@kaleabdenbel/llmweb 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kaleab Denbel
+
+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

@@ -0,0 +1,96 @@
+# llmweb 🛸
+
+The data compiler that transforms messy application state into LLM-readable truth.
+
+## The Mental Model
+
+`llmweb` is not just a metadata library. it's a compiler for your website's soul.
+
+- **Static Truth**: Your contract with the world. Deterministic. Versioned.
+- **Dynamic Truth**: Live data from APIs, Server Actions, or DB calls.
+- **The Engine**: Compiles these into a single, structured JSON object for LLMs.
+
+## Installation
+
+```bash
+npm install llmweb
+```
+
+## Quick Start (Next.js)
+
+### 1. Define your Truth
+
+Create an LLM route to expose your site's data.
+
+```typescript
+// app/llm/route.ts
+import { createLLMHandler } from "llmweb/adapters/next";
+import { getStaffList } from "@/actions/getStaffList";
+
+const config = {
+  static: "./llm.json", // Path to your static contract
+
+  dynamic: {
+    announcements: {
+      from: { type: "fetch", url: "https://api.site.com/news" },
+      map: {
+        title: "headline",
+        body: "content",
+        publishedAt: "date",
+      },
+    },
+    staff: {
+      from: { type: "fn", call: getStaffList },
+      map: {
+        name: "full_name",
+        role: "role_title",
+      },
+    },
+  },
+};
+
+export const GET = createLLMHandler(config);
+```
+
+### 2. Use the Component
+
+Render the compiled truth directly in your admin or SEO pages.
+
+```tsx
+import { LLMJson } from "llmweb/adapters/next";
+
+export default function LlmTruthPage() {
+  return (
+    <div className="p-8">
+      <h1>LLM Truth Engine</h1>
+      <LLMJson
+        config={config}
+        className="bg-gray-900 text-green-400 p-4 rounded"
+      />
+    </div>
+  );
+}
+```
+
+## The Engine Features
+
+- **Brutal Mapping**: Rename, pick, omit, and compute fields easily.
+- **Parallel Resolution**: All dynamic sources are resolved in parallel.
+- **Error Boundaries**: Configurable `failLoudly` mode for strict data integrity.
+- **Timeouts**: Prevent slow APIs from hanging your truth route.
+- **Deterministic Merging**: Static structure defines the slots; dynamic data fills them.
+
+## Advanced Mapping
+
+```typescript
+map: {
+  fullName: (s) => `${s.first} ${s.last}`, // Computed field
+  meta: {
+     tags: "categories", // Nested renames
+  }
+}
+```
+
+## License
+
+MIT

package/dist/adapters/express.d.ts

@@ -0,0 +1,5 @@
+import { LLMConfig } from '../types';
+/**
+ * An Express middleware that serves the LLM truth.
+ */
+export declare function llmMiddleware(config: LLMConfig): (req: any, res: any, next: any) => Promise<void>;

package/dist/adapters/express.js

