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

package/files/useDialFileSharing/useDialFileSharing.d.ts

@@ -0,0 +1,34 @@
+import { DialFile } from '@epam/ai-dial-react-file-manager';
+import { FileManagerNotification, FileOperationSuccessEvent } from '../dial-file-manager.types';
+import { DialFilesApi } from '../dial-files-api';
+/** Options accepted by `useDialFileSharing`. */
+export interface UseDialFileSharingOptions {
+    /** Injected operation port used for every sharing network call. */
+    filesApi: DialFilesApi;
+    /** DIAL Core bucket to browse (used only for the my_files tab). */
+    bucket: string;
+    /** Display name for the root folder node. */
+    rootLabel: string;
+    /** Forces `useDialFileListing`'s fetch effect to re-run after a mutation settles. */
+    bumpRetry: () => void;
+    /** Called when a sharing mutation fails and should surface a toast notification. */
+    onNotification?: (notification: FileManagerNotification) => void;
+    /** Called with a structured event once an unshare succeeds, so the host can show its success toast. */
+    onOperationSuccess?: (event: FileOperationSuccessEvent) => void;
+    /** Removes the unshared root rows from the cached Shared listing ahead of the refetch. */
+    removeSharedRootItems?: (names: string[]) => void;
+}
+/** Values returned by `useDialFileSharing`. */
+export interface UseDialFileSharingResult {
+    isUnsharing: boolean;
+    isRemovingAccess: boolean;
+    onUnshareFiles: (files: DialFile[]) => void;
+    onRemoveFilesAccess: (files: DialFile[]) => void;
+}
+/**
+ * Manages the unshare/remove-access mutations. Bumps `useDialFileListing`'s
+ * shared retry counter after each mutation settles rather than holding its
+ * own cache copy.
+ */
+export declare const useDialFileSharing: ({ filesApi, bucket, rootLabel, bumpRetry, onNotification, onOperationSuccess, removeSharedRootItems, }: UseDialFileSharingOptions) => UseDialFileSharingResult;
+//# sourceMappingURL=useDialFileSharing.d.ts.map

package/files/useDialFileSharing/useDialFileSharing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDialFileSharing.d.ts","sourceRoot":"","sources":["../../../src/files/useDialFileSharing/useDialFileSharing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAOjE,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,gDAAgD;AAChD,MAAM,WAAW,yBAAyB;IACxC,mEAAmE;IACnE,QAAQ,EAAE,YAAY,CAAC;IACvB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,oFAAoF;IACpF,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACjE,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;IAChE,0FAA0F;IAC1F,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACnD;AAED,+CAA+C;AAC/C,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IAC5C,mBAAmB,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;CAClD;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,wGAQhC,yBAAyB,KAAG,wBAsF9B,CAAC"}

package/files/useDialFileSharing/useDialFileSharing.js

@@ -1,70 +1,76 @@
-import { FileManagerNotificationReason as e } from "../dial-file-manager.types.js";
-import { resolveDialFileApiPath as t } from "../resolve-dial-file-api-path.js";
-import { useCallback as n, useState as r } from "react";
-import { NotificationVariant as i } from "@epam/ai-dial-ui-kit";
+import { FileManagerNotificationReason as e, FileOperationKind as t } from "../dial-file-manager.types.js";
+import { resolveDialFileApiPath as n } from "../resolve-dial-file-api-path.js";
+import { useCallback as r, useState as i } from "react";
+import { NotificationVariant as a } from "@epam/ai-dial-ui-kit";
 //#region src/files/useDialFileSharing/useDialFileSharing.ts
