@kaleabdenbel/llmweb 1.0.4 → 1.0.6

package/dist/index-C5RUlsf2.d.ts

@@ -0,0 +1,56 @@
+type SourceType = "fetch" | "fn";
+interface SourceDefinition {
+    type: SourceType;
+    url?: string;
+    call?: (...args: any[]) => Promise<any> | any;
+}
+interface MapSchema {
+    [targetKey: string]: string | ((sourceData: any) => any) | MapSchema;
+}
+interface DynamicSource {
+    from: SourceDefinition;
+    map?: MapSchema;
+}
+interface LLMConfig {
+    identity?: {
+        name: string;
+        description?: string;
+        brand?: string;
+        locale?: string;
+    };
+    navigation?: {
+        pages: Array<{
+            label: string;
+            path: string;
+        }>;
+    };
+    business?: {
+        address?: string;
+        email?: string;
+        twitter?: string;
+        linkedin?: string;
+    };
+    seo?: {
+        titlePattern?: string;
+        descriptionPattern?: string;
+        multilingual?: boolean;
+    };
+    contentTypes?: string[];
+    type?: string;
+    static?: string | Record<string, any>;
+    dynamic?: {
+        [key: string]: DynamicSource;
+    };
+}
+interface TransformerOptions {
+    failLoudly?: boolean;
+    timeout?: number;
+}
+interface LLMJsonProps {
+    config: LLMConfig;
+    mode?: "script" | "window" | "pre" | "ldjson";
+    targetKey?: string;
+    className?: string;
+}
+
+export type { DynamicSource as D, LLMConfig as L, MapSchema as M, SourceDefinition as S, TransformerOptions as T, LLMJsonProps as a, SourceType as b };

package/dist/index.browser.d.mts

@@ -0,0 +1,10 @@
+import { L as LLMConfig, T as TransformerOptions } from './index-C5RUlsf2.mjs';
+export { D as DynamicSource, a as LLMJsonProps, M as MapSchema, S as SourceDefinition, b as SourceType } from './index-C5RUlsf2.mjs';
+export { t as toLDJSONString, a as toScriptString, b as toWindowString, c as transform } from './injector-DD7MSHW4.mjs';
+
+/**
+ * The main "Compiler" for LLM truth (Browser version).
+ */
+declare function createLLMSource(config: LLMConfig, options?: TransformerOptions): Promise<any>;
+
+export { LLMConfig, TransformerOptions, createLLMSource };

package/dist/index.browser.d.ts

@@ -0,0 +1,10 @@
+import { L as LLMConfig, T as TransformerOptions } from './index-C5RUlsf2.js';
+export { D as DynamicSource, a as LLMJsonProps, M as MapSchema, S as SourceDefinition, b as SourceType } from './index-C5RUlsf2.js';
+export { t as toLDJSONString, a as toScriptString, b as toWindowString, c as transform } from './injector-Gh9wJgRZ.js';
+
+/**
+ * The main "Compiler" for LLM truth (Browser version).
+ */
+declare function createLLMSource(config: LLMConfig, options?: TransformerOptions): Promise<any>;
+
+export { LLMConfig, TransformerOptions, createLLMSource };

package/dist/index.browser.js

