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

package/catalog/useSkillDetailsPanelData/useSkillDetailsPanelData.d.ts

@@ -0,0 +1,54 @@
+import { CatalogItem } from '@epam/ai-dial-catalog';
+import { SkillMetadataItemDto } from '@epam/ai-dial-chat-api-client';
+import { SkillFileContent } from '../../skill/skill-file-preview';
+import { DeploymentFolderLabels } from '../map-deployment-to-catalog-item';
+import { SkillOverviewLabels } from '../map-skill-to-catalog-item';
+import { SkillDetailsApi } from '../useSkillItemDetails';
+/** Options accepted by `useSkillDetailsPanelData`. */
+export interface UseSkillDetailsPanelDataOptions {
+    /** Configured API adapter used for all network calls. */
+    api: SkillDetailsApi;
+    /** The user's own skills. */
+    skills: SkillMetadataItemDto[];
+    /** Skills shared with the user. */
+    sharedWithMe?: SkillMetadataItemDto[];
+    /** Public skills. */
+    publicSkills?: SkillMetadataItemDto[];
+    /**
+     * Resource URL (`skills/{bucket}/{path}`) of the skill whose details are
+     * shown; `null` when the panel is closed, which resolves no item.
+     */
+    skillId: string | null;
+    /** Personal/Shared/Public folder labels for the mapped item's folder path. */
+    folderLabels: DeploymentFolderLabels;
+    /** Labels for the skill overview section headers. */
+    skillOverviewLabels: SkillOverviewLabels;
+    /** Favorited resource ids, keyed by skill resource URL. */
+    favoriteIds: ReadonlySet<string>;
+}
+/** Returned by `useSkillDetailsPanelData`. */
+export interface UseSkillDetailsPanelDataResult {
+    /**
+     * The selected skill as a catalog item with its fetched details merged in;
+     * `null` while no skill is selected or the skill is not in the listings.
+     */
+    detailsPanelItem: CatalogItem | null;
+    /** Whether the details fetch for the current item is in flight. */
+    isDetailsLoading: boolean;
+    /** Whether the resolved skill is currently favorited. */
+    isStarred: boolean;
+    /**
+     * Downloads and returns preview bytes for a file inside the open skill's
+     * package. Throws on HTTP errors, unparseable ids, and size-limit
+     * violations.
+     */
+    onLoadSkillDetailsFile(fileId: string): Promise<SkillFileContent>;
+}
+/**
+ * Headless data pipeline behind a skill details side panel: resolves the
+ * selected skill from the listings, maps it to a catalog item with its
+ * ownership flags and folder prefix, fetches its details with cancellation,
+ * and merges the fetch result into the item.
+ */
+export declare const useSkillDetailsPanelData: ({ api, skills, sharedWithMe, publicSkills, skillId, folderLabels, skillOverviewLabels, favoriteIds, }: UseSkillDetailsPanelDataOptions) => UseSkillDetailsPanelDataResult;
+//# sourceMappingURL=useSkillDetailsPanelData.d.ts.map

package/catalog/useSkillDetailsPanelData/useSkillDetailsPanelData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillDetailsPanelData.d.ts","sourceRoot":"","sources":["../../../src/catalog/useSkillDetailsPanelData/useSkillDetailsPanelData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,sDAAsD;AACtD,MAAM,WAAW,+BAA+B;IAC9C,yDAAyD;IACzD,GAAG,EAAE,eAAe,CAAC;IACrB,6BAA6B;IAC7B,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,mCAAmC;IACnC,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,qBAAqB;IACrB,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,8EAA8E;IAC9E,YAAY,EAAE,sBAAsB,CAAC;IACrC,qDAAqD;IACrD,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,2DAA2D;IAC3D,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,8CAA8C;AAC9C,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,gBAAgB,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,mEAAmE;IACnE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACnE;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,uGAStC,+BAA+B,KAAG,8BAqGpC,CAAC"}

package/catalog/useSkillItemDetails.d.ts

