@epam/ai-dial-chat-hooks 1.3.0-dev.33 → 1.3.0-dev.331

package/sharing.d.ts

@@ -1,65 +1,2 @@
-import { ShareApi } from '@epam/ai-dial-chat-api-client';
-import { ShareLinkAccess } from '@epam/ai-dial-share';
-import { ShareLinkData } from '@epam/ai-dial-share';
-
-/** State of one resource's recipient-count lookup. */
-export declare interface RecipientsCountEntry {
-    /** Where the lookup for this resource currently stands. */
-    status: RecipientsCountStatus;
-    /** Number of users holding access; present only once the status is `Resolved`. */
-    count?: number;
-}
-
-/** Lifecycle of an on-demand recipient-count lookup for one resource. */
-export declare enum RecipientsCountStatus {
-    /** Nothing requested yet for this resource. */
-    Idle = "idle",
-    /** A lookup is in flight. */
-    Loading = "loading",
-    /** A count came back and is known exactly. */
-    Resolved = "resolved",
-    /** The lookup failed, so the count is unknown. */
-    Unknown = "unknown"
-}
-
-/**
- * Resolves and manages share-link data for a DIAL Core resource.
- *
- * Accepts an already-configured `ShareApi` instance — this hook owns only
- * the request lifecycle (loading/error, a stale-response guard, and
- * re-fetch on access change), not the client's base URL, auth, or CSRF
- * setup, which stay the caller's responsibility.
- */
-export declare const useShareLink: (shareApi: Pick<ShareApi, "createShareLink">, itemId: string, origin?: string) => UseShareLinkResult;
-
-/** Result returned by {@link useShareLink}. */
-export declare interface UseShareLinkResult {
-    /** Resolved share-link data, or `undefined` while loading or on error. */
-    data: ShareLinkData | undefined;
-    /** Whether the share link is still being created. */
-    isLoading: boolean;
-    /** Set when the share link could not be created. */
-    error: Error | null;
-    /** Requests a new share link for the given access levels. */
-    setAccess: (access: ShareLinkAccess[]) => void;
-}
-
-/**
- * Resolves how many users hold shared access to a resource, one resource at
- * a time and only when asked. Accepts an already-configured `ShareApi`
- * instance — this hook owns only the dedup/cache state machine, not the
- * client's base URL, auth, or CSRF setup.
- */
-export declare const useShareRecipientsCount: (shareApi: Pick<ShareApi, "getShareRecipientsCount">) => UseShareRecipientsCountResult;
-
-/** Per-resource recipient-count lookups resolved on demand. */
-export declare interface UseShareRecipientsCountResult {
-    /** Starts a lookup for the resource unless one already ran for it. */
-    requestRecipientsCount: (itemId: string) => void;
-    /** Current lookup state for the resource. */
-    getRecipientsCount: (itemId: string) => RecipientsCountEntry;
-    /** Drops the resource's cached result so the next request fetches it again. */
-    invalidateRecipientsCount: (itemId: string) => void;
-}
-
-export { }
+export * from './entry-points/sharing.js'
+export {}

package/sharing.js

@@ -1,3 +1,6 @@
 import { RecipientsCountStatus as e, useShareRecipientsCount as t } from "./useShareRecipientsCount/useShareRecipientsCount.js";
-import { useShareLink as n } from "./useShareLink/useShareLink.js";
-export { e as RecipientsCountStatus, n as useShareLink, t as useShareRecipientsCount };
+import { AcceptShareInvitationErrorKind as n } from "./share-invitation/types.js";
+import { DEFAULT_ACCEPT_SHARE_INVITATION_ERROR_LABELS as r, resolveAcceptShareInvitationError as i } from "./share-invitation/share-invitation-error.js";
+import { useAcceptShareInvitation as a } from "./share-invitation/useAcceptShareInvitation/useAcceptShareInvitation.js";
+import { useShareLink as o } from "./useShareLink/useShareLink.js";
+export { n as AcceptShareInvitationErrorKind, r as DEFAULT_ACCEPT_SHARE_INVITATION_ERROR_LABELS, e as RecipientsCountStatus, i as resolveAcceptShareInvitationError, a as useAcceptShareInvitation, o as useShareLink, t as useShareRecipientsCount };

package/signin-interrupt/models.d.ts