@@ -0,0 +1,160 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/express.ts
+var express_exports = {};
+__export(express_exports, {
+  llmMiddleware: () => llmMiddleware
+});
+module.exports = __toCommonJS(express_exports);
+
+// src/core/resolver.ts
+async function resolveAll(dynamicSources, options = {}) {
+  const keys = Object.keys(dynamicSources);
+  const results = await Promise.allSettled(
+    keys.map((key) => resolveSource(dynamicSources[key], options.timeout))
+  );
+  const data = {};
+  results.forEach((result, index) => {
+    const key = keys[index];
+    if (result.status === "fulfilled") {
+      data[key] = result.value;
+    } else {
+      console.error(`[llmweb] Failed to resolve source "${key}":`, result.reason);
+      data[key] = null;
+    }
+  });
+  return data;
+}
+async function resolveSource(source, timeoutMs) {
+  const { from } = source;
+  const controller = timeoutMs ? new AbortController() : null;
+  const signal = controller?.signal;
+  const timeoutPromise = timeoutMs ? new Promise(
+    (_, reject) => setTimeout(() => {
+      controller?.abort();
+      reject(new Error(`Timeout of ${timeoutMs}ms exceeded`));
+    }, timeoutMs)
+  ) : null;
+  const resolvePromise = (async () => {
+    if (from.type === "fetch") {
+      if (!from.url) throw new Error("Fetch source requires a URL");
+      const response = await fetch(from.url, { signal });
+      if (!response.ok) throw new Error(`HTTP error ${response.status} for ${from.url}`);
+      return response.json();
+    }
+    if (from.type === "fn") {
+      if (!from.call) throw new Error('Function source requires a "call" property');
+      return from.call();
+    }
+    throw new Error(`Unsupported source type: ${from.type}`);
+  })();
+  if (timeoutPromise) {
+    return Promise.race([resolvePromise, timeoutPromise]);
+  }
+  return resolvePromise;
+}
+
+// src/core/transformer.ts
+function transform(sourceData, schema) {
+  if (!sourceData || typeof sourceData !== "object") return sourceData;
+  const result = {};
+  for (const [targetKey, mapping] of Object.entries(schema)) {
+    if (typeof mapping === "string") {
+      result[targetKey] = getValueByPath(sourceData, mapping);
+    } else if (typeof mapping === "function") {
+      result[targetKey] = mapping(sourceData);
+    } else if (typeof mapping === "object" && mapping !== null) {
+      result[targetKey] = transform(sourceData, mapping);
+    }
+  }
+  return result;
+}
+function getValueByPath(obj, path) {
+  return path.split(".").reduce((acc, part) => acc && acc[part], obj);
+}
+
+// src/core/merger.ts
+function merge(staticData, dynamicResults) {
+  if (!staticData) return dynamicResults;
+  return {
+    ...staticData,
+    ...dynamicResults
+  };
+}
+
+// src/index.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+async function createLLMSource(config, options = {}) {
+  let staticTruth = {};
+  if (config.static) {
+    try {
+      const staticPath = config.static.startsWith("/") ? config.static : (0, import_node_path.join)(process.cwd(), config.static);
+      const content = (0, import_node_fs.readFileSync)(staticPath, "utf-8");
+      staticTruth = JSON.parse(content);
+    } catch (error) {
+      if (options.failLoudly) {
+        throw new Error(`[llmweb] Static Truth Error: Failed to load/parse JSON at ${config.static}. ${error}`);
+      }
+      console.warn(`[llmweb] Warning: Could not load static JSON at ${config.static}. Proceeding with dynamic data only.`);
+    }
+  }
+  const dynamicTruth = {};
+  if (config.dynamic) {
+    const rawResults = await resolveAll(config.dynamic, { timeout: options.timeout });
+    for (const [key, source] of Object.entries(config.dynamic)) {
+      const rawData = rawResults[key];
+      if (rawData === null && options.failLoudly) {
+        throw new Error(`[llmweb] Dynamic Truth Error: Source "${key}" failed to resolve.`);
+      }
+      if (rawData && source.map) {
+        try {
+          dynamicTruth[key] = transform(rawData, source.map);
+        } catch (error) {
+          if (options.failLoudly) {
+            throw new Error(`[llmweb] Transformation Error: Failed to map source "${key}". ${error}`);
+          }
+          console.error(`[llmweb] Warning: Mapping failed for "${key}". Using raw data.`);
+          dynamicTruth[key] = rawData;
+        }
+      } else {
+        dynamicTruth[key] = rawData;
+      }
+    }
+  }
+  return merge(staticTruth, dynamicTruth);
+}
+
+// src/adapters/express.ts
+function llmMiddleware(config) {
+  return async (req, res, next) => {
+    try {
+      const truth = await createLLMSource(config);
+      res.status(200).json(truth);
+    } catch (error) {
+      console.error("[llmweb] Express middleware error:", error);
+      res.status(500).json({ error: "Internal Server Error" });
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  llmMiddleware
+});

package/dist/adapters/express.mjs

@@ -0,0 +1,19 @@
+import {
+  createLLMSource
+} from "../chunk-PYG5H54N.mjs";
+
+// src/adapters/express.ts
+function llmMiddleware(config) {
+  return async (req, res, next) => {
+    try {
+      const truth = await createLLMSource(config);
+      res.status(200).json(truth);
+    } catch (error) {
+      console.error("[llmweb] Express middleware error:", error);
+      res.status(500).json({ error: "Internal Server Error" });
+    }
+  };
+}
+export {
+  llmMiddleware
+};

package/dist/adapters/next.d.ts

@@ -0,0 +1,18 @@
+import { LLMConfig } from "../types";
+interface LLMJsonProps {
+    config: LLMConfig;
+    /**
+     * Optional custom styling for the rendered JSON if viewing in a browser.
+     */
+    className?: string;
+}
+/**
+ * A Next.js Server Component that resolves the LLM truth and renders it.
+ * By default, it renders a <pre> tag with the JSON string.
+ */
+export declare function LLMJson({ config, className }: LLMJsonProps): Promise<import("react/jsx-runtime").JSX.Element>;
+/**
+ * A helper for Next.js App Router Route Handlers (route.ts).
+ */
+export declare function createLLMHandler(config: LLMConfig): () => Promise<Response>;
+export {};

package/dist/adapters/next.js

@@ -0,0 +1,167 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/next.tsx
+var next_exports = {};
+__export(next_exports, {
+  LLMJson: () => LLMJson,
+  createLLMHandler: () => createLLMHandler
+});
+module.exports = __toCommonJS(next_exports);
+
+// src/core/resolver.ts
+async function resolveAll(dynamicSources, options = {}) {
+  const keys = Object.keys(dynamicSources);
+  const results = await Promise.allSettled(
+    keys.map((key) => resolveSource(dynamicSources[key], options.timeout))
+  );
+  const data = {};
+  results.forEach((result, index) => {
+    const key = keys[index];
+    if (result.status === "fulfilled") {
+      data[key] = result.value;
+    } else {
+      console.error(`[llmweb] Failed to resolve source "${key}":`, result.reason);
+      data[key] = null;
+    }
+  });
+  return data;
+}
+async function resolveSource(source, timeoutMs) {
+  const { from } = source;
+  const controller = timeoutMs ? new AbortController() : null;
+  const signal = controller?.signal;
+  const timeoutPromise = timeoutMs ? new Promise(
+    (_, reject) => setTimeout(() => {
+      controller?.abort();
+      reject(new Error(`Timeout of ${timeoutMs}ms exceeded`));
+    }, timeoutMs)
+  ) : null;
+  const resolvePromise = (async () => {
+    if (from.type === "fetch") {
+      if (!from.url) throw new Error("Fetch source requires a URL");
+      const response = await fetch(from.url, { signal });
+      if (!response.ok) throw new Error(`HTTP error ${response.status} for ${from.url}`);
+      return response.json();
+    }
+    if (from.type === "fn") {
+      if (!from.call) throw new Error('Function source requires a "call" property');
+      return from.call();
+    }
+    throw new Error(`Unsupported source type: ${from.type}`);
+  })();
+  if (timeoutPromise) {
+    return Promise.race([resolvePromise, timeoutPromise]);
+  }
+  return resolvePromise;
+}
+
+// src/core/transformer.ts
+function transform(sourceData, schema) {
+  if (!sourceData || typeof sourceData !== "object") return sourceData;
+  const result = {};
+  for (const [targetKey, mapping] of Object.entries(schema)) {
+    if (typeof mapping === "string") {
+      result[targetKey] = getValueByPath(sourceData, mapping);
+    } else if (typeof mapping === "function") {
+      result[targetKey] = mapping(sourceData);
+    } else if (typeof mapping === "object" && mapping !== null) {
+      result[targetKey] = transform(sourceData, mapping);
+    }
+  }
+  return result;
+}
+function getValueByPath(obj, path) {
+  return path.split(".").reduce((acc, part) => acc && acc[part], obj);
+}
+
+// src/core/merger.ts
+function merge(staticData, dynamicResults) {
+  if (!staticData) return dynamicResults;
+  return {
+    ...staticData,
+    ...dynamicResults
+  };
+}
+
+// src/index.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+async function createLLMSource(config, options = {}) {
+  let staticTruth = {};
+  if (config.static) {
+    try {
+      const staticPath = config.static.startsWith("/") ? config.static : (0, import_node_path.join)(process.cwd(), config.static);
+      const content = (0, import_node_fs.readFileSync)(staticPath, "utf-8");
+      staticTruth = JSON.parse(content);
+    } catch (error) {
+      if (options.failLoudly) {
+        throw new Error(`[llmweb] Static Truth Error: Failed to load/parse JSON at ${config.static}. ${error}`);
+      }
+      console.warn(`[llmweb] Warning: Could not load static JSON at ${config.static}. Proceeding with dynamic data only.`);
+    }
+  }
+  const dynamicTruth = {};
+  if (config.dynamic) {
+    const rawResults = await resolveAll(config.dynamic, { timeout: options.timeout });
+    for (const [key, source] of Object.entries(config.dynamic)) {
+      const rawData = rawResults[key];
+      if (rawData === null && options.failLoudly) {
+        throw new Error(`[llmweb] Dynamic Truth Error: Source "${key}" failed to resolve.`);
+      }
+      if (rawData && source.map) {
+        try {
+          dynamicTruth[key] = transform(rawData, source.map);
+        } catch (error) {
+          if (options.failLoudly) {
+            throw new Error(`[llmweb] Transformation Error: Failed to map source "${key}". ${error}`);
+          }
+          console.error(`[llmweb] Warning: Mapping failed for "${key}". Using raw data.`);
+          dynamicTruth[key] = rawData;
+        }
+      } else {
+        dynamicTruth[key] = rawData;
+      }
+    }
+  }
+  return merge(staticTruth, dynamicTruth);
+}
+
+// src/adapters/next.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+async function LLMJson({ config, className }) {
+  const truth = await createLLMSource(config);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("pre", { id: "llm-truth", className, children: JSON.stringify(truth, null, 2) });
+}
+function createLLMHandler(config) {
+  return async () => {
+    const truth = await createLLMSource(config);
+    return new Response(JSON.stringify(truth), {
+      status: 200,
+      headers: {
+        "Content-Type": "application/json"
+      }
+    });
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LLMJson,
+  createLLMHandler
+});

