te.js 2.0.3 → 2.1.1

package/utils/auto-register.js

@@ -1,17 +1,17 @@
-import fs from 'node:fs/promises';
-import path from 'path';
-
-const findTargetFiles = async () => {
-  if (!process.env.DIR_TARGETS) return;
-  const fullPath = path.join(process.cwd(), process.env.DIR_TARGETS);
-  const directory = await fs.readdir(fullPath, {
-    withFileTypes: true,
-    recursive: true,
-  });
-
-  return directory.filter(
-    (file) => file.isFile() && file.name.endsWith('target.js'),
-  );
-};
-
-export { findTargetFiles };
+import fs from 'node:fs/promises';
+import path from 'path';
+
+const findTargetFiles = async () => {
+  if (!process.env.DIR_TARGETS) return;
+  const fullPath = path.join(process.cwd(), process.env.DIR_TARGETS);
+  const directory = await fs.readdir(fullPath, {
+    withFileTypes: true,
+    recursive: true,
+  });
+
+  return directory.filter(
+    (file) => file.isFile() && file.name.endsWith('target.js'),
+  );
+};
+
+export { findTargetFiles };

package/utils/configuration.js

@@ -1,64 +1,64 @@
-import * as fs from 'fs';
-import { getAllEnv } from 'tej-env';
-
-const loadConfigFile = () => {
-  try {
-    const data = fs.readFileSync('tejas.config.json', 'utf8');
-    return JSON.parse(data);
-  } catch (err) {
-    return {};
-  }
-};
-
-const keysToUpperCase = (obj) => {
-  if (!obj) return {};
-  const standardObj = {};
-
-  for (const key in obj) {
-    if (obj.hasOwnProperty(key)) {
-      const value = obj[key];
-      const upperKey = key.toUpperCase();
-
-      if (typeof value === 'object' && value !== null) {
-        standardObj[upperKey] = keysToUpperCase(value);
-      } else {
-        standardObj[upperKey] = value;
-      }
-    }
-  }
-
-  return standardObj;
-};
-
-const flattenObject = (obj, prefix = '') => {
-  let flattened = {};
-
-  for (const key in obj) {
-    if (obj.hasOwnProperty(key)) {
-      const value = obj[key];
-      const newKey = prefix ? `${prefix}_${key}` : key;
-
-      if (
-        typeof value === 'object' &&
-        value !== null &&
-        !Array.isArray(value) &&
-        Object.keys(value).length > 0
-      ) {
-        const nested = flattenObject(value, newKey);
-        Object.assign(flattened, nested);
-      } else {
-        flattened[newKey] = value;
-      }
-    }
-  }
-  return flattened;
-};
-
-const standardizeObj = (obj) => {
-  let standardObj = obj;
-  standardObj = keysToUpperCase(standardObj);
-  standardObj = flattenObject(standardObj);
-  return standardObj;
-};
-
-export { loadConfigFile, standardizeObj };
+import * as fs from 'fs';
+import { getAllEnv } from 'tej-env';
+
+const loadConfigFile = () => {
+  try {
+    const data = fs.readFileSync('tejas.config.json', 'utf8');
+    return JSON.parse(data);
+  } catch (err) {
+    return {};
+  }
+};
+
+const keysToUpperCase = (obj) => {
+  if (!obj) return {};
+  const standardObj = {};
+
+  for (const key in obj) {
+    if (obj.hasOwnProperty(key)) {
+      const value = obj[key];
+      const upperKey = key.toUpperCase();
+
+      if (typeof value === 'object' && value !== null) {
+        standardObj[upperKey] = keysToUpperCase(value);
+      } else {
+        standardObj[upperKey] = value;
+      }
+    }
+  }
+
+  return standardObj;
+};
+
+const flattenObject = (obj, prefix = '') => {
+  let flattened = {};
+
+  for (const key in obj) {
+    if (obj.hasOwnProperty(key)) {
+      const value = obj[key];
+      const newKey = prefix ? `${prefix}_${key}` : key;
+
+      if (
+        typeof value === 'object' &&
+        value !== null &&
+        !Array.isArray(value) &&
+        Object.keys(value).length > 0
+      ) {
+        const nested = flattenObject(value, newKey);
+        Object.assign(flattened, nested);
+      } else {
+        flattened[newKey] = value;
+      }
+    }
+  }
+  return flattened;
+};
+
+const standardizeObj = (obj) => {
+  let standardObj = obj;
+  standardObj = keysToUpperCase(standardObj);
+  standardObj = flattenObject(standardObj);
+  return standardObj;
+};
+
+export { loadConfigFile, standardizeObj };

