@epam/ai-dial-chat-hooks 1.2.0-dev.99 → 1.3.0-dev.5

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,12 +10,24 @@ 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. */
     message: string | null;
     /** Extracted W3C trace ID, when the error's response carries a valid `traceparent`. */
     traceId?: string;
+    /**
+     * Error code reported by the service behind the API, when the API forwards one
+     * (`upstreamCode`). Passed through as-is; the host decides whether to act on it.
+     */
+    upstreamCode?: string;
+    /**
+     * Error reason reported by the service behind the API, when the API forwards one
+     * (`upstreamMessage`). Untranslated; the host decides whether to display it.
+     */
+    upstreamMessage?: string;
 }
 
 /** Appends a locale's uppercased code to a field label, e.g. `'Name [EN]'`. */
@@ -29,7 +41,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 +64,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 +125,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 +144,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?, upstreamCode?, upstreamMessage? }` 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`. */
@@ -162,6 +174,9 @@ export declare const getExternalServiceFallbackName: (serviceName: string) => st
  */
 export declare const getRemainingCharacters: (value: string, maxLength: number) => number | null;
 
+/** Returns the schemas that create schema-based apps: unique by id, without id-less entries or the custom-app schema. */
+export declare const getRunnerSchemas: <T extends QuickAppSchemaLike>(schemas: T[]) => RunnerSchema<T>[];
+
 /** Case-insensitive substring match. */
 export declare const includesIgnoreCase: (str: string, query: string) => boolean;
 
