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

package/files/dial-file-manager.types.d.ts

@@ -0,0 +1,337 @@
+import { DialFileManagerActionProfile, DialFileManagerVariant, FileUploadValidationResult, FileDownloadBatchState, FileUploadBatchState, FileUploadFailureReason } from '@epam/ai-dial-chat-shared';
+import { DialCopiedItem, DialDeletedItem, DialFile, DialFileManagerActions, DialFileManagerTabs, DialUploadFileItem, FileManagerColumnKey } from '@epam/ai-dial-react-file-manager';
+import { NotificationVariant } from '@epam/ai-dial-ui-kit';
+import { DialFilesApi } from './dial-files-api';
+import { DownloadDestinationHandlers } from './download-destination';
+/**
+ * Library-owned identifier for why a file-manager hook is surfacing an
+ * `onNotification` event, replacing a pre-translated toast message. The host
+ * maps each reason to its own translated string.
+ */
+export declare enum FileManagerNotificationReason {
+    /** A folder listing fetch (initial load, expand, invalidate-refetch, or popup preload) failed. */
+    FolderLoadFailed = "folderLoadFailed",
+    /** A single-file/folder metadata fetch (`onGetInfo`) failed. */
+    MetadataLoadFailed = "metadataLoadFailed",
+    /** `onCreateFolder`'s `createFolder` call failed. */
+    FolderCreateFailed = "folderCreateFailed",
+    /** `onDownloadFiles` failed for a single file/folder selection. */
+    DownloadFileFailed = "downloadFileFailed",
+    /** `onDownloadFiles` failed for a multi-item selection. */
+    DownloadFilesFailed = "downloadFilesFailed",
+    /** `onDeleteFiles` deleted at least one item successfully; `count`/`name`/`folder` describe the result. */
+    FilesDeleted = "filesDeleted",
+    /** `onDeleteFiles` completed with at least one failure alongside a success; `names`/`restCount` list the failures. */
+    FilesDeletePartiallyFailed = "filesDeletePartiallyFailed",
+    /** `onDeleteFiles`'s `deleteFiles` request itself rejected. */
+    DeleteFailed = "deleteFailed",
+    /** `onMoveToFiles`'s rename branch failed for every item in the batch. */
+    RenameFailed = "renameFailed",
+    /** `onMoveToFiles`'s rename branch failed for some items; `count` is the failed count. */
+    RenamePartiallyFailed = "renamePartiallyFailed",
+    /** `onMoveToFiles`'s move branch failed for every item in the batch. */
+    MoveFailed = "moveFailed",
+    /** `onMoveToFiles`'s move branch failed for some items; `count` is the failed count. */
+    MovePartiallyFailed = "movePartiallyFailed",
+    /** `onCopyFiles` failed for every item in the batch. */
+    CopyFailed = "copyFailed",
+    /** `onCopyFiles` failed for some items; `count` is the failed count. */
+    CopyPartiallyFailed = "copyPartiallyFailed",
+    /** `useDialFileSharing`'s `onUnshareFiles` request failed. */
+    UnshareFailed = "unshareFailed",
+    /** `useDialFileSharing`'s `onRemoveFilesAccess` request failed. */
+    RemoveAccessFailed = "removeAccessFailed",
+    /** `useDialFileUploadBatch`'s plain-file batch had zero successful uploads. */
+    UploadFailed = "uploadFailed",
+    /** `useDialFileUploadBatch`'s plain-file batch completed (fully or partially successful). */
+    UploadCompleted = "uploadCompleted",
+    /** `onUploadArchive` extracted zero entries successfully; `names`/`restCount` list the failures. */
+    UploadArchiveFailed = "uploadArchiveFailed",
+    /** `onUploadArchive` extracted some entries successfully and some failed; `count`/`names`/`restCount` describe the failures. */
+    UploadArchivePartiallyFailed = "uploadArchivePartiallyFailed",
+    /** `onUploadArchive`'s `uploadArchive` request itself rejected. */
+    UploadArchiveRequestFailed = "uploadArchiveRequestFailed",
+    /** A copy/move targeted a destination in a different All-view section from its source items; no request was made. */
+    CrossSectionTransferUnsupported = "crossSectionTransferUnsupported"
+}
+/**
+ * Structured toast event emitted by file-manager hooks. `reason` carries a
+ * library-owned identifier the host translates; `message` is an optional
+ * pre-rendered fallback for notifications a hook composes without a `reason`
+ * (e.g. hosts still authoring their own text for hooks not yet covered by a
+ * `FileManagerNotificationReason` member). The remaining fields carry the
+ * data a host needs to interpolate its translated string for reasons whose
+ * wording depends on more than the reason itself.
+ */
+export interface FileManagerNotification {
+    variant: NotificationVariant;
+    title?: string;
+    message?: string;
+    reason?: FileManagerNotificationReason;
+    /** Number of items the notification covers (e.g. a partial-failure count). */
+    count?: number;
+    /** Name of the affected entity or first successfully affected item. */
+    name?: string;
+    /** Source or destination folder name the notification refers to. */
+    folder?: string;
+    /** Up to the first 5 names affected by a partial/full failure list (e.g. archive extraction, delete). */
+    names?: string[];
+    /** Count of additional affected items beyond `names`' limit. */
+    restCount?: number;
+    /** Reason shared by every failed file of an `UploadFailed` batch; unset when the failed files have different reasons. */
+    failureReason?: FileUploadFailureReason;
+}
+/**
+ * Reason a file/folder name failed `onCreateFolderValidate`/
+ * `onRenameValidate`'s validation, used as the discriminant of
+ * `FileNameValidationError`.
+ */
+export declare enum FileNameValidationErrorReason {
+    Empty = "empty",
+    ForbiddenSymbols = "forbiddenSymbols",
+    ReservedName = "reservedName",
+    TooLong = "tooLong",
+    DuplicateName = "duplicateName"
+}
+/**
+ * Discriminated validation failure returned by `onCreateFolderValidate`/
+ * `onRenameValidate` instead of a pre-translated message; `null` means the
+ * name is valid. The host maps each `reason` to its own translated string.
+ */
+export type FileNameValidationError = {
+    reason: FileNameValidationErrorReason.Empty;
+} | {
+    reason: FileNameValidationErrorReason.ForbiddenSymbols;
+    symbols: string;
+} | {
+    reason: FileNameValidationErrorReason.ReservedName;
+} | {
+    reason: FileNameValidationErrorReason.TooLong;
+    maxLength: number;
+} | {
+    reason: FileNameValidationErrorReason.DuplicateName;
+    existingName: string;
+};
+/**
+ * Kind of mutation `useDialFileMutations` just completed successfully, for
+ * `onOperationSuccess`. Delete has no member here — its success feedback
+ * stays a structured `onNotification` event since it needs a count/folder,
+ * not a single named entity.
+ */
+export declare enum FileOperationKind {
+    FolderCreated = "folderCreated",
+    FileRenamed = "fileRenamed",
+    FileDownloaded = "fileDownloaded",
+    FilesDownloaded = "filesDownloaded",
+    FileCopied = "fileCopied",
+    FilesCopied = "filesCopied",
+    FileMoved = "fileMoved",
+    FilesMoved = "filesMoved",
+    /** A copy whose every item landed in its own source folder (Duplicate). */
+    FileDuplicated = "fileDuplicated",
+    FilesDuplicated = "filesDuplicated",
+    /** One or more shared-with-me items were removed from the Shared tab. */
+    FilesUnshared = "filesUnshared"
+}
+/**
+ * Structured success event `useDialFileMutations` emits through
+ * `onOperationSuccess` instead of calling an application notification
+ * service directly.
+ */
+export interface FileOperationSuccessEvent {
+    /** Which mutation just succeeded. */
+    kind: FileOperationKind;
+    /** Name of the affected entity or first successfully affected item, when applicable. */
+    name?: string;
+    /** Number of items the operation covered, when applicable. */
+    count?: number;
+    /**
+     * Destination folder as a slash-joined virtual path starting at the root
+     * label (e.g. `My files/reports`), for copy/move/duplicate operations.
+     */
+    destinationFolderName?: string;
+    /**
+     * Whether the affected item is a folder rather than a file. Set for rename,
+     * copy, move, and duplicate events; on a multi-item event it describes the
+     * first successfully affected item (the one `name` refers to).
+     */
+    isFolder?: boolean;
+}
+export interface UseDialFileManagerOptions {
+    /** Injected operation port used for every file-manager network call. */
+    filesApi: DialFilesApi;
+    /** DIAL Core bucket to browse (used only for my_files tab). */
+    bucket: string;
+    /** Display name for the root folder node. Defaults to `'My files'`. */
+    rootLabel?: string;
+    /** Active tab — drives listing source and per-tab options. Defaults to MyFiles. */
+    activeTab?: DialFileManagerTabs;
+    /** When false, the listing issues no `DialFilesApi` call and reports `isLoading: false`. Defaults to `true`. */
+    isActive?: boolean;
+    /** Changing this value resets cache and navigation exactly like an `activeTab` change. Defaults to `undefined`. */
+    sessionKey?: string;
+    /** Called when a file-manager action should surface a toast notification. */
+    onNotification?: (notification: FileManagerNotification) => void;
+    /** Called when a mutation succeeds, instead of invoking an application notification service directly. */
+    onOperationSuccess?: (event: FileOperationSuccessEvent) => void;
+    /** Regexp of characters forbidden in file/folder names (e.g. NOT_ALLOWED_SYMBOLS_REGEXP). */
+    forbiddenSymbolsRegExp?: RegExp;
+    /** Which host is driving this hook instance. Defaults to `Attach`. */
+    variant?: DialFileManagerVariant;
+    /** Gates which actions are exposed. Defaults to the value derived from `variant`. */
+    actionProfile?: DialFileManagerActionProfile;
+    /**
+     * Host-supplied action label text, keyed by `DialFileManagerActions`. The
+     * hook computes which actions are visible/enabled per tab/variant/
+     * actionProfile and intersects that gating with this map — an action the
+     * gating allows but this map omits is left out of `actionLabels`.
+     */
+    labels: Partial<Record<DialFileManagerActions, string>>;
+    /** BCP-47 locale string for date formatting, replacing `i18n.language`. */
+    locale: string;
+    /** Translated tooltip shown on the disabled New/Upload button. */
+    disabledNewButtonTooltip: string;
+    /** Host-injected browser "Save As"/auto-download seam for `onDownloadFiles`. */
+    downloadDestination: DownloadDestinationHandlers;
+    /**
+     * Builds a translated message from a structured validation-error reason,
+     * for `onCreateFolderValidate`/`onRenameValidate`. `item` is passed for a
+     * rename (so the host can distinguish file vs. folder wording) and
+     * omitted for folder creation.
+     */
+    buildValidationErrorMessage: (error: FileNameValidationError, item?: DialFile) => string;
+}
+export interface UseDialFileManagerResult {
+    /** Hierarchical items for DialFileManager's `items` prop. */
+    items: DialFile[];
+    /** True while the current folder is loading. */
+    isLoading: boolean;
+    /** Non-null when the last fetch failed. */
+    error: string | null;
+    /** Current path in DialFileManager format (e.g. `"/My files"`, `"/My files/reports/"`). */
+    path: string;
+    /** Pass directly to DialFileManager's `onPathChange`. */
+    onPathChange: (nextPath?: string) => void;
+    /** Re-runs the fetch for the current `folderPath`. */
+    retry: () => void;
+    /**
+     * Search: called by DialFileManager when the user types in the search box.
+     * `folder` is accepted for API parity with DialFileManager but is intentionally
+     * unused — this hook always searches from the active-tab root stored in
+     * `folderPath`, not from the passed-in `folder` (see design decision D3).
+     */
+    onSearchFiles: (folder: string, query: string) => void;
+    /** Search: true while a search request is in flight. */
+    isSearching: boolean;
+    /** Search: flat, unfiltered recursive listing of the current folder, or null when search is not active. */
+    searchResults: DialFile[] | null;
+    /** Search: clears results and exits search mode. */
+    clearSearchResults: () => void;
+    /** Tree: controlled set of expanded folder virtual paths. */
+    expandedPaths: Set<string>;
+    /** Tree: expanded or destination-popup virtual paths whose children are already cached. */
+    loadedPaths: Set<string>;
+    /** Tree: called by DialFileManager when a folder is expanded/collapsed. */
+    onExpandedPathsChange: (paths: Set<string>) => void;
+    /** Destination folder popup: preloads the browsed folder without changing the outer grid path. */
+    onFolderPopupPathChange: (nextPath?: string) => void;
+    /** Destination folder popup: normalized virtual paths currently being preloaded. */
+    folderPopupLoadingPaths: Set<string>;
+    /** Upload: start a new batch. */
+    onUploadFiles: (files: DialUploadFileItem[], destinationFolder: string) => void;
+    /** Upload: extracts and uploads a ZIP archive's entries to the destination folder. */
+    onUploadArchive: (file: File, name: string, destinationFolder: string) => void;
+    /** Upload: validate file names before upload (called by DialFileManager). */
+    onValidateUpload: (files: DialUploadFileItem[], existingFiles: DialFile[], destinationFolder: string) => Promise<FileUploadValidationResult>;
+    /** Upload: current batch state (null when idle). */
+    uploadBatchState: FileUploadBatchState | null;
+    /** Upload: abort all in-flight and queued uploads. */
+    cancelUpload: () => void;
+    /** Upload: abort one queued or in-flight upload by its entry id. */
+    cancelUploadFile: (id: string) => void;
+    /** Upload: empty the upload queue. */
+    clearUploadBatch: () => void;
+    /** Folder creation: called when user confirms a new folder name. */
+    onCreateFolder: (file: DialUploadFileItem, folderPath: string, fileId: string) => Promise<void>;
+    /** Folder creation: inline synchronous validation (returns error message or null). */
+    onCreateFolderValidate: (name: string, parentFolder: DialFile) => string | null;
+    /** True while a folder creation request is in flight. */
+    isCreatingFolder: boolean;
+    /** Download: called when user triggers download on one or more items; returns without waiting for the transfer. */
+    onDownloadFiles: (dialFiles: DialFile[]) => void;
+    /** True while at least one download is in progress. Does not block other actions. */
+    isDownloading: boolean;
+    /** Download: current batch state (null when idle). */
+    downloadBatchState: FileDownloadBatchState | null;
+    /** Download: abort one in-flight download by its entry id. */
+    cancelDownloadFile: (id: string) => void;
+    /** Download: abort every in-flight download. */
+    cancelAllDownloads: () => void;
+    /** Download: empty the download batch. */
+    clearDownloadBatch: () => void;
+    /** Delete: called when user confirms deletion of one or more items. */
+    onDeleteFiles: (items: DialDeletedItem[], sourceFolder: string) => void;
+    /** True while a delete request is in flight. */
+    isDeleting: boolean;
+    /** Rename: inline validation — returns error string or null. */
+    onRenameValidate: (value: string, item: DialFile) => string | null;
+    /** Rename: called when user confirms an inline rename. Also dispatches cross-folder move (see D3). */
+    onMoveToFiles: (items: DialCopiedItem[], sourceFolder: string, destinationFolder: string) => void;
+    /** True while a rename request is in flight. */
+    isRenaming: boolean;
+    /** Copy: called when user confirms a copy-paste. */
+    onCopyFiles: (items: DialCopiedItem[], destinationFolder: string) => void;
+    /** True while a copy request is in flight. */
+    isCopying: boolean;
+    /** True while the cross-folder-move branch of onMoveToFiles is in flight. */
+    isMoving: boolean;
+    /** Aborts whichever of copy/move is currently in flight. */
+    cancelCopyMove: () => void;
+    /** True when the current folder grants WRITE (upload + new folder). */
+    uploadEnabled: boolean;
+    /** True when Upload/New must be disabled. */
+    isNewButtonDisabled: boolean;
+    /** Tooltip for disabled New/Upload when `isNewButtonDisabled` is true. */
+    disabledNewButtonTooltip: string;
+    /** Columns to show in the grid — tab-dependent. */
+    visibleColumns: FileManagerColumnKey[];
+    /** BCP-47 locale string for date formatting, sourced from i18n.language. */
+    dateLocale: string;
+    /** Fixed date format options for the UpdatedAt column. */
+    dateOptions: Intl.DateTimeFormatOptions;
+    /** Action labels for grid/tree/bulk — Delete present only on my_files tab. */
+    actionLabels: Partial<Record<DialFileManagerActions, string>>;
+    /** Root-level shared item paths, populated only on the Shared tab. */
+    sharedWithMeIds: string[] | undefined;
+    /** Share: paths the user has shared with others, populated only on my_files tab. */
+    sharedByMePaths: Set<string>;
+    /** Unshare: called when user removes a shared-with-me item (Shared tab only). */
+    onUnshareFiles: (files: DialFile[]) => void;
+    /** True while an unshare request is in flight. */
+    isUnsharing: boolean;
+    /** Remove access: called when user revokes access to an owned shared item (my_files tab only). */
+    onRemoveFilesAccess: (files: DialFile[]) => void;
+    /** True while a remove-access request is in flight. */
+    isRemovingAccess: boolean;
+    /** Metadata: populated once onGetInfo resolves; passed to fileMetadataPopupOptions.fileMetadata. */
+    fileMetadata: DialFile | undefined;
+    /** True while a metadata request is in flight. */
+    isFileMetadataLoading: boolean;
+    /** Metadata: called by DialFileManager.onGetInfo to fetch and display a file's details. */
+    onGetInfo: (file: DialFile) => void;
+    /** Metadata: resets fileMetadata/isFileMetadataLoading; passed to fileMetadataPopupOptions.clearMetadata. */
+    clearMetadata: () => void;
+    /**
+     * True while any mutating file-manager operation is in flight: the OR of
+     * `isCreatingFolder`, `isDeleting`, `isRenaming`, `isCopying`,
+     * `isMoving`, `isUnsharing`, `isRemovingAccess`, and any upload still queued or running.
+     *
+     * Deliberately excludes three flags, each already fully contained by its own
+     * scoped loading UI:
+     * - `isLoading` — a read (listing fetch), not a mutation.
+     * - `isSearching` — scoped to ui-kit's own search-progress UI.
+     * - `isFileMetadataLoading` — has its own `loading` state in `fileMetadataPopupOptions`.
+     */
+    isAnyOperationInProgress: boolean;
+}
+//# sourceMappingURL=dial-file-manager.types.d.ts.map