@@ -0,0 +1,48 @@
+import { ExternalServiceAuthType, ExternalServiceCredentialsLevel, ExternalServiceOAuthSettings } from '../external-services/useExternalServiceLogin';
+import { ToolsetCredentialsLevel } from '../oauth/types';
+import { PendingSigninEvent } from '../shared/client-channel';
+import { SigninInterruptAnnouncementKind, SigninInterruptRowError, SigninInterruptRowStatus } from './types';
+/** Display and login metadata resolved for the resource behind a pending sign-in event. */
+export interface SigninRowInfo {
+    /** Resource display name, or a fallback derived from its id while metadata is missing. */
+    displayName: string;
+    /** Resource version shown next to the name, when known. */
+    displayVersion?: string;
+    /** Authentication mechanism, or `undefined` while metadata is missing. */
+    authenticationType?: ExternalServiceAuthType;
+    /** Credentials level the login targets. */
+    credentialsLevel: ToolsetCredentialsLevel | ExternalServiceCredentialsLevel;
+    /** OAuth client settings for the authorize URL, when the resource uses OAuth. */
+    oauthSettings?: ExternalServiceOAuthSettings;
+}
+/** One pending sign-in event with its resolved metadata and local row state. */
+export interface SigninInterruptRow {
+    /** The pending client-channel event this row resolves. */
+    event: PendingSigninEvent;
+    /** Resolved display and login metadata. */
+    info: SigninRowInfo;
+    /** Whether a login or decline is in flight. */
+    status: SigninInterruptRowStatus;
+    /** Shorthand for `status === SigninInterruptRowStatus.Processing`. */
+    isProcessing: boolean;
+    /** Recoverable failure of the last attempt, if any. */
+    error?: SigninInterruptRowError;
+    /** API key typed into the row; `''` until the user types. */
+    apiKey: string;
+    /** Whether the resource takes an API key, so the row shows a key field. */
+    requiresApiKey: boolean;
+    /** Whether the resource needs no credentials, so the row offers no actions. */
+    requiresNoCredentials: boolean;
+    /** Whether the resource uses DIAL-native offline credentials. */
+    isDialNative: boolean;
+    /** Whether `Log in` can be submitted: always, except an API-key row with a blank key. */
+    canSubmitLogin: boolean;
+}
+/** Status a sign-in interrupt announces after resolving an event. */
+export interface SigninInterruptAnnouncement {
+    /** Which resolution happened. */
+    kind: SigninInterruptAnnouncementKind;
+    /** Display name of the resolved resource; `''` when it is no longer known. */
+    name: string;
+}
+//# sourceMappingURL=models.d.ts.map

package/signin-interrupt/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/signin-interrupt/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,+BAA+B,EAC/B,4BAA4B,EAC7B,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EACV,+BAA+B,EAC/B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAEjB,2FAA2F;AAC3F,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,uBAAuB,CAAC;IAC7C,2CAA2C;IAC3C,gBAAgB,EAAE,uBAAuB,GAAG,+BAA+B,CAAC;IAC5E,iFAAiF;IACjF,aAAa,CAAC,EAAE,4BAA4B,CAAC;CAC9C;AAED,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,KAAK,EAAE,kBAAkB,CAAC;IAC1B,2CAA2C;IAC3C,IAAI,EAAE,aAAa,CAAC;IACpB,+CAA+C;IAC/C,MAAM,EAAE,wBAAwB,CAAC;IACjC,sEAAsE;IACtE,YAAY,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,KAAK,CAAC,EAAE,uBAAuB,CAAC;IAChC,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,cAAc,EAAE,OAAO,CAAC;IACxB,+EAA+E;IAC/E,qBAAqB,EAAE,OAAO,CAAC;IAC/B,iEAAiE;IACjE,YAAY,EAAE,OAAO,CAAC;IACtB,yFAAyF;IACzF,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,qEAAqE;AACrE,MAAM,WAAW,2BAA2B;IAC1C,iCAAiC;IACjC,IAAI,EAAE,+BAA+B,CAAC;IACtC,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;CACd"}

package/signin-interrupt/signin-row-info.d.ts

@@ -0,0 +1,10 @@
+import { DialToolsetDto, GetExternalServiceResponseDto } from '@epam/ai-dial-chat-api-client';
+import { PendingSigninEvent } from '../shared/client-channel';
+import { SigninRowInfo } from './models';
+/** Returns the key of a pending event's underlying resource: the toolset id, or the external-service scope id. */
+export declare const getSigninEventResourceKey: (event: PendingSigninEvent) => string;
+/** Returns the row metadata for a toolset, falling back to a name derived from its id while `toolset` is unknown. */
+export declare const resolveToolsetSigninRowInfo: (toolsetId: string, toolset: DialToolsetDto | undefined, activeLocale: string, primaryLocale: string) => SigninRowInfo;
+/** Returns the row metadata for an application's external service, falling back to its decoded name while `service` is unknown. */
+export declare const resolveExternalServiceSigninRowInfo: (serviceName: string, service: GetExternalServiceResponseDto | undefined) => SigninRowInfo;
+//# sourceMappingURL=signin-row-info.d.ts.map

