@epam/ai-dial-chat-hooks 1.3.0-dev.252 → 1.3.0-dev.253

package/project/project-mapping.d.ts

@@ -0,0 +1,11 @@
+import { ProjectSource as ProjectSourceDto, ProjectDetailsDto, ProjectDto } from '@epam/ai-dial-chat-api-client';
+import { ProjectItem, ProjectSource, ProjectViewModel, StoredProjectContextFile } from '@epam/ai-dial-projects';
+/** Maps a BFF project source onto the Projects lib's source. */
+export declare const mapProjectSource: (source: ProjectSourceDto) => ProjectSource;
+/** Maps a BFF project to the card item the Projects lib renders; the sort date falls back to the creation time. */
+export declare const mapProjectDtoToItem: (project: ProjectDto) => ProjectItem;
+/** Maps a project's BFF details to the content the project view renders; content types come from the file names. */
+export declare const mapProjectDetailsToViewModel: (project: ProjectDetailsDto) => ProjectViewModel;
+/** Maps a project's stored context files to the cards the project form renders; ids are `stored:{name}`. */
+export declare const mapStoredContextFiles: (project: ProjectDetailsDto) => StoredProjectContextFile[];
+//# sourceMappingURL=project-mapping.d.ts.map

package/project/project-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-mapping.d.ts","sourceRoot":"","sources":["../../src/project/project-mapping.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,IAAI,gBAAgB,EACjC,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAChB,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EACL,KAAK,WAAW,EAChB,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAchC,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,GAAI,QAAQ,gBAAgB,KAAG,aACnC,CAAC;AAE1B,mHAAmH;AACnH,eAAO,MAAM,mBAAmB,GAAI,SAAS,UAAU,KAAG,WAMxD,CAAC;AAEH,oHAAoH;AACpH,eAAO,MAAM,4BAA4B,GACvC,SAAS,iBAAiB,KACzB,gBAQD,CAAC;AAEH,4GAA4G;AAC5G,eAAO,MAAM,qBAAqB,GAChC,SAAS,iBAAiB,KACzB,wBAAwB,EAYvB,CAAC"}

package/project/project-mapping.js

@@ -0,0 +1,36 @@
+import { RequestStatus as e, getAttachmentTypeFromMime as t, inferMimeTypeFromPath as n } from "@epam/ai-dial-chat-shared";
+import { ProjectSource as r } from "@epam/ai-dial-chat-api-client";
+import { ProjectSource as i } from "@epam/ai-dial-projects";
+//#region src/project/project-mapping.ts
+var a = "", o = {
+	[r.Personal]: i.Personal,
+	[r.Shared]: i.Shared,
+	[r.Organization]: i.Organization
+}, s = (e) => o[e], c = (e) => ({
+	id: e.id,
+	name: e.name,
+	source: s(e.source),
+	parentPath: e.parentPath,
+	updatedAt: e.updatedAt ?? e.createdAt
+}), l = (e) => ({
+	name: e.name,
+	description: e.description,
+	instructions: e.instructions,
+	contextFiles: e.contextFiles.map(({ name: e }) => ({
+		name: e,
+		contentType: n(e) ?? a
+	}))
+}), u = (r) => r.contextFiles.map(({ name: r, size: i }) => {
+	let o = n(r) ?? a;
+	return {
+		id: `stored:${r}`,
+		name: r,
+		size: i,
+		contentType: o,
+		type: t(o),
+		status: e.Idle,
+		isStored: !0
+	};
+});
+//#endregion
+export { l as mapProjectDetailsToViewModel, c as mapProjectDtoToItem, s as mapProjectSource, u as mapStoredContextFiles };

package/project/projects-api-client.d.ts