package/utils/errors-llm-config.js

@@ -0,0 +1,84 @@
+/**
+ * Resolve and validate errors.llm configuration (LLM-inferred error codes/messages).
+ * Uses ERRORS_LLM_* env vars with fallback to LLM_*.
+ * Config file keys (e.g. errors.llm.baseURL) are standardized to ERRORS_LLM_BASEURL etc.
+ */
+
+import { env } from 'tej-env';
+
+const MESSAGE_TYPES = /** @type {const} */ (['endUser', 'developer']);
+
+/**
+ * Normalize messageType to 'endUser' | 'developer'.
+ * @param {string} v
+ * @returns {'endUser'|'developer'}
+ */
+function normalizeMessageType(v) {
+  const s = String(v ?? '').trim().toLowerCase();
+  if (s === 'developer' || s === 'dev') return 'developer';
+  return 'endUser'; // endUser, end_user, default
+}
+
+/**
+ * Resolve errors.llm config from env (feature-specific then LLM_ fallback).
+ * @returns {{ enabled: boolean, baseURL: string, apiKey: string, model: string, messageType: 'endUser'|'developer' }}
+ */
+export function getErrorsLlmConfig() {
+  const enabledRaw = env('ERRORS_LLM_ENABLED') ?? '';
+  const enabled =
+    enabledRaw === true ||
+    enabledRaw === 'true' ||
+    enabledRaw === '1' ||
+    enabledRaw === 1;
+
+  const baseURL =
+    env('ERRORS_LLM_BASE_URL') ??
+    env('ERRORS_LLM_BASEURL') ??
+    env('LLM_BASE_URL') ??
+    env('LLM_BASEURL') ??
+    '';
+
+  const apiKey =
+    env('ERRORS_LLM_API_KEY') ??
+    env('ERRORS_LLM_APIKEY') ??
+    env('LLM_API_KEY') ??
+    env('LLM_APIKEY') ??
+    '';
+
+  const model =
+    env('ERRORS_LLM_MODEL') ?? env('LLM_MODEL') ?? '';
+
+  const messageTypeRaw =
+    env('ERRORS_LLM_MESSAGE_TYPE') ?? env('ERRORS_LLM_MESSAGETYPE') ?? env('LLM_MESSAGE_TYPE') ?? env('LLM_MESSAGETYPE') ?? '';
+
+  return {
+    enabled: Boolean(enabled),
+    baseURL: String(baseURL ?? '').trim(),
+    apiKey: String(apiKey ?? '').trim(),
+    model: String(model ?? '').trim(),
+    messageType: normalizeMessageType(messageTypeRaw || 'endUser'),
+  };
+}
+
+export { MESSAGE_TYPES };
+
+/**
+ * Validate errors.llm when enabled: require baseURL, apiKey, and model (after LLM_ fallback).
+ * Call at takeoff. Throws if enabled but config is invalid; no-op otherwise.
+ * @throws {Error} If errors.llm.enabled is true but any of baseURL, apiKey, or model is missing
+ */
+export function validateErrorsLlmAtTakeoff() {
+  const { enabled, baseURL, apiKey, model } = getErrorsLlmConfig();
+  if (!enabled) return;
+
+  const missing = [];
+  if (!baseURL) missing.push('baseURL (ERRORS_LLM_BASE_URL or LLM_BASE_URL)');
+  if (!apiKey) missing.push('apiKey (ERRORS_LLM_API_KEY or LLM_API_KEY)');
+  if (!model) missing.push('model (ERRORS_LLM_MODEL or LLM_MODEL)');
+
+  if (missing.length > 0) {
+    throw new Error(
+      `errors.llm is enabled but required config is missing: ${missing.join(', ')}. Set these env vars or disable errors.llm.enabled.`,
+    );
+  }
+}

package/utils/request-logger.js