package/signin-interrupt/signin-row-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signin-row-info.d.ts","sourceRoot":"","sources":["../../src/signin-interrupt/signin-row-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,6BAA6B,EAC9B,MAAM,+BAA+B,CAAC;AAWvC,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,kHAAkH;AAClH,eAAO,MAAM,yBAAyB,GAAI,OAAO,kBAAkB,KAAG,MAGL,CAAC;AAElE,qHAAqH;AACrH,eAAO,MAAM,2BAA2B,GACtC,WAAW,MAAM,EACjB,SAAS,cAAc,GAAG,SAAS,EACnC,cAAc,MAAM,EACpB,eAAe,MAAM,KACpB,aASD,CAAC;AAEH,mIAAmI;AACnI,eAAO,MAAM,mCAAmC,GAC9C,aAAa,MAAM,EACnB,SAAS,6BAA6B,GAAG,SAAS,KACjD,aAiBD,CAAC"}

package/signin-interrupt/signin-row-info.js

@@ -0,0 +1,21 @@
+import { getToolsetFallbackName as e, resolveToolsetCredentialsLevel as t } from "../oauth/toolset-id.js";
+import { resolveLocalizedText as n } from "../shared/locale.js";
+import { toToolsetOAuthSettings as r } from "../oauth/authorize-url.js";
+import { buildExternalServiceScopeId as i, getExternalServiceFallbackName as a } from "../shared/external-services.js";
+import { ExternalServiceAuthStatus as o, ExternalServiceCredentialsLevel as s } from "../external-services/useExternalServiceLogin.js";
+import { PendingSigninEventKind as c } from "../shared/client-channel.js";
+//#region src/signin-interrupt/signin-row-info.ts
+var l = (e) => e.kind === c.Toolset ? e.toolsetId : i(e.appId, e.serviceName), u = (i, a, o, s) => ({
+	displayName: n(a?.displayName, o, s) || e(i),
+	displayVersion: a?.displayVersion,
+	authenticationType: a?.authSettings?.authenticationType,
+	credentialsLevel: t(i),
+	oauthSettings: r(a?.authSettings)
+}), d = (e, t) => ({
+	displayName: t?.displayName || a(e),
+	authenticationType: t?.authenticationType,
+	credentialsLevel: t?.globalAuthStatus != null && t.globalAuthStatus !== o.SignedIn && t.userLevelAuthStatus == null ? s.Global : s.User,
+	oauthSettings: r(t)
+});
+//#endregion
+export { l as getSigninEventResourceKey, d as resolveExternalServiceSigninRowInfo, u as resolveToolsetSigninRowInfo };

package/signin-interrupt/types.d.ts

@@ -0,0 +1,28 @@
+/** Progress of one sign-in interrupt row. */
+export declare enum SigninInterruptRowStatus {
+    /** Awaiting the user's login or decline. */
+    Idle = "idle",
+    /** A login or decline for this row is in flight. */
+    Processing = "processing"
+}
+/** Recoverable failure shown on a sign-in interrupt row; the event stays pending. */
+export declare enum SigninInterruptRowError {
+    /** The login failed, or reporting its success to DIAL Core failed. */
+    LoginFailed = "login-failed",
+    /** The browser blocked the OAuth popup. */
+    PopupBlocked = "popup-blocked",
+    /** Reporting the decline to DIAL Core failed. */
+    DeclineFailed = "decline-failed",
+    /** A DIAL administrator must approve the application's access first. */
+    AdminConsentRequired = "admin-consent-required",
+    /** Offline access is not configured for the user's account. */
+    OfflineUnavailable = "offline-unavailable"
+}
+/** Kind of status a sign-in interrupt announces after resolving an event. */
+export declare enum SigninInterruptAnnouncementKind {
+    /** A login succeeded and its event was reported as `success`. */
+    LoginSucceeded = "login-succeeded",
+    /** An event was declined and reported as `denied`. */
+    Declined = "declined"
+}
+//# sourceMappingURL=types.d.ts.map

package/signin-interrupt/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/signin-interrupt/types.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,oBAAY,wBAAwB;IAClC,4CAA4C;IAC5C,IAAI,SAAS;IACb,oDAAoD;IACpD,UAAU,eAAe;CAC1B;AAED,qFAAqF;AACrF,oBAAY,uBAAuB;IACjC,sEAAsE;IACtE,WAAW,iBAAiB;IAC5B,2CAA2C;IAC3C,YAAY,kBAAkB;IAC9B,iDAAiD;IACjD,aAAa,mBAAmB;IAChC,wEAAwE;IACxE,oBAAoB,2BAA2B;IAC/C,+DAA+D;IAC/D,kBAAkB,wBAAwB;CAC3C;AAED,6EAA6E;AAC7E,oBAAY,+BAA+B;IACzC,iEAAiE;IACjE,cAAc,oBAAoB;IAClC,sDAAsD;IACtD,QAAQ,aAAa;CACtB"}