package/files/dial-file-manager.types.d.ts.map

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

package/files/dial-file-to-attachment.d.ts

@@ -0,0 +1,26 @@
+import { Attachment } from '@epam/ai-dial-chat-shared';
+import { DialFile } from '@epam/ai-dial-ui-kit';
+/** Options for {@link dialFileToAttachment} and {@link dialFilesToAttachments}. */
+export interface DialFileToAttachmentOptions {
+    /**
+     * Resolves an image attachment's `previewUrl` from its DIAL resource URL.
+     * Left unset, image attachments get no `previewUrl`. The host owns bucket/
+     * icon-path REST construction — this hook never builds those URLs itself.
+     */
+    resolvePreviewUrl?: (url: string) => string | undefined;
+}
+/**
+ * Converts a selected ui-kit file into the generic attachment contract.
+ * DIAL storage identifiers are resolved at the app edge so the input library
+ * remains unaware of buckets, server routes, and external file systems.
+ */
+export declare const dialFileToAttachment: (file: DialFile, bucket: string, options?: DialFileToAttachmentOptions) => Attachment | null;
+/** Maps a batch of selected DIAL files to attachments, dropping folders and unresolvable entries. */
+export declare const dialFilesToAttachments: (files: DialFile[], bucket: string, options?: DialFileToAttachmentOptions) => Attachment[];
+/**
+ * Converts a DIAL Core folder path (e.g. `files/{bucket}/{path}/`) into an
+ * attachment. DIAL Core resolves folder contents server-side when the path is
+ * sent as an attachment URL.
+ */
+export declare const dialFolderPathToAttachment: (folderPath: string) => Attachment;
+//# sourceMappingURL=dial-file-to-attachment.d.ts.map

