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

package/share-invitation/models.d.ts

@@ -0,0 +1,46 @@
+import { AcceptInvitationResponseDto, DeploymentItemDto, DialToolsetDto, SkillMetadataItemDto } from '@epam/ai-dial-chat-api-client';
+import { AcceptShareInvitationErrorKind } from './types';
+/** Localized sentences shown when accepting a share invitation fails. */
+export interface AcceptShareInvitationErrorLabels {
+    /** Sentence for an expired or unknown link. Defaults to `'We are sorry, but the link you are trying to access has expired or does not exist.'`. */
+    notFound: string;
+    /** Sentence for a reached users limit, given the shared item's name. Defaults to `` (name) => `"${name}" has already been shared with the maximum specified number of users.` ``. */
+    usersLimitReached: (name: string) => string;
+    /** Sentence for a reached users limit when the backend sent no item name. Defaults to `'This item has already been shared with the maximum specified number of users.'`. */
+    usersLimitReachedUnnamed: string;
+    /** Sentence for any other failure that carries no message of its own. Defaults to `'This share link is invalid or has expired.'`. */
+    acceptError: string;
+}
+/** A classified share-invitation accept failure, ready to show as an error notification. */
+export interface AcceptShareInvitationError {
+    /** Why the accept failed. */
+    kind: AcceptShareInvitationErrorKind;
+    /** User-facing sentence for the failure. */
+    message: string;
+    /** Trace id to show as the Request ID; set only for `Failed`, since expired and over-the-limit links are expected outcomes. */
+    requestId?: string;
+    /** Shared item's title sent with a `UsersLimitReached` refusal, when the backend sent one. */
+    itemName?: string;
+    /** The original thrown value. */
+    cause: unknown;
+}
+/** Options for {@link useAcceptShareInvitation}. */
+export interface UseAcceptShareInvitationOptions {
+    /** Invitation id from the opened share link; nothing is accepted while it is `undefined`. */
+    invitationId: string | undefined;
+    /** Already-configured call that accepts the invitation in DIAL Core. */
+    acceptInvitation: (invitationId: string) => Promise<AcceptInvitationResponseDto>;
+    /** Refreshes the host's lists after the accept and before the shared summaries are merged. Skipped when omitted. */
+    refreshLists?: (response: AcceptInvitationResponseDto) => Promise<unknown>;
+    /** Receives the backend-resolved model, application or toolset summary, after `refreshLists` settles. */
+    onSharedItem?: (item: DeploymentItemDto | DialToolsetDto) => void;
+    /** Receives the backend-resolved skill summary, after `refreshLists` settles. */
+    onSharedSkill?: (skill: SkillMetadataItemDto) => void;
+    /** Called last once the invitation is accepted, e.g. to redirect to `response.itemId`. */
+    onAccepted: (response: AcceptInvitationResponseDto) => void;
+    /** Called with the classified failure, e.g. to show a notification and redirect to a fallback. */
+    onError: (error: AcceptShareInvitationError) => void;
+    /** Overrides for the failure sentences. Defaults to {@link DEFAULT_ACCEPT_SHARE_INVITATION_ERROR_LABELS}. */
+    labels?: Partial<AcceptShareInvitationErrorLabels>;
+}
+//# sourceMappingURL=models.d.ts.map

package/share-invitation/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/share-invitation/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,SAAS,CAAC;AAE9D,yEAAyE;AACzE,MAAM,WAAW,gCAAgC;IAC/C,mJAAmJ;IACnJ,QAAQ,EAAE,MAAM,CAAC;IACjB,qLAAqL;IACrL,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,4KAA4K;IAC5K,wBAAwB,EAAE,MAAM,CAAC;IACjC,qIAAqI;IACrI,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,4FAA4F;AAC5F,MAAM,WAAW,0BAA0B;IACzC,6BAA6B;IAC7B,IAAI,EAAE,8BAA8B,CAAC;IACrC,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,+HAA+H;IAC/H,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,+BAA+B;IAC9C,6FAA6F;IAC7F,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,wEAAwE;IACxE,gBAAgB,EAAE,CAChB,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC1C,oHAAoH;IACpH,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,2BAA2B,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,yGAAyG;IACzG,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,GAAG,cAAc,KAAK,IAAI,CAAC;IAClE,iFAAiF;IACjF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACtD,0FAA0F;IAC1F,UAAU,EAAE,CAAC,QAAQ,EAAE,2BAA2B,KAAK,IAAI,CAAC;IAC5D,kGAAkG;IAClG,OAAO,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,CAAC;IACrD,6GAA6G;IAC7G,MAAM,CAAC,EAAE,OAAO,CAAC,gCAAgC,CAAC,CAAC;CACpD"}

package/share-invitation/share-invitation-error.d.ts

@@ -0,0 +1,6 @@
+import { AcceptShareInvitationError, AcceptShareInvitationErrorLabels } from './models';
+/** English sentences used when a host passes no {@link AcceptShareInvitationErrorLabels}. */
+export declare const DEFAULT_ACCEPT_SHARE_INVITATION_ERROR_LABELS: AcceptShareInvitationErrorLabels;
+/** Returns the kind, user-facing sentence and Request ID for a failed share-invitation accept. */
+export declare const resolveAcceptShareInvitationError: (error: unknown, labels?: Partial<AcceptShareInvitationErrorLabels>) => Promise<AcceptShareInvitationError>;
+//# sourceMappingURL=share-invitation-error.d.ts.map

package/share-invitation/share-invitation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"share-invitation-error.d.ts","sourceRoot":"","sources":["../../src/share-invitation/share-invitation-error.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,0BAA0B,EAC1B,gCAAgC,EACjC,MAAM,UAAU,CAAC;AAGlB,6FAA6F;AAC7F,eAAO,MAAM,4CAA4C,EAAE,gCASxD,CAAC;AAEJ,kGAAkG;AAClG,eAAO,MAAM,iCAAiC,GAC5C,OAAO,OAAO,EACd,SAAQ,OAAO,CAAC,gCAAgC,CAAM,KACrD,OAAO,CAAC,0BAA0B,CAuCpC,CAAC"}

package/share-invitation/share-invitation-error.js

@@ -0,0 +1,37 @@
+import { getAcceptInvitationErrorItemName as e, getApiErrorDetails as t } from "../api-error/api-error.js";
+import { AcceptShareInvitationErrorKind as n } from "./types.js";
+import { ShareInvitationErrorCode as r } from "@epam/ai-dial-chat-api-client";
+//#region src/share-invitation/share-invitation-error.ts
+var i = {
+	notFound: "We are sorry, but the link you are trying to access has expired or does not exist.",
+	usersLimitReached: (e) => `"${e}" has already been shared with the maximum specified number of users.`,
+	usersLimitReachedUnnamed: "This item has already been shared with the maximum specified number of users.",
+	acceptError: "This share link is invalid or has expired."
+}, a = async (a, o = {}) => {
+	let s = {
+		...i,
+		...o
+	}, { message: c, traceId: l, code: u } = await t(a);
+	if (u === r.ShareInvitationNotFound) return {
+		kind: n.NotFound,
+		message: s.notFound,
+		cause: a
+	};
+	if (u === r.ShareInvitationAcceptedUsersLimitReached) {
+		let t = await e(a);
+		return {
+			kind: n.UsersLimitReached,
+			message: t ? s.usersLimitReached(t) : s.usersLimitReachedUnnamed,
+			...t ? { itemName: t } : {},
+			cause: a
+		};
+	}
+	return {
+		kind: n.Failed,
+		message: c ?? s.acceptError,
+		...l ? { requestId: l } : {},
+		cause: a
+	};
+};
+//#endregion
+export { i as DEFAULT_ACCEPT_SHARE_INVITATION_ERROR_LABELS, a as resolveAcceptShareInvitationError };

package/share-invitation/types.d.ts

@@ -0,0 +1,10 @@
+/** Why accepting a share invitation failed. */
+export declare enum AcceptShareInvitationErrorKind {
+    /** The link has expired or never existed (`ShareInvitationErrorCode.ShareInvitationNotFound`). */
+    NotFound = "not-found",
+    /** The item is already shared with the maximum number of users (`ShareInvitationErrorCode.ShareInvitationAcceptedUsersLimitReached`). */
+    UsersLimitReached = "users-limit-reached",
+    /** Any other failure, including a refresh or callback that threw after the accept. */
+    Failed = "failed"
+}
+//# sourceMappingURL=types.d.ts.map

package/share-invitation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/share-invitation/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,oBAAY,8BAA8B;IACxC,kGAAkG;IAClG,QAAQ,cAAc;IACtB,yIAAyI;IACzI,iBAAiB,wBAAwB;IACzC,sFAAsF;IACtF,MAAM,WAAW;CAClB"}

package/share-invitation/types.js

@@ -0,0 +1,6 @@
+//#region src/share-invitation/types.ts
+var e = /* @__PURE__ */ function(e) {
+	return e.NotFound = "not-found", e.UsersLimitReached = "users-limit-reached", e.Failed = "failed", e;
+}({});
+//#endregion
+export { e as AcceptShareInvitationErrorKind };

package/share-invitation/useAcceptShareInvitation/useAcceptShareInvitation.d.ts

@@ -0,0 +1,9 @@
+import { UseAcceptShareInvitationOptions } from '../models';
+/**
+ * Accepts a share invitation once per mount, then refreshes the host's lists,
+ * merges the backend-resolved summaries and calls `onAccepted`; any failure
+ * goes to `onError` already classified. Callbacks are read at call time, so
+ * new identities never re-run the accept.
+ */
+export declare const useAcceptShareInvitation: (options: UseAcceptShareInvitationOptions) => void;
+//# sourceMappingURL=useAcceptShareInvitation.d.ts.map

package/share-invitation/useAcceptShareInvitation/useAcceptShareInvitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAcceptShareInvitation.d.ts","sourceRoot":"","sources":["../../../src/share-invitation/useAcceptShareInvitation/useAcceptShareInvitation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,WAAW,CAAC;AAGjE;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,SAAS,+BAA+B,KACvC,IA2CF,CAAC"}

package/share-invitation/useAcceptShareInvitation/useAcceptShareInvitation.js

@@ -0,0 +1,26 @@
+import { resolveAcceptShareInvitationError as e } from "../share-invitation-error.js";
+import { useEffect as t, useRef as n } from "react";
+//#region src/share-invitation/useAcceptShareInvitation/useAcceptShareInvitation.ts
+var r = (r) => {
+	let i = n(r);
+	t(() => {
+		i.current = r;
+	});
+	let a = n(!1), { invitationId: o } = r;
+	t(() => {
+		o && !a.current && (a.current = !0, (async () => {
+			let { acceptInvitation: t, refreshLists: n, onSharedItem: r, onSharedSkill: a, onAccepted: s } = i.current;
+			try {
+				let e = await t(o);
+				n && await n(e);
+				let { sharedDeployment: i, sharedToolset: c, sharedSkill: l } = e, u = i ?? c;
+				u && r?.(u), l && a?.(l), s(e);
+			} catch (t) {
+				let { labels: n, onError: r } = i.current;
+				r(await e(t, n));
+			}
+		})());
+	}, [o]);
+};
+//#endregion
+export { r as useAcceptShareInvitation };

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 };