@@ -1,43 +1,43 @@
-import { env } from 'tej-env';
-import ansi from 'ansi-colors';
-import TejLogger from 'tej-logger';
-
-const logger = new TejLogger('Tejas.Request');
-const { italic, bold, blue, white, bgGreen, bgRed, whiteBright } = ansi;
-
-function logHttpRequest(ammo, next) {
-  if (!env('LOG_HTTP_REQUESTS')) return;
-
-  const startTime = new Date();
-  ammo.res.on('finish', () => {
-    const res = ammo.res;
-    const method = italic(whiteBright(ammo.method));
-    const endpoint = bold(ammo.endpoint);
-    const statusCode =
-      res.statusCode >= 400
-        ? bgRed(whiteBright(bold(`✖ ${res.statusCode}`)))
-        : bgGreen(whiteBright(bold(`✔ ${res.statusCode}`)));
-
-    const duration = white(`${new Date() - startTime}ms`);
-    const payload = `${blue('Request')}: ${white(
-      JSON.stringify(ammo.payload),
-    )}`;
-    const dispatchedData = `${blue('Response')}: ${white(ammo.dispatchedData)}`;
-    const nextLine = '\n';
-
-    logger.log(
-      italic(`Incoming request from ${ammo.ip}`),
-      nextLine,
-      method,
-      endpoint,
-      statusCode,
-      duration,
-      nextLine,
-      payload,
-      nextLine,
-      dispatchedData,
-    );
-  });
-}
-
-export default logHttpRequest;
+import { env } from 'tej-env';
+import ansi from 'ansi-colors';
+import TejLogger from 'tej-logger';
+
+const logger = new TejLogger('Tejas.Request');
+const { italic, bold, blue, white, bgGreen, bgRed, whiteBright } = ansi;
+
+function logHttpRequest(ammo, next) {
+  if (!env('LOG_HTTP_REQUESTS')) return;
+
+  const startTime = new Date();
+  ammo.res.on('finish', () => {
+    const res = ammo.res;
+    const method = italic(whiteBright(ammo.method));
+    const endpoint = bold(ammo.endpoint);
+    const statusCode =
+      res.statusCode >= 400
+        ? bgRed(whiteBright(bold(`✖ ${res.statusCode}`)))
+        : bgGreen(whiteBright(bold(`✔ ${res.statusCode}`)));
+
+    const duration = white(`${new Date() - startTime}ms`);
+    const payload = `${blue('Request')}: ${white(
+      JSON.stringify(ammo.payload),
+    )}`;
+    const dispatchedData = `${blue('Response')}: ${white(ammo.dispatchedData)}`;
+    const nextLine = '\n';
+
+    logger.log(
+      italic(`Incoming request from ${ammo.ip}`),
+      nextLine,
+      method,
+      endpoint,
+      statusCode,
+      duration,
+      nextLine,
+      payload,
+      nextLine,
+      dispatchedData,
+    );
+  });
+}
+
+export default logHttpRequest;

package/utils/status-codes.js