package/signin-interrupt/types.js

@@ -0,0 +1,10 @@
+//#region src/signin-interrupt/types.ts
+var e = /* @__PURE__ */ function(e) {
+	return e.Idle = "idle", e.Processing = "processing", e;
+}({}), t = /* @__PURE__ */ function(e) {
+	return e.LoginFailed = "login-failed", e.PopupBlocked = "popup-blocked", e.DeclineFailed = "decline-failed", e.AdminConsentRequired = "admin-consent-required", e.OfflineUnavailable = "offline-unavailable", e;
+}({}), n = /* @__PURE__ */ function(e) {
+	return e.LoginSucceeded = "login-succeeded", e.Declined = "declined", e;
+}({});
+//#endregion
+export { n as SigninInterruptAnnouncementKind, t as SigninInterruptRowError, e as SigninInterruptRowStatus };

package/signin-interrupt/useSigninInterrupt/useSigninInterrupt.d.ts

@@ -0,0 +1,52 @@
+import { DialToolsetDto, GetExternalServiceResponseDto, ReportClientChannelDtoResultEnum } from '@epam/ai-dial-chat-api-client';
+import { ExternalServiceLoginOutcome, ExternalServiceLoginParams } from '../../external-services/useExternalServiceLogin';
+import { ToolsetLoginOutcome, ToolsetLoginParams } from '../../oauth/useToolsetLogin/useToolsetLogin';
+import { PendingSigninEvent } from '../../shared/client-channel';
+import { SigninInterruptAnnouncement, SigninInterruptRow } from '../models';
+/** Host data and operations `useSigninInterrupt` resolves pending sign-in events with. */
+export interface UseSigninInterruptOptions {
+    /** Pending client-channel sign-in events, in display order. */
+    pendingEvents: PendingSigninEvent[];
+    /** Toolsets the host already has loaded; a listed toolset is not fetched again. */
+    toolsets: DialToolsetDto[];
+    /** Locale toolset display names are resolved for. */
+    activeLocale: string;
+    /** Locale used when a display name has no entry for `activeLocale`. */
+    primaryLocale: string;
+    /** Fetches a toolset that `toolsets` does not list; a rejection keeps the fallback name. */
+    getToolset: (toolsetId: string) => Promise<DialToolsetDto>;
+    /** Fetches an application's external service; a rejection keeps the fallback name. */
+    getExternalService: (appId: string, serviceName: string) => Promise<GetExternalServiceResponseDto>;
+    /** Logs in to a toolset, e.g. `useToolsetLogin().login`. */
+    loginToolset: (params: ToolsetLoginParams) => Promise<ToolsetLoginOutcome>;
+    /** Logs in to an external service, e.g. `useExternalServiceLogin().login`. */
+    loginExternalService: (params: ExternalServiceLoginParams) => Promise<ExternalServiceLoginOutcome>;
+    /** Refreshes the host's toolset list after a successful toolset login, before success is reported. */
+    refetchToolsets: () => Promise<unknown>;
+    /** Reports an event's resolution on the client channel; a rejection leaves the event pending. */
+    reportEvent: (eventId: string, result: ReportClientChannelDtoResultEnum) => Promise<unknown>;
+}
+/** Rows, announcement and actions of a sign-in interrupt dialog. */
+export interface UseSigninInterruptResult {
+    /** One row per pending event, in `pendingEvents` order. */
+    rows: SigninInterruptRow[];
+    /** Latest resolution to announce, or `undefined` before the first one. */
+    announcement?: SigninInterruptAnnouncement;
+    /** Whether logins grant offline-use consent. Defaults to `true`. */
+    offlineUsageConsent: boolean;
+    /** Sets `offlineUsageConsent`. */
+    setOfflineUsageConsent: (value: boolean) => void;
+    /** Whether any row uses an API key or OAuth, so the offline-use consent control applies. */
+    isOfflineUsageConsentShown: boolean;
+    /** Stores a row's typed API key and clears its error. */
+    changeApiKey: (eventId: string, value: string) => void;
+    /** Starts a login for a row; synchronous up to the login call so an OAuth popup stays inside the click. */
+    login: (eventId: string) => void;
+    /** Reports a row as `denied`. */
+    decline: (eventId: string) => Promise<void>;
+    /** Declines every pending event. */
+    declineAll: () => void;
+}
+/** Resolves pending sign-in events into dialog rows and runs their login, decline and result reporting. */
+export declare const useSigninInterrupt: ({ pendingEvents, toolsets, activeLocale, primaryLocale, getToolset, getExternalService, loginToolset, loginExternalService, refetchToolsets, reportEvent, }: UseSigninInterruptOptions) => UseSigninInterruptResult;
+//# sourceMappingURL=useSigninInterrupt.d.ts.map

