@epam/ai-dial-chat-hooks 1.3.0-dev.34 → 1.3.0-dev.342

package/api-error/api-error.d.ts

@@ -0,0 +1,32 @@
+/** Normalized shape returned by {@link getApiErrorDetails}. */
+export interface ApiErrorDetails {
+    /** Stable domain error code supplied by the API, when present. */
+    code?: string;
+    /** HTTP status code carried by the error, when available. */
+    status?: number;
+    /** Resolved human-readable error message, or `null` when none could be resolved. */
+    message: string | null;
+    /** Extracted W3C trace ID, when the error's response carries a valid `traceparent`. */
+    traceId?: string;
+    /**
+     * Error code reported by the service behind the API, when the API forwards one
+     * (`upstreamCode`). Passed through as-is; the host decides whether to act on it.
+     */
+    upstreamCode?: string;
+    /**
+     * Error reason reported by the service behind the API, when the API forwards one
+     * (`upstreamMessage`). Untranslated; the host decides whether to display it.
+     */
+    upstreamMessage?: string;
+}
+/** True when the API indicates the conversation resource no longer exists at the path. */
+export declare const isConversationNotFoundError: (error: unknown) => boolean;
+/** HTTP status code carried by a thrown API error, or `undefined` if none is attached. */
+export declare const getApiErrorStatus: (error: unknown) => number | undefined;
+/** Resolves a human-readable message from an API error's response body, or falls back to `Error.message`. */
+export declare const getApiErrorMessage: (error: unknown) => Promise<string | null>;
+/** Normalizes any API error into a `{ status?, message, traceId?, code?, upstreamCode?, upstreamMessage? }` shape. */
+export declare const getApiErrorDetails: (error: unknown) => Promise<ApiErrorDetails>;
+/** Shared item's title carried by a refused `acceptInvitation` error, when the backend sent one. */
+export declare const getAcceptInvitationErrorItemName: (error: unknown) => Promise<string | undefined>;
+//# sourceMappingURL=api-error.d.ts.map

package/api-error/api-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-error.d.ts","sourceRoot":"","sources":["../../src/api-error/api-error.ts"],"names":[],"mappings":"AAWA,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAqED,0FAA0F;AAC1F,eAAO,MAAM,2BAA2B,GAAI,OAAO,OAAO,KAAG,OAI5D,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAC3B,CAAC;AAElC,6GAA6G;AAC7G,eAAO,MAAM,kBAAkB,GAC7B,OAAO,OAAO,KACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAevB,CAAC;AAEF,sHAAsH;AActH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,OAAO,KACb,OAAO,CAAC,eAAe,CAyDzB,CAAC;AAEF,oGAAoG;AACpG,eAAO,MAAM,gCAAgC,GAC3C,OAAO,OAAO,KACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAY5B,CAAC"}

package/api-error/api-error.js

@@ -1,40 +1,41 @@
+import { ResponseError as e } from "@epam/ai-dial-chat-api-client";
 //#region src/api-error/api-error.ts
