@smart-cloud/ai-kit-ui 1.5.2 → 1.5.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/ShadowBoundary.d.ts +1 -1
- package/dist/ai-feature/AiFeatureBorder.d.ts +1 -1
- package/dist/ai-feature/ProofreadDiff.d.ts +1 -1
- package/dist/ai-kit-ui.css +31 -4
- package/dist/errorHandling.d.ts +21 -0
- package/dist/index.cjs +9 -9
- package/dist/index.d.ts +1 -0
- package/dist/index.js +9 -9
- package/dist/useAiRun.d.ts +2 -0
- package/package.json +40 -19
- package/src/ai-chatbot/AiChatbot.tsx +6 -2
- package/src/ai-feature/AiFeature.tsx +38 -23
- package/src/doc-search/DocSearch.tsx +44 -27
- package/src/errorHandling.ts +258 -0
- package/src/i18n/en.ts +15 -0
- package/src/i18n/hu.ts +15 -0
- package/src/index.tsx +1 -0
- package/src/styles/ai-kit-ui.css +31 -4
- package/src/useAiRun.ts +23 -29
- package/tests/error-handling.test.ts +82 -0
package/src/i18n/hu.ts
CHANGED
|
@@ -178,6 +178,21 @@ export const huDict: Record<string, string> = {
|
|
|
178
178
|
shorter: "rövidebb",
|
|
179
179
|
Show: "Mutat",
|
|
180
180
|
"Something went wrong.": "Valami baj történt.",
|
|
181
|
+
"Something went wrong. Please try again.":
|
|
182
|
+
"Valami baj történt. Próbáld újra.",
|
|
183
|
+
"We couldn't verify that you're human. Please try again.":
|
|
184
|
+
"Nem sikerült az emberi felhasználót ellenőrizni. Próbáld újra.",
|
|
185
|
+
"You are not authorized to use this AI feature. Please sign in or contact the site owner.":
|
|
186
|
+
"Nincs jogosultságod ehhez az AI-funkcióhoz. Jelentkezz be, vagy fordulj a webhely gazdájához.",
|
|
187
|
+
"Too many requests. Please wait a moment and try again.":
|
|
188
|
+
"Túl sok kérés érkezett. Várj egy kicsit, majd próbáld újra.",
|
|
189
|
+
"The request could not be processed. Review your input and try again.":
|
|
190
|
+
"A kérést nem sikerült feldolgozni. Ellenőrizd a bevitt adatokat, majd próbáld újra.",
|
|
191
|
+
"We couldn't reach the AI service. Check your connection and try again.":
|
|
192
|
+
"Az AI-szolgáltatás nem érhető el. Ellenőrizd a kapcsolatot, majd próbáld újra.",
|
|
193
|
+
"The AI service is temporarily unavailable. Please try again.":
|
|
194
|
+
"Az AI-szolgáltatás átmenetileg nem érhető el. Próbáld újra.",
|
|
195
|
+
"Request ID": "Kérésazonosító",
|
|
181
196
|
Sources: "Források",
|
|
182
197
|
Spanish: "spanyol",
|
|
183
198
|
Stop: "Stop",
|
package/src/index.tsx
CHANGED
package/src/styles/ai-kit-ui.css
CHANGED
|
@@ -49,6 +49,11 @@
|
|
|
49
49
|
/* Useful “bridge” vars */
|
|
50
50
|
--ai-kit-button-padding-x: var(--button-padding-x, 12px);
|
|
51
51
|
--ai-kit-input-padding-x: var(--input-padding-x, 12px);
|
|
52
|
+
--ai-kit-action-transition:
|
|
53
|
+
background-color 160ms ease, border-color 160ms ease, color 160ms ease,
|
|
54
|
+
box-shadow 160ms ease, opacity 160ms ease, transform 160ms ease;
|
|
55
|
+
--ai-kit-action-focus-ring: var(--mantine-primary-color-filled, #1c7ed6);
|
|
56
|
+
--ai-kit-action-disabled-opacity: 0.6;
|
|
52
57
|
|
|
53
58
|
/* ---------------------------
|
|
54
59
|
1) Semantic color tokens
|
|
@@ -359,6 +364,31 @@
|
|
|
359
364
|
min-width: var(--ai-kit-actions-button-min-width, 140px);
|
|
360
365
|
}
|
|
361
366
|
|
|
367
|
+
/* Leave action colors to Mantine's resolved primary palette and the shared
|
|
368
|
+
WP Suite Theme CSS; this layer only standardizes interaction states. */
|
|
369
|
+
.ai-feature-root .mantine-Button-root,
|
|
370
|
+
.doc-search-root .mantine-Button-root,
|
|
371
|
+
.ai-docs-ask .mantine-Button-root,
|
|
372
|
+
.ai-docs-ask .mantine-ActionIcon-root {
|
|
373
|
+
transition: var(--ai-kit-action-transition);
|
|
374
|
+
}
|
|
375
|
+
|
|
376
|
+
.ai-feature-root .mantine-Button-root:focus-visible,
|
|
377
|
+
.doc-search-root .mantine-Button-root:focus-visible,
|
|
378
|
+
.ai-docs-ask .mantine-Button-root:focus-visible,
|
|
379
|
+
.ai-docs-ask .mantine-ActionIcon-root:focus-visible {
|
|
380
|
+
outline: 2px solid var(--ai-kit-action-focus-ring);
|
|
381
|
+
outline-offset: 2px;
|
|
382
|
+
}
|
|
383
|
+
|
|
384
|
+
.ai-feature-root .mantine-Button-root:disabled,
|
|
385
|
+
.doc-search-root .mantine-Button-root:disabled,
|
|
386
|
+
.ai-docs-ask .mantine-Button-root:disabled,
|
|
387
|
+
.ai-docs-ask .mantine-ActionIcon-root:disabled {
|
|
388
|
+
cursor: not-allowed;
|
|
389
|
+
opacity: var(--ai-kit-action-disabled-opacity);
|
|
390
|
+
}
|
|
391
|
+
|
|
362
392
|
@media (max-width: var(--ai-kit-actions-breakpoint, 520px)) {
|
|
363
393
|
.ai-kit-actions {
|
|
364
394
|
flex-direction: column;
|
|
@@ -463,10 +493,7 @@
|
|
|
463
493
|
gap: 2px;
|
|
464
494
|
|
|
465
495
|
box-shadow: var(--ai-kit-launcher-shadow);
|
|
466
|
-
transition:
|
|
467
|
-
transform 0.2s ease,
|
|
468
|
-
box-shadow 0.2s ease,
|
|
469
|
-
background 0.2s ease;
|
|
496
|
+
transition: var(--ai-kit-action-transition);
|
|
470
497
|
|
|
471
498
|
padding: var(--ai-kit-space-3);
|
|
472
499
|
pointer-events: auto;
|
package/src/useAiRun.ts
CHANGED
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
import { ApiError } from "@aws-amplify/api";
|
|
2
1
|
import {
|
|
3
2
|
AiKitLanguageCode,
|
|
4
3
|
AiKitPlugin,
|
|
@@ -9,11 +8,20 @@ import {
|
|
|
9
8
|
type AiKitStatusEvent,
|
|
10
9
|
} from "@smart-cloud/ai-kit-core";
|
|
11
10
|
import { getWpSuite } from "@smart-cloud/wpsuite-core";
|
|
11
|
+
import { I18n } from "aws-amplify/utils";
|
|
12
12
|
import { useCallback, useRef, useState } from "react";
|
|
13
|
+
import {
|
|
14
|
+
AiRunError,
|
|
15
|
+
type AiRunErrorDetails,
|
|
16
|
+
clearAiRunErrorFeedback,
|
|
17
|
+
createAiRunErrorFeedback,
|
|
18
|
+
isAiRunAbort,
|
|
19
|
+
} from "./errorHandling";
|
|
13
20
|
|
|
14
21
|
export type AiRunState<T> = {
|
|
15
22
|
busy: boolean;
|
|
16
23
|
error: string | null;
|
|
24
|
+
errorDetails: AiRunErrorDetails | null;
|
|
17
25
|
statusEvent: AiKitStatusEvent | null;
|
|
18
26
|
result: T | null;
|
|
19
27
|
isCancelled: boolean;
|
|
@@ -34,27 +42,6 @@ export type UseAiRunResult<T> = AiRunState<T> & {
|
|
|
34
42
|
signal: AbortSignal | null;
|
|
35
43
|
};
|
|
36
44
|
|
|
37
|
-
function getErrorMessage(err: unknown): string {
|
|
38
|
-
if ((err as ApiError)?.response?.body) {
|
|
39
|
-
try {
|
|
40
|
-
return JSON.parse((err as ApiError)!.response!.body!).message;
|
|
41
|
-
} catch {
|
|
42
|
-
/* empty */
|
|
43
|
-
}
|
|
44
|
-
}
|
|
45
|
-
if (err instanceof Error) {
|
|
46
|
-
return err.message;
|
|
47
|
-
}
|
|
48
|
-
if (typeof err === "string") {
|
|
49
|
-
return err;
|
|
50
|
-
}
|
|
51
|
-
try {
|
|
52
|
-
return JSON.stringify(err);
|
|
53
|
-
} catch {
|
|
54
|
-
return "Unknown error";
|
|
55
|
-
}
|
|
56
|
-
}
|
|
57
|
-
|
|
58
45
|
/**
|
|
59
46
|
* Returns true if backend routing is configured in the current AiKit settings.
|
|
60
47
|
*
|
|
@@ -102,7 +89,7 @@ export function useAiRun<T>(): UseAiRunResult<T> {
|
|
|
102
89
|
const lastSourceRef = useRef<"on-device" | "backend" | null>(null);
|
|
103
90
|
|
|
104
91
|
const [busy, setBusy] = useState(false);
|
|
105
|
-
const [
|
|
92
|
+
const [errorFeedback, setErrorFeedback] = useState(clearAiRunErrorFeedback);
|
|
106
93
|
const [statusEvent, setStatusEvent] = useState<AiKitStatusEvent | null>(null);
|
|
107
94
|
const [result, setResult] = useState<T | null>(null);
|
|
108
95
|
const [isCancelled, setIsCancelled] = useState(false);
|
|
@@ -118,7 +105,7 @@ export function useAiRun<T>(): UseAiRunResult<T> {
|
|
|
118
105
|
ctrlRef.current?.abort();
|
|
119
106
|
ctrlRef.current = null;
|
|
120
107
|
setBusy(false);
|
|
121
|
-
|
|
108
|
+
setErrorFeedback(clearAiRunErrorFeedback());
|
|
122
109
|
setStatusEvent(null);
|
|
123
110
|
setResult(null);
|
|
124
111
|
setIsCancelled(false);
|
|
@@ -135,7 +122,7 @@ export function useAiRun<T>(): UseAiRunResult<T> {
|
|
|
135
122
|
ctrlRef.current = ctrl;
|
|
136
123
|
|
|
137
124
|
setBusy(true);
|
|
138
|
-
|
|
125
|
+
setErrorFeedback(clearAiRunErrorFeedback());
|
|
139
126
|
setStatusEvent(null);
|
|
140
127
|
setResult(null);
|
|
141
128
|
setIsCancelled(false);
|
|
@@ -156,12 +143,18 @@ export function useAiRun<T>(): UseAiRunResult<T> {
|
|
|
156
143
|
setResult(value);
|
|
157
144
|
return value;
|
|
158
145
|
} catch (err) {
|
|
159
|
-
if (ctrl.signal.aborted) {
|
|
146
|
+
if (ctrl.signal.aborted || isAiRunAbort(err)) {
|
|
160
147
|
setIsCancelled(true);
|
|
161
|
-
|
|
148
|
+
setErrorFeedback(clearAiRunErrorFeedback());
|
|
162
149
|
return null;
|
|
163
150
|
}
|
|
164
|
-
|
|
151
|
+
const feedback = createAiRunErrorFeedback(err, (message) =>
|
|
152
|
+
I18n.get(message),
|
|
153
|
+
);
|
|
154
|
+
setErrorFeedback(feedback);
|
|
155
|
+
throw new AiRunError(feedback.details!, feedback.message!, {
|
|
156
|
+
cause: err,
|
|
157
|
+
});
|
|
165
158
|
} finally {
|
|
166
159
|
setBusy(false);
|
|
167
160
|
setStatusEvent(null);
|
|
@@ -175,7 +168,8 @@ export function useAiRun<T>(): UseAiRunResult<T> {
|
|
|
175
168
|
|
|
176
169
|
return {
|
|
177
170
|
busy,
|
|
178
|
-
error,
|
|
171
|
+
error: errorFeedback.message,
|
|
172
|
+
errorDetails: errorFeedback.details,
|
|
179
173
|
statusEvent,
|
|
180
174
|
result,
|
|
181
175
|
isCancelled,
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import assert from "node:assert/strict";
|
|
2
|
+
import test from "node:test";
|
|
3
|
+
|
|
4
|
+
import {
|
|
5
|
+
clearAiRunErrorFeedback,
|
|
6
|
+
createAiRunErrorFeedback,
|
|
7
|
+
getAiRunErrorMessage,
|
|
8
|
+
normalizeAiRunError,
|
|
9
|
+
} from "../src/errorHandling.ts";
|
|
10
|
+
|
|
11
|
+
function backendError(status: number, body: Record<string, unknown>) {
|
|
12
|
+
return {
|
|
13
|
+
name: "ApiError",
|
|
14
|
+
message: `Backend request failed: ${JSON.stringify(body)}`,
|
|
15
|
+
response: {
|
|
16
|
+
statusCode: status,
|
|
17
|
+
body: JSON.stringify(body),
|
|
18
|
+
headers: { "x-request-id": body.requestId },
|
|
19
|
+
},
|
|
20
|
+
};
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
test("normalizes reCAPTCHA rejection without exposing request data", () => {
|
|
24
|
+
const details = normalizeAiRunError(
|
|
25
|
+
backendError(403, {
|
|
26
|
+
code: "HUMAN_VERIFICATION_ERROR",
|
|
27
|
+
message: "Assessment rejected",
|
|
28
|
+
requestId: "req-human-1",
|
|
29
|
+
token: "must-not-leak",
|
|
30
|
+
}),
|
|
31
|
+
);
|
|
32
|
+
|
|
33
|
+
assert.deepEqual(details, {
|
|
34
|
+
kind: "human-verification",
|
|
35
|
+
status: 403,
|
|
36
|
+
code: "HUMAN_VERIFICATION_ERROR",
|
|
37
|
+
safeMessage: "Assessment rejected",
|
|
38
|
+
requestId: "req-human-1",
|
|
39
|
+
});
|
|
40
|
+
assert.equal(
|
|
41
|
+
getAiRunErrorMessage(details),
|
|
42
|
+
"We couldn't verify that you're human. Please try again.",
|
|
43
|
+
);
|
|
44
|
+
assert.doesNotMatch(JSON.stringify(details), /must-not-leak/);
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
test("distinguishes authorization, throttling, network, and backend failures", () => {
|
|
48
|
+
assert.equal(
|
|
49
|
+
normalizeAiRunError(backendError(401, { code: "UNAUTHORIZED" })).kind,
|
|
50
|
+
"authorization",
|
|
51
|
+
);
|
|
52
|
+
assert.equal(
|
|
53
|
+
normalizeAiRunError(backendError(429, { code: "THROTTLED" })).kind,
|
|
54
|
+
"throttled",
|
|
55
|
+
);
|
|
56
|
+
assert.equal(
|
|
57
|
+
normalizeAiRunError(new TypeError("Failed to fetch")).kind,
|
|
58
|
+
"network",
|
|
59
|
+
);
|
|
60
|
+
assert.equal(
|
|
61
|
+
normalizeAiRunError(backendError(503, { code: "UPSTREAM_ERROR" })).kind,
|
|
62
|
+
"server",
|
|
63
|
+
);
|
|
64
|
+
});
|
|
65
|
+
|
|
66
|
+
test("treats intentional cancellation as non-error feedback", () => {
|
|
67
|
+
const feedback = createAiRunErrorFeedback(
|
|
68
|
+
new DOMException("Aborted", "AbortError"),
|
|
69
|
+
);
|
|
70
|
+
assert.equal(feedback.details?.kind, "cancelled");
|
|
71
|
+
assert.equal(feedback.message, null);
|
|
72
|
+
});
|
|
73
|
+
|
|
74
|
+
test("beginning a successful retry clears stale error feedback", () => {
|
|
75
|
+
const failed = createAiRunErrorFeedback(
|
|
76
|
+
backendError(429, { code: "THROTTLED" }),
|
|
77
|
+
);
|
|
78
|
+
assert.equal(failed.details?.kind, "throttled");
|
|
79
|
+
|
|
80
|
+
const retry = clearAiRunErrorFeedback();
|
|
81
|
+
assert.deepEqual(retry, { message: null, details: null });
|
|
82
|
+
});
|