@@ -0,0 +1,157 @@
+import { AttachmentDto, ConversationResponseDto, CreateConversationDto, CreateProjectResponseDto, ListProjectsResponseDto, ProjectConversationListResponseDto, ProjectDetailsDto, RenameConversationResponseDto, UpdateProjectResponseDto } from '@epam/ai-dial-chat-api-client';
+import { RequestSkill } from '@epam/ai-dial-chat-shared';
+/** A generated-client `Raw` answer, of which only the native response is read. */
+interface RawApiResponse {
+    raw: Response;
+}
+/** Narrow configured generated-client (`ProjectsApi`) surface the project hooks require. */
+export interface ProjectsConfiguredClient {
+    listProjects: (options?: RequestInit) => Promise<ListProjectsResponseDto>;
+    getProject: (request: {
+        id: string;
+    }, options?: RequestInit) => Promise<ProjectDetailsDto>;
+    createProject: (request: {
+        name: string;
+        description?: string;
+        instructions?: string;
+        fileNames?: string;
+        files?: Blob[];
+    }, options?: RequestInit) => Promise<CreateProjectResponseDto>;
+    updateProject: (request: {
+        id: string;
+        ifMatch: string;
+        name: string;
+        description?: string;
+        instructions?: string;
+        fileNames?: string;
+        removedFileNames?: string;
+        files?: Blob[];
+    }, options?: RequestInit) => Promise<UpdateProjectResponseDto>;
+    deleteProject: (request: {
+        id: string;
+        ifMatch: string;
+    }) => Promise<void>;
+    downloadProjectRaw: (request: {
+        id: string;
+    }, options?: RequestInit) => Promise<RawApiResponse>;
+    downloadProjectFileRaw: (request: {
+        id: string;
+        fileName: string;
+    }, options?: RequestInit) => Promise<RawApiResponse>;
+    listProjectConversations: (request: {
+        id: string;
+        limit?: number;
+        offset?: number;
+    }, options?: RequestInit) => Promise<ProjectConversationListResponseDto>;
+    createProjectConversation: (request: {
+        id: string;
+        createConversationDto: CreateConversationDto;
+    }) => Promise<ConversationResponseDto>;
+    getProjectConversation: (request: {
+        id: string;
+        conversationName: string;
+    }, options?: RequestInit) => Promise<ConversationResponseDto>;
+    saveProjectConversation: (request: {
+        id: string;
+        conversationName: string;
+        saveConversationBodyDto: {
+            conversation: ConversationResponseDto;
+        };
+    }) => Promise<ConversationResponseDto>;
+    renameProjectConversation: (request: {
+        id: string;
+        conversationName: string;
+        renameConversationBodyDto: {
+            newTitle: string;
+        };
+    }) => Promise<RenameConversationResponseDto>;
+    deleteProjectConversation: (request: {
+        id: string;
+        conversationName: string;
+    }) => Promise<void>;
+    attachToProjectGenerationRaw: (request: {
+        id: string;
+        attachGenerationDto: {
+            path: string;
+        };
+    }, options?: RequestInit) => Promise<RawApiResponse>;
+}
+/** Text fields of a project create or edit request. */
+export interface ProjectFields {
+    /** Project name; also the last path segment of its id. */
+    name: string;
+    /** Plain-text description. */
+    description: string;
+    /** Markdown instructions, stored as the `PROJECT.md` body. */
+    instructions: string;
+}
+/** One project edit: the fields, the added files only, the stored files to drop and the loaded version. */
+export interface ProjectUpdateRequest {
+    /** The project's DIAL id. */
+    id: string;
+    /** The edited text fields. */
+    fields: ProjectFields;
+    /** Files added in this edit. */
+    newFiles: File[];
+    /** Names of the stored context files to remove. */
+    removedFileNames: string[];
+    /** The loaded project's `contentVersion`; a conversation written meanwhile does not change it. */
+    contentVersion: string;
+}
+/** One page of a project's conversations, newest first. */
+export interface ProjectConversationListPage {
+    /** Page size, `1..100`; the BFF defaults to 50. */
+    limit?: number;
+    /** Conversations to skip; the next page starts at the count already loaded. */
+    offset?: number;
+}
+/** The first message of a new top-level or project conversation. */
+export interface ConversationCreateRequest {
+    /** The first user message. */
+    firstMessage: string;
+    /** Model or application the conversation starts with. */
+    deploymentId: string;
+    /** Attachments of the first message. */
+    attachments?: AttachmentDto[];
+    /** Tool configuration of the first message. */
+    configurationValue?: Record<string, unknown>;
+    /** Form values of the first message. */
+    formValue?: Record<string, unknown>;
+    /** Skills requested with the first message. */
+    skills?: RequestSkill[];
+}
+/** App-agnostic project requests over a configured generated client. */
+export interface ProjectsApiClient {
+    listProjects: (signal?: AbortSignal) => Promise<ListProjectsResponseDto>;
+    getProject: (id: string, signal?: AbortSignal) => Promise<ProjectDetailsDto>;
+    createProject: (fields: ProjectFields, files: File[], signal?: AbortSignal) => Promise<CreateProjectResponseDto>;
+    updateProject: (request: ProjectUpdateRequest, signal?: AbortSignal) => Promise<UpdateProjectResponseDto>;
+    deleteProject: (id: string, contentVersion: string) => Promise<void>;
+    downloadProjectArchive: (id: string, signal?: AbortSignal) => Promise<Response>;
+    downloadProjectContextFile: (id: string, fileName: string, signal?: AbortSignal) => Promise<Response>;
+    listProjectConversations: (projectId: string, signal?: AbortSignal, page?: ProjectConversationListPage) => Promise<ProjectConversationListResponseDto>;
+    createProjectConversation: (projectId: string, request: ConversationCreateRequest) => Promise<ConversationResponseDto>;
+    getProjectConversation: (conversationId: string, signal?: AbortSignal) => Promise<ConversationResponseDto>;
+    saveProjectConversation: (conversationId: string, conversation: ConversationResponseDto) => Promise<ConversationResponseDto>;
+    renameProjectConversation: (conversationId: string, newTitle: string) => Promise<RenameConversationResponseDto>;
+    deleteProjectConversation: (conversationId: string) => Promise<void>;
+    attachToProjectGeneration: (projectId: string, path: string, signal?: AbortSignal) => Promise<ReadableStream<Uint8Array>>;
+}
+/**
+ * Splits a project conversation id `projects/{bucket}/{projectPath…}/conversations/{name}`
+ * into the project id and the conversation file name; `null` for any other id.
+ */
+export declare const splitProjectConversationId: (conversationId: string) => {
+    projectId: string;
+    conversationName: string;
+} | null;
+/** The create-conversation body of a first message, the same for a top-level and a project conversation. */
+export declare const buildCreateConversationDto: ({ firstMessage, deploymentId, attachments, configurationValue, formValue, skills, }: ConversationCreateRequest) => CreateConversationDto;
+/**
+ * Composes the project requests over a configured generated `ProjectsApi`.
+ * File names travel as JSON fields, positionally paired with `files`,
+ * because the BFF never trusts a multipart part's own filename.
+ */
+export declare const createProjectsApiClient: (client: ProjectsConfiguredClient) => ProjectsApiClient;
+export {};
+//# sourceMappingURL=projects-api-client.d.ts.map