package/signin-interrupt/useSigninInterrupt/useSigninInterrupt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSigninInterrupt.d.ts","sourceRoot":"","sources":["../../../src/signin-interrupt/useSigninInterrupt/useSigninInterrupt.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,6BAA6B,EAClC,gCAAgC,EACjC,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAGL,KAAK,2BAA2B,EAEhC,KAAK,0BAA0B,EAChC,MAAM,iDAAiD,CAAC;AAKzD,OAAO,EACL,KAAK,mBAAmB,EAExB,KAAK,kBAAkB,EACxB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAEL,KAAK,kBAAkB,EAGxB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EACV,2BAA2B,EAC3B,kBAAkB,EAEnB,MAAM,WAAW,CAAC;AAYnB,0FAA0F;AAC1F,MAAM,WAAW,yBAAyB;IACxC,+DAA+D;IAC/D,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,mFAAmF;IACnF,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IACtB,4FAA4F;IAC5F,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3D,sFAAsF;IACtF,kBAAkB,EAAE,CAClB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,KAChB,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC5C,4DAA4D;IAC5D,YAAY,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC3E,8EAA8E;IAC9E,oBAAoB,EAAE,CACpB,MAAM,EAAE,0BAA0B,KAC/B,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC1C,sGAAsG;IACtG,eAAe,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,iGAAiG;IACjG,WAAW,EAAE,CACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gCAAgC,KACrC,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED,oEAAoE;AACpE,MAAM,WAAW,wBAAwB;IACvC,2DAA2D;IAC3D,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,2BAA2B,CAAC;IAC3C,oEAAoE;IACpE,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kCAAkC;IAClC,sBAAsB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,4FAA4F;IAC5F,0BAA0B,EAAE,OAAO,CAAC;IACpC,yDAAyD;IACzD,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,2GAA2G;IAC3G,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,iCAAiC;IACjC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,oCAAoC;IACpC,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AA0BD,2GAA2G;AAC3G,eAAO,MAAM,kBAAkB,GAAI,6JAWhC,yBAAyB,KAAG,wBA4a9B,CAAC"}

package/signin-interrupt/useSigninInterrupt/useSigninInterrupt.js

