@codewithagents/api-errors 1.0.6 → 1.2.0

package/dist/index.d.ts

@@ -1,9 +1,27 @@
+export type { FieldError, ParsedErrors, ErrorFormat, CustomParser } from './parsers/types.js';
+import type { FieldError, ErrorFormat, CustomParser } from './parsers/types.js';
 /**
- * Normalized representation of a single field-level error.
+ * Rich result returned by `extractErrors`.
  */
-export interface FieldError {
-    field: string;
-    message: string;
+export interface ExtractResult {
+    /**
+     * Field-level errors extracted from the response body.
+     */
+    fieldErrors: FieldError[];
+    /**
+     * Non-field (global/form-level) error messages.
+     * These are messages that could not be attributed to a specific field,
+     * such as RFC 9457 `detail`, JSON:API errors without a source pointer,
+     * or violations/invalid-params entries without a field name.
+     */
+    formErrors: string[];
+    /**
+     * The format that was recognized.
+     * `null` when no supported format matched (both `fieldErrors` and `formErrors` are empty).
+     *
+     * Use this to distinguish "unrecognized shape" from "recognized but genuinely no errors".
+     */
+    format: ErrorFormat | null;
 }
 /**
  * Options for mapApiErrors and extractFieldErrors.
@@ -17,7 +35,7 @@ export interface MapApiErrorsOptions {
     /**
      * Optional transform applied to every field name before it is returned.
      * Useful for mapping backend camelCase field names to nested React Hook Form
-     * paths, e.g. `"addressCity"` → `"address.city"`.
+     * paths, e.g. `"addressCity"` to `"address.city"`.
      */
     transformField?: (field: string) => string;
     /**
@@ -32,19 +50,68 @@ export interface MapApiErrorsOptions {
      * extractFieldErrors(err, { statusCodes: [422] })
      */
     statusCodes?: number[];
+    /**
+     * Optional message resolver / i18n hook.
+     * Called for every error message (both field errors and form errors) before
+     * the message is included in the result. Return a replacement string to
+     * translate or reformat the message.
+     *
+     * `field` is `null` for global/form-level errors.
+     *
+     * @example
+     * resolveMessage: (msg, field) => t(`errors.${msg}`) ?? msg
+     */
+    resolveMessage?: (message: string, field: string | null) => string;
+    /**
+     * Custom parsers to try before the built-in parsers.
+     * Parsers are tried in order; the first one that returns a non-null result wins.
+     * Return `null` to indicate "not recognized by this parser".
+     *
+     * Custom parsers receive the already-unwrapped body (after ApiError / Axios
+     * unwrapping), so they do not need to re-implement body unwrapping.
+     */
+    parsers?: ReadonlyArray<CustomParser>;
 }
+/**
+ * Extract errors from an unknown API error response, returning a rich result
+ * that includes field errors, form-level (non-field) errors, and the matched format.
+ *
+ * Use `format` to distinguish "unrecognized shape" (format is null) from
+ * "recognized but genuinely no errors" (format is non-null, both arrays empty).
+ *
+ * `formErrors` contains global / non-field error messages that cannot be
+ * attributed to a specific field (e.g. RFC 9457 `detail`, JSON:API errors
+ * without a source pointer, violations without a field name).
+ *
+ * Supports all formats recognized by `extractFieldErrors`, plus:
+ * - `violations: [{ field, message }]`
+ * - `"invalid-params": [{ name, reason }]`
+ * - JSON:API `errors: [{ source: { pointer }, detail }]`
+ * - Laravel / DRF top-level field map `{ field: ["msg", ...] }`
+ *
+ * Use `options.parsers` to register custom parsers for application-specific shapes.
+ *
+ * Never throws.
+ */
+export declare function extractErrors(error: unknown, options?: MapApiErrorsOptions): ExtractResult;
 /**
  * Extract normalized field errors from an unknown API error response.
  *
  * Supports:
  * - RFC 7807 / RFC 9457 Problem Details (Spring Boot 3+) with `errors` map
  * - RFC 9457 top-level `detail` field as a root-level error
+ * - RFC 9457 `violations: [{ field, message }]` array
+ * - RFC 9457 `"invalid-params": [{ name, reason }]` array
+ * - JSON:API `errors: [{ source: { pointer }, detail }]` array
+ * - Laravel / DRF top-level field map `{ field: ["msg", ...] }`
  * - Spring Boot default validation format (array of `{ field, defaultMessage }`)
  * - Simple flat `{ field, message }` object
  * - Array of `{ field, message }` objects
  *
- * Use `statusCodes` to restrict extraction to specific HTTP status codes —
- * avoids parsing 404 or 500 bodies as field errors.
+ * Use `statusCodes` to restrict extraction to specific HTTP status codes.
+ *
+ * For a richer result that includes non-field errors and the matched format,
+ * use `extractErrors` instead.
  *
  * Never throws — returns an empty array for unrecognized shapes.
  */