package/dist/adapters/next.mjs

@@ -0,0 +1,25 @@
+import {
+  createLLMSource
+} from "../chunk-PYG5H54N.mjs";
+
+// src/adapters/next.tsx
+import { jsx } from "react/jsx-runtime";
+async function LLMJson({ config, className }) {
+  const truth = await createLLMSource(config);
+  return /* @__PURE__ */ jsx("pre", { id: "llm-truth", className, children: JSON.stringify(truth, null, 2) });
+}
+function createLLMHandler(config) {
+  return async () => {
+    const truth = await createLLMSource(config);
+    return new Response(JSON.stringify(truth), {
+      status: 200,
+      headers: {
+        "Content-Type": "application/json"
+      }
+    });
+  };
+}
+export {
+  LLMJson,
+  createLLMHandler
+};

package/dist/chunk-PYG5H54N.mjs

@@ -0,0 +1,122 @@
+// src/core/resolver.ts
+async function resolveAll(dynamicSources, options = {}) {
+  const keys = Object.keys(dynamicSources);
+  const results = await Promise.allSettled(
+    keys.map((key) => resolveSource(dynamicSources[key], options.timeout))
+  );
+  const data = {};
+  results.forEach((result, index) => {
+    const key = keys[index];
+    if (result.status === "fulfilled") {
+      data[key] = result.value;
+    } else {
+      console.error(`[llmweb] Failed to resolve source "${key}":`, result.reason);
+      data[key] = null;
+    }
+  });
+  return data;
+}
+async function resolveSource(source, timeoutMs) {
+  const { from } = source;
+  const controller = timeoutMs ? new AbortController() : null;
+  const signal = controller?.signal;
+  const timeoutPromise = timeoutMs ? new Promise(
+    (_, reject) => setTimeout(() => {
+      controller?.abort();
+      reject(new Error(`Timeout of ${timeoutMs}ms exceeded`));
+    }, timeoutMs)
+  ) : null;
+  const resolvePromise = (async () => {
+    if (from.type === "fetch") {
+      if (!from.url) throw new Error("Fetch source requires a URL");
+      const response = await fetch(from.url, { signal });
+      if (!response.ok) throw new Error(`HTTP error ${response.status} for ${from.url}`);
+      return response.json();
+    }
+    if (from.type === "fn") {
+      if (!from.call) throw new Error('Function source requires a "call" property');
+      return from.call();
+    }
+    throw new Error(`Unsupported source type: ${from.type}`);
+  })();
+  if (timeoutPromise) {
+    return Promise.race([resolvePromise, timeoutPromise]);
+  }
+  return resolvePromise;
+}
+
+// src/core/transformer.ts
+function transform(sourceData, schema) {
+  if (!sourceData || typeof sourceData !== "object") return sourceData;
+  const result = {};
+  for (const [targetKey, mapping] of Object.entries(schema)) {
+    if (typeof mapping === "string") {
+      result[targetKey] = getValueByPath(sourceData, mapping);
+    } else if (typeof mapping === "function") {
+      result[targetKey] = mapping(sourceData);
+    } else if (typeof mapping === "object" && mapping !== null) {
+      result[targetKey] = transform(sourceData, mapping);
+    }
+  }
+  return result;
+}
+function getValueByPath(obj, path) {
+  return path.split(".").reduce((acc, part) => acc && acc[part], obj);
+}
+
+// src/core/merger.ts
+function merge(staticData, dynamicResults) {
+  if (!staticData) return dynamicResults;
+  return {
+    ...staticData,
+    ...dynamicResults
+  };
+}
+
+// src/index.ts
+import { readFileSync } from "fs";
+import { join } from "path";
+async function createLLMSource(config, options = {}) {
+  let staticTruth = {};
+  if (config.static) {
+    try {
+      const staticPath = config.static.startsWith("/") ? config.static : join(process.cwd(), config.static);
+      const content = readFileSync(staticPath, "utf-8");
+      staticTruth = JSON.parse(content);
+    } catch (error) {
+      if (options.failLoudly) {
+        throw new Error(`[llmweb] Static Truth Error: Failed to load/parse JSON at ${config.static}. ${error}`);
+      }
+      console.warn(`[llmweb] Warning: Could not load static JSON at ${config.static}. Proceeding with dynamic data only.`);
+    }
+  }
+  const dynamicTruth = {};
+  if (config.dynamic) {
+    const rawResults = await resolveAll(config.dynamic, { timeout: options.timeout });
+    for (const [key, source] of Object.entries(config.dynamic)) {
+      const rawData = rawResults[key];
+      if (rawData === null && options.failLoudly) {
+        throw new Error(`[llmweb] Dynamic Truth Error: Source "${key}" failed to resolve.`);
+      }
+      if (rawData && source.map) {
+        try {
+          dynamicTruth[key] = transform(rawData, source.map);
+        } catch (error) {
+          if (options.failLoudly) {
+            throw new Error(`[llmweb] Transformation Error: Failed to map source "${key}". ${error}`);
+          }
+          console.error(`[llmweb] Warning: Mapping failed for "${key}". Using raw data.`);
+          dynamicTruth[key] = rawData;
+        }
+      } else {
+        dynamicTruth[key] = rawData;
+      }
+    }
+  }
+  return merge(staticTruth, dynamicTruth);
+}
+
+export {
+  transform,
+  createLLMSource
+};

