@codewithagents/api-errors 1.0.6 → 1.2.0

package/dist/parsers/dispatch.js

@@ -0,0 +1,116 @@
+import { isObject } from './utils.js';
+import { tryParseViolations } from './violations.js';
+import { tryParseInvalidParams } from './invalid-params.js';
+import { tryParseJsonApi } from './json-api.js';
+import { tryParseRfc7807 } from './rfc7807.js';
+import { tryParseSpringArray } from './spring.js';
+import { tryParseGraphqlExtensions } from './graphql-extensions.js';
+import { tryParseLaravelDrf } from './laravel-drf.js';
+import { tryParseFlatObject, tryParseFlatArray } from './flat.js';
+import { tryParseZodFlatten } from './zod-flatten.js';
+/** Wrap a ParsedErrors result with its format tag, applying transformField to field names. */
+function wrapMatch(parsed, format, transformField) {
+    return {
+        parsed: {
+            fieldErrors: parsed.fieldErrors.map((e) => ({
+                field: transformField(e.field),
+                message: e.message,
+            })),
+            formErrors: parsed.formErrors,
+        },
+        format,
+    };
+}
+/**
+ * Try all object-body parsers in priority order.
+ * Returns the first match, or null if no parser recognized the shape.
+ */
+function matchObjectBody(body, fallbackField, transformField) {
+    // Each thunk in this ordered list tries one parser and returns a MatchResult or null.
+    const candidates = [
+        () => {
+            const r = tryParseViolations(body);
+            return r && wrapMatch(r, 'violations', transformField);
+        },
+        () => {
+            const r = tryParseInvalidParams(body);
+            return r && wrapMatch(r, 'invalid-params', transformField);
+        },
+        () => {
+            const r = tryParseJsonApi(body);
+            return r && wrapMatch(r, 'json-api', transformField);
+        },
+        () => {
+            const r = tryParseRfc7807(body, transformField);
+            return r && { parsed: { fieldErrors: r, formErrors: [] }, format: 'rfc7807-map' };
+        },
+        () => {
+            const r = tryParseGraphqlExtensions(body);
+            return r && wrapMatch(r, 'graphql-extensions', transformField);
+        },
+        () => {
+            const r = tryParseSpringArray(body, fallbackField, transformField);
+            return r && { parsed: { fieldErrors: r, formErrors: [] }, format: 'spring-array' };
+        },
+        () => {
+            const r = tryParseLaravelDrf(body);
+            return r && wrapMatch(r, 'laravel-drf', transformField);
+        },
+        () => {
+            const r = tryParseFlatObject(body, fallbackField, transformField);
+            return r && { parsed: { fieldErrors: r, formErrors: [] }, format: 'flat-object' };
+        },
+        () => {
+            const r = tryParseZodFlatten(body);
+            return r && wrapMatch(r, 'zod-flatten', transformField);
+        },
+        () => {
+            const detail = body['detail'];
+            return typeof detail === 'string'
+                ? { parsed: { fieldErrors: [], formErrors: [detail] }, format: 'rfc9457-detail' }
+                : null;
+        },
+    ];
+    for (const candidate of candidates) {
+        const result = candidate();
+        if (result !== null)
+            return result;
+    }
+    return null;
+}
+/**
+ * Run custom parsers (if any) before the built-in ones.
+ * Returns the first match, or null to fall through.
+ */
+function tryCustomParsers(body, customParsers) {
+    for (const parser of customParsers) {
+        const parsed = parser(body);
+        if (parsed !== null)
+            return { parsed, format: 'custom' };
+    }
+    return null;
+}
+/**
+ * Dispatch an array body through the flat-array parser.
+ */
+function matchArrayBody(body, fallbackField, transformField) {
+    const flat = tryParseFlatArray(body, fallbackField, transformField);
+    return flat ? { parsed: { fieldErrors: flat, formErrors: [] }, format: 'flat-array' } : null;
+}
+/**
+ * Run all parsers (custom, array, object) against an already-unwrapped body.
+ * Returns the first match, or null if no parser recognized the shape.
+ */
+export function matchBody(body, fallbackField, transformField, customParsers) {
+    if (customParsers?.length) {
+        const custom = tryCustomParsers(body, customParsers);
+        if (custom !== null)
+            return custom;
+    }
+    if (Array.isArray(body))
+        return matchArrayBody(body, fallbackField, transformField);
+    if (!isObject(body))
+        return null;
+    return matchObjectBody(body, fallbackField, transformField);
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/parsers/dispatch.js.map

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

package/dist/parsers/flat.d.ts

@@ -0,0 +1,12 @@
+import type { FieldError } from './types.js';
+/**
+ * Simple flat object format:
+ * { "field": "email", "message": "Invalid email" }
+ */
+export declare function tryParseFlatObject(body: Record<string, unknown>, fallbackField: string, transformField: (field: string) => string): FieldError[] | null;
+/**
+ * Array of simple flat objects:
+ * [{ "field": "email", "message": "Invalid email" }]
+ */
+export declare function tryParseFlatArray(body: unknown[], fallbackField: string, transformField: (field: string) => string): FieldError[] | null;
+//# sourceMappingURL=flat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flat.d.ts","sourceRoot":"","sources":["../../src/parsers/flat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAG5C;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACxC,UAAU,EAAE,GAAG,IAAI,CAMrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EAAE,EACf,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACxC,UAAU,EAAE,GAAG,IAAI,CAUrB"}

package/dist/parsers/flat.js

@@ -0,0 +1,31 @@
+import { isObject } from './utils.js';
+/**
+ * Simple flat object format:
+ * { "field": "email", "message": "Invalid email" }
+ */
+export 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 }];
+}
+/**
+ * Array of simple flat objects:
+ * [{ "field": "email", "message": "Invalid email" }]
+ */
+export 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;
+}
+//# sourceMappingURL=flat.js.map

