@epam/ai-dial-chat-hooks 1.3.0-dev.29 → 1.3.0-dev.290

package/file-manager.js

@@ -1,30 +1,32 @@
-import { isDialFileId as e, resolveDialFileBucketAndPath as t, resolveRelativeDialFilePath as n } from "./files/dial-file.js";
-import { isDialFileAcceptType as r, mimeTypesToAttachmentExtensionLabels as i, mimeTypesToDialFileAcceptTypes as a, mimeTypesToFileAccept as o } from "./files/attachment-types.js";
-import { sanitizeFileName as s, splitFileNameExtension as c, trimFileNameToByteLimit as l } from "./files/file-name.js";
-import { DialFilesApiUploadMode as u } from "./files/dial-files-api.js";
-import { FileManagerNotificationReason as d, FileNameValidationErrorReason as f, FileOperationKind as p } from "./files/dial-file-manager.types.js";
-import { COLUMNS_MY_FILES as m, COLUMNS_ORGANIZATION as h, COLUMNS_SHARED as g, CORE_PERMISSION_MAP as _, DATE_OPTIONS as v, DIAL_FILE_MANAGER_SECTION_TABS as y, PATH_SEPARATOR_REGEXP as b, RESERVED_MARKER_NAME as x, UPLOAD_CONCURRENCY as S } from "./files/dial-file-manager.model.js";
-import { buildSharedItemVirtualPath as C, dialCorePathToRelative as w, findDialFileByPath as T, findFolderByVirtualPath as E, formatOperationFolderName as D, getVirtualPathName as O, hasDialFileWritePermission as k, hasForbiddenNameSymbols as A, hasSamePaths as j, isCopyMoveDuplicateAllowed as M, isShareActionsAllowed as N, normalizeVirtualPath as P, parseNewFolderVirtualPath as F, resolveOwnerCoords as I, resolveSectionByPath as L, unionPathSets as R, withRoutableRootLabels as z } from "./files/dial-file-manager-path.util.js";
-import { resolveDialFileApiPath as B, virtualPathToApiPath as V } from "./files/resolve-dial-file-api-path.js";
-import { prepareCopyItems as H, prepareMoveRenameItems as U } from "./files/dial-file-manager-copy-move.util.js";
-import { buildFromCache as W, fetchByTab as G, fetchForSearch as K, findFirstSuccessfulCopyMoveItem as q, mapCorePermissions as J, mapFileMetadataToDialFile as Y, mapSearchItem as X, mergeCreatedFolderIntoCache as Z, updateEntry as Q } from "./files/dial-file-manager-mapping.util.js";
-import { createFilesApiClient as $ } from "./files/create-files-api.js";
-import { createUploadFileWithProgress as ee } from "./files/create-upload-file-with-progress.js";
-import { openAnnotationAttachment as te } from "./files/annotation.js";
-import { getUrlFileName as ne, isExternalSourcePreviewable as re, resolveExternalSourceContentType as ie } from "./files/source-content.js";
-import { annotationToDisplayAttachment as ae, attachmentDtoToDisplayAttachment as oe, attachmentDtosToDisplayAttachments as se } from "./files/attachment-dto-to-display.js";
-import { dialFileToAttachment as ce, dialFilesToAttachments as le, dialFolderPathToAttachment as ue } from "./files/dial-file-to-attachment.js";
-import { DownloadDestinationType as de } from "./files/download-destination.js";
-import { prepareDownloadDestination as fe } from "./files/prepare-download-destination.js";
-import { deriveActionProfile as pe } from "./files/file-manager-variant.js";
-import { useDialFileListing as me } from "./files/useDialFileListing/useDialFileListing.js";
-import { useDialFileMetadata as he } from "./files/useDialFileMetadata/useDialFileMetadata.js";
-import { useDialFileMutations as ge } from "./files/useDialFileMutations/useDialFileMutations.js";
-import { useDialFileSharing as _e } from "./files/useDialFileSharing/useDialFileSharing.js";
-import { useDialFileUploadBatch as ve } from "./files/useDialFileUploadBatch/useDialFileUploadBatch.js";
-import { useDialFileManager as ye } from "./files/useDialFileManager/useDialFileManager.js";
-import { useDialFileManagerSections as be } from "./files/useDialFileManagerSections/useDialFileManagerSections.js";
-import { useDialFileManagerTabConfig as xe } from "./files/useDialFileManagerTabConfig/useDialFileManagerTabConfig.js";
-import { useFileAttachmentPicker as Se } from "./files/useFileAttachmentPicker/useFileAttachmentPicker.js";
-import { useGridEditingScroll as Ce } from "@epam/ai-dial-chat-shared";
-export { m as COLUMNS_MY_FILES, h as COLUMNS_ORGANIZATION, g as COLUMNS_SHARED, _ as CORE_PERMISSION_MAP, v as DATE_OPTIONS, y as DIAL_FILE_MANAGER_SECTION_TABS, u as DialFilesApiUploadMode, de as DownloadDestinationType, d as FileManagerNotificationReason, f as FileNameValidationErrorReason, p as FileOperationKind, b as PATH_SEPARATOR_REGEXP, x as RESERVED_MARKER_NAME, S as UPLOAD_CONCURRENCY, ae as annotationToDisplayAttachment, oe as attachmentDtoToDisplayAttachment, se as attachmentDtosToDisplayAttachments, W as buildFromCache, C as buildSharedItemVirtualPath, $ as createFilesApiClient, ee as createUploadFileWithProgress, pe as deriveActionProfile, w as dialCorePathToRelative, ce as dialFileToAttachment, le as dialFilesToAttachments, ue as dialFolderPathToAttachment, G as fetchByTab, K as fetchForSearch, T as findDialFileByPath, q as findFirstSuccessfulCopyMoveItem, E as findFolderByVirtualPath, D as formatOperationFolderName, ne as getUrlFileName, O as getVirtualPathName, k as hasDialFileWritePermission, A as hasForbiddenNameSymbols, j as hasSamePaths, M as isCopyMoveDuplicateAllowed, r as isDialFileAcceptType, e as isDialFileId, re as isExternalSourcePreviewable, N as isShareActionsAllowed, J as mapCorePermissions, Y as mapFileMetadataToDialFile, X as mapSearchItem, Z as mergeCreatedFolderIntoCache, i as mimeTypesToAttachmentExtensionLabels, a as mimeTypesToDialFileAcceptTypes, o as mimeTypesToFileAccept, P as normalizeVirtualPath, te as openAnnotationAttachment, F as parseNewFolderVirtualPath, H as prepareCopyItems, fe as prepareDownloadDestination, U as prepareMoveRenameItems, B as resolveDialFileApiPath, t as resolveDialFileBucketAndPath, ie as resolveExternalSourceContentType, I as resolveOwnerCoords, n as resolveRelativeDialFilePath, L as resolveSectionByPath, s as sanitizeFileName, c as splitFileNameExtension, l as trimFileNameToByteLimit, R as unionPathSets, Q as updateEntry, me as useDialFileListing, ye as useDialFileManager, be as useDialFileManagerSections, xe as useDialFileManagerTabConfig, he as useDialFileMetadata, ge as useDialFileMutations, _e as useDialFileSharing, ve as useDialFileUploadBatch, Se as useFileAttachmentPicker, Ce as useGridEditingScroll, V as virtualPathToApiPath, z as withRoutableRootLabels };
+import { FileSelectionKind as e, getFileSelectionKind as t, isDialFileId as n, isDialFolderId as r, resolveDialFileBucketAndPath as i, resolveDialFolderPath as a, resolveRelativeDialFilePath as o } from "./files/dial-file.js";
+import { isDialFileAcceptType as s, mimeTypesToAttachmentExtensionLabels as c, mimeTypesToDialFileAcceptTypes as l, mimeTypesToFileAccept as u } from "./files/attachment-types.js";
+import { sanitizeFileName as d, splitFileNameExtension as f, trimFileNameToByteLimit as p } from "./files/file-name.js";
+import { DialFilesApiUploadMode as m } from "./files/dial-files-api.js";
+import { FileManagerNotificationReason as h, FileNameValidationErrorReason as g, FileOperationKind as _ } from "./files/dial-file-manager.types.js";
+import { COLUMNS_MY_FILES as v, COLUMNS_ORGANIZATION as y, COLUMNS_SHARED as b, CORE_PERMISSION_MAP as x, DATE_OPTIONS as S, DIAL_FILE_MANAGER_SECTION_TABS as C, PATH_SEPARATOR_REGEXP as w, RESERVED_MARKER_NAME as T, UPLOAD_CONCURRENCY as E } from "./files/dial-file-manager.model.js";
+import { buildSharedItemVirtualPath as D, dialCorePathToRelative as O, findDialFileByPath as k, findFolderByVirtualPath as A, formatOperationFolderName as j, getVirtualPathName as M, hasDialFileWritePermission as N, hasForbiddenNameSymbols as P, hasSamePaths as F, isCopyMoveDuplicateAllowed as I, isShareActionsAllowed as L, normalizeVirtualPath as R, parseNewFolderVirtualPath as z, resolveOwnerCoords as B, resolveSectionByPath as V, unionPathSets as H, withRoutableRootLabels as U } from "./files/dial-file-manager-path.util.js";
+import { resolveDialFileApiPath as W, virtualPathToApiPath as G } from "./files/resolve-dial-file-api-path.js";
+import { prepareCopyItems as K, prepareMoveRenameItems as q } from "./files/dial-file-manager-copy-move.util.js";
+import { UploadBodyEncoding as J, UploadNetworkError as Y, createUploadFileWithProgress as X } from "./files/create-upload-file-with-progress.js";
+import { buildFromCache as Z, buildSharedSearchScope as Q, fetchByTab as $, fetchForSearch as ee, findFirstSuccessfulCopyMoveItem as te, mapCorePermissions as ne, mapFileMetadataToDialFile as re, mapSearchItem as ie, mergeCreatedFolderIntoCache as ae, resolveTransferFailureReason as oe, resolveUploadFailureReason as se, updateEntry as ce } from "./files/dial-file-manager-mapping.util.js";
+import { createFilesApiClient as le } from "./files/create-files-api.js";
+import { openAnnotationAttachment as ue } from "./files/annotation.js";
+import { getUrlFileName as de, isExternalSourcePreviewable as fe, resolveExternalSourceContentType as pe } from "./files/source-content.js";
+import { annotationToDisplayAttachment as me, attachmentDtoToDisplayAttachment as he, attachmentDtosToDisplayAttachments as ge } from "./files/attachment-dto-to-display.js";
+import { useUnshareConfirmationState as _e } from "./files/useUnshareConfirmationState/useUnshareConfirmationState.js";
+import { dialFileToAttachment as ve, dialFilesToAttachments as ye, dialFolderPathToAttachment as be } from "./files/dial-file-to-attachment.js";
+import { DownloadDestinationType as xe } from "./files/download-destination.js";
+import { prepareDownloadDestination as Se } from "./files/prepare-download-destination.js";
+import { deriveActionProfile as Ce } from "./files/file-manager-variant.js";
+import { useDialFileListing as we } from "./files/useDialFileListing/useDialFileListing.js";
+import { useDialFileMetadata as Te } from "./files/useDialFileMetadata/useDialFileMetadata.js";
+import { useDialFileMutations as Ee } from "./files/useDialFileMutations/useDialFileMutations.js";
+import { useDialFileSharing as De } from "./files/useDialFileSharing/useDialFileSharing.js";
+import { useDialFileUploadBatch as Oe } from "./files/useDialFileUploadBatch/useDialFileUploadBatch.js";
+import { useDialFileManager as ke } from "./files/useDialFileManager/useDialFileManager.js";
+import { useDialFileManagerSections as Ae } from "./files/useDialFileManagerSections/useDialFileManagerSections.js";
+import { useDialFileManagerTabConfig as je } from "./files/useDialFileManagerTabConfig/useDialFileManagerTabConfig.js";
+import { useFileAttachmentPicker as Me } from "./files/useFileAttachmentPicker/useFileAttachmentPicker.js";
+import { useFileAttachmentModalState as Ne } from "./files/useFileAttachmentModalState/useFileAttachmentModalState.js";
+import { useGridEditingScroll as Pe } from "@epam/ai-dial-chat-shared";
+export { v as COLUMNS_MY_FILES, y as COLUMNS_ORGANIZATION, b as COLUMNS_SHARED, x as CORE_PERMISSION_MAP, S as DATE_OPTIONS, C as DIAL_FILE_MANAGER_SECTION_TABS, m as DialFilesApiUploadMode, xe as DownloadDestinationType, h as FileManagerNotificationReason, g as FileNameValidationErrorReason, _ as FileOperationKind, e as FileSelectionKind, w as PATH_SEPARATOR_REGEXP, T as RESERVED_MARKER_NAME, E as UPLOAD_CONCURRENCY, J as UploadBodyEncoding, Y as UploadNetworkError, me as annotationToDisplayAttachment, he as attachmentDtoToDisplayAttachment, ge as attachmentDtosToDisplayAttachments, Z as buildFromCache, D as buildSharedItemVirtualPath, Q as buildSharedSearchScope, le as createFilesApiClient, X as createUploadFileWithProgress, Ce as deriveActionProfile, O as dialCorePathToRelative, ve as dialFileToAttachment, ye as dialFilesToAttachments, be as dialFolderPathToAttachment, $ as fetchByTab, ee as fetchForSearch, k as findDialFileByPath, te as findFirstSuccessfulCopyMoveItem, A as findFolderByVirtualPath, j as formatOperationFolderName, t as getFileSelectionKind, de as getUrlFileName, M as getVirtualPathName, N as hasDialFileWritePermission, P as hasForbiddenNameSymbols, F as hasSamePaths, I as isCopyMoveDuplicateAllowed, s as isDialFileAcceptType, n as isDialFileId, r as isDialFolderId, fe as isExternalSourcePreviewable, L as isShareActionsAllowed, ne as mapCorePermissions, re as mapFileMetadataToDialFile, ie as mapSearchItem, ae as mergeCreatedFolderIntoCache, c as mimeTypesToAttachmentExtensionLabels, l as mimeTypesToDialFileAcceptTypes, u as mimeTypesToFileAccept, R as normalizeVirtualPath, ue as openAnnotationAttachment, z as parseNewFolderVirtualPath, K as prepareCopyItems, Se as prepareDownloadDestination, q as prepareMoveRenameItems, W as resolveDialFileApiPath, i as resolveDialFileBucketAndPath, a as resolveDialFolderPath, pe as resolveExternalSourceContentType, B as resolveOwnerCoords, o as resolveRelativeDialFilePath, V as resolveSectionByPath, oe as resolveTransferFailureReason, se as resolveUploadFailureReason, d as sanitizeFileName, f as splitFileNameExtension, p as trimFileNameToByteLimit, H as unionPathSets, ce as updateEntry, we as useDialFileListing, ke as useDialFileManager, Ae as useDialFileManagerSections, je as useDialFileManagerTabConfig, Te as useDialFileMetadata, Ee as useDialFileMutations, De as useDialFileSharing, Oe as useDialFileUploadBatch, Ne as useFileAttachmentModalState, Me as useFileAttachmentPicker, Pe as useGridEditingScroll, _e as useUnshareConfirmationState, G as virtualPathToApiPath, U as withRoutableRootLabels };

