te.js 2.1.0 → 2.1.1

package/server/endpoint.js

@@ -1,74 +1,97 @@
-import isMiddlewareValid from './targets/middleware-validator.js';
-import { isPathValid, standardizePath } from './targets/path-validator.js';
-import isShootValid from './targets/shoot-validator.js';
-
-class Endpoint {
-  constructor() {
-    this.path = '';
-    this.middlewares = [];
-    this.handler = null;
-    this.metadata = null;
-    /** Source group (e.g. target file id) for grouping in docs. Set by loader before register(). */
-    this.group = null;
-  }
-
-  setPath(base, path) {
-    const standardizedBase = standardizePath(base);
-    const standardizedPath = standardizePath(path);
-
-    let fullPath = `${standardizedBase}${standardizedPath}`;
-    if (fullPath.length === 0) fullPath = '/';
-
-    if (!isPathValid(fullPath)) return this;
-
-    this.path = fullPath;
-    return this;
-  }
-
-  setMiddlewares(middlewares) {
-    const validMiddlewares = middlewares.filter(isMiddlewareValid);
-    if (validMiddlewares.length === 0) return this;
-
-    this.middlewares = this.middlewares.concat(validMiddlewares);
-    return this;
-  }
-
-  setHandler(handler) {
-    if (!isShootValid(handler)) return this;
-    this.handler = handler;
-
-    return this;
-  }
-
-  setMetadata(metadata) {
-    this.metadata = metadata ?? null;
-    return this;
-  }
-
-  setGroup(group) {
-    this.group = group ?? null;
-    return this;
-  }
-
-  getPath() {
-    return this.path;
-  }
-
-  getMiddlewares() {
-    return this.middlewares;
-  }
-
-  getHandler() {
-    return this.handler;
-  }
-
-  getMetadata() {
-    return this.metadata;
-  }
-
-  getGroup() {
-    return this.group;
-  }
-}
-
-export default Endpoint;
+import isMiddlewareValid from './targets/middleware-validator.js';
+import { isPathValid, standardizePath } from './targets/path-validator.js';
+import isShootValid from './targets/shoot-validator.js';
+
+class Endpoint {
+  constructor() {
+    this.path = '';
+    this.middlewares = [];
+    this.handler = null;
+    this.metadata = null;
+    /** Allowed HTTP methods (e.g. ['GET', 'POST']). null = method-agnostic. */
+    this.methods = null;
+    /** Source group (e.g. target file id) for grouping in docs. Set by loader before register(). */
+    this.group = null;
+  }
+
+  setPath(base, path) {
+    const standardizedBase = standardizePath(base);
+    const standardizedPath = standardizePath(path);
+
+    let fullPath = `${standardizedBase}${standardizedPath}`;
+    if (fullPath.length === 0) fullPath = '/';
+
+    if (!isPathValid(fullPath)) return this;
+
+    this.path = fullPath;
+    return this;
+  }
+
+  setMiddlewares(middlewares) {
+    const validMiddlewares = middlewares.filter(isMiddlewareValid);
+    if (validMiddlewares.length === 0) return this;
+
+    this.middlewares = this.middlewares.concat(validMiddlewares);
+    return this;
+  }
+
+  setHandler(handler) {
+    if (!isShootValid(handler)) return this;
+    this.handler = handler;
+
+    return this;
+  }
+
+  setMetadata(metadata) {
+    this.metadata = metadata ?? null;
+    return this;
+  }
+
+  /**
+   * @param {string[]|null} methods - Allowed HTTP methods (e.g. ['GET', 'POST']). null = method-agnostic.
+   */
+  setMethods(methods) {
+    if (methods == null) {
+      this.methods = null;
+      return this;
+    }
+    const arr = Array.isArray(methods) ? methods : [methods];
+    let normalized = arr.map((m) => String(m).toUpperCase()).filter(Boolean);
+    if (normalized.includes('GET') && !normalized.includes('HEAD')) {
+      normalized = [...normalized, 'HEAD'];
+    }
+    this.methods = normalized.length > 0 ? normalized : null;
+    return this;
+  }
+
+  setGroup(group) {
+    this.group = group ?? null;
+    return this;
+  }
+
+  getPath() {
+    return this.path;
+  }
+
+  getMiddlewares() {
+    return this.middlewares;
+  }
+
+  getHandler() {
+    return this.handler;
+  }
+
+  getMetadata() {
+    return this.metadata;
+  }
+
+  getMethods() {
+    return this.methods;
+  }
+
+  getGroup() {
+    return this.group;
+  }
+}
+
+export default Endpoint;

package/server/error.js

@@ -1,9 +1,9 @@
-class TejError extends Error {
-  constructor(code, message) {
-    super(message);
-    this.name = this.constructor.name;
-    this.code = code;
-  }
-}
-
-export default TejError;
+class TejError extends Error {
+  constructor(code, message) {
+    super(message);
+    this.name = this.constructor.name;
+    this.code = code;
+  }
+}
+
+export default TejError;