package/dist/core/merger.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Merges static truth with dynamic truth.
+ * Rules:
+ * - Static defines the base object.
+ * - Dynamic results overwrite or fill slots in the static base based on their keys.
+ */
+export declare function merge(staticData: any, dynamicResults: any): any;

package/dist/core/resolver.d.ts

@@ -0,0 +1,12 @@
+import { DynamicSource } from '../types';
+export interface ResolvedData {
+    [key: string]: any;
+}
+/**
+ * Resolves all dynamic sources in parallel.
+ */
+export declare function resolveAll(dynamicSources: {
+    [key: string]: DynamicSource;
+}, options?: {
+    timeout?: number;
+}): Promise<ResolvedData>;

package/dist/core/transformer.d.ts

@@ -0,0 +1,7 @@
+import { MapSchema } from '../types';
+/**
+ * Transforms source data according to a MapSchema.
+ * The schema keys represent the target structure, and the values
+ * represent the source keys or transformation functions.
+ */
+export declare function transform(sourceData: any, schema: MapSchema): any;

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { LLMConfig, TransformerOptions } from './types';
+/**
+ * The main "Compiler" for LLM truth.
+ */
+export declare function createLLMSource(config: LLMConfig, options?: TransformerOptions): Promise<any>;
+export * from './types';
+export { transform } from './core/transformer';

