@c9up/rune 0.1.5 → 0.1.7

package/src/errors.ts

@@ -12,3 +12,51 @@ export class RuneError extends Error {
 		this.hint = options?.hint;
 	}
 }
+
+/**
+ * A single validation failure in a {@link RuneValidationError} — mirrors the
+ * VineJS `SimpleErrorReporter` node shape `{ message, rule, field, index?, meta? }`.
+ */
+export interface RuneErrorNode {
+	/** Human-readable (already interpolated) error message. */
+	message: string;
+	/** The rule that failed, e.g. `required`, `minLength`, `email`. */
+	rule: string;
+	/** Dotted field path, e.g. `user.email` or `tags.0`. */
+	field: string;
+	/** Array index when the field is an array item (VineJS parity). */
+	index?: number;
+	/** Rule metadata carried for reporters/i18n (e.g. `{ min: 3 }`). */
+	meta?: Record<string, unknown>;
+}
+
+/**
+ * Thrown by {@link ValidationSchema.validateOrThrow} — VineJS's
+ * `E_VALIDATION_ERROR`. Carries the structured `messages` array and an HTTP
+ * `status` (422) so web layers can render it directly, matching AdonisJS/VineJS.
+ */
+export class RuneValidationError extends Error {
+	/** Internal error code for programmatic handling (VineJS parity). */
+	readonly code = "E_VALIDATION_ERROR";
+	/** HTTP status for the failure (422 Unprocessable Entity). */
+	readonly status = 422;
+	/** Structured, per-field validation messages. */
+	readonly messages: RuneErrorNode[];
+
+	constructor(messages: RuneErrorNode[], options?: ErrorOptions) {
+		super("Validation failure", options);
+		this.name = "RuneValidationError";
+		this.messages = messages;
+		if ("captureStackTrace" in Error) {
+			Error.captureStackTrace(this, RuneValidationError);
+		}
+	}
+
+	get [Symbol.toStringTag](): string {
+		return this.name;
+	}
+
+	override toString(): string {
+		return `${this.name} [${this.code}]: ${this.message}`;
+	}
+}

package/src/index.ts

@@ -4,9 +4,16 @@
  * @implements FR38, FR39, FR40, FR41, FR42
  */
 
-export { RuneError } from "./errors.js";
+export { RuneError, RuneValidationError } from "./errors.js";
+export type { MessagesProviderContract } from "./MessagesProvider.js";
+export { SimpleMessagesProvider } from "./MessagesProvider.js";
 export type {
+	CompiledRule,
+	FieldContext,
+	Infer,
 	RuleChain,
+	RuleValidator,
+	ValidateOptions,
 	ValidationError,
 	ValidationMessageParams,
 	ValidationResult,
@@ -15,6 +22,7 @@ export type {
 } from "./Schema.js";
 export {
 	bindRosetta,
+	createRule,
 	rules,
 	schema,
 	setValidationTranslator,