@@ -1,82 +1,82 @@
-const statuses = {
-  '100': 'Continue',
-  '101': 'Switching Protocols',
-  '102': 'Processing',
-  '103': 'Early Hints',
-  '200': 'OK',
-  '201': 'Created',
-  '202': 'Accepted',
-  '203': 'Non-Authoritative Information',
-  '204': 'No Content',
-  '205': 'Reset Content',
-  '206': 'Partial Content',
-  '207': 'Multi-Status',
-  '208': 'Already Reported',
-  '226': 'IM Used',
-  '300': 'Multiple Choices',
-  '301': 'Moved Permanently',
-  '302': 'Found',
-  '303': 'See Other',
-  '304': 'Not Modified',
-  '305': 'Use Proxy',
-  '307': 'Temporary Redirect',
-  '308': 'Permanent Redirect',
-  '400': 'Bad Request',
-  '401': 'Unauthorized',
-  '402': 'Payment Required',
-  '403': 'Forbidden',
-  '404': 'Not Found',
-  '405': 'Method Not Allowed',
-  '406': 'Not Acceptable',
-  '407': 'Proxy Authentication Required',
-  '408': 'Request Timeout',
-  '409': 'Conflict',
-  '410': 'Gone',
-  '411': 'Length Required',
-  '412': 'Precondition Failed',
-  '413': 'Payload Too Large',
-  '414': 'URI Too Long',
-  '415': 'Unsupported Media Type',
-  '416': 'Range Not Satisfiable',
-  '417': 'Expectation Failed',
-  '418': 'I\'m a Teapot',
-  '421': 'Misdirected Request',
-  '422': 'Unprocessable Entity',
-  '423': 'Locked',
-  '424': 'Failed Dependency',
-  '425': 'Too Early',
-  '426': 'Upgrade Required',
-  '428': 'Precondition Required',
-  '429': 'Too Many Requests',
-  '431': 'Request Header Fields Too Large',
-  '451': 'Unavailable For Legal Reasons',
-  '500': 'Internal Server Error',
-  '501': 'Not Implemented',
-  '502': 'Bad Gateway',
-  '503': 'Service Unavailable',
-  '504': 'Gateway Timeout',
-  '505': 'HTTP Version Not Supported',
-  '506': 'Variant Also Negotiates',
-  '507': 'Insufficient Storage',
-  '508': 'Loop Detected',
-  '509': 'Bandwidth Limit Exceeded',
-  '510': 'Not Extended',
-  '511': 'Network Authentication Required',
-};
-
-const reverseStatuses = Object.fromEntries(
-    Object.entries(statuses).map(([key, value]) => [value, key]));
-
-const toStatusCode = (message) => {
-  return reverseStatuses[message];
-};
-
-const toStatusMessage = (code) => {
-  return statuses[code];
-};
-
-const isStatusCode = (code) => {
-  return statuses[code] !== undefined;
-}
-
-export {toStatusCode, toStatusMessage, isStatusCode};
+const statuses = {
+  '100': 'Continue',
+  '101': 'Switching Protocols',
+  '102': 'Processing',
+  '103': 'Early Hints',
+  '200': 'OK',
+  '201': 'Created',
+  '202': 'Accepted',
+  '203': 'Non-Authoritative Information',
+  '204': 'No Content',
+  '205': 'Reset Content',
+  '206': 'Partial Content',
+  '207': 'Multi-Status',
+  '208': 'Already Reported',
+  '226': 'IM Used',
+  '300': 'Multiple Choices',
+  '301': 'Moved Permanently',
+  '302': 'Found',
+  '303': 'See Other',
+  '304': 'Not Modified',
+  '305': 'Use Proxy',
+  '307': 'Temporary Redirect',
+  '308': 'Permanent Redirect',
+  '400': 'Bad Request',
+  '401': 'Unauthorized',
+  '402': 'Payment Required',
+  '403': 'Forbidden',
+  '404': 'Not Found',
+  '405': 'Method Not Allowed',
+  '406': 'Not Acceptable',
+  '407': 'Proxy Authentication Required',
+  '408': 'Request Timeout',
+  '409': 'Conflict',
+  '410': 'Gone',
+  '411': 'Length Required',
+  '412': 'Precondition Failed',
+  '413': 'Payload Too Large',
+  '414': 'URI Too Long',
+  '415': 'Unsupported Media Type',
+  '416': 'Range Not Satisfiable',
+  '417': 'Expectation Failed',
+  '418': 'I\'m a Teapot',
+  '421': 'Misdirected Request',
+  '422': 'Unprocessable Entity',
+  '423': 'Locked',
+  '424': 'Failed Dependency',
+  '425': 'Too Early',
+  '426': 'Upgrade Required',
+  '428': 'Precondition Required',
+  '429': 'Too Many Requests',
+  '431': 'Request Header Fields Too Large',
+  '451': 'Unavailable For Legal Reasons',
+  '500': 'Internal Server Error',
+  '501': 'Not Implemented',
+  '502': 'Bad Gateway',
+  '503': 'Service Unavailable',
+  '504': 'Gateway Timeout',
+  '505': 'HTTP Version Not Supported',
+  '506': 'Variant Also Negotiates',
+  '507': 'Insufficient Storage',
+  '508': 'Loop Detected',
+  '509': 'Bandwidth Limit Exceeded',
+  '510': 'Not Extended',
+  '511': 'Network Authentication Required',
+};
+
+const reverseStatuses = Object.fromEntries(
+    Object.entries(statuses).map(([key, value]) => [value, key]));
+
+const toStatusCode = (message) => {
+  return reverseStatuses[message];
+};
+
+const toStatusMessage = (code) => {
+  return statuses[code];
+};
+
+const isStatusCode = (code) => {
+  return statuses[code] !== undefined;
+}
+
+export {toStatusCode, toStatusMessage, isStatusCode};