-var a = ({ filesApi: a, bucket: o, rootLabel: s, bumpRetry: c, onNotification: l }) => {
-	let [u, d] = r(!1), [f, p] = r(!1);
+var o = ({ filesApi: o, bucket: s, rootLabel: c, bumpRetry: l, onNotification: u, onOperationSuccess: d, removeSharedRootItems: f }) => {
+	let [p, m] = i(!1), [h, g] = i(!1);
 	return {
-		isUnsharing: u,
-		isRemovingAccess: f,
-		onUnshareFiles: n((n) => {
-			n.length !== 0 && (async () => {
-				d(!0);
-				let r = n.map((e) => {
-					let n = e.bucket ?? o;
+		isUnsharing: p,
+		isRemovingAccess: h,
+		onUnshareFiles: r((r) => {
+			r.length !== 0 && (async () => {
+				m(!0);
+				let i = r.map((e) => {
+					let t = e.bucket ?? s;
 					return {
-						bucket: n,
-						path: t(e, n, s)
+						bucket: t,
+						path: n(e, t, c)
 					};
 				});
 				try {
-					await a.discardShared(r), c();
+					await o.discardShared(i), f?.(r.map((e) => e.name)), d?.({
+						kind: t.FilesUnshared,
+						name: r[0].name,
+						count: r.length
+					}), l();
 				} catch {
-					l?.({
-						variant: i.Error,
+					u?.({
+						variant: a.Error,
 						reason: e.UnshareFailed
 					});
 				} finally {
-					d(!1);
+					m(!1);
 				}
 			})();
 		}, [
-			o,
 			s,
-			l,
-			a,
-			c
+			c,
+			u,
+			d,
+			f,
+			o,
+			l
 		]),
-		onRemoveFilesAccess: n((n) => {
-			n.length !== 0 && (async () => {
-				p(!0);
-				let r = n.map((e) => {
-					let n = e.bucket ?? o;
+		onRemoveFilesAccess: r((t) => {
+			t.length !== 0 && (async () => {
+				g(!0);
+				let r = t.map((e) => {
+					let t = e.bucket ?? s;
 					return {
-						bucket: n,
-						path: t(e, n, s)
+						bucket: t,
+						path: n(e, t, c)
 					};
 				});
 				try {
-					await a.revokeAccess(r), c();
+					await o.revokeAccess(r), l();
 				} catch {
-					l?.({
-						variant: i.Error,
+					u?.({
+						variant: a.Error,
 						reason: e.RemoveAccessFailed
 					});
 				} finally {
-					p(!1);
+					g(!1);
 				}
 			})();
 		}, [
-			o,
 			s,
-			l,
-			a,
-			c
+			c,
+			u,
+			o,
+			l
 		])
 	};
 };
 //#endregion
-export { a as useDialFileSharing };
+export { o as useDialFileSharing };

package/files/useDialFileUploadBatch/useDialFileUploadBatch.d.ts

@@ -0,0 +1,47 @@
+import { ListFilesItemDto } from '@epam/ai-dial-chat-api-client';
+import { FileUploadBatchState, FileUploadValidationResult } from '@epam/ai-dial-chat-shared';
+import { DialFile, DialUploadFileItem, DialFileManagerTabs } from '@epam/ai-dial-react-file-manager';
+import { SharedRootMeta } from '../dial-file-manager.model';
+import { FileManagerNotification } from '../dial-file-manager.types';
+import { DialFilesApi } from '../dial-files-api';
+/** Options accepted by `useDialFileUploadBatch`. */
+export interface UseDialFileUploadBatchOptions {
+    /** Injected operation port used for every upload network call. */
+    filesApi: DialFilesApi;
+    /** DIAL Core bucket to browse (used only for the my_files tab). */
+    bucket: string;
+    /** Display name for the root folder node. */
+    rootLabel: string;
+    /** Active tab — drives owner-bucket resolution for the Shared tab. */
+    activeTab: DialFileManagerTabs;
+    /** Read-only snapshot of `useDialFileListing`'s cache, used to decide overwrite vs. create-only upload mode. */
+    cache: Map<string, ListFilesItemDto[]>;
+    /** Owner-bucket resolution metadata for the Shared tab, owned by `useDialFileListing`. */
+    sharedRootMetaRef: React.RefObject<Map<string, SharedRootMeta>>;
+    /** Deletes the given API-path cache keys so the next fetch re-fetches them. */
+    invalidateFolders: (apiPaths: string[]) => void;
+    /** Forces `useDialFileListing`'s fetch effect to re-run. */
+    bumpRetry: () => void;
+    /** Called when an upload batch fails or completes and should surface a toast notification. */
+    onNotification?: (notification: FileManagerNotification) => void;
+}
+/** Values returned by `useDialFileUploadBatch`. */
+export interface UseDialFileUploadBatchResult {
+    onUploadFiles: (files: DialUploadFileItem[], destinationFolder: string) => void;
+    onUploadArchive: (file: File, name: string, destinationFolder: string) => void;
+    onValidateUpload: (files: DialUploadFileItem[], existingFiles: DialFile[], destinationFolder: string) => Promise<FileUploadValidationResult>;
+    uploadBatchState: FileUploadBatchState | null;
+    cancelUpload: () => void;
+    cancelUploadFile: (id: string) => void;
+    clearUploadBatch: () => void;
+}
+/**
+ * Manages upload batches (single-file and ZIP-archive extraction), including
+ * concurrency-limited progress tracking and per-file abort. A batch started
+ * while another is on screen is appended to it, and settled entries stay in
+ * `uploadBatchState` until `clearUploadBatch`. Invalidates the shared listing
+ * cache for the destination folder through `invalidateFolders`/`bumpRetry`
+ * after a batch settles — it never holds its own copy of the cache.
+ */
+export declare const useDialFileUploadBatch: ({ filesApi, bucket, rootLabel, activeTab, cache, sharedRootMetaRef, invalidateFolders, bumpRetry, onNotification, }: UseDialFileUploadBatchOptions) => UseDialFileUploadBatchResult;
+//# sourceMappingURL=useDialFileUploadBatch.d.ts.map

package/files/useDialFileUploadBatch/useDialFileUploadBatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDialFileUploadBatch.d.ts","sourceRoot":"","sources":["../../../src/files/useDialFileUploadBatch/useDialFileUploadBatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EACV,oBAAoB,EAEpB,0BAA0B,EAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,QAAQ,EACR,kBAAkB,EACnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAKvE,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAG1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAyDtD,oDAAoD;AACpD,MAAM,WAAW,6BAA6B;IAC5C,kEAAkE;IAClE,QAAQ,EAAE,YAAY,CAAC;IACvB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,SAAS,EAAE,mBAAmB,CAAC;IAC/B,gHAAgH;IAChH,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACvC,0FAA0F;IAC1F,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAChE,+EAA+E;IAC/E,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAChD,4DAA4D;IAC5D,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,8FAA8F;IAC9F,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAClE;AAED,mDAAmD;AACnD,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,CACb,KAAK,EAAE,kBAAkB,EAAE,EAC3B,iBAAiB,EAAE,MAAM,KACtB,IAAI,CAAC;IACV,eAAe,EAAE,CACf,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,MAAM,KACtB,IAAI,CAAC;IACV,gBAAgB,EAAE,CAChB,KAAK,EAAE,kBAAkB,EAAE,EAC3B,aAAa,EAAE,QAAQ,EAAE,EACzB,iBAAiB,EAAE,MAAM,KACtB,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACzC,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC9C,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,qHAUpC,6BAA6B,KAAG,4BAwRlC,CAAC"}

package/files/useDialFileUploadBatch/useDialFileUploadBatch.js

@@ -32,18 +32,22 @@ var f = 5, p = (e) => e.error ? `${e.path} (${e.error})` : e.path, m = (e) => {
 		}])), (async () => {
 			let r = o.Failed;
 			try {
-				let { results: i } = await f.uploadArchive(e, p, h(s, t)), a = i.filter((e) => e.success).length, c = i.filter((e) => !e.success), l = c.length, { names: d, restCount: g } = m(c);
+				let { results: i } = await f.uploadArchive(e, p, h(s, t)), a = i.filter((e) => e.success).length, c = i.filter((e) => !e.success), l = c.length, { names: d, restCount: _ } = m(c);
 				i.length > 0 && a === 0 ? T?.({
 					variant: u.Error,
 					reason: n.UploadArchiveFailed,
 					names: d,
-					restCount: g
-				}) : (r = o.Completed, l > 0 && T?.({
+					restCount: _
+				}) : (r = o.Completed, l > 0 ? T?.({
 					variant: u.Error,
 					reason: n.UploadArchivePartiallyFailed,
 					count: l,
 					names: d,
-					restCount: g
+					restCount: _
+				}) : T?.({
+					variant: u.Success,
+					reason: n.UploadCompleted,
+					folder: s || g
 				}));
 			} catch {
 				T?.({

package/files/useFileAttachmentPicker/useFileAttachmentPicker.d.ts

@@ -0,0 +1,59 @@
+import { FileManagerSelectableNode } from '@epam/ai-dial-chat-shared';
+import { DialFileManagerTabs, DialFileAcceptType, FileTreeOptions } from '@epam/ai-dial-react-file-manager';
+import { UseDialFileManagerOptions, UseDialFileManagerResult } from '../dial-file-manager.types';
+/** Options accepted by {@link useFileAttachmentPicker}. */
+export interface UseFileAttachmentPickerOptions {
+    /**
+     * Configured `useDialFileManager` options besides the values this hook derives:
+     * `bucket`, `activeTab`, `rootLabel`, `variant`, and `forbiddenSymbolsRegExp`.
+     */
+    fileManagerOptions: Omit<UseDialFileManagerOptions, 'bucket' | 'activeTab' | 'rootLabel' | 'variant' | 'forbiddenSymbolsRegExp'>;
+    /** DIAL Core bucket to browse. */
+    bucket: string;
+    /** Regexp of characters forbidden in file/folder names, forwarded to `useDialFileManager`. */
+    forbiddenSymbolsRegExp?: RegExp;
+    /** Host-translated label per tab; also supplies the active tab's root-folder label. */
+    tabLabels: Record<DialFileManagerTabs, string>;
+    /** Tab ids the host's configuration allows. `undefined` allows every tab. */
+    allowedTabs?: string[];
+    /** Initial active tab. Defaults to `DialFileManagerTabs.MyFiles`. */
+    initialTab?: DialFileManagerTabs;
+    /** MIME types eligible for selection/upload. Empty or absent allows every type. */
+    allowedTypes?: string[];
+    /** Files at or below this size (bytes) remain eligible; absent allows any size. */
+    maxSelectableFileSize?: number;
+    /** Whether folder rows are eligible for selection. Defaults to `false`. */
+    canAttachFolders?: boolean;
+}
+/** Result returned by {@link useFileAttachmentPicker}. */
+export interface UseFileAttachmentPickerResult {
+    /** The composed file-manager controller; forward to `FileManagerAttachModal`'s `controller` prop. */
+    controller: UseDialFileManagerResult;
+    /** Active tab. */
+    activeTab: DialFileManagerTabs;
+    /** Tab list filtered to `allowedTabs`; forward to `FileManagerAttachModal`'s `tabs` prop. */
+    tabs: FileTreeOptions['tabs'];
+    /** Switches the active tab and clears the current selection. */
+    onTabChange: (tab: DialFileManagerTabs) => void;
+    /** Currently selected paths. */
+    selectedPaths: Set<string>;
+    /** Replaces the selection with a defensive copy of the given set. */
+    onSelectedPathsChange: (paths: Set<string>) => void;
+    /** Row eligibility predicate; forward to `FileManagerAttachModal`'s `isRowSelectable` prop. */
+    isRowSelectable: (node: {
+        data?: FileManagerSelectableNode | null;
+    }) => boolean;
+    /** MIME eligibility predicate; forward to `FileManagerAttachModal`'s `isFileTypeAllowed` prop. */
+    isFileTypeAllowed: (contentType: string) => boolean;
+    /** Accepted upload MIME types; forward to `FileManagerAttachModal`'s `allowedFileTypes` prop. */
+    allowedFileTypes: DialFileAcceptType[] | undefined;
+}
+/**
+ * Composes the file-manager tab/listing hooks into the stateful part of an attachment picker:
+ * active tab, selected paths, and hidden-path/MIME/size/folder row eligibility. Returns the
+ * existing `useDialFileManager` controller unchanged and the selection/tab/eligibility fields
+ * `FileManagerAttachModal` already consumes — it composes that modal, it does not replace it.
+ * Final attachment filtering, deduplication, and count enforcement stay owned by the modal.
+ */
+export declare const useFileAttachmentPicker: ({ fileManagerOptions, bucket, forbiddenSymbolsRegExp, tabLabels, allowedTabs, initialTab, allowedTypes, maxSelectableFileSize, canAttachFolders, }: UseFileAttachmentPickerOptions) => UseFileAttachmentPickerResult;
+//# sourceMappingURL=useFileAttachmentPicker.d.ts.map

package/files/useFileAttachmentPicker/useFileAttachmentPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileAttachmentPicker.d.ts","sourceRoot":"","sources":["../../../src/files/useFileAttachmentPicker/useFileAttachmentPicker.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,mBAAmB,EAGnB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACrB,MAAM,kCAAkC,CAAC;AAI1C,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAIpC,2DAA2D;AAC3D,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,kBAAkB,EAAE,IAAI,CACtB,yBAAyB,EACzB,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,wBAAwB,CAC5E,CAAC;IACF,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,8FAA8F;IAC9F,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAC/C,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qEAAqE;IACrE,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mFAAmF;IACnF,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,0DAA0D;AAC1D,MAAM,WAAW,6BAA6B;IAC5C,qGAAqG;IACrG,UAAU,EAAE,wBAAwB,CAAC;IACrC,kBAAkB;IAClB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,6FAA6F;IAC7F,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAC9B,gEAAgE;IAChE,WAAW,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAChD,gCAAgC;IAChC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,qEAAqE;IACrE,qBAAqB,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACpD,+FAA+F;IAC/F,eAAe,EAAE,CAAC,IAAI,EAAE;QACtB,IAAI,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;KACzC,KAAK,OAAO,CAAC;IACd,kGAAkG;IAClG,iBAAiB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;IACpD,iGAAiG;IACjG,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,SAAS,CAAC;CACpD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAAI,oJAUrC,8BAA8B,KAAG,6BAqHnC,CAAC"}