@epam/ai-dial-chat-hooks 1.1.0-dev.383 → 1.1.0-dev.390

package/{attachment/useAttachmentValidation/useAttachmentValidation.d.ts → attachments.d.ts}

@@ -1,44 +1,88 @@
-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"
-}
-/** 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). */
-    allowedMimeTypes: string[];
-    /** Already-formatted, non-translated extension list (e.g. ".png, .jpg"), present only when `reason` is `UnsupportedType`. */
-    formats?: string;
-}
-/** Parameters for {@link useAttachmentValidation}. */
-export interface UseAttachmentValidationParams {
-    /** Resolved MIME types currently allowed for attachments. */
-    allowedMimeTypes: string[];
-    /** 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, onValidationError, debounceMs, }: UseAttachmentValidationParams) => UseAttachmentValidationResult;
-//# sourceMappingURL=useAttachmentValidation.d.ts.map
+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). */
+    allowedMimeTypes: string[];
+    /** Already-formatted, non-translated extension list (e.g. ".png, .jpg"), present only when `reason` is `UnsupportedType`. */
+    formats?: string;
+}
+
+/** 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"
+}
+
+/**
+ * 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, onValidationError, debounceMs, }: UseAttachmentValidationParams) => UseAttachmentValidationResult;
+
+/** Parameters for {@link useAttachmentValidation}. */
+export declare interface UseAttachmentValidationParams {
+    /** Resolved MIME types currently allowed for attachments. */
+    allowedMimeTypes: string[];
+    /** 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 { }

package/attachments.js

@@ -0,0 +1,2 @@
+import { a as e, i as t, n, r, t as i } from "./useAttachmentValidation-CkMTd5lA.js";
+export { i as AttachmentValidationErrorReason, r as downloadAttachment, t as isDownloadableAttachment, e as useAttachmentAction, n as useAttachmentValidation };