@epam/ai-dial-chat-hooks 1.3.0-dev.98 → 1.4.0-dev.5

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

@@ -0,0 +1,179 @@
+import { AttachmentDto, ConversationResponseDto, CreateConversationDto, CreateProjectResponseDto, ListProjectsResponseDto, ProjectArtifactListResponseDto, ProjectConversationListResponseDto, ProjectConversationTitlesResponseDto, ProjectDetailsDto, GenerateTitleResponseDto, 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;
+    }, options?: RequestInit) => Promise<ProjectConversationListResponseDto>;
+    getProjectConversationTitles: (request: {
+        id: string;
+        projectConversationTitlesBodyDto: {
+            names: string[];
+        };
+    }, options?: RequestInit) => Promise<ProjectConversationTitlesResponseDto>;
+    listProjectArtifacts: (request: {
+        id: string;
+    }, options?: RequestInit) => Promise<ProjectArtifactListResponseDto>;
+    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>;
+    generateProjectConversationTitle: (request: {
+        id: string;
+        conversationName: string;
+    }) => Promise<GenerateTitleResponseDto>;
+    deleteProjectConversation: (request: {
+        id: string;
+        conversationName: string;
+    }) => Promise<void>;
+    markProjectConversationViewed: (request: {
+        id: string;
+        conversationName: string;
+    }) => Promise<void>;
+    attachToProjectGenerationRaw: (request: {
+        id: string;
+        attachGenerationDto: {
+            path: string;
+        };
+    }, options?: RequestInit) => Promise<RawApiResponse>;
+    watchProjectsRaw: (request: {
+        watchProjectsBodyDto: {
+            ids: 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; when omitted, a save keeps the stored one. */
+    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;
+}
+/** 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>;
+    /** Lists the files the agents saved under the project's `artifacts/` folder, newest first. */
+    listProjectArtifacts: (projectId: string, signal?: AbortSignal) => Promise<ProjectArtifactListResponseDto>;
+    listProjectConversations: (projectId: string, signal?: AbortSignal) => Promise<ProjectConversationListResponseDto>;
+    getProjectConversationTitles: (projectId: string, names: string[], signal?: AbortSignal) => Promise<ProjectConversationTitlesResponseDto>;
+    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>;
+    /** Suggests a title for the conversation without saving it. */
+    generateProjectConversationTitle: (conversationId: string) => Promise<GenerateTitleResponseDto>;
+    deleteProjectConversation: (conversationId: string) => Promise<void>;
+    /** Records that the caller has seen the conversation's current version; a host without it keeps no read state. */
+    markProjectConversationViewed?: (conversationId: string) => Promise<void>;
+    attachToProjectGeneration: (projectId: string, path: string, signal?: AbortSignal) => Promise<ReadableStream<Uint8Array>>;
+    /** Opens the SSE stream of changes to the given projects; a host without it gets no live updates. */
+    watchProjects?: (ids: 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) => Required<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,90 @@
+//#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,
+	listProjectArtifacts: (t, r) => e.listProjectArtifacts({ id: t }, ...n(r)),
+	listProjectConversations: (t, r) => e.listProjectConversations({ id: t }, ...n(r)),
+	getProjectConversationTitles: (t, r, i) => e.getProjectConversationTitles({
+		id: t,
+		projectConversationTitlesBodyDto: { names: r }
+	}, ...n(i)),
+	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 }
+	}),
+	generateProjectConversationTitle: (n) => e.generateProjectConversationTitle(t(n)),
+	deleteProjectConversation: (n) => e.deleteProjectConversation(t(n)),
+	markProjectConversationViewed: (n) => e.markProjectConversationViewed(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;
+	},
+	watchProjects: async (t, r) => {
+		let { raw: i } = await e.watchProjectsRaw({ watchProjectsBodyDto: { ids: t } }, ...n(r));
+		if (!i.body) throw Error("Watch endpoint returned no response body");
+		return i.body;
+	}
+});
+//#endregion
+export { r as buildCreateConversationDto, i as createProjectsApiClient, e as splitProjectConversationId };

package/project/use-pinned-project-chats.d.ts

