@kaleabdenbel/llmweb 1.0.1 → 1.0.3

package/dist/index.browser.mjs

@@ -0,0 +1,145 @@
+// 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) return sourceData;
+  if (Array.isArray(sourceData)) {
+    return sourceData.map((item) => transform(item, schema));
+  }
+  if (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/core/compiler.ts
+async function compileLLM(config, loader, options = {}) {
+  let staticTruth = {};
+  if (config.static) {
+    try {
+      const content = await loader(config.static);
+      if (content) {
+        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/core/injector.ts
+function toScriptString(data) {
+  const json = JSON.stringify(data);
+  return `<script type="application/llm+json">${json}</script>`;
+}
+function toWindowString(data, key = "__LLM__") {
+  const json = JSON.stringify(data);
+  return `window.${key} = ${json};`;
+}
+
+// src/index.browser.ts
+var browserLoader = async (path) => {
+  console.warn(`[llmweb] Static files cannot be loaded in the browser: ${path}. Please use dynamic sources or pass data directly.`);
+  return null;
+};
+async function createLLMSource(config, options = {}) {
+  return compileLLM(config, browserLoader, options);
+}
+export {
+  createLLMSource,
+  toScriptString,
+  toWindowString,
+  transform
+};

package/dist/index.js

@@ -21,6 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   createLLMSource: () => createLLMSource,
+  toScriptString: () => toScriptString,
+  toWindowString: () => toWindowString,
   transform: () => transform
 });
 module.exports = __toCommonJS(index_exports);
@@ -74,7 +76,11 @@ async function resolveSource(source, timeoutMs) {
 
 // src/core/transformer.ts
 function transform(sourceData, schema) {
-  if (!sourceData || typeof sourceData !== "object") return sourceData;
+  if (!sourceData) return sourceData;
+  if (Array.isArray(sourceData)) {
+    return sourceData.map((item) => transform(item, schema));
+  }
+  if (typeof sourceData !== "object") return sourceData;
   const result = {};
   for (const [targetKey, mapping] of Object.entries(schema)) {
     if (typeof mapping === "string") {
@@ -100,16 +106,15 @@ function merge(staticData, dynamicResults) {
   };
 }
 
-// src/index.ts
-var import_node_fs = require("fs");
-var import_node_path = require("path");
-async function createLLMSource(config, options = {}) {
+// src/core/compiler.ts
+async function compileLLM(config, loader, 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);
+      const content = await loader(config.static);
+      if (content) {
+        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}`);
@@ -142,8 +147,33 @@ async function createLLMSource(config, options = {}) {
   }
   return merge(staticTruth, dynamicTruth);
 }
+
+// src/index.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+
+// src/core/injector.ts
+function toScriptString(data) {
+  const json = JSON.stringify(data);
+  return `<script type="application/llm+json">${json}</script>`;
+}
+function toWindowString(data, key = "__LLM__") {
+  const json = JSON.stringify(data);
+  return `window.${key} = ${json};`;
+}
+
+// src/index.ts
+var nodeLoader = async (path) => {
+  const fullPath = path.startsWith("/") ? path : (0, import_node_path.join)(process.cwd(), path);
+  return (0, import_node_fs.readFileSync)(fullPath, "utf-8");
+};
+async function createLLMSource(config, options = {}) {
+  return compileLLM(config, nodeLoader, options);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createLLMSource,
+  toScriptString,
+  toWindowString,
   transform
 });

package/dist/index.mjs

@@ -1,8 +1,149 @@
-import {
-  createLLMSource,
-  transform
-} from "./chunk-PYG5H54N.mjs";
+// 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) return sourceData;
+  if (Array.isArray(sourceData)) {
+    return sourceData.map((item) => transform(item, schema));
+  }
+  if (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/core/compiler.ts
+async function compileLLM(config, loader, options = {}) {
+  let staticTruth = {};
+  if (config.static) {
+    try {
+      const content = await loader(config.static);
+      if (content) {
+        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/index.ts
+import { readFileSync } from "fs";
+import { join } from "path";
+
+// src/core/injector.ts
+function toScriptString(data) {
+  const json = JSON.stringify(data);
+  return `<script type="application/llm+json">${json}</script>`;
+}
+function toWindowString(data, key = "__LLM__") {
+  const json = JSON.stringify(data);
+  return `window.${key} = ${json};`;
+}
+
+// src/index.ts
+var nodeLoader = async (path) => {
+  const fullPath = path.startsWith("/") ? path : join(process.cwd(), path);
+  return readFileSync(fullPath, "utf-8");
+};
+async function createLLMSource(config, options = {}) {
+  return compileLLM(config, nodeLoader, options);
+}
 export {
   createLLMSource,
+  toScriptString,
+  toWindowString,
   transform
 };

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "@kaleabdenbel/llmweb",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "A compiler for LLM-readable truth from static and dynamic sources.",
   "publishConfig": {
     "access": "public"
   },
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
+  "browser": "./dist/index.browser.mjs",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "browser": "./dist/index.browser.mjs",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js",
       "types": "./dist/index.d.ts"
@@ -19,6 +21,16 @@
       "require": "./dist/adapters/next.js",
       "types": "./dist/adapters/next.d.ts"
     },
+    "./adapters/react": {
+      "import": "./dist/adapters/react.mjs",
+      "require": "./dist/adapters/react.js",
+      "types": "./dist/adapters/react.d.ts"
+    },
+    "./adapters/vanilla": {
+      "import": "./dist/adapters/vanilla.mjs",
+      "require": "./dist/adapters/vanilla.js",
+      "types": "./dist/adapters/vanilla.d.ts"
+    },
     "./adapters/express": {
       "import": "./dist/adapters/express.mjs",
       "require": "./dist/adapters/express.js",
@@ -31,8 +43,8 @@
     "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",
+    "build": "tsup src/index.ts src/index.browser.ts src/adapters/next.tsx src/adapters/react.tsx src/adapters/vanilla.ts src/adapters/express.ts --format cjs,esm --dts --clean --no-splitting",
+    "dev": "tsup src/index.ts src/index.browser.ts src/adapters/next.tsx src/adapters/react.tsx src/adapters/vanilla.ts src/adapters/express.ts --format cjs,esm --watch --dts --no-splitting",
     "lint": "tsc",
     "test": "vitest run"
   },

package/dist/adapters/express.d.ts

@@ -1,5 +0,0 @@
-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/next.d.ts

@@ -1,18 +0,0 @@
-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/core/merger.d.ts

@@ -1,7 +0,0 @@
-/**
- * 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

@@ -1,12 +0,0 @@
-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

@@ -1,7 +0,0 @@
-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

@@ -1,7 +0,0 @@
-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/types/index.d.ts

@@ -1,23 +0,0 @@
-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;
-}