@epam/ai-dial-chat-hooks 1.2.0-dev.20 → 1.2.0-dev.207

package/usage/map-usage-data-to-dashboard.js

@@ -0,0 +1,66 @@
+import { formatCost as e } from "@epam/ai-dial-chat-shared";
+import { UsageLimitStatus as t } from "@epam/ai-dial-usage-dashboard";
+//#region src/usage/map-usage-data-to-dashboard.ts
+var n = {
+	todayTitle: "usage.todayTitle",
+	todayPeriodDescription: "usage.todayPeriodDescription",
+	thisWeekTitle: "usage.thisWeekTitle",
+	thisWeekPeriodDescription: "usage.thisWeekPeriodDescription",
+	thisMonthTitle: "usage.thisMonthTitle",
+	thisMonthPeriodDescription: "usage.thisMonthPeriodDescription",
+	unlimitedProgressAriaLabel: "usage.unlimitedProgressAriaLabel",
+	progressAriaLabel: "usage.progressAriaLabel"
+}, r = 2 ** 53, i = 75, a = (e) => e != null && Number.isFinite(e.total) && Number.isFinite(e.used), o = (e) => e >= 100 ? t.LimitReached : e >= i ? t.RunningLow : t.Default, s = (e) => e ? {
+	resetLabel: e.label,
+	resetIsoValue: e.isoValue,
+	resetAriaLabel: e.ariaLabel
+} : {}, c = (i, a, c, l, u) => {
+	let d = Math.max(0, i.used), f = e(d), p = s(u);
+	if (i.total >= r) return {
+		title: a,
+		periodDescription: c,
+		used: d,
+		total: i.total,
+		usedLabel: f,
+		isUnlimited: !0,
+		status: t.Default,
+		progressAriaLabel: l(n.unlimitedProgressAriaLabel, { used: f }),
+		...p
+	};
+	let m = Math.max(i.total, 0), h = Math.max(m - d, 0), g = m > 0 ? d / m * 100 : 100, _ = e(m);
+	return {
+		title: a,
+		periodDescription: c,
+		used: d,
+		total: m,
+		usedLabel: f,
+		totalLabel: _,
+		remainingLabel: e(h),
+		usedPercent: g,
+		status: o(g),
+		progressAriaLabel: l(n.progressAriaLabel, {
+			used: f,
+			total: _,
+			percent: Math.round(g)
+		}),
+		...p
+	};
+}, l = (e, t, r) => [
+	{
+		stats: e?.dayCostStats,
+		titleKey: n.todayTitle,
+		periodDescriptionKey: n.todayPeriodDescription
+	},
+	{
+		stats: e?.weekCostStats,
+		titleKey: n.thisWeekTitle,
+		periodDescriptionKey: n.thisWeekPeriodDescription
+	},
+	{
+		stats: e?.monthCostStats,
+		titleKey: n.thisMonthTitle,
+		periodDescriptionKey: n.thisMonthPeriodDescription
+	}
+].flatMap(({ stats: e, titleKey: n, periodDescriptionKey: i }) => a(e) ? [c(e, t(n), t(i), t, r(e.resetsAt))] : []);
+//#endregion
+export { n as USAGE_DATA_I18N_KEYS, l as mapUsageDataToDashboard };

package/usage/map-user-usage-to-model-limits.js