package/files/dial-file-to-attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dial-file-to-attachment.d.ts","sourceRoot":"","sources":["../../src/files/dial-file-to-attachment.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAkBvE,mFAAmF;AACnF,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACzD;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,QAAQ,EACd,QAAQ,MAAM,EACd,UAAU,2BAA2B,KACpC,UAAU,GAAG,IAoBf,CAAC;AAEF,qGAAqG;AACrG,eAAO,MAAM,sBAAsB,GACjC,OAAO,QAAQ,EAAE,EACjB,QAAQ,MAAM,EACd,UAAU,2BAA2B,KACpC,UAAU,EAG4D,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GAAI,YAAY,MAAM,KAAG,UAa/D,CAAC"}

package/files/dial-file-to-attachment.js

@@ -22,15 +22,15 @@ var a = (e, n) => {
 		...u == null ? {} : { previewUrl: u }
 	};
 }, s = (e, t, n) => e.map((e) => o(e, t, n)).filter((e) => e != null), c = (t) => {
-	let i = e(t.replace(/\/$/, "").split("/").filter(Boolean).pop() ?? "");
+	let i = t.replace(/\/$/, "").split("/").filter(Boolean).pop() ?? "", a = e(i);
 	return {
 		id: t,
-		name: i,
+		name: a,
 		contentType: "application/octet-stream",
 		type: n.File,
 		status: r.Idle,
 		url: t,
-		file: new File([], i)
+		file: new File([], a)
 	};
 };
 //#endregion