@@ -0,0 +1,270 @@
+import { ToolsetAuthTypes as e } from "../../oauth/types.js";
+import { ToolsetLoginOutcomeType as t } from "../../oauth/useToolsetLogin/useToolsetLogin.js";
+import { buildExternalServiceScopeId as n } from "../../shared/external-services.js";
+import { ExternalServiceAuthType as r, ExternalServiceLoginOutcomeType as i } from "../../external-services/useExternalServiceLogin.js";
+import { PendingSigninEventKind as a } from "../../shared/client-channel.js";
+import { getSigninEventResourceKey as o, resolveExternalServiceSigninRowInfo as s, resolveToolsetSigninRowInfo as c } from "../signin-row-info.js";
+import { SigninInterruptAnnouncementKind as l, SigninInterruptRowError as u, SigninInterruptRowStatus as d } from "../types.js";
+import { ReportClientChannelDtoResultEnum as f } from "@epam/ai-dial-chat-api-client";
+import { useCallback as p, useEffect as m, useMemo as h, useRef as g, useState as _ } from "react";
+//#region src/signin-interrupt/useSigninInterrupt/useSigninInterrupt.ts
+var v = {
+	status: d.Idle,
+	apiKey: ""
+}, y = (e, t) => e.kind === a.Toolset ? c(e.toolsetId, void 0, t, t) : s(e.serviceName, void 0), b = ({ pendingEvents: b, toolsets: x, activeLocale: S, primaryLocale: C, getToolset: w, getExternalService: T, loginToolset: E, loginExternalService: D, refetchToolsets: O, reportEvent: k }) => {
+	let [A, j] = _({}), [M, N] = _({}), [P, F] = _({}), [I, L] = _(), [R, z] = _(!0), B = g(/* @__PURE__ */ new Set()), V = g(/* @__PURE__ */ new Set()), H = g(/* @__PURE__ */ new Set()), U = p((e) => A[e] ?? v, [A]);
+	m(() => {
+		let e = new Set(b.map((e) => e.id));
+		j((t) => {
+			let n = !1, r = {};
+			for (let [i, a] of Object.entries(t)) e.has(i) ? r[i] = a : n = !0;
+			return n ? r : t;
+		});
+		for (let t of Array.from(H.current)) e.has(t) || H.current.delete(t);
+	}, [b]);
+	let W = p((e, t) => {
+		j((n) => ({
+			...n,
+			[e]: {
+				...n[e] ?? v,
+				...t
+			}
+		}));
+	}, []);
+	m(() => {
+		let e = async (e) => {
+			try {
+				let t = await w(e);
+				N((n) => ({
+					...n,
+					[e]: t
+				}));
+			} catch {} finally {
+				B.current.delete(e);
+			}
+		}, t = async (e, t, n) => {
+			try {
+				let r = await T(e, t);
+				F((e) => ({
+					...e,
+					[n]: r
+				}));
+			} catch {} finally {
+				V.current.delete(n);
+			}
+		};
+		for (let r of b) if (r.kind === a.Toolset) {
+			if ((x.find((e) => e.id === r.toolsetId) ?? M[r.toolsetId]) || B.current.has(r.toolsetId)) continue;
+			B.current.add(r.toolsetId), e(r.toolsetId);
+		} else {
+			let { appId: e, serviceName: i } = r, a = n(e, i);
+			if (P[a] || V.current.has(a)) continue;
+			V.current.add(a), t(e, i, a);
+		}
+	}, [
+		b,
+		x,
+		M,
+		P,
+		w,
+		T
+	]);
+	let G = h(() => {
+		let e = /* @__PURE__ */ new Map();
+		for (let t of b) {
+			let n = o(t);
+			if (!e.has(n)) {
+				if (t.kind === a.Toolset) {
+					let r = x.find((e) => e.id === t.toolsetId) ?? M[t.toolsetId];
+					e.set(n, c(t.toolsetId, r, S, C));
+				} else e.set(n, s(t.serviceName, P[n]));
+			}
+		}
+		return e;
+	}, [
+		b,
+		x,
+		M,
+		P,
+		S,
+		C
+	]), K = p((e) => G.get(o(e)) ?? y(e, C), [G, C]), q = p(async (e, t) => {
+		await k(e, f.Success), L({
+			kind: l.LoginSucceeded,
+			name: t
+		});
+	}, [k]);
+	m(() => {
+		for (let e of b) {
+			if (e.kind !== a.ExternalService) continue;
+			let t = G.get(o(e));
+			t?.authenticationType === r.None && (H.current.has(e.id) || (H.current.add(e.id), q(e.id, t.displayName)));
+		}
+	}, [
+		b,
+		G,
+		q
+	]);
+	let ee = p((e, t) => {
+		W(e, {
+			apiKey: t,
+			error: void 0
+		});
+	}, [W]), J = p(async (e) => {
+		W(e, {
+			status: d.Processing,
+			error: void 0
+		});
+		try {
+			await k(e, f.Denied);
+			let t = b.find((t) => t.id === e);
+			L({
+				kind: l.Declined,
+				name: t ? G.get(o(t))?.displayName ?? "" : ""
+			});
+		} catch {
+			W(e, {
+				status: d.Idle,
+				error: u.DeclineFailed
+			});
+		}
+	}, [
+		k,
+		W,
+		b,
+		G
+	]), te = p(() => {
+		for (let e of b) J(e.id);
+	}, [b, J]), Y = p((e, t) => b.filter((n) => n.id !== e.id && n.kind === e.kind && o(n) === o(e) && G.get(o(n))?.credentialsLevel === t.credentialsLevel).map((e) => e.id), [b, G]), X = p(async (e, t) => {
+		let n = Y(e, t);
+		try {
+			await q(e.id, t.displayName);
+		} catch {
+			W(e.id, {
+				status: d.Idle,
+				error: u.LoginFailed
+			});
+			return;
+		}
+		for (let e of n) k(e, f.Success);
+	}, [
+		Y,
+		q,
+		k,
+		W
+	]), Z = p((e, t) => {
+		W(e, {
+			status: d.Idle,
+			error: t
+		});
+	}, [W]), Q = p(async (n, r, i) => {
+		switch ((await E({
+			toolsetId: n.toolsetId,
+			credentialsLevel: r.credentialsLevel,
+			authenticationType: r.authenticationType ?? e.ApiKey,
+			apiKey: i,
+			oauthSettings: r.oauthSettings,
+			forceStale: !0,
+			offlineUsageConsent: R
+		})).type) {
+			case t.Success:
+				await O(), await X(n, r);
+				return;
+			case t.PopupBlocked:
+				Z(n.id, u.PopupBlocked);
+				return;
+			case t.Failure:
+				Z(n.id, u.LoginFailed);
+				return;
+			default: Z(n.id);
+		}
+	}, [
+		E,
+		R,
+		O,
+		X,
+		Z
+	]), $ = p(async (e, t, n) => {
+		switch ((await D({
+			appId: e.appId,
+			serviceId: e.serviceName,
+			credentialsLevel: t.credentialsLevel,
+			authenticationType: t.authenticationType ?? r.ApiKey,
+			apiKey: n,
+			oauthSettings: t.oauthSettings,
+			forceStale: !0,
+			offlineUsageConsent: R
+		})).type) {
+			case i.Success:
+				await X(e, t);
+				return;
+			case i.AdminConsentRequired:
+				Z(e.id, u.AdminConsentRequired);
+				return;
+			case i.OfflineUnavailable:
+				Z(e.id, u.OfflineUnavailable);
+				return;
+			case i.PopupBlocked:
+				Z(e.id, u.PopupBlocked);
+				return;
+			case i.Failure:
+				Z(e.id, u.LoginFailed);
+				return;
+			default: Z(e.id);
+		}
+	}, [
+		D,
+		R,
+		X,
+		Z
+	]), ne = p((e) => {
+		let t = b.find((t) => t.id === e);
+		if (!t) return;
+		let n = K(t), { apiKey: r } = U(e);
+		W(e, {
+			status: d.Processing,
+			error: void 0
+		}), t.kind === a.Toolset ? Q(t, n, r) : $(t, n, r);
+	}, [
+		b,
+		K,
+		U,
+		W,
+		Q,
+		$
+	]);
+	return {
+		rows: h(() => b.map((e) => {
+			let t = K(e), { status: n, error: i, apiKey: a } = U(e.id), o = t.authenticationType === r.ApiKey;
+			return {
+				event: e,
+				info: t,
+				status: n,
+				isProcessing: n === d.Processing,
+				error: i,
+				apiKey: a,
+				requiresApiKey: o,
+				requiresNoCredentials: t.authenticationType === r.None,
+				isDialNative: t.authenticationType === r.DialNative,
+				canSubmitLogin: !o || a.trim().length > 0
+			};
+		}), [
+			b,
+			K,
+			U
+		]),
+		announcement: I,
+		offlineUsageConsent: R,
+		setOfflineUsageConsent: z,
+		isOfflineUsageConsentShown: h(() => b.some((e) => {
+			let t = G.get(o(e))?.authenticationType;
+			return t === r.ApiKey || t === r.OAuth;
+		}), [b, G]),
+		changeApiKey: ee,
+		login: ne,
+		decline: J,
+		declineAll: te
+	};
+};
+//#endregion
+export { b as useSigninInterrupt };