@@ -285,6 +300,11 @@ export declare interface QuickAppSchemaLike {
  */
 export declare const resolveLocalizedText: (value: LocalizedText | undefined | null, activeLocale: string, primaryLocale: string) => string;
 
+/** An application schema with a resolved id, as returned by {@link getRunnerSchemas}. */
+export declare type RunnerSchema<T extends QuickAppSchemaLike> = T & {
+    id: string;
+};
+
 /** Decodes a URI-encoded path segment, returning the original string if decoding fails. */
 export declare const safeDecodeURI: (path: string) => string;
 

package/utils.js

@@ -5,13 +5,13 @@ import { includesIgnoreCase as o, safeDecodeURI as s, safeDecodeURIComponent as
 import { appendLocaleCode as d, buildAdditionalLocaleOptions as f, composeLocalePayload as p, decomposeLocalizedFields as m, resolveLocalizedText as h, toBaseLocale as g } from "./shared/locale.js";
 import { formatCalendarDate as _, padTwoDigits as v } from "./shared/formatting.js";
 import { PromptSource as y, parsePromptResourceUrl as b } from "./prompt/prompt-resource.js";
-import { buildPromptExportEnvelope as x, buildPromptExportFileName as S, serializePromptExport as C } from "./prompt/export-prompt.js";
-import { PROMPT_CONTENT_MAX_LENGTH as w, PROMPT_COUNTER_ANNOUNCE_THRESHOLD as T, PROMPT_DESCRIPTION_MAX_LENGTH as E, PROMPT_NAME_MAX_LENGTH as D, PromptFieldError as O, buildPromptPath as k, getRemainingCharacters as A, validatePromptContent as j, validatePromptDescription as M, validatePromptName as N } from "./prompt/prompt.js";
-import { usePromptsState as P } from "./prompt/usePromptsState/usePromptsState.js";
-import { apSchedulerDayToJsDay as F, jsDayToApSchedulerDay as I } from "./shared/cron-weekday.js";
-import { isCustomAppSchema as L, isQuickAppSchema as R } from "./shared/application-schema.js";
-import { getBrowserTimezone as z } from "./shared/browser-timezone.js";
-import { isValidAbsoluteUrl as B, isValidFeaturesData as V, parseFeaturesData as H } from "./shared/custom-apps.js";
-import { buildExternalServiceScopeId as U, getExternalServiceFallbackName as W, parseExternalServiceUrl as G } from "./shared/external-services.js";
-import { useUsageData as K } from "./usage/useUsageData/useUsageData.js";
-export { w as PROMPT_CONTENT_MAX_LENGTH, T as PROMPT_COUNTER_ANNOUNCE_THRESHOLD, E as PROMPT_DESCRIPTION_MAX_LENGTH, D as PROMPT_NAME_MAX_LENGTH, O as PromptFieldError, y as PromptSource, F as apSchedulerDayToJsDay, d as appendLocaleCode, f as buildAdditionalLocaleOptions, U as buildExternalServiceScopeId, x as buildPromptExportEnvelope, S as buildPromptExportFileName, k as buildPromptPath, p as composeLocalePayload, i as createCsrfMiddleware, a as createUnauthorizedMiddleware, m as decomposeLocalizedFields, _ as formatCalendarDate, e as getApiErrorDetails, t as getApiErrorMessage, n as getApiErrorStatus, z as getBrowserTimezone, W as getExternalServiceFallbackName, A as getRemainingCharacters, o as includesIgnoreCase, r as isConversationNotFoundError, L as isCustomAppSchema, R as isQuickAppSchema, B as isValidAbsoluteUrl, V as isValidFeaturesData, I as jsDayToApSchedulerDay, v as padTwoDigits, G as parseExternalServiceUrl, H as parseFeaturesData, b as parsePromptResourceUrl, h as resolveLocalizedText, s as safeDecodeURI, c as safeDecodeURIComponent, C as serializePromptExport, l as stripSurroundingSlashes, u as stripTrailingSlashes, g as toBaseLocale, P as usePromptsState, K as useUsageData, j as validatePromptContent, M as validatePromptDescription, N as validatePromptName };
+import { getRunnerSchemas as x, isCustomAppSchema as S, isQuickAppSchema as C } from "./shared/application-schema.js";
+import { buildPromptExportEnvelope as w, buildPromptExportFileName as T, serializePromptExport as E } from "./prompt/export-prompt.js";
+import { PROMPT_CONTENT_MAX_LENGTH as D, PROMPT_COUNTER_ANNOUNCE_THRESHOLD as O, PROMPT_DESCRIPTION_MAX_LENGTH as k, PROMPT_NAME_MAX_LENGTH as A, PromptFieldError as j, buildPromptPath as M, getRemainingCharacters as N, validatePromptContent as P, validatePromptDescription as F, validatePromptName as I } from "./prompt/prompt.js";
+import { usePromptsState as L } from "./prompt/usePromptsState/usePromptsState.js";
+import { apSchedulerDayToJsDay as R, jsDayToApSchedulerDay as z } from "./shared/cron-weekday.js";
+import { getBrowserTimezone as B } from "./shared/browser-timezone.js";
+import { isValidAbsoluteUrl as V, isValidFeaturesData as H, parseFeaturesData as U } from "./shared/custom-apps.js";
+import { buildExternalServiceScopeId as W, getExternalServiceFallbackName as G, parseExternalServiceUrl as K } from "./shared/external-services.js";
+import { useUsageData as q } from "./usage/useUsageData/useUsageData.js";
+export { D as PROMPT_CONTENT_MAX_LENGTH, O as PROMPT_COUNTER_ANNOUNCE_THRESHOLD, k as PROMPT_DESCRIPTION_MAX_LENGTH, A as PROMPT_NAME_MAX_LENGTH, j as PromptFieldError, y as PromptSource, R as apSchedulerDayToJsDay, d as appendLocaleCode, f as buildAdditionalLocaleOptions, W as buildExternalServiceScopeId, w as buildPromptExportEnvelope, T as buildPromptExportFileName, M as buildPromptPath, p as composeLocalePayload, i as createCsrfMiddleware, a as createUnauthorizedMiddleware, m as decomposeLocalizedFields, _ as formatCalendarDate, e as getApiErrorDetails, t as getApiErrorMessage, n as getApiErrorStatus, B as getBrowserTimezone, G as getExternalServiceFallbackName, N as getRemainingCharacters, x as getRunnerSchemas, o as includesIgnoreCase, r as isConversationNotFoundError, S as isCustomAppSchema, C as isQuickAppSchema, V as isValidAbsoluteUrl, H as isValidFeaturesData, z as jsDayToApSchedulerDay, v as padTwoDigits, K as parseExternalServiceUrl, U as parseFeaturesData, b as parsePromptResourceUrl, h as resolveLocalizedText, s as safeDecodeURI, c as safeDecodeURIComponent, E as serializePromptExport, l as stripSurroundingSlashes, u as stripTrailingSlashes, g as toBaseLocale, L as usePromptsState, q as useUsageData, P as validatePromptContent, F as validatePromptDescription, I as validatePromptName };