@@ -0,0 +1,202 @@
+import { normalizeDeploymentId as e } from "../catalog/deployment-id.js";
+import { formatCost as t } from "@epam/ai-dial-chat-shared";
+import { DeploymentItemDtoTypeEnum as n } from "@epam/ai-dial-chat-api-client";
+import { ModelLimitMetricKind as r, ModelLimitStatus as i } from "@epam/ai-dial-usage-dashboard";
+//#region src/usage/map-user-usage-to-model-limits.ts
+var a = 2 ** 53, o = 75, s = new Intl.NumberFormat(void 0, {
+	notation: "compact",
+	maximumFractionDigits: 1
+}), c = new Intl.NumberFormat(void 0, { maximumFractionDigits: 2 }), l = {
+	todayPeriodDescription: "usage.todayPeriodDescription",
+	thisWeekPeriodDescription: "usage.thisWeekPeriodDescription",
+	thisMonthPeriodDescription: "usage.thisMonthPeriodDescription",
+	overallCostLimitRunningLowTooltip: "usage.overallCostLimitRunningLowTooltip",
+	overallCostLimitReachedTooltip: "usage.overallCostLimitReachedTooltip",
+	unavailableLabel: "usage.unavailableLabel",
+	followsCostLimitLabel: "usage.followsCostLimitLabel",
+	noLimitLabel: "usage.noLimitLabel",
+	followsCostLimitAriaLabel: "usage.followsCostLimitAriaLabel",
+	unlimitedProgressAriaLabel: "usage.unlimitedProgressAriaLabel",
+	progressAriaLabel: "usage.progressAriaLabel",
+	spentLabel: "usage.spentLabel",
+	applicationTypeLabel: "usage.applicationTypeLabel",
+	includesCalledModelsLabel: "usage.includesCalledModelsLabel"
+}, u = {
+	day: {
+		cost: "dayCostStats",
+		tokens: "dayTokenStats"
+	},
+	week: {
+		cost: "weekCostStats",
+		tokens: "weekTokenStats"
+	},
+	month: {
+		cost: "monthCostStats",
+		tokens: "monthTokenStats"
+	}
+}, d = {
+	day: {
+		field: "dayCostStats",
+		labelKey: l.todayPeriodDescription
+	},
+	week: {
+		field: "weekCostStats",
+		labelKey: l.thisWeekPeriodDescription
+	},
+	month: {
+		field: "monthCostStats",
+		labelKey: l.thisMonthPeriodDescription
+	}
+}, f = (e) => e != null && Number.isFinite(e.total) && Number.isFinite(e.used), p = (e) => e >= 100 ? i.LimitReached : e >= o ? i.RunningLow : i.WithinLimits, m = (e) => {
+	if (!f(e)) return i.Unavailable;
+	if (e.total >= a) return i.NoLimit;
+	let t = Math.max(0, e.used), n = Math.max(0, e.total);
+	return p(n > 0 ? t / n * 100 : 100);
+}, h = (e) => e === i.WithinLimits || e === i.RunningLow || e === i.LimitReached, g = (e, t, n, r, a) => {
+	let o = e?.[t.field], s = m(o), c = a(o?.resetsAt), u = r(t.labelKey).toLocaleLowerCase(n);
+	return {
+		status: s,
+		tooltipLabel: s === i.LimitReached ? r(l.overallCostLimitReachedTooltip, { period: u }) : s === i.RunningLow ? r(l.overallCostLimitRunningLowTooltip, { period: u }) : void 0,
+		...c ? {
+			resetLabel: c.label,
+			resetIsoValue: c.isoValue,
+			resetAriaLabel: c.ariaLabel
+		} : {}
+	};
+}, _ = () => void 0, v = (e, t, n, r = _) => ({
+	day: g(e, d.day, t, n, r),
+	week: g(e, d.week, t, n, r),
+	month: g(e, d.month, t, n, r)
+}), y = (e) => ({
+	kind: r.Unavailable,
+	ariaLabel: e(l.unavailableLabel)
+}), b = (e, t, n) => {
+	if (!f(e)) return y(n);
+	let i = Math.max(0, e.used), o = s.format(i);
+	if (e.total >= a) {
+		let e = h(t);
+		return {
+			kind: r.Unlimited,
+			usedLabel: o,
+			supportingLabel: n(e ? l.followsCostLimitLabel : l.noLimitLabel),
+			ariaLabel: n(e ? l.followsCostLimitAriaLabel : l.unlimitedProgressAriaLabel, { used: c.format(i) })
+		};
+	}
+	let u = Math.max(e.total, 0), d = s.format(u), m = u > 0 ? i / u * 100 : 100, g = p(m);
+	return {
+		kind: r.Finite,
+		usedLabel: o,
+		totalLabel: d,
+		usedPercent: m,
+		status: g,
+		ariaLabel: n(l.progressAriaLabel, {
+			used: c.format(i),
+			total: c.format(u),
+			percent: Math.round(m)
+		})
+	};
+}, x = (e, n) => {
+	if (!f(e)) return y(n);
+	let i = Math.max(0, e.used), o = n(l.spentLabel, { amount: t(i) });
+	if (e.total >= a) return {
+		kind: r.Unlimited,
+		usedLabel: o,
+		ariaLabel: o
+	};
+	let s = Math.max(e.total, 0), c = s > 0 ? i / s * 100 : 100;
+	return {
+		kind: r.Finite,
+		usedLabel: o,
+		totalLabel: t(s),
+		usedPercent: c,
+		status: p(c),
+		ariaLabel: n(l.progressAriaLabel, {
+			used: t(i),
+			total: t(s),
+			percent: Math.round(c)
+		})
+	};
+}, S = (e, t, n, r) => ({
+	tokens: b(e[t.tokens], n, r),
+	cost: x(e[t.cost], r)
+}), C = (e) => e.filter((e) => e.kind === r.Finite).map((e) => e.status), w = (e, t, n) => {
+	let a = [
+		...C(e),
+		...C(t),
+		...n
+	].filter((e) => e != null && h(e));
+	return a.includes(i.LimitReached) ? i.LimitReached : a.includes(i.RunningLow) ? i.RunningLow : a.includes(i.WithinLimits) ? i.WithinLimits : e.some((e) => e.kind === r.Unlimited) || n.includes(i.NoLimit) ? i.NoLimit : i.Unavailable;
+}, T = (e, t, n) => {
+	let i = x(e[t.cost], n);
+	return {
+		tokens: y(n),
+		cost: i.kind === r.Unlimited ? {
+			...i,
+			supportingLabel: n(l.includesCalledModelsLabel)
+		} : i
+	};
+}, E = (e) => e.some((e) => f(e) && e.used > 0), D = (t, r, i, a, o, s) => {
+	let c = t?.deployments;
+	if (c == null) return [];
+	let d = new Map(r.filter((e) => e.type === n.Model || e.type === n.Application).map((t) => [e(t.id), t])), f = v(t, i, a);
+	return Object.keys(c).map((t) => {
+		let r = d.get(e(t)), p = r == null ? t : s(r.displayName, i) || r.id, m = c[t], h = o(r?.iconUrl);
+		if (r?.type === n.Application) {
+			let e = T(m, u.day, a), n = T(m, u.week, a), i = T(m, u.month, a);
+			return {
+				row: {
+					id: t,
+					name: p,
+					version: r.displayVersion,
+					avatarSrc: h,
+					typeLabel: a(l.applicationTypeLabel),
+					day: e,
+					week: n,
+					month: i,
+					status: w([
+						e.tokens,
+						n.tokens,
+						i.tokens
+					], [
+						e.cost,
+						n.cost,
+						i.cost
+					], [
+						f.day.status,
+						f.week.status,
+						f.month.status
+					])
+				},
+				hasUsage: E(Object.values(u).map(({ cost: e }) => m[e]))
+			};
+		}
+		let g = S(m, u.day, f.day.status, a), _ = S(m, u.week, f.week.status, a), v = S(m, u.month, f.month.status, a), y = Object.values(u).flatMap(({ cost: e, tokens: t }) => [m[e], m[t]]);
+		return {
+			row: {
+				id: t,
+				name: p,
+				version: r?.displayVersion,
+				avatarSrc: h,
+				day: g,
+				week: _,
+				month: v,
+				status: w([
+					g.tokens,
+					_.tokens,
+					v.tokens
+				], [
+					g.cost,
+					_.cost,
+					v.cost
+				], [
+					f.day.status,
+					f.week.status,
+					f.month.status
+				])
+			},
+			hasUsage: E(y)
+		};
+	}).filter(({ hasUsage: e }) => e).map(({ row: e }) => e);
+};
+//#endregion
+export { l as USAGE_MODEL_LIMITS_I18N_KEYS, v as mapOverallCostLimitsToPeriodStatuses, D as mapUserUsageToModelLimits };