package/dist/parsers/flat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flat.js","sourceRoot":"","sources":["../../src/parsers/flat.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAA6B,EAC7B,aAAqB,EACrB,cAAyC;IAEzC,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACzE,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC5E,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IACjC,MAAM,KAAK,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAA;IAC1D,OAAO,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAe,EACf,aAAqB,EACrB,cAAyC;IAEzC,MAAM,MAAM,GAAiB,EAAE,CAAA;IAC/B,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAQ;QAC7B,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAA;QAClF,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAC5E,IAAI,OAAO,KAAK,IAAI;YAAE,SAAQ;QAC9B,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AAC1C,CAAC"}

package/dist/parsers/graphql-extensions.d.ts

@@ -0,0 +1,18 @@
+import type { ParsedErrors } from './types.js';
+/**
+ * GraphQL errors array shape:
+ * { errors: [{ message: "...", extensions?: { field?: string, path?: string[] } }] }
+ *
+ * Field resolution (in order):
+ *   1. `extensions.field` — plain string field name
+ *   2. `extensions.path` — array of path segments joined with `.`
+ *   3. Neither — treated as a form-level (global) error
+ *
+ * Guards (must NOT match):
+ *   - Items with `source.pointer` or `detail` (JSON:API shape)
+ *   - Items with `defaultMessage` (Spring Boot shape)
+ *
+ * Returns null if `body.errors` is not an array.
+ */
+export declare function tryParseGraphqlExtensions(body: Record<string, unknown>): ParsedErrors | null;
+//# sourceMappingURL=graphql-extensions.d.ts.map

package/dist/parsers/graphql-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-extensions.d.ts","sourceRoot":"","sources":["../../src/parsers/graphql-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,YAAY,CAAA;AAG1D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,GAAG,IAAI,CAwB5F"}

package/dist/parsers/graphql-extensions.js