@@ -0,0 +1,64 @@
+import { CatalogItem, CatalogItemDetailsFetchResult } from '@epam/ai-dial-catalog';
+import { SkillFileListResponseDto, SkillMetadataItemDto } from '@epam/ai-dial-chat-api-client';
+import { SkillFileContent } from '../skill/skill-file-preview';
+import { SkillOverviewLabels } from './map-skill-to-catalog-item';
+/** Injected API port for skill detail fetching. Mirrors exact server-api wrapper signatures. */
+export interface SkillDetailsApi {
+    /** Downloads a raw skill file, returning the raw fetch `Response`. */
+    downloadSkillFile(bucket: string, path: string, filePath: string, signal?: AbortSignal): Promise<Response>;
+    /** Lists files inside a skill package. */
+    listSkillFiles(params: {
+        bucket: string;
+        filePath: string;
+        path?: string;
+        token?: string;
+        limit?: number;
+        recursive?: boolean;
+    }, signal?: AbortSignal): Promise<SkillFileListResponseDto>;
+    /**
+     * Fetches a single skill's own authoritative metadata (`author`,
+     * `updatedAt`, and the rest of `SkillMetadataItemDto`) — not the catalog
+     * listing entry, which may be sparse for a shared skill.
+     */
+    getSkillMetadata(bucket: string, path: string, signal?: AbortSignal): Promise<SkillMetadataItemDto>;
+}
+/** Options accepted by `useSkillItemDetails`. */
+export interface UseSkillItemDetailsOptions {
+    /** Configured API adapter used for all network calls. */
+    api: SkillDetailsApi;
+    /**
+     * Combined array of all skills visible to this user
+     * (personal + shared + public) for overview metadata lookup.
+     */
+    skills: SkillMetadataItemDto[];
+    /** Labels for skill overview section headers. */
+    skillOverviewLabels: SkillOverviewLabels;
+}
+/** Returned callbacks from `useSkillItemDetails`. All callbacks are stable for stable inputs. */
+export interface UseSkillItemDetailsResult {
+    /**
+     * Fetches full detail data for a skill catalog item.
+     * Returns `undefined` on failure (error handled by caller).
+     */
+    onFetchSkillDetails(item: CatalogItem): Promise<CatalogItemDetailsFetchResult | undefined>;
+    /**
+     * Loads the text content of a file inside the currently open skill's package.
+     * Returns `undefined` when the file cannot be read or is a directory.
+     */
+    onLoadContentFile(fileId: string): Promise<string | undefined>;
+    /**
+     * Downloads and returns preview bytes for a file inside the currently open skill's package.
+     * Throws on HTTP errors, unparseable ids, and size-limit violations.
+     */
+    onLoadSkillDetailsFile(fileId: string): Promise<SkillFileContent>;
+}
+/**
+ * Headless hook that encapsulates skill detail fetching: manifest download and
+ * parse, package file listing, authoritative metadata fetching, overview
+ * construction, and in-package file loads. `useCatalogItemDetails` delegates
+ * its skill branch here; hosts that only surface skill details consume this
+ * hook directly, without the deployment and prompt ports the full catalog
+ * pipeline requires.
+ */
+export declare const useSkillItemDetails: ({ api, skills, skillOverviewLabels, }: UseSkillItemDetailsOptions) => UseSkillItemDetailsResult;
+//# sourceMappingURL=useSkillItemDetails.d.ts.map

package/catalog/useSkillItemDetails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillItemDetails.d.ts","sourceRoot":"","sources":["../../src/catalog/useSkillItemDetails.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,6BAA6B,EAC9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAYpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,gGAAgG;AAChG,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrB,0CAA0C;IAC1C,cAAc,CACZ,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrC;;;;OAIG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC;AAED,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC,yDAAyD;IACzD,GAAG,EAAE,eAAe,CAAC;IACrB;;;OAGG;IACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,iDAAiD;IACjD,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C;AAED,iGAAiG;AACjG,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,mBAAmB,CACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,6BAA6B,GAAG,SAAS,CAAC,CAAC;IACtD;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/D;;;OAGG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACnE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,uCAIjC,0BAA0B,KAAG,yBA4I/B,CAAC"}

package/catalog/useSkillItemDetails.js

@@ -22,7 +22,7 @@ var d = ({ api: d, skills: f, skillOverviewLabels: p }) => {
 				}),
 				d.getSkillMetadata(l, u)
 			]), v = h.status === "fulfilled" && h.value != null ? c(h.value) : void 0, y = _.status === "fulfilled" ? _.value : f.find((e) => e.url === i.id), b = g.status === "fulfilled" ? r(y, g.value.items, v?.about, p) : void 0, x = g.status === "fulfilled" ? n(g.value.items, u) : [], S = g.status === "fulfilled" ? s(g.value.items, u) : e;
-			if (!(v == null && b == null)) return {
+			if (v != null || b != null) return {
 				...v == null ? {} : { promptContent: {
 					content: v.body,
 					...v.description == null ? {} : { description: v.description },
@@ -41,8 +41,8 @@ var d = ({ api: d, skills: f, skillOverviewLabels: p }) => {
 			if (t == null) return;
 			let n = o(e, t.path);
 			if (n == null) return;
-			let r = await a(await d.downloadSkillFile(t.bucket, t.path, n));
-			if (r != null) return n === "SKILL.md" ? c(r).body : r;
+			let r = await d.downloadSkillFile(t.bucket, t.path, n), i = await a(r);
+			if (i != null) return n === "SKILL.md" ? c(i).body : i;
 		}, [d]),
 		onLoadSkillDetailsFile: l(async (e) => {
 			let t = m.current;