@@ -0,0 +1,58 @@
+import { ProjectDetailsDto } from '@epam/ai-dial-chat-api-client';
+import { ProjectsApiClient } from './projects-api-client';
+/** Most chats listed under one pinned project. */
+export declare const PINNED_PROJECT_CHATS_LIMIT = 10;
+/** What `usePinnedProjectChats` needs from the host besides the ids. */
+export interface PinnedProjectChatsOptions {
+    /** No request is sent and `projects` is empty while `false`. */
+    enabled: boolean;
+    /** The project no longer exists (a watch `DELETE`, or `404` on a read). Called at most once per id. */
+    onProjectDeleted: (projectId: string) => void;
+}
+/** A chat listed under a pinned project. */
+export interface PinnedProjectChat {
+    /** The conversation's DIAL id. */
+    id: string;
+    /** Display title; the file-name title when its body could not be read. */
+    title: string;
+    /** The caller has not seen the conversation's current version. */
+    isUnread?: boolean;
+}
+/** A loaded pinned project and its newest chats. */
+export interface PinnedProjectChats {
+    /** The project's details as last read; `canEdit`, `canManage`, `contentVersion` and `conversationCount` feed the host's actions. */
+    project: ProjectDetailsDto;
+    /** At most `PINNED_PROJECT_CHATS_LIMIT` chats, newest first. */
+    chats: PinnedProjectChat[];
+    /** The project has more chats than `chats` holds. */
+    hasMore: boolean;
+}
+/** What `usePinnedProjectChats` returns. */
+export interface PinnedProjectChatsResult {
+    /** Loaded projects, in `projectIds` order; an id whose load failed is absent while it is retried. */
+    projects: PinnedProjectChats[];
+    /** True until every id of the current `projectIds` settled once. */
+    isLoading: boolean;
+    /** Clears a chat's unread state locally until a read reports a newer version. Sends no request. */
+    markViewed: (conversationId: string) => void;
+    /** Silently re-reads one loaded project, through the same per-project gate as a watch event. */
+    refresh: (projectId: string) => void;
+}
+/**
+ * Loads each pinned project's details and newest chats through the injected
+ * client, and keeps them current with one watch stream over every pinned
+ * project. A changed project is refreshed silently, one refresh at a time per
+ * project plus one trailing run; a deleted one is dropped and reported. A
+ * first load that fails with anything but a `404` is retried with a bounded
+ * backoff, and the project stays out of the watch until it loads. A dropped
+ * stream is reopened with a bounded backoff and followed by a refresh of every
+ * project; a watch that cannot be opened is not retried for the same projects.
+ * Requests are aborted on unmount, when `enabled` turns false, and for an id
+ * that leaves `projectIds`.
+ *
+ * @param client - Configured project requests, from `createProjectsApiClient`; it must be referentially stable, because a new object reloads.
+ * @param projectIds - The pinned project ids, in display order.
+ * @param options - Whether the tree is enabled and the delete callback; the callback is read at event time, so a new identity never resubscribes.
+ */
+export declare const usePinnedProjectChats: (client: Pick<ProjectsApiClient, "getProject" | "listProjectConversations" | "getProjectConversationTitles" | "watchProjects">, projectIds: string[], { enabled, onProjectDeleted }: PinnedProjectChatsOptions) => PinnedProjectChatsResult;
+//# sourceMappingURL=use-pinned-project-chats.d.ts.map

package/project/use-pinned-project-chats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-pinned-project-chats.d.ts","sourceRoot":"","sources":["../../src/project/use-pinned-project-chats.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAKvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,kDAAkD;AAClD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAW7C,wEAAwE;AACxE,MAAM,WAAW,yBAAyB;IACxC,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,uGAAuG;IACvG,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,oIAAoI;IACpI,OAAO,EAAE,iBAAiB,CAAC;IAC3B,gEAAgE;IAChE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,wBAAwB;IACvC,qGAAqG;IACrG,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAC;IACnB,mGAAmG;IACnG,UAAU,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,gGAAgG;IAChG,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAiFD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,IAAI,CACV,iBAAiB,EACf,YAAY,GACZ,0BAA0B,GAC1B,8BAA8B,GAC9B,eAAe,CAClB,EACD,YAAY,MAAM,EAAE,EACpB,+BAA+B,yBAAyB,KACvD,wBAqXF,CAAC"}

package/project/use-pinned-project-chats.js

