@naturalcycles/nodejs-lib 15.107.1 → 15.107.3

package/dist/util/git2.d.ts

@@ -7,7 +7,7 @@ declare class Git2 {
     commitMessageToTitleMessage(msg: string): string;
     hasUncommittedChanges(): boolean;
     /**
-     * Returns true if there were changes
+     * @returns true if there were changes
      */
     commitAll(msg: string): boolean;
     /**
@@ -22,6 +22,14 @@ declare class Git2 {
     getCurrentBranchName(): string;
     getCurrentRepoName(): string;
     getAllBranchesNames(): string[];
+    gitRefExists(ref: string): boolean;
+    getTrackedFiles(): string[];
+    getUntrackedFiles(): string[];
+    getTrackedChangedFiles(diffBase: string, diffFilter?: string): string[];
+    /**
+     * @returns both tracked changed and untracked files
+     */
+    getAllChangedFiles(diffBase: string): string[];
 }
 export declare const git2: Git2;
 export {};

package/dist/util/git2.js

@@ -1,5 +1,6 @@
 import { execSync } from 'node:child_process';
 import { basename } from 'node:path';
+import { _uniq } from '@naturalcycles/js-lib/array';
 import { exec2 } from '../exec2/exec2.js';
 /**
  * Set of utility functions to work with git.
@@ -26,7 +27,7 @@ class Git2 {
         }
     }
     /**
-     * Returns true if there were changes
+     * @returns true if there were changes
      */
     commitAll(msg) {
         // git commit -a -m "style(lint-all): $GIT_MSG" || true
@@ -120,5 +121,56 @@ class Git2 {
             .filter(s => !s.includes(' -> '))
             .map(s => s.split('/')[1]);
     }
+    gitRefExists(ref) {
+        try {
+            exec2.exec(`git rev-parse --verify --quiet ${ref}`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    getTrackedFiles() {
+        try {
+            return exec2
+                .exec('git ls-files')
+                .split('\n')
+                .filter(s => s.trim().length);
+        }
+        catch {
+            return [];
+        }
+    }
+    getUntrackedFiles() {
+        try {
+            return exec2
+                .exec('git ls-files --others --exclude-standard')
+                .split('\n')
+                .filter(s => s.trim().length);
+        }
+        catch {
+            return [];
+        }
+    }
+    getTrackedChangedFiles(diffBase, diffFilter = 'AMR') {
+        try {
+            return exec2
+                .exec(`git diff --name-only --diff-filter=${diffFilter} ${diffBase}`)
+                .split('\n')
+                .filter(s => s.trim().length);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * @returns both tracked changed and untracked files
+     */
+    getAllChangedFiles(diffBase) {
+        const tracked = this.getTrackedChangedFiles(diffBase);
+        const untracked = this.getUntrackedFiles();
+        const changes = [...tracked, ...untracked];
+        return _uniq(changes);
+    }
 }
 export const git2 = new Git2();

package/dist/validation/ajv/jSchema.js

@@ -1178,6 +1178,9 @@ function executeValidation(fn, builtSchema, input, opt = {}, defaultInputName) {
     const errors = fn.errors;
     const { inputId = _isObject(input) ? input['id'] : undefined, inputName = defaultInputName || 'Object', } = opt;
     const dataVar = [inputName, inputId].filter(Boolean).join('.');
+    // Build fingerprint before applyImprovementsOnErrorMessages: after it, /items/0/name becomes
+    // .items[0].name, embedding the index into the segment and making it harder to strip without regex
+    const fingerprint = buildAjvErrorFingerprint(errors[0], inputName);
     applyImprovementsOnErrorMessages(errors, builtSchema);
     let message = getAjv().errorsText(errors, {
         dataVar,
@@ -1187,9 +1190,6 @@ function executeValidation(fn, builtSchema, input, opt = {}, defaultInputName) {
     // the error message Input would contain already mutated object print, such as Input: {}
     // Unless `getOriginalInput` function is provided - then it will be used to preserve the Input pureness.
     const inputStringified = _inspect(opt.getOriginalInput?.() || input, { maxLen: 4000 });
-    // fingerprint is captured before appending the dynamic Input snippet,
-    // so we can group repeated validation errors by rule rather than by unique request content.
-    const fingerprint = message;
     message = [message, 'Input: ' + inputStringified].join(separator);
     const err = new AjvValidationError(message, _filterNullishValues({
         errors,
@@ -1222,6 +1222,22 @@ function applyImprovementsOnErrorMessages(errors, schema) {
         error.instancePath = error.instancePath.replaceAll(/\/(\d+)/g, `[$1]`).replaceAll('/', '.');
     }
 }
+/**
+ * Groups repeated validation errors by rule rather than by unique request content.
+ * Excludes instance-specific data like record IDs and array indices.
+ */
+function buildAjvErrorFingerprint(e, inputName) {
+    const value = Object.values(e.params || {})[0];
+    let rule = e.keyword;
+    if (value !== undefined)
+        rule += `:${value}`;
+    const path = e.instancePath
+        .split('/')
+        .filter(s => s && isNaN(Number(s)))
+        .join('.');
+    const location = [inputName, path].filter(Boolean).join('.');
+    return [location, rule].join(' ');
+}
 /**
  * Filters out noisy errors produced by nullable anyOf patterns.
  * When `nullable()` wraps a schema in `anyOf: [realSchema, { type: 'null' }]`,
@@ -1362,10 +1378,7 @@ function hasNoObjectSchemas(schema) {
     else if (schema.type === 'array') {
         return !schema.items || hasNoObjectSchemas(schema.items);
     }
-    else {
-        return !!schema.type && ['string', 'number', 'integer', 'boolean', 'null'].includes(schema.type);
-    }
-    return false;
+    return !!schema.type && ['string', 'number', 'integer', 'boolean', 'null'].includes(schema.type);
 }
 /**
  * Deep copy that preserves functions in customValidations/customConversions.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/nodejs-lib",
   "type": "module",
-  "version": "15.107.1",
+  "version": "15.107.3",
   "dependencies": {
     "@naturalcycles/js-lib": "^15",
     "@standard-schema/spec": "^1",
@@ -17,7 +17,7 @@
     "yargs": "^18"
   },
   "devDependencies": {
-    "@typescript/native-preview": "7.0.0-dev.20260401.1",
+    "@typescript/native-preview": "beta",
     "@naturalcycles/dev-lib": "18.4.2"
   },
   "exports": {

package/src/util/git2.ts

@@ -1,5 +1,6 @@
 import { execSync } from 'node:child_process'
 import { basename } from 'node:path'
+import { _uniq } from '@naturalcycles/js-lib/array'
 import type { UnixTimestamp } from '@naturalcycles/js-lib/types'
 import { exec2 } from '../exec2/exec2.js'
 
@@ -30,7 +31,7 @@ class Git2 {
   }
 
   /**
-   * Returns true if there were changes
+   * @returns true if there were changes
    */
   commitAll(msg: string): boolean {
     // git commit -a -m "style(lint-all): $GIT_MSG" || true
@@ -134,6 +135,59 @@ class Git2 {
       .filter(s => !s.includes(' -> '))
       .map(s => s.split('/')[1]!)
   }
+
+  gitRefExists(ref: string): boolean {
+    try {
+      exec2.exec(`git rev-parse --verify --quiet ${ref}`)
+      return true
+    } catch {
+      return false
+    }
+  }
+
+  getTrackedFiles(): string[] {
+    try {
+      return exec2
+        .exec('git ls-files')
+        .split('\n')
+        .filter(s => s.trim().length)
+    } catch {
+      return []
+    }
+  }
+
+  getUntrackedFiles(): string[] {
+    try {
+      return exec2
+        .exec('git ls-files --others --exclude-standard')
+        .split('\n')
+        .filter(s => s.trim().length)
+    } catch {
+      return []
+    }
+  }
+
+  getTrackedChangedFiles(diffBase: string, diffFilter = 'AMR'): string[] {
+    try {
+      return exec2
+        .exec(`git diff --name-only --diff-filter=${diffFilter} ${diffBase}`)
+        .split('\n')
+        .filter(s => s.trim().length)
+    } catch {
+      return []
+    }
+  }
+
+  /**
+   * @returns both tracked changed and untracked files
+   */
+  getAllChangedFiles(diffBase: string): string[] {
+    const tracked = this.getTrackedChangedFiles(diffBase)
+    const untracked = this.getUntrackedFiles()
+
+    const changes = [...tracked, ...untracked]
+    return _uniq(changes)
+  }
 }
 
 export const git2 = new Git2()

package/src/validation/ajv/jSchema.ts

@@ -1692,6 +1692,10 @@ function executeValidation<OUT>(
   } = opt
   const dataVar = [inputName, inputId].filter(Boolean).join('.')
 
+  // Build fingerprint before applyImprovementsOnErrorMessages: after it, /items/0/name becomes
+  // .items[0].name, embedding the index into the segment and making it harder to strip without regex
+  const fingerprint = buildAjvErrorFingerprint(errors[0], inputName)
+
   applyImprovementsOnErrorMessages(errors, builtSchema)
 
   let message = getAjv().errorsText(errors, {
@@ -1703,9 +1707,6 @@ function executeValidation<OUT>(
   // the error message Input would contain already mutated object print, such as Input: {}
   // Unless `getOriginalInput` function is provided - then it will be used to preserve the Input pureness.
   const inputStringified = _inspect(opt.getOriginalInput?.() || input, { maxLen: 4000 })
-  // fingerprint is captured before appending the dynamic Input snippet,
-  // so we can group repeated validation errors by rule rather than by unique request content.
-  const fingerprint = message
   message = [message, 'Input: ' + inputStringified].join(separator)
 
   const err = new AjvValidationError(
@@ -1723,7 +1724,7 @@ function executeValidation<OUT>(
 // ==== Error formatting helpers ====
 
 function applyImprovementsOnErrorMessages(
-  errors: ErrorObject<string, Record<string, any>, unknown>[] | null | undefined,
+  errors: ErrorObject[] | null | undefined,
   schema: JsonSchema,
 ): void {
   if (!errors) return
@@ -1750,16 +1751,29 @@ function applyImprovementsOnErrorMessages(
   }
 }
 
+/**
+ * Groups repeated validation errors by rule rather than by unique request content.
+ * Excludes instance-specific data like record IDs and array indices.
+ */
+function buildAjvErrorFingerprint(e: ErrorObject, inputName: string): string {
+  const value = Object.values(e.params || {})[0]
+  let rule = e.keyword
+  if (value !== undefined) rule += `:${value}`
+  const path = e.instancePath
+    .split('/')
+    .filter(s => s && isNaN(Number(s)))
+    .join('.')
+  const location = [inputName, path].filter(Boolean).join('.')
+  return [location, rule].join(' ')
+}
+
 /**
  * Filters out noisy errors produced by nullable anyOf patterns.
  * When `nullable()` wraps a schema in `anyOf: [realSchema, { type: 'null' }]`,
  * AJV produces "must be null" and "must match a schema in anyOf" errors
  * that are confusing. This method splices them out, keeping only the real errors.
  */
-function filterNullableAnyOfErrors(
-  errors: ErrorObject<string, Record<string, any>, unknown>[],
-  schema: JsonSchema,
-): void {
+function filterNullableAnyOfErrors(errors: ErrorObject[], schema: JsonSchema): void {
   // Collect exact schemaPaths to remove (anyOf aggregates) and prefixes (null branches)
   const exactPaths: string[] = []
   const nullBranchPrefixes: string[] = []
@@ -1919,11 +1933,9 @@ function hasNoObjectSchemas(schema: JsonSchema): boolean {
     return true
   } else if (schema.type === 'array') {
     return !schema.items || hasNoObjectSchemas(schema.items)
-  } else {
-    return !!schema.type && ['string', 'number', 'integer', 'boolean', 'null'].includes(schema.type)
   }
 
-  return false
+  return !!schema.type && ['string', 'number', 'integer', 'boolean', 'null'].includes(schema.type)
 }
 
 type EnumBaseType = 'string' | 'number' | 'other'