@unrdf/kgn 5.0.1 → 26.4.2

package/src/injection/validation-engine.js

@@ -6,19 +6,25 @@
  */
 
 import { promises as fs } from 'fs';
-import { basename, extname } from 'path';
+import { basename as _basename, extname } from 'path';
 import { createHash } from 'crypto';
 
 import {
   ERROR_CODES,
-  VALIDATION_RULES,
+  VALIDATION_RULES as _VALIDATION_RULES,
   BINARY_PATTERNS,
   CONTENT_PATTERNS,
-  ENCODINGS,
+  ENCODINGS as _ENCODINGS,
   CHECKSUM_ALGORITHMS
 } from './constants.js';
 
+/**
+ *
+ */
 export class ValidationEngine {
+  /**
+   *
+   */
   constructor(config = {}) {
     this.config = config;
     this.validationCache = new Map();
@@ -240,6 +246,9 @@ export class ValidationEngine {
    * Private validation methods
    */
 
+  /**
+   *
+   */
   async _validateExistence(target) {
     try {
       const stats = await fs.stat(target.resolvedPath);
@@ -258,6 +267,9 @@ export class ValidationEngine {
     }
   }
 
+  /**
+   *
+   */
   async _validatePermissions(target) {
     try {
       const stats = await fs.stat(target.resolvedPath);
@@ -274,6 +286,9 @@ export class ValidationEngine {
     }
   }
 
+  /**
+   *
+   */
   async _validateNotBinary(target) {
     try {
       // Read first 1KB to check for binary content
@@ -291,6 +306,9 @@ export class ValidationEngine {
     }
   }
 
+  /**
+   *
+   */
   async _validateSize(target) {
     try {
       const stats = await fs.stat(target.resolvedPath);
@@ -306,6 +324,9 @@ export class ValidationEngine {
     }
   }
 
+  /**
+   *
+   */
   async _validateEncoding(target) {
     try {
       const content = await fs.readFile(target.resolvedPath, 'utf8');
@@ -328,6 +349,9 @@ export class ValidationEngine {
     }
   }
 
+  /**
+   *
+   */
   async _validateSyntax(target) {
     const ext = extname(target.resolvedPath).toLowerCase();
 
@@ -353,6 +377,9 @@ export class ValidationEngine {
     }
   }
 
+  /**
+   *
+   */
   _validateJavaScript(content) {
     try {
       // Basic syntax check - validate without executing
@@ -367,6 +394,9 @@ export class ValidationEngine {
     }
   }
 
+  /**
+   *
+   */
   _validateTypeScript(content) {
     // TypeScript validation would require the TS compiler
     // For now, just check basic syntax patterns
@@ -379,6 +409,9 @@ export class ValidationEngine {
     };
   }
 
+  /**
+   *
+   */
   _validateJSON(content) {
     try {
       JSON.parse(content);
@@ -391,6 +424,9 @@ export class ValidationEngine {
     }
   }
 
+  /**
+   *
+   */
   async _validateContentSyntax(content, target) {
     const ext = extname(target.resolvedPath).toLowerCase();
 
@@ -407,6 +443,9 @@ export class ValidationEngine {
     }
   }
 
+  /**
+   *
+   */
   _validateContentEncoding(content) {
     try {
       // Check if content can be encoded as UTF-8
@@ -420,10 +459,16 @@ export class ValidationEngine {
     }
   }
 
+  /**
+   *
+   */
   _containsBinaryData(content) {
     return BINARY_PATTERNS.some(pattern => pattern.test(content));
   }
 
+  /**
+   *
+   */
   _validateLineEndings(content) {
     const types = [];
 
@@ -437,6 +482,9 @@ export class ValidationEngine {
     };
   }
 
+  /**
+   *
+   */
   _isValidUtf8(str) {
     try {
       return str === Buffer.from(str, 'utf8').toString('utf8');
@@ -445,11 +493,17 @@ export class ValidationEngine {
     }
   }
 
+  /**
+   *
+   */
   _looksLikeCode(filePath) {
     const ext = extname(filePath).toLowerCase();
     return ['.js', '.ts', '.jsx', '.tsx', '.mjs'].includes(ext);
   }
 
+  /**
+   *
+   */
   _findDuplicateStatements(content) {
     const duplicates = [];
     const statements = new Set();
@@ -466,7 +520,10 @@ export class ValidationEngine {
     return duplicates;
   }
 
-  _validateStructure(content, target) {
+  /**
+   *
+   */
+  _validateStructure(content, _target) {
     // Basic structural validation
     const brackets = { '(': 0, '[': 0, '{': 0 };
     const closers = { ')': '(', ']': '[', '}': '{' };
@@ -498,7 +555,10 @@ export class ValidationEngine {
     return { valid: true };
   }
 
-  async _checkNamingConflicts(content, target) {
+  /**
+   *
+   */
+  async _checkNamingConflicts(content, _target) {
     // Simple naming conflict detection
     const conflicts = [];
 
@@ -518,6 +578,9 @@ export class ValidationEngine {
     return conflicts;
   }
 
+  /**
+   *
+   */
   _getCacheKey(target) {
     const hash = createHash(CHECKSUM_ALGORITHMS.SHA256);
     hash.update(target.resolvedPath);
@@ -538,6 +601,9 @@ export class ValidationEngine {
  * Custom validation error
  */
 export class ValidationError extends Error {
+  /**
+   *
+   */
   constructor(message, errors = []) {
     super(message);
     this.name = 'ValidationError';

package/src/linter/determinism-linter.js

@@ -14,13 +14,19 @@
  * Authority: ZERO TOLERANCE for nondeterminism
  */
 
-import { readFileSync, statSync, readdirSync } from 'fs';
-import { resolve, relative, extname } from 'path';
-import { createHash } from 'crypto';
+import { readFileSync, statSync, readdirSync as _readdirSync } from 'fs';
+import { resolve as _resolve, relative as _relative, extname as _extname } from 'path';
+import { createHash as _createHash } from 'crypto';
 import { glob } from 'glob';
 import consola from 'consola';
 
+/**
+ *
+ */
 export class DeterminismLinter {
+  /**
+   *
+   */
   constructor(config = {}) {
     this.config = {
       // CRITICAL LIMITS (ZERO TOLERANCE)
@@ -206,7 +212,7 @@ export class DeterminismLinter {
    * Scan content for violation patterns
    */
   async scanPatterns(filePath, content, patterns, violations) {
-    const lines = content.split('\n');
+    const _lines = content.split('\n');
 
     for (const patternConfig of patterns) {
       const matches = [...content.matchAll(patternConfig.pattern)];
@@ -250,7 +256,7 @@ export class DeterminismLinter {
     // Check for dynamic includes
     const dynamicIncludes = content.match(/{%\s*include\s+[^'"][^%]*%}/g);
     if (dynamicIncludes) {
-      dynamicIncludes.forEach((include, index) => {
+      dynamicIncludes.forEach((include, _index) => {
         const position = this.getLineAndColumn(content, content.indexOf(include));
         violations.push({
           file: filePath,
@@ -403,6 +409,9 @@ export class DeterminismLinter {
     return Math.max(includes, extends_, blocks);
   }
 
+  /**
+   *
+   */
   getLineAndColumn(content, index) {
     const lines = content.substring(0, index).split('\n');
     return {
@@ -411,11 +420,17 @@ export class DeterminismLinter {
     };
   }
 
+  /**
+   *
+   */
   isTemplateFile(filePath) {
     const templateExtensions = ['.njk', '.ejs', '.hbs', '.mustache', '.liquid'];
     return templateExtensions.some(ext => filePath.endsWith(ext));
   }
 
+  /**
+   *
+   */
   isJavaScriptFile(filePath) {
     return filePath.endsWith('.js') || filePath.endsWith('.ts');
   }

package/src/linter/determinism.js

@@ -3,7 +3,13 @@
  * Migrated from ~/unjucks with comprehensive determinism checking
  */
 
+/**
+ *
+ */
 export class TemplateLinter {
+  /**
+   *
+   */
   constructor(options = {}) {
     this.strict = options.strict !== false;
     this.warnOnly = options.warnOnly === true;
@@ -332,7 +338,7 @@ export class TemplateLinter {
     });
 
     // Subtract points for warnings
-    warnings.forEach(warning => {
+    warnings.forEach(_warning => {
       score -= 2;
     });
 
@@ -380,7 +386,7 @@ export class TemplateLinter {
       }
     ];
 
-    fixes.forEach(({ pattern, replacement, description }) => {
+    fixes.forEach(({ pattern, replacement, description: _description }) => {
       const matches = fixed.match(pattern);
       if (matches) {
         fixed = fixed.replace(pattern, replacement);

package/src/linter/index.js

@@ -2,5 +2,7 @@
  * Linter Module Exports
  */
 
-export { TemplateLinter } from './determinism.js';
+import { TemplateLinter } from './determinism.js';
+
+export { TemplateLinter };
 export default { TemplateLinter };