@iblai/data-layer 1.12.106 → 1.13.0

package/dist/src/features/user-chat-history/constants.d.ts

@@ -0,0 +1,41 @@
+import { SERVICES } from '@data-layer/constants';
+export declare const USER_CHAT_HISTORY_REDUCER_PATH = "userChatHistoryApiSlice";
+export declare const USER_CHAT_HISTORY_QUERY_KEYS: {
+    GET_USER_CHAT_HISTORY: () => string[];
+    GET_USER_CHAT_HISTORY_SESSION: () => string[];
+    GET_USER_CHAT_HISTORY_FILTER: () => string[];
+    GET_USER_CHAT_HISTORY_REPORTS: () => string[];
+    GET_USER_CHAT_HISTORY_REPORT_STATUS: () => string[];
+};
+/**
+ * User-scoped chat history endpoints (`my-chat-history*`). Unlike the admin
+ * `chat-history` family these require no RBAC permissions — the backend only
+ * allows the authenticated user to read their own data, enforced through the
+ * `{userId}` path segment.
+ */
+export declare const USER_CHAT_HISTORY_ENDPOINTS: {
+    GET_USER_CHAT_HISTORY: {
+        service: SERVICES;
+        path: (org: string, userId: string) => string;
+    };
+    GET_USER_CHAT_HISTORY_SESSION: {
+        service: SERVICES;
+        path: (org: string, userId: string, sessionId: string) => string;
+    };
+    GET_USER_CHAT_HISTORY_FILTER: {
+        service: SERVICES;
+        path: (org: string, userId: string) => string;
+    };
+    USER_CHAT_HISTORY_REPORT: {
+        service: SERVICES;
+        path: (org: string, userId: string) => string;
+    };
+    USER_CHAT_HISTORY_REPORT_STATUS: {
+        service: SERVICES;
+        path: (org: string, userId: string, taskId: string) => string;
+    };
+    USER_CHAT_HISTORY_REPORT_DOWNLOAD: {
+        service: SERVICES;
+        path: (org: string, userId: string, taskId: string) => string;
+    };
+};

package/dist/src/features/user-chat-history/types.d.ts

@@ -0,0 +1,137 @@
+export type UserChatHistoryTopic = {
+    id?: number;
+    name: string;
+};
+export type UserChatHistoryDateRange = {
+    start_date: string;
+    end_date: string;
+};
+export type UserChatHistorySentiment = 'positive' | 'negative' | 'neutral';
+export type UserChatHistoryFilterResponse = {
+    topics: UserChatHistoryTopic[];
+    date_ranges?: UserChatHistoryDateRange[];
+    sentiment?: string[];
+};
+export type UserChatHistoryMessage = {
+    human: string;
+    ai: string;
+    human_message_inserted_at?: string;
+    ai_message_inserted_at?: string;
+};
+export type UserChatHistorySession = {
+    id: string;
+    student?: string;
+    email?: string;
+    mentor: string;
+    mentor_name?: string;
+    inserted_at: string;
+    topics?: UserChatHistoryTopic[];
+    messages?: UserChatHistoryMessage[];
+    sentiment?: string;
+    rating?: number;
+    /** AI-generated title summarizing the conversation. */
+    title?: string | null;
+    first_user_message?: string | null;
+    last_message_at?: string | null;
+    message_count_human?: number;
+    message_count_ai?: number;
+    positive_feedback_count?: number;
+    negative_feedback_count?: number;
+};
+export type UserChatHistoryResponse = {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: UserChatHistorySession[];
+};
+export type UserChatHistoryParams = {
+    /** Mentor unique ID. */
+    mentor?: string;
+    /** `YYYY-MM-DD`. */
+    start_date?: string;
+    /** `YYYY-MM-DD`. */
+    end_date?: string;
+    /** Comma-separated topic names. */
+    topics?: string;
+    sentiment?: UserChatHistorySentiment | string;
+    page?: number;
+    page_size?: number;
+};
+export type GetUserChatHistoryArgs = {
+    org: string;
+    userId: string;
+    params?: UserChatHistoryParams;
+};
+export type GetUserChatHistorySessionArgs = {
+    org: string;
+    userId: string;
+    sessionId: string;
+};
+export type UserChatHistoryFilterParams = {
+    mentor_id?: string;
+    /** `true` returns monthly date ranges; otherwise weekly. */
+    monthly_range?: boolean;
+    start_date?: string;
+    end_date?: string;
+};
+export type GetUserChatHistoryFilterArgs = {
+    org: string;
+    userId: string;
+    params?: UserChatHistoryFilterParams;
+};
+export type UserChatHistoryReportState = 'pending' | 'running' | 'accumulating' | 'processing' | 'storing' | 'completed' | 'cancelled' | 'error' | 'expired';
+/** States in which a report task can still reach `completed`. */
+export declare const USER_CHAT_HISTORY_REPORT_ACTIVE_STATES: UserChatHistoryReportState[];
+export type UserChatHistoryReportFilters = {
+    mentor_id?: string[];
+    topic?: string;
+    sentiment?: UserChatHistorySentiment | string;
+};
+export type CreateUserChatHistoryReportBody = {
+    start_date?: string;
+    end_date?: string;
+    format?: 'json' | 'csv';
+    /** Force creation of a new report even if a completed one exists. */
+    force?: boolean;
+    filters?: UserChatHistoryReportFilters;
+};
+export type CreateUserChatHistoryReportArgs = {
+    org: string;
+    userId: string;
+    body?: CreateUserChatHistoryReportBody;
+};
+export type UserChatHistoryReportStatus = {
+    report_id?: string;
+    report_name?: string;
+    state?: UserChatHistoryReportState;
+    started_on?: string;
+    owner?: string;
+    /** When the report download expires (only when completed). */
+    expires?: string;
+    /** Download link for the report when available. */
+    url?: string;
+    created_at?: string;
+    /** Seconds the client should poll before relying on notifications. */
+    poll_timeout?: number;
+};
+/** Envelope returned by the create-report and report-status endpoints. */
+export type UserChatHistoryReportResponse = {
+    data: UserChatHistoryReportStatus;
+};
+export type UserChatHistoryReportListItem = UserChatHistoryReportStatus & {
+    filters?: UserChatHistoryReportFilters;
+    start_date?: string | null;
+    end_date?: string | null;
+};
+export type UserChatHistoryReportsResponse = {
+    reports: UserChatHistoryReportListItem[];
+};
+export type GetUserChatHistoryReportsArgs = {
+    org: string;
+    userId: string;
+};
+export type GetUserChatHistoryReportStatusArgs = {
+    org: string;
+    userId: string;
+    taskId: string;
+};

package/dist/src/index.d.ts

@@ -15,6 +15,7 @@ export * from './features/training-documents/api-slice';
 export * from './features/platform/api-slice';
 export * from './features/user/api-slice';
 export * from './features/user/types';
+export * from './features/user/utils';
 export * from './features/user/api-slice';
 export * from './features/core/api-slice';
 export * from './features/core/constants';
@@ -135,6 +136,9 @@ export * from './features/evaluations/types';
 export * from './features/watched-groups/api-slice';
 export * from './features/watched-groups/constants';
 export * from './features/watched-groups/types';
+export * from './features/user-chat-history/api-slice';
+export * from './features/user-chat-history/constants';
+export * from './features/user-chat-history/types';
 export * from './reducers';
 export * from './utils';
 export type { CustomQueryArgs } from './features/utils';