package/project/projects-api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects-api-client.d.ts","sourceRoot":"","sources":["../../src/project/projects-api-client.ts"],"names":[],"mappings":"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"}

package/project/projects-api-client.js

@@ -0,0 +1,81 @@
+//#region src/project/projects-api-client.ts
+var e = (e) => {
+	let t = e.split("/");
+	return t.length < 5 || t[0] !== "projects" || t[t.length - 2] !== "conversations" ? null : {
+		projectId: t.slice(0, -2).join("/"),
+		conversationName: t[t.length - 1]
+	};
+}, t = (t) => {
+	let n = e(t);
+	if (!n) throw Error("Not a project conversation id");
+	return {
+		id: n.projectId,
+		conversationName: n.conversationName
+	};
+}, n = (e) => e ? [{ signal: e }] : [], r = ({ firstMessage: e, deploymentId: t, attachments: n, configurationValue: r, formValue: i, skills: a }) => ({
+	firstMessage: e,
+	deploymentId: t,
+	...n?.length || r || i || a?.length ? { custom_content: {
+		...n?.length ? { attachments: n } : {},
+		...r ? { configuration_value: r } : {},
+		...i ? { form_value: i } : {},
+		...a?.length ? { skills: a } : {}
+	} } : {}
+}), i = (e) => ({
+	listProjects: (t) => e.listProjects(...n(t)),
+	getProject: (t, r) => e.getProject({ id: t }, ...n(r)),
+	createProject: ({ name: t, description: r, instructions: i }, a, o) => e.createProject({
+		name: t,
+		description: r,
+		instructions: i,
+		fileNames: JSON.stringify(a.map((e) => e.name)),
+		files: a
+	}, ...n(o)),
+	updateProject: ({ id: t, fields: r, newFiles: i, removedFileNames: a, contentVersion: o }, s) => e.updateProject({
+		id: t,
+		ifMatch: o,
+		name: r.name,
+		description: r.description,
+		instructions: r.instructions,
+		fileNames: JSON.stringify(i.map((e) => e.name)),
+		removedFileNames: JSON.stringify(a),
+		files: i
+	}, ...n(s)),
+	deleteProject: (t, n) => e.deleteProject({
+		id: t,
+		ifMatch: n
+	}),
+	downloadProjectArchive: async (t, r) => (await e.downloadProjectRaw({ id: t }, ...n(r))).raw,
+	downloadProjectContextFile: async (t, r, i) => (await e.downloadProjectFileRaw({
+		id: t,
+		fileName: r
+	}, ...n(i))).raw,
+	listProjectConversations: (t, r, i) => e.listProjectConversations({
+		id: t,
+		...i
+	}, ...n(r)),
+	createProjectConversation: (t, n) => e.createProjectConversation({
+		id: t,
+		createConversationDto: r(n)
+	}),
+	getProjectConversation: (r, i) => e.getProjectConversation(t(r), ...n(i)),
+	saveProjectConversation: (n, r) => e.saveProjectConversation({
+		...t(n),
+		saveConversationBodyDto: { conversation: r }
+	}),
+	renameProjectConversation: (n, r) => e.renameProjectConversation({
+		...t(n),
+		renameConversationBodyDto: { newTitle: r }
+	}),
+	deleteProjectConversation: (n) => e.deleteProjectConversation(t(n)),
+	attachToProjectGeneration: async (t, r, i) => {
+		let { raw: a } = await e.attachToProjectGenerationRaw({
+			id: t,
+			attachGenerationDto: { path: r }
+		}, ...n(i));
+		if (!a.body) throw Error("Attach endpoint returned no response body");
+		return a.body;
+	}
+});
+//#endregion
+export { r as buildCreateConversationDto, i as createProjectsApiClient, e as splitProjectConversationId };

