driftdetect-core 0.1.0

package/dist/parsers/json-parser.d.ts

@@ -0,0 +1,219 @@
+/**
+ * JSON Parser - JSON/YAML/JSONC parsing for AST extraction
+ *
+ * Extracts schema information, keys, types, nested structures,
+ * arrays, and objects from JSON-like files using native parsing.
+ *
+ * @requirements 3.2
+ */
+import { BaseParser } from './base-parser.js';
+import type { AST, ASTNode, Language, ParseResult, Position } from './types.js';
+/**
+ * JSON value types
+ */
+export type JSONValueType = 'object' | 'array' | 'string' | 'number' | 'boolean' | 'null';
+/**
+ * Information about a JSON key-value pair
+ */
+export interface JSONKeyInfo {
+    /** The key name */
+    key: string;
+    /** Full path to this key (e.g., "root.nested.key") */
+    path: string;
+    /** Type of the value */
+    valueType: JSONValueType;
+    /** The actual value (for primitives) */
+    value: unknown;
+    /** Depth in the structure (0 = root level) */
+    depth: number;
+    /** Parent key path */
+    parentPath: string | null;
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Information about a JSON object
+ */
+export interface JSONObjectInfo {
+    /** Full path to this object */
+    path: string;
+    /** Keys in this object */
+    keys: string[];
+    /** Depth in the structure */
+    depth: number;
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Information about a JSON array
+ */
+export interface JSONArrayInfo {
+    /** Full path to this array */
+    path: string;
+    /** Number of elements */
+    length: number;
+    /** Types of elements in the array */
+    elementTypes: JSONValueType[];
+    /** Whether all elements are the same type */
+    isHomogeneous: boolean;
+    /** Depth in the structure */
+    depth: number;
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Schema information extracted from JSON
+ */
+export interface JSONSchemaInfo {
+    /** Root type of the JSON */
+    rootType: JSONValueType;
+    /** All key paths found */
+    keyPaths: string[];
+    /** All unique keys */
+    uniqueKeys: string[];
+    /** Maximum nesting depth */
+    maxDepth: number;
+    /** Total number of keys */
+    totalKeys: number;
+    /** Total number of arrays */
+    totalArrays: number;
+    /** Total number of objects */
+    totalObjects: number;
+}
+/**
+ * Extended parse result with JSON-specific information
+ */
+export interface JSONParseResult extends ParseResult {
+    /** Extracted keys */
+    keys: JSONKeyInfo[];
+    /** Extracted objects */
+    objects: JSONObjectInfo[];
+    /** Extracted arrays */
+    arrays: JSONArrayInfo[];
+    /** Schema information */
+    schema: JSONSchemaInfo;
+    /** The parsed JSON value */
+    parsedValue: unknown;
+}
+/**
+ * JSON/YAML/JSONC parser using native parsing.
+ *
+ * Provides AST parsing and extraction of schema information,
+ * keys, types, and nested structures from JSON-like source files.
+ *
+ * @requirements 3.2 - Support JSON/YAML parsing
+ * @requirements 3.3 - Graceful degradation on parse errors
+ */
+export declare class JSONParser extends BaseParser {
+    readonly language: Language;
+    readonly extensions: string[];
+    /**
+     * Parse JSON/YAML source code into an AST.
+     *
+     * @param source - The source code to parse
+     * @param filePath - Optional file path for error reporting
+     * @returns JSONParseResult containing the AST and extracted information
+     *
+     * @requirements 3.2, 3.3
+     */
+    parse(source: string, filePath?: string): JSONParseResult;
+    /**
+     * Query the AST for nodes matching a pattern.
+     *
+     * Supports querying by node type (e.g., 'Object', 'Array', 'Property', 'String', 'Number').
+     * Also supports querying by key path pattern (e.g., '$.config.*', '$.items[*]').
+     *
+     * @param ast - The AST to query
+     * @param pattern - The node type or key path pattern to search for
+     * @returns Array of matching AST nodes
+     *
+     * @requirements 3.5
+     */
+    query(ast: AST, pattern: string): ASTNode[];
+    /**
+     * Check if a file is a YAML file based on extension.
+     */
+    private isYamlFile;
+    /**
+     * Check if a file is a JSONC file based on extension.
+     */
+    private isJsoncFile;
+    /**
+     * Strip comments from JSONC source.
+     * Handles both single-line (//) and multi-line (/* *\/) comments.
+     */
+    private stripJsonComments;
+    /**
+     * Convert simple YAML to JSON.
+     * This is a basic implementation that handles common YAML patterns.
+     */
+    private convertYamlToJson;
+    /**
+     * Strip inline comments from a YAML value.
+     * Handles comments that appear after values (e.g., "value # comment").
+     */
+    private stripYamlInlineComment;
+    /**
+     * Parse a YAML value to its JavaScript equivalent.
+     */
+    private parseYamlValue;
+    /**
+     * Parse a YAML inline array like [1, 2, 3].
+     */
+    private parseYamlInlineArray;
+    /**
+     * Extract structure information from parsed JSON.
+     */
+    private extractStructure;
+    /**
+     * Get the JSON value type.
+     */
+    private getValueType;
+    /**
+     * Check if a value is a primitive type.
+     */
+    private isPrimitive;
+    /**
+     * Build schema information from extracted data.
+     */
+    private buildSchema;
+    /**
+     * Create an empty schema for error cases.
+     */
+    private createEmptySchema;
+    /**
+     * Build an AST node from a JSON value.
+     */
+    private buildASTNode;
+    /**
+     * Find the position of a path in the source.
+     */
+    private findPositionForPath;
+    /**
+     * Find the position of a key in the source.
+     */
+    private findPositionForKey;
+    /**
+     * Escape special regex characters.
+     */
+    private escapeRegex;
+    /**
+     * Extract error position from JSON parse error message.
+     */
+    private extractErrorPosition;
+    /**
+     * Convert a character offset to a position.
+     */
+    private offsetToPosition;
+    /**
+     * Query the AST using a JSONPath-like pattern.
+     */
+    private queryByPath;
+}
+//# sourceMappingURL=json-parser.d.ts.map

package/dist/parsers/json-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/json-parser.ts"],"names":[],"mappings":"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"}