@@ -68,4 +135,63 @@ export declare function mapApiErrors(error: unknown, setError: (field: string, e
     type: string;
     message: string;
 }) => void, options?: MapApiErrorsOptions): void;
+/**
+ * Vanilla (framework-agnostic) adapter.
+ *
+ * Extracts field errors from an unknown API error response and returns a plain
+ * `Record<string, string>` mapping field names to their first error message.
+ * Useful for any custom form library or imperative error handling.
+ *
+ * Only fieldErrors are included. For form-level (global) errors use `extractErrors`.
+ *
+ * @example
+ * ```ts
+ * const record = mapApiErrorsToRecord(error)
+ * // { email: "must not be blank", name: "required" }
+ * ```
+ */
+export declare function mapApiErrorsToRecord(error: unknown, options?: MapApiErrorsOptions): Record<string, string>;
+/**
+ * Formik adapter.
+ *
+ * Extracts field errors from an unknown API error response and calls Formik's
+ * `setErrors` with a `Record<string, string>` of field -> first error message.
+ *
+ * No Formik import is required. The `setErrors` parameter is typed by its
+ * shape only (structural typing).
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await submitForm(values)
+ * } catch (error) {
+ *   mapApiErrorsFormik(error, setErrors)
+ * }
+ * ```
+ */
+export declare function mapApiErrorsFormik(error: unknown, setErrors: (errors: Record<string, string>) => void, options?: MapApiErrorsOptions): void;
+/**
+ * TanStack Form v1 adapter.
+ *
+ * Extracts field errors from an unknown API error response and calls
+ * `form.setFieldMeta` for each field to inject server-side errors into the
+ * form state. The updater function merges errors and errorMap onto the
+ * existing field meta.
+ *
+ * No TanStack Form import is required. The `form` parameter is typed by its
+ * shape only (structural typing), so this adapter works without adding
+ * `@tanstack/form-core` as a dependency.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await form.handleSubmit()
+ * } catch (error) {
+ *   mapApiErrorsTanstack(error, form)
+ * }
+ * ```
+ */
+export declare function mapApiErrorsTanstack(error: unknown, form: {
+    setFieldMeta: (field: string, updater: (meta: any) => any) => void;
+}, options?: MapApiErrorsOptions): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAC1C;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AA8KD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,UAAU,EAAE,CA0E9F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,EAC3E,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CAKN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAC7F,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAM/E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB;;;;;OAKG;IACH,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAC1C;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAA;IAClE;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;CACtC;AA4BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,aAAa,CA2B1F;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,UAAU,EAAE,CAqB9F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,EAC3E,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CAKN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,EACnD,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE;IAAE,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,KAAK,IAAI,CAAA;CAAE,EAC5E,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CASN"}

package/dist/index.js

