@epam/ai-dial-chat-hooks 1.3.0-dev.28 → 1.3.0-dev.282

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

@@ -0,0 +1 @@
+{"version":3,"file":"download-progress.d.ts","sourceRoot":"","sources":["../../src/files/download-progress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,QAAQ,EAClB,SAAS,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,KAClC,QAiBF,CAAC;AAEF,2HAA2H;AAC3H,eAAO,MAAM,gBAAgB,GAAI,UAAU,QAAQ,KAAG,MAAM,GAAG,SAG9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,MAAM,EAChB,OAAO,MAAM,GAAG,SAAS,EACzB,YAAY,OAAO,KAClB,MAAM,GAAG,SAIX,CAAC;AAEF,kHAAkH;AAClH,eAAO,MAAM,2BAA2B,GAAI,UAAU,QAAQ,KAAG,KAG7D,CAAC;AAEL,qFAAqF;AACrF,UAAU,gBAAgB;IACxB,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,gBAAgB,EAAE,KACxB,MAAM,GAAG,SAOX,CAAC"}

package/files/download-progress.js

@@ -0,0 +1,28 @@
+//#region src/files/download-progress.ts
+var e = (e, t) => {
+	if (!e.body) return e;
+	let n = 0, r = new TransformStream({ transform(e, r) {
+		n += e.byteLength, t(n), r.enqueue(e);
+	} });
+	return new Response(e.body.pipeThrough(r), {
+		headers: e.headers,
+		status: e.status,
+		statusText: e.statusText
+	});
+}, t = (e) => {
+	let t = Number(e.headers.get("content-length"));
+	return Number.isFinite(t) && t > 0 ? t : void 0;
+}, n = (e, t, n) => {
+	if (t == null) return;
+	let r = Math.round(e / t * 100);
+	return Math.min(n ? 99 : 100, r);
+}, r = (e) => Object.assign(/* @__PURE__ */ Error(`Download failed with status ${e.status}`), { response: e }), i = (e) => {
+	let t = 0;
+	for (let n of e) {
+		if (n.isFolder || n.contentLength == null) return;
+		t += n.contentLength;
+	}
+	return t > 0 ? t : void 0;
+};
+//#endregion
+export { r as createDownloadResponseError, i as estimateArchiveSize, t as getContentLength, n as getDownloadPercent, e as withDownloadProgress };

package/files/file-manager-variant.d.ts

@@ -0,0 +1,3 @@
+import { DialFileManagerActionProfile, DialFileManagerVariant } from '@epam/ai-dial-chat-shared';
+export declare const deriveActionProfile: (variant: DialFileManagerVariant) => DialFileManagerActionProfile;
+//# sourceMappingURL=file-manager-variant.d.ts.map

package/files/file-manager-variant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-manager-variant.d.ts","sourceRoot":"","sources":["../../src/files/file-manager-variant.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,mBAAmB,GAC9B,SAAS,sBAAsB,KAC9B,4BASF,CAAC"}

package/files/file-name.d.ts

@@ -0,0 +1,19 @@
+/** Splits a file name into its base and extension, using only the last dot. */
+export declare const splitFileNameExtension: (fileName: string) => {
+    base: string;
+    extension: string;
+};
+export declare const trimFileNameToByteLimit: (name: string, limit?: number) => string;
+/**
+ * Sanitizes a filename for upload by replacing forbidden characters with `_`,
+ * trimming trailing dots/whitespace from the base name, and capping the result
+ * to 255 UTF-8 bytes.
+ *
+ * Mutates nothing — returns a new string. The caller (onValidateUpload) is
+ * responsible for writing the result back to DialUploadFileItem.name so the
+ * ui-kit's subsequent conflict detection sees the sanitized name.
+ *
+ * If the base name is empty after sanitization, returns the original name unchanged.
+ */
+export declare const sanitizeFileName: (name: string) => string;
+//# sourceMappingURL=file-name.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-name.d.ts","sourceRoot":"","sources":["../../src/files/file-name.ts"],"names":[],"mappings":"AAMA,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,KACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAOnC,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,EAAE,cAAW,KAAG,MAYnE,CAAC;AAiBF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAY/C,CAAC"}

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

@@ -0,0 +1,8 @@
+import { DownloadDestination } from './download-destination';
+/**
+ * Resolves where a download should be written: the browser's native "Save
+ * As" picker when available (`window.showSaveFilePicker`), otherwise a
+ * plain blob download. Returns `Cancelled` if the user dismisses the picker.
+ */
+export declare const prepareDownloadDestination: (filename: string, mimeType?: string) => Promise<DownloadDestination>;
+//# sourceMappingURL=prepare-download-destination.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-download-destination.d.ts","sourceRoot":"","sources":["../../src/files/prepare-download-destination.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAchC;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAU,MAAM,EAChB,iBAAqC,KACpC,OAAO,CAAC,mBAAmB,CAkC7B,CAAC"}

package/files/resolve-dial-file-api-path.d.ts

@@ -0,0 +1,12 @@
+import { DialFile } from '@epam/ai-dial-react-file-manager';
+/**
+ * Converts a DialFileManager virtual path to an API folder path.
+ * e.g. "/My files" → "", "/My files/reports/" → "reports/"
+ */
+export declare const virtualPathToApiPath: (virtualPath: string, rootLabel: string) => string;
+/**
+ * Resolves a DialFile to the bucket-relative API path used by files BFF endpoints.
+ * Prefers DIAL resource ids when present; otherwise converts DialFile.path virtual paths.
+ */
+export declare const resolveDialFileApiPath: (file: DialFile, bucket: string, rootLabel: string) => string;
+//# sourceMappingURL=resolve-dial-file-api-path.d.ts.map

package/files/resolve-dial-file-api-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-dial-file-api-path.d.ts","sourceRoot":"","sources":["../../src/files/resolve-dial-file-api-path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAoCjE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,aAAa,MAAM,EACnB,WAAW,MAAM,KAChB,MAiCF,CAAC;AAOF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,QAAQ,EACd,QAAQ,MAAM,EACd,WAAW,MAAM,KAChB,MAkBF,CAAC"}

package/files/source-content.d.ts

@@ -0,0 +1,28 @@
+/** Pure source classification. Keep MIME values aligned with attachment-canvas
+ * without importing its renderer dependency graph into this entry point. */
+/**
+ * Returns the last path segment of `url` — its file name — for both absolute
+ * URLs and DIAL-relative resource paths such as
+ * `files/<bucket>/qa-routed-source.html`. Any query string or hash is dropped
+ * and percent escapes are decoded. Returns an empty string when no segment can
+ * be extracted. Used to classify a resource by extension when its display name
+ * is a citation title rather than a file name.
+ */
+export declare const getUrlFileName: (url: string) => string;
+/**
+ * Returns the content type to trust for an external citation source: `contentType`
+ * unchanged when it is already an image/audio/PDF/document-renderer marker,
+ * otherwise the type implied by `url`'s path extension (`application/pdf` for
+ * `.pdf`, the canonical MIME for `.docx`/`.xlsx`/`.pptx`/`.csv`) when that
+ * extension is recognized, otherwise `contentType` unchanged.
+ *
+ * Web-search grounding APIs label every reference — PDFs and Office documents
+ * included — as `text/markdown`, so a mislabeled `contentType` must not win
+ * over a recognized URL extension: doing so previously sent a PDF's raw bytes
+ * into the markdown/text canvas viewer, rendering garbled text instead of
+ * opening the PDF/OOXML viewer.
+ */
+export declare const resolveExternalSourceContentType: (contentType: string, url: string) => string;
+/** Returns true when an external (non-DIAL) source URL should be opened in the canvas rather than a new browser tab. */
+export declare const isExternalSourcePreviewable: (contentType: string, url: string) => boolean;
+//# sourceMappingURL=source-content.d.ts.map

package/files/source-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-content.d.ts","sourceRoot":"","sources":["../../src/files/source-content.ts"],"names":[],"mappings":"AAAA;4EAC4E;AA8E5E;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,MAiB5C,CAAC;AAcF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gCAAgC,GAC3C,aAAa,MAAM,EACnB,KAAK,MAAM,KACV,MASF,CAAC;AAEF,wHAAwH;AACxH,eAAO,MAAM,2BAA2B,GACtC,aAAa,MAAM,EACnB,KAAK,MAAM,KACV,OAQF,CAAC"}

package/files/source-content.js

@@ -4,7 +4,7 @@ var e = {
 	xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
 	pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
 	csv: "text/csv"
-}, t = new Set(/* @__PURE__ */ "txt.md.markdown.json.jsonl.ndjson.xml.csv.tsv.yaml.yml.toml.ini.conf.cfg.css.scss.sass.less.js.jsx.ts.tsx.mjs.cjs.mts.cts.py.rb.go.rs.java.kt.swift.c.h.cpp.cs.sh.bash.zsh.fish.ps1.log.env.gitignore.dockerfile.makefile.sql".split(".")), n = new Set(["html", "htm"]), r = "pdf", i = "application/pdf", a = (e) => e.split(/[?#]/)[0], o = (e) => {
+}, t = /* @__PURE__ */ new Set(/* @__PURE__ */ "txt.md.markdown.json.jsonl.ndjson.xml.csv.tsv.yaml.yml.toml.ini.conf.cfg.css.scss.sass.less.js.jsx.ts.tsx.mjs.cjs.mts.cts.py.rb.go.rs.java.kt.swift.c.h.cpp.cs.sh.bash.zsh.fish.ps1.log.env.gitignore.dockerfile.makefile.sql".split(".")), n = /* @__PURE__ */ new Set(["html", "htm"]), r = "pdf", i = "application/pdf", a = (e) => e.split(/[?#]/)[0], o = (e) => {
 	let t = e.lastIndexOf(".");
 	return t === -1 ? "" : e.slice(t + 1).toLowerCase();
 }, s = (e) => {

package/files/useDialFileListing/useDialFileListing.d.ts

@@ -0,0 +1,82 @@
+import { CreateFolderResponseDto, ListFilesItemDto } from '@epam/ai-dial-chat-api-client';
+import { DialFile, 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 `useDialFileListing`. */
+export interface UseDialFileListingOptions {
+    /** Injected operation port used for every listing/search 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 (e.g. `'My files'`). */
+    rootLabel: string;
+    /** Active tab — drives listing source and per-tab options. */
+    activeTab: DialFileManagerTabs;
+    /** Called with a structured event when a folder-load operation fails. */
+    onNotification?: (notification: FileManagerNotification) => void;
+    /** When false, the hook 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;
+}
+/** Values returned by `useDialFileListing`. */
+export interface UseDialFileListingResult {
+    items: DialFile[];
+    isLoading: boolean;
+    error: string | null;
+    path: string;
+    /** Bucket-relative path of the currently browsed folder (e.g. `"reports/"`, `""` for root). */
+    folderPath: string;
+    onPathChange: (nextPath?: string) => void;
+    retry: () => void;
+    onSearchFiles: (folder: string, query: string) => void;
+    isSearching: boolean;
+    searchResults: DialFile[] | null;
+    clearSearchResults: () => void;
+    expandedPaths: Set<string>;
+    loadedPaths: Set<string>;
+    onExpandedPathsChange: (paths: Set<string>) => void;
+    onFolderPopupPathChange: (nextPath?: string) => void;
+    folderPopupLoadingPaths: Set<string>;
+    sharedWithMeIds: string[] | undefined;
+    sharedByMePaths: Set<string>;
+    currentFolder: DialFile | undefined;
+    /** Read-only snapshot of the per-folder listing cache, for `useDialFileUploadBatch`'s overwrite-mode check. */
+    cache: Map<string, ListFilesItemDto[]>;
+    /** Read-only snapshot of per-folder permissions, for `useDialFileMutations`'s create-folder inherited permissions. */
+    listingPermissionsCache: Map<string, string[] | undefined>;
+    /** Owner-bucket resolution metadata for the Shared tab, populated by the root listing fetch. */
+    sharedRootMetaRef: React.RefObject<Map<string, SharedRootMeta>>;
+    /** Imperatively navigates the current folder — used by mutations after a rename/delete of the browsed folder. */
+    setFolderPath: React.Dispatch<React.SetStateAction<string>>;
+    /**
+     * Deletes the given API-path cache keys so the next listing fetch/expand for
+     * that folder re-fetches from the server. The only way sibling sub-hooks may
+     * invalidate the shared cache (`openspec/changes/archive/2026-07-21-split-use-dial-file-manager/design.md` D1).
+     */
+    invalidateFolders: (apiPaths: string[]) => void;
+    /** Merges a just-created folder into its parent's cache entry (optimistic display for create-folder). */
+    mergeCreatedFolder: (parentApiPath: string, created: CreateFolderResponseDto, inheritedPermissions?: string[]) => void;
+    /** Forces the listing effect to re-fetch the currently browsed folder. */
+    bumpRetry: () => void;
+    /**
+     * Drops the named root rows from the Shared tab's cached listing, so an
+     * unshared item disappears at once instead of waiting for the refetch.
+     */
+    removeSharedRootItems: (names: string[]) => void;
+}
+/**
+ * Manages DIAL file-storage browsing state: folder listing/navigation, the
+ * tree's expand/collapse state, search, and the shared per-folder cache that
+ * `useDialFileUploadBatch`/`useDialFileMutations`/`useDialFileSharing` invalidate
+ * through `invalidateFolders`/`bumpRetry` after their own mutations settle
+ * (`openspec/changes/archive/2026-07-21-split-use-dial-file-manager/design.md` D1) — this hook is the sole owner/writer of that cache.
+ *
+ * Supports three listing sources via `activeTab`:
+ * - my_files: user's own bucket via `DialFilesApi.listFiles`
+ * - shared: files shared with the user via `DialFilesApi.listSharedFiles`
+ * - organization: public bucket via `DialFilesApi.listPublicFiles`
+ */
+export declare const useDialFileListing: ({ filesApi, bucket, rootLabel, activeTab, onNotification, isActive, sessionKey, }: UseDialFileListingOptions) => UseDialFileListingResult;
+//# sourceMappingURL=useDialFileListing.d.ts.map

package/files/useDialFileListing/useDialFileListing.d.ts.map

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