@epam/ai-dial-chat-hooks 1.3.0-dev.13 → 1.3.0-dev.133

package/skill/useSkillFilePreview.d.ts

@@ -0,0 +1,38 @@
+import { SkillFileContent } from './skill-file-preview';
+/** Discriminant for the kind of error a `useSkillFilePreview` load can produce. */
+export declare enum SkillPreviewErrorKind {
+    /** HTTP 403 — the caller lacks permission to read this file. */
+    Forbidden = "forbidden",
+    /** Any non-403 load failure. */
+    Generic = "generic"
+}
+/** Options accepted by `useSkillFilePreview`. */
+export interface UseSkillFilePreviewOptions {
+    /**
+     * Opaque id of the selected skill file. Changing this resets all state
+     * and starts a new load; stale resolutions from the previous id are discarded.
+     */
+    fileId: string;
+    /**
+     * App-owned loader; resolves with the raw file bytes when the request
+     * succeeds. The hook never constructs a URL or imports a REST client.
+     */
+    onLoadFile: (fileId: string) => Promise<SkillFileContent>;
+}
+/** State returned by `useSkillFilePreview`. */
+export interface UseSkillFilePreviewResult {
+    /** `true` while the async load is in flight. */
+    isLoading: boolean;
+    /** Resolved file content, or `null` while loading or after an error. */
+    content: SkillFileContent | null;
+    /** Classified load error, or `null` while loading or after a success. */
+    error: SkillPreviewErrorKind | null;
+}
+/**
+ * Headless hook that manages the skill-file preview loading lifecycle.
+ * Starts a new load on mount and whenever `fileId` changes; classifies errors
+ * as `Forbidden` (HTTP 403) or `Generic`; discards settlements from superseded
+ * or unmounted loads.
+ */
+export declare const useSkillFilePreview: ({ fileId, onLoadFile, }: UseSkillFilePreviewOptions) => UseSkillFilePreviewResult;
+//# sourceMappingURL=useSkillFilePreview.d.ts.map

package/skill/useSkillFilePreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillFilePreview.d.ts","sourceRoot":"","sources":["../../src/skill/useSkillFilePreview.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,mFAAmF;AACnF,oBAAY,qBAAqB;IAC/B,gEAAgE;IAChE,SAAS,cAAc;IACvB,gCAAgC;IAChC,OAAO,YAAY;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC3D;AAED,+CAA+C;AAC/C,MAAM,WAAW,yBAAyB;IACxC,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,yEAAyE;IACzE,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACrC;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,yBAGjC,0BAA0B,KAAG,yBAoC/B,CAAC"}

package/skill/useSkillsState/useSkillsState.d.ts

@@ -0,0 +1,35 @@
+import { SkillCatalogListResponseDto, SkillMetadataItemDto } from '@epam/ai-dial-chat-api-client';
+/** Parameters for {@link useSkillsState}. */
+export interface UseSkillsStateParams {
+    /** Fetches the aggregate skill listing from the server. */
+    listSkills: () => Promise<SkillCatalogListResponseDto>;
+    /** Whether the Skills feature is enabled in the current overlay/tenant config. */
+    enabled: boolean;
+    /** Whether the user session is ready for API calls (auth has settled). */
+    ready: boolean;
+}
+/** Result returned by {@link useSkillsState}. */
+export interface UseSkillsStateResult {
+    /** Skills in the caller's own bucket. */
+    skills: SkillMetadataItemDto[];
+    /** Skills in the organisation bucket. */
+    publicSkills: SkillMetadataItemDto[];
+    /** Skills other users shared with the caller. */
+    sharedWithMe: SkillMetadataItemDto[];
+    /** True until the aggregate listing has settled. */
+    isLoading: boolean;
+    /** Rejection reason of the most recent failed listing, or `null`. */
+    error: unknown;
+    /** Re-reads personal, shared, and organisation skills. */
+    refetch: () => Promise<void>;
+    /** Upserts a single skill into the shared-with-me list by URL identity. */
+    mergeSharedSkill: (item: SkillMetadataItemDto) => void;
+}
+/**
+ * Fetches all skill namespaces with a gated single request: clears state
+ * immediately when `enabled` is false, defers the fetch until `ready` is true,
+ * and exposes `refetch` / `mergeSharedSkill` for manual updates.
+ * Does not import any feature-flag hook, auth enum, or app context.
+ */
+export declare const useSkillsState: ({ listSkills, enabled, ready, }: UseSkillsStateParams) => UseSkillsStateResult;
+//# sourceMappingURL=useSkillsState.d.ts.map

package/skill/useSkillsState/useSkillsState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillsState.d.ts","sourceRoot":"","sources":["../../../src/skill/useSkillsState/useSkillsState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AAGvC,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,UAAU,EAAE,MAAM,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACvD,kFAAkF;IAClF,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,yCAAyC;IACzC,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,iDAAiD;IACjD,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,2EAA2E;IAC3E,gBAAgB,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACxD;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,iCAI5B,oBAAoB,KAAG,oBAqFzB,CAAC"}