@classytic/repo-core 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to `@classytic/repo-core` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.10.0] - 2026-07-13
+
+### Added — `ValidationErrorMeta.path` + `.meta` (field-scoped validation errors)
+
+- **`ValidationErrorMeta.path?: string`** — dot-path to the offending field
+  (e.g. `'journalItems.2.account'`). Set by kits with field-scoped validation
+  (ledger's `FieldError`, Mongoose `ValidationError`). Absent when the kit doesn't
+  have a field path.
+- **`ValidationErrorMeta.meta?: Readonly<Record<string, unknown>>`** — non-PII
+  structured extra for the field (e.g. `{ value: 'bad' }`). Never include secrets.
+- **`toErrorContract`** now forwards `path` and `meta` from each `validationErrors`
+  entry onto the wire `ErrorDetail`. Previously only `code` and `message` were mapped;
+  field paths were silently dropped. No breaking change — both fields are optional and
+  additive. Kits that don't set them produce the same wire shape as before.
+
 ## [0.9.0] - 2026-07-11
 
 ### Added — `StandardRepo.getByIds` (batch point-read)

package/dist/errors/contract.d.mts

@@ -23,9 +23,10 @@ declare function statusToErrorCode(status: number): ErrorCode;
  * `validationErrors` (mongokit-shaped throwable field) is mapped into the
  * canonical `details` array so wire consumers see one shape regardless
  * of which kit threw the error. Each `validationErrors[i]` becomes an
- * `ErrorDetail` with `code: validator`, `message: error`, `path` left
- * unset (kits that have field paths set them in their own ErrorDetail
- * mapping).
+ * `ErrorDetail` with `code: validator`, `message: error`, plus `path` and
+ * `meta` when the throwing kit populates them (field-scoped validators
+ * like ledger's `FieldError` — so a kernel's rich field errors reach the
+ * wire natively, with NO per-host errorMapper).
  *
  * `duplicate.fields` is similarly flattened into `details` with the
  * duplicate-key code so unique-constraint failures look uniform on the

package/dist/errors/contract.mjs

@@ -36,9 +36,10 @@ function statusToErrorCode(status) {
 * `validationErrors` (mongokit-shaped throwable field) is mapped into the
 * canonical `details` array so wire consumers see one shape regardless
 * of which kit threw the error. Each `validationErrors[i]` becomes an
-* `ErrorDetail` with `code: validator`, `message: error`, `path` left
-* unset (kits that have field paths set them in their own ErrorDetail
-* mapping).
+* `ErrorDetail` with `code: validator`, `message: error`, plus `path` and
+* `meta` when the throwing kit populates them (field-scoped validators
+* like ledger's `FieldError` — so a kernel's rich field errors reach the
+* wire natively, with NO per-host errorMapper).
 *
 * `duplicate.fields` is similarly flattened into `details` with the
 * duplicate-key code so unique-constraint failures look uniform on the
@@ -59,8 +60,10 @@ function toErrorContract(error) {
 	};
 	const details = [];
 	if (Array.isArray(e.validationErrors)) for (const v of e.validationErrors) details.push({
+		...v.path ? { path: v.path } : {},
 		code: v.validator,
-		message: v.error
+		message: v.error,
+		...v.meta ? { meta: v.meta } : {}
 	});
 	if (e.duplicate?.fields?.length) for (const field of e.duplicate.fields) details.push({
 		path: field,

package/dist/errors/types.d.mts

@@ -39,6 +39,19 @@ interface DuplicateKeyMeta {
 interface ValidationErrorMeta {
   validator: string;
   error: string;
+  /**
+   * Dot-path to the offending field (e.g. `'journalItems.2.account'`).
+   * Optional — kits with field-scoped validation (ledger's `FieldError`,
+   * mongoose ValidationError) set it so it flows onto the wire
+   * {@link ErrorDetail.path} via {@link toErrorContract} instead of being
+   * dropped. Kits without a path leave it unset.
+   */
+  path?: string;
+  /**
+   * Non-PII structured extra for this field (e.g. the offending value under
+   * `{ value }`). Flows onto {@link ErrorDetail.meta}. Never include secrets.
+   */
+  meta?: Readonly<Record<string, unknown>>;
 }
 /**
  * HTTP-shaped error — the throwable envelope every repository error and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/repo-core",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Driver-agnostic repository primitives: hooks, Filter IR, operations, pagination, cache contract. Foundation for mongokit, sqlitekit, pgkit, and prismakit. Lean by design — no plugins ship here; each kit owns its own.",
   "type": "module",
   "sideEffects": false,