package/files/annotation.d.ts

@@ -0,0 +1,10 @@
+import { AttachmentResource } from '@epam/ai-dial-chat-shared';
+import { ResolveDownloadUrl } from '../attachment/useAttachmentAction/useAttachmentAction';
+/**
+ * Opens a cited/referenced attachment: triggers a browser download for
+ * DIAL-hosted files (`files/...` ids) via the injected `resolveDownloadUrl`,
+ * otherwise opens the URL in a new tab. No-ops when the attachment has no
+ * URL or the download URL cannot be resolved.
+ */
+export declare const openAnnotationAttachment: (attachment: AttachmentResource, resolveDownloadUrl: ResolveDownloadUrl) => void;
+//# sourceMappingURL=annotation.d.ts.map

package/files/annotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation.d.ts","sourceRoot":"","sources":["../../src/files/annotation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uDAAuD,CAAC;AAGhG;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,YAAY,kBAAkB,EAC9B,oBAAoB,kBAAkB,KACrC,IAeF,CAAC"}

package/files/attachment-canvas.d.ts

@@ -0,0 +1,135 @@
+import { CodeCanvasContent, ErrorCanvasContent, HtmlCanvasContent, ImageCanvasContent, JsonCanvasContent, MarkdownCanvasContent, OoxmlCanvasContent, GroupedVisualizerCanvasContent, PdfCanvasContent, PlainTextCanvasContent, VisualizerCanvasContent, OoxmlFileType } from '@epam/ai-dial-attachment-canvas';
+import { Annotation, ApplicationVisualizer, AttachmentResource, CustomVisualizer, DisplayAttachment } from '@epam/ai-dial-chat-shared';
+import { AnnotationGroup } from '@epam/ai-dial-quotations';
+/**
+ * DIAL-file URL resolution injected by the host into every attachment-canvas
+ * content resolver below. Host-owned — encodes the app's own
+ * file-download endpoint.
+ */
+export interface AttachmentCanvasUrlResolvers {
+    /** Resolves a DIAL Core file id to a downloadable URL. */
+    resolveDialFileDownloadUrl: (fileId: string) => string | undefined;
+    /** Resolves the best downloadable DIAL-file URL from an attachment's `url` or `referenceUrl`. */
+    resolveDialUrl: (attachment: DisplayAttachment) => string | undefined;
+    /** Resolves a DIAL Core file id to a fetchable metadata URL (used for cache-freshness validation). */
+    resolveDialFileMetadataUrl: (fileId: string) => string | undefined;
+    /** URL of a host-served bootstrap document that renders HTML with no download URL (inline `data`) under its own response CSP instead of the embedding page's — forwarded as `HtmlCanvasContent.srcdocHostUrl`. When omitted, that HTML renders via plain `srcdoc`. */
+    htmlSrcdocHostUrl?: string;
+}
+/** Clears all cached fetch results. Call this when leaving a conversation. */
+export declare const clearAttachmentCache: () => void;
+/**
+ * Whether the attachment carries text `resolveAttachmentText` can resolve —
+ * inline data, a DIAL download URL, or a locally-picked file. Mirrors that
+ * function's source list, so a `null` resolver result can be read as "the text
+ * was fetched and rejected" rather than "there was no text to fetch".
+ */
+export declare const hasAttachmentTextSource: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => boolean;
+/**
+ * Resolves an image canvas content payload from a DisplayAttachment without
+ * fetching — returns a local blob URL or the BFF download URL directly so the
+ * browser cache can be shared with the conversation view's `<img>` element.
+ * A local `File` with bytes takes precedence over the DIAL download URL; a
+ * 0-byte `File` (the file-manager placeholder) does not. Error detection is
+ * delegated to `<img onError>` in the canvas renderer. Returns `null` if no
+ * URL source is available.
+ */
+export declare const resolveImageCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => ImageCanvasContent | null;
+/** Resolves a plain-text canvas content payload from a DisplayAttachment, or `null` if unavailable. */
+export declare const resolveTextCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => Promise<PlainTextCanvasContent | ErrorCanvasContent | null>;
+/** Resolves a Markdown canvas content payload from a DisplayAttachment, or `null` if unavailable. */
+export declare const resolveMarkdownCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => Promise<MarkdownCanvasContent | ErrorCanvasContent | null>;
+/** Resolves a syntax-highlighted code canvas content payload from a DisplayAttachment, or `null` if unavailable. */
+export declare const resolveCodeCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers, language?: string) => Promise<CodeCanvasContent | ErrorCanvasContent | null>;
+/**
+ * Resolves an HTML canvas content payload from a DisplayAttachment.
+ * When the attachment has a download URL, that URL is the primary render
+ * target so the preview loads via `src` and gets its own response-level CSP
+ * instead of inheriting the host document's — no HTML text is fetched up
+ * front; `resolveSourceText` fetches it lazily, only when the "View source"
+ * toggle is used, and rejects if that fetch fails. `isSameOriginUrl` reflects
+ * a real comparison against the embedding document's own origin.
+ * With no download URL (local file or inline data), falls back to `srcdoc`,
+ * rejecting payloads larger than 1 MiB to prevent browser truncation, and
+ * forwards `resolvers.htmlSrcdocHostUrl` so that HTML can still render under
+ * its own response-level CSP.
+ * Returns `null` if no source is available, or an `ErrorCanvasContent` when
+ * that fallback fetch fails.
+ */
+export declare const resolveHtmlCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => Promise<HtmlCanvasContent | ErrorCanvasContent | null>;
+/**
+ * Builds a `PdfCanvasContent` for a PDF citation annotation, including highlights
+ * for the clicked annotation's document within its citation group.
+ * When the clicked annotation has a page but no selector with valid geometry,
+ * an invisible page-anchor highlight is added and selected so the viewer
+ * still opens that page.
+ * Returns `null` if the annotation has no PDF source attachment.
+ */
+export declare const annotationToPdfCanvasContent: (annotation: Annotation, groups: AnnotationGroup[], resolvers: AttachmentCanvasUrlResolvers) => PdfCanvasContent | null;
+/**
+ * Builds an `OoxmlCanvasContent` for a DOCX/PPTX/XLSX citation annotation,
+ * including highlights for every annotation sharing the clicked one's source
+ * document. Returns `null` when the annotation has no source attachment,
+ * the source is not a format `@silurus/ooxml` renders as DOCX/XLSX/PPTX (a
+ * CSV source returns `null` — citation highlighting targets Office documents
+ * only), or no URL resolves.
+ */
+export declare const annotationToOoxmlCanvasContent: (annotation: Annotation, annotations: Annotation[], resolvers: AttachmentCanvasUrlResolvers) => OoxmlCanvasContent | null;
+/** Canvas content for a citation, with the file name its canvas tab shows. */
+export interface AnnotationCanvasContent {
+    /** PDF or OOXML viewer content with the citation highlighted. */
+    content: PdfCanvasContent | OoxmlCanvasContent;
+    /** The source attachment's title, or the decoded last segment of its URL. */
+    fileName: string;
+}
+/**
+ * Returns the highlighted canvas content for a citation — PDF first, then a
+ * DOCX/PPTX/XLSX document — or `null` when the source opens neither way.
+ */
+export declare const resolveAnnotationCanvasContent: (annotation: Annotation, groups: AnnotationGroup[], annotations: Annotation[], resolvers: AttachmentCanvasUrlResolvers) => AnnotationCanvasContent | null;
+/**
+ * Builds a `PdfCanvasContent` for a reference-only attachment whose
+ * `reference_url` points at a PDF file (optionally with a `#page=N`
+ * fragment), so it can be opened in the canvas and scrolled to the
+ * referenced page the same way a regular PDF citation is. Returns `null`
+ * when the attachment's `url` does not target a PDF.
+ */
+export declare const referenceAttachmentToPdfCanvasContent: (attachment: AttachmentResource, resolvers: AttachmentCanvasUrlResolvers) => PdfCanvasContent | null;
+/** Resolves a PDF canvas content payload from a DisplayAttachment, or `null` if unavailable. */
+export declare const resolvePdfCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => Promise<PdfCanvasContent | ErrorCanvasContent | null>;
+/** Resolves an OOXML or CSV renderer payload from a DisplayAttachment, or `null` if unavailable. */
+export declare const resolveOoxmlCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers, format: OoxmlFileType) => Promise<OoxmlCanvasContent | ErrorCanvasContent | null>;
+/**
+ * Resolves a JSON canvas content payload from a DisplayAttachment, or `null` if unavailable.
+ * Falls back to `PlainTextCanvasContent` when the fetched text is not valid JSON.
+ */
+export declare const resolveJsonCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => Promise<JsonCanvasContent | PlainTextCanvasContent | ErrorCanvasContent | null>;
+/**
+ * Fetches the attachment payload and builds a `VisualizerCanvasContent` for the
+ * given registry entry and theme. Returns `null` when the payload cannot be
+ * fetched (caller should fall through to default content-type handling).
+ *
+ * Only JSON payloads are parsed into `data`. Non-JSON payloads (plain text,
+ * CSV, binary, …) resolve with `data: {}` — the visualizer still receives
+ * `mimeType` and `layout`, just no payload body. This is intentional: only
+ * JSON attachment content is forwarded to visualizers in this version.
+ */
+export declare const resolveVisualizerCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers, entry: CustomVisualizer, themeId: string) => Promise<VisualizerCanvasContent | null>;
+/** Outcome of building a grouped visualizer payload. */
+export interface GroupedVisualizerResolution {
+    /** The grouped payload, or `null` when no claimed attachment resolved to a URL. */
+    content: GroupedVisualizerCanvasContent | null;
+    /** The claimed attachments that reached `content.attachments`, in the input's order. The caller returns the rest to the ordinary attachment tray. */
+    resolved: DisplayAttachment[];
+}
+/**
+ * Builds the grouped payload for an application-scoped visualizer from the
+ * attachments its entry claims, reporting which of them `resolveAbsoluteUrl`
+ * could produce a URL for. Unlike the single-attachment resolver this fetches
+ * nothing: the grouped protocol hands the visualizer URLs and lets it read
+ * them itself, so the URLs must be absolute — a host-relative path would
+ * resolve against the iframe's own origin. Producing one is host knowledge,
+ * which is why it arrives as a callback rather than being built here.
+ */
+export declare const resolveGroupedVisualizerCanvasContent: (attachments: DisplayAttachment[], resolveAbsoluteUrl: (attachment: DisplayAttachment) => string | undefined, entry: ApplicationVisualizer, themeId: string) => GroupedVisualizerResolution;
+//# sourceMappingURL=attachment-canvas.d.ts.map