-var e = (e) => typeof e == "object" && !!e, t = (t) => {
-	if (!e(t)) return !1;
-	let { message: n, error: r } = t;
+var t = (e) => typeof e == "object" && !!e, n = (e) => {
+	if (!t(e)) return !1;
+	let { message: n, error: r } = e;
 	return typeof n == "string" || Array.isArray(n) && n.every((e) => typeof e == "string") || typeof r == "string";
-}, n = (e) => t(e) ? Array.isArray(e.message) ? e.message.join("\n") : e.message ? e.message : e.error ? e.error : null : null, r = /^00-([0-9a-f]{32})-([0-9a-f]{16})-[0-9a-f]{2}$/, i = "0".repeat(32), a = "0".repeat(16), o = (e) => {
+}, r = (e) => n(e) ? Array.isArray(e.message) ? e.message.join("\n") : e.message ? e.message : e.error ? e.error : null : null, i = /^00-([0-9a-f]{32})-([0-9a-f]{16})-[0-9a-f]{2}$/, a = "0".repeat(32), o = "0".repeat(16), s = (e) => {
 	if (typeof e != "string") return;
-	let t = r.exec(e);
+	let t = i.exec(e);
 	if (!t) return;
-	let [, n, o] = t;
-	if (!(n === i || o === a)) return n;
-}, s = (t) => {
-	if (!e(t)) return;
-	let n = t.response;
-	if (!(!e(n) || typeof n.json != "function")) return n;
+	let [, n, r] = t;
+	if (n !== a && r !== o) return n;
 }, c = (e) => {
-	let t = s(e);
+	if (!t(e)) return;
+	let n = e.response;
+	if (t(n) && typeof n.json == "function") return n;
+}, l = (e) => {
+	let t = c(e);
 	return t?.status ? t.status === 404 : !1;
-}, l = (e) => s(e)?.status, u = async (e) => {
-	let t = s(e);
+}, u = (e) => c(e)?.status, d = async (e) => {
+	let t = c(e);
 	if (t) try {
-		let e = n(await t.json());
+		let e = r(await t.json());
 		if (e !== null) return e;
 	} catch {
 		return null;
 	}
 	return e instanceof Error && e.message ? e.message : null;
-}, d = async (t) => {
-	let r = s(t), i = r?.status, a = null, c, l = !1, u, d, f;
-	if (r) try {
-		let t = await (typeof r.clone == "function" ? r.clone() : r).json();
-		a = n(t), e(t) && (u = typeof t.code == "string" ? t.code : void 0, d = typeof t.upstreamCode == "string" ? t.upstreamCode : void 0, f = typeof t.upstreamMessage == "string" ? t.upstreamMessage : void 0, c = o(t.traceparent));
+}, f = async (e) => {
+	let n = c(e), i = n?.status, a = null, o, l = !1, u, d, f;
+	if (n) try {
+		let e = await (typeof n.clone == "function" ? n.clone() : n).json();
+		a = r(e), t(e) && (u = typeof e.code == "string" ? e.code : void 0, d = typeof e.upstreamCode == "string" ? e.upstreamCode : void 0, f = typeof e.upstreamMessage == "string" ? e.upstreamMessage : void 0, o = s(e.traceparent));
 	} catch {
 		l = !0;
 	}
-	!l && a === null && t instanceof Error && t.message && (a = t.message);
-	let p = c ?? o(typeof r?.headers?.get == "function" ? r.headers.get("traceparent") : void 0);
+	!l && a === null && e instanceof Error && e.message && (a = e.message);
+	let p = o ?? s(typeof n?.headers?.get == "function" ? n.headers.get("traceparent") : void 0);
 	return {
 		status: i,
 		message: a,
@@ -43,6 +44,13 @@ var e = (e) => typeof e == "object" && !!e, t = (t) => {
 		...d ? { upstreamCode: d } : {},
 		...f ? { upstreamMessage: f } : {}
 	};
+}, p = async (t) => {
+	if (t instanceof e) try {
+		let e = await t.response.clone().json();
+		return typeof e.itemName == "string" && e.itemName ? e.itemName : void 0;
+	} catch {
+		return;
+	}
 };
 //#endregion
-export { d as getApiErrorDetails, u as getApiErrorMessage, l as getApiErrorStatus, c as isConversationNotFoundError };
+export { p as getAcceptInvitationErrorItemName, f as getApiErrorDetails, d as getApiErrorMessage, u as getApiErrorStatus, l as isConversationNotFoundError };

package/api-transport/create-csrf-middleware.d.ts

@@ -0,0 +1,15 @@
+import { Middleware } from '@epam/ai-dial-chat-api-client';
+/** Host capabilities {@link createCsrfMiddleware} needs to attach and capture a CSRF token. */
+export interface CreateCsrfMiddlewareDeps {
+    /** Returns the currently held CSRF token, or `null` when none is set. */
+    getCsrfToken: () => string | null;
+    /** Stores a CSRF token captured from a response header, or `null` to clear it. */
+    setCsrfToken: (token: string | null) => void;
+}
+/**
+ * Builds a generated-client `Middleware` that attaches `X-CSRF-Token` on every
+ * non-GET request when a token is set, and captures a rotated token from the
+ * `x-csrf-token` response header.
+ */
+export declare const createCsrfMiddleware: (deps: CreateCsrfMiddlewareDeps) => Middleware;
+//# sourceMappingURL=create-csrf-middleware.d.ts.map

package/api-transport/create-csrf-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-csrf-middleware.d.ts","sourceRoot":"","sources":["../../src/api-transport/create-csrf-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,+FAA+F;AAC/F,MAAM,WAAW,wBAAwB;IACvC,yEAAyE;IACzE,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,kFAAkF;IAClF,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC9C;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,wBAAwB,KAC7B,UAqBD,CAAC"}

package/api-transport/create-unauthorized-middleware.d.ts

@@ -0,0 +1,40 @@
+import { Middleware } from '@epam/ai-dial-chat-api-client';
+/** Outcome of a CSRF-token refresh attempt, reported back to {@link createUnauthorizedMiddleware}. */
+export type CsrfRefreshOutcome = {
+    status: 'ok';
+    token: string;
+} | {
+    status: 'unauthorized' | 'failed';
+};
+/** An error thrown to indicate the caller is unauthenticated. */
+export interface UnauthorizedErrorLike extends Error {
+    readonly status: 401;
+    readonly url: string;
+}
+/** Host capabilities {@link createUnauthorizedMiddleware} needs to handle 401s and invalid-CSRF retries. */
+export interface CreateUnauthorizedMiddlewareDeps {
+    /** Notifies the host that a request was unauthorized (also expected to clear any held CSRF token). */
+    notifyUnauthorized: (url: string) => void;
+    /** Attempts to refresh the CSRF token, de-duplicating concurrent calls. */
+    refreshCsrfToken: () => Promise<CsrfRefreshOutcome>;
+    /** Classifies a response body as an invalid-CSRF error. */
+    isInvalidCsrfErrorBody: (body: string) => boolean;
+    /** Returns the currently held CSRF token, or `null` when none is set. */
+    getCsrfToken: () => string | null;
+    /**
+     * Stores a CSRF token captured from a response header. Needed here (in
+     * addition to the CSRF middleware's own `post` hook) because the
+     * invalid-CSRF retry issues its own `fetch` outside the generated-client
+     * middleware pipeline, so its response header is never seen by that hook.
+     */
+    setCsrfToken: (token: string | null) => void;
+    /** Constructs the error thrown to signal an unauthorized request. */
+    createUnauthorizedError: (url: string) => UnauthorizedErrorLike;
+}
+/**
+ * Builds a generated-client `Middleware` that throws on 401, and on a
+ * classified invalid-CSRF 403 refreshes the token and retries the original
+ * request exactly once.
+ */
+export declare const createUnauthorizedMiddleware: (deps: CreateUnauthorizedMiddlewareDeps) => Middleware;
+//# sourceMappingURL=create-unauthorized-middleware.d.ts.map

package/api-transport/create-unauthorized-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-unauthorized-middleware.d.ts","sourceRoot":"","sources":["../../src/api-transport/create-unauthorized-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAIhE,sGAAsG;AACtG,MAAM,MAAM,kBAAkB,GAC5B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,cAAc,GAAG,QAAQ,CAAA;CAAE,CAAC;AAE1E,iEAAiE;AACjE,MAAM,WAAW,qBAAsB,SAAQ,KAAK;IAClD,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,4GAA4G;AAC5G,MAAM,WAAW,gCAAgC;IAC/C,sGAAsG;IACtG,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpD,2DAA2D;IAC3D,sBAAsB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAClD,yEAAyE;IACzE,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC;;;;;OAKG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7C,qEAAqE;IACrE,uBAAuB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,qBAAqB,CAAC;CACjE;AAgCD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GACvC,MAAM,gCAAgC,KACrC,UAoEF,CAAC"}

package/api-transport/create-unauthorized-middleware.js

@@ -32,7 +32,10 @@ var e = async (e) => {
 		if (t.response.status === 401) throw r.notifyUnauthorized(t.url), r.createUnauthorizedError(t.url);
 		if (t.response.status === 403) {
 			let n = await e(t.response);
-			if (r.isInvalidCsrfErrorBody(n)) return a(t, await i(t));
+			if (r.isInvalidCsrfErrorBody(n)) {
+				let e = await i(t);
+				return a(t, e);
+			}
 		}
 		return t.response;
 	} };

package/attachment/attach-constraints.d.ts

@@ -0,0 +1,31 @@
+/** The limits an attach dialog enforces; an absent or non-positive value is no limit. */
+export interface AttachConstraints {
+    /** Allowed MIME types; `*` or `*\/*` allows every type. */
+    allowedTypes?: readonly string[];
+    /** Host-written label for the allowed types, used instead of one derived from `allowedTypes`. */
+    allowedTypesLabel?: string;
+    /** Largest file size, in bytes. */
+    maxFileSize?: number;
+    /** Most files per attach. */
+    maxCount?: number;
+}
+/** Localized pieces of the constraint description. */
+export interface AttachConstraintLabels {
+    /** Type label when every type is allowed, e.g. `'All types'`. */
+    allTypes: string;
+    /** Sentence naming the size limit and the allowed types. */
+    maxSizeWithTypes: (maxSize: string, allowedTypes: string) => string;
+    /** Sentence naming only the size limit. */
+    maxSizeOnly: (maxSize: string) => string;
+    /** Sentence naming the file-count limit. */
+    upToFiles: (count: number) => string;
+}
+/** Returns `true` when the MIME-type list allows every type (`*` or `*\/*`). */
+export declare const areAllMimeTypesAllowed: (types: readonly string[]) => boolean;
+/**
+ * Returns the attach dialog's constraint description — the size and type
+ * limits as one sentence, then the count limit, joined with `. ` and ending
+ * in `.` — or `null` when nothing is limited.
+ */
+export declare const buildAttachConstraintDescription: (constraints: AttachConstraints, labels: AttachConstraintLabels) => string | null;
+//# sourceMappingURL=attach-constraints.d.ts.map

package/attachment/attach-constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach-constraints.d.ts","sourceRoot":"","sources":["../../src/attachment/attach-constraints.ts"],"names":[],"mappings":"AAGA,yFAAyF;AACzF,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,iGAAiG;IACjG,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,sDAAsD;AACtD,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IACpE,2CAA2C;IAC3C,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC,4CAA4C;IAC5C,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC;AAED,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,GAAI,OAAO,SAAS,MAAM,EAAE,KAAG,OACZ,CAAC;AAYvD;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,GAC3C,aAAa,iBAAiB,EAC9B,QAAQ,sBAAsB,KAC7B,MAAM,GAAG,IA+BX,CAAC"}

package/attachment/attach-constraints.js

@@ -0,0 +1,18 @@
+import { formatFileSize as e } from "@epam/ai-dial-chat-shared";
+import { mimeTypesToExtensionLabels as t } from "@epam/ai-dial-attachment-input";
+//#region src/attachment/attach-constraints.ts
+var n = (e) => e.some((e) => e === "*" || e === "*/*"), r = ({ allowedTypes: e, allowedTypesLabel: r }, i) => {
+	if (r != null) return r;
+	if (e != null && e.length !== 0) return n(e) ? i.allTypes : t([...e]);
+}, i = (t, n) => {
+	let { allowedTypes: i, maxFileSize: a, maxCount: o } = t, s = i != null && i.length > 0, c = a != null && a > 0, l = o != null && o > 0 && Number.isFinite(o);
+	if (!s && !c && !l) return null;
+	let u = [];
+	if (s || c) {
+		let i = r(t, n), o = c ? e(a) : void 0;
+		i != null && o != null ? u.push(n.maxSizeWithTypes(o, i)) : o == null ? i != null && u.push(i) : u.push(n.maxSizeOnly(o));
+	}
+	return l && u.push(n.upToFiles(o)), `${u.join(". ")}.`;
+};
+//#endregion
+export { n as areAllMimeTypesAllowed, i as buildAttachConstraintDescription };

package/attachment/useAttachmentAction/useAttachmentAction.d.ts

@@ -0,0 +1,32 @@
+import { DisplayAttachment } from '@epam/ai-dial-chat-shared';
+/** Resolves a DIAL Core file id to a downloadable URL. Host-owned — encodes the app's own file-download endpoint. */
+export type ResolveDownloadUrl = (fileId: string) => string | undefined;
+/** Parameters for {@link useAttachmentAction}. */
+export interface UseAttachmentActionParams {
+    /** Resolves a DIAL Core file id to a downloadable URL. */
+    resolveDownloadUrl: ResolveDownloadUrl;
+}
+/** Return value of {@link useAttachmentAction}. */
+export interface UseAttachmentActionResult {
+    /** Default click handler for an attachment tile: download, canvas-preview, or open-in-browser. */
+    handleAttachmentClick: (attachment: DisplayAttachment) => void;
+}
+/** Returns true when `downloadAttachment` can trigger a download for `attachment`; a DIAL folder attachment is not downloadable. */
+export declare const isDownloadableAttachment: (attachment: DisplayAttachment) => boolean;
+/**
+ * Downloads an attachment that carries its own content: a DIAL-hosted file
+ * (`url` resolves to a DIAL file id) or an inline `data` payload. Returns
+ * whether a download was actually triggered, so callers can skip
+ * non-downloadable (reference-only) attachments without duplicating the
+ * DIAL-file-id / URL-resolution checks.
+ */
+export declare const downloadAttachment: (attachment: DisplayAttachment, resolveDownloadUrl: ResolveDownloadUrl) => boolean;
+/**
+ * Default click behavior for a plain attachment tile: downloads DIAL-hosted
+ * and inline (`data`) files, and for reference-only attachments (no `url`/`data`,
+ * only `referenceUrl` — e.g. RAG/search-grounding chunks), opens a PDF
+ * `referenceUrl` in the canvas scrolled to its referenced page when present,
+ * otherwise opens/downloads the `referenceUrl` as-is.
+ */
+export declare const useAttachmentAction: ({ resolveDownloadUrl, }: UseAttachmentActionParams) => UseAttachmentActionResult;
+//# sourceMappingURL=useAttachmentAction.d.ts.map

package/attachment/useAttachmentAction/useAttachmentAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachmentAction.d.ts","sourceRoot":"","sources":["../../../src/attachment/useAttachmentAction/useAttachmentAction.ts"],"names":[],"mappings":"AAKA,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AAKnC,qHAAqH;AACrH,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAExE,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,0DAA0D;IAC1D,kBAAkB,EAAE,kBAAkB,CAAC;CACxC;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,kGAAkG;IAClG,qBAAqB,EAAE,CAAC,UAAU,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAChE;AAMD,oIAAoI;AACpI,eAAO,MAAM,wBAAwB,GACnC,YAAY,iBAAiB,KAC5B,OACkE,CAAC;AAEtE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,iBAAiB,EAC7B,oBAAoB,kBAAkB,KACrC,OA0BF,CAAC;AAsDF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,yBAEjC,yBAAyB,KAAG,yBAmC9B,CAAC"}

package/attachment/useAttachmentAction/useAttachmentAction.js

@@ -1,37 +1,38 @@
-import { isDialFileId as e } from "../../files/dial-file.js";
-import { AttachmentContentType as t, useAttachmentCanvas as n } from "@epam/ai-dial-attachment-canvas";
-import { MIMEType as r, base64ToBlob as i, ensureDownloadFilename as a, triggerAnchorDownload as o, triggerBlobDownload as s } from "@epam/ai-dial-chat-shared";
-import { parsePdfPageReference as c } from "@epam/ai-dial-quotations";
-import { useCallback as l } from "react";
+import { isDialFileId as e, isDialFolderId as t } from "../../files/dial-file.js";
+import { AttachmentContentType as n, useAttachmentCanvas as r } from "@epam/ai-dial-attachment-canvas";
+import { MIMEType as i, base64ToBlob as a, ensureDownloadFilename as o, triggerAnchorDownload as s, triggerBlobDownload as c } from "@epam/ai-dial-chat-shared";
+import { parsePdfPageReference as l } from "@epam/ai-dial-quotations";
+import { useCallback as u } from "react";
 //#region src/attachment/useAttachmentAction/useAttachmentAction.ts
-var u = (t) => t.url != null && e(t.url) || t.data != null, d = (t, n) => {
-	let { url: c, name: l, contentType: u, data: d } = t;
-	if (c != null && e(c)) {
-		let e = n(c);
-		return e == null ? !1 : (o(e, a(l, c, u)), !0);
+var d = (n) => n != null && e(n) && !t(n), f = (e) => d(e.url) || e.data != null, p = (e, t) => {
+	let { url: n, name: r, contentType: l, data: u } = e;
+	if (d(n)) {
+		let e = t(n);
+		return e != null && (s(e, o(r, n, l)), !0);
 	}
-	return d == null ? !1 : (s(i(d, u || r.Plain), a(l, c, u)), !0);
-}, f = (t, n) => {
+	return u != null && (c(a(u, l || i.Plain), o(r, n, l)), !0);
+}, m = (t, n) => {
 	let { url: r } = t;
 	if (r == null) return;
 	let i = r.split("#")[0];
 	if (e(i)) {
 		let e = n(i);
 		if (e == null) return;
-		o(e, a(t.title ?? i.split("/").pop() ?? "", i, t.type));
+		let r = t.title ?? i.split("/").pop() ?? "";
+		s(e, o(r, i, t.type));
 	} else window.open(r, "_blank", "noopener,noreferrer");
-}, p = (n, r) => {
-	let i = c(n.url);
+}, h = (t, r) => {
+	let i = l(t.url);
 	if (i == null) return null;
 	let a = e(i.baseUrl) ? r(i.baseUrl) : i.baseUrl;
 	if (a == null) return null;
 	if (i.page == null) return {
-		type: t.Pdf,
+		type: n.Pdf,
 		url: a
 	};
 	let o = `reference-page-${i.page}`;
 	return {
-		type: t.Pdf,
+		type: n.Pdf,
 		url: a,
 		highlights: [{
 			id: o,
@@ -49,12 +50,12 @@ var u = (t) => t.url != null && e(t.url) || t.data != null, d = (t, n) => {
 		}],
 		selectedHighlightId: o
 	};
-}, m = ({ resolveDownloadUrl: e }) => {
-	let { openCanvas: t } = n();
-	return { handleAttachmentClick: l((n) => {
+}, g = ({ resolveDownloadUrl: e }) => {
+	let { openCanvas: t } = r();
+	return { handleAttachmentClick: u((n) => {
 		let { url: r, referenceUrl: i, data: a, name: o } = n;
 		if (r != null || a != null) {
-			d(n, e);
+			p(n, e);
 			return;
 		}
 		if (i == null) return;
@@ -62,13 +63,9 @@ var u = (t) => t.url != null && e(t.url) || t.data != null, d = (t, n) => {
 			type: n.contentType,
 			url: i,
 			title: o
-		}, c = p(s, e);
-		if (c) {
-			t(c, o);
-			return;
-		}
-		f(s, e);
+		}, c = h(s, e);
+		c ? t(c, o) : m(s, e);
 	}, [t, e]) };
 };
 //#endregion
-export { d as downloadAttachment, u as isDownloadableAttachment, m as useAttachmentAction };
+export { p as downloadAttachment, f as isDownloadableAttachment, g as useAttachmentAction };

package/attachment/useAttachmentValidation/useAttachmentValidation.d.ts

@@ -0,0 +1,50 @@
+import { AttachmentErrorReason, Attachment } from '@epam/ai-dial-chat-shared';
+/** Reason a rejected attachment failed validation. */
+export declare enum AttachmentValidationErrorReason {
+    /** No MIME types are allowed at all — attachments are disabled entirely. */
+    NoTypesAllowed = "noTypesAllowed",
+    /** The attachment's content type is not among the allowed MIME types. */
+    UnsupportedType = "unsupportedType",
+    /** The attachment's file size exceeds `maxFileSizeBytes`. */
+    FileTooLarge = "fileTooLarge"
+}
+/** Structured, translation-free report of a rejected attachment, emitted at most once per debounce window. */
+export interface AttachmentValidationErrorEvent {
+    /** Why the attachment(s) were rejected. */
+    reason: AttachmentValidationErrorReason;
+    /** The resolved MIME types the caller currently allows (possibly empty). Present only when `reason` is `NoTypesAllowed` or `UnsupportedType`. */
+    allowedMimeTypes?: string[];
+    /** Already-formatted, non-translated extension list (e.g. ".png, .jpg"), present only when `reason` is `UnsupportedType`. */
+    formats?: string;
+    /** The size limit, in bytes, that was exceeded. Present only when `reason` is `FileTooLarge`. */
+    maxFileSizeBytes?: number;
+}
+/** Parameters for {@link useAttachmentValidation}. */
+export interface UseAttachmentValidationParams {
+    /** Resolved MIME types currently allowed for attachments. */
+    allowedMimeTypes: string[];
+    /** Maximum attachment file size, in bytes. When omitted, no file is rejected for size. */
+    maxFileSizeBytes?: number;
+    /** Called with a structured event when a rejected attachment is reported, at most once per debounce window. */
+    onValidationError?: (event: AttachmentValidationErrorEvent) => void;
+    /** Debounce window, in ms, before firing `onValidationError` for a rejected file. Defaults to `100`. */
+    debounceMs?: number;
+}
+/** Return value of {@link useAttachmentValidation}. */
+export interface UseAttachmentValidationResult {
+    /** The resolved MIME types currently allowed for attachments (echoes the `allowedMimeTypes` param). */
+    inputAttachmentTypes: string[];
+    /** Whether at least one MIME type is currently allowed. */
+    isAttachmentsAllowed: boolean;
+    /** Classifies an attachment as allowed (`undefined`) or rejected (`AttachmentErrorReason`). */
+    validateAttachment: (attachment: Attachment) => AttachmentErrorReason | undefined;
+    /** `<input accept>` string derived from `allowedMimeTypes`, or `undefined` when any type accepts everything. */
+    fileAccept: string | undefined;
+}
+/**
+ * Validates an attachment's content type against a resolved list of allowed
+ * MIME types, debouncing a burst of rejected files into a single
+ * `onValidationError` call rather than firing one per file.
+ */
+export declare const useAttachmentValidation: ({ allowedMimeTypes, maxFileSizeBytes, onValidationError, debounceMs, }: UseAttachmentValidationParams) => UseAttachmentValidationResult;
+//# sourceMappingURL=useAttachmentValidation.d.ts.map

package/attachment/useAttachmentValidation/useAttachmentValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachmentValidation.d.ts","sourceRoot":"","sources":["../../../src/attachment/useAttachmentValidation/useAttachmentValidation.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,qBAAqB,EACrB,KAAK,UAAU,EAChB,MAAM,2BAA2B,CAAC;AAMnC,sDAAsD;AACtD,oBAAY,+BAA+B;IACzC,4EAA4E;IAC5E,cAAc,mBAAmB;IACjC,yEAAyE;IACzE,eAAe,oBAAoB;IACnC,6DAA6D;IAC7D,YAAY,iBAAiB;CAC9B;AAED,8GAA8G;AAC9G,MAAM,WAAW,8BAA8B;IAC7C,2CAA2C;IAC3C,MAAM,EAAE,+BAA+B,CAAC;IACxC,iJAAiJ;IACjJ,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,6HAA6H;IAC7H,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,sDAAsD;AACtD,MAAM,WAAW,6BAA6B;IAC5C,6DAA6D;IAC7D,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+GAA+G;IAC/G,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAC;IACpE,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uDAAuD;AACvD,MAAM,WAAW,6BAA6B;IAC5C,uGAAuG;IACvG,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,2DAA2D;IAC3D,oBAAoB,EAAE,OAAO,CAAC;IAC9B,+FAA+F;IAC/F,kBAAkB,EAAE,CAClB,UAAU,EAAE,UAAU,KACnB,qBAAqB,GAAG,SAAS,CAAC;IACvC,gHAAgH;IAChH,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,wEAKrC,6BAA6B,KAAG,6BAwFlC,CAAC"}

package/attachments.d.ts

@@ -1,94 +1,2 @@
-import { Attachment } from '@epam/ai-dial-chat-shared';
-import { AttachmentErrorReason } from '@epam/ai-dial-chat-shared';
-import { DisplayAttachment } from '@epam/ai-dial-chat-shared';
-
-/** Structured, translation-free report of a rejected attachment, emitted at most once per debounce window. */
-export declare interface AttachmentValidationErrorEvent {
-    /** Why the attachment(s) were rejected. */
-    reason: AttachmentValidationErrorReason;
-    /** The resolved MIME types the caller currently allows (possibly empty). Present only when `reason` is `NoTypesAllowed` or `UnsupportedType`. */
-    allowedMimeTypes?: string[];
-    /** Already-formatted, non-translated extension list (e.g. ".png, .jpg"), present only when `reason` is `UnsupportedType`. */
-    formats?: string;
-    /** The size limit, in bytes, that was exceeded. Present only when `reason` is `FileTooLarge`. */
-    maxFileSizeBytes?: number;
-}
-
-/** Reason a rejected attachment failed validation. */
-export declare enum AttachmentValidationErrorReason {
-    /** No MIME types are allowed at all — attachments are disabled entirely. */
-    NoTypesAllowed = "noTypesAllowed",
-    /** The attachment's content type is not among the allowed MIME types. */
-    UnsupportedType = "unsupportedType",
-    /** The attachment's file size exceeds `maxFileSizeBytes`. */
-    FileTooLarge = "fileTooLarge"
-}
-
-/**
- * Downloads an attachment that carries its own content: a DIAL-hosted file
- * (`url` resolves to a DIAL file id) or an inline `data` payload. Returns
- * whether a download was actually triggered, so callers can skip
- * non-downloadable (reference-only) attachments without duplicating the
- * DIAL-file-id / URL-resolution checks.
- */
-export declare const downloadAttachment: (attachment: DisplayAttachment, resolveDownloadUrl: ResolveDownloadUrl) => boolean;
-
-/** Returns true when `downloadAttachment` can trigger a download for `attachment`. */
-export declare const isDownloadableAttachment: (attachment: DisplayAttachment) => boolean;
-
-/** Resolves a DIAL Core file id to a downloadable URL. Host-owned — encodes the app's own file-download endpoint. */
-export declare type ResolveDownloadUrl = (fileId: string) => string | undefined;
-
-/**
- * Default click behavior for a plain attachment tile: downloads DIAL-hosted
- * and inline (`data`) files, and for reference-only attachments (no `url`/`data`,
- * only `referenceUrl` — e.g. RAG/search-grounding chunks), opens a PDF
- * `referenceUrl` in the canvas scrolled to its referenced page when present,
- * otherwise opens/downloads the `referenceUrl` as-is.
- */
-export declare const useAttachmentAction: ({ resolveDownloadUrl, }: UseAttachmentActionParams) => UseAttachmentActionResult;
-
-/** Parameters for {@link useAttachmentAction}. */
-export declare interface UseAttachmentActionParams {
-    /** Resolves a DIAL Core file id to a downloadable URL. */
-    resolveDownloadUrl: ResolveDownloadUrl;
-}
-
-/** Return value of {@link useAttachmentAction}. */
-export declare interface UseAttachmentActionResult {
-    /** Default click handler for an attachment tile: download, canvas-preview, or open-in-browser. */
-    handleAttachmentClick: (attachment: DisplayAttachment) => void;
-}
-
-/**
- * Validates an attachment's content type against a resolved list of allowed
- * MIME types, debouncing a burst of rejected files into a single
- * `onValidationError` call rather than firing one per file.
- */
-export declare const useAttachmentValidation: ({ allowedMimeTypes, maxFileSizeBytes, onValidationError, debounceMs, }: UseAttachmentValidationParams) => UseAttachmentValidationResult;
-
-/** Parameters for {@link useAttachmentValidation}. */
-export declare interface UseAttachmentValidationParams {
-    /** Resolved MIME types currently allowed for attachments. */
-    allowedMimeTypes: string[];
-    /** Maximum attachment file size, in bytes. When omitted, no file is rejected for size. */
-    maxFileSizeBytes?: number;
-    /** Called with a structured event when a rejected attachment is reported, at most once per debounce window. */
-    onValidationError?: (event: AttachmentValidationErrorEvent) => void;
-    /** Debounce window, in ms, before firing `onValidationError` for a rejected file. Defaults to `100`. */
-    debounceMs?: number;
-}
-
-/** Return value of {@link useAttachmentValidation}. */
-export declare interface UseAttachmentValidationResult {
-    /** The resolved MIME types currently allowed for attachments (echoes the `allowedMimeTypes` param). */
-    inputAttachmentTypes: string[];
-    /** Whether at least one MIME type is currently allowed. */
-    isAttachmentsAllowed: boolean;
-    /** Classifies an attachment as allowed (`undefined`) or rejected (`AttachmentErrorReason`). */
-    validateAttachment: (attachment: Attachment) => AttachmentErrorReason | undefined;
-    /** `<input accept>` string derived from `allowedMimeTypes`, or `undefined` when any type accepts everything. */
-    fileAccept: string | undefined;
-}
-
-export { }
+export * from './entry-points/attachments.js'
+export {}

package/attachments.js

@@ -1,3 +1,4 @@
 import { downloadAttachment as e, isDownloadableAttachment as t, useAttachmentAction as n } from "./attachment/useAttachmentAction/useAttachmentAction.js";
 import { AttachmentValidationErrorReason as r, useAttachmentValidation as i } from "./attachment/useAttachmentValidation/useAttachmentValidation.js";
-export { r as AttachmentValidationErrorReason, e as downloadAttachment, t as isDownloadableAttachment, n as useAttachmentAction, i as useAttachmentValidation };
+import { areAllMimeTypesAllowed as a, buildAttachConstraintDescription as o } from "./attachment/attach-constraints.js";
+export { r as AttachmentValidationErrorReason, a as areAllMimeTypesAllowed, o as buildAttachConstraintDescription, e as downloadAttachment, t as isDownloadableAttachment, n as useAttachmentAction, i as useAttachmentValidation };

package/catalog/application-credentials.d.ts

@@ -0,0 +1,15 @@
+import { ApplicationCredential, ApplicationCredentialLoginParams } from '@epam/ai-dial-catalog';
+import { ApplicationExternalServiceDto } from '@epam/ai-dial-chat-api-client';
+import { ExternalServiceLoginParams } from '../external-services/useExternalServiceLogin';
+/** Host-resolved inputs of `mapApplicationCredentials`. */
+export interface MapApplicationCredentialsOptions {
+    /** Whether the user's offline credentials are connected, as `useApplicationCredentials` reports. */
+    isOfflineConnected: boolean;
+    /** Localized explanation shown on `DIAL_NATIVE` services. */
+    dialNativeHint?: string;
+}
+/** Returns the credentials-form view of each application external service. */
+export declare const mapApplicationCredentials: (services: readonly ApplicationExternalServiceDto[], { isOfflineConnected, dialNativeHint }: MapApplicationCredentialsOptions) => ApplicationCredential[];
+/** Returns the user-level `login` request for an application external service and the submitted form values. */
+export declare const buildApplicationCredentialLoginParams: (appId: string, service: ApplicationExternalServiceDto, params: ApplicationCredentialLoginParams) => ExternalServiceLoginParams;
+//# sourceMappingURL=application-credentials.d.ts.map

package/catalog/application-credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-credentials.d.ts","sourceRoot":"","sources":["../../src/catalog/application-credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,gCAAgC,EACtC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAIL,KAAK,0BAA0B,EAChC,MAAM,8CAA8C,CAAC;AAGtD,2DAA2D;AAC3D,MAAM,WAAW,gCAAgC;IAC/C,oGAAoG;IACpG,kBAAkB,EAAE,OAAO,CAAC;IAC5B,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB,GACpC,UAAU,SAAS,6BAA6B,EAAE,EAClD,wCAAwC,gCAAgC,KACvE,qBAAqB,EA8BpB,CAAC;AAEL,gHAAgH;AAChH,eAAO,MAAM,qCAAqC,GAChD,OAAO,MAAM,EACb,SAAS,6BAA6B,EACtC,QAAQ,gCAAgC,KACvC,0BASD,CAAC"}

package/catalog/application-credentials.js

@@ -0,0 +1,28 @@
+import { toToolsetOAuthSettings as e } from "../oauth/authorize-url.js";
+import { ExternalServiceAuthStatus as t, ExternalServiceAuthType as n, ExternalServiceCredentialsLevel as r } from "../external-services/useExternalServiceLogin.js";
+import { CredentialStatus as i, ToolsetAuthenticationType as a } from "@epam/ai-dial-catalog";
+//#region src/catalog/application-credentials.ts
+var o = (e, { isOfflineConnected: r, dialNativeHint: o }) => e.map((e) => {
+	let s = e.authenticationType === n.DialNative, c = s ? r && e.appLevelAuthStatus === t.SignedIn : e.userLevelAuthStatus === t.SignedIn;
+	return {
+		id: e.id,
+		name: e.displayName || e.id,
+		description: e.description,
+		authenticationType: e.authenticationType === n.ApiKey ? a.ApiKey : a.OAuth,
+		status: c ? i.SignedIn : i.SignedOut,
+		hasSharedCredentials: !s && !c && (e.globalAuthStatus === t.SignedIn || e.appLevelAuthStatus === t.SignedIn),
+		canLogout: !s,
+		canConsentToOfflineUsage: !s,
+		hint: s ? o : void 0
+	};
+}), s = (n, i, a) => ({
+	appId: n,
+	serviceId: i.id,
+	...a,
+	credentialsLevel: r.User,
+	authenticationType: i.authenticationType,
+	oauthSettings: e(i),
+	forceStale: i.userLevelAuthStatus === t.Failed
+});
+//#endregion
+export { s as buildApplicationCredentialLoginParams, o as mapApplicationCredentials };

package/catalog/catalog-derivations.d.ts

@@ -0,0 +1,29 @@
+import { CatalogItem } from '@epam/ai-dial-catalog';
+import { CatalogEntityType } from '@epam/ai-dial-chat-shared';
+/**
+ * Filters catalog items to those listed under at least one tab in `visibleTypes` (see `getCatalogItemTabs`) and whose `supportsChat` is not `false`.
+ * Call only when selector mode is active; otherwise pass through the original array.
+ */
+export declare const filterCatalogItemsBySelector: (items: readonly CatalogItem[], visibleTypes: ReadonlySet<CatalogEntityType>) => CatalogItem[];
+/**
+ * Filters out items owned by the current user when `hideOwned` is true.
+ * Always returns a new array so callers may safely assign to mutable collections.
+ */
+export declare const filterHiddenOwnedItems: (items: readonly CatalogItem[], hideOwned: boolean) => CatalogItem[];
+/**
+ * Returns items marked as a user favorite that are not hidden, in original order.
+ */
+export declare const deriveFavoriteItems: (items: readonly CatalogItem[]) => CatalogItem[];
+/**
+ * Returns the subset of `tabOrder` entries that at least one item in `items`
+ * is listed under (see `getCatalogItemTabs`), preserving tab order.
+ */
+export declare const deriveAvailableTabIds: <T extends CatalogEntityType>(items: readonly CatalogItem[], tabOrder: readonly T[]) => T[];
+/**
+ * Returns the intersection of `persistedTopics` with topics that appear in
+ * `items`. Returns a new Set and never mutates either input.
+ */
+export declare const reconcileFilterTopics: (persistedTopics: ReadonlySet<string>, items: readonly CatalogItem[]) => Set<string>;
+/** Whether a share link for a catalog entity of this type may grant edit access. */
+export declare const canEditShareAccess: (type: CatalogEntityType) => boolean;
+//# sourceMappingURL=catalog-derivations.d.ts.map

package/catalog/catalog-derivations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-derivations.d.ts","sourceRoot":"","sources":["../../src/catalog/catalog-derivations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAsB,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GACvC,OAAO,SAAS,WAAW,EAAE,EAC7B,cAAc,WAAW,CAAC,iBAAiB,CAAC,KAC3C,WAAW,EAKX,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,SAAS,WAAW,EAAE,EAC7B,WAAW,OAAO,KACjB,WAAW,EACkD,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,SAAS,WAAW,EAAE,KAC5B,WAAW,EACiD,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,iBAAiB,EAC/D,OAAO,SAAS,WAAW,EAAE,EAC7B,UAAU,SAAS,CAAC,EAAE,KACrB,CAAC,EAGH,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,iBAAiB,WAAW,CAAC,MAAM,CAAC,EACpC,OAAO,SAAS,WAAW,EAAE,KAC5B,GAAG,CAAC,MAAM,CAKZ,CAAC;AAeF,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,GAAI,MAAM,iBAAiB,KAAG,OAC5B,CAAC"}