@nhtio/validation 1.20250719.2 → 1.20250804.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhtio/validation",
-  "version": "1.20250719.2",
+  "version": "1.20250804.0",
   "description": "A powerful schema description language and data validator",
   "keywords": [],
   "author": "Jak Giveon <jak@nht.io>",

package/private/patches/index.d.ts

@@ -0,0 +1,3 @@
+import type { Root } from 'joi';
+import type { ValidationRoot } from '../index';
+export declare const patch: (root: Root) => ValidationRoot;

package/private/patches/json.d.ts

@@ -0,0 +1,2 @@
+import type { Root } from 'joi';
+export declare const json: (root: Root) => Root;

package/private/schemas/datetime.d.ts

@@ -2,8 +2,8 @@ import { DateTime } from 'luxon';
 import { Dayjs } from 'dayjs';
 import type { Tokens } from '../types';
 import type { AnySchema } from '../schemas';
-import type { Zone, LocaleOptions, DateObjectUnits } from 'luxon';
 import type { ExtensionFactory, Reference } from 'joi';
+import type { Zone, LocaleOptions, DateObjectUnits, ZoneOptions, ToISOTimeOptions, ToISODateOptions, ToSQLOptions, ToRelativeOptions } from 'luxon';
 /**
  * Types that can be parsed into a DateTime object.
  *
@@ -232,7 +232,7 @@ export interface DatetimeSchema<TSchema = DateTime> extends AnySchema<TSchema> {
      * // Returns DateTime in Eastern timezone
      * ```
      */
-    setZone(zone: string | Zone): this;
+    setZone(zone: string | Zone, opts?: ZoneOptions): this;
     /**
      * Formats the datetime using a custom format string during validation.
      *
@@ -264,6 +264,7 @@ export interface DatetimeSchema<TSchema = DateTime> extends AnySchema<TSchema> {
     /**
      * Converts the datetime to ISO 8601 string format during validation.
      *
+     * @param opts - Options for ISO string formatting
      * @returns The schema instance for method chaining
      *
      * @example
@@ -273,10 +274,11 @@ export interface DatetimeSchema<TSchema = DateTime> extends AnySchema<TSchema> {
      * // Returns: "2023-07-15T15:30:00.000Z"
      * ```
      */
-    toISO(): this;
+    toISO(opts?: ToISOTimeOptions): this;
     /**
      * Converts the datetime to ISO date format (YYYY-MM-DD) during validation.
      *
+     * @param opts - Options for ISO date formatting
      * @returns The schema instance for method chaining
      *
      * @example
@@ -286,7 +288,7 @@ export interface DatetimeSchema<TSchema = DateTime> extends AnySchema<TSchema> {
      * // Returns: "2023-07-15"
      * ```
      */
-    toISODate(): this;
+    toISODate(opts?: ToISODateOptions): this;
     /**
      * Converts the datetime to ISO week date format during validation.
      *
@@ -303,6 +305,7 @@ export interface DatetimeSchema<TSchema = DateTime> extends AnySchema<TSchema> {
     /**
      * Converts the datetime to ISO time format during validation.
      *
+     * @param opts - Options for ISO time formatting
      * @returns The schema instance for method chaining
      *
      * @example
@@ -312,7 +315,7 @@ export interface DatetimeSchema<TSchema = DateTime> extends AnySchema<TSchema> {
      * // Returns: "15:30:00.000Z"
      * ```
      */
-    toISOTime(): this;
+    toISOTime(opts?: ToISOTimeOptions): this;
     /**
      * Converts the datetime to RFC 2822 format during validation.
      *
@@ -355,6 +358,7 @@ export interface DatetimeSchema<TSchema = DateTime> extends AnySchema<TSchema> {
     /**
      * Converts the datetime to SQL time format (HH:mm:ss.SSS) during validation.
      *
+     * @param opts - Options for SQL time formatting
      * @returns The schema instance for method chaining
      *
      * @example
@@ -364,10 +368,11 @@ export interface DatetimeSchema<TSchema = DateTime> extends AnySchema<TSchema> {
      * // Returns: "15:30:45.123"
      * ```
      */
-    toSQLTime(): this;
+    toSQLTime(opts?: ToSQLOptions): this;
     /**
      * Converts the datetime to SQL datetime format during validation.
      *
+     * @param opts - Options for SQL formatting
      * @returns The schema instance for method chaining
      *
      * @example
@@ -377,7 +382,7 @@ export interface DatetimeSchema<TSchema = DateTime> extends AnySchema<TSchema> {
      * // Returns: "2023-07-15 15:30:45.123 Z"
      * ```
      */
-    toSQL(): this;
+    toSQL(opts?: ToSQLOptions): this;
     /**
      * Converts the datetime to milliseconds since Unix epoch during validation.
      *
@@ -446,6 +451,7 @@ export interface DatetimeSchema<TSchema = DateTime> extends AnySchema<TSchema> {
     /**
      * Converts the datetime to a plain object representation during validation.
      *
+     * @param opts - Options for object conversion
      * @returns The schema instance for method chaining
      *
      * @example
@@ -455,7 +461,9 @@ export interface DatetimeSchema<TSchema = DateTime> extends AnySchema<TSchema> {
      * // Returns: { year: 2023, month: 7, day: 15, hour: 15, minute: 30, second: 0, millisecond: 0 }
      * ```
      */
-    toObject(): this;
+    toObject(opts?: {
+        includeConfig?: boolean;
+    }): this;
     /**
      * Converts the datetime to a JavaScript Date object during validation.
      *
@@ -472,6 +480,7 @@ export interface DatetimeSchema<TSchema = DateTime> extends AnySchema<TSchema> {
     /**
      * Converts the datetime to a relative time string during validation.
      *
+     * @param opts - Options for relative time formatting
      * @returns The schema instance for method chaining
      *
      * @example
@@ -481,7 +490,7 @@ export interface DatetimeSchema<TSchema = DateTime> extends AnySchema<TSchema> {
      * // Returns: "2 hours ago" (relative to current time)
      * ```
      */
-    toRelative(): this;
+    toRelative(opts?: ToRelativeOptions): this;
     /**
      * Sets the locale for the datetime during validation.
      *