package/files/attachment-canvas.d.ts.map

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

package/files/attachment-canvas.js

@@ -245,7 +245,15 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 			selectedHighlightId: h
 		} : {}
 	};
-}, H = (n, r) => {
+}, H = (e, t, n, r) => {
+	let i = z(e, t, r) ?? V(e, n, r);
+	if (i == null) return null;
+	let a = e.body?.source?.attachment, o = a?.url?.split("/").pop() ?? "";
+	return {
+		content: i,
+		fileName: a?.title || decodeURIComponent(o)
+	};
+}, U = (n, r) => {
 	let i = m(n.url);
 	if (i == null) return null;
 	let a = e(i.baseUrl) ? r.resolveDialFileDownloadUrl(i.baseUrl) : i.baseUrl;
@@ -262,38 +270,38 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 		selectedHighlightId: o,
 		page: i.page
 	};
-}, U = (e) => {
+}, W = (e) => {
 	try {
 		let t = new URL(e).protocol;
 		return t === "http:" || t === "https:" || t === "blob:";
 	} catch {
 		return !1;
 	}
-}, W = (t) => t.url != null && !e(t.url) && U(t.url) ? t.url : void 0, G = async (e, n) => {
+}, G = (t) => t.url != null && !e(t.url) && W(t.url) ? t.url : void 0, K = async (e, n) => {
 	let r = await O(e, n);
 	if (r != null) return typeof r == "string" ? {
 		type: t.Pdf,
 		url: r
 	} : r;
-	let i = W(e);
+	let i = G(e);
 	return i == null ? null : {
 		type: t.Pdf,
 		url: i
 	};
-}, K = async (e, n, r) => {
+}, q = async (e, n, r) => {
 	let i = await O(e, n);
 	if (i != null) return typeof i == "string" ? {
 		type: t.Ooxml,
 		url: i,
 		format: r
 	} : i;
-	let a = W(e);
+	let a = G(e);
 	return a == null ? null : {
 		type: t.Ooxml,
 		url: a,
 		format: r
 	};
-}, q = async (e, n) => {
+}, J = async (e, n) => {
 	let r = await k(e, n);
 	if (r == null) return null;
 	if (typeof r != "string") return r;
@@ -309,7 +317,7 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 			text: r
 		};
 	}
