json-rescue 0.0.1 → 0.2.2

package/CHANGELOG.md

@@ -0,0 +1,3 @@
+# Changelog
+
+## [0.2.1](https://github.com/azeemmirza/json-rescue/compare/0.2.0...0.2.1) (2026-02-20)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 json-rescue contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -84,7 +84,7 @@ Typical environments where this breaks:
 ### 3.1 Version Roadmap (Planned)
 
 ```text
-v0.1.0 (Core) → v0.2.0 → v0.3.0 → v0.4.0 → v1.0.0
+v0.1.0 (Core) → v0.2.1 → v0.3.0 → v0.4.0 → v1.0.0
      │            │         │         │         │
      ▼            ▼         ▼         ▼         ▼
  Extract +     Repair     Multi +   Streaming  Stable

package/dist/extraction.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Extraction strategies for finding JSON in messy text
+ */
+import { ExtractionCandidate } from './types';
+/**
+ * Extract JSON from Markdown code blocks (```json ... ```)
+ */
+export declare function extractFromMarkdown(text: string): ExtractionCandidate[];
+/**
+ * Extract JSON using balanced braces/brackets (string-aware)
+ * Handles nested structures and respects string boundaries
+ */
+export declare function extractBalancedBraces(text: string): ExtractionCandidate[];
+/**
+ * Extract all JSON candidates from text
+ */
+export declare function extractAllCandidates(text: string): ExtractionCandidate[];
+//# sourceMappingURL=extraction.d.ts.map

package/dist/extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.d.ts","sourceRoot":"","sources":["../src/extraction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAoBvE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAuBzE;AA0DD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAgBxE"}

package/dist/extraction.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Extraction strategies for finding JSON in messy text
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractFromMarkdown = extractFromMarkdown;
+exports.extractBalancedBraces = extractBalancedBraces;
+exports.extractAllCandidates = extractAllCandidates;
+/**
+ * Extract JSON from Markdown code blocks (```json ... ```)
+ */
+function extractFromMarkdown(text) {
+    const candidates = [];
+    // Match ```json ... ``` blocks
+    const markdownRegex = /```json\s*\n([\s\S]*?)```/g;
+    let match;
+    while ((match = markdownRegex.exec(text)) !== null) {
+        const jsonText = match[1].trim();
+        if (jsonText) {
+            candidates.push({
+                text: jsonText,
+                source: 'markdown',
+                startIndex: match.index,
+                endIndex: match.index + match[0].length,
+            });
+        }
+    }
+    return candidates;
+}
+/**
+ * Extract JSON using balanced braces/brackets (string-aware)
+ * Handles nested structures and respects string boundaries
+ */
+function extractBalancedBraces(text) {
+    const candidates = [];
+    for (let i = 0; i < text.length; i++) {
+        const char = text[i];
+        // Look for object or array start
+        if (char === '{' || char === '[') {
+            const result = extractBalancedRegion(text, i);
+            if (result) {
+                const { endIndex, extracted } = result;
+                candidates.push({
+                    text: extracted,
+                    source: 'balanced-braces',
+                    startIndex: i,
+                    endIndex,
+                });
+                i = endIndex - 1; // Move past this candidate
+            }
+        }
+    }
+    return candidates;
+}
+/**
+ * Extract a balanced region from startIndex, respecting string boundaries
+ */
+function extractBalancedRegion(text, startIndex) {
+    const opening = text[startIndex];
+    const closing = opening === '{' ? '}' : ']';
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = startIndex; i < text.length; i++) {
+        const char = text[i];
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (char === '\\' && inString) {
+            escaped = true;
+            continue;
+        }
+        if (char === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (!inString) {
+            if (char === opening) {
+                depth++;
+            }
+            else if (char === closing) {
+                depth--;
+                if (depth === 0) {
+                    const extracted = text.substring(startIndex, i + 1);
+                    // Validate it looks like valid JSON structure
+                    if (extracted.trim().length > 2) {
+                        return {
+                            endIndex: i + 1,
+                            extracted,
+                        };
+                    }
+                    return null;
+                }
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Extract all JSON candidates from text
+ */
+function extractAllCandidates(text) {
+    const markdown = extractFromMarkdown(text);
+    const balanced = extractBalancedBraces(text);
+    // Combine and deduplicate by content
+    const seen = new Set();
+    const all = [];
+    for (const candidate of [...markdown, ...balanced]) {
+        if (!seen.has(candidate.text)) {
+            seen.add(candidate.text);
+            all.push(candidate);
+        }
+    }
+    return all;
+}
+//# sourceMappingURL=extraction.js.map

package/dist/extraction.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * json-rescue - Extract, repair, and parse JSON from messy real-world text
+ * @packageDocumentation
+ */
+export { rescueJson } from './rescue';
+export type { RescueResult, RescueOptions, RepairIssue, ExtractionCandidate } from './types';
+export { extractAllCandidates, extractFromMarkdown, extractBalancedBraces } from './extraction';
+export { autoRepair, repairTrailingCommas, repairJsoncComments, repairSmartQuotes } from './repair';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAG7F,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGhG,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * json-rescue - Extract, repair, and parse JSON from messy real-world text
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.repairSmartQuotes = exports.repairJsoncComments = exports.repairTrailingCommas = exports.autoRepair = exports.extractBalancedBraces = exports.extractFromMarkdown = exports.extractAllCandidates = exports.rescueJson = void 0;
+var rescue_1 = require("./rescue");
+Object.defineProperty(exports, "rescueJson", { enumerable: true, get: function () { return rescue_1.rescueJson; } });
+// Re-export extraction utilities
+var extraction_1 = require("./extraction");
+Object.defineProperty(exports, "extractAllCandidates", { enumerable: true, get: function () { return extraction_1.extractAllCandidates; } });
+Object.defineProperty(exports, "extractFromMarkdown", { enumerable: true, get: function () { return extraction_1.extractFromMarkdown; } });
+Object.defineProperty(exports, "extractBalancedBraces", { enumerable: true, get: function () { return extraction_1.extractBalancedBraces; } });
+// Re-export repair utilities
+var repair_1 = require("./repair");
+Object.defineProperty(exports, "autoRepair", { enumerable: true, get: function () { return repair_1.autoRepair; } });
+Object.defineProperty(exports, "repairTrailingCommas", { enumerable: true, get: function () { return repair_1.repairTrailingCommas; } });
+Object.defineProperty(exports, "repairJsoncComments", { enumerable: true, get: function () { return repair_1.repairJsoncComments; } });
+Object.defineProperty(exports, "repairSmartQuotes", { enumerable: true, get: function () { return repair_1.repairSmartQuotes; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AAGnB,iCAAiC;AACjC,2CAAgG;AAAvF,kHAAA,oBAAoB,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAAE,mHAAA,qBAAqB,OAAA;AAEzE,6BAA6B;AAC7B,mCAAoG;AAA3F,oGAAA,UAAU,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAAE,6GAAA,mBAAmB,OAAA;AAAE,2GAAA,iBAAiB,OAAA"}

package/dist/repair.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Auto-repair strategies for common JSON defects
+ */
+import { RepairIssue } from './types';
+export interface RepairResult {
+    text: string;
+    issues: RepairIssue[];
+}
+/**
+ * Apply all default repairs to the text
+ */
+export declare function autoRepair(text: string): RepairResult;
+/**
+ * Remove trailing commas before closing braces/brackets
+ * e.g., {a: 1,} → {a: 1}
+ */
+export declare function repairTrailingCommas(text: string): RepairResult;
+/**
+ * Remove JSONC-style comments
+ * Handles both line and block style comments
+ */
+export declare function repairJsoncComments(text: string): RepairResult;
+/**
+ * Replace smart quotes (curly quotes) with standard quotes
+ * e.g., "hello" → "hello"
+ */
+export declare function repairSmartQuotes(text: string): RepairResult;
+/**
+ * Check if text is valid JSON without throwing
+ */
+export declare function isValidJson(text: string): boolean;
+//# sourceMappingURL=repair.d.ts.map

package/dist/repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../src/repair.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAiBrD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAkB/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CA2B9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAmB5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjD"}

package/dist/repair.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * Auto-repair strategies for common JSON defects
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.autoRepair = autoRepair;
+exports.repairTrailingCommas = repairTrailingCommas;
+exports.repairJsoncComments = repairJsoncComments;
+exports.repairSmartQuotes = repairSmartQuotes;
+exports.isValidJson = isValidJson;
+/**
+ * Apply all default repairs to the text
+ */
+function autoRepair(text) {
+    let current = text;
+    const allIssues = [];
+    // Apply repairs in order
+    const repairs = [repairTrailingCommas, repairJsoncComments, repairSmartQuotes];
+    for (const repair of repairs) {
+        const result = repair(current);
+        current = result.text;
+        allIssues.push(...result.issues);
+    }
+    return {
+        text: current,
+        issues: allIssues,
+    };
+}
+/**
+ * Remove trailing commas before closing braces/brackets
+ * e.g., {a: 1,} → {a: 1}
+ */
+function repairTrailingCommas(text) {
+    const issues = [];
+    let modified = false;
+    // Match comma followed by whitespace and closing bracket/brace
+    const repaired = text.replace(/,(\s*[}\]])/g, (match, closing) => {
+        if (!modified) {
+            modified = true;
+            issues.push({
+                code: 'TRAILING_COMMA',
+                message: 'Removed trailing comma before closing bracket',
+                severity: 'warning',
+            });
+        }
+        return closing;
+    });
+    return { text: repaired, issues };
+}
+/**
+ * Remove JSONC-style comments
+ * Handles both line and block style comments
+ */
+function repairJsoncComments(text) {
+    const issues = [];
+    let result = text;
+    // Remove // comments (to end of line)
+    const singleLineRegex = /\/\/.*$/gm;
+    if (singleLineRegex.test(result)) {
+        issues.push({
+            code: 'JSONC_COMMENT_SINGLE',
+            message: 'Removed single-line comments',
+            severity: 'warning',
+        });
+        result = result.replace(singleLineRegex, '');
+    }
+    // Remove /* */ comments
+    const multiLineRegex = /\/\*[\s\S]*?\*\//g;
+    if (multiLineRegex.test(result)) {
+        issues.push({
+            code: 'JSONC_COMMENT_MULTI',
+            message: 'Removed multi-line comments',
+            severity: 'warning',
+        });
+        result = result.replace(multiLineRegex, '');
+    }
+    return { text: result, issues };
+}
+/**
+ * Replace smart quotes (curly quotes) with standard quotes
+ * e.g., "hello" → "hello"
+ */
+function repairSmartQuotes(text) {
+    const issues = [];
+    // Unicode smart quotes: " " ' '
+    const smartQuoteRegex = /[\u201C\u201D\u2018\u2019]/g;
+    if (smartQuoteRegex.test(text)) {
+        issues.push({
+            code: 'SMART_QUOTES',
+            message: 'Converted smart quotes to standard ASCII quotes',
+            severity: 'warning',
+        });
+    }
+    const repaired = text
+        .replace(/[\u201C\u201D]/g, '"') // Convert curly double quotes
+        .replace(/[\u2018\u2019]/g, "'"); // Convert curly single quotes
+    return { text: repaired, issues };
+}
+/**
+ * Check if text is valid JSON without throwing
+ */
+function isValidJson(text) {
+    try {
+        JSON.parse(text);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=repair.js.map

package/dist/repair.js.map

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

package/dist/rescue.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Main rescue function with support for generics and multiple modes
+ */
+import { RescueResult, RescueOptions } from './types';
+/**
+ * Rescue JSON from messy text with transparent repair reporting
+ *
+ * @template T - The expected type of the parsed JSON
+ * @param text - The text containing JSON
+ * @param options - Configuration options
+ * @returns A RescueResult with parsed data, repair issues, and metadata
+ *
+ * @example
+ * ```typescript
+ * const result = rescueJson<{ name: string }>(mixedText);
+ * if (result.success) {
+ *   console.log(result.data.name);
+ *   console.log(result.issues); // See what was repaired
+ * }
+ * ```
+ */
+export declare function rescueJson<T = unknown>(text: string, options?: RescueOptions): RescueResult<T> | RescueResult<T>[];
+export { RescueResult, RescueOptions, RepairIssue } from './types';
+//# sourceMappingURL=rescue.d.ts.map

package/dist/rescue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rescue.d.ts","sourceRoot":"","sources":["../src/rescue.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAe,MAAM,SAAS,CAAC;AAInE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EACpC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,aAAkB,GAC1B,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,CA2CrC;AA8DD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/rescue.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Main rescue function with support for generics and multiple modes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rescueJson = rescueJson;
+const extraction_1 = require("./extraction");
+const repair_1 = require("./repair");
+/**
+ * Rescue JSON from messy text with transparent repair reporting
+ *
+ * @template T - The expected type of the parsed JSON
+ * @param text - The text containing JSON
+ * @param options - Configuration options
+ * @returns A RescueResult with parsed data, repair issues, and metadata
+ *
+ * @example
+ * ```typescript
+ * const result = rescueJson<{ name: string }>(mixedText);
+ * if (result.success) {
+ *   console.log(result.data.name);
+ *   console.log(result.issues); // See what was repaired
+ * }
+ * ```
+ */
+function rescueJson(text, options = {}) {
+    const { mode = 'first', autoRepair: shouldRepair = true } = options;
+    // Extract candidates
+    const candidates = (0, extraction_1.extractAllCandidates)(text);
+    if (candidates.length === 0) {
+        const emptyResult = {
+            data: null,
+            success: false,
+            issues: [
+                {
+                    code: 'NO_JSON_FOUND',
+                    message: 'No JSON candidates found in the text',
+                    severity: 'error',
+                },
+            ],
+            raw: '',
+            repaired: '',
+        };
+        return mode === 'all' ? [emptyResult] : emptyResult;
+    }
+    // Process candidates
+    const results = [];
+    for (const candidate of candidates) {
+        const result = processCandidate(candidate.text, shouldRepair);
+        results.push(result);
+        // Stop if we found a valid one and only want the first
+        if (mode === 'first' && result.success) {
+            break;
+        }
+    }
+    // Return based on mode
+    if (mode === 'all') {
+        return results;
+    }
+    // Return first successful or first result
+    return results.find((r) => r.success) || results[0];
+}
+/**
+ * Process a single candidate: attempt repair and parse
+ */
+function processCandidate(raw, shouldRepair) {
+    const allIssues = [];
+    let repaired = raw;
+    // Try to parse as-is first
+    if ((0, repair_1.isValidJson)(raw)) {
+        return {
+            data: JSON.parse(raw),
+            success: true,
+            issues: [],
+            raw,
+            repaired: raw,
+        };
+    }
+    // If we should repair, apply repairs
+    if (shouldRepair) {
+        const repairResult = (0, repair_1.autoRepair)(raw);
+        repaired = repairResult.text;
+        allIssues.push(...repairResult.issues);
+        // Try parsing after repair
+        if ((0, repair_1.isValidJson)(repaired)) {
+            return {
+                data: JSON.parse(repaired),
+                success: true,
+                issues: allIssues,
+                raw,
+                repaired,
+            };
+        }
+    }
+    // Failed to parse
+    let parseError = 'Unknown parse error';
+    try {
+        JSON.parse(repaired);
+    }
+    catch (e) {
+        parseError = e instanceof Error ? e.message : String(e);
+    }
+    return {
+        data: null,
+        success: false,
+        issues: [
+            ...allIssues,
+            {
+                code: 'PARSE_ERROR',
+                message: `Failed to parse JSON: ${parseError}`,
+                severity: 'error',
+            },
+        ],
+        raw,
+        repaired,
+    };
+}
+//# sourceMappingURL=rescue.js.map

package/dist/rescue.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Core type definitions for json-rescue
+ */
+/**
+ * Represents a single repair issue found during extraction/repair
+ */
+export interface RepairIssue {
+    code: string;
+    message: string;
+    line?: number;
+    column?: number;
+    severity: 'warning' | 'error';
+}
+/**
+ * Result of a rescue operation with transparent repair reporting
+ */
+export interface RescueResult<T = unknown> {
+    /** The parsed JSON object */
+    data: T | null;
+    /** Whether parsing was successful */
+    success: boolean;
+    /** List of repairs applied */
+    issues: RepairIssue[];
+    /** The original extracted text before repairs */
+    raw: string;
+    /** The repaired text before parsing */
+    repaired: string;
+}
+/**
+ * Extraction candidate found in the text
+ */
+export interface ExtractionCandidate {
+    text: string;
+    source: 'markdown' | 'balanced-braces';
+    startIndex: number;
+    endIndex: number;
+}
+/**
+ * Options for rescueJson function
+ */
+export interface RescueOptions {
+    /** Mode of extraction: 'first' (default) or 'all' */
+    mode?: 'first' | 'all';
+    /** Whether to attempt auto-repair */
+    autoRepair?: boolean;
+    /** Custom repair rules */
+    customRepairs?: ((text: string) => {
+        text: string;
+        issues: RepairIssue[];
+    })[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,6BAA6B;IAC7B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,iBAAiB,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACvB,qCAAqC;IACrC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC,EAAE,CAAC;CAC/E"}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Core type definitions for json-rescue
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "json-rescue",
-  "version": "0.0.1",
+  "version": "0.2.2",
   "description": "Rescue valid JSON from messy text by extracting candidates, applying safe repairs, and returning a parsed result with a transparent repair report.",
   "keywords": [
     "json",
@@ -22,18 +22,43 @@
     "url": "https://azeemmirza.co"
   },
   "type": "commonjs",
-  "main": "index.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "build": "tsc",
     "test": "jest",
     "test:watch": "jest --watch",
-    "prepublishOnly": "npm run build",
-    "publish:public": "npm publish --access public"
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "release": "release-it",
+    "release:dry": "release-it --dry-run",
+    "prepublishOnly": "npm run build && npm run lint && npm run test",
+    "publish": "npm publish --access public"
   },
   "devDependencies": {
+    "@commitlint/cli": "^20.4.2",
+    "@commitlint/config-conventional": "^20.4.2",
+    "@eslint/js": "^10.0.1",
+    "@release-it/conventional-changelog": "^10.0.5",
     "@types/jest": "^30.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
+    "@typescript-eslint/parser": "^8.56.0",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "eslint": "^10.0.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
     "jest": "^30.2.0",
+    "release-it": "^19.2.4",
     "ts-jest": "^29.4.6",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.56.0"
   }
 }

package/src/index.ts

@@ -1 +0,0 @@
-console.log('json-rescue...');

package/tsconfig.json

@@ -1,19 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "commonjs",
-    "lib": ["dom", "esnext"],
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "**/*.test.ts"]
-}