package/utils/tejas-entrypoint-html.js

@@ -1,18 +1,18 @@
-// TODO Create a better entrypoint html
-
-const html =
-  "" +
-  "<!DOCTYPE html>" +
-  '<html lang="en">' +
-  "<head>" +
-  '<meta charset="UTF-8">' +
-  '<meta http-equiv="X-UA-Compatible" content="IE=edge">' +
-  '<meta name="viewport" content="width=device-width, initial-scale=1.0">' +
-  "<title>te.js</title>" +
-  "</head>" +
-  "<body>" +
-  "<h1>Tejas is flying</h1>" +
-  "</body>" +
-  "</html>";
-
-export default html;
+// TODO Create a better entrypoint html
+
+const html =
+  "" +
+  "<!DOCTYPE html>" +
+  '<html lang="en">' +
+  "<head>" +
+  '<meta charset="UTF-8">' +
+  '<meta http-equiv="X-UA-Compatible" content="IE=edge">' +
+  '<meta name="viewport" content="width=device-width, initial-scale=1.0">' +
+  "<title>te.js</title>" +
+  "</head>" +
+  "<body>" +
+  "<h1>Tejas is flying</h1>" +
+  "</body>" +
+  "</html>";
+
+export default html;

package/auto-docs/llm/index.js

@@ -1,6 +0,0 @@
-/**
- * LLM provider for auto-documentation.
- * Single OpenAI-compatible setup: use createProvider(config) with baseURL, apiKey, model.
- */
-
-export { LLMProvider, createProvider, extractJSON, extractJSONArray } from './provider.js';

package/auto-docs/llm/parse.js

@@ -1,88 +0,0 @@
-/**
- * Parse JSON from LLM response text (handles markdown code blocks).
- */
-
-/**
- * Extract the first JSON object from a string.
- * @param {string} str - Raw LLM response
- * @returns {object|null}
- */
-export function extractJSON(str) {
-  if (!str || typeof str !== 'string') return null;
-  const trimmed = str.trim();
-  const open = trimmed.indexOf('{');
-  if (open === -1) return null;
-  let depth = 0;
-  let end = -1;
-  for (let i = open; i < trimmed.length; i++) {
-    if (trimmed[i] === '{') depth++;
-    else if (trimmed[i] === '}') {
-      depth--;
-      if (depth === 0) {
-        end = i + 1;
-        break;
-      }
-    }
-  }
-  if (end === -1) return null;
-  try {
-    return JSON.parse(trimmed.slice(open, end));
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Extract the first JSON array from a string.
- * @param {string} str - Raw LLM response
- * @returns {Array|null}
- */
-export function extractJSONArray(str) {
-  if (!str || typeof str !== 'string') return null;
-  const trimmed = str.trim();
-  const open = trimmed.indexOf('[');
-  if (open === -1) return null;
-  let depth = 0;
-  let end = -1;
-  for (let i = open; i < trimmed.length; i++) {
-    if (trimmed[i] === '[') depth++;
-    else if (trimmed[i] === ']') {
-      depth--;
-      if (depth === 0) {
-        end = i + 1;
-        break;
-      }
-    }
-  }
-  if (end === -1) return null;
-  try {
-    return JSON.parse(trimmed.slice(open, end));
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Reconcile LLM-ordered tag names with actual tag objects. Returns tags in desired order;
- * any tag not in orderedTagNames is appended at the end.
- * @param {string[]} orderedTagNames - Tag names in desired order (from LLM)
- * @param {Array<{ name: string, description?: string }>} tags - Current spec.tags
- * @returns {Array<{ name: string, description?: string }>} Tags reordered
- */
-export function reconcileOrderedTags(orderedTagNames, tags) {
-  if (!Array.isArray(tags) || !tags.length) return [];
-  if (!Array.isArray(orderedTagNames) || !orderedTagNames.length) return [...tags];
-  const byName = new Map(tags.map((t) => [t.name, t]));
-  const ordered = [];
-  for (const name of orderedTagNames) {
-    const tag = byName.get(name);
-    if (tag) {
-      ordered.push(tag);
-      byName.delete(name);
-    }
-  }
-  for (const [, tag] of byName) {
-    ordered.push(tag);
-  }
-  return ordered;
-}