package/dist/index.js

@@ -0,0 +1,149 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createLLMSource: () => createLLMSource,
+  transform: () => transform
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/core/resolver.ts
+async function resolveAll(dynamicSources, options = {}) {
+  const keys = Object.keys(dynamicSources);
+  const results = await Promise.allSettled(
+    keys.map((key) => resolveSource(dynamicSources[key], options.timeout))
+  );
+  const data = {};
+  results.forEach((result, index) => {
+    const key = keys[index];
+    if (result.status === "fulfilled") {
+      data[key] = result.value;
+    } else {
+      console.error(`[llmweb] Failed to resolve source "${key}":`, result.reason);
+      data[key] = null;
+    }
+  });
+  return data;
+}
+async function resolveSource(source, timeoutMs) {
+  const { from } = source;
+  const controller = timeoutMs ? new AbortController() : null;
+  const signal = controller?.signal;
+  const timeoutPromise = timeoutMs ? new Promise(
+    (_, reject) => setTimeout(() => {
+      controller?.abort();
+      reject(new Error(`Timeout of ${timeoutMs}ms exceeded`));
+    }, timeoutMs)
+  ) : null;
+  const resolvePromise = (async () => {
+    if (from.type === "fetch") {
+      if (!from.url) throw new Error("Fetch source requires a URL");
+      const response = await fetch(from.url, { signal });
+      if (!response.ok) throw new Error(`HTTP error ${response.status} for ${from.url}`);
+      return response.json();
+    }
+    if (from.type === "fn") {
+      if (!from.call) throw new Error('Function source requires a "call" property');
+      return from.call();
+    }
+    throw new Error(`Unsupported source type: ${from.type}`);
+  })();
+  if (timeoutPromise) {
+    return Promise.race([resolvePromise, timeoutPromise]);
+  }
+  return resolvePromise;
+}
+
+// src/core/transformer.ts
+function transform(sourceData, schema) {
+  if (!sourceData || typeof sourceData !== "object") return sourceData;
+  const result = {};
+  for (const [targetKey, mapping] of Object.entries(schema)) {
+    if (typeof mapping === "string") {
+      result[targetKey] = getValueByPath(sourceData, mapping);
+    } else if (typeof mapping === "function") {
+      result[targetKey] = mapping(sourceData);
+    } else if (typeof mapping === "object" && mapping !== null) {
+      result[targetKey] = transform(sourceData, mapping);
+    }
+  }
+  return result;
+}
+function getValueByPath(obj, path) {
+  return path.split(".").reduce((acc, part) => acc && acc[part], obj);
+}
+
+// src/core/merger.ts
+function merge(staticData, dynamicResults) {
+  if (!staticData) return dynamicResults;
+  return {
+    ...staticData,
+    ...dynamicResults
+  };
+}
+
+// src/index.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+async function createLLMSource(config, options = {}) {
+  let staticTruth = {};
+  if (config.static) {
+    try {
+      const staticPath = config.static.startsWith("/") ? config.static : (0, import_node_path.join)(process.cwd(), config.static);
+      const content = (0, import_node_fs.readFileSync)(staticPath, "utf-8");
+      staticTruth = JSON.parse(content);
+    } catch (error) {
+      if (options.failLoudly) {
+        throw new Error(`[llmweb] Static Truth Error: Failed to load/parse JSON at ${config.static}. ${error}`);
+      }
+      console.warn(`[llmweb] Warning: Could not load static JSON at ${config.static}. Proceeding with dynamic data only.`);
+    }
+  }
+  const dynamicTruth = {};
+  if (config.dynamic) {
+    const rawResults = await resolveAll(config.dynamic, { timeout: options.timeout });
+    for (const [key, source] of Object.entries(config.dynamic)) {
+      const rawData = rawResults[key];
+      if (rawData === null && options.failLoudly) {
+        throw new Error(`[llmweb] Dynamic Truth Error: Source "${key}" failed to resolve.`);
+      }
+      if (rawData && source.map) {
+        try {
+          dynamicTruth[key] = transform(rawData, source.map);
+        } catch (error) {
+          if (options.failLoudly) {
+            throw new Error(`[llmweb] Transformation Error: Failed to map source "${key}". ${error}`);
+          }
+          console.error(`[llmweb] Warning: Mapping failed for "${key}". Using raw data.`);
+          dynamicTruth[key] = rawData;
+        }
+      } else {
+        dynamicTruth[key] = rawData;
+      }
+    }
+  }
+  return merge(staticTruth, dynamicTruth);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createLLMSource,
+  transform
+});

