@astral/validations 4.13.3 → 4.14.0

package/README.md

@@ -71,6 +71,7 @@
 - [Common](#common)
   - [optional](#optional)
   - [when. Условная валидация](#when-условная-валидация)
+  - [enabled. Условная валидация](#enabled-условная-валидация)
   - [transform](#transform)
   - [or](#or)
 - [Async](#async)
@@ -1607,6 +1608,57 @@ toPrettyError(
   validate({ name: 'Vasya' })
 );
 
+// undefined
+validate({ name: 'Kolya' });
+```
+---
+
+## enabled. Условная валидация
+
+Позволяет определять условные валидации без выбора альтернативной схемы. Является упрощением when с otherwise = any().
+
+```ts
+type Values = { name: string; isAgree: boolean };
+
+const validate = object<Values>({
+  name: enabled({
+    is: (_, ctx) => Boolean(ctx.values?.isAgree),
+    then: string(),
+  }),
+  isAgree: optional(boolean()),
+});
+
+// undefined
+validate({ isAgree: false, name: '' });
+
+// { name: 'Обязательно' }
+toPrettyError(
+  validate({ isAgree: true, name: '' })
+);
+```
+
+Enabled для ветки объекта:
+```ts
+type ValuesInfo = { surname: string };
+
+type Values = {
+  name: string;
+  info?: ValuesInfo;
+};
+
+const validate = object<Values>({
+  name: string(),
+  info: enabled({
+    is: (_, ctx) => ctx.values?.name === 'Vasya',
+    then: object<ValuesInfo>({ surname: string() }),
+  }),
+});
+
+// { info: 'Обязательно' }
+toPrettyError(
+  validate({ name: 'Vasya' })
+);
+
 // undefined
 validate({ name: 'Kolya' });
 ```

package/enabled/enabled.d.ts

@@ -0,0 +1,34 @@
+import { type ValidationContext, type ValidationRule } from '../core';
+type Params<TLastSchemaValues extends Record<string, unknown>> = {
+    /**
+     * @description Условие для включения схемы
+     */
+    is: (value: unknown, ctx: ValidationContext<TLastSchemaValues>) => boolean;
+    /**
+     * Правило валидации, применяемая если is === true
+     */
+    then: ValidationRule<unknown, TLastSchemaValues>;
+};
+/**
+ * @description Позволяет указывать условные валидации
+ * @example
+ * ```ts
+ * type Values = { name: string; isAgree: boolean };
+ *
+ * const validate = object<Values>({
+ *   name: enabled({
+ *     is: (_, ctx) => ctx.global.values.isAgree,
+ *     then: string(),
+ *   }),
+ *   isAgree: optional(boolean()),
+ * });
+ *
+ * // undefined
+ * const result1 = validate({ isAgree: false, name: '' });
+ *
+ * // Required error для name
+ * const result2 = validate({ isAgree: true, name: '' });
+ * ```
+ */
+export declare const enabled: <TLastSchemaValues extends Record<string, unknown>>({ is, then, }: Params<TLastSchemaValues>) => (value: unknown, prevCtx?: ValidationContext<TLastSchemaValues> | undefined) => import("../core").ValidationResult;
+export {};

package/enabled/enabled.js

@@ -0,0 +1,31 @@
+import { any } from '../any';
+import { callRule, createRule, } from '../core';
+/**
+ * @description Позволяет указывать условные валидации
+ * @example
+ * ```ts
+ * type Values = { name: string; isAgree: boolean };
+ *
+ * const validate = object<Values>({
+ *   name: enabled({
+ *     is: (_, ctx) => ctx.global.values.isAgree,
+ *     then: string(),
+ *   }),
+ *   isAgree: optional(boolean()),
+ * });
+ *
+ * // undefined
+ * const result1 = validate({ isAgree: false, name: '' });
+ *
+ * // Required error для name
+ * const result2 = validate({ isAgree: true, name: '' });
+ * ```
+ */
+export const enabled = ({ is, then, }) => {
+    return createRule((value, ctx) => {
+        if (is(value, ctx)) {
+            return callRule(then, value, ctx);
+        }
+        return callRule(any(), value, ctx);
+    });
+};

package/enabled/index.d.ts

@@ -0,0 +1 @@
+export * from './enabled';

package/enabled/index.js

@@ -0,0 +1 @@
+export * from './enabled';

package/index.d.ts

@@ -44,3 +44,4 @@ export { any } from './any';
 export { when } from './when';
 export { toPrettyError } from './toPrettyError';
 export { transform } from './transform';
+export { enabled } from './enabled';

package/index.js

@@ -44,3 +44,4 @@ export { any } from './any';
 export { when } from './when';
 export { toPrettyError } from './toPrettyError';
 export { transform } from './transform';
+export { enabled } from './enabled';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astral/validations",
-  "version": "4.13.3",
+  "version": "4.14.0",
   "browser": "./index.js",
   "main": "./index.js",
   "dependencies": {