@painitehq/structured-llm 0.1.0

package/README.md

@@ -0,0 +1,75 @@
+# React + TypeScript + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
+
+## React Compiler
+
+The React Compiler is enabled on this template. See [this documentation](https://react.dev/learn/react-compiler) for more information.
+
+Note: This will impact Vite dev & build performances.
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+
+```js
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+
+      // Remove tseslint.configs.recommended and replace with this
+      tseslint.configs.recommendedTypeChecked,
+      // Alternatively, use this for stricter rules
+      tseslint.configs.strictTypeChecked,
+      // Optionally, add this for stylistic rules
+      tseslint.configs.stylisticTypeChecked,
+
+      // Other configs...
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```
+
+You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
+
+```js
+// eslint.config.js
+import reactX from 'eslint-plugin-react-x'
+import reactDom from 'eslint-plugin-react-dom'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+      // Enable lint rules for React
+      reactX.configs['recommended-typescript'],
+      // Enable lint rules for React DOM
+      reactDom.configs.recommended,
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```

package/dist/index.cjs

@@ -0,0 +1,332 @@
+'use strict';
+
+// src/llm-client.ts
+var DEFAULT_MODEL = "openrouter/free";
+var DEFAULT_TEMPERATURE = 0;
+var DEFAULT_TIMEOUT = 6e4;
+async function callLLM(prompt, config) {
+  const {
+    apiKey,
+    model = DEFAULT_MODEL,
+    temperature = DEFAULT_TEMPERATURE,
+    timeout = DEFAULT_TIMEOUT
+  } = config;
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeout);
+  try {
+    const response = await fetch("https://openrouter.ai/api/v1/chat/completions", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`,
+        "HTTP-Referer": "https://github.com/harshitduggal/structured-llm",
+        "X-Title": "structured-llm"
+      },
+      body: JSON.stringify({
+        model,
+        messages: [
+          {
+            role: "system",
+            content: "You are a precise data extraction assistant. You MUST respond with valid JSON only. No explanations, no markdown, no text outside the JSON. Just the raw JSON object."
+          },
+          {
+            role: "user",
+            content: prompt
+          }
+        ],
+        temperature,
+        response_format: { type: "json_object" }
+      }),
+      signal: controller.signal
+    });
+    if (!response.ok) {
+      const errorBody = await response.text();
+      throw new Error(
+        `OpenRouter API error: ${response.status} - ${errorBody}`
+      );
+    }
+    const data = await response.json();
+    if (!data.choices || data.choices.length === 0) {
+      throw new Error("No response from LLM");
+    }
+    const content = data.choices[0].message?.content;
+    if (!content) {
+      throw new Error("Empty response from LLM");
+    }
+    return {
+      content,
+      model: data.model || model,
+      usage: data.usage ? {
+        promptTokens: data.usage.prompt_tokens,
+        completionTokens: data.usage.completion_tokens,
+        totalTokens: data.usage.total_tokens
+      } : void 0
+    };
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+
+// src/validator.ts
+function tryParseJSON(raw) {
+  try {
+    const data = JSON.parse(raw);
+    return { success: true, data };
+  } catch (e) {
+    return { success: false, error: e instanceof Error ? e.message : "Unknown parse error" };
+  }
+}
+function extractJSON(raw) {
+  const trimmed = raw.trim();
+  if (tryParseJSON(trimmed).success) {
+    return trimmed;
+  }
+  const codeBlockMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
+  if (codeBlockMatch) {
+    const inner = codeBlockMatch[1].trim();
+    if (tryParseJSON(inner).success) {
+      return inner;
+    }
+  }
+  const firstBrace = trimmed.indexOf("{");
+  const lastBrace = trimmed.lastIndexOf("}");
+  if (firstBrace !== -1 && lastBrace > firstBrace) {
+    const candidate = trimmed.slice(firstBrace, lastBrace + 1);
+    if (tryParseJSON(candidate).success) {
+      return candidate;
+    }
+  }
+  const firstBracket = trimmed.indexOf("[");
+  const lastBracket = trimmed.lastIndexOf("]");
+  if (firstBracket !== -1 && lastBracket > firstBracket) {
+    const candidate = trimmed.slice(firstBracket, lastBracket + 1);
+    if (tryParseJSON(candidate).success) {
+      return candidate;
+    }
+  }
+  return null;
+}
+function repairJSON(raw) {
+  let candidate = raw.trim();
+  candidate = candidate.replace(/,\s*([}\]])/g, "$1");
+  candidate = candidate.replace(/'/g, '"');
+  candidate = candidate.replace(/(\w+)\s*:/g, '"$1":');
+  candidate = candidate.replace(/:\s*"([^"]*?)"/g, (match, content) => {
+    if (content.includes('"')) {
+      return match;
+    }
+    return match;
+  });
+  if (!candidate.startsWith("{") && !candidate.startsWith("[")) {
+    const firstBrace = candidate.indexOf("{");
+    const firstBracket = candidate.indexOf("[");
+    if (firstBrace !== -1 && (firstBracket === -1 || firstBrace < firstBracket)) {
+      candidate = candidate.slice(firstBrace);
+    } else if (firstBracket !== -1) {
+      candidate = candidate.slice(firstBracket);
+    }
+  }
+  if (!candidate.endsWith("}") && !candidate.endsWith("]")) {
+    const lastBrace = candidate.lastIndexOf("}");
+    const lastBracket = candidate.lastIndexOf("]");
+    if (lastBrace !== -1 && (lastBracket === -1 || lastBrace > lastBracket)) {
+      candidate = candidate.slice(0, lastBrace + 1);
+    } else if (lastBracket !== -1) {
+      candidate = candidate.slice(0, lastBracket + 1);
+    }
+  }
+  const result = tryParseJSON(candidate);
+  if (result.success) {
+    return candidate;
+  }
+  return null;
+}
+function validateAgainstSchema(data, schema) {
+  if (typeof data !== "object" || data === null || Array.isArray(data)) {
+    return { valid: false, errors: ["Root value must be an object"] };
+  }
+  const errors = [];
+  const obj = data;
+  for (const [key, field] of Object.entries(schema)) {
+    const value = obj[key];
+    if (value === void 0 && field.required !== false) {
+      errors.push(`Missing required field: "${key}"`);
+      continue;
+    }
+    if (value === void 0) {
+      continue;
+    }
+    switch (field.type) {
+      case "string":
+        if (typeof value !== "string") {
+          errors.push(`Field "${key}" must be string, got ${typeof value}`);
+        }
+        break;
+      case "number":
+        if (typeof value !== "number") {
+          errors.push(`Field "${key}" must be number, got ${typeof value}`);
+        }
+        break;
+      case "boolean":
+        if (typeof value !== "boolean") {
+          errors.push(`Field "${key}" must be boolean, got ${typeof value}`);
+        }
+        break;
+      case "array":
+        if (!Array.isArray(value)) {
+          errors.push(`Field "${key}" must be array, got ${typeof value}`);
+        }
+        break;
+      case "object":
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+          errors.push(`Field "${key}" must be object, got ${typeof value}`);
+        }
+        break;
+    }
+  }
+  if (errors.length > 0) {
+    return { valid: false, errors };
+  }
+  return { valid: true, data };
+}
+
+// src/schema.ts
+function defineSchema(name, fields) {
+  return { name, fields };
+}
+function schemaToPrompt(schema) {
+  const fieldDescriptions = Object.entries(schema.fields).map(([key, field]) => {
+    const parts = [`"${key}": ${fieldTypeToExample(field)}`];
+    if (field.description) {
+      parts.push(`// ${field.description}`);
+    }
+    return parts.join(" ");
+  }).join(",\n  ");
+  return `{
+  "${schema.name}": {
+  ${fieldDescriptions}
+  }
+}`;
+}
+function fieldTypeToExample(field) {
+  switch (field.type) {
+    case "string":
+      return `"..."`;
+    case "number":
+      return "0";
+    case "boolean":
+      return "true";
+    case "array":
+      if (field.items) {
+        return `[${fieldTypeToExample(field.items)}]`;
+      }
+      return "[]";
+    case "object":
+      if (field.properties) {
+        const inner = Object.entries(field.properties).map(([k, v]) => `"${k}": ${fieldTypeToExample(v)}`).join(", ");
+        return `{ ${inner} }`;
+      }
+      return "{}";
+  }
+}
+function schemaToZodishString(schema) {
+  const lines = [];
+  lines.push(`Expected JSON structure for "${schema.name}":`);
+  for (const [key, field] of Object.entries(schema.fields)) {
+    const required = field.required !== false ? "(required)" : "(optional)";
+    lines.push(`  - "${key}": ${field.type} ${required}${field.description ? ` - ${field.description}` : ""}`);
+  }
+  return lines.join("\n");
+}
+
+// src/extractor.ts
+var MAX_REPAIR_ATTEMPTS = 3;
+function unwrapNamedResponse(data, schemaName) {
+  if (typeof data === "object" && data !== null && !Array.isArray(data) && schemaName in data && typeof data[schemaName] === "object") {
+    return data[schemaName];
+  }
+  return data;
+}
+async function extract(input, schema, options = {}) {
+  const config = {
+    apiKey: options.apiKey || process.env.OPENROUTER_API_KEY || "",
+    model: options.model || "openrouter/free",
+    temperature: options.temperature ?? 0,
+    timeout: options.timeout ?? 3e4
+  };
+  if (!config.apiKey || config.apiKey.trim() === "") {
+    throw new Error(
+      "OpenRouter API key required. Pass it in options or set OPENROUTER_API_KEY environment variable."
+    );
+  }
+  const schemaDescription = schemaToZodishString(schema);
+  const exampleJSON = schemaToPrompt(schema);
+  const userPrompt = `Extract structured data from the following text.
+
+${schemaDescription}
+
+Return ONLY valid JSON matching this structure:
+${exampleJSON}
+
+Text to extract from:
+"""
+${input}
+"""`;
+  const schemaFields = {};
+  for (const [key, field] of Object.entries(schema.fields)) {
+    schemaFields[key] = { type: field.type, required: field.required };
+  }
+  let lastRaw = "";
+  let lastError = "";
+  for (let attempt = 0; attempt <= MAX_REPAIR_ATTEMPTS; attempt++) {
+    const prompt = attempt === 0 ? userPrompt : `${userPrompt}
+
+IMPORTANT: Your previous response was invalid JSON. Here was the error:
+${lastError}
+
+Previous raw response:
+${lastRaw}
+
+Fix the JSON and return ONLY valid JSON. No explanations, no markdown, just the raw JSON object.`;
+    const response = await callLLM(prompt, config);
+    lastRaw = response.content;
+    const extracted = extractJSON(response.content);
+    if (!extracted) {
+      lastError = "Could not extract JSON from response";
+      continue;
+    }
+    const parsed = tryParseJSON(extracted);
+    if (!parsed.success) {
+      lastError = parsed.error;
+      continue;
+    }
+    const repaired = repairJSON(extracted);
+    const finalData = repaired ? tryParseJSON(repaired).success ? JSON.parse(repaired) : parsed.data : parsed.data;
+    const unwrapped = unwrapNamedResponse(finalData, schema.name);
+    const validation = validateAgainstSchema(unwrapped, schemaFields);
+    if (!validation.valid) {
+      lastError = `Schema validation failed: ${validation.errors.join(", ")}`;
+      continue;
+    }
+    return {
+      data: unwrapped,
+      raw: response.content,
+      model: response.model,
+      usage: response.usage
+    };
+  }
+  throw new Error(
+    `Failed to extract valid JSON after ${MAX_REPAIR_ATTEMPTS + 1} attempts. Last error: ${lastError}`
+  );
+}
+
+exports.defineSchema = defineSchema;
+exports.extract = extract;
+exports.extractJSON = extractJSON;
+exports.repairJSON = repairJSON;
+exports.schemaToPrompt = schemaToPrompt;
+exports.schemaToZodishString = schemaToZodishString;
+exports.tryParseJSON = tryParseJSON;
+exports.validateAgainstSchema = validateAgainstSchema;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/llm-client.ts","../src/validator.ts","../src/schema.ts","../src/extractor.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export interface LLMClientConfig {\n  apiKey: string;\n  model: string;\n  temperature?: number;\n  timeout?: number;\n}\n\nexport interface LLMResponse {\n  content: string;\n  model: string;\n  usage?: {\n    promptTokens: number;\n    completionTokens: number;\n    totalTokens: number;\n  };\n}\n\ninterface OpenRouterChoice {\n  message?: {\n    content?: string;\n  };\n}\n\ninterface OpenRouterResponse {\n  choices?: OpenRouterChoice[];\n  model?: string;\n  usage?: {\n    prompt_tokens: number;\n    completion_tokens: number;\n    total_tokens: number;\n  };\n}\n\nconst DEFAULT_MODEL = \"openrouter/free\";\nconst DEFAULT_TEMPERATURE = 0;\nconst DEFAULT_TIMEOUT = 60000;\n\nexport async function callLLM(\n  prompt: string,\n  config: LLMClientConfig\n): Promise<LLMResponse> {\n  const {\n    apiKey,\n    model = DEFAULT_MODEL,\n    temperature = DEFAULT_TEMPERATURE,\n    timeout = DEFAULT_TIMEOUT,\n  } = config;\n\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n  try {\n    const response = await fetch(\"https://openrouter.ai/api/v1/chat/completions\", {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${apiKey}`,\n        \"HTTP-Referer\": \"https://github.com/harshitduggal/structured-llm\",\n        \"X-Title\": \"structured-llm\",\n      },\n      body: JSON.stringify({\n        model,\n        messages: [\n          {\n            role: \"system\",\n            content: \"You are a precise data extraction assistant. You MUST respond with valid JSON only. No explanations, no markdown, no text outside the JSON. Just the raw JSON object.\",\n          },\n          {\n            role: \"user\",\n            content: prompt,\n          },\n        ],\n        temperature,\n        response_format: { type: \"json_object\" },\n      }),\n      signal: controller.signal,\n    });\n\n    if (!response.ok) {\n      const errorBody = await response.text();\n      throw new Error(\n        `OpenRouter API error: ${response.status} - ${errorBody}`\n      );\n    }\n\n    const data = (await response.json()) as OpenRouterResponse;\n\n    if (!data.choices || data.choices.length === 0) {\n      throw new Error(\"No response from LLM\");\n    }\n\n    const content = data.choices[0].message?.content;\n    if (!content) {\n      throw new Error(\"Empty response from LLM\");\n    }\n\n    return {\n      content,\n      model: data.model || model,\n      usage: data.usage\n        ? {\n            promptTokens: data.usage.prompt_tokens,\n            completionTokens: data.usage.completion_tokens,\n            totalTokens: data.usage.total_tokens,\n          }\n        : undefined,\n    };\n  } finally {\n    clearTimeout(timeoutId);\n  }\n}\n","export function tryParseJSON(raw: string): { success: true; data: unknown } | { success: false; error: string } {\n  try {\n    const data = JSON.parse(raw);\n    return { success: true, data };\n  } catch (e) {\n    return { success: false, error: e instanceof Error ? e.message : \"Unknown parse error\" };\n  }\n}\n\nexport function extractJSON(raw: string): string | null {\n  const trimmed = raw.trim();\n\n  if (tryParseJSON(trimmed).success) {\n    return trimmed;\n  }\n\n  const codeBlockMatch = trimmed.match(/```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?\\s*```/);\n  if (codeBlockMatch) {\n    const inner = codeBlockMatch[1].trim();\n    if (tryParseJSON(inner).success) {\n      return inner;\n    }\n  }\n\n  const firstBrace = trimmed.indexOf(\"{\");\n  const lastBrace = trimmed.lastIndexOf(\"}\");\n  if (firstBrace !== -1 && lastBrace > firstBrace) {\n    const candidate = trimmed.slice(firstBrace, lastBrace + 1);\n    if (tryParseJSON(candidate).success) {\n      return candidate;\n    }\n  }\n\n  const firstBracket = trimmed.indexOf(\"[\");\n  const lastBracket = trimmed.lastIndexOf(\"]\");\n  if (firstBracket !== -1 && lastBracket > firstBracket) {\n    const candidate = trimmed.slice(firstBracket, lastBracket + 1);\n    if (tryParseJSON(candidate).success) {\n      return candidate;\n    }\n  }\n\n  return null;\n}\n\nexport function repairJSON(raw: string): string | null {\n  let candidate = raw.trim();\n\n  candidate = candidate.replace(/,\\s*([}\\]])/g, \"$1\");\n\n  candidate = candidate.replace(/'/g, '\"');\n\n  candidate = candidate.replace(/(\\w+)\\s*:/g, '\"$1\":');\n\n  candidate = candidate.replace(/:\\s*\"([^\"]*?)\"/g, (match, content) => {\n    if (content.includes('\"')) {\n      return match;\n    }\n    return match;\n  });\n\n  if (!candidate.startsWith(\"{\") && !candidate.startsWith(\"[\")) {\n    const firstBrace = candidate.indexOf(\"{\");\n    const firstBracket = candidate.indexOf(\"[\");\n    if (firstBrace !== -1 && (firstBracket === -1 || firstBrace < firstBracket)) {\n      candidate = candidate.slice(firstBrace);\n    } else if (firstBracket !== -1) {\n      candidate = candidate.slice(firstBracket);\n    }\n  }\n\n  if (!candidate.endsWith(\"}\") && !candidate.endsWith(\"]\")) {\n    const lastBrace = candidate.lastIndexOf(\"}\");\n    const lastBracket = candidate.lastIndexOf(\"]\");\n    if (lastBrace !== -1 && (lastBracket === -1 || lastBrace > lastBracket)) {\n      candidate = candidate.slice(0, lastBrace + 1);\n    } else if (lastBracket !== -1) {\n      candidate = candidate.slice(0, lastBracket + 1);\n    }\n  }\n\n  const result = tryParseJSON(candidate);\n  if (result.success) {\n    return candidate;\n  }\n\n  return null;\n}\n\nexport function validateAgainstSchema(data: unknown, schema: Record<string, { type: string; required?: boolean }>): { valid: true; data: unknown } | { valid: false; errors: string[] } {\n  if (typeof data !== \"object\" || data === null || Array.isArray(data)) {\n    return { valid: false, errors: [\"Root value must be an object\"] };\n  }\n\n  const errors: string[] = [];\n  const obj = data as Record<string, unknown>;\n\n  for (const [key, field] of Object.entries(schema)) {\n    const value = obj[key];\n\n    if (value === undefined && field.required !== false) {\n      errors.push(`Missing required field: \"${key}\"`);\n      continue;\n    }\n\n    if (value === undefined) {\n      continue;\n    }\n\n    switch (field.type) {\n      case \"string\":\n        if (typeof value !== \"string\") {\n          errors.push(`Field \"${key}\" must be string, got ${typeof value}`);\n        }\n        break;\n      case \"number\":\n        if (typeof value !== \"number\") {\n          errors.push(`Field \"${key}\" must be number, got ${typeof value}`);\n        }\n        break;\n      case \"boolean\":\n        if (typeof value !== \"boolean\") {\n          errors.push(`Field \"${key}\" must be boolean, got ${typeof value}`);\n        }\n        break;\n      case \"array\":\n        if (!Array.isArray(value)) {\n          errors.push(`Field \"${key}\" must be array, got ${typeof value}`);\n        }\n        break;\n      case \"object\":\n        if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n          errors.push(`Field \"${key}\" must be object, got ${typeof value}`);\n        }\n        break;\n    }\n  }\n\n  if (errors.length > 0) {\n    return { valid: false, errors };\n  }\n\n  return { valid: true, data };\n}\n","import { ExtractionSchema, SchemaField } from \"./types\";\n\nexport function defineSchema(name: string, fields: Record<string, SchemaField>): ExtractionSchema {\n  return { name, fields };\n}\n\nexport function schemaToPrompt(schema: ExtractionSchema): string {\n  const fieldDescriptions = Object.entries(schema.fields)\n    .map(([key, field]) => {\n      const parts = [`\"${key}\": ${fieldTypeToExample(field)}`];\n      if (field.description) {\n        parts.push(`// ${field.description}`);\n      }\n      return parts.join(\" \");\n    })\n    .join(\",\\n  \");\n\n  return `{\n  \"${schema.name}\": {\n  ${fieldDescriptions}\n  }\n}`;\n}\n\nfunction fieldTypeToExample(field: SchemaField): string {\n  switch (field.type) {\n    case \"string\":\n      return `\"...\"`;\n    case \"number\":\n      return \"0\";\n    case \"boolean\":\n      return \"true\";\n    case \"array\":\n      if (field.items) {\n        return `[${fieldTypeToExample(field.items)}]`;\n      }\n      return \"[]\";\n    case \"object\":\n      if (field.properties) {\n        const inner = Object.entries(field.properties)\n          .map(([k, v]) => `\"${k}\": ${fieldTypeToExample(v)}`)\n          .join(\", \");\n        return `{ ${inner} }`;\n      }\n      return \"{}\";\n  }\n}\n\nexport function schemaToZodishString(schema: ExtractionSchema): string {\n  const lines: string[] = [];\n  lines.push(`Expected JSON structure for \"${schema.name}\":`);\n\n  for (const [key, field] of Object.entries(schema.fields)) {\n    const required = field.required !== false ? \"(required)\" : \"(optional)\";\n    lines.push(`  - \"${key}\": ${field.type} ${required}${field.description ? ` - ${field.description}` : \"\"}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n","import { ExtractionSchema, ExtractionOptions, ExtractionResult } from \"./types\";\nimport { callLLM, LLMClientConfig } from \"./llm-client\";\nimport { extractJSON, repairJSON, tryParseJSON, validateAgainstSchema } from \"./validator\";\nimport { schemaToPrompt, schemaToZodishString } from \"./schema\";\n\n\nconst MAX_REPAIR_ATTEMPTS = 3;\n\nfunction unwrapNamedResponse(data: unknown, schemaName: string): unknown {\n  if (\n    typeof data === \"object\" &&\n    data !== null &&\n    !Array.isArray(data) &&\n    schemaName in data &&\n    typeof (data as Record<string, unknown>)[schemaName] === \"object\"\n  ) {\n    return (data as Record<string, unknown>)[schemaName];\n  }\n  return data;\n}\n\nexport async function extract<T = Record<string, unknown>>(\n  input: string,\n  schema: ExtractionSchema,\n  options: ExtractionOptions = {}\n): Promise<ExtractionResult<T>> {\n  const config: LLMClientConfig = {\n    apiKey: options.apiKey || process.env.OPENROUTER_API_KEY || \"\",\n    model: options.model || \"openrouter/free\",\n    temperature: options.temperature ?? 0,\n    timeout: options.timeout ?? 30000,\n  };\n\n  if (!config.apiKey || config.apiKey.trim() === \"\") {\n    throw new Error(\n      \"OpenRouter API key required. Pass it in options or set OPENROUTER_API_KEY environment variable.\"\n    );\n  }\n\n  const schemaDescription = schemaToZodishString(schema);\n  const exampleJSON = schemaToPrompt(schema);\n\n  const userPrompt = `Extract structured data from the following text.\n\n${schemaDescription}\n\nReturn ONLY valid JSON matching this structure:\n${exampleJSON}\n\nText to extract from:\n\"\"\"\n${input}\n\"\"\"`;\n\n  const schemaFields: Record<string, { type: string; required?: boolean }> = {};\n  for (const [key, field] of Object.entries(schema.fields)) {\n    schemaFields[key] = { type: field.type, required: field.required };\n  }\n\n  let lastRaw = \"\";\n  let lastError = \"\";\n\n  for (let attempt = 0; attempt <= MAX_REPAIR_ATTEMPTS; attempt++) {\n    const prompt =\n      attempt === 0\n        ? userPrompt\n        : `${userPrompt}\n\nIMPORTANT: Your previous response was invalid JSON. Here was the error:\n${lastError}\n\nPrevious raw response:\n${lastRaw}\n\nFix the JSON and return ONLY valid JSON. No explanations, no markdown, just the raw JSON object.`;\n\n    const response = await callLLM(prompt, config);\n    lastRaw = response.content;\n\n    const extracted = extractJSON(response.content);\n    if (!extracted) {\n      lastError = \"Could not extract JSON from response\";\n      continue;\n    }\n\n    const parsed = tryParseJSON(extracted);\n    if (!parsed.success) {\n      lastError = parsed.error;\n      continue;\n    }\n\n    const repaired = repairJSON(extracted);\n    const finalData = repaired\n      ? tryParseJSON(repaired).success\n        ? JSON.parse(repaired)\n        : parsed.data\n      : parsed.data;\n\n    const unwrapped = unwrapNamedResponse(finalData, schema.name);\n\n    const validation = validateAgainstSchema(unwrapped, schemaFields);\n    if (!validation.valid) {\n      lastError = `Schema validation failed: ${validation.errors.join(\", \")}`;\n      continue;\n    }\n\n    return {\n      data: unwrapped as T,\n      raw: response.content,\n      model: response.model,\n      usage: response.usage,\n    };\n  }\n\n  throw new Error(\n    `Failed to extract valid JSON after ${MAX_REPAIR_ATTEMPTS + 1} attempts. Last error: ${lastError}`\n  );\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,62 @@
+interface ExtractionSchema {
+    name: string;
+    fields: Record<string, SchemaField>;
+}
+type SchemaField = {
+    type: "string" | "number" | "boolean" | "array" | "object";
+    description?: string;
+    required?: boolean;
+    items?: SchemaField;
+    properties?: Record<string, SchemaField>;
+};
+interface ExtractionOptions {
+    apiKey?: string;
+    model?: string;
+    temperature?: number;
+    maxRetries?: number;
+    timeout?: number;
+}
+interface ExtractionResult<T> {
+    data: T;
+    raw: string;
+    model: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+interface ExtractionError {
+    type: "validation" | "api" | "timeout" | "parse";
+    message: string;
+    raw?: string;
+    attempts: number;
+}
+
+declare function extract<T = Record<string, unknown>>(input: string, schema: ExtractionSchema, options?: ExtractionOptions): Promise<ExtractionResult<T>>;
+
+declare function defineSchema(name: string, fields: Record<string, SchemaField>): ExtractionSchema;
+declare function schemaToPrompt(schema: ExtractionSchema): string;
+declare function schemaToZodishString(schema: ExtractionSchema): string;
+
+declare function tryParseJSON(raw: string): {
+    success: true;
+    data: unknown;
+} | {
+    success: false;
+    error: string;
+};
+declare function extractJSON(raw: string): string | null;
+declare function repairJSON(raw: string): string | null;
+declare function validateAgainstSchema(data: unknown, schema: Record<string, {
+    type: string;
+    required?: boolean;
+}>): {
+    valid: true;
+    data: unknown;
+} | {
+    valid: false;
+    errors: string[];
+};
+
+export { type ExtractionError, type ExtractionOptions, type ExtractionResult, type ExtractionSchema, type SchemaField, defineSchema, extract, extractJSON, repairJSON, schemaToPrompt, schemaToZodishString, tryParseJSON, validateAgainstSchema };

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+interface ExtractionSchema {
+    name: string;
+    fields: Record<string, SchemaField>;
+}
+type SchemaField = {
+    type: "string" | "number" | "boolean" | "array" | "object";
+    description?: string;
+    required?: boolean;
+    items?: SchemaField;
+    properties?: Record<string, SchemaField>;
+};
+interface ExtractionOptions {
+    apiKey?: string;
+    model?: string;
+    temperature?: number;
+    maxRetries?: number;
+    timeout?: number;
+}
+interface ExtractionResult<T> {
+    data: T;
+    raw: string;
+    model: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+interface ExtractionError {
+    type: "validation" | "api" | "timeout" | "parse";
+    message: string;
+    raw?: string;
+    attempts: number;
+}
+
+declare function extract<T = Record<string, unknown>>(input: string, schema: ExtractionSchema, options?: ExtractionOptions): Promise<ExtractionResult<T>>;
+
+declare function defineSchema(name: string, fields: Record<string, SchemaField>): ExtractionSchema;
+declare function schemaToPrompt(schema: ExtractionSchema): string;
+declare function schemaToZodishString(schema: ExtractionSchema): string;
+
+declare function tryParseJSON(raw: string): {
+    success: true;
+    data: unknown;
+} | {
+    success: false;
+    error: string;
+};
+declare function extractJSON(raw: string): string | null;
+declare function repairJSON(raw: string): string | null;
+declare function validateAgainstSchema(data: unknown, schema: Record<string, {
+    type: string;
+    required?: boolean;
+}>): {
+    valid: true;
+    data: unknown;
+} | {
+    valid: false;
+    errors: string[];
+};
+
+export { type ExtractionError, type ExtractionOptions, type ExtractionResult, type ExtractionSchema, type SchemaField, defineSchema, extract, extractJSON, repairJSON, schemaToPrompt, schemaToZodishString, tryParseJSON, validateAgainstSchema };

package/dist/index.js

@@ -0,0 +1,323 @@
+// src/llm-client.ts
+var DEFAULT_MODEL = "openrouter/free";
+var DEFAULT_TEMPERATURE = 0;
+var DEFAULT_TIMEOUT = 6e4;
+async function callLLM(prompt, config) {
+  const {
+    apiKey,
+    model = DEFAULT_MODEL,
+    temperature = DEFAULT_TEMPERATURE,
+    timeout = DEFAULT_TIMEOUT
+  } = config;
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeout);
+  try {
+    const response = await fetch("https://openrouter.ai/api/v1/chat/completions", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`,
+        "HTTP-Referer": "https://github.com/harshitduggal/structured-llm",
+        "X-Title": "structured-llm"
+      },
+      body: JSON.stringify({
+        model,
+        messages: [
+          {
+            role: "system",
+            content: "You are a precise data extraction assistant. You MUST respond with valid JSON only. No explanations, no markdown, no text outside the JSON. Just the raw JSON object."
+          },
+          {
+            role: "user",
+            content: prompt
+          }
+        ],
+        temperature,
+        response_format: { type: "json_object" }
+      }),
+      signal: controller.signal
+    });
+    if (!response.ok) {
+      const errorBody = await response.text();
+      throw new Error(
+        `OpenRouter API error: ${response.status} - ${errorBody}`
+      );
+    }
+    const data = await response.json();
+    if (!data.choices || data.choices.length === 0) {
+      throw new Error("No response from LLM");
+    }
+    const content = data.choices[0].message?.content;
+    if (!content) {
+      throw new Error("Empty response from LLM");
+    }
+    return {
+      content,
+      model: data.model || model,
+      usage: data.usage ? {
+        promptTokens: data.usage.prompt_tokens,
+        completionTokens: data.usage.completion_tokens,
+        totalTokens: data.usage.total_tokens
+      } : void 0
+    };
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+
+// src/validator.ts
+function tryParseJSON(raw) {
+  try {
+    const data = JSON.parse(raw);
+    return { success: true, data };
+  } catch (e) {
+    return { success: false, error: e instanceof Error ? e.message : "Unknown parse error" };
+  }
+}
+function extractJSON(raw) {
+  const trimmed = raw.trim();
+  if (tryParseJSON(trimmed).success) {
+    return trimmed;
+  }
+  const codeBlockMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
+  if (codeBlockMatch) {
+    const inner = codeBlockMatch[1].trim();
+    if (tryParseJSON(inner).success) {
+      return inner;
+    }
+  }
+  const firstBrace = trimmed.indexOf("{");
+  const lastBrace = trimmed.lastIndexOf("}");
+  if (firstBrace !== -1 && lastBrace > firstBrace) {
+    const candidate = trimmed.slice(firstBrace, lastBrace + 1);
+    if (tryParseJSON(candidate).success) {
+      return candidate;
+    }
+  }
+  const firstBracket = trimmed.indexOf("[");
+  const lastBracket = trimmed.lastIndexOf("]");
+  if (firstBracket !== -1 && lastBracket > firstBracket) {
+    const candidate = trimmed.slice(firstBracket, lastBracket + 1);
+    if (tryParseJSON(candidate).success) {
+      return candidate;
+    }
+  }
+  return null;
+}
+function repairJSON(raw) {
+  let candidate = raw.trim();
+  candidate = candidate.replace(/,\s*([}\]])/g, "$1");
+  candidate = candidate.replace(/'/g, '"');
+  candidate = candidate.replace(/(\w+)\s*:/g, '"$1":');
+  candidate = candidate.replace(/:\s*"([^"]*?)"/g, (match, content) => {
+    if (content.includes('"')) {
+      return match;
+    }
+    return match;
+  });
+  if (!candidate.startsWith("{") && !candidate.startsWith("[")) {
+    const firstBrace = candidate.indexOf("{");
+    const firstBracket = candidate.indexOf("[");
+    if (firstBrace !== -1 && (firstBracket === -1 || firstBrace < firstBracket)) {
+      candidate = candidate.slice(firstBrace);
+    } else if (firstBracket !== -1) {
+      candidate = candidate.slice(firstBracket);
+    }
+  }
+  if (!candidate.endsWith("}") && !candidate.endsWith("]")) {
+    const lastBrace = candidate.lastIndexOf("}");
+    const lastBracket = candidate.lastIndexOf("]");
+    if (lastBrace !== -1 && (lastBracket === -1 || lastBrace > lastBracket)) {
+      candidate = candidate.slice(0, lastBrace + 1);
+    } else if (lastBracket !== -1) {
+      candidate = candidate.slice(0, lastBracket + 1);
+    }
+  }
+  const result = tryParseJSON(candidate);
+  if (result.success) {
+    return candidate;
+  }
+  return null;
+}
+function validateAgainstSchema(data, schema) {
+  if (typeof data !== "object" || data === null || Array.isArray(data)) {
+    return { valid: false, errors: ["Root value must be an object"] };
+  }
+  const errors = [];
+  const obj = data;
+  for (const [key, field] of Object.entries(schema)) {
+    const value = obj[key];
+    if (value === void 0 && field.required !== false) {
+      errors.push(`Missing required field: "${key}"`);
+      continue;
+    }
+    if (value === void 0) {
+      continue;
+    }
+    switch (field.type) {
+      case "string":
+        if (typeof value !== "string") {
+          errors.push(`Field "${key}" must be string, got ${typeof value}`);
+        }
+        break;
+      case "number":
+        if (typeof value !== "number") {
+          errors.push(`Field "${key}" must be number, got ${typeof value}`);
+        }
+        break;
+      case "boolean":
+        if (typeof value !== "boolean") {
+          errors.push(`Field "${key}" must be boolean, got ${typeof value}`);
+        }
+        break;
+      case "array":
+        if (!Array.isArray(value)) {
+          errors.push(`Field "${key}" must be array, got ${typeof value}`);
+        }
+        break;
+      case "object":
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+          errors.push(`Field "${key}" must be object, got ${typeof value}`);
+        }
+        break;
+    }
+  }
+  if (errors.length > 0) {
+    return { valid: false, errors };
+  }
+  return { valid: true, data };
+}
+
+// src/schema.ts
+function defineSchema(name, fields) {
+  return { name, fields };
+}
+function schemaToPrompt(schema) {
+  const fieldDescriptions = Object.entries(schema.fields).map(([key, field]) => {
+    const parts = [`"${key}": ${fieldTypeToExample(field)}`];
+    if (field.description) {
+      parts.push(`// ${field.description}`);
+    }
+    return parts.join(" ");
+  }).join(",\n  ");
+  return `{
+  "${schema.name}": {
+  ${fieldDescriptions}
+  }
+}`;
+}
+function fieldTypeToExample(field) {
+  switch (field.type) {
+    case "string":
+      return `"..."`;
+    case "number":
+      return "0";
+    case "boolean":
+      return "true";
+    case "array":
+      if (field.items) {
+        return `[${fieldTypeToExample(field.items)}]`;
+      }
+      return "[]";
+    case "object":
+      if (field.properties) {
+        const inner = Object.entries(field.properties).map(([k, v]) => `"${k}": ${fieldTypeToExample(v)}`).join(", ");
+        return `{ ${inner} }`;
+      }
+      return "{}";
+  }
+}
+function schemaToZodishString(schema) {
+  const lines = [];
+  lines.push(`Expected JSON structure for "${schema.name}":`);
+  for (const [key, field] of Object.entries(schema.fields)) {
+    const required = field.required !== false ? "(required)" : "(optional)";
+    lines.push(`  - "${key}": ${field.type} ${required}${field.description ? ` - ${field.description}` : ""}`);
+  }
+  return lines.join("\n");
+}
+
+// src/extractor.ts
+var MAX_REPAIR_ATTEMPTS = 3;
+function unwrapNamedResponse(data, schemaName) {
+  if (typeof data === "object" && data !== null && !Array.isArray(data) && schemaName in data && typeof data[schemaName] === "object") {
+    return data[schemaName];
+  }
+  return data;
+}
+async function extract(input, schema, options = {}) {
+  const config = {
+    apiKey: options.apiKey || process.env.OPENROUTER_API_KEY || "",
+    model: options.model || "openrouter/free",
+    temperature: options.temperature ?? 0,
+    timeout: options.timeout ?? 3e4
+  };
+  if (!config.apiKey || config.apiKey.trim() === "") {
+    throw new Error(
+      "OpenRouter API key required. Pass it in options or set OPENROUTER_API_KEY environment variable."
+    );
+  }
+  const schemaDescription = schemaToZodishString(schema);
+  const exampleJSON = schemaToPrompt(schema);
+  const userPrompt = `Extract structured data from the following text.
+
+${schemaDescription}
+
+Return ONLY valid JSON matching this structure:
+${exampleJSON}
+
+Text to extract from:
+"""
+${input}
+"""`;
+  const schemaFields = {};
+  for (const [key, field] of Object.entries(schema.fields)) {
+    schemaFields[key] = { type: field.type, required: field.required };
+  }
+  let lastRaw = "";
+  let lastError = "";
+  for (let attempt = 0; attempt <= MAX_REPAIR_ATTEMPTS; attempt++) {
+    const prompt = attempt === 0 ? userPrompt : `${userPrompt}
+
+IMPORTANT: Your previous response was invalid JSON. Here was the error:
+${lastError}
+
+Previous raw response:
+${lastRaw}
+
+Fix the JSON and return ONLY valid JSON. No explanations, no markdown, just the raw JSON object.`;
+    const response = await callLLM(prompt, config);
+    lastRaw = response.content;
+    const extracted = extractJSON(response.content);
+    if (!extracted) {
+      lastError = "Could not extract JSON from response";
+      continue;
+    }
+    const parsed = tryParseJSON(extracted);
+    if (!parsed.success) {
+      lastError = parsed.error;
+      continue;
+    }
+    const repaired = repairJSON(extracted);
+    const finalData = repaired ? tryParseJSON(repaired).success ? JSON.parse(repaired) : parsed.data : parsed.data;
+    const unwrapped = unwrapNamedResponse(finalData, schema.name);
+    const validation = validateAgainstSchema(unwrapped, schemaFields);
+    if (!validation.valid) {
+      lastError = `Schema validation failed: ${validation.errors.join(", ")}`;
+      continue;
+    }
+    return {
+      data: unwrapped,
+      raw: response.content,
+      model: response.model,
+      usage: response.usage
+    };
+  }
+  throw new Error(
+    `Failed to extract valid JSON after ${MAX_REPAIR_ATTEMPTS + 1} attempts. Last error: ${lastError}`
+  );
+}
+
+export { defineSchema, extract, extractJSON, repairJSON, schemaToPrompt, schemaToZodishString, tryParseJSON, validateAgainstSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/llm-client.ts","../src/validator.ts","../src/schema.ts","../src/extractor.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export interface LLMClientConfig {\n  apiKey: string;\n  model: string;\n  temperature?: number;\n  timeout?: number;\n}\n\nexport interface LLMResponse {\n  content: string;\n  model: string;\n  usage?: {\n    promptTokens: number;\n    completionTokens: number;\n    totalTokens: number;\n  };\n}\n\ninterface OpenRouterChoice {\n  message?: {\n    content?: string;\n  };\n}\n\ninterface OpenRouterResponse {\n  choices?: OpenRouterChoice[];\n  model?: string;\n  usage?: {\n    prompt_tokens: number;\n    completion_tokens: number;\n    total_tokens: number;\n  };\n}\n\nconst DEFAULT_MODEL = \"openrouter/free\";\nconst DEFAULT_TEMPERATURE = 0;\nconst DEFAULT_TIMEOUT = 60000;\n\nexport async function callLLM(\n  prompt: string,\n  config: LLMClientConfig\n): Promise<LLMResponse> {\n  const {\n    apiKey,\n    model = DEFAULT_MODEL,\n    temperature = DEFAULT_TEMPERATURE,\n    timeout = DEFAULT_TIMEOUT,\n  } = config;\n\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n  try {\n    const response = await fetch(\"https://openrouter.ai/api/v1/chat/completions\", {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${apiKey}`,\n        \"HTTP-Referer\": \"https://github.com/harshitduggal/structured-llm\",\n        \"X-Title\": \"structured-llm\",\n      },\n      body: JSON.stringify({\n        model,\n        messages: [\n          {\n            role: \"system\",\n            content: \"You are a precise data extraction assistant. You MUST respond with valid JSON only. No explanations, no markdown, no text outside the JSON. Just the raw JSON object.\",\n          },\n          {\n            role: \"user\",\n            content: prompt,\n          },\n        ],\n        temperature,\n        response_format: { type: \"json_object\" },\n      }),\n      signal: controller.signal,\n    });\n\n    if (!response.ok) {\n      const errorBody = await response.text();\n      throw new Error(\n        `OpenRouter API error: ${response.status} - ${errorBody}`\n      );\n    }\n\n    const data = (await response.json()) as OpenRouterResponse;\n\n    if (!data.choices || data.choices.length === 0) {\n      throw new Error(\"No response from LLM\");\n    }\n\n    const content = data.choices[0].message?.content;\n    if (!content) {\n      throw new Error(\"Empty response from LLM\");\n    }\n\n    return {\n      content,\n      model: data.model || model,\n      usage: data.usage\n        ? {\n            promptTokens: data.usage.prompt_tokens,\n            completionTokens: data.usage.completion_tokens,\n            totalTokens: data.usage.total_tokens,\n          }\n        : undefined,\n    };\n  } finally {\n    clearTimeout(timeoutId);\n  }\n}\n","export function tryParseJSON(raw: string): { success: true; data: unknown } | { success: false; error: string } {\n  try {\n    const data = JSON.parse(raw);\n    return { success: true, data };\n  } catch (e) {\n    return { success: false, error: e instanceof Error ? e.message : \"Unknown parse error\" };\n  }\n}\n\nexport function extractJSON(raw: string): string | null {\n  const trimmed = raw.trim();\n\n  if (tryParseJSON(trimmed).success) {\n    return trimmed;\n  }\n\n  const codeBlockMatch = trimmed.match(/```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?\\s*```/);\n  if (codeBlockMatch) {\n    const inner = codeBlockMatch[1].trim();\n    if (tryParseJSON(inner).success) {\n      return inner;\n    }\n  }\n\n  const firstBrace = trimmed.indexOf(\"{\");\n  const lastBrace = trimmed.lastIndexOf(\"}\");\n  if (firstBrace !== -1 && lastBrace > firstBrace) {\n    const candidate = trimmed.slice(firstBrace, lastBrace + 1);\n    if (tryParseJSON(candidate).success) {\n      return candidate;\n    }\n  }\n\n  const firstBracket = trimmed.indexOf(\"[\");\n  const lastBracket = trimmed.lastIndexOf(\"]\");\n  if (firstBracket !== -1 && lastBracket > firstBracket) {\n    const candidate = trimmed.slice(firstBracket, lastBracket + 1);\n    if (tryParseJSON(candidate).success) {\n      return candidate;\n    }\n  }\n\n  return null;\n}\n\nexport function repairJSON(raw: string): string | null {\n  let candidate = raw.trim();\n\n  candidate = candidate.replace(/,\\s*([}\\]])/g, \"$1\");\n\n  candidate = candidate.replace(/'/g, '\"');\n\n  candidate = candidate.replace(/(\\w+)\\s*:/g, '\"$1\":');\n\n  candidate = candidate.replace(/:\\s*\"([^\"]*?)\"/g, (match, content) => {\n    if (content.includes('\"')) {\n      return match;\n    }\n    return match;\n  });\n\n  if (!candidate.startsWith(\"{\") && !candidate.startsWith(\"[\")) {\n    const firstBrace = candidate.indexOf(\"{\");\n    const firstBracket = candidate.indexOf(\"[\");\n    if (firstBrace !== -1 && (firstBracket === -1 || firstBrace < firstBracket)) {\n      candidate = candidate.slice(firstBrace);\n    } else if (firstBracket !== -1) {\n      candidate = candidate.slice(firstBracket);\n    }\n  }\n\n  if (!candidate.endsWith(\"}\") && !candidate.endsWith(\"]\")) {\n    const lastBrace = candidate.lastIndexOf(\"}\");\n    const lastBracket = candidate.lastIndexOf(\"]\");\n    if (lastBrace !== -1 && (lastBracket === -1 || lastBrace > lastBracket)) {\n      candidate = candidate.slice(0, lastBrace + 1);\n    } else if (lastBracket !== -1) {\n      candidate = candidate.slice(0, lastBracket + 1);\n    }\n  }\n\n  const result = tryParseJSON(candidate);\n  if (result.success) {\n    return candidate;\n  }\n\n  return null;\n}\n\nexport function validateAgainstSchema(data: unknown, schema: Record<string, { type: string; required?: boolean }>): { valid: true; data: unknown } | { valid: false; errors: string[] } {\n  if (typeof data !== \"object\" || data === null || Array.isArray(data)) {\n    return { valid: false, errors: [\"Root value must be an object\"] };\n  }\n\n  const errors: string[] = [];\n  const obj = data as Record<string, unknown>;\n\n  for (const [key, field] of Object.entries(schema)) {\n    const value = obj[key];\n\n    if (value === undefined && field.required !== false) {\n      errors.push(`Missing required field: \"${key}\"`);\n      continue;\n    }\n\n    if (value === undefined) {\n      continue;\n    }\n\n    switch (field.type) {\n      case \"string\":\n        if (typeof value !== \"string\") {\n          errors.push(`Field \"${key}\" must be string, got ${typeof value}`);\n        }\n        break;\n      case \"number\":\n        if (typeof value !== \"number\") {\n          errors.push(`Field \"${key}\" must be number, got ${typeof value}`);\n        }\n        break;\n      case \"boolean\":\n        if (typeof value !== \"boolean\") {\n          errors.push(`Field \"${key}\" must be boolean, got ${typeof value}`);\n        }\n        break;\n      case \"array\":\n        if (!Array.isArray(value)) {\n          errors.push(`Field \"${key}\" must be array, got ${typeof value}`);\n        }\n        break;\n      case \"object\":\n        if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n          errors.push(`Field \"${key}\" must be object, got ${typeof value}`);\n        }\n        break;\n    }\n  }\n\n  if (errors.length > 0) {\n    return { valid: false, errors };\n  }\n\n  return { valid: true, data };\n}\n","import { ExtractionSchema, SchemaField } from \"./types\";\n\nexport function defineSchema(name: string, fields: Record<string, SchemaField>): ExtractionSchema {\n  return { name, fields };\n}\n\nexport function schemaToPrompt(schema: ExtractionSchema): string {\n  const fieldDescriptions = Object.entries(schema.fields)\n    .map(([key, field]) => {\n      const parts = [`\"${key}\": ${fieldTypeToExample(field)}`];\n      if (field.description) {\n        parts.push(`// ${field.description}`);\n      }\n      return parts.join(\" \");\n    })\n    .join(\",\\n  \");\n\n  return `{\n  \"${schema.name}\": {\n  ${fieldDescriptions}\n  }\n}`;\n}\n\nfunction fieldTypeToExample(field: SchemaField): string {\n  switch (field.type) {\n    case \"string\":\n      return `\"...\"`;\n    case \"number\":\n      return \"0\";\n    case \"boolean\":\n      return \"true\";\n    case \"array\":\n      if (field.items) {\n        return `[${fieldTypeToExample(field.items)}]`;\n      }\n      return \"[]\";\n    case \"object\":\n      if (field.properties) {\n        const inner = Object.entries(field.properties)\n          .map(([k, v]) => `\"${k}\": ${fieldTypeToExample(v)}`)\n          .join(\", \");\n        return `{ ${inner} }`;\n      }\n      return \"{}\";\n  }\n}\n\nexport function schemaToZodishString(schema: ExtractionSchema): string {\n  const lines: string[] = [];\n  lines.push(`Expected JSON structure for \"${schema.name}\":`);\n\n  for (const [key, field] of Object.entries(schema.fields)) {\n    const required = field.required !== false ? \"(required)\" : \"(optional)\";\n    lines.push(`  - \"${key}\": ${field.type} ${required}${field.description ? ` - ${field.description}` : \"\"}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n","import { ExtractionSchema, ExtractionOptions, ExtractionResult } from \"./types\";\nimport { callLLM, LLMClientConfig } from \"./llm-client\";\nimport { extractJSON, repairJSON, tryParseJSON, validateAgainstSchema } from \"./validator\";\nimport { schemaToPrompt, schemaToZodishString } from \"./schema\";\n\n\nconst MAX_REPAIR_ATTEMPTS = 3;\n\nfunction unwrapNamedResponse(data: unknown, schemaName: string): unknown {\n  if (\n    typeof data === \"object\" &&\n    data !== null &&\n    !Array.isArray(data) &&\n    schemaName in data &&\n    typeof (data as Record<string, unknown>)[schemaName] === \"object\"\n  ) {\n    return (data as Record<string, unknown>)[schemaName];\n  }\n  return data;\n}\n\nexport async function extract<T = Record<string, unknown>>(\n  input: string,\n  schema: ExtractionSchema,\n  options: ExtractionOptions = {}\n): Promise<ExtractionResult<T>> {\n  const config: LLMClientConfig = {\n    apiKey: options.apiKey || process.env.OPENROUTER_API_KEY || \"\",\n    model: options.model || \"openrouter/free\",\n    temperature: options.temperature ?? 0,\n    timeout: options.timeout ?? 30000,\n  };\n\n  if (!config.apiKey || config.apiKey.trim() === \"\") {\n    throw new Error(\n      \"OpenRouter API key required. Pass it in options or set OPENROUTER_API_KEY environment variable.\"\n    );\n  }\n\n  const schemaDescription = schemaToZodishString(schema);\n  const exampleJSON = schemaToPrompt(schema);\n\n  const userPrompt = `Extract structured data from the following text.\n\n${schemaDescription}\n\nReturn ONLY valid JSON matching this structure:\n${exampleJSON}\n\nText to extract from:\n\"\"\"\n${input}\n\"\"\"`;\n\n  const schemaFields: Record<string, { type: string; required?: boolean }> = {};\n  for (const [key, field] of Object.entries(schema.fields)) {\n    schemaFields[key] = { type: field.type, required: field.required };\n  }\n\n  let lastRaw = \"\";\n  let lastError = \"\";\n\n  for (let attempt = 0; attempt <= MAX_REPAIR_ATTEMPTS; attempt++) {\n    const prompt =\n      attempt === 0\n        ? userPrompt\n        : `${userPrompt}\n\nIMPORTANT: Your previous response was invalid JSON. Here was the error:\n${lastError}\n\nPrevious raw response:\n${lastRaw}\n\nFix the JSON and return ONLY valid JSON. No explanations, no markdown, just the raw JSON object.`;\n\n    const response = await callLLM(prompt, config);\n    lastRaw = response.content;\n\n    const extracted = extractJSON(response.content);\n    if (!extracted) {\n      lastError = \"Could not extract JSON from response\";\n      continue;\n    }\n\n    const parsed = tryParseJSON(extracted);\n    if (!parsed.success) {\n      lastError = parsed.error;\n      continue;\n    }\n\n    const repaired = repairJSON(extracted);\n    const finalData = repaired\n      ? tryParseJSON(repaired).success\n        ? JSON.parse(repaired)\n        : parsed.data\n      : parsed.data;\n\n    const unwrapped = unwrapNamedResponse(finalData, schema.name);\n\n    const validation = validateAgainstSchema(unwrapped, schemaFields);\n    if (!validation.valid) {\n      lastError = `Schema validation failed: ${validation.errors.join(\", \")}`;\n      continue;\n    }\n\n    return {\n      data: unwrapped as T,\n      raw: response.content,\n      model: response.model,\n      usage: response.usage,\n    };\n  }\n\n  throw new Error(\n    `Failed to extract valid JSON after ${MAX_REPAIR_ATTEMPTS + 1} attempts. Last error: ${lastError}`\n  );\n}\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@painitehq/structured-llm",
+  "version": "0.1.0",
+  "description": "Force LLM output into structured, type-safe JSON. Stop your app from crashing on malformed AI responses.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "lint": "eslint src/",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "llm",
+    "ai",
+    "json",
+    "structured-output",
+    "schema",
+    "openrouter",
+    "extraction",
+    "type-safe",
+    "zod"
+  ],
+  "author": "harshitduggal",
+  "license": "MIT",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^26.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "~5.7.0",
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "zod": "^3.23.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    }
+  }
+}