package/dist/index.mjs

@@ -0,0 +1,8 @@
+import {
+  createLLMSource,
+  transform
+} from "./chunk-PYG5H54N.mjs";
+export {
+  createLLMSource,
+  transform
+};

package/dist/types/index.d.ts

@@ -0,0 +1,23 @@
+export type SourceType = 'fetch' | 'fn';
+export interface SourceDefinition {
+    type: SourceType;
+    url?: string;
+    call?: (...args: any[]) => Promise<any> | any;
+}
+export interface MapSchema {
+    [targetKey: string]: string | ((sourceData: any) => any) | MapSchema;
+}
+export interface DynamicSource {
+    from: SourceDefinition;
+    map?: MapSchema;
+}
+export interface LLMConfig {
+    static?: string;
+    dynamic?: {
+        [key: string]: DynamicSource;
+    };
+}
+export interface TransformerOptions {
+    failLoudly?: boolean;
+    timeout?: number;
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@kaleabdenbel/llmweb",
+  "version": "1.0.0",
+  "description": "A compiler for LLM-readable truth from static and dynamic sources.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./adapters/next": {
+      "import": "./dist/adapters/next.mjs",
+      "require": "./dist/adapters/next.js",
+      "types": "./dist/adapters/next.d.ts"
+    },
+    "./adapters/express": {
+      "import": "./dist/adapters/express.mjs",
+      "require": "./dist/adapters/express.js",
+      "types": "./dist/adapters/express.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/adapters/next.tsx src/adapters/express.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts src/adapters/next.tsx src/adapters/express.ts --format cjs,esm --watch --dts",
+    "lint": "tsc",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "llm",
+    "json",
+    "nextjs",
+    "api",
+    "metadata"
+  ],
+  "author": "Kaleab Denbel",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "tsup": "^8.0.0",
+    "vitest": "^1.0.0",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
+    "react": "^18.0.0",
+    "next": "^14.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "next": ">=13"
+  }
+}