mirror of
https://github.com/morluto/rea.git
synced 2026-11-16 19:53:50 +00:00
* refactor(domain): bound a first batch of constant-maximum slices with boundedList * fix(domain): describe a bounded list with nothing retained without a leading separator * refactor(domain): bound eleven counted list samples through boundedList (#11421) Desktop state differences, guidance subsection pointers, native output contract issues, APK v1 duplicate-name samples, environment write refusals, desktop build action logs and credential-named saved-value pointers already reported a count or a cut beside a sliced list; the slice and the count now come from one boundedList. constant-maximum-slice: 54 -> 43.
95 lines
3.1 KiB
TypeScript
95 lines
3.1 KiB
TypeScript
import { boundedList } from "../boundedList.js";
|
|
import { z } from "zod";
|
|
import { err, type Result } from "../result.js";
|
|
import { AnalysisOutputError } from "../analysisErrorCore.js";
|
|
import type { JsonValue } from "../jsonValue.js";
|
|
|
|
/** Issues kept per refusal; the count still reports every issue. */
|
|
const MAX_CONTRACT_ISSUES = 16;
|
|
|
|
const jsonKind = (value: unknown): string =>
|
|
value === null
|
|
? "null"
|
|
: Array.isArray(value)
|
|
? "array"
|
|
: value === undefined
|
|
? "missing"
|
|
: typeof value;
|
|
|
|
const valueAt = (value: unknown, path: readonly PropertyKey[]): unknown => {
|
|
let current = value;
|
|
for (const key of path) {
|
|
if (typeof current !== "object" || current === null) return undefined;
|
|
if (typeof key === "symbol") return undefined;
|
|
current = (current as Record<string | number, unknown>)[key];
|
|
}
|
|
return current;
|
|
};
|
|
|
|
interface LocatedIssue {
|
|
readonly issue: z.core.$ZodIssue;
|
|
readonly path: readonly PropertyKey[];
|
|
/** The union option index chosen at each enclosing failed union. */
|
|
readonly branches: readonly number[];
|
|
}
|
|
|
|
/**
|
|
* Replace each failed union with the issues of every option it tried, located
|
|
* at their full path, so a nested field failure stays named.
|
|
*/
|
|
const locatedIssues = (
|
|
issues: readonly z.core.$ZodIssue[],
|
|
prefix: readonly PropertyKey[] = [],
|
|
branches: readonly number[] = [],
|
|
): LocatedIssue[] =>
|
|
issues.flatMap((issue) => {
|
|
const path = [...prefix, ...issue.path];
|
|
return issue.code === "invalid_union" && issue.errors.length > 0
|
|
? issue.errors.flatMap((option, index) =>
|
|
locatedIssues(option, path, [...branches, index]),
|
|
)
|
|
: [{ issue, path, branches }];
|
|
});
|
|
|
|
/**
|
|
* Name the fields a provider reply failed its contract on. Each issue carries
|
|
* only its field path, Zod issue code, the expected kind and the observed JSON
|
|
* kind, never reported text, so the diagnostic is safe to return to callers.
|
|
* Issues inside a failed union carry the option index at each union level.
|
|
*/
|
|
export const outputContractDiagnostics = (
|
|
cause: z.ZodError,
|
|
value?: unknown,
|
|
): Readonly<Record<string, JsonValue>> => {
|
|
const located = boundedList(locatedIssues(cause.issues), MAX_CONTRACT_ISSUES);
|
|
return {
|
|
contract_issue_count: located.items.length + located.omitted,
|
|
contract_issues: located.items.map(({ issue, path, branches }) => ({
|
|
path: path.map((key) => (typeof key === "number" ? key : String(key))),
|
|
code: issue.code,
|
|
...(branches.length === 0 ? {} : { union_branches: [...branches] }),
|
|
...(issue.code === "invalid_type"
|
|
? {
|
|
expected: issue.expected,
|
|
...(value === undefined
|
|
? {}
|
|
: { received: jsonKind(valueAt(value, path)) }),
|
|
}
|
|
: {}),
|
|
})),
|
|
};
|
|
};
|
|
|
|
export const invalidNativeOutput = <T>(
|
|
operation: string,
|
|
expected: string,
|
|
cause: z.ZodError,
|
|
): Result<T, AnalysisOutputError> =>
|
|
err(
|
|
new AnalysisOutputError(
|
|
operation,
|
|
`Provider returned an invalid ${expected}`,
|
|
{ cause, diagnostics: outputContractDiagnostics(cause) },
|
|
),
|
|
);
|