@@ -1,146 +1,98 @@
+import { finalize } from './parsers/utils.js';
+import { unwrapBody } from './parsers/unwrap.js';
+import { matchBody } from './parsers/dispatch.js';
+import { isObject } from './parsers/utils.js';
 // ---------------------------------------------------------------------------
-// Internal type guards
+// Status filtering helper
 // ---------------------------------------------------------------------------
-function isObject(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function isStringArray(value) {
-    return Array.isArray(value) && value.every((v) => typeof v === 'string');
-}
-// ---------------------------------------------------------------------------
-// Format detectors + parsers
-// ---------------------------------------------------------------------------
-/**
- * RFC 7807 Problem Details (Spring Boot 3+ default):
- * { "errors": { "email": ["must not be blank"], "name": ["too short"] } }
- */
-function tryParseRfc7807(body, fallbackField, transformField) {
-    const { errors } = body;
-    if (!isObject(errors))
-        return null;
-    const result = [];
-    for (const [rawField, messages] of Object.entries(errors)) {
-        const field = transformField(rawField);
-        if (isStringArray(messages)) {
-            for (const message of messages) {
-                result.push({ field, message });
-            }
-        }
-        else if (typeof messages === 'string') {
-            result.push({ field, message: messages });
-        }
-        // null / unknown value shapes are skipped — no partial/garbage errors
-    }
-    return result.length > 0 ? result : null;
-}
-/**
- * Spring Boot default validation format (pre-3):
- * { "errors": [{ "field": "email", "defaultMessage": "must not be blank" }] }
- */
-function tryParseSpringArray(body, fallbackField, transformField) {
-    const { errors } = body;
-    if (!Array.isArray(errors))
-        return null;
-    const result = [];
-    for (const item of errors) {
-        if (!isObject(item))
-            continue;
-        const rawField = typeof item['field'] === 'string' ? item['field'] : fallbackField;
-        const message = typeof item['defaultMessage'] === 'string'
-            ? item['defaultMessage']
-            : typeof item['message'] === 'string'
-                ? item['message']
-                : 'Unknown error';
-        result.push({ field: transformField(rawField), message });
+function extractStatus(error) {
+    if (!isObject(error))
+        return undefined;
+    const e = error;
+    if (typeof e['status'] === 'number')
+        return e['status'];
+    if (isObject(e['response'])) {
+        const r = e['response'];
+        if (typeof r['status'] === 'number')
+            return r['status'];
     }
-    return result.length > 0 ? result : null;
-}
-/**
- * Simple flat object format:
- * { "field": "email", "message": "Invalid email" }
- */
-function tryParseFlatObject(body, fallbackField, transformField) {
-    const rawField = typeof body['field'] === 'string' ? body['field'] : null;
-    const message = typeof body['message'] === 'string' ? body['message'] : null;
-    if (message === null)
-        return null;
-    const field = rawField !== null ? rawField : fallbackField;
-    return [{ field: transformField(field), message }];
+    return undefined;
 }
-/**
- * Array of simple flat objects:
- * [{ "field": "email", "message": "Invalid email" }]
- */
-function tryParseFlatArray(body, fallbackField, transformField) {
-    const result = [];
-    for (const item of body) {
-        if (!isObject(item))
-            continue;
-        const rawField = typeof item['field'] === 'string' ? item['field'] : fallbackField;
-        const message = typeof item['message'] === 'string' ? item['message'] : null;
-        if (message === null)
-            continue;
-        result.push({ field: transformField(rawField), message });
-    }
-    return result.length > 0 ? result : null;
-}
-/**
- * RFC 9457 / RFC 7807 top-level detail field:
- * { "title": "Bad Request", "detail": "Email is already taken.", "status": 422 }
- *
- * Fires as a last-resort fallback when no field-specific errors are found.
- */
-function tryParseRfc9457Detail(body, fallbackField, transformField) {
-    const detail = body['detail'];
-    if (typeof detail !== 'string')
-        return null;
-    return [{ field: transformField(fallbackField), message: detail }];
+/** True when the error's status code is present but not in the allowed list. */
+function isStatusBlocked(error, options) {
+    if (!options?.statusCodes)
+        return false;
+    const status = extractStatus(error);
+    return status !== undefined && !options.statusCodes.includes(status);
 }
 // ---------------------------------------------------------------------------
-// Safety
+// Public API
 // ---------------------------------------------------------------------------
 /**
- * Field-path segments that must never be forwarded to a path-aware setter.
- * A path-aware setter (e.g. React Hook Form's `setError`) splits the field name
- * on `.`/`[]` and walks/creates nested objects, so a malicious field like
- * `__proto__.polluted` from an untrusted error body would otherwise become a
- * prototype-pollution write in the consuming app.
- */
-const FORBIDDEN_FIELD_SEGMENTS = new Set(['__proto__', 'constructor', 'prototype']);
-/**
- * Upper bound on the number of field errors returned. A hostile body with a huge
- * `errors` map or array would otherwise produce an unbounded list (and an equal
- * number of `setError` calls / re-renders downstream).
+ * Extract errors from an unknown API error response, returning a rich result
+ * that includes field errors, form-level (non-field) errors, and the matched format.
+ *
+ * Use `format` to distinguish "unrecognized shape" (format is null) from
+ * "recognized but genuinely no errors" (format is non-null, both arrays empty).
+ *
+ * `formErrors` contains global / non-field error messages that cannot be
+ * attributed to a specific field (e.g. RFC 9457 `detail`, JSON:API errors
+ * without a source pointer, violations without a field name).
+ *
+ * Supports all formats recognized by `extractFieldErrors`, plus:
+ * - `violations: [{ field, message }]`
+ * - `"invalid-params": [{ name, reason }]`
+ * - JSON:API `errors: [{ source: { pointer }, detail }]`
+ * - Laravel / DRF top-level field map `{ field: ["msg", ...] }`
+ *
+ * Use `options.parsers` to register custom parsers for application-specific shapes.
+ *
+ * Never throws.
  */
-const MAX_FIELD_ERRORS = 1000;
-/** True if no path segment of `field` is a prototype-pollution gadget key. */
-function isSafeFieldPath(field) {
-    for (const segment of field.split(/[.[\]]+/)) {
-        if (FORBIDDEN_FIELD_SEGMENTS.has(segment))
-            return false;
+export function extractErrors(error, options) {
+    const fallbackField = options?.fallbackField ?? 'root';
+    const transformField = options?.transformField ?? ((f) => f);
+    const resolveMessage = options?.resolveMessage;
+    try {
+        if (isStatusBlocked(error, options))
+            return { fieldErrors: [], formErrors: [], format: null };
+        const match = matchBody(unwrapBody(error), fallbackField, transformField, options?.parsers);
+        if (match === null)
+            return { fieldErrors: [], formErrors: [], format: null };
+        const { parsed, format } = match;
+        const fieldErrors = finalize(resolveMessage
+            ? parsed.fieldErrors.map((e) => ({
+                field: e.field,
+                message: resolveMessage(e.message, e.field),
+            }))
+            : parsed.fieldErrors);
+        const formErrors = resolveMessage
+            ? parsed.formErrors.map((m) => resolveMessage(m, null))
+            : parsed.formErrors;
+        return { fieldErrors, formErrors, format };
+    }
+    catch {
+        return { fieldErrors: [], formErrors: [], format: null };
     }
-    return true;
-}
-/** Drop unsafe field paths and cap the result before it leaves the library. */
-function finalize(result) {
-    const safe = result.filter((e) => isSafeFieldPath(e.field));
-    return safe.length > MAX_FIELD_ERRORS ? safe.slice(0, MAX_FIELD_ERRORS) : safe;
 }
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
 /**
  * Extract normalized field errors from an unknown API error response.
  *
  * Supports:
  * - RFC 7807 / RFC 9457 Problem Details (Spring Boot 3+) with `errors` map
  * - RFC 9457 top-level `detail` field as a root-level error
+ * - RFC 9457 `violations: [{ field, message }]` array
+ * - RFC 9457 `"invalid-params": [{ name, reason }]` array
+ * - JSON:API `errors: [{ source: { pointer }, detail }]` array
+ * - Laravel / DRF top-level field map `{ field: ["msg", ...] }`
  * - Spring Boot default validation format (array of `{ field, defaultMessage }`)
  * - Simple flat `{ field, message }` object
  * - Array of `{ field, message }` objects
  *
- * Use `statusCodes` to restrict extraction to specific HTTP status codes —
- * avoids parsing 404 or 500 bodies as field errors.
+ * Use `statusCodes` to restrict extraction to specific HTTP status codes.
+ *
+ * For a richer result that includes non-field errors and the matched format,
+ * use `extractErrors` instead.
  *
  * Never throws — returns an empty array for unrecognized shapes.
  */
@@ -148,66 +100,19 @@ export function extractFieldErrors(error, options) {
     const fallbackField = options?.fallbackField ?? 'root';
     const transformField = options?.transformField ?? ((f) => f);
     try {
-        // Status-code filtering: if statusCodes is provided, check error.status
-        // (or error.response.status for Axios-style errors) before doing anything.
-        if (options?.statusCodes !== undefined) {
-            let status;
-            if (isObject(error)) {
-                const e = error;
-                if (typeof e['status'] === 'number') {
-                    status = e['status'];
-                }
-                else if (isObject(e['response'])) {
-                    const r = e['response'];
-                    if (typeof r['status'] === 'number')
-                        status = r['status'];
-                }
-            }
-            if (status !== undefined && !options.statusCodes.includes(status)) {
-                return [];
-            }
-        }
-        // Unwrap common error wrapper shapes (e.g. Axios response, fetch response body)
-        let body = error;
-        // Support ApiError-style wrappers: { status: number, body: unknown }
-        // Matches the ApiError class generated by @codewithagents/openapi-gen, letting
-        // callers pass the thrown error directly: extractFieldErrors(apiError, { statusCodes: [422] })
-        if (isObject(body) &&
-            typeof body['status'] === 'number' &&
-            Object.prototype.hasOwnProperty.call(body, 'body')) {
-            body = body['body'];
-        }
-        // Support objects with a `response.data` shape (Axios-style)
-        if (isObject(body) && isObject(body['response']) && body['response']['data'] !== undefined) {
-            body = body['response']['data'];
-        }
-        // Support objects with a `data` property that contains the actual error body
-        if (isObject(body) && isObject(body['data']) && !('field' in body) && !('errors' in body)) {
-            body = body['data'];
-        }
-        // Array of flat error objects
-        if (Array.isArray(body)) {
-            return finalize(tryParseFlatArray(body, fallbackField, transformField) ?? []);
-        }
-        if (!isObject(body))
+        if (isStatusBlocked(error, options))
             return [];
-        // Try RFC 7807 / Spring Boot 3 format first (object-style errors map)
-        const rfc7807 = tryParseRfc7807(body, fallbackField, transformField);
-        if (rfc7807 !== null)
-            return finalize(rfc7807);
-        // Try Spring Boot default format (array-style errors list)
-        const springArray = tryParseSpringArray(body, fallbackField, transformField);
-        if (springArray !== null)
-            return finalize(springArray);
-        // Try simple flat object
-        const flat = tryParseFlatObject(body, fallbackField, transformField);
-        if (flat !== null)
-            return finalize(flat);
-        // Try RFC 9457 top-level detail as a last-resort root error
-        const rfc9457 = tryParseRfc9457Detail(body, fallbackField, transformField);
-        if (rfc9457 !== null)
-            return finalize(rfc9457);
-        return [];
+        const match = matchBody(unwrapBody(error), fallbackField, transformField, options?.parsers);
+        if (match === null)
+            return [];
+        const { parsed } = match;
+        // In the legacy API, form-level errors fall back to fallbackField instead of
+        // being returned in a separate channel.
+        const fallbackErrors = parsed.formErrors.map((message) => ({
+            field: transformField(fallbackField),
+            message,
+        }));
+        return finalize([...parsed.fieldErrors, ...fallbackErrors]);
     }
     catch {
         return [];
@@ -234,4 +139,81 @@ export function mapApiErrors(error, setError, options) {
         setError(field, { type: 'server', message });
     }
 }
+/**
+ * Vanilla (framework-agnostic) adapter.
+ *
+ * Extracts field errors from an unknown API error response and returns a plain
+ * `Record<string, string>` mapping field names to their first error message.
+ * Useful for any custom form library or imperative error handling.
+ *
+ * Only fieldErrors are included. For form-level (global) errors use `extractErrors`.
+ *
+ * @example
+ * ```ts
+ * const record = mapApiErrorsToRecord(error)
+ * // { email: "must not be blank", name: "required" }
+ * ```
+ */
+export function mapApiErrorsToRecord(error, options) {
+    const fieldErrors = extractFieldErrors(error, options);
+    const record = {};
+    for (const { field, message } of fieldErrors) {
+        if (!(field in record)) {
+            record[field] = message;
+        }
+    }
+    return record;
+}
+/**
+ * Formik adapter.
+ *
+ * Extracts field errors from an unknown API error response and calls Formik's
+ * `setErrors` with a `Record<string, string>` of field -> first error message.
+ *
+ * No Formik import is required. The `setErrors` parameter is typed by its
+ * shape only (structural typing).
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await submitForm(values)
+ * } catch (error) {
+ *   mapApiErrorsFormik(error, setErrors)
+ * }
+ * ```
+ */
+export function mapApiErrorsFormik(error, setErrors, options) {
+    setErrors(mapApiErrorsToRecord(error, options));
+}
+/**
+ * TanStack Form v1 adapter.
+ *
+ * Extracts field errors from an unknown API error response and calls
+ * `form.setFieldMeta` for each field to inject server-side errors into the
+ * form state. The updater function merges errors and errorMap onto the
+ * existing field meta.
+ *
+ * No TanStack Form import is required. The `form` parameter is typed by its
+ * shape only (structural typing), so this adapter works without adding
+ * `@tanstack/form-core` as a dependency.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await form.handleSubmit()
+ * } catch (error) {
+ *   mapApiErrorsTanstack(error, form)
+ * }
+ * ```
+ */
+export function mapApiErrorsTanstack(error, form, options) {
+    const record = mapApiErrorsToRecord(error, options);
+    for (const [field, message] of Object.entries(record)) {
+        form.setFieldMeta(field, (meta) => ({
+            ...meta,
+            errors: [message],
+            errorMap: { onChange: message },
+        }));
+    }
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/parsers/dispatch.d.ts

@@ -0,0 +1,12 @@
+import type { CustomParser, ErrorFormat, ParsedErrors } from './types.js';
+/** Internal match result: parsed errors + the format that matched. */
+export interface MatchResult {
+    parsed: ParsedErrors;
+    format: ErrorFormat;
+}
+/**
+ * Run all parsers (custom, array, object) against an already-unwrapped body.
+ * Returns the first match, or null if no parser recognized the shape.
+ */
+export declare function matchBody(body: unknown, fallbackField: string, transformField: (f: string) => string, customParsers: ReadonlyArray<CustomParser> | undefined): MatchResult | null;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/parsers/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/parsers/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAYzE,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,WAAW,CAAA;CACpB;AA6GD;;;GAGG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,OAAO,EACb,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EACrC,aAAa,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,SAAS,GACrD,WAAW,GAAG,IAAI,CAQpB"}