@hoangvu12/yomi 0.1.0

package/dist/index.js

@@ -0,0 +1,125 @@
+import { parseJson, JsonParseError } from "./parse.js";
+import { coerceToSchema } from "./coerce.js";
+import { createContext } from "./types.js";
+// Re-export types and utilities
+export { Flag } from "./flags.js";
+export { JsonParseError } from "./parse.js";
+/**
+ * Parse a string into a typed value using a Zod schema.
+ *
+ * This is the main entry point for the Schema-Aligned Parser.
+ * It combines flexible JSON parsing with schema-aligned coercion.
+ *
+ * @example
+ * ```ts
+ * const UserSchema = z.object({
+ *   name: z.string(),
+ *   age: z.number(),
+ * });
+ *
+ * // Handles malformed JSON
+ * const result = parse(UserSchema, `{name: 'John', age: "25",}`);
+ * // → { success: true, data: { name: "John", age: 25 }, flags: [...] }
+ * ```
+ */
+export function parse(schema, input) {
+    // Phase 1: Flexible JSON parsing
+    let parsed;
+    let parseFlags = [];
+    try {
+        const parseResult = parseJson(input);
+        parsed = parseResult.value;
+        parseFlags = parseResult.flags;
+    }
+    catch (e) {
+        if (e instanceof JsonParseError) {
+            return {
+                success: false,
+                error: {
+                    type: "json_parse_error",
+                    message: e.message,
+                },
+            };
+        }
+        throw e;
+    }
+    // Phase 2: Schema-aligned coercion
+    const ctx = createContext();
+    ctx.flags.push(...parseFlags);
+    const result = coerceToSchema(schema, parsed, ctx);
+    if (result.success) {
+        return {
+            success: true,
+            data: result.value,
+            flags: result.flags,
+        };
+    }
+    return {
+        success: false,
+        error: {
+            type: "coercion_error",
+            message: result.error.message,
+            path: result.error.path,
+            expected: result.error.expected,
+            received: result.error.received,
+        },
+    };
+}
+/**
+ * Parse a string into a typed value, throwing on error.
+ *
+ * @throws {Error} If parsing or coercion fails
+ */
+export function parseOrThrow(schema, input) {
+    const result = parse(schema, input);
+    if (!result.success) {
+        const error = result.error;
+        const path = error.path?.join(".") ?? "";
+        throw new Error(`Parse error${path ? ` at ${path}` : ""}: ${error.message}`);
+    }
+    return result.data;
+}
+/**
+ * Coerce an already-parsed value to match a schema.
+ *
+ * Use this when you already have a parsed JavaScript value
+ * and just need schema-aligned coercion.
+ *
+ * @example
+ * ```ts
+ * const data = JSON.parse(rawJson);
+ * const result = coerce(UserSchema, data);
+ * ```
+ */
+export function coerce(schema, value) {
+    return coerceToSchema(schema, value);
+}
+/**
+ * Coerce a value to match a schema, throwing on error.
+ *
+ * @throws {Error} If coercion fails
+ */
+export function coerceOrThrow(schema, value) {
+    const result = coerce(schema, value);
+    if (!result.success) {
+        const path = result.error.path.join(".") || "<root>";
+        throw new Error(`Coercion error at ${path}: ${result.error.message}`);
+    }
+    return result.value;
+}
+/**
+ * Check if a parse result has any coercion flags.
+ * Useful for detecting when values were transformed.
+ */
+export function hasFlags(result) {
+    return result.success && result.flags.length > 0;
+}
+/**
+ * Get the flag types from a parse result.
+ */
+export function getFlags(result) {
+    if (!result.success)
+        return [];
+    return result.flags.map((f) => f.flag);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/parse.d.ts

@@ -0,0 +1,17 @@
+import { type FlagWithContext } from "./flags.js";
+export interface ParseResult {
+    value: unknown;
+    flags: FlagWithContext[];
+}
+/**
+ * LLM outputs are notoriously messy - they wrap JSON in markdown, add
+ * explanatory text, use single quotes, leave trailing commas, etc.
+ *
+ * We try progressively more aggressive strategies to extract valid JSON,
+ * preferring minimal intervention (so we try JSON.parse first before repair).
+ */
+export declare function parseJson(input: string): ParseResult;
+export declare class JsonParseError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAuDpD;AA2FD,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/parse.js

@@ -0,0 +1,157 @@
+import { jsonrepair } from "jsonrepair";
+import { Flag, flag } from "./flags.js";
+/**
+ * LLM outputs are notoriously messy - they wrap JSON in markdown, add
+ * explanatory text, use single quotes, leave trailing commas, etc.
+ *
+ * We try progressively more aggressive strategies to extract valid JSON,
+ * preferring minimal intervention (so we try JSON.parse first before repair).
+ */
+export function parseJson(input) {
+    const trimmed = input.trim();
+    const flags = [];
+    // Fast path: if it's already valid JSON, don't waste time on extraction/repair
+    try {
+        return { value: JSON.parse(trimmed), flags };
+    }
+    catch {
+        // Expected for most LLM outputs - continue to extraction strategies
+    }
+    // LLMs love wrapping responses in ```json blocks, especially ChatGPT
+    const markdownResult = extractFromMarkdown(trimmed);
+    if (markdownResult !== null) {
+        flags.push(flag(Flag.ExtractedFromMarkdown));
+        try {
+            return { value: JSON.parse(markdownResult), flags };
+        }
+        catch {
+            // The extracted content might still have syntax issues
+            try {
+                const repaired = jsonrepair(markdownResult);
+                flags.push(flag(Flag.JsonRepaired));
+                return { value: JSON.parse(repaired), flags };
+            }
+            catch {
+                // Markdown extraction didn't help, try other strategies
+            }
+        }
+    }
+    // LLMs often prefix JSON with "Here's the result:" or similar
+    const extracted = extractJsonFromText(trimmed);
+    if (extracted !== null && extracted !== trimmed) {
+        flags.push(flag(Flag.ExtractedFromText));
+        try {
+            return { value: JSON.parse(extracted), flags };
+        }
+        catch {
+            try {
+                const repaired = jsonrepair(extracted);
+                flags.push(flag(Flag.JsonRepaired));
+                return { value: JSON.parse(repaired), flags };
+            }
+            catch {
+                // Extraction didn't help, try repairing the whole thing
+            }
+        }
+    }
+    // Last resort: let jsonrepair try to fix whatever syntax issues exist
+    // (trailing commas, unquoted keys, single quotes, comments, etc.)
+    try {
+        const repaired = jsonrepair(trimmed);
+        flags.push(flag(Flag.JsonRepaired));
+        return { value: JSON.parse(repaired), flags };
+    }
+    catch {
+        throw new JsonParseError(`Failed to parse JSON: ${trimmed.slice(0, 100)}...`);
+    }
+}
+/**
+ * ChatGPT and Claude often wrap JSON in markdown code blocks.
+ * We extract the content between the backticks.
+ */
+function extractFromMarkdown(input) {
+    const codeBlockMatch = input.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (codeBlockMatch?.[1]) {
+        return codeBlockMatch[1].trim();
+    }
+    return null;
+}
+/**
+ * LLMs often add context around JSON: "Here's your data: {...} Let me know if..."
+ * We find balanced braces/brackets to extract just the JSON portion.
+ *
+ * Uses a simple state machine to handle strings (so braces inside strings
+ * don't confuse the matching) and escape sequences.
+ */
+function extractJsonFromText(input) {
+    const objectStart = input.indexOf("{");
+    const arrayStart = input.indexOf("[");
+    let start;
+    let openChar;
+    let closeChar;
+    if (objectStart === -1 && arrayStart === -1) {
+        return null;
+    }
+    else if (objectStart === -1) {
+        start = arrayStart;
+        openChar = "[";
+        closeChar = "]";
+    }
+    else if (arrayStart === -1) {
+        start = objectStart;
+        openChar = "{";
+        closeChar = "}";
+    }
+    else {
+        // Use whichever structure appears first in the text
+        if (objectStart < arrayStart) {
+            start = objectStart;
+            openChar = "{";
+            closeChar = "}";
+        }
+        else {
+            start = arrayStart;
+            openChar = "[";
+            closeChar = "]";
+        }
+    }
+    // Track nesting depth, ignoring braces inside strings
+    let depth = 0;
+    let inString = false;
+    let escapeNext = false;
+    for (let i = start; i < input.length; i++) {
+        const char = input[i];
+        if (escapeNext) {
+            escapeNext = false;
+            continue;
+        }
+        if (char === "\\") {
+            escapeNext = true;
+            continue;
+        }
+        if (char === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (char === openChar) {
+            depth++;
+        }
+        else if (char === closeChar) {
+            depth--;
+            if (depth === 0) {
+                return input.slice(start, i + 1);
+            }
+        }
+    }
+    // Unclosed JSON - return what we have, jsonrepair might fix it
+    return input.slice(start);
+}
+export class JsonParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "JsonParseError";
+    }
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,64 @@
+import type { z } from "zod";
+import type { FlagWithContext } from "./flags.js";
+/**
+ * Result of successful coercion, including the value and any transformation flags.
+ */
+export interface CoerceSuccess<T> {
+    success: true;
+    value: T;
+    flags: FlagWithContext[];
+}
+/**
+ * Result of failed coercion, including error details.
+ */
+export interface CoerceFailure {
+    success: false;
+    error: CoerceError;
+}
+/**
+ * Combined result type for coercion.
+ */
+export type CoerceResult<T> = CoerceSuccess<T> | CoerceFailure;
+/**
+ * Error that occurred during coercion.
+ */
+export interface CoerceError {
+    message: string;
+    path: (string | number)[];
+    expected: string;
+    received: string;
+}
+/**
+ * Context passed through the coercion process.
+ */
+export interface CoerceContext {
+    /** Current path in the object (for error messages) */
+    path: (string | number)[];
+    /** Accumulated flags */
+    flags: FlagWithContext[];
+}
+/**
+ * Create a new coercion context.
+ */
+export declare function createContext(): CoerceContext;
+/**
+ * Create a child context with an extended path.
+ */
+export declare function childContext(ctx: CoerceContext, segment: string | number): CoerceContext;
+/**
+ * Create a success result.
+ */
+export declare function success<T>(value: T, ctx: CoerceContext): CoerceSuccess<T>;
+/**
+ * Create a failure result.
+ */
+export declare function failure(message: string, ctx: CoerceContext, expected: string, received: string): CoerceFailure;
+/**
+ * Type helper to extract the inferred type from a Zod schema.
+ */
+export type InferSchema<T extends z.ZodTypeAny> = z.infer<T>;
+/**
+ * Get a human-readable type description for an unknown value.
+ */
+export declare function describeType(value: unknown): string;
+//# 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,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,wBAAwB;IACxB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,aAAa,CAE7C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAKxF;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,aAAa,GAAG,aAAa,CAAC,CAAC,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,aAAa,CAUf;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE7D;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKnD"}

package/dist/types.js

@@ -0,0 +1,48 @@
+/**
+ * Create a new coercion context.
+ */
+export function createContext() {
+    return { path: [], flags: [] };
+}
+/**
+ * Create a child context with an extended path.
+ */
+export function childContext(ctx, segment) {
+    return {
+        path: [...ctx.path, segment],
+        flags: ctx.flags, // Share flags array
+    };
+}
+/**
+ * Create a success result.
+ */
+export function success(value, ctx) {
+    return { success: true, value, flags: ctx.flags };
+}
+/**
+ * Create a failure result.
+ */
+export function failure(message, ctx, expected, received) {
+    return {
+        success: false,
+        error: {
+            message,
+            path: ctx.path,
+            expected,
+            received,
+        },
+    };
+}
+/**
+ * Get a human-readable type description for an unknown value.
+ */
+export function describeType(value) {
+    if (value === null)
+        return "null";
+    if (value === undefined)
+        return "undefined";
+    if (Array.isArray(value))
+        return "array";
+    return typeof value;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA6CA;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAkB,EAAE,OAAwB;IACvE,OAAO;QACL,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC;QAC5B,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,oBAAoB;KACvC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAI,KAAQ,EAAE,GAAkB;IACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CACrB,OAAe,EACf,GAAkB,EAClB,QAAgB,EAChB,QAAgB;IAEhB,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE;YACL,OAAO;YACP,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ;YACR,QAAQ;SACT;KACF,CAAC;AACJ,CAAC;AAOD;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,OAAO,KAAK,CAAC;AACtB,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@hoangvu12/yomi",
+  "version": "0.1.0",
+  "description": "Yomi (読み) - Flexible JSON parser that interprets LLM output to match Zod schemas",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "json",
+    "parser",
+    "llm",
+    "zod",
+    "coerce",
+    "schema",
+    "ai",
+    "openai",
+    "anthropic",
+    "structured-output"
+  ],
+  "author": "hoangvu12",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hoangvu12/yomi.git"
+  },
+  "homepage": "https://github.com/hoangvu12/yomi#readme",
+  "bugs": {
+    "url": "https://github.com/hoangvu12/yomi/issues"
+  },
+  "dependencies": {
+    "jsonrepair": "^3.8.0"
+  },
+  "peerDependencies": {
+    "zod": "^3.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "vitest": "^2.0.0",
+    "eslint": "^8.56.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "zod": "^3.23.8"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT"
+}