-}, J = async (e, n, r, i) => {
+}, Y = async (e, n, r, i) => {
 	let a = await k(e, n);
 	if (a == null || typeof a != "string") return null;
 	let o = {};
@@ -331,7 +339,7 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 		visualizerName: r.title,
 		requestTimeout: r.requestTimeout
 	};
-}, Y = (e, n, r, i) => {
+}, X = (e, n, r, i) => {
 	let a = {
 		width: r.width,
 		height: r.height,
@@ -361,4 +369,4 @@ var g = (e, t) => URL.createObjectURL(s(e, t)), _ = (e) => {
 	};
 };
 //#endregion
-export { V as annotationToOoxmlCanvasContent, z as annotationToPdfCanvasContent, S as clearAttachmentCache, A as hasAttachmentTextSource, H as referenceAttachmentToPdfCanvasContent, F as resolveCodeCanvasContent, Y as resolveGroupedVisualizerCanvasContent, L as resolveHtmlCanvasContent, j as resolveImageCanvasContent, q as resolveJsonCanvasContent, N as resolveMarkdownCanvasContent, K as resolveOoxmlCanvasContent, G as resolvePdfCanvasContent, M as resolveTextCanvasContent, J as resolveVisualizerCanvasContent };
+export { V as annotationToOoxmlCanvasContent, z as annotationToPdfCanvasContent, S as clearAttachmentCache, A as hasAttachmentTextSource, U as referenceAttachmentToPdfCanvasContent, H as resolveAnnotationCanvasContent, F as resolveCodeCanvasContent, X as resolveGroupedVisualizerCanvasContent, L as resolveHtmlCanvasContent, j as resolveImageCanvasContent, J as resolveJsonCanvasContent, N as resolveMarkdownCanvasContent, q as resolveOoxmlCanvasContent, K as resolvePdfCanvasContent, M as resolveTextCanvasContent, Y as resolveVisualizerCanvasContent };

package/files/attachment-dto-to-display.d.ts

@@ -0,0 +1,10 @@
+import { Annotation, AttachmentDisplayResolvers, DisplayAttachment, MessageAttachment } from '@epam/ai-dial-chat-shared';
+/**
+ * Maps a message attachment payload to the display-only attachment model used by UI components.
+ */
+export declare const attachmentDtoToDisplayAttachment: (dto: MessageAttachment, resolvers: AttachmentDisplayResolvers) => DisplayAttachment;
+/** Maps an annotation's source attachment to the display-only attachment model. */
+export declare const annotationToDisplayAttachment: (annotation: Annotation) => DisplayAttachment | null;
+/** Maps Chat API attachment DTOs to display-only attachment models. */
+export declare const attachmentDtosToDisplayAttachments: (dtos: MessageAttachment[] | undefined, resolvers: AttachmentDisplayResolvers) => DisplayAttachment[];
+//# sourceMappingURL=attachment-dto-to-display.d.ts.map

package/files/attachment-dto-to-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-dto-to-display.d.ts","sourceRoot":"","sources":["../../src/files/attachment-dto-to-display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAQnC;;GAEG;AACH,eAAO,MAAM,gCAAgC,GAC3C,KAAK,iBAAiB,EACtB,WAAW,0BAA0B,KACpC,iBAAyE,CAAC;AAE7E,mFAAmF;AACnF,eAAO,MAAM,6BAA6B,GACxC,YAAY,UAAU,KACrB,iBAAiB,GAAG,IAatB,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,kCAAkC,GAC7C,MAAM,iBAAiB,EAAE,GAAG,SAAS,EACrC,WAAW,0BAA0B,KACpC,iBAAiB,EACwD,CAAC"}

package/files/attachment-dto-to-display.js

@@ -1,15 +1,16 @@
-import { AttachmentType as e, RequestStatus as t, messageAttachmentToDisplayAttachment as n } from "@epam/ai-dial-chat-shared";
+import { getUrlFileName as e } from "./source-content.js";
+import { AttachmentType as t, RequestStatus as n, messageAttachmentToDisplayAttachment as r } from "@epam/ai-dial-chat-shared";
 //#region src/files/attachment-dto-to-display.ts
-var r = (e, t) => n(e, t), i = (n) => {
-	let r = n.body?.source?.attachment;
-	return r == null ? null : {
-		id: r.url,
-		name: r.url.split("/").pop() ?? r.url,
-		contentType: r.type,
-		type: r.type.startsWith("image/") ? e.Image : e.File,
-		status: t.Idle,
-		url: r.url
+var i = (e, t) => r(e, t), a = (r) => {
+	let i = r.body?.source?.attachment;
+	return i == null ? null : {
+		id: i.url,
+		name: e(i.url),
+		contentType: i.type,
+		type: i.type.startsWith("image/") ? t.Image : t.File,
+		status: n.Idle,
+		url: i.url
 	};
-}, a = (e, t) => e?.map((e) => r(e, t)) ?? [];
+}, o = (e, t) => e?.map((e) => i(e, t)) ?? [];
 //#endregion
-export { i as annotationToDisplayAttachment, r as attachmentDtoToDisplayAttachment, a as attachmentDtosToDisplayAttachments };
+export { a as annotationToDisplayAttachment, i as attachmentDtoToDisplayAttachment, o as attachmentDtosToDisplayAttachments };

package/files/attachment-types.d.ts

@@ -0,0 +1,21 @@
+import { DialFileAcceptType } from '@epam/ai-dial-react-file-manager';
+/** Narrows a string to a `DialFileAcceptType` — a dotted extension or a MIME type/wildcard. */
+export declare const isDialFileAcceptType: (type: string) => type is DialFileAcceptType;
+/**
+ * Normalizes `*` to the all-files wildcard, canonicalizes MIME aliases, and drops
+ * any value that is not a valid `DialFileAcceptType`.
+ *
+ * Aliases are resolved because a file picker matches an `accept` entry against its
+ * own MIME table: a declared `text/json` offers no `.json` file, while the
+ * `application/json` it denotes does.
+ */
+export declare const mimeTypesToDialFileAcceptTypes: (types?: string[]) => DialFileAcceptType[] | undefined;
+/**
+ * Builds an `<input accept>` string from resolved MIME types, filtering out
+ * any value `isDialFileAcceptType` rejects, or `undefined` when no types are
+ * given or any type accepts everything.
+ */
+export declare const mimeTypesToFileAccept: (types?: string[]) => string | undefined;
+/** Formats MIME types as a human-readable, comma-separated list of dotted extensions (or the MIME type itself for wildcards). */
+export declare const mimeTypesToAttachmentExtensionLabels: (types: string[]) => string;
+//# sourceMappingURL=attachment-types.d.ts.map

package/files/attachment-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-types.d.ts","sourceRoot":"","sources":["../../src/files/attachment-types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAK3E,+FAA+F;AAC/F,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,KACX,IAAI,IAAI,kBAAgE,CAAC;AAE5E;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,GACzC,QAAQ,MAAM,EAAE,KACf,kBAAkB,EAAE,GAAG,SAYzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,EAAE,KAAG,MAAM,GAAG,SASjE,CAAC;AAEF,iIAAiI;AACjI,eAAO,MAAM,oCAAoC,GAAI,OAAO,MAAM,EAAE,KAAG,MAiBxD,CAAC"}

package/files/attachment-types.js

@@ -5,7 +5,7 @@ var n = "*/*", r = (e) => e.startsWith(".") || e.includes("/"), i = (t) => {
 	if (t != null) return t.map((t) => t === "*" ? n : t.startsWith(".") ? t : e(t)).filter(r);
 }, a = (e) => {
 	let t = i(e);
-	if (!(t == null || t.length === 0) && !t.some((e) => e === n)) return t.join(",");
+	if (t != null && t.length !== 0 && !t.some((e) => e === n)) return t.join(",");
 }, o = (n) => n.map((n) => {
 	if (n.endsWith("/*")) return n;
 	let r = e(n), i = t(r);

package/files/browser-download.d.ts

@@ -0,0 +1,9 @@
+import { DownloadDestination } from './download-destination';
+/**
+ * Writes `response` to disk and returns the file name it was saved under — the
+ * `Content-Disposition` name when the response carries one, otherwise
+ * `fallbackName`. Callers report the returned name so a confirmation names what
+ * is actually on disk rather than what was requested.
+ */
+export declare const triggerBrowserDownload: (response: Response, fallbackName: string, destination?: DownloadDestination) => Promise<string>;
+//# sourceMappingURL=browser-download.d.ts.map

package/files/browser-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-download.d.ts","sourceRoot":"","sources":["../../src/files/browser-download.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AA2BhC;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,QAAQ,EAClB,cAAc,MAAM,EACpB,cAAa,mBAEZ,KACA,OAAO,CAAC,MAAM,CAqBhB,CAAC"}

package/files/browser-download.js

@@ -0,0 +1,23 @@
+import { DownloadDestinationType as e } from "./download-destination.js";
+import { triggerBlobDownload as t } from "@epam/ai-dial-chat-shared";
+//#region src/files/browser-download.ts
+var n = /filename\*\s*=\s*UTF-8''([^;\n]+)/i, r = (e) => {
+	if (!e) return null;
+	let t = n.exec(e)?.[1];
+	if (t) try {
+		let e = decodeURIComponent(t.trim()).replace(/[/\\]/g, "").trim();
+		if (e) return e;
+	} catch {}
+	let r = /filename(?!\*)[^;=\n]*=(?:(\\?['"])(.*?)\1|([^;\n]*))/i.exec(e), i = r?.[2] ?? r?.[3];
+	return i && i.replace(/[/\\]/g, "").trim() || null;
+}, i = async (n, i, a = { type: e.Blob }) => {
+	if (a.type === e.Cancelled) return i;
+	if (a.type === e.Stream) {
+		if (n.body == null) throw await a.writable.abort("Response has no readable stream"), Error("Response has no readable stream");
+		return await n.body.pipeTo(a.writable), i;
+	}
+	let o = r(n.headers.get("Content-Disposition")) ?? i, s = await n.blob();
+	return t(s, o), o;
+};
+//#endregion
+export { i as triggerBrowserDownload };

package/files/create-files-api.d.ts

@@ -0,0 +1,52 @@
+import { ArchiveItemDto, CopyFilesResponseDto, CopyItemDto, CreateFolderDto, CreateFolderResponseDto, DeleteFilesResponseDto, DeleteItemDto, DiscardSharedItemDto, DiscardSharedResponseDto, FileMetadataResponseDto, FileUploadResponseDto, FilesApi, ListFilesResponseDto, ListPublicFilesRequest, ListSharedFilesRequest, MoveFilesResponseDto, MoveItemDto, RenameFilesResponseDto, RenameItemDto, RevokeAccessItemDto, RevokeAccessResponseDto, UploadArchiveResponseDto } from '@epam/ai-dial-chat-api-client';
+/** Upload mode passed to `FilesApi.uploadFile`: overwrite an existing file or fail if it already exists. */
+export type UploadMode = 'overwrite' | 'create-only';
+/** Options accepted by an {@link UploadFileWithProgressFn}. */
+export interface UploadFileWithProgressOptions {
+    /** Aborts the upload in flight. */
+    signal?: AbortSignal;
+    /** Called with the upload's progress percentage (0–100). */
+    onProgress?: (percent: number) => void;
+    /** Defaults to the generated client's own default when omitted. */
+    uploadMode?: UploadMode;
+}
+/** Shape of a progress-reporting file upload function, e.g. the return value of `createUploadFileWithProgress`. */
+export type UploadFileWithProgressFn = (bucket: string, path: string, file: File, options?: UploadFileWithProgressOptions) => Promise<FileUploadResponseDto>;
+/** Options accepted by the returned `uploadFile`. */
+export type UploadFileOptions = UploadFileWithProgressOptions;
+/** The DIAL files API surface produced by {@link createFilesApiClient}. */
+export interface FilesApiClient {
+    listPublicFiles: (params: ListPublicFilesRequest) => Promise<ListFilesResponseDto>;
+    listSharedFiles: (params: ListSharedFilesRequest) => Promise<ListFilesResponseDto>;
+    listFiles: (params: {
+        bucket: string;
+        path?: string;
+        token?: string;
+        limit?: number;
+        recursive?: boolean;
+        permissions?: boolean;
+    }, signal?: AbortSignal) => Promise<ListFilesResponseDto>;
+    uploadFile: (bucket: string, path: string, file: File, options?: AbortSignal | UploadFileOptions) => Promise<FileUploadResponseDto>;
+    uploadArchive: (file: File, bucket: string, destinationPath: string) => Promise<UploadArchiveResponseDto>;
+    getFileMetadata: (params: {
+        bucket: string;
+        path: string;
+    }) => Promise<FileMetadataResponseDto>;
+    downloadFile: (bucket: string, path: string, signal?: AbortSignal) => Promise<Response>;
+    createFolder: (params: CreateFolderDto) => Promise<CreateFolderResponseDto>;
+    deleteFiles: (items: DeleteItemDto[]) => Promise<DeleteFilesResponseDto>;
+    renameFiles: (items: RenameItemDto[]) => Promise<RenameFilesResponseDto>;
+    copyFiles: (items: CopyItemDto[], signal?: AbortSignal) => Promise<CopyFilesResponseDto>;
+    moveFiles: (items: MoveItemDto[], signal?: AbortSignal) => Promise<MoveFilesResponseDto>;
+    downloadArchive: (items: ArchiveItemDto[], signal?: AbortSignal) => Promise<Response>;
+    revokeAccess: (items: RevokeAccessItemDto[]) => Promise<RevokeAccessResponseDto>;
+    discardShared: (items: DiscardSharedItemDto[]) => Promise<DiscardSharedResponseDto>;
+    listSharedByMe: (bucket: string) => Promise<ListFilesResponseDto>;
+}
+/**
+ * Builds the DIAL files API wrapper functions `apps/chat/src/server-api/files.api.ts`
+ * exposes today, delegating to an already-configured `FilesApi` instance and
+ * an injected progress-reporting upload function.
+ */
+export declare const createFilesApiClient: (filesApi: FilesApi, uploadFileWithProgress: UploadFileWithProgressFn) => FilesApiClient;
+//# sourceMappingURL=create-files-api.d.ts.map

package/files/create-files-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-files-api.d.ts","sourceRoot":"","sources":["../../src/files/create-files-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,QAAQ,EACR,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,WAAW,EACX,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,+BAA+B,CAAC;AAEvC,4GAA4G;AAC5G,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,aAAa,CAAC;AAErD,+DAA+D;AAC/D,MAAM,WAAW,6BAA6B;IAC5C,mCAAmC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,mEAAmE;IACnE,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,mHAAmH;AACnH,MAAM,MAAM,wBAAwB,GAAG,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,6BAA6B,KACpC,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEpC,qDAAqD;AACrD,MAAM,MAAM,iBAAiB,GAAG,6BAA6B,CAAC;AAE9D,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,CACf,MAAM,EAAE,sBAAsB,KAC3B,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,eAAe,EAAE,CACf,MAAM,EAAE,sBAAsB,KAC3B,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,SAAS,EAAE,CACT,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,EACD,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,UAAU,EAAE,CACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,WAAW,GAAG,iBAAiB,KACtC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACpC,aAAa,EAAE,CACb,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,KACpB,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACvC,eAAe,EAAE,CAAC,MAAM,EAAE;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACvC,YAAY,EAAE,CACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,YAAY,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC5E,WAAW,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzE,WAAW,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzE,SAAS,EAAE,CACT,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,SAAS,EAAE,CACT,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,eAAe,EAAE,CACf,KAAK,EAAE,cAAc,EAAE,EACvB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,YAAY,EAAE,CACZ,KAAK,EAAE,mBAAmB,EAAE,KACzB,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACtC,aAAa,EAAE,CACb,KAAK,EAAE,oBAAoB,EAAE,KAC1B,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACvC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACnE;AAOD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,QAAQ,EAClB,wBAAwB,wBAAwB,KAC/C,cAiFD,CAAC"}

package/files/create-files-api.js

@@ -31,7 +31,7 @@ var e = (e) => e instanceof AbortSignal ? { signal: e } : e ?? {}, t = (t, n) =>
 	renameFiles: (e) => t.renameFiles({ renameFilesDto: { items: e } }),
 	copyFiles: (e, n) => t.copyFiles({ copyFilesDto: { items: e } }, n ? { signal: n } : void 0),
 	moveFiles: (e, n) => t.moveFiles({ moveFilesDto: { items: e } }, n ? { signal: n } : void 0),
-	downloadArchive: async (e) => (await t.downloadArchiveRaw({ downloadArchiveDto: { items: e } })).raw,
+	downloadArchive: async (e, n) => (await t.downloadArchiveRaw({ downloadArchiveDto: { items: e } }, n ? { signal: n } : void 0)).raw,
 	revokeAccess: (e) => t.revokeAccess({ revokeAccessDto: { items: e } }),
 	discardShared: (e) => t.discardShared({ discardSharedDto: { items: e } }),
 	listSharedByMe: (e) => t.listSharedByMe({ bucket: e })

package/files/create-upload-file-with-progress.d.ts

@@ -0,0 +1,44 @@
+import { UploadFileWithProgressFn } from './create-files-api';
+/** Rejection for an upload that got no response at all (the XHR `error` event). */
+export declare class UploadNetworkError extends Error {
+    constructor();
+}
+/** How {@link createUploadFileWithProgress} encodes the upload request. */
+export declare enum UploadBodyEncoding {
+    /** `POST` with a `FormData` body carrying `file`, `bucket`, `path` and `uploadMode`. */
+    Multipart = "multipart",
+    /**
+     * `PUT` with the `File` itself as the body (`Content-Type:
+     * application/octet-stream`) and `bucket`, `path`, `uploadMode` and
+     * `contentType` in the query string, so the server can stream the body
+     * without parsing it.
+     */
+    Raw = "raw"
+}
+export interface CreateUploadFileWithProgressDeps {
+    /** Returns the currently held CSRF token, or `null` when none is set. */
+    getCsrfToken: () => string | null;
+    /** Stores a CSRF token captured from the upload response header. */
+    setCsrfToken: (token: string | null) => void;
+    /** Notifies the host that the upload request was unauthorized. */
+    notifyUnauthorized: (url: string) => void;
+    /** Constructs the error thrown to signal an unauthorized upload. */
+    createUnauthorizedError: (url: string) => Error;
+    /** The upload endpoint's URL. */
+    uploadUrl: string;
+    /**
+     * How the request carries the file and its fields; must match what the
+     * endpoint at `uploadUrl` accepts. Defaults to {@link UploadBodyEncoding.Multipart}.
+     */
+    bodyEncoding?: UploadBodyEncoding;
+    /** Builds the `XMLHttpRequest` instance to upload through. Defaults to `() => new XMLHttpRequest()`. */
+    xhrFactory?: () => XMLHttpRequest;
+}
+/**
+ * Builds a progress-reporting file-upload function backed by
+ * `XMLHttpRequest` (needed because the `fetch`-based generated client has no
+ * upload-progress event), reporting progress, honoring an `AbortSignal`,
+ * attaching/rotating a CSRF token, and reporting an unauthorized response.
+ */
+export declare const createUploadFileWithProgress: (deps: CreateUploadFileWithProgressDeps) => UploadFileWithProgressFn;
+//# sourceMappingURL=create-upload-file-with-progress.d.ts.map

package/files/create-upload-file-with-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-upload-file-with-progress.d.ts","sourceRoot":"","sources":["../../src/files/create-upload-file-with-progress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,wBAAwB,EAEzB,MAAM,oBAAoB,CAAC;AA2B5B,mFAAmF;AACnF,qBAAa,kBAAmB,SAAQ,KAAK;;CAK5C;AAED,2EAA2E;AAC3E,oBAAY,kBAAkB;IAC5B,wFAAwF;IACxF,SAAS,cAAc;IACvB;;;;;OAKG;IACH,GAAG,QAAQ;CACZ;AAED,MAAM,WAAW,gCAAgC;IAC/C,yEAAyE;IACzE,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,oEAAoE;IACpE,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7C,kEAAkE;IAClE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,oEAAoE;IACpE,uBAAuB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,KAAK,CAAC;IAChD,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,cAAc,CAAC;CACnC;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACvC,MAAM,gCAAgC,KACrC,wBA+FF,CAAC"}