@@ -0,0 +1,83 @@
+import { isObject } from './utils.js';
+/**
+ * GraphQL errors array shape:
+ * { errors: [{ message: "...", extensions?: { field?: string, path?: string[] } }] }
+ *
+ * Field resolution (in order):
+ *   1. `extensions.field` — plain string field name
+ *   2. `extensions.path` — array of path segments joined with `.`
+ *   3. Neither — treated as a form-level (global) error
+ *
+ * Guards (must NOT match):
+ *   - Items with `source.pointer` or `detail` (JSON:API shape)
+ *   - Items with `defaultMessage` (Spring Boot shape)
+ *
+ * Returns null if `body.errors` is not an array.
+ */
+export function tryParseGraphqlExtensions(body) {
+    const { errors } = body;
+    if (!Array.isArray(errors))
+        return null;
+    // Require at least one item that looks like a GraphQL error (has message, not JSON:API/Spring).
+    if (!errors.some(isGraphqlErrorItem))
+        return null;
+    const fieldErrors = [];
+    const formErrors = [];
+    for (const item of errors) {
+        if (!isObject(item))
+            continue;
+        const message = typeof item['message'] === 'string' ? item['message'] : null;
+        if (message === null)
+            continue;
+        const field = extractField(item);
+        if (field !== null) {
+            fieldErrors.push({ field, message });
+        }
+        else {
+            formErrors.push(message);
+        }
+    }
+    return { fieldErrors, formErrors };
+}
+/** True when an item looks like a GraphQL error object (not JSON:API, not Spring). */
+function isGraphqlErrorItem(item) {
+    if (!isObject(item))
+        return false;
+    // Must have a string message.
+    if (typeof item['message'] !== 'string')
+        return false;
+    // Must NOT have JSON:API keys.
+    if (isObject(item['source']) && 'pointer' in item['source'])
+        return false;
+    if (typeof item['detail'] === 'string')
+        return false;
+    // Must NOT have Spring Boot keys.
+    if ('defaultMessage' in item)
+        return false;
+    // Must NOT have a top-level `field` key (Spring uses `field` for the field name).
+    // Real GraphQL errors carry the field name in `extensions.field`, not at the top level.
+    if ('field' in item)
+        return false;
+    return true;
+}
+/** Extract a field name from a GraphQL error item's extensions. Returns null for form-level. */
+function extractField(item) {
+    const extensions = item['extensions'];
+    if (!isObject(extensions))
+        return null;
+    // Prefer extensions.field (plain string).
+    if (typeof extensions['field'] === 'string' && extensions['field'] !== '') {
+        return extensions['field'];
+    }
+    // Fall back to extensions.path (array joined with `.`).
+    const path = extensions['path'];
+    if (Array.isArray(path) && path.length > 0) {
+        const segments = path
+            .filter((s) => typeof s === 'string' || typeof s === 'number')
+            .map(String);
+        if (segments.length > 0)
+            return segments.join('.');
+    }
+    return null;
+}
+//# sourceMappingURL=graphql-extensions.js.map

package/dist/parsers/graphql-extensions.js.map

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

package/dist/parsers/invalid-params.d.ts

@@ -0,0 +1,7 @@
+import type { ParsedErrors } from './types.js';
+/**
+ * RFC 9457 invalid-params array:
+ * { "invalid-params": [{ "name": "email", "reason": "must not be blank" }] }
+ */
+export declare function tryParseInvalidParams(body: Record<string, unknown>): ParsedErrors | null;
+//# sourceMappingURL=invalid-params.d.ts.map

package/dist/parsers/invalid-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-params.d.ts","sourceRoot":"","sources":["../../src/parsers/invalid-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAG9C;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,GAAG,IAAI,CAIxF"}

package/dist/parsers/invalid-params.js

@@ -0,0 +1,12 @@
+import { parseKeyedArray } from './utils.js';
+/**
+ * RFC 9457 invalid-params array:
+ * { "invalid-params": [{ "name": "email", "reason": "must not be blank" }] }
+ */
+export function tryParseInvalidParams(body) {
+    const invalidParams = body['invalid-params'];
+    if (!Array.isArray(invalidParams))
+        return null;
+    return parseKeyedArray(invalidParams, 'name', 'reason');
+}
+//# sourceMappingURL=invalid-params.js.map

package/dist/parsers/invalid-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-params.js","sourceRoot":"","sources":["../../src/parsers/invalid-params.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5C;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA6B;IACjE,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAA;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;QAAE,OAAO,IAAI,CAAA;IAC9C,OAAO,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;AACzD,CAAC"}

package/dist/parsers/json-api.d.ts

@@ -0,0 +1,14 @@
+import type { ParsedErrors } from './types.js';
+/**
+ * JSON:API errors array:
+ * { "errors": [{ "source": { "pointer": "/data/attributes/email" }, "detail": "..." }] }
+ *
+ * Errors with a source pointer map to field errors.
+ * Errors without a source pointer (or with a pointer of "/") map to form errors.
+ *
+ * IMPORTANT: this parser must run BEFORE tryParseSpringArray because a JSON:API
+ * body also has an `errors` array and would silently match the Spring-array parser
+ * via the defaultMessage fallback.
+ */
+export declare function tryParseJsonApi(body: Record<string, unknown>): ParsedErrors | null;
+//# sourceMappingURL=json-api.d.ts.map

package/dist/parsers/json-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-api.d.ts","sourceRoot":"","sources":["../../src/parsers/json-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,YAAY,CAAA;AAG1D;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,GAAG,IAAI,CAWlF"}