@@ -0,0 +1,185 @@
+"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.browser.ts
+var index_browser_exports = {};
+__export(index_browser_exports, {
+  createLLMSource: () => createLLMSource,
+  toLDJSONString: () => toLDJSONString,
+  toScriptString: () => toScriptString,
+  toWindowString: () => toWindowString,
+  transform: () => transform
+});
+module.exports = __toCommonJS(index_browser_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) 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 = {}) {
+  const { static: staticRef, dynamic, ...topLevelMetadata } = config;
+  let staticTruth = { ...topLevelMetadata };
+  if (staticRef) {
+    try {
+      if (typeof staticRef === "object") {
+        staticTruth = { ...staticTruth, ...staticRef };
+      } else {
+        const content = await loader(staticRef);
+        if (content) {
+          staticTruth = { ...staticTruth, ...JSON.parse(content) };
+        }
+      }
+    } catch (error) {
+      if (options.failLoudly) {
+        throw new Error(`[llmweb] Static Truth Error: Failed to load/parse JSON at ${staticRef}. ${error}`);
+      }
+      console.warn(`[llmweb] Warning: Could not load static JSON at ${staticRef}. 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};`;
+}
+function toLDJSONString(data) {
+  return JSON.stringify(data);
+}
+
+// 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);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createLLMSource,
+  toLDJSONString,
+  toScriptString,
+  toWindowString,
+  transform
+});

package/dist/index.browser.mjs

@@ -0,0 +1,154 @@
+// 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 = {}) {
+  const { static: staticRef, dynamic, ...topLevelMetadata } = config;
+  let staticTruth = { ...topLevelMetadata };
+  if (staticRef) {
+    try {
+      if (typeof staticRef === "object") {
+        staticTruth = { ...staticTruth, ...staticRef };
+      } else {
+        const content = await loader(staticRef);
+        if (content) {
+          staticTruth = { ...staticTruth, ...JSON.parse(content) };
+        }
+      }
+    } catch (error) {
+      if (options.failLoudly) {
+        throw new Error(`[llmweb] Static Truth Error: Failed to load/parse JSON at ${staticRef}. ${error}`);
+      }
+      console.warn(`[llmweb] Warning: Could not load static JSON at ${staticRef}. 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};`;
+}
+function toLDJSONString(data) {
+  return JSON.stringify(data);
+}
+
+// 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,
+  toLDJSONString,
+  toScriptString,
+  toWindowString,
+  transform
+};

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+import { L as LLMConfig, T as TransformerOptions } from './index-C5RUlsf2.mjs';
+export { D as DynamicSource, a as LLMJsonProps, M as MapSchema, S as SourceDefinition, b as SourceType } from './index-C5RUlsf2.mjs';
+export { t as toLDJSONString, a as toScriptString, b as toWindowString, c as transform } from './injector-DD7MSHW4.mjs';
+
+/**
+ * The main "Compiler" for LLM truth (Node.js version).
+ * Uses dynamic imports for fs/path to be browser-bundler friendly.
+ */
+declare function createLLMSource(config: LLMConfig, options?: TransformerOptions): Promise<any>;
+
+export { LLMConfig, TransformerOptions, createLLMSource };

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { L as LLMConfig, T as TransformerOptions } from './index-C5RUlsf2.js';
+export { D as DynamicSource, a as LLMJsonProps, M as MapSchema, S as SourceDefinition, b as SourceType } from './index-C5RUlsf2.js';
+export { t as toLDJSONString, a as toScriptString, b as toWindowString, c as transform } from './injector-Gh9wJgRZ.js';
+
+/**
+ * The main "Compiler" for LLM truth (Node.js version).
+ * Uses dynamic imports for fs/path to be browser-bundler friendly.
+ */
+declare function createLLMSource(config: LLMConfig, options?: TransformerOptions): Promise<any>;
+
+export { LLMConfig, TransformerOptions, createLLMSource };

package/dist/index.js

@@ -0,0 +1,208 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createLLMSource: () => createLLMSource,
+  toLDJSONString: () => toLDJSONString,
+  toScriptString: () => toScriptString,
+  toWindowString: () => toWindowString,
+  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) 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 = {}) {
+  const { static: staticRef, dynamic, ...topLevelMetadata } = config;
+  let staticTruth = { ...topLevelMetadata };
+  if (staticRef) {
+    try {
+      if (typeof staticRef === "object") {
+        staticTruth = { ...staticTruth, ...staticRef };
+      } else {
+        const content = await loader(staticRef);
+        if (content) {
+          staticTruth = { ...staticTruth, ...JSON.parse(content) };
+        }
+      }
+    } catch (error) {
+      if (options.failLoudly) {
+        throw new Error(`[llmweb] Static Truth Error: Failed to load/parse JSON at ${staticRef}. ${error}`);
+      }
+      console.warn(`[llmweb] Warning: Could not load static JSON at ${staticRef}. 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};`;
+}
+function toLDJSONString(data) {
+  return JSON.stringify(data);
+}
+
+// src/index.ts
+async function createLLMSource(config, options = {}) {
+  const nodeLoader = async (path) => {
+    try {
+      const fs = await import(
+        /* webpackIgnore: true */
+        "fs"
+      );
+      const nodePath = await import(
+        /* webpackIgnore: true */
+        "path"
+      );
+      const fullPath = path.startsWith("/") ? path : nodePath.join(process.cwd(), path);
+      return fs.readFileSync(fullPath, "utf-8");
+    } catch (error) {
+      console.warn(`[llmweb] Warning: 'node:fs' not available. Skipping static file load: ${path}`);
+      return null;
+    }
+  };
+  return compileLLM(config, nodeLoader, options);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createLLMSource,
+  toLDJSONString,
+  toScriptString,
+  toWindowString,
+  transform
+});