package/usage.d.ts

@@ -0,0 +1,125 @@
+import { DeploymentItemDto } from '@epam/ai-dial-chat-api-client';
+import { ModelLimitPeriodStatuses } from '@epam/ai-dial-usage-dashboard';
+import { ModelLimitRow } from '@epam/ai-dial-usage-dashboard';
+import { UsageLimitCardData } from '@epam/ai-dial-usage-dashboard';
+import { UserLimitStatsResponseDto } from '@epam/ai-dial-chat-api-client';
+
+/** Formats a raw `resetsAt` into display strings, or returns `undefined` when it cannot be formatted. */
+export declare type FormatResetTime = (resetsAt: string | undefined) => ResetTimeDisplay | undefined;
+
+/**
+ * Maps the same top-level Cost budgets used by the aggregate cards into table-header state.
+ *
+ * @param formatResetTime - Formats each period's top-level `resetsAt` into the header's reset trio. Omit it to produce statuses with no reset fields.
+ */
+export declare const mapOverallCostLimitsToPeriodStatuses: (usage: UserLimitStatsResponseDto | undefined, activeLocale: string, t: Translate_2, formatResetTime?: FormatResetTime) => ModelLimitPeriodStatuses;
+
+/**
+ * Maps a `UserLimitStatsResponseDto` into `UsageLimitCardGroup`'s `cards` prop,
+ * in Today / This week / This month order. A period is omitted entirely when
+ * the response carries no usable stat for it. Each card's reset trio comes from
+ * `formatResetTime`, and is absent when that callback returns `undefined`.
+ */
+export declare const mapUsageDataToDashboard: (usage: UserLimitStatsResponseDto | undefined, t: Translate, formatResetTime: FormatResetTime) => UsageLimitCardData[];
+
+/**
+ * Maps `usage.deployments` into `ModelLimitsSection`'s `rows` prop, joined with model or application
+ * identity from `deploymentItems`. Rows are included only when any displayed period stat has nonzero
+ * usage (Cost stats only, for an application). Order follows `Object.keys(deployments)` —
+ * `deploymentItems` is enrichment-only.
+ *
+ * @param resolveIconUrl - Resolves a deployment's raw `iconUrl` to the URL the avatar should load.
+ * @param resolveDisplayName - Resolves a localized-text map or plain string to the display name for `activeLocale`.
+ */
+export declare const mapUserUsageToModelLimits: (usage: UserLimitStatsResponseDto | undefined, deploymentItems: DeploymentItemDto[], activeLocale: string, t: Translate_2, resolveIconUrl: ResolveIconUrl, resolveDisplayName: ResolveDisplayName) => ModelLimitRow[];
+
+/**
+ * One reset time, already parsed and formatted by the host. Declared
+ * structurally here so this library never imports an application type; the
+ * host passes a value that satisfies this shape (e.g. `apps/chat`'s own
+ * `ResetTimeDisplay`).
+ */
+export declare interface ResetTimeDisplay {
+    /** Exclusive end of the period as an epoch ms value, for the host's boundary scheduling. */
+    resetsAtMs: number;
+    /** Machine-readable instant for a `<time dateTime>` attribute. */
+    isoValue: string;
+    /** Visible reset line. */
+    label: string;
+    /** Accessible expansion of the reset line. */
+    ariaLabel: string;
+}
+
+/** A callback that resolves a display name from a localized-text value. */
+declare type ResolveDisplayName = (name: string | Record<string, string> | undefined | null, locale: string) => string;
+
+/** A callback that resolves an icon URL from a deployment's raw `iconUrl` field. */
+declare type ResolveIconUrl = (iconUrl: string | undefined) => string | undefined;
+
+/** A translate function compatible with i18next's `TFunction`. */
+declare type Translate = (key: string, options?: Record<string, unknown>) => string;
+
+/** A translate function compatible with i18next's `TFunction`. */
+declare type Translate_2 = (key: string, options?: Record<string, unknown>) => string;
+
+/**
+ * i18n key strings that the consuming app's translation bundle must define for
+ * `mapUsageDataToDashboard` to produce correctly translated strings. The
+ * values are the default key paths used by AI DIAL Chat.
+ */
+export declare const USAGE_DATA_I18N_KEYS: {
+    /** Title for the current-UTC-day card (e.g. `'Today'`). */
+    readonly todayTitle: "usage.todayTitle";
+    /** Accessible period description for the current-UTC-day card. */
+    readonly todayPeriodDescription: "usage.todayPeriodDescription";
+    /** Title for the current-UTC-week card (e.g. `'This week'`). */
+    readonly thisWeekTitle: "usage.thisWeekTitle";
+    /** Accessible period description for the current-UTC-week card. */
+    readonly thisWeekPeriodDescription: "usage.thisWeekPeriodDescription";
+    /** Title for the current-UTC-month card (e.g. `'This month'`). */
+    readonly thisMonthTitle: "usage.thisMonthTitle";
+    /** Accessible period description for the current-UTC-month card. */
+    readonly thisMonthPeriodDescription: "usage.thisMonthPeriodDescription";
+    /** Aria label when there is no limit. Receives `{ used: string }`. */
+    readonly unlimitedProgressAriaLabel: "usage.unlimitedProgressAriaLabel";
+    /** Aria label for a progress bar with a finite limit. Receives `{ used: string, total: string, percent: number }`. */
+    readonly progressAriaLabel: "usage.progressAriaLabel";
+};
+
+/**
+ * i18n key strings that the consuming app's translation bundle must define for
+ * `mapUserUsageToModelLimits` and `mapOverallCostLimitsToPeriodStatuses` to produce
+ * correctly translated strings. The values are the default key paths used by AI DIAL Chat.
+ */
+export declare const USAGE_MODEL_LIMITS_I18N_KEYS: {
+    /** Period label used in tooltip text. Receives no interpolation. */
+    readonly todayPeriodDescription: "usage.todayPeriodDescription";
+    /** Period label used in tooltip text. Receives no interpolation. */
+    readonly thisWeekPeriodDescription: "usage.thisWeekPeriodDescription";
+    /** Period label used in tooltip text. Receives no interpolation. */
+    readonly thisMonthPeriodDescription: "usage.thisMonthPeriodDescription";
+    /** Tooltip when the overall cost limit is running low. Receives `{ period: string }`. */
+    readonly overallCostLimitRunningLowTooltip: "usage.overallCostLimitRunningLowTooltip";
+    /** Tooltip when the overall cost limit is reached. Receives `{ period: string }`. */
+    readonly overallCostLimitReachedTooltip: "usage.overallCostLimitReachedTooltip";
+    /** Aria label for a metric cell with no data. */
+    readonly unavailableLabel: "usage.unavailableLabel";
+    /** Supporting label when a token limit follows the cost limit. */
+    readonly followsCostLimitLabel: "usage.followsCostLimitLabel";
+    /** Supporting label when there is no per-deployment token limit. */
+    readonly noLimitLabel: "usage.noLimitLabel";
+    /** Aria label when token usage has no limit but follows the cost limit. Receives `{ used: string }`. */
+    readonly followsCostLimitAriaLabel: "usage.followsCostLimitAriaLabel";
+    /** Aria label when there is no limit. Receives `{ used: string }`. */
+    readonly unlimitedProgressAriaLabel: "usage.unlimitedProgressAriaLabel";
+    /** Aria label for a progress bar with a finite limit. Receives `{ used: string, total: string, percent: number }`. */
+    readonly progressAriaLabel: "usage.progressAriaLabel";
+    /** Label for the spent-cost cell. Receives `{ amount: string }`. */
+    readonly spentLabel: "usage.spentLabel";
+    /** Type caption for an application (agent) row. Receives no interpolation. */
+    readonly applicationTypeLabel: "usage.applicationTypeLabel";
+    /** Supporting label on an application row's spent cost. Receives no interpolation. */
+    readonly includesCalledModelsLabel: "usage.includesCalledModelsLabel";
+};
+
+export { }