package/dist/parsers/json-api.js

@@ -0,0 +1,85 @@
+import { isObject } from './utils.js';
+/**
+ * JSON:API errors array:
+ * { "errors": [{ "source": { "pointer": "/data/attributes/email" }, "detail": "..." }] }
+ *
+ * Errors with a source pointer map to field errors.
+ * Errors without a source pointer (or with a pointer of "/") map to form errors.
+ *
+ * IMPORTANT: this parser must run BEFORE tryParseSpringArray because a JSON:API
+ * body also has an `errors` array and would silently match the Spring-array parser
+ * via the defaultMessage fallback.
+ */
+export function tryParseJsonApi(body) {
+    const { errors } = body;
+    if (!Array.isArray(errors) || !isJsonApiShape(errors))
+        return null;
+    const fieldErrors = [];
+    const formErrors = [];
+    for (const item of errors) {
+        if (!isObject(item))
+            continue;
+        classifyJsonApiItem(item, fieldErrors, formErrors);
+    }
+    return { fieldErrors, formErrors };
+}
+/** True when at least one item looks like a JSON:API error object (not Spring). */
+function isJsonApiShape(errors) {
+    return errors.some((item) => isObject(item) &&
+        (isObject(item['source']) || typeof item['detail'] === 'string') &&
+        !('field' in item) &&
+        !('defaultMessage' in item));
+}
+/** Push one JSON:API error item into the appropriate bucket. */
+function classifyJsonApiItem(item, fieldErrors, formErrors) {
+    const detail = typeof item['detail'] === 'string' ? item['detail'] : null;
+    const message = detail ?? 'Unknown error';
+    const source = item['source'];
+    if (isObject(source) && typeof source['pointer'] === 'string') {
+        const field = pointerToField(source['pointer']);
+        if (field !== null) {
+            fieldErrors.push({ field, message });
+        }
+        else if (detail !== null) {
+            formErrors.push(detail);
+        }
+    }
+    else if (detail !== null) {
+        formErrors.push(detail);
+    }
+}
+/**
+ * Convert a JSON Pointer (RFC 6901) used in JSON:API source.pointer to a
+ * dot-separated field path for form use.
+ *
+ * `/data/attributes/email`        -> `email`
+ * `/data/attributes/address/city` -> `address.city`
+ * `/data/relationships/author`    -> `author`
+ * `/email`                        -> `email`
+ * `/`                             -> null (root, non-field)
+ * ``                              -> null
+ */
+function pointerToField(pointer) {
+    if (!pointer || pointer === '/')
+        return null;
+    const segments = pointer
+        .replace(/^\//, '')
+        .split('/')
+        .map((s) => s.replace(/~1/g, '/').replace(/~0/g, '~'))
+        .filter(Boolean);
+    return segments.length > 0 ? resolveJsonApiSegments(segments) : null;
+}
+/** Strip well-known JSON:API structural prefixes and join as dot-path. */
+function resolveJsonApiSegments(segments) {
+    if (segments[0] !== 'data')
+        return segments.join('.');
+    if (segments[1] === 'attributes') {
+        const rest = segments.slice(2);
+        return rest.length > 0 ? rest.join('.') : null;
+    }
+    if (segments[1] === 'relationships' && segments.length > 2) {
+        return segments.slice(2).join('.');
+    }
+    return segments.join('.');
+}
+//# sourceMappingURL=json-api.js.map

package/dist/parsers/json-api.js.map

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

package/dist/parsers/laravel-drf.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedErrors } from './types.js';
+/**
+ * Laravel / DRF top-level field-to-messages map:
+ * { "email": ["must not be blank", "invalid format"], "name": ["required"] }
+ *
+ * Guard: at least one value must be a non-empty string array, and the body
+ * must not use keys owned by other parsers.
+ */
+export declare function tryParseLaravelDrf(body: Record<string, unknown>): ParsedErrors | null;
+//# sourceMappingURL=laravel-drf.d.ts.map

package/dist/parsers/laravel-drf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"laravel-drf.d.ts","sourceRoot":"","sources":["../../src/parsers/laravel-drf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,YAAY,CAAA;AAuB1D;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,GAAG,IAAI,CAgBrF"}

package/dist/parsers/laravel-drf.js