package/project/use-project-actions.d.ts

@@ -0,0 +1,49 @@
+import { ProjectDetailsDto } from '@epam/ai-dial-chat-api-client';
+import { ProjectsApiClient } from './projects-api-client';
+/** Which project action failed, for the host's error message. */
+export declare enum ProjectActionError {
+    Pin = "pin",
+    Download = "download",
+    Delete = "delete",
+    /** The delete lost to a concurrent change; the project should be reloaded. */
+    ChangedElsewhere = "changed-elsewhere"
+}
+/** Host behaviour the project actions delegate to. */
+export interface ProjectActionsHandlers {
+    /** Whether the project is in the caller's pins. */
+    isPinned: boolean;
+    /** Persists the pin state; rejects on failure. */
+    setPinned: (projectId: string, isPinned: boolean) => Promise<void>;
+    /** Saves a downloaded response as a file and resolves the saved name. */
+    saveFile: (response: Response, fileName: string) => Promise<string>;
+    /** Called after the archive was saved, with the saved file name. */
+    onArchiveDownloaded?: (savedName: string) => void;
+    /** Called after the project was deleted; the host updates pins and navigates away. */
+    onDeleted: (project: ProjectDetailsDto) => void;
+    /** Called with a failed action and its trace id; the host shows the message. */
+    onError: (error: ProjectActionError, requestId?: string) => void;
+    /** Re-reads the project, e.g. after a delete lost to a concurrent change. */
+    onReload: () => void;
+}
+/**
+ * Pin, archive and context-file downloads, and the confirmed delete of one
+ * loaded project, with their in-flight state. Messages, notifications, pins
+ * and navigation stay with the host through `handlers`.
+ *
+ * @param client - Configured project requests, from `createProjectsApiClient`.
+ * @param project - The loaded project, or `null` while none is loaded.
+ * @param handlers - Host behaviour the actions delegate to.
+ */
+export declare const useProjectActions: (client: Pick<ProjectsApiClient, "deleteProject" | "downloadProjectArchive" | "downloadProjectContextFile">, project: ProjectDetailsDto | null, { isPinned, setPinned, saveFile, onArchiveDownloaded, onDeleted, onError, onReload, }: ProjectActionsHandlers) => {
+    isPinned: boolean;
+    isPinPending: boolean;
+    togglePin: () => Promise<void>;
+    downloadArchive: () => Promise<void>;
+    openFile: (fileName: string) => Promise<void>;
+    isDeleteOpen: boolean;
+    isDeleting: boolean;
+    requestDelete: () => void;
+    cancelDelete: () => void;
+    confirmDelete: () => Promise<void>;
+};
+//# sourceMappingURL=use-project-actions.d.ts.map

