@naturalcycles/js-lib 15.22.1 → 15.24.0

package/dist/validation/validation.d.ts

@@ -18,8 +18,13 @@ export type ValidationFunction<T, ERR extends AppError> = (input: T, opt?: Valid
 export type ValidationFunctionResult<T, ERR extends AppError> = [err: ERR | null, output: T];
 export interface ValidationFunctionOptions {
     /**
-     * Defaults to false,
-     * which means that the ValidationFunction IS NOT ALLOWED to mutate the input.
+     * Defaults to undefined.
+     *
+     * Undefined means that it's up for the underlying validation library (implementation)
+     * to mutate or not.
+     * E.g joi and zod would deep-clone, while ajv would mutate.
+     *
+     * False means that the ValidationFunction IS NOT ALLOWED to mutate the input.
      * If set to true - the ValidationFunction HAS TO mutate the input
      * if it needs to apply transformations, such as:
      * - stripping unknown properties

package/dist/zod/zod.shared.schemas.d.ts

@@ -1,6 +1,6 @@
 import type { ZodString } from 'zod';
 import { z } from 'zod';
-import type { IsoDate, UnixTimestamp, UnixTimestampMillis } from '../types.js';
+import type { IANATimezone, IsoDate, UnixTimestamp, UnixTimestampMillis } from '../types.js';
 type ZodBranded<T, B> = T & Record<'_zod', Record<'output', number & B>>;
 export type ZodBrandedString<B> = ZodBranded<z.ZodString, B>;
 export type ZodBrandedInt<B> = ZodBranded<z.ZodInt, B>;
@@ -20,7 +20,7 @@ declare function jwt(): z.ZodString;
  * "Slug" - a valid URL, filename, etc.
  */
 declare function slug(): z.ZodString;
-declare function ianaTimezone(): z.ZodEnum;
+declare function ianaTimezone(): ZodBrandedString<IANATimezone>;
 type BaseDBEntityZodShape = {
     id: ZodString;
     created: ZodBrandedInt<UnixTimestamp>;

package/dist/zod/zod.shared.schemas.js

@@ -76,9 +76,10 @@ function slug() {
         .describe('Slug');
 }
 function ianaTimezone() {
-    return (z
+    return z
         // UTC is added to assist unit-testing, which uses UTC by default (not technically a valid Iana timezone identifier)
-        .enum([...Intl.supportedValuesOf('timeZone'), 'UTC']));
+        .enum([...Intl.supportedValuesOf('timeZone'), 'UTC'])
+        .describe('IANATimezone');
 }
 const baseDBEntitySchema = z.object({
     id: z.string(),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.22.1",
+  "version": "15.24.0",
   "dependencies": {
     "tslib": "^2",
     "zod": "^4"

package/src/validation/validation.ts

@@ -24,8 +24,13 @@ export type ValidationFunctionResult<T, ERR extends AppError> = [err: ERR | null
 
 export interface ValidationFunctionOptions {
   /**
-   * Defaults to false,
-   * which means that the ValidationFunction IS NOT ALLOWED to mutate the input.
+   * Defaults to undefined.
+   *
+   * Undefined means that it's up for the underlying validation library (implementation)
+   * to mutate or not.
+   * E.g joi and zod would deep-clone, while ajv would mutate.
+   *
+   * False means that the ValidationFunction IS NOT ALLOWED to mutate the input.
    * If set to true - the ValidationFunction HAS TO mutate the input
    * if it needs to apply transformations, such as:
    * - stripping unknown properties

package/src/zod/zod.shared.schemas.ts

@@ -1,6 +1,6 @@
 import type { ZodString } from 'zod'
 import { z } from 'zod'
-import type { IsoDate, UnixTimestamp, UnixTimestampMillis } from '../types.js'
+import type { IANATimezone, IsoDate, UnixTimestamp, UnixTimestampMillis } from '../types.js'
 
 type ZodBranded<T, B> = T & Record<'_zod', Record<'output', number & B>>
 export type ZodBrandedString<B> = ZodBranded<z.ZodString, B>
@@ -98,11 +98,12 @@ function slug(): z.ZodString {
     .describe('Slug')
 }
 
-function ianaTimezone(): z.ZodEnum {
+function ianaTimezone(): ZodBrandedString<IANATimezone> {
   return (
     z
       // UTC is added to assist unit-testing, which uses UTC by default (not technically a valid Iana timezone identifier)
       .enum([...Intl.supportedValuesOf('timeZone'), 'UTC'])
+      .describe('IANATimezone') as unknown as ZodBrandedString<IANATimezone>
   )
 }