@@ -0,0 +1,46 @@
+import { isStringArray } from './utils.js';
+/** Keys that belong to other parsers and disqualify a body from Laravel/DRF matching. */
+const LARAVEL_RESERVED_KEYS = new Set([
+    'errors',
+    'violations',
+    'invalid-params',
+    'field',
+    'message',
+    'detail',
+    'title',
+    'status',
+    'type',
+    // Zod flatten shape keys — prevent laravel-drf from consuming zod-flatten bodies.
+    'fieldErrors',
+    'formErrors',
+]);
+function hasReservedLaravelKey(entries) {
+    return entries.some(([k]) => LARAVEL_RESERVED_KEYS.has(k));
+}
+/**
+ * Laravel / DRF top-level field-to-messages map:
+ * { "email": ["must not be blank", "invalid format"], "name": ["required"] }
+ *
+ * Guard: at least one value must be a non-empty string array, and the body
+ * must not use keys owned by other parsers.
+ */
+export function tryParseLaravelDrf(body) {
+    const entries = Object.entries(body);
+    if (entries.length === 0 || hasReservedLaravelKey(entries))
+        return null;
+    // Require at least one non-empty string array to distinguish from generic flat objects
+    if (!entries.some(([, v]) => isStringArray(v) && v.length > 0))
+        return null;
+    const fieldErrors = [];
+    for (const [rawField, messages] of entries) {
+        if (isStringArray(messages)) {
+            for (const message of messages)
+                fieldErrors.push({ field: rawField, message });
+        }
+        else if (typeof messages === 'string') {
+            fieldErrors.push({ field: rawField, message: messages });
+        }
+    }
+    return fieldErrors.length > 0 ? { fieldErrors, formErrors: [] } : null;
+}
+//# sourceMappingURL=laravel-drf.js.map

package/dist/parsers/laravel-drf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"laravel-drf.js","sourceRoot":"","sources":["../../src/parsers/laravel-drf.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,yFAAyF;AACzF,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,QAAQ;IACR,YAAY;IACZ,gBAAgB;IAChB,OAAO;IACP,SAAS;IACT,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,MAAM;IACN,kFAAkF;IAClF,aAAa;IACb,YAAY;CACb,CAAC,CAAA;AAEF,SAAS,qBAAqB,CAAC,OAA4B;IACzD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA6B;IAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAA;IAEvE,uFAAuF;IACvF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAK,CAAc,CAAC,MAAM,GAAG,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAEzF,MAAM,WAAW,GAAiB,EAAE,CAAA;IACpC,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,OAAO,EAAE,CAAC;QAC3C,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,KAAK,MAAM,OAAO,IAAI,QAAQ;gBAAE,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAA;QAChF,CAAC;aAAM,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACxC,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACxE,CAAC"}

package/dist/parsers/rfc7807.d.ts

@@ -0,0 +1,7 @@
+import type { FieldError } from './types.js';
+/**
+ * RFC 7807 Problem Details (Spring Boot 3+ default):
+ * { "errors": { "email": ["must not be blank"], "name": ["too short"] } }
+ */
+export declare function tryParseRfc7807(body: Record<string, unknown>, transformField: (field: string) => string): FieldError[] | null;
+//# sourceMappingURL=rfc7807.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rfc7807.d.ts","sourceRoot":"","sources":["../../src/parsers/rfc7807.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAG5C;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACxC,UAAU,EAAE,GAAG,IAAI,CAerB"}

package/dist/parsers/rfc7807.js

@@ -0,0 +1,24 @@
+import { isObject, isStringArray } from './utils.js';
+/**
+ * RFC 7807 Problem Details (Spring Boot 3+ default):
+ * { "errors": { "email": ["must not be blank"], "name": ["too short"] } }
+ */
+export function tryParseRfc7807(body, 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;
+}
+//# sourceMappingURL=rfc7807.js.map

package/dist/parsers/rfc7807.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rfc7807.js","sourceRoot":"","sources":["../../src/parsers/rfc7807.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEpD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,IAA6B,EAC7B,cAAyC;IAEzC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACvB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAA;IAElC,MAAM,MAAM,GAAiB,EAAE,CAAA;IAC/B,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;QACtC,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,KAAK,MAAM,OAAO,IAAI,QAAQ;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;QACjE,CAAC;aAAM,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC3C,CAAC;QACD,sEAAsE;IACxE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AAC1C,CAAC"}

package/dist/parsers/spring.d.ts