package/project/use-project-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-project-actions.d.ts","sourceRoot":"","sources":["../../src/project/use-project-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,iEAAiE;AACjE,oBAAY,kBAAkB;IAC5B,GAAG,QAAQ;IACX,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,8EAA8E;IAC9E,gBAAgB,sBAAsB;CACvC;AAED,sDAAsD;AACtD,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,QAAQ,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,yEAAyE;IACzE,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,oEAAoE;IACpE,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,sFAAsF;IACtF,SAAS,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAChD,gFAAgF;IAChF,OAAO,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,IAAI,CACV,iBAAiB,EACjB,eAAe,GAAG,wBAAwB,GAAG,4BAA4B,CAC1E,EACD,SAAS,iBAAiB,GAAG,IAAI,EACjC,uFAQG,sBAAsB;;;;;yBAyCN,MAAM;;;;;;CAmE1B,CAAC"}

package/project/use-project-actions.js

@@ -0,0 +1,102 @@
+import { getApiErrorDetails as e } from "../api-error/api-error.js";
+import { sanitizeFileName as t } from "../files/file-name.js";
+import { useCallback as n, useMemo as r, useState as i } from "react";
+import { ProjectCreateErrorCode as a } from "@epam/ai-dial-chat-api-client";
+//#region src/project/use-project-actions.ts
+var o = /* @__PURE__ */ function(e) {
+	return e.Pin = "pin", e.Download = "download", e.Delete = "delete", e.ChangedElsewhere = "changed-elsewhere", e;
+}({}), s = (o, s, { isPinned: c, setPinned: l, saveFile: u, onArchiveDownloaded: d, onDeleted: f, onError: p, onReload: m }) => {
+	let [h, g] = i(!1), [_, v] = i(!1), [y, b] = i(!1), x = n(async (t, n) => {
+		let { traceId: r } = await e(t);
+		p(n, r);
+	}, [p]), S = n(async () => {
+		if (s != null) {
+			g(!0);
+			try {
+				await l(s.id, !c);
+			} catch (e) {
+				await x(e, "pin");
+			} finally {
+				g(!1);
+			}
+		}
+	}, [
+		s,
+		c,
+		l,
+		x
+	]), C = n(async () => {
+		if (s != null) try {
+			let e = await u(await o.downloadProjectArchive(s.id), `${t(s.name)}.zip`);
+			d?.(e);
+		} catch (e) {
+			await x(e, "download");
+		}
+	}, [
+		o,
+		s,
+		u,
+		d,
+		x
+	]), w = n(async (e) => {
+		if (s != null) try {
+			await u(await o.downloadProjectContextFile(s.id, e), e);
+		} catch (e) {
+			await x(e, "download");
+		}
+	}, [
+		o,
+		s,
+		u,
+		x
+	]), T = n(() => v(!0), []), E = n(() => {
+		y || v(!1);
+	}, [y]), D = n(async () => {
+		if (s != null) {
+			b(!0);
+			try {
+				await o.deleteProject(s.id, s.contentVersion), v(!1), f(s);
+			} catch (t) {
+				let { code: n, traceId: r } = await e(t);
+				if (n === a.ProjectChanged) {
+					v(!1), p("changed-elsewhere", r), m();
+					return;
+				}
+				p("delete", r);
+			} finally {
+				b(!1);
+			}
+		}
+	}, [
+		o,
+		s,
+		f,
+		p,
+		m
+	]);
+	return r(() => ({
+		isPinned: c,
+		isPinPending: h,
+		togglePin: S,
+		downloadArchive: C,
+		openFile: w,
+		isDeleteOpen: _,
+		isDeleting: y,
+		requestDelete: T,
+		cancelDelete: E,
+		confirmDelete: D
+	}), [
+		c,
+		h,
+		S,
+		C,
+		w,
+		_,
+		y,
+		T,
+		E,
+		D
+	]);
+};
+//#endregion
+export { o as ProjectActionError, s as useProjectActions };

