@naturalcycles/nodejs-lib 15.133.0 → 15.134.0

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

@@ -1,6 +1,6 @@
 import type { ValidationFunction, ValidationFunctionResult } from '@naturalcycles/js-lib';
 import type { Set2 } from '@naturalcycles/js-lib/object';
-import type { AnyObject, BaseDBEntity, IANATimezone, Inclusiveness, IsoDate, IsoDateTime, IsoMonth, Enum, NumberEnum, StringEnum, StringMap, UnixTimestamp, UnixTimestampMillis } from '@naturalcycles/js-lib/types';
+import type { AnyObject, BaseDBEntity, IANATimezone, Inclusiveness, IsoDate, IsoDateTime, IsoMonth, Enum, NonEmptyArray, NumberEnum, StringEnum, StringMap, UnixTimestamp, UnixTimestampMillis } from '@naturalcycles/js-lib/types';
 import type { StandardJSONSchemaV1, StandardSchemaV1 } from '@standard-schema/spec';
 import type { Ajv, ValidateFunction } from 'ajv';
 import { AjvValidationError } from './ajvValidationError.js';
@@ -408,13 +408,17 @@ export declare class JObjectInfer<PROPS extends Record<string, JSchema<any, any>
         updated: JNumber<UnixTimestamp, false>;
     }[K] : K extends keyof PROPS ? PROPS[K] : never; }, Opt>;
 }
-export declare class JArray<OUT, Opt> extends JBuilder<OUT[], Opt> {
+export declare class JArray<OUT, Opt, ARR extends OUT[] = OUT[]> extends JBuilder<ARR, Opt> {
     constructor(itemsSchema: JSchema<OUT, Opt>);
     minLength(minItems: number): this;
     maxLength(maxItems: number): this;
     length(exactLength: number): this;
     length(minItems: number, maxItems: number): this;
     exactLength(length: number): this;
+    /**
+     * Same as `minLength(1)`, but also narrows the output type to `NonEmptyArray`.
+     */
+    nonEmpty(): JArray<OUT, Opt, NonEmptyArray<OUT>>;
     unique(): this;
 }
 declare class JSet2Builder<OUT, Opt> extends JBuilder<Set2<OUT>, Opt> {

package/dist/validation/ajv/jSchema.js

@@ -942,6 +942,12 @@ export class JArray extends JBuilder {
     exactLength(length) {
         return this.minLength(length).maxLength(length);
     }
+    /**
+     * Same as `minLength(1)`, but also narrows the output type to `NonEmptyArray`.
+     */
+    nonEmpty() {
+        return this.minLength(1);
+    }
     unique() {
         return this.cloneAndUpdateSchema({ uniqueItems: true });
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/nodejs-lib",
   "type": "module",
-  "version": "15.133.0",
+  "version": "15.134.0",
   "dependencies": {
     "@naturalcycles/js-lib": "^15",
     "@standard-schema/spec": "^1",
@@ -14,7 +14,7 @@
     "yaml": "^2"
   },
   "devDependencies": {
-    "@naturalcycles/dev-lib": "20.68.0",
+    "@naturalcycles/dev-lib": "0.0.0",
     "typescript": "^7"
   },
   "exports": {

package/src/validation/ajv/jSchema.ts

@@ -20,6 +20,7 @@ import type {
   IsoDateTime,
   IsoMonth,
   Enum,
+  NonEmptyArray,
   NumberEnum,
   StringEnum,
   StringMap,
@@ -1290,7 +1291,7 @@ export class JObjectInfer<
   }
 }
 
-export class JArray<OUT, Opt> extends JBuilder<OUT[], Opt> {
+export class JArray<OUT, Opt, ARR extends OUT[] = OUT[]> extends JBuilder<ARR, Opt> {
   constructor(itemsSchema: JSchema<OUT, Opt>) {
     super({
       type: 'array',
@@ -1317,6 +1318,13 @@ export class JArray<OUT, Opt> extends JBuilder<OUT[], Opt> {
     return this.minLength(length).maxLength(length)
   }
 
+  /**
+   * Same as `minLength(1)`, but also narrows the output type to `NonEmptyArray`.
+   */
+  nonEmpty(): JArray<OUT, Opt, NonEmptyArray<OUT>> {
+    return this.minLength(1) as any as JArray<OUT, Opt, NonEmptyArray<OUT>>
+  }
+
   unique(): this {
     return this.cloneAndUpdateSchema({ uniqueItems: true })
   }