@@ -0,0 +1,269 @@
+import { getApiErrorStatus as e } from "../api-error/api-error.js";
+import { runProjectWatch as t } from "./project-watch-stream.js";
+import { applyViewedMark as n } from "./project-viewed-marks.js";
+import { ProjectWatchAction as r } from "@epam/ai-dial-chat-api-client";
+import { useCallback as i, useEffect as a, useMemo as o, useRef as s, useState as c } from "react";
+//#region src/project/use-pinned-project-chats.ts
+var l = 10, u = 1e3, d = [
+	1e3,
+	2e3,
+	4e3,
+	8e3,
+	16e3
+], f = "\n", p = {
+	snapshots: /* @__PURE__ */ new Map(),
+	settled: /* @__PURE__ */ new Set(),
+	watchKey: ""
+}, m = [], h = (e, { settled: t, snapshots: n }, r) => {
+	let i = [...e].sort();
+	return i.every((e) => t.has(e)) ? i.filter((e) => n.has(e)).slice(0, u).join(f) : r;
+}, g = (e, t) => {
+	if (!e.snapshots.has(t) && !e.settled.has(t)) return e;
+	let n = new Map(e.snapshots);
+	n.delete(t);
+	let r = new Set(e.settled);
+	return r.delete(t), {
+		...e,
+		snapshots: n,
+		settled: r
+	};
+}, _ = (e, t) => {
+	if (t.length === 0) return e;
+	let n = new Map(t.map((e) => [e.id, e]));
+	return e.map((e) => {
+		let t = n.get(e.id);
+		return t ? {
+			...e,
+			title: t.title,
+			isTitlePending: !1
+		} : e;
+	});
+}, v = (l, u, { enabled: v, onProjectDeleted: y }) => {
+	let [b, x] = c(p), S = s(b);
+	a(() => {
+		S.current = b;
+	});
+	let C = s(y);
+	a(() => {
+		C.current = y;
+	});
+	let w = s(/* @__PURE__ */ new Set()), T = s(/* @__PURE__ */ new Map()), E = s(/* @__PURE__ */ new Map()), D = s(/* @__PURE__ */ new Set()), O = s(/* @__PURE__ */ new Map()), k = s(/* @__PURE__ */ new Map()), A = s(null), j = o(() => [...new Set(u)].sort().join(f), [u]), M = i(async (e, t) => {
+		let [n, r] = await Promise.allSettled([l.getProject(e, t), l.listProjectConversations(e, t)]);
+		if (n.status === "rejected") throw n.reason;
+		let i = r.status === "fulfilled" ? r.value.items : [], a = i.slice(0, 10), o = a.filter((e) => e.isTitlePending).map((e) => e.name);
+		if (o.length > 0) try {
+			let { items: n } = await l.getProjectConversationTitles(e, o, t);
+			a = _(a, n);
+		} catch {}
+		return {
+			project: n.value,
+			items: a,
+			hasMore: i.length > 10
+		};
+	}, [l]), N = i(({ project: e, items: t, hasMore: r }) => {
+		for (let { id: e, updatedAt: n } of t) k.current.set(e, n);
+		return {
+			project: e,
+			hasMore: r,
+			chats: t.map((e) => ({
+				id: e.id,
+				title: e.title,
+				...n(O.current, e) ? { isUnread: !0 } : {}
+			}))
+		};
+	}, []), P = i((e) => {
+		D.current.has(e) || (D.current.add(e), C.current(e));
+	}, []), F = i((e) => {
+		E.current.get(e)?.controller?.abort(), E.current.delete(e);
+	}, []), I = i((e) => {
+		F(e), x((t) => {
+			if (!t.snapshots.has(e)) return t;
+			let n = new Map(t.snapshots);
+			return n.delete(e), {
+				...t,
+				snapshots: n,
+				watchKey: h(w.current, {
+					settled: t.settled,
+					snapshots: n
+				}, t.watchKey)
+			};
+		});
+	}, [F]), L = i((t) => {
+		if (!S.current.snapshots.has(t)) return;
+		let n = E.current.get(t);
+		if (n ?? (n = {
+			isRefreshing: !1,
+			isPending: !1
+		}, E.current.set(t, n)), n.isRefreshing) {
+			n.isPending = !0;
+			return;
+		}
+		let r = n, i = new AbortController();
+		r.isRefreshing = !0, r.controller = i, (async () => {
+			try {
+				let e = await M(t, i.signal);
+				if (i.signal.aborted) return;
+				let n = N(e);
+				x((e) => {
+					if (!e.snapshots.has(t)) return e;
+					let r = new Map(e.snapshots);
+					return r.set(t, n), {
+						...e,
+						snapshots: r
+					};
+				});
+			} catch (n) {
+				if (i.signal.aborted) return;
+				e(n) === 404 && (I(t), P(t));
+			} finally {
+				r.isRefreshing = !1, r.isPending && !i.signal.aborted && E.current.get(t) === r && (r.isPending = !1, L(t));
+			}
+		})();
+	}, [
+		I,
+		M,
+		P,
+		N
+	]), R = i((t, n, r = 0) => {
+		let i = () => {
+			T.current.get(t) === n && T.current.delete(t);
+		};
+		(async () => {
+			try {
+				let e = await M(t, n.signal);
+				if (n.signal.aborted) return;
+				let r = N(e);
+				x((e) => {
+					let n = new Map(e.snapshots);
+					n.set(t, r);
+					let i = new Set(e.settled).add(t);
+					return {
+						snapshots: n,
+						settled: i,
+						watchKey: h(w.current, {
+							settled: i,
+							snapshots: n
+						}, e.watchKey)
+					};
+				}), i();
+			} catch (a) {
+				if (n.signal.aborted) return;
+				x((e) => {
+					if (e.settled.has(t)) return e;
+					let n = new Set(e.settled).add(t);
+					return {
+						...e,
+						settled: n,
+						watchKey: h(w.current, {
+							settled: n,
+							snapshots: e.snapshots
+						}, e.watchKey)
+					};
+				});
+				let o = e(a) === 404, s = o ? void 0 : d[r];
+				if (s == null) {
+					i(), o && P(t);
+					return;
+				}
+				let c = setTimeout(() => R(t, n, r + 1), s);
+				n.signal.addEventListener("abort", () => clearTimeout(c), { once: !0 });
+			}
+		})();
+	}, [
+		M,
+		P,
+		N
+	]);
+	a(() => () => {
+		for (let e of T.current.values()) e.abort();
+		T.current.clear();
+		for (let e of E.current.values()) e.controller?.abort();
+		E.current.clear(), w.current.clear(), D.current.clear(), O.current.clear(), k.current.clear(), x(p);
+	}, [l, v]), a(() => {
+		if (!v) return;
+		let e = new Set(j === "" ? [] : j.split(f));
+		for (let t of [...w.current]) e.has(t) || (w.current.delete(t), D.current.delete(t), T.current.get(t)?.abort(), T.current.delete(t), F(t), x((e) => {
+			let n = g(e, t);
+			return {
+				...n,
+				watchKey: h(w.current, n, e.watchKey)
+			};
+		}));
+		for (let t of e) {
+			if (w.current.has(t)) continue;
+			w.current.add(t);
+			let e = new AbortController();
+			T.current.set(t, e), R(t, e);
+		}
+	}, [
+		v,
+		j,
+		F,
+		R
+	]);
+	let z = v && j !== "" && j.split(f).some((e) => !b.settled.has(e)), B = v ? b.watchKey : "", { watchProjects: V } = l;
+	a(() => {
+		if (V == null || B === "" || B === A.current) return;
+		let e = new AbortController();
+		return t({
+			watchProjects: V,
+			ids: B.split(f),
+			signal: e.signal,
+			onEvent: (t) => {
+				if (e.signal.aborted) return;
+				let n = S.current.snapshots.get(t.id);
+				n != null && (t.action === r.Delete ? (I(t.id), P(t.id)) : (t.etag == null || t.etag !== n.project.etag) && L(t.id));
+			},
+			onReconnected: () => {
+				for (let e of S.current.snapshots.keys()) L(e);
+			},
+			onUnavailable: () => {
+				A.current = B;
+			}
+		}), () => e.abort();
+	}, [
+		V,
+		B,
+		I,
+		P,
+		L
+	]);
+	let H = i((e) => {
+		k.current.has(e) && (O.current.set(e, k.current.get(e)), x((t) => {
+			let n;
+			for (let [r, i] of t.snapshots) i.chats.some((t) => t.id === e && t.isUnread) && (n ??= new Map(t.snapshots), n.set(r, {
+				...i,
+				chats: i.chats.map((t) => t.id === e ? {
+					id: t.id,
+					title: t.title
+				} : t)
+			}));
+			return n ? {
+				...t,
+				snapshots: n
+			} : t;
+		}));
+	}, []);
+	return {
+		projects: o(() => {
+			if (!v) return m;
+			let e = /* @__PURE__ */ new Set(), t = [];
+			for (let n of u) {
+				if (e.has(n)) continue;
+				e.add(n);
+				let r = b.snapshots.get(n);
+				r && t.push(r);
+			}
+			return t;
+		}, [
+			v,
+			u,
+			b.snapshots
+		]),
+		isLoading: z,
+		markViewed: H,
+		refresh: L
+	};
+};
+//#endregion
+export { l as PINNED_PROJECT_CHATS_LIMIT, v as usePinnedProjectChats };

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

@@ -0,0 +1,53 @@
+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",
+    Unpin = "unpin",
+    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;
+    /** Whether the delete confirmation is open, when the host owns that state. Defaults to the hook's own state. */
+    isDeleteOpen?: boolean;
+    /** Called with the new state whenever the delete confirmation opens or closes: a request, a cancel, a success or a conflict. */
+    onDeleteOpenChange?: (isOpen: boolean) => 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">, project: ProjectDetailsDto | null, { isPinned, setPinned, saveFile, onArchiveDownloaded, onDeleted, onError, onReload, isDeleteOpen: controlledDeleteOpen, onDeleteOpenChange, }: ProjectActionsHandlers) => {
+    isPinned: boolean;
+    isPinPending: boolean;
+    togglePin: () => Promise<void>;
+    downloadArchive: () => 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,KAAK,UAAU;IACf,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;IACrB,gHAAgH;IAChH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gIAAgI;IAChI,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAChD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,wBAAwB,CAAC,EAC3E,SAAS,iBAAiB,GAAG,IAAI,EACjC,+IAUG,sBAAsB;;;;;;;;;;CA4G1B,CAAC"}