@@ -0,0 +1,7 @@
+import type { FieldError } from './types.js';
+/**
+ * Spring Boot default validation format (pre-3):
+ * { "errors": [{ "field": "email", "defaultMessage": "must not be blank" }] }
+ */
+export declare function tryParseSpringArray(body: Record<string, unknown>, fallbackField: string, transformField: (field: string) => string): FieldError[] | null;
+//# sourceMappingURL=spring.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spring.d.ts","sourceRoot":"","sources":["../../src/parsers/spring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAG5C;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACxC,UAAU,EAAE,GAAG,IAAI,CAiBrB"}

package/dist/parsers/spring.js

@@ -0,0 +1,24 @@
+import { isObject } from './utils.js';
+/**
+ * Spring Boot default validation format (pre-3):
+ * { "errors": [{ "field": "email", "defaultMessage": "must not be blank" }] }
+ */
+export 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 });
+    }
+    return result.length > 0 ? result : null;
+}
+//# sourceMappingURL=spring.js.map

package/dist/parsers/spring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring.js","sourceRoot":"","sources":["../../src/parsers/spring.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA6B,EAC7B,aAAqB,EACrB,cAAyC;IAEzC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACvB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAA;IAEvC,MAAM,MAAM,GAAiB,EAAE,CAAA;IAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAQ;QAC7B,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAA;QAClF,MAAM,OAAO,GACX,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,QAAQ;YACxC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;YACxB,CAAC,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ;gBACnC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;gBACjB,CAAC,CAAC,eAAe,CAAA;QACvB,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AAC1C,CAAC"}

package/dist/parsers/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Normalized representation of a single field-level error.
+ */
+export interface FieldError {
+    field: string;
+    message: string;
+}
+/**
+ * Raw parse result used internally and returned by custom parsers.
+ * Both arrays may be empty if the shape was recognized but contained no errors.
+ */
+export interface ParsedErrors {
+    fieldErrors: FieldError[];
+    formErrors: string[];
+}
+/**
+ * The format/shape that was recognized when parsing an error body.
+ *
+ * - `'rfc7807-map'`          - RFC 7807 / RFC 9457 `errors` map: `{ errors: { field: [...] } }`
+ * - `'spring-array'`         - Spring Boot array: `{ errors: [{ field, defaultMessage }] }`
+ * - `'violations'`           - RFC 9457 / Spring `violations` array: `{ violations: [{ field, message }] }`
+ * - `'invalid-params'`       - RFC 9457 `invalid-params` array: `{ "invalid-params": [{ name, reason }] }`
+ * - `'json-api'`             - JSON:API errors array: `{ errors: [{ source: { pointer }, detail }] }`
+ * - `'graphql-extensions'`   - GraphQL errors array: `{ errors: [{ message, extensions?: { field?, path? } }] }`
+ * - `'zod-flatten'`          - Zod flatten shape: `{ fieldErrors: { field: [...] }, formErrors: [...] }`
+ * - `'laravel-drf'`          - Laravel / DRF top-level field map: `{ field: ["msg1", ...] }`
+ * - `'flat-object'`          - Simple flat object: `{ field, message }`
+ * - `'flat-array'`           - Array of flat objects: `[{ field, message }]`
+ * - `'rfc9457-detail'`       - RFC 9457 top-level `detail` string (last-resort fallback)
+ * - `'custom'`               - Matched a caller-provided custom parser
+ */
+export type ErrorFormat = 'rfc7807-map' | 'spring-array' | 'violations' | 'invalid-params' | 'json-api' | 'graphql-extensions' | 'zod-flatten' | 'laravel-drf' | 'flat-object' | 'flat-array' | 'rfc9457-detail' | 'custom';
+/**
+ * A custom parser that callers can register to handle application-specific
+ * error shapes not covered by the built-in parsers.
+ *
+ * Return `null` to indicate "not recognized" and let the next parser try.
+ * Return a `ParsedErrors` object (even if both arrays are empty) to signal
+ * that this shape was recognized.
+ */
+export interface CustomParser {
+    (body: unknown): ParsedErrors | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/parsers/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,WAAW,GACnB,aAAa,GACb,cAAc,GACd,YAAY,GACZ,gBAAgB,GAChB,UAAU,GACV,oBAAoB,GACpB,aAAa,GACb,aAAa,GACb,aAAa,GACb,YAAY,GACZ,gBAAgB,GAChB,QAAQ,CAAA;AAEZ;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAAA;CACrC"}