package/project/use-project-conversations.d.ts

@@ -0,0 +1,27 @@
+import { ProjectConversationListItem } from '@epam/ai-dial-projects';
+import { ProjectsApiClient } from './projects-api-client';
+/**
+ * Loads a project's conversations for its Chats list and keeps them in local
+ * state: there is no live subscription, so the first page is read once per
+ * project (and on retry), `loadMore` appends the next one, and rename and
+ * delete update the list in place. Requests are aborted when the project
+ * changes or the view unmounts. Rename, delete and `loadMore` reject on
+ * failure for the caller's toast.
+ *
+ * @param client - Configured project requests, from `createProjectsApiClient`; it must be referentially stable, because a new object reloads the list.
+ * @param projectId - The project's DIAL id, or `null` while none is known.
+ */
+export declare const useProjectConversations: (client: Pick<ProjectsApiClient, "listProjectConversations" | "renameProjectConversation" | "deleteProjectConversation">, projectId: string | null) => {
+    retry: () => void;
+    loadMore: () => Promise<void>;
+    rename: (id: string, newTitle: string) => Promise<void>;
+    remove: (id: string) => Promise<void>;
+    items: ProjectConversationListItem[];
+    isLoading: boolean;
+    hasError: boolean;
+    /** More conversations exist after `items`. */
+    hasMore: boolean;
+    /** The next page is being read. */
+    isLoadingMore: boolean;
+};
+//# sourceMappingURL=use-project-conversations.d.ts.map

package/project/use-project-conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-project-conversations.d.ts","sourceRoot":"","sources":["../../src/project/use-project-conversations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AA8B/D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,GAClC,QAAQ,IAAI,CACV,iBAAiB,EACf,0BAA0B,GAC1B,2BAA2B,GAC3B,2BAA2B,CAC9B,EACD,WAAW,MAAM,GAAG,IAAI;;;iBA6EX,MAAM,YAAY,MAAM;iBAaxB,MAAM;WAvIZ,2BAA2B,EAAE;eACzB,OAAO;cACR,OAAO;IACjB,8CAA8C;aACrC,OAAO;IAChB,mCAAmC;mBACpB,OAAO;CA4IvB,CAAC"}

package/project/use-project-conversations.js

@@ -0,0 +1,109 @@
+import { useCallback as e, useEffect as t, useRef as n, useState as r } from "react";
+//#region src/project/use-project-conversations.ts
+var i = {
+	items: [],
+	isLoading: !0,
+	hasError: !1,
+	hasMore: !1,
+	isLoadingMore: !1
+}, a = {
+	...i,
+	isLoading: !1
+}, o = ({ items: e }) => e.map(({ id: e, title: t, author: n }) => ({
+	id: e,
+	title: t,
+	authorName: n
+})), s = (s, c) => {
+	let [l, u] = r(i), [d, f] = r(0), p = n(null);
+	t(() => {
+		if (c == null) {
+			u(a);
+			return;
+		}
+		let e = new AbortController();
+		return p.current = e, (async () => {
+			u((e) => ({
+				...e,
+				isLoading: !0,
+				hasError: !1,
+				isLoadingMore: !1
+			}));
+			try {
+				let t = await s.listProjectConversations(c, e.signal);
+				if (e.signal.aborted) return;
+				u({
+					items: o(t),
+					isLoading: !1,
+					hasError: !1,
+					hasMore: t.hasMore,
+					isLoadingMore: !1
+				});
+			} catch {
+				if (e.signal.aborted) return;
+				u({
+					...a,
+					hasError: !0
+				});
+			}
+		})(), () => e.abort();
+	}, [
+		s,
+		c,
+		d
+	]);
+	let m = e(() => f((e) => e + 1), []), h = e(async () => {
+		let e = p.current;
+		if (c != null && e != null) {
+			u((e) => ({
+				...e,
+				isLoadingMore: !0
+			}));
+			try {
+				let t = await s.listProjectConversations(c, e.signal, { offset: l.items.length });
+				if (e.signal.aborted) return;
+				u((e) => {
+					let n = new Set(e.items.map((e) => e.id));
+					return {
+						...e,
+						items: [...e.items, ...o(t).filter((e) => !n.has(e.id))],
+						hasMore: t.hasMore,
+						isLoadingMore: !1
+					};
+				});
+			} catch (t) {
+				if (e.signal.aborted) return;
+				throw u((e) => ({
+					...e,
+					isLoadingMore: !1
+				})), t;
+			}
+		}
+	}, [
+		s,
+		c,
+		l.items.length
+	]), g = e(async (e, t) => {
+		let { name: n } = await s.renameProjectConversation(e, t);
+		u((t) => ({
+			...t,
+			items: t.items.map((t) => t.id === e ? {
+				...t,
+				title: n
+			} : t)
+		}));
+	}, [s]), _ = e(async (e) => {
+		await s.deleteProjectConversation(e), u((t) => ({
+			...t,
+			items: t.items.filter((t) => t.id !== e)
+		}));
+	}, [s]);
+	return {
+		...l,
+		retry: m,
+		loadMore: h,
+		rename: g,
+		remove: _
+	};
+};
+//#endregion
+export { s as useProjectConversations };