package/skill/skill-archive.d.ts

@@ -0,0 +1,7 @@
+import { SkillFileSourceEntry } from '@epam/ai-dial-skill-editor';
+/**
+ * Expands a `.zip` into one entry per file, with `/`-separated paths as stored
+ * in the archive; rejects when the input is not a readable zip.
+ */
+export declare const extractSkillArchive: (archive: File) => Promise<SkillFileSourceEntry[]>;
+//# sourceMappingURL=skill-archive.d.ts.map

package/skill/skill-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-archive.d.ts","sourceRoot":"","sources":["../../src/skill/skill-archive.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AA2BvE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,IAAI,KACZ,OAAO,CAAC,oBAAoB,EAAE,CAmBhC,CAAC"}

package/skill/skill-file-batch-validation.d.ts

@@ -0,0 +1,74 @@
+import { SkillFileBatchError, SkillFileUploadCandidate, SkillFileValidationResult } from '@epam/ai-dial-skill-editor';
+/** A recognized, structurally valid manifest candidate from a staged batch. */
+export interface SkillManifestImportCandidate {
+    /** The `SkillFileUploadCandidate.id` this manifest came from. */
+    candidateId: string;
+    /** The imported manifest's `name` field. */
+    name: string;
+    /** The imported manifest's `description` field. */
+    description: string;
+    /** The imported manifest's full parsed frontmatter, including unknown fields. */
+    frontmatter: Record<string, unknown>;
+    /** The imported manifest's instructions body. */
+    instructions: string;
+}
+/** Localized messages the batch validator needs, resolved by the caller. */
+export interface SkillFileBatchValidationMessages {
+    /** Shown when a required field (e.g. a candidate's path) is empty. */
+    required: string;
+    /** Shown when a candidate's path collides with a reserved entry name. */
+    pathReserved: string;
+    /** Shown when a candidate's path fails DIAL's relative-path rules. */
+    pathInvalid: string;
+    /** Shown when a candidate's path duplicates another candidate or an existing file. */
+    pathDuplicate: string;
+    /** Shown when a candidate exceeds the per-file size limit; receives the formatted limit. */
+    fileTooLarge: (maxSize: string) => string;
+    /** Shown when a root-level `SKILL.md`-like path has the wrong casing. */
+    manifestCasingInvalid: string;
+    /** Shown when the batch stages more than one root `SKILL.md`. */
+    manifestDuplicate: string;
+    /** Shown when a root `SKILL.md`'s bytes are not valid UTF-8. */
+    manifestInvalidUtf8: string;
+    /** Shown when a root `SKILL.md`'s frontmatter is missing or missing `name`/`description`. */
+    manifestInvalidFrontmatter: string;
+    /** Shown when the batch's projected total package size exceeds the limit. */
+    totalSizeExceeded: string;
+    /** Shown when the batch's projected total file count exceeds the limit. */
+    totalCountExceeded: string;
+}
+/** Snapshot of editor state the batch validator projects new totals against. */
+export interface SkillFileBatchValidationContext {
+    /** Paths already present in the editor's supporting-file tree. */
+    existingPaths: string[];
+    /** Sum of the bytes already held for existing supporting files. */
+    existingTotalBytes: number;
+    /** Bytes held for each existing supporting file, keyed by path; a replacing upload frees its target's share. Defaults to none. */
+    existingFileBytes?: ReadonlyMap<string, number>;
+    /** Paths of the folders in the tree; a file can never take one over, so a candidate at such a path is a duplicate. Defaults to none. */
+    existingFolderPaths?: string[];
+    /** UTF-8 byte length of the currently generated/loaded root `SKILL.md`. */
+    manifestByteLength: number;
+    /** Localized messages. */
+    messages: SkillFileBatchValidationMessages;
+}
+/** Result of validating a whole staged batch. */
+export interface SkillFileBatchValidationOutcome {
+    /** One result per candidate, in the same order as the input. */
+    results: SkillFileValidationResult[];
+    /** Batch-level errors (projected total size/count, multiple manifests). */
+    batchErrors: SkillFileBatchError[];
+    /** The single accepted manifest import, when the batch has exactly one valid `SKILL.md`. */
+    manifestCandidate?: SkillManifestImportCandidate;
+}
+/**
+ * Validates a whole staged upload batch against per-file limits, path
+ * safety, in-batch/against-existing duplicates, and projected total
+ * size/count — mirroring the BFF's authoritative `SkillsPackageService`
+ * limits for immediate feedback (the server remains the final gate). Reads
+ * each candidate's bytes only where required (the root `SKILL.md` manifest,
+ * to decode and parse its frontmatter) — never for an ordinary supporting
+ * file, whose size is checked via `File.size` alone.
+ */
+export declare const validateSkillFileBatch: (candidates: SkillFileUploadCandidate[], context: SkillFileBatchValidationContext) => Promise<SkillFileBatchValidationOutcome>;
+//# sourceMappingURL=skill-file-batch-validation.d.ts.map