package/files/dial-file.d.ts

@@ -0,0 +1,36 @@
+import { DialFile } from '@epam/ai-dial-ui-kit';
+/** True when `url` looks like a DIAL Core file id (`files/{bucket}/{path}`). */
+export declare const isDialFileId: (url: string) => boolean;
+/** True when `url` is a DIAL Core folder id: a file id ending with `/`, ignoring any `#...` fragment. */
+export declare const isDialFolderId: (url: string) => boolean;
+/**
+ * Converts a DIAL file ID or full resource path to the relative bucket path
+ * expected by the files download API.
+ */
+export declare const resolveRelativeDialFilePath: (pathOrFileId: string, bucket: string) => string;
+/**
+ * Extracts the bucket and decoded relative path from a DIAL file ID
+ * (`files/{bucket}/{path}`). Returns `undefined` if the input does not start
+ * with `files/` or has no path segment after the bucket.
+ */
+export declare const resolveDialFileBucketAndPath: (fileId: string) => {
+    bucket: string;
+    path: string;
+} | undefined;
+/** What a file-manager selection consists of, for picking its confirmation copy. */
+export declare enum FileSelectionKind {
+    /** Exactly one file. */
+    File = "file",
+    /** Exactly one folder. */
+    Folder = "folder",
+    /** Zero or several items. */
+    Multiple = "multiple"
+}
+/** Returns whether a selection is one file, one folder or several items. */
+export declare const getFileSelectionKind: (items: readonly Pick<DialFile, "nodeType">[]) => FileSelectionKind;
+/**
+ * Returns the DIAL folder path (`files/{bucket}/{path}/`) for a file-manager
+ * folder, or `null` when it carries neither `url` nor `id`.
+ */
+export declare const resolveDialFolderPath: (file: Pick<DialFile, "url" | "id" | "bucket">, bucket: string) => string | null;
+//# sourceMappingURL=dial-file.d.ts.map