package/project/use-project-submit.d.ts

@@ -0,0 +1,49 @@
+import { CreateProjectResponseDto, UpdateProjectResponseDto } from '@epam/ai-dial-chat-api-client';
+import { ProjectFields, ProjectsApiClient, ProjectUpdateRequest } from './projects-api-client';
+/** A rejected create or save, normalised for the page. */
+export interface ProjectSubmitFailure {
+    /** `true` when the page unmounted mid-request; nothing should be shown. */
+    isAborted: boolean;
+    /** HTTP status of the rejection. */
+    status?: number;
+    /** The BFF's `ProjectCreateErrorCode`, when the rejection carried one. */
+    code?: string;
+    /** Trace id for the error toast. */
+    requestId?: string;
+}
+/** Result of one {@link useCreateProject} `create` call. */
+export type CreateProjectOutcome = {
+    isCreated: true;
+    project: CreateProjectResponseDto;
+} | ({
+    isCreated: false;
+} & ProjectSubmitFailure);
+/** Result of one {@link useSaveProject} `save` call. */
+export type SaveProjectOutcome = {
+    isSaved: true;
+    project: UpdateProjectResponseDto;
+} | ({
+    isSaved: false;
+} & ProjectSubmitFailure);
+/**
+ * Submits the New project form; the page owns the form state and decides
+ * what each outcome means.
+ *
+ * @param client - Configured project requests, from `createProjectsApiClient`.
+ */
+export declare const useCreateProject: (client: Pick<ProjectsApiClient, "createProject">) => {
+    create: (fields: ProjectFields, files: File[]) => Promise<CreateProjectOutcome>;
+    isSubmitting: boolean;
+};
+/**
+ * Submits the Edit project form as one atomic update, conditioned on the
+ * loaded `contentVersion`; the page owns the draft and decides what each
+ * outcome means.
+ *
+ * @param client - Configured project requests, from `createProjectsApiClient`.
+ */
+export declare const useSaveProject: (client: Pick<ProjectsApiClient, "updateProject">) => {
+    save: (request: ProjectUpdateRequest) => Promise<SaveProjectOutcome>;
+    isSubmitting: boolean;
+};
+//# sourceMappingURL=use-project-submit.d.ts.map

package/project/use-project-submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-project-submit.d.ts","sourceRoot":"","sources":["../../src/project/use-project-submit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAE/B,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4DAA4D;AAC5D,MAAM,MAAM,oBAAoB,GAC5B;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,wBAAwB,CAAA;CAAE,GACtD,CAAC;IAAE,SAAS,EAAE,KAAK,CAAA;CAAE,GAAG,oBAAoB,CAAC,CAAC;AAElD,wDAAwD;AACxD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,wBAAwB,CAAA;CAAE,GACpD,CAAC;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,GAAG,oBAAoB,CAAC,CAAC;AAkDhD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC;qBAMpC,aAAa,SACd,IAAI,EAAE,KACZ,OAAO,CAAC,oBAAoB,CAAC;;CAYnC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC;oBAK9B,oBAAoB,KAAG,OAAO,CAAC,kBAAkB,CAAC;;CAYrE,CAAC"}