package/skill/skill-file-batch-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-file-batch-validation.d.ts","sourceRoot":"","sources":["../../src/skill/skill-file-batch-validation.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,4BAA4B,CAAC;AAUpC,+EAA+E;AAC/E,MAAM,WAAW,4BAA4B;IAC3C,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,WAAW,gCAAgC;IAC/C,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,aAAa,EAAE,MAAM,CAAC;IACtB,4FAA4F;IAC5F,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1C,yEAAyE;IACzE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6FAA6F;IAC7F,0BAA0B,EAAE,MAAM,CAAC;IACnC,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,gFAAgF;AAChF,MAAM,WAAW,+BAA+B;IAC9C,kEAAkE;IAClE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mEAAmE;IACnE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kIAAkI;IAClI,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,wIAAwI;IACxI,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B;IAC1B,QAAQ,EAAE,gCAAgC,CAAC;CAC5C;AAED,iDAAiD;AACjD,MAAM,WAAW,+BAA+B;IAC9C,gEAAgE;IAChE,OAAO,EAAE,yBAAyB,EAAE,CAAC;IACrC,2EAA2E;IAC3E,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,4FAA4F;IAC5F,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;CAClD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GACjC,YAAY,wBAAwB,EAAE,EACtC,SAAS,+BAA+B,KACvC,OAAO,CAAC,+BAA+B,CAgJzC,CAAC"}