package/files/dial-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dial-file.d.ts","sourceRoot":"","sources":["../../src/files/dial-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGvE,gFAAgF;AAChF,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,OAAmC,CAAC;AAE/E,yGAAyG;AACzG,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,OACS,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,GACtC,cAAc,MAAM,EACpB,QAAQ,MAAM,KACb,MAmBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GACvC,QAAQ,MAAM,KACb;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAcrC,CAAC;AAEF,oFAAoF;AACpF,oBAAY,iBAAiB;IAC3B,wBAAwB;IACxB,IAAI,SAAS;IACb,0BAA0B;IAC1B,MAAM,WAAW;IACjB,6BAA6B;IAC7B,QAAQ,aAAa;CACtB;AAED,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,GAC/B,OAAO,SAAS,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,KAC3C,iBAKF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,GAAG,QAAQ,CAAC,EAC7C,QAAQ,MAAM,KACb,MAAM,GAAG,IAcX,CAAC"}

package/files/dial-file.js

@@ -1,21 +1,22 @@
 import { safeDecodeURI as e } from "../shared/string-utils.js";
+import { DialFileNodeType as t } from "@epam/ai-dial-ui-kit";
 //#region src/files/dial-file.ts
-var t = (e) => e.startsWith("files/"), n = (n, r) => {
+var n = (e) => e.startsWith("files/"), r = (e) => n(e) && e.split("#")[0].endsWith("/"), i = (t, r) => {
 	let i = `files/${r}/`;
-	if (n.startsWith(i)) return e(n.slice(i.length));
-	if (t(n)) {
-		let t = n.slice(6), i = t.indexOf("/");
+	if (t.startsWith(i)) return e(t.slice(i.length));
+	if (n(t)) {
+		let n = t.slice(6), i = n.indexOf("/");
 		if (i >= 0) {
-			let n = t.slice(0, i), a = t.slice(i + 1);
-			if (n === r) return e(a);
+			let t = n.slice(0, i), a = n.slice(i + 1);
+			if (t === r) return e(a);
 		}
 	}
-	return n;
-}, r = (e) => {
-	if (!t(e)) return;
-	let n = e.slice(6), r = n.indexOf("/");
+	return t;
+}, a = (e) => {
+	if (!n(e)) return;
+	let t = e.slice(6), r = t.indexOf("/");
 	if (r < 0) return;
-	let i = n.slice(0, r), a = n.slice(r + 1), o;
+	let i = t.slice(0, r), a = t.slice(r + 1), o;
 	try {
 		o = decodeURIComponent(a);
 	} catch {
@@ -25,6 +26,13 @@ var t = (e) => e.startsWith("files/"), n = (n, r) => {
 		bucket: i,
 		path: o
 	};
+}, o = /* @__PURE__ */ function(e) {
+	return e.File = "file", e.Folder = "folder", e.Multiple = "multiple", e;
+}({}), s = (e) => e.length === 1 ? e[0].nodeType === t.FOLDER ? "folder" : "file" : "multiple", c = (e, t) => {
+	let r = e.url ?? e.id ?? "";
+	if (!r) return null;
+	let i = (n(r) ? r : `files/${e.bucket ?? t}/${r.replace(/^\/+/, "")}`).split("/").filter((e) => e !== ".." && e !== ".").join("/");
+	return i.endsWith("/") ? i : `${i}/`;
 };
 //#endregion
-export { t as isDialFileId, r as resolveDialFileBucketAndPath, n as resolveRelativeDialFilePath };
+export { o as FileSelectionKind, s as getFileSelectionKind, n as isDialFileId, r as isDialFolderId, a as resolveDialFileBucketAndPath, c as resolveDialFolderPath, i as resolveRelativeDialFilePath };

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

@@ -0,0 +1,71 @@
+import { ArchiveItemDto, CopyFilesResponseDto, CopyItemDto, CreateFolderDto, CreateFolderResponseDto, DeleteFilesResponseDto, DeleteItemDto, DiscardSharedItemDto, DiscardSharedResponseDto, FileMetadataResponseDto, FileUploadResponseDto, ListFilesResponseDto, ListPublicFilesRequest, ListSharedFilesRequest, MoveFilesResponseDto, MoveItemDto, RenameFilesResponseDto, RenameItemDto, RevokeAccessItemDto, RevokeAccessResponseDto, UploadArchiveResponseDto } from '@epam/ai-dial-chat-api-client';
+/** Upload mode passed through to `DialFilesApi.uploadFile` — mirrors the BFF's `uploadMode` form field. */
+export declare enum DialFilesApiUploadMode {
+    Overwrite = "overwrite",
+    CreateOnly = "create-only"
+}
+/** Options accepted by `DialFilesApi.uploadFile` beyond an already-created `AbortSignal`. */
+export interface DialFilesApiUploadOptions {
+    /** Aborts the in-flight upload when triggered. */
+    signal?: AbortSignal;
+    /** Called with the 0–100 upload progress percentage when the transport reports byte progress. */
+    onProgress?: (percent: number) => void;
+    /** Controls create-only vs. overwrite semantics for the destination path. */
+    uploadMode?: DialFilesApiUploadMode;
+}
+/**
+ * Operation port every file-manager hook that performs network I/O accepts as
+ * a parameter, replacing direct `server-api/files.api` access. Mirrors
+ * `apps/chat/src/server-api/files.api.ts`'s exact function signatures — not
+ * the generated client's own method shapes — since that file wraps
+ * `uploadFile`/`uploadArchive` with custom XHR-based progress/cancellation
+ * that has no equivalent in the generated client.
+ */
+export interface DialFilesApi {
+    /** Lists files/folders directly under `params.path` within `params.bucket`. */
+    listFiles(params: {
+        bucket: string;
+        path?: string;
+        token?: string;
+        limit?: number;
+        recursive?: boolean;
+        permissions?: boolean;
+    }, signal?: AbortSignal): Promise<ListFilesResponseDto>;
+    /** Lists files/folders under the organization's public root. */
+    listPublicFiles(params: ListPublicFilesRequest): Promise<ListFilesResponseDto>;
+    /** Lists files/folders shared with the current user. */
+    listSharedFiles(params: ListSharedFilesRequest): Promise<ListFilesResponseDto>;
+    /** Lists items the current user has shared with others, from their own bucket. */
+    listSharedByMe(bucket: string): Promise<ListFilesResponseDto>;
+    /** Fetches metadata for a single file or folder. */
+    getFileMetadata(params: {
+        bucket: string;
+        path: string;
+    }): Promise<FileMetadataResponseDto>;
+    /**
+     * Uploads a file, reporting progress via `options.onProgress` when supplied
+     * and honoring cancellation via `options.signal` or a bare `AbortSignal`.
+     */
+    uploadFile(bucket: string, path: string, file: File, options?: AbortSignal | DialFilesApiUploadOptions): Promise<FileUploadResponseDto>;
+    /** Uploads a ZIP archive and extracts its entries under `destinationPath`. */
+    uploadArchive(file: File, bucket: string, destinationPath: string): Promise<UploadArchiveResponseDto>;
+    /** Creates a new folder. */
+    createFolder(params: CreateFolderDto): Promise<CreateFolderResponseDto>;
+    /** Deletes one or more files/folders. */
+    deleteFiles(items: DeleteItemDto[]): Promise<DeleteFilesResponseDto>;
+    /** Renames one or more files/folders in place (same parent folder). */
+    renameFiles(items: RenameItemDto[]): Promise<RenameFilesResponseDto>;
+    /** Copies one or more files/folders to a destination path. */
+    copyFiles(items: CopyItemDto[], signal?: AbortSignal): Promise<CopyFilesResponseDto>;
+    /** Moves one or more files/folders to a destination path (different parent folder). */
+    moveFiles(items: MoveItemDto[], signal?: AbortSignal): Promise<MoveFilesResponseDto>;
+    /** Downloads a single file, returning the raw fetch `Response`. */
+    downloadFile(bucket: string, path: string, signal?: AbortSignal): Promise<Response>;
+    /** Downloads a ZIP archive of the given items, returning the raw fetch `Response`; `signal` aborts the request and its body. */
+    downloadArchive(items: ArchiveItemDto[], signal?: AbortSignal): Promise<Response>;
+    /** Revokes access previously granted on the given owned items. */
+    revokeAccess(items: RevokeAccessItemDto[]): Promise<RevokeAccessResponseDto>;
+    /** Discards items shared with the current user. */
+    discardShared(items: DiscardSharedItemDto[]): Promise<DiscardSharedResponseDto>;
+}
+//# sourceMappingURL=dial-files-api.d.ts.map

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

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

package/files/download-destination.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Where a downloaded file's bytes should be written. Mirrors the host's own
+ * "Save As" vs. blob-download vs. cancelled-picker outcomes without the lib
+ * depending on the host's browser-API implementation.
+ */
+export declare enum DownloadDestinationType {
+    Blob = "blob",
+    Stream = "stream",
+    Cancelled = "cancelled"
+}
+/** Discriminated destination a host resolves for a download, passed back into `triggerDownload`. */
+export type DownloadDestination = {
+    type: DownloadDestinationType.Blob;
+} | {
+    type: DownloadDestinationType.Stream;
+    writable: WritableStream<Uint8Array>;
+} | {
+    type: DownloadDestinationType.Cancelled;
+};
+/**
+ * Host-injected seam for `useDialFileMutations.onDownloadFiles`, replacing a
+ * direct import of the app's browser "Save As" / auto-download utilities —
+ * that behavior is desktop/web-shell-specific, not file-manager domain logic.
+ */
+export interface DownloadDestinationHandlers {
+    /** Resolves where a download with the given file name/MIME type should be written. */
+    resolveDestination(filename: string, mimeType: string): Promise<DownloadDestination>;
+    /** Writes `response` to `destination` and returns the name it was saved under. */
+    triggerDownload(response: Response, fallbackName: string, destination: DownloadDestination): Promise<string>;
+}
+//# sourceMappingURL=download-destination.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"download-destination.d.ts","sourceRoot":"","sources":["../../src/files/download-destination.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oBAAY,uBAAuB;IACjC,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED,oGAAoG;AACpG,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,uBAAuB,CAAC,IAAI,CAAA;CAAE,GACtC;IACE,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CACtC,GACD;IAAE,IAAI,EAAE,uBAAuB,CAAC,SAAS,CAAA;CAAE,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,sFAAsF;IACtF,kBAAkB,CAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,kFAAkF;IAClF,eAAe,CACb,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,mBAAmB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAAC;CACpB"}

package/files/download-progress.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Returns a `Response` that streams the same bytes as `response` and calls
+ * `onBytes` with the running total of bytes read; headers and status are kept,
+ * so `Content-Disposition` naming still works. A response without a body is
+ * returned unchanged.
+ */
+export declare const withDownloadProgress: (response: Response, onBytes: (received: number) => void) => Response;
+/** The response's `Content-Length` as a positive byte count, or `undefined` when it is absent or not a positive number. */
+export declare const getContentLength: (response: Response) => number | undefined;
+/**
+ * Percent of `total` received, or `undefined` when the total is unknown. An
+ * estimated total (an archive) is capped at 99 so the row never reads 100
+ * before the stream actually ends.
+ */
+export declare const getDownloadPercent: (received: number, total: number | undefined, isEstimate: boolean) => number | undefined;
+/** An error for a non-OK download `Response` that keeps it, so `getApiErrorDetails` reads its status and body. */
+export declare const createDownloadResponseError: (response: Response) => Error;
+/** The size an item contributes to an archive estimate: a file with a known size. */
+interface ArchiveSizedItem {
+    /** Whether the item is a file or a folder. */
+    isFolder: boolean;
+    /** The file's size in bytes, when known. */
+    contentLength?: number;
+}
+/**
+ * Estimated archive size: the sum of the selected files' sizes, or `undefined`
+ * when any item is a folder (its contents are not known up front) or has no
+ * size. The zip is stored uncompressed, so the sum undershoots only by the
+ * per-entry headers.
+ */
+export declare const estimateArchiveSize: (items: ArchiveSizedItem[]) => number | undefined;
+export {};
+//# sourceMappingURL=download-progress.d.ts.map