@naturalcycles/nodejs-lib 15.85.0 → 15.86.0

package/dist/validation/ajv/getAjv.js

@@ -1,4 +1,4 @@
-import { _isBetween, _lazyValue } from '@naturalcycles/js-lib';
+import { _isBetween, _lazyValue, _round } from '@naturalcycles/js-lib';
 import { _assert } from '@naturalcycles/js-lib/error';
 import { _deepCopy, _mapObject, Set2 } from '@naturalcycles/js-lib/object';
 import { _substringAfterLast } from '@naturalcycles/js-lib/string';
@@ -560,6 +560,20 @@ export function createAjv(opt) {
             return validate;
         },
     });
+    ajv.addKeyword({
+        keyword: 'precision',
+        type: ['number'],
+        modifying: true,
+        errors: false,
+        schemaType: 'number',
+        validate: function validate(numberOfDigits, data, _schema, ctx) {
+            if (!numberOfDigits)
+                return true;
+            _assert(ctx?.parentData && ctx.parentDataProperty !== undefined, 'You should only use `precision(n) on a property of an object, or on an element of an array due to Ajv mutation issues.');
+            ctx.parentData[ctx.parentDataProperty] = _round(data, 10 ** (-1 * numberOfDigits));
+            return true;
+        },
+    });
     return ajv;
 }
 const monthLengths = [0, 31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];

package/dist/validation/ajv/jsonSchemaBuilder.d.ts

@@ -279,6 +279,12 @@ export declare class JsonSchemaNumberBuilder<IN extends number | undefined = num
     unixTimestamp2000Millis(): JsonSchemaNumberBuilder<UnixTimestampMillis, UnixTimestampMillis, Opt>;
     utcOffset(): this;
     utcOffsetHour(): this;
+    /**
+     * Specify the precision of the floating point numbers by the number of digits after the ".".
+     * Excess digits will be cut-off when the current schema is nested in an object or array schema,
+     * due to how mutability works in Ajv.
+     */
+    precision(numberOfDigits: number): this;
 }
 export declare class JsonSchemaBooleanBuilder<IN extends boolean | undefined = boolean, OUT = IN, Opt extends boolean = false> extends JsonSchemaAnyBuilder<IN, OUT, Opt> {
     constructor();
@@ -512,6 +518,7 @@ export interface JsonSchema<IN = unknown, OUT = IN> {
         schemaDictionary: Record<string, JsonSchema>;
     };
     anyOfThese?: JsonSchema[];
+    precision?: number;
 }
 declare function object(props: AnyObject): never;
 declare function object<IN extends AnyObject>(props: {

package/dist/validation/ajv/jsonSchemaBuilder.js

@@ -632,6 +632,14 @@ export class JsonSchemaNumberBuilder extends JsonSchemaAnyBuilder {
     utcOffsetHour() {
         return this.integer().min(-12).max(14);
     }
+    /**
+     * Specify the precision of the floating point numbers by the number of digits after the ".".
+     * Excess digits will be cut-off when the current schema is nested in an object or array schema,
+     * due to how mutability works in Ajv.
+     */
+    precision(numberOfDigits) {
+        return this.cloneAndUpdateSchema({ precision: numberOfDigits });
+    }
 }
 export class JsonSchemaBooleanBuilder extends JsonSchemaAnyBuilder {
     constructor() {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/nodejs-lib",
   "type": "module",
-  "version": "15.85.0",
+  "version": "15.86.0",
   "dependencies": {
     "@naturalcycles/js-lib": "^15",
     "@types/js-yaml": "^4",

package/src/validation/ajv/getAjv.ts

@@ -1,4 +1,4 @@
-import { _isBetween, _lazyValue } from '@naturalcycles/js-lib'
+import { _isBetween, _lazyValue, _round } from '@naturalcycles/js-lib'
 import { _assert } from '@naturalcycles/js-lib/error'
 import { _deepCopy, _mapObject, Set2 } from '@naturalcycles/js-lib/object'
 import { _substringAfterLast } from '@naturalcycles/js-lib/string'
@@ -639,6 +639,26 @@ export function createAjv(opt?: Options): Ajv2020 {
     },
   })
 
+  ajv.addKeyword({
+    keyword: 'precision',
+    type: ['number'],
+    modifying: true,
+    errors: false,
+    schemaType: 'number',
+    validate: function validate(numberOfDigits: number, data: number, _schema, ctx) {
+      if (!numberOfDigits) return true
+
+      _assert(
+        ctx?.parentData && ctx.parentDataProperty !== undefined,
+        'You should only use `precision(n) on a property of an object, or on an element of an array due to Ajv mutation issues.',
+      )
+
+      ctx.parentData[ctx.parentDataProperty] = _round(data, 10 ** (-1 * numberOfDigits))
+
+      return true
+    },
+  })
+
   return ajv
 }
 

package/src/validation/ajv/jsonSchemaBuilder.ts

@@ -888,6 +888,15 @@ export class JsonSchemaNumberBuilder<
   utcOffsetHour(): this {
     return this.integer().min(-12).max(14)
   }
+
+  /**
+   * Specify the precision of the floating point numbers by the number of digits after the ".".
+   * Excess digits will be cut-off when the current schema is nested in an object or array schema,
+   * due to how mutability works in Ajv.
+   */
+  precision(numberOfDigits: number): this {
+    return this.cloneAndUpdateSchema({ precision: numberOfDigits })
+  }
 }
 
 export class JsonSchemaBooleanBuilder<
@@ -1572,6 +1581,7 @@ export interface JsonSchema<IN = unknown, OUT = IN> {
     schemaDictionary: Record<string, JsonSchema>
   }
   anyOfThese?: JsonSchema[]
+  precision?: number
 }
 
 function object(props: AnyObject): never