@futdevpro/fsm-dynamo 1.16.7 → 1.16.10

package/src/_collections/utils/json-error-helper.util.spec.ts

@@ -1,521 +1,521 @@
-import { DyFM_JsonErrorHelper, JsonErrorLineInfo } from './json-error-helper.util';
-
-describe('| DyFM_JsonErrorHelper', (): void => {
-
-  describe('| extractLineInfoFromJsonError', (): void => {
-    it('| should extract line info from error with position', (): void => {
-      const errorMessage = 'Expected property name or "}" in JSON at position 10';
-      const jsonInput = '{"name": "John", "age": 30}';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-
-      expect(result).not.toBeNull();
-      expect(result?.lineNumber).toBe(1);
-      expect(result?.characterPosition).toBe(10);
-      expect(result?.contextLines).toContain(jsonInput);
-    });
-
-    it('| should handle multi-line JSON with position', (): void => {
-      const errorMessage = 'Unexpected token } in JSON at position 25';
-      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-
-      expect(result).not.toBeNull();
-      expect(result?.lineNumber).toBeGreaterThan(0);
-      expect(result?.contextLines.length).toBeGreaterThan(0);
-    });
-
-    it('| should return null for error without position', (): void => {
-      const errorMessage = 'Invalid JSON format';
-      const jsonInput = '{"name": "John"}';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-
-      expect(result).toBeNull();
-    });
-
-    it('| should handle "Unexpected end of JSON input" error', (): void => {
-      const errorMessage = 'Unexpected end of JSON input at position 14';
-      const jsonInput = '{"name": "John"';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-
-      expect(result).not.toBeNull();
-      expect(result?.lineNumber).toBeGreaterThan(0);
-    });
-
-    it('| should use custom contextLines parameter', (): void => {
-      const errorMessage = 'Expected property name or "}" in JSON at position 10';
-      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput, 2);
-
-      expect(result).not.toBeNull();
-      if (result) {
-        expect(result.contextLines.length).toBeLessThanOrEqual(5);
-      }
-    });
-
-    it('| should handle position beyond string length', (): void => {
-      const errorMessage = 'Unexpected token in JSON at position 1000';
-      const jsonInput = '{"name": "John"}';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-
-      expect(result).toBeNull();
-    });
-
-    it('| should handle invalid position values', (): void => {
-      const errorMessage = 'Unexpected token in JSON at position -1';
-      const jsonInput = '{"name": "John"}';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-
-      expect(result).toBeNull();
-    });
-  });
-
-  describe('| formatJsonErrorForLogging', (): void => {
-    it('| should format error with line info', (): void => {
-      const lineInfo: JsonErrorLineInfo = {
-        lineNumber: 2,
-        contextLines: ['{"name": "John",', '"age": 30}'],
-        characterPosition: 5
-      };
-      const errorMessage = 'Expected property name or "}" in JSON at position 10';
-      const result = DyFM_JsonErrorHelper.formatJsonErrorForLogging(lineInfo, errorMessage);
-
-      expect(result.length).toBeGreaterThan(0);
-      expect(result[0]).toContain('JSON parsing failed');
-      expect(result.some(line => line.includes('Error at line'))).toBe(true);
-    });
-
-    it('| should include context lines in formatted output', (): void => {
-      const lineInfo: JsonErrorLineInfo = {
-        lineNumber: 1,
-        contextLines: ['{"name": "John"}'],
-        characterPosition: 5
-      };
-      const errorMessage = 'Test error';
-      const result = DyFM_JsonErrorHelper.formatJsonErrorForLogging(lineInfo, errorMessage);
-
-      expect(result.some(line => line.includes('Context'))).toBe(true);
-      expect(result.some(line => line.includes('1:'))).toBe(true);
-    });
-
-    it('| should mark error line with >>>', (): void => {
-      const lineInfo: JsonErrorLineInfo = {
-        lineNumber: 2,
-        contextLines: ['line1', 'line2', 'line3'],
-        characterPosition: 5
-      };
-      const errorMessage = 'Test error';
-      const result = DyFM_JsonErrorHelper.formatJsonErrorForLogging(lineInfo, errorMessage);
-
-      expect(result.some(line => line.includes('>>>'))).toBe(true);
-    });
-
-    it('| should handle empty context lines', (): void => {
-      const lineInfo: JsonErrorLineInfo = {
-        lineNumber: 1,
-        contextLines: [],
-        characterPosition: 0
-      };
-      const errorMessage = 'Test error';
-      const result = DyFM_JsonErrorHelper.formatJsonErrorForLogging(lineInfo, errorMessage);
-
-      expect(result.length).toBeGreaterThan(0);
-      expect(result[0]).toContain('JSON parsing failed');
-    });
-  });
-
-  describe('| parseJsonWithEnhancedError', (): void => {
-    it('| should parse valid JSON successfully', (): void => {
-      const jsonString = '{"name": "John", "age": 30}';
-      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
-
-      expect(result).toEqual({ name: 'John', age: 30 });
-    });
-
-    it('| should throw enhanced error for invalid JSON', (): void => {
-      const jsonString = '{"name": "John", "age": }';
-
-      try {
-        DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
-        fail('Expected error to be thrown');
-      } catch (error) {
-        expect(error).toBeInstanceOf(Error);
-        const errorMessage = (error as Error).message;
-        expect(errorMessage).toContain('JSON parsing failed');
-      }
-    });
-
-    it('| should throw error for null input', (): void => {
-      try {
-        DyFM_JsonErrorHelper.parseJsonWithEnhancedError(null as any);
-        fail('Expected error to be thrown');
-      } catch (error) {
-        expect(error).toBeInstanceOf(Error);
-        expect((error as Error).message).toContain('Invalid JSON input');
-      }
-    });
-
-    it('| should throw error for undefined input', (): void => {
-      try {
-        DyFM_JsonErrorHelper.parseJsonWithEnhancedError(undefined as any);
-        fail('Expected error to be thrown');
-      } catch (error) {
-        expect(error).toBeInstanceOf(Error);
-        expect((error as Error).message).toContain('Invalid JSON input');
-      }
-    });
-
-    it('| should throw error for non-string input', (): void => {
-      try {
-        DyFM_JsonErrorHelper.parseJsonWithEnhancedError(123 as any);
-        fail('Expected error to be thrown');
-      } catch (error) {
-        expect(error).toBeInstanceOf(Error);
-        expect((error as Error).message).toContain('Invalid JSON input');
-      }
-    });
-
-    it('| should use custom contextLines parameter', (): void => {
-      const jsonString = '{"name": "John", "age": }';
-
-      try {
-        DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString, undefined, 1);
-        fail('Expected error to be thrown');
-      } catch (error) {
-        expect(error).toBeInstanceOf(Error);
-        const errorMessage = (error as Error).message;
-        expect(errorMessage).toContain('JSON parsing failed');
-      }
-    });
-
-    it('| should handle reviver function', (): void => {
-      const jsonString = '{"name": "John", "age": 30}';
-      const reviver = (key: string, value: any): any => {
-        if (key === 'age') {
-          return value * 2;
-        }
-        return value;
-      };
-      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString, reviver);
-
-      expect(result).toEqual({ name: 'John', age: 60 });
-    });
-
-    it('| should provide enhanced error for multi-line JSON', (): void => {
-      const jsonString = '{\n  "name": "John",\n  "age": \n}';
-
-      try {
-        DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
-        fail('Expected error to be thrown');
-      } catch (error) {
-        expect(error).toBeInstanceOf(Error);
-        const errorMessage = (error as Error).message;
-        expect(errorMessage).toContain('JSON parsing failed');
-      }
-    });
-
-    it('| should handle empty string', (): void => {
-      try {
-        DyFM_JsonErrorHelper.parseJsonWithEnhancedError('');
-        fail('Expected error to be thrown');
-      } catch (error) {
-        expect(error).toBeInstanceOf(Error);
-      }
-    });
-
-    it('| should parse valid JSON array', (): void => {
-      const jsonString = '[1, 2, 3, "test"]';
-      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
-
-      expect(result).toEqual([1, 2, 3, 'test']);
-    });
-
-    it('| should parse valid JSON string', (): void => {
-      const jsonString = '"simple string"';
-      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
-
-      expect(result).toBe('simple string');
-    });
-
-    it('| should parse valid JSON number', (): void => {
-      const jsonString = '42.5';
-      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
-
-      expect(result).toBe(42.5);
-    });
-
-    it('| should parse valid JSON boolean', (): void => {
-      const jsonString = 'true';
-      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
-
-      expect(result).toBe(true);
-    });
-
-    it('| should parse valid JSON null', (): void => {
-      const jsonString = 'null';
-      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
-
-      expect(result).toBeNull();
-    });
-
-    it('| should handle position at end of string', (): void => {
-      const errorMessage = 'Unexpected end of JSON input at position 14';
-      const jsonInput = '{"name": "John"}';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-
-      expect(result).not.toBeNull();
-      if (result) {
-        expect(result.lineNumber).toBeGreaterThan(0);
-      }
-    });
-
-    it('| should handle position at start of string', (): void => {
-      const errorMessage = 'Unexpected token in JSON at position 0';
-      const jsonInput = 'invalid';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-
-      expect(result).not.toBeNull();
-      if (result) {
-        expect(result.characterPosition).toBe(0);
-      }
-    });
-
-    it('| should handle very large contextLines parameter', (): void => {
-      const errorMessage = 'Expected property name or "}" in JSON at position 10';
-      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput, 100);
-
-      expect(result).not.toBeNull();
-      if (result) {
-        // The function may return more context lines than requested due to implementation
-        // We just check that it returns a reasonable number
-        expect(result.contextLines.length).toBeGreaterThan(0);
-        expect(result.contextLines.length).toBeLessThanOrEqual(100);
-      }
-    });
-
-    it('| should handle zero contextLines parameter', (): void => {
-      const errorMessage = 'Expected property name or "}" in JSON at position 10';
-      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput, 0);
-
-      expect(result).not.toBeNull();
-      if (result) {
-        expect(result.contextLines.length).toBeGreaterThan(0);
-      }
-    });
-
-    it('| should return null when position is greater than jsonInput length', (): void => {
-      // Test case for line 82-83: position > jsonInput.length returns null
-      const errorMessage = 'Unexpected end of JSON input';
-      const jsonInput = '{"name": "John"}';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput, 5);
-      expect(result).toBeNull();
-    });
-
-    it('| should handle formatJsonForBetterErrors with non-string input', (): void => {
-      // Test case for line 293-294: formatJsonForBetterErrors handles non-string input
-      const result = (DyFM_JsonErrorHelper as any).formatJsonForBetterErrors(null);
-      expect(result).toBe('');
-    });
-
-    it('| should handle formatJsonForBetterErrors with undefined input', (): void => {
-      // Test case for line 293-294: formatJsonForBetterErrors handles undefined input
-      const result = (DyFM_JsonErrorHelper as any).formatJsonForBetterErrors(undefined);
-      expect(result).toBe('');
-    });
-
-    it('| should handle formatJsonForBetterErrors with empty string', (): void => {
-      // Test case for formatJsonForBetterErrors with empty string
-      const result = (DyFM_JsonErrorHelper as any).formatJsonForBetterErrors('');
-      expect(result).toBeDefined();
-    });
-
-    it('| should handle formatJsonForBetterErrors with complex JSON', (): void => {
-      // Test case for formatJsonForBetterErrors with complex JSON formatting
-      const complexJson = '{"level1":{"level2":{"level3":"value","array":[1,2,3]},"other":"data"},"simple":"value"}';
-      const result = (DyFM_JsonErrorHelper as any).formatJsonForBetterErrors(complexJson);
-      expect(result).toBeDefined();
-      expect(result).toContain('\n');
-    });
-
-    it('| should handle extractLineInfoFromJsonError with token matching without position', (): void => {
-      // Test case for lines 60-62: token matching without position
-      const errorMessage = "Unexpected token '}'";
-      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-      
-      // Should try to find token position
-      expect(result).toBeDefined();
-    });
-
-    it('| should handle extractLineInfoFromJsonError with different error message formats', (): void => {
-      // Test various error message formats
-      const formats = [
-        'Unexpected token } in JSON at position 25',
-        'Expected property name or "}" in JSON at position 10',
-        'Unexpected end of JSON input at position 14',
-        'Unexpected token }',
-        'Expected double-quoted property name in JSON at position 5',
-      ];
-      
-      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
-      
-      formats.forEach(errorMessage => {
-        const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-        // Some may return null, some may return line info
-        expect(result === null || (result && result.lineNumber > 0)).toBeTrue();
-      });
-    });
-
-    it('| should handle extractLineInfoFromJsonError with token match but no newlines', (): void => {
-      // Test case for line 62: token matching when jsonInput doesn't include newlines
-      const errorMessage = "Unexpected token '}'";
-      const jsonInput = '{"name": "John", "age": 30}'; // No newlines
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-      
-      // Should return null when no newlines and no position
-      expect(result).toBeNull();
-    });
-
-    it('| should handle extractLineInfoFromJsonError with token found at position', (): void => {
-      // Test case for lines 65-68: token found at position
-      const errorMessage = "Unexpected token '}'";
-      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-      
-      // May or may not find the token, but should handle gracefully
-      expect(result === null || (result && result.lineNumber > 0)).toBeTrue();
-    });
-
-    it('| should handle extractLineInfoFromJsonError edge cases in position extraction', (): void => {
-      // Test edge cases: position at start, middle, end
-      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
-      
-      // Position at start
-      let result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError('Error at position 0', jsonInput);
-      expect(result === null || (result && result.characterPosition >= 0)).toBeTrue();
-      
-      // Position in middle
-      result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError('Error at position 10', jsonInput);
-      expect(result === null || (result && result.lineNumber > 0)).toBeTrue();
-      
-      // Position at end (equal to length)
-      const endPosition = jsonInput.length;
-      result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(`Error at position ${endPosition}`, jsonInput);
-      expect(result === null || (result && result.lineNumber > 0)).toBeTrue();
-    });
-
-    it('| should handle error messages with different formats', (): void => {
-      const errorMessage = 'Unexpected token } in JSON at position 25';
-      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-
-      expect(result).not.toBeNull();
-    });
-
-    it('| should handle empty error message', (): void => {
-      const errorMessage = '';
-      const jsonInput = '{"name": "John"}';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-
-      expect(result).toBeNull();
-    });
-
-    it('| should handle empty jsonInput', (): void => {
-      const errorMessage = 'Unexpected token in JSON at position 0';
-      const jsonInput = '';
-      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
-
-      expect(result).not.toBeNull();
-      if (result) {
-        expect(result.contextLines).toContain('(invalid or empty input)');
-      }
-    });
-
-    it('| should handle formatJsonErrorForLogging with single line context', (): void => {
-      const lineInfo: JsonErrorLineInfo = {
-        lineNumber: 1,
-        contextLines: ['{"name": "John"}'],
-        characterPosition: 5
-      };
-      const errorMessage = 'Test error';
-      const result = DyFM_JsonErrorHelper.formatJsonErrorForLogging(lineInfo, errorMessage);
-
-      expect(result.some(line => line.includes('>>>'))).toBe(true);
-      expect(result.some(line => line.includes('1:'))).toBe(true);
-    });
-
-    it('| should handle formatJsonErrorForLogging with multiple context lines', (): void => {
-      const lineInfo: JsonErrorLineInfo = {
-        lineNumber: 3,
-        contextLines: ['line1', 'line2', 'line3', 'line4', 'line5'],
-        characterPosition: 5
-      };
-      const errorMessage = 'Test error';
-      const result = DyFM_JsonErrorHelper.formatJsonErrorForLogging(lineInfo, errorMessage);
-
-      expect(result.some(line => line.includes('>>>'))).toBe(true);
-      expect(result.some(line => line.includes('3:'))).toBe(true);
-    });
-
-    it('| should handle formatJsonErrorForLogging with empty lines in context', (): void => {
-      const lineInfo: JsonErrorLineInfo = {
-        lineNumber: 2,
-        contextLines: ['line1', '', 'line3'],
-        characterPosition: 5
-      };
-      const errorMessage = 'Test error';
-      const result = DyFM_JsonErrorHelper.formatJsonErrorForLogging(lineInfo, errorMessage);
-
-      expect(result.some(line => line.includes('(empty line)'))).toBe(true);
-    });
-
-    it('| should handle parseJsonWithEnhancedError with complex nested JSON', (): void => {
-      const jsonString = '{"level1": {"level2": {"level3": "value"}}}';
-      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
-
-      expect(result.level1.level2.level3).toBe('value');
-    });
-
-    it('| should handle parseJsonWithEnhancedError with array containing objects', (): void => {
-      const jsonString = '[{"id": 1}, {"id": 2}]';
-      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
-
-      expect(result).toEqual([{ id: 1 }, { id: 2 }]);
-    });
-
-    it('| should handle parseJsonWithEnhancedError with special characters', (): void => {
-      const jsonString = '{"message": "Hello\\nWorld\\tTab"}';
-      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
-
-      expect(result.message).toBe('Hello\nWorld\tTab');
-    });
-
-    it('| should handle parseJsonWithEnhancedError with unicode characters', (): void => {
-      const jsonString = '{"unicode": "🚀 Test ñáéíóú"}';
-      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
-
-      expect(result.unicode).toBe('🚀 Test ñáéíóú');
-    });
-
-    it('| should handle parseJsonWithEnhancedError with scientific notation', (): void => {
-      const jsonString = '{"small": 1e-10, "large": 1e10}';
-      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
-
-      expect(result.small).toBe(1e-10);
-      expect(result.large).toBe(1e10);
-    });
-
-    it('| should handle parseJsonWithEnhancedError with reviver that returns undefined', (): void => {
-      const jsonString = '{"keep": "value", "remove": "value"}';
-      const reviver = (key: string, value: any): any => {
-        return key === 'remove' ? undefined : value;
-      };
-      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString, reviver);
-
-      expect(result.keep).toBe('value');
-      expect(result.remove).toBeUndefined();
-    });
-  });
-});
-
+import { DyFM_JsonErrorHelper, JsonErrorLineInfo } from './json-error-helper.util';
+
+describe('| DyFM_JsonErrorHelper', (): void => {
+
+  describe('| extractLineInfoFromJsonError', (): void => {
+    it('| should extract line info from error with position', (): void => {
+      const errorMessage = 'Expected property name or "}" in JSON at position 10';
+      const jsonInput = '{"name": "John", "age": 30}';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+
+      expect(result).not.toBeNull();
+      expect(result?.lineNumber).toBe(1);
+      expect(result?.characterPosition).toBe(10);
+      expect(result?.contextLines).toContain(jsonInput);
+    });
+
+    it('| should handle multi-line JSON with position', (): void => {
+      const errorMessage = 'Unexpected token } in JSON at position 25';
+      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+
+      expect(result).not.toBeNull();
+      expect(result?.lineNumber).toBeGreaterThan(0);
+      expect(result?.contextLines.length).toBeGreaterThan(0);
+    });
+
+    it('| should return null for error without position', (): void => {
+      const errorMessage = 'Invalid JSON format';
+      const jsonInput = '{"name": "John"}';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+
+      expect(result).toBeNull();
+    });
+
+    it('| should handle "Unexpected end of JSON input" error', (): void => {
+      const errorMessage = 'Unexpected end of JSON input at position 14';
+      const jsonInput = '{"name": "John"';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+
+      expect(result).not.toBeNull();
+      expect(result?.lineNumber).toBeGreaterThan(0);
+    });
+
+    it('| should use custom contextLines parameter', (): void => {
+      const errorMessage = 'Expected property name or "}" in JSON at position 10';
+      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput, 2);
+
+      expect(result).not.toBeNull();
+      if (result) {
+        expect(result.contextLines.length).toBeLessThanOrEqual(5);
+      }
+    });
+
+    it('| should handle position beyond string length', (): void => {
+      const errorMessage = 'Unexpected token in JSON at position 1000';
+      const jsonInput = '{"name": "John"}';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+
+      expect(result).toBeNull();
+    });
+
+    it('| should handle invalid position values', (): void => {
+      const errorMessage = 'Unexpected token in JSON at position -1';
+      const jsonInput = '{"name": "John"}';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+
+      expect(result).toBeNull();
+    });
+  });
+
+  describe('| formatJsonErrorForLogging', (): void => {
+    it('| should format error with line info', (): void => {
+      const lineInfo: JsonErrorLineInfo = {
+        lineNumber: 2,
+        contextLines: ['{"name": "John",', '"age": 30}'],
+        characterPosition: 5
+      };
+      const errorMessage = 'Expected property name or "}" in JSON at position 10';
+      const result = DyFM_JsonErrorHelper.formatJsonErrorForLogging(lineInfo, errorMessage);
+
+      expect(result.length).toBeGreaterThan(0);
+      expect(result[0]).toContain('JSON parsing failed');
+      expect(result.some(line => line.includes('Error at line'))).toBe(true);
+    });
+
+    it('| should include context lines in formatted output', (): void => {
+      const lineInfo: JsonErrorLineInfo = {
+        lineNumber: 1,
+        contextLines: ['{"name": "John"}'],
+        characterPosition: 5
+      };
+      const errorMessage = 'Test error';
+      const result = DyFM_JsonErrorHelper.formatJsonErrorForLogging(lineInfo, errorMessage);
+
+      expect(result.some(line => line.includes('Context'))).toBe(true);
+      expect(result.some(line => line.includes('1:'))).toBe(true);
+    });
+
+    it('| should mark error line with >>>', (): void => {
+      const lineInfo: JsonErrorLineInfo = {
+        lineNumber: 2,
+        contextLines: ['line1', 'line2', 'line3'],
+        characterPosition: 5
+      };
+      const errorMessage = 'Test error';
+      const result = DyFM_JsonErrorHelper.formatJsonErrorForLogging(lineInfo, errorMessage);
+
+      expect(result.some(line => line.includes('>>>'))).toBe(true);
+    });
+
+    it('| should handle empty context lines', (): void => {
+      const lineInfo: JsonErrorLineInfo = {
+        lineNumber: 1,
+        contextLines: [],
+        characterPosition: 0
+      };
+      const errorMessage = 'Test error';
+      const result = DyFM_JsonErrorHelper.formatJsonErrorForLogging(lineInfo, errorMessage);
+
+      expect(result.length).toBeGreaterThan(0);
+      expect(result[0]).toContain('JSON parsing failed');
+    });
+  });
+
+  describe('| parseJsonWithEnhancedError', (): void => {
+    it('| should parse valid JSON successfully', (): void => {
+      const jsonString = '{"name": "John", "age": 30}';
+      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
+
+      expect(result).toEqual({ name: 'John', age: 30 });
+    });
+
+    it('| should throw enhanced error for invalid JSON', (): void => {
+      const jsonString = '{"name": "John", "age": }';
+
+      try {
+        DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
+        fail('Expected error to be thrown');
+      } catch (error) {
+        expect(error).toBeInstanceOf(Error);
+        const errorMessage = (error as Error).message;
+        expect(errorMessage).toContain('JSON parsing failed');
+      }
+    });
+
+    it('| should throw error for null input', (): void => {
+      try {
+        DyFM_JsonErrorHelper.parseJsonWithEnhancedError(null as any);
+        fail('Expected error to be thrown');
+      } catch (error) {
+        expect(error).toBeInstanceOf(Error);
+        expect((error as Error).message).toContain('Invalid JSON input');
+      }
+    });
+
+    it('| should throw error for undefined input', (): void => {
+      try {
+        DyFM_JsonErrorHelper.parseJsonWithEnhancedError(undefined as any);
+        fail('Expected error to be thrown');
+      } catch (error) {
+        expect(error).toBeInstanceOf(Error);
+        expect((error as Error).message).toContain('Invalid JSON input');
+      }
+    });
+
+    it('| should throw error for non-string input', (): void => {
+      try {
+        DyFM_JsonErrorHelper.parseJsonWithEnhancedError(123 as any);
+        fail('Expected error to be thrown');
+      } catch (error) {
+        expect(error).toBeInstanceOf(Error);
+        expect((error as Error).message).toContain('Invalid JSON input');
+      }
+    });
+
+    it('| should use custom contextLines parameter', (): void => {
+      const jsonString = '{"name": "John", "age": }';
+
+      try {
+        DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString, undefined, 1);
+        fail('Expected error to be thrown');
+      } catch (error) {
+        expect(error).toBeInstanceOf(Error);
+        const errorMessage = (error as Error).message;
+        expect(errorMessage).toContain('JSON parsing failed');
+      }
+    });
+
+    it('| should handle reviver function', (): void => {
+      const jsonString = '{"name": "John", "age": 30}';
+      const reviver = (key: string, value: any): any => {
+        if (key === 'age') {
+          return value * 2;
+        }
+        return value;
+      };
+      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString, reviver);
+
+      expect(result).toEqual({ name: 'John', age: 60 });
+    });
+
+    it('| should provide enhanced error for multi-line JSON', (): void => {
+      const jsonString = '{\n  "name": "John",\n  "age": \n}';
+
+      try {
+        DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
+        fail('Expected error to be thrown');
+      } catch (error) {
+        expect(error).toBeInstanceOf(Error);
+        const errorMessage = (error as Error).message;
+        expect(errorMessage).toContain('JSON parsing failed');
+      }
+    });
+
+    it('| should handle empty string', (): void => {
+      try {
+        DyFM_JsonErrorHelper.parseJsonWithEnhancedError('');
+        fail('Expected error to be thrown');
+      } catch (error) {
+        expect(error).toBeInstanceOf(Error);
+      }
+    });
+
+    it('| should parse valid JSON array', (): void => {
+      const jsonString = '[1, 2, 3, "test"]';
+      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
+
+      expect(result).toEqual([1, 2, 3, 'test']);
+    });
+
+    it('| should parse valid JSON string', (): void => {
+      const jsonString = '"simple string"';
+      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
+
+      expect(result).toBe('simple string');
+    });
+
+    it('| should parse valid JSON number', (): void => {
+      const jsonString = '42.5';
+      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
+
+      expect(result).toBe(42.5);
+    });
+
+    it('| should parse valid JSON boolean', (): void => {
+      const jsonString = 'true';
+      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
+
+      expect(result).toBe(true);
+    });
+
+    it('| should parse valid JSON null', (): void => {
+      const jsonString = 'null';
+      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
+
+      expect(result).toBeNull();
+    });
+
+    it('| should handle position at end of string', (): void => {
+      const errorMessage = 'Unexpected end of JSON input at position 14';
+      const jsonInput = '{"name": "John"}';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+
+      expect(result).not.toBeNull();
+      if (result) {
+        expect(result.lineNumber).toBeGreaterThan(0);
+      }
+    });
+
+    it('| should handle position at start of string', (): void => {
+      const errorMessage = 'Unexpected token in JSON at position 0';
+      const jsonInput = 'invalid';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+
+      expect(result).not.toBeNull();
+      if (result) {
+        expect(result.characterPosition).toBe(0);
+      }
+    });
+
+    it('| should handle very large contextLines parameter', (): void => {
+      const errorMessage = 'Expected property name or "}" in JSON at position 10';
+      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput, 100);
+
+      expect(result).not.toBeNull();
+      if (result) {
+        // The function may return more context lines than requested due to implementation
+        // We just check that it returns a reasonable number
+        expect(result.contextLines.length).toBeGreaterThan(0);
+        expect(result.contextLines.length).toBeLessThanOrEqual(100);
+      }
+    });
+
+    it('| should handle zero contextLines parameter', (): void => {
+      const errorMessage = 'Expected property name or "}" in JSON at position 10';
+      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput, 0);
+
+      expect(result).not.toBeNull();
+      if (result) {
+        expect(result.contextLines.length).toBeGreaterThan(0);
+      }
+    });
+
+    it('| should return null when position is greater than jsonInput length', (): void => {
+      // Test case for line 82-83: position > jsonInput.length returns null
+      const errorMessage = 'Unexpected end of JSON input';
+      const jsonInput = '{"name": "John"}';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput, 5);
+      expect(result).toBeNull();
+    });
+
+    it('| should handle formatJsonForBetterErrors with non-string input', (): void => {
+      // Test case for line 293-294: formatJsonForBetterErrors handles non-string input
+      const result = (DyFM_JsonErrorHelper as any).formatJsonForBetterErrors(null);
+      expect(result).toBe('');
+    });
+
+    it('| should handle formatJsonForBetterErrors with undefined input', (): void => {
+      // Test case for line 293-294: formatJsonForBetterErrors handles undefined input
+      const result = (DyFM_JsonErrorHelper as any).formatJsonForBetterErrors(undefined);
+      expect(result).toBe('');
+    });
+
+    it('| should handle formatJsonForBetterErrors with empty string', (): void => {
+      // Test case for formatJsonForBetterErrors with empty string
+      const result = (DyFM_JsonErrorHelper as any).formatJsonForBetterErrors('');
+      expect(result).toBeDefined();
+    });
+
+    it('| should handle formatJsonForBetterErrors with complex JSON', (): void => {
+      // Test case for formatJsonForBetterErrors with complex JSON formatting
+      const complexJson = '{"level1":{"level2":{"level3":"value","array":[1,2,3]},"other":"data"},"simple":"value"}';
+      const result = (DyFM_JsonErrorHelper as any).formatJsonForBetterErrors(complexJson);
+      expect(result).toBeDefined();
+      expect(result).toContain('\n');
+    });
+
+    it('| should handle extractLineInfoFromJsonError with token matching without position', (): void => {
+      // Test case for lines 60-62: token matching without position
+      const errorMessage = "Unexpected token '}'";
+      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+      
+      // Should try to find token position
+      expect(result).toBeDefined();
+    });
+
+    it('| should handle extractLineInfoFromJsonError with different error message formats', (): void => {
+      // Test various error message formats
+      const formats = [
+        'Unexpected token } in JSON at position 25',
+        'Expected property name or "}" in JSON at position 10',
+        'Unexpected end of JSON input at position 14',
+        'Unexpected token }',
+        'Expected double-quoted property name in JSON at position 5',
+      ];
+      
+      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
+      
+      formats.forEach(errorMessage => {
+        const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+        // Some may return null, some may return line info
+        expect(result === null || (result && result.lineNumber > 0)).toBeTrue();
+      });
+    });
+
+    it('| should handle extractLineInfoFromJsonError with token match but no newlines', (): void => {
+      // Test case for line 62: token matching when jsonInput doesn't include newlines
+      const errorMessage = "Unexpected token '}'";
+      const jsonInput = '{"name": "John", "age": 30}'; // No newlines
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+      
+      // Should return null when no newlines and no position
+      expect(result).toBeNull();
+    });
+
+    it('| should handle extractLineInfoFromJsonError with token found at position', (): void => {
+      // Test case for lines 65-68: token found at position
+      const errorMessage = "Unexpected token '}'";
+      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+      
+      // May or may not find the token, but should handle gracefully
+      expect(result === null || (result && result.lineNumber > 0)).toBeTrue();
+    });
+
+    it('| should handle extractLineInfoFromJsonError edge cases in position extraction', (): void => {
+      // Test edge cases: position at start, middle, end
+      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
+      
+      // Position at start
+      let result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError('Error at position 0', jsonInput);
+      expect(result === null || (result && result.characterPosition >= 0)).toBeTrue();
+      
+      // Position in middle
+      result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError('Error at position 10', jsonInput);
+      expect(result === null || (result && result.lineNumber > 0)).toBeTrue();
+      
+      // Position at end (equal to length)
+      const endPosition = jsonInput.length;
+      result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(`Error at position ${endPosition}`, jsonInput);
+      expect(result === null || (result && result.lineNumber > 0)).toBeTrue();
+    });
+
+    it('| should handle error messages with different formats', (): void => {
+      const errorMessage = 'Unexpected token } in JSON at position 25';
+      const jsonInput = '{\n  "name": "John",\n  "age": 30\n}';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+
+      expect(result).not.toBeNull();
+    });
+
+    it('| should handle empty error message', (): void => {
+      const errorMessage = '';
+      const jsonInput = '{"name": "John"}';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+
+      expect(result).toBeNull();
+    });
+
+    it('| should handle empty jsonInput', (): void => {
+      const errorMessage = 'Unexpected token in JSON at position 0';
+      const jsonInput = '';
+      const result = DyFM_JsonErrorHelper.extractLineInfoFromJsonError(errorMessage, jsonInput);
+
+      expect(result).not.toBeNull();
+      if (result) {
+        expect(result.contextLines).toContain('(invalid or empty input)');
+      }
+    });
+
+    it('| should handle formatJsonErrorForLogging with single line context', (): void => {
+      const lineInfo: JsonErrorLineInfo = {
+        lineNumber: 1,
+        contextLines: ['{"name": "John"}'],
+        characterPosition: 5
+      };
+      const errorMessage = 'Test error';
+      const result = DyFM_JsonErrorHelper.formatJsonErrorForLogging(lineInfo, errorMessage);
+
+      expect(result.some(line => line.includes('>>>'))).toBe(true);
+      expect(result.some(line => line.includes('1:'))).toBe(true);
+    });
+
+    it('| should handle formatJsonErrorForLogging with multiple context lines', (): void => {
+      const lineInfo: JsonErrorLineInfo = {
+        lineNumber: 3,
+        contextLines: ['line1', 'line2', 'line3', 'line4', 'line5'],
+        characterPosition: 5
+      };
+      const errorMessage = 'Test error';
+      const result = DyFM_JsonErrorHelper.formatJsonErrorForLogging(lineInfo, errorMessage);
+
+      expect(result.some(line => line.includes('>>>'))).toBe(true);
+      expect(result.some(line => line.includes('3:'))).toBe(true);
+    });
+
+    it('| should handle formatJsonErrorForLogging with empty lines in context', (): void => {
+      const lineInfo: JsonErrorLineInfo = {
+        lineNumber: 2,
+        contextLines: ['line1', '', 'line3'],
+        characterPosition: 5
+      };
+      const errorMessage = 'Test error';
+      const result = DyFM_JsonErrorHelper.formatJsonErrorForLogging(lineInfo, errorMessage);
+
+      expect(result.some(line => line.includes('(empty line)'))).toBe(true);
+    });
+
+    it('| should handle parseJsonWithEnhancedError with complex nested JSON', (): void => {
+      const jsonString = '{"level1": {"level2": {"level3": "value"}}}';
+      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
+
+      expect(result.level1.level2.level3).toBe('value');
+    });
+
+    it('| should handle parseJsonWithEnhancedError with array containing objects', (): void => {
+      const jsonString = '[{"id": 1}, {"id": 2}]';
+      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
+
+      expect(result).toEqual([{ id: 1 }, { id: 2 }]);
+    });
+
+    it('| should handle parseJsonWithEnhancedError with special characters', (): void => {
+      const jsonString = '{"message": "Hello\\nWorld\\tTab"}';
+      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
+
+      expect(result.message).toBe('Hello\nWorld\tTab');
+    });
+
+    it('| should handle parseJsonWithEnhancedError with unicode characters', (): void => {
+      const jsonString = '{"unicode": "🚀 Test ñáéíóú"}';
+      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
+
+      expect(result.unicode).toBe('🚀 Test ñáéíóú');
+    });
+
+    it('| should handle parseJsonWithEnhancedError with scientific notation', (): void => {
+      const jsonString = '{"small": 1e-10, "large": 1e10}';
+      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString);
+
+      expect(result.small).toBe(1e-10);
+      expect(result.large).toBe(1e10);
+    });
+
+    it('| should handle parseJsonWithEnhancedError with reviver that returns undefined', (): void => {
+      const jsonString = '{"keep": "value", "remove": "value"}';
+      const reviver = (key: string, value: any): any => {
+        return key === 'remove' ? undefined : value;
+      };
+      const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(jsonString, reviver);
+
+      expect(result.keep).toBe('value');
+      expect(result.remove).toBeUndefined();
+    });
+  });
+});
+