package/server/errors/code-context.js

@@ -1,125 +1,125 @@
-/**
- * Capture code context from the call stack: surrounding source with line numbers,
- * including upstream callers and downstream code. Used by LLM error inference.
- */
-
-import { readFile } from 'node:fs/promises';
-import { fileURLToPath } from 'node:url';
-import path from 'node:path';
-
-/** Path segments that identify te.js internals (excluded from "user" stack frames). */
-const INTERNAL_PATTERNS = [
-  'server/ammo.js',
-  'server/handler.js',
-  'server/errors/llm-error-service.js',
-  'server/errors/code-context.js',
-  'node_modules',
-];
-
-const LINES_ABOVE = 25;
-const LINES_BELOW = 25;
-const MAX_FRAMES = 6;
-
-/**
- * Parse a single stack frame line to extract file path, line, and column.
- * Handles "at fn (file:///path:line:col)" and "at file:///path:line:col" and "at /path:line:col".
- * @param {string} line
- * @returns {{ filePath: string, line: number, column: number } | null}
- */
-function parseStackFrame(line) {
-  const trimmed = line.trim();
-  if (!trimmed.startsWith('at ')) return null;
-  // Last occurrence of :number:number is line:column (path may contain colons on Windows/file URL)
-  const match = trimmed.match(/:(\d+):(\d+)\s*\)?\s*$/);
-  if (!match) return null;
-  const lineNum = parseInt(match[1], 10);
-  const colNum = parseInt(match[2], 10);
-  const before = trimmed.slice(0, trimmed.lastIndexOf(':' + match[1] + ':' + match[2]));
-  // Strip "at ... (" or "at " prefix to get path
-  let filePath = before.replace(/^\s*at\s+(?:.*?\s+\()?/, '').replace(/\)?\s*$/, '').trim();
-  if (filePath.startsWith('file://')) {
-    try {
-      filePath = fileURLToPath(filePath);
-    } catch {
-      return null;
-    }
-  }
-  if (!filePath || lineNum <= 0) return null;
-  return { filePath, line: lineNum, column: colNum };
-}
-
-/**
- * Return true if this file path is internal (te.js / node_modules) and should be skipped for user context.
- * @param {string} filePath - Absolute or relative path
- */
-function isInternalFrame(filePath) {
-  const normalized = path.normalize(filePath).replace(/\\/g, '/');
-  return INTERNAL_PATTERNS.some((p) => normalized.includes(p));
-}
-
-/**
- * Read source file and return lines [lineNum - LINES_ABOVE, lineNum + LINES_BELOW] with line numbers.
- * @param {string} filePath - Absolute path
- * @param {number} lineNum - Center line (1-based)
- * @returns {Promise<{ file: string, line: number, snippet: string } | null>}
- */
-async function readSnippet(filePath, lineNum) {
-  let content;
-  try {
-    content = await readFile(filePath, 'utf-8');
-  } catch {
-    return null;
-  }
-  const lines = content.split(/\r?\n/);
-  const start = Math.max(0, lineNum - 1 - LINES_ABOVE);
-  const end = Math.min(lines.length, lineNum + LINES_BELOW);
-  const snippet = lines
-    .slice(start, end)
-    .map((text, i) => {
-      const num = start + i + 1;
-      const marker = num === lineNum ? ' →' : '  ';
-      return `${String(num).padStart(4)}${marker} ${text}`;
-    })
-    .join('\n');
-
-  return {
-    file: filePath,
-    line: lineNum,
-    snippet,
-  };
-}
-
-/**
- * Capture code context from the current call stack: parse stack, filter to user frames,
- * and read surrounding source (with line numbers) for each frame. First frame is the
- * throw site; remaining frames are upstream callers. Each snippet includes lines
- * above and below (downstream in the same function).
- *
- * @param {string} [stack] - Stack string (e.g. new Error().stack). If omitted, captures current stack.
- * @param {{ maxFrames?: number, linesAround?: number }} [options]
- * @returns {Promise<{ snippets: Array<{ file: string, line: number, snippet: string }> }>}
- */
-export async function captureCodeContext(stack, options = {}) {
-  const stackStr = typeof stack === 'string' && stack ? stack : new Error().stack;
-  if (!stackStr) return { snippets: [] };
-
-  const maxFrames = options.maxFrames ?? MAX_FRAMES;
-  const lines = stackStr.split('\n');
-  const frames = [];
-
-  for (const line of lines) {
-    const parsed = parseStackFrame(line);
-    if (!parsed) continue;
-    if (isInternalFrame(parsed.filePath)) continue;
-    frames.push(parsed);
-    if (frames.length >= maxFrames) break;
-  }
-
-  const snippets = [];
-  for (const { filePath, line } of frames) {
-    const one = await readSnippet(filePath, line);
-    if (one) snippets.push(one);
-  }
-
-  return { snippets };
-}
+/**
+ * Capture code context from the call stack: surrounding source with line numbers,
+ * including upstream callers and downstream code. Used by LLM error inference.
+ */
+
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+
+/** Path segments that identify te.js internals (excluded from "user" stack frames). */
+const INTERNAL_PATTERNS = [
+  'server/ammo.js',
+  'server/handler.js',
+  'server/errors/llm-error-service.js',
+  'server/errors/code-context.js',
+  'node_modules',
+];
+
+const LINES_ABOVE = 25;
+const LINES_BELOW = 25;
+const MAX_FRAMES = 6;
+
+/**
+ * Parse a single stack frame line to extract file path, line, and column.
+ * Handles "at fn (file:///path:line:col)" and "at file:///path:line:col" and "at /path:line:col".
+ * @param {string} line
+ * @returns {{ filePath: string, line: number, column: number } | null}
+ */
+function parseStackFrame(line) {
+  const trimmed = line.trim();
+  if (!trimmed.startsWith('at ')) return null;
+  // Last occurrence of :number:number is line:column (path may contain colons on Windows/file URL)
+  const match = trimmed.match(/:(\d+):(\d+)\s*\)?\s*$/);
+  if (!match) return null;
+  const lineNum = parseInt(match[1], 10);
+  const colNum = parseInt(match[2], 10);
+  const before = trimmed.slice(0, trimmed.lastIndexOf(':' + match[1] + ':' + match[2]));
+  // Strip "at ... (" or "at " prefix to get path
+  let filePath = before.replace(/^\s*at\s+(?:.*?\s+\()?/, '').replace(/\)?\s*$/, '').trim();
+  if (filePath.startsWith('file://')) {
+    try {
+      filePath = fileURLToPath(filePath);
+    } catch {
+      return null;
+    }
+  }
+  if (!filePath || lineNum <= 0) return null;
+  return { filePath, line: lineNum, column: colNum };
+}
+
+/**
+ * Return true if this file path is internal (te.js / node_modules) and should be skipped for user context.
+ * @param {string} filePath - Absolute or relative path
+ */
+function isInternalFrame(filePath) {
+  const normalized = path.normalize(filePath).replace(/\\/g, '/');
+  return INTERNAL_PATTERNS.some((p) => normalized.includes(p));
+}
+
+/**
+ * Read source file and return lines [lineNum - LINES_ABOVE, lineNum + LINES_BELOW] with line numbers.
+ * @param {string} filePath - Absolute path
+ * @param {number} lineNum - Center line (1-based)
+ * @returns {Promise<{ file: string, line: number, snippet: string } | null>}
+ */
+async function readSnippet(filePath, lineNum) {
+  let content;
+  try {
+    content = await readFile(filePath, 'utf-8');
+  } catch {
+    return null;
+  }
+  const lines = content.split(/\r?\n/);
+  const start = Math.max(0, lineNum - 1 - LINES_ABOVE);
+  const end = Math.min(lines.length, lineNum + LINES_BELOW);
+  const snippet = lines
+    .slice(start, end)
+    .map((text, i) => {
+      const num = start + i + 1;
+      const marker = num === lineNum ? ' →' : '  ';
+      return `${String(num).padStart(4)}${marker} ${text}`;
+    })
+    .join('\n');
+
+  return {
+    file: filePath,
+    line: lineNum,
+    snippet,
+  };
+}
+
+/**
+ * Capture code context from the current call stack: parse stack, filter to user frames,
+ * and read surrounding source (with line numbers) for each frame. First frame is the
+ * throw site; remaining frames are upstream callers. Each snippet includes lines
+ * above and below (downstream in the same function).
+ *
+ * @param {string} [stack] - Stack string (e.g. new Error().stack). If omitted, captures current stack.
+ * @param {{ maxFrames?: number, linesAround?: number }} [options]
+ * @returns {Promise<{ snippets: Array<{ file: string, line: number, snippet: string }> }>}
+ */
+export async function captureCodeContext(stack, options = {}) {
+  const stackStr = typeof stack === 'string' && stack ? stack : new Error().stack;
+  if (!stackStr) return { snippets: [] };
+
+  const maxFrames = options.maxFrames ?? MAX_FRAMES;
+  const lines = stackStr.split('\n');
+  const frames = [];
+
+  for (const line of lines) {
+    const parsed = parseStackFrame(line);
+    if (!parsed) continue;
+    if (isInternalFrame(parsed.filePath)) continue;
+    frames.push(parsed);
+    if (frames.length >= maxFrames) break;
+  }
+
+  const snippets = [];
+  for (const { filePath, line } of frames) {
+    const one = await readSnippet(filePath, line);
+    if (one) snippets.push(one);
+  }
+
+  return { snippets };
+}