package/usage.js

@@ -0,0 +1,3 @@
+import { USAGE_DATA_I18N_KEYS as e, mapUsageDataToDashboard as t } from "./usage/map-usage-data-to-dashboard.js";
+import { USAGE_MODEL_LIMITS_I18N_KEYS as n, mapOverallCostLimitsToPeriodStatuses as r, mapUserUsageToModelLimits as i } from "./usage/map-user-usage-to-model-limits.js";
+export { e as USAGE_DATA_I18N_KEYS, n as USAGE_MODEL_LIMITS_I18N_KEYS, r as mapOverallCostLimitsToPeriodStatuses, t as mapUsageDataToDashboard, i as mapUserUsageToModelLimits };

package/usePageFileDrag/usePageFileDrag.js

@@ -6,8 +6,8 @@ var a = (a = !0, o = !0) => {
 		f.current = a, p.current = o, o || (d.current = 0, c(!1));
 	}, [a, o]);
 	let m = e(() => {
-		u([]);
-	}, []);
+		u((e) => e.filter((e) => !l.includes(e)));
+	}, [l]);
 	return t(() => {
 		let e = (e) => !!e.dataTransfer?.types.includes("Files"), t = (t) => {
 			!p.current || !e(t) || (d.current += 1, c(!0));
@@ -18,7 +18,7 @@ var a = (a = !0, o = !0) => {
 		}, i = (t) => {
 			if (!(!e(t) || !p.current) && (t.preventDefault(), d.current = 0, c(!1), f.current)) {
 				let e = Array.from(t.dataTransfer?.files ?? []);
-				e.length > 0 && u(e);
+				e.length > 0 && u((t) => [...t, ...e]);
 			}
 		};
 		return document.addEventListener("dragenter", t), document.addEventListener("dragleave", n), document.addEventListener("dragover", r), document.addEventListener("drop", i), () => {

package/utils.d.ts

@@ -1,7 +1,7 @@
-import { DeploymentCreationFormLocaleEntry } from '@epam/ai-dial-builder-form';
-import { DeploymentCreationFormLocaleOption } from '@epam/ai-dial-builder-form';
 import { ExportFolder } from '@epam/ai-dial-chat-shared';
+import { LocaleOption } from '@epam/ai-dial-chat-shared';
 import { LocaleTextEntryDto } from '@epam/ai-dial-chat-api-client';
+import { LocalizedTextEntry } from '@epam/ai-dial-chat-shared';
 import { Middleware } from '@epam/ai-dial-chat-api-client';
 import { PromptFolderResponseDto } from '@epam/ai-dial-chat-api-client';
 import { PromptListResponseDto } from '@epam/ai-dial-chat-api-client';
@@ -10,6 +10,8 @@ import { UserLimitStatsResponseDto } from '@epam/ai-dial-chat-api-client';
 
 /** Normalized shape returned by {@link getApiErrorDetails}. */
 export declare interface ApiErrorDetails {
+    /** Stable domain error code supplied by the API, when present. */
+    code?: string;
     /** HTTP status code carried by the error, when available. */
     status?: number;
     /** Resolved human-readable error message, or `null` when none could be resolved. */
@@ -29,7 +31,7 @@ export declare const apSchedulerDayToJsDay: (apSchedulerDay: number) => number;
  * `additionalLocaleCodes` and excluding whichever code is already the
  * primary Name/Description field.
  */
-export declare const buildAdditionalLocaleOptions: (additionalLocaleCodes: string[], primaryLocale: string) => DeploymentCreationFormLocaleOption[];
+export declare const buildAdditionalLocaleOptions: (additionalLocaleCodes: string[], primaryLocale: string) => LocaleOption[];
 
 /** Reconstructs the exact scope id Core expects as `ResourceSignInRequest`/`ResourceSignOutRequest`'s `url` field. */
 export declare const buildExternalServiceScopeId: (appId: string, serviceName: string) => string;
@@ -52,7 +54,7 @@ export declare const buildPromptPath: (folderId: string, name: string) => string
  * `undefined` (not `[]`) when nothing remains, so a request untouched by
  * this feature stays byte-identical to today.
  */
-export declare const composeLocalePayload: (otherLocales: DeploymentCreationFormLocaleEntry[], primaryLocale: string) => LocaleTextEntryDto[] | undefined;
+export declare const composeLocalePayload: (otherLocales: LocalizedTextEntry[], primaryLocale: string) => LocaleTextEntryDto[] | undefined;
 
 /**
  * Builds a generated-client `Middleware` that attaches `X-CSRF-Token` on every
@@ -113,7 +115,7 @@ export declare type CsrfRefreshOutcome = {
  * present in either map, excluding `primaryLocale` — that key is already the
  * primary Name/Description field, not a row in the popup.
  */
-export declare const decomposeLocalizedFields: (displayName: LocalizedText | undefined, description: LocalizedText | undefined, primaryLocale: string) => DeploymentCreationFormLocaleEntry[];
+export declare const decomposeLocalizedFields: (displayName: LocalizedText | undefined, description: LocalizedText | undefined, primaryLocale: string) => LocalizedTextEntry[];
 
 /** A prompt record as it appears inside a downloaded prompt file. */
 export declare interface ExportedPrompt {
@@ -132,7 +134,7 @@ export declare interface ExportedPrompt {
 /** Formats a Unix timestamp (ms) as a locale-formatted calendar date, e.g. `'22/7/2026'`. */
 export declare const formatCalendarDate: (timestampMs: number) => string;
 
-/** Normalizes any API error into a `{ status?, message, traceId? }` shape. */
+/** Normalizes any API error into a `{ status?, message, traceId?, code? }` shape. */
 export declare const getApiErrorDetails: (error: unknown) => Promise<ApiErrorDetails>;
 
 /** Resolves a human-readable message from an API error's response body, or falls back to `Error.message`. */