llm-json-guard 1.0.0

package/README.md

@@ -0,0 +1,32 @@
+# llm-json-guard
+
+Production-safe JSON repair and schema validation for LLM outputs.
+
+## Installation
+
+npm install llm-json-guard
+
+## Usage
+
+import { LLMJsonGuard } from "llm-json-guard";
+
+const guard = new LLMJsonGuard({
+  apiKey: process.env.RAPIDAPI_KEY
+});
+
+const result = await guard.guard(
+  "{name: 'Harsh', age: 21,}",
+  {
+    type: "object",
+    properties: {
+      name: { type: "string" },
+      age: { type: "number" }
+    },
+    required: ["name", "age"]
+  }
+);
+
+console.log(result.data);
+
+Requires a RapidAPI key.
+Get one here: https://rapidapi.com/...

package/index.js

@@ -0,0 +1,59 @@
+class LLMJsonGuard {
+  constructor({ apiKey }) {
+    if (!apiKey) {
+      throw new Error("RapidAPI key is required");
+    }
+
+    this.apiKey = apiKey;
+    this.baseUrl =
+      "https://llm-json-sanitizer-schema-guard.p.rapidapi.com";
+  }
+
+  async sanitize(rawOutput) {
+    if (!rawOutput) {
+      throw new Error("rawOutput is required");
+    }
+
+    return this.#request("/api/json-repair/sanitize", {
+      raw_output: rawOutput
+    });
+  }
+
+  async guard(rawOutput, schema) {
+    if (!rawOutput || !schema) {
+      throw new Error("rawOutput and schema are required");
+    }
+
+    return this.#request("/api/json-repair/guard", {
+      raw_output: rawOutput,
+      schema
+    });
+  }
+
+  async #request(path, body) {
+    const response = await fetch(this.baseUrl + path, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-rapidapi-key": this.apiKey,
+        "x-rapidapi-host":
+          "llm-json-sanitizer-schema-guard.p.rapidapi.com"
+      },
+      body: JSON.stringify(body)
+    });
+
+    const data = await response.json();
+
+    if (!response.ok) {
+      const message =
+        data?.data?.response?.stage ||
+        data?.message ||
+        "Request failed";
+      throw new Error(message);
+    }
+
+    return data.data.response;
+  }
+}
+
+export { LLMJsonGuard };

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "llm-json-guard",
+  "version": "1.0.0",
+  "description": "Production-safe JSON repair and schema validation for LLM outputs",
+  "main": "index.js",
+  "type": "module",
+  "keywords": [
+    "json",
+    "llm",
+    "json-validation",
+    "json-repair",
+    "ai",
+    "schema"
+  ],
+  "author": "Harsh Verma",
+  "license": "MIT"
+}