te.js 2.1.6 → 2.2.1

package/cli/docs-command.js

@@ -32,25 +32,25 @@ function mask(value) {
 
 function ask(question, fallback = '') {
   const hint = fallback ? c.dim(` (${fallback})`) : '';
-  return new Promise((resolve) => {
-    rl.question(`${c.cyan('?')} ${question}${hint}${c.dim(': ')}`, (answer) => {
-      resolve(answer.trim() || fallback);
-    });
+  const { promise, resolve } = Promise.withResolvers();
+  rl.question(`${c.cyan('?')} ${question}${hint}${c.dim(': ')}`, (answer) => {
+    resolve(answer.trim() || fallback);
   });
+  return promise;
 }
 
 function askYesNo(question, fallback = false) {
   const hint = fallback ? 'Y/n' : 'y/N';
-  return new Promise((resolve) => {
-    rl.question(
-      `${c.cyan('?')} ${question} ${c.dim(`(${hint})`)}${c.dim(': ')}`,
-      (answer) => {
-        const val = answer.trim().toLowerCase();
-        if (!val) return resolve(fallback);
-        resolve(val === 'y' || val === 'yes');
-      },
-    );
-  });
+  const { promise, resolve } = Promise.withResolvers();
+  rl.question(
+    `${c.cyan('?')} ${question} ${c.dim(`(${hint})`)}${c.dim(': ')}`,
+    (answer) => {
+      const val = answer.trim().toLowerCase();
+      if (!val) return resolve(fallback);
+      resolve(val === 'y' || val === 'yes');
+    },
+  );
+  return promise;
 }
 
 async function loadTargetFiles(dirTargets = 'targets') {
@@ -88,13 +88,15 @@ async function loadTargetFiles(dirTargets = 'targets') {
 function getDocsOptionsFromConfig(config = {}) {
   const docs = config.docs || config.generateDocs || {};
   const e = process.env;
-  const baseURL = docs.llm?.baseURL ?? e.LLM_BASE_URL ?? 'https://api.openai.com/v1';
+  const baseURL =
+    docs.llm?.baseURL ?? e.LLM_BASE_URL ?? 'https://api.openai.com/v1';
   const apiKey = docs.llm?.apiKey ?? e.LLM_API_KEY ?? e.OPENAI_API_KEY;
   const model = docs.llm?.model ?? e.LLM_MODEL ?? 'gpt-4o-mini';
   if (!apiKey && !e.OPENAI_API_KEY) {
     return null;
   }
-  const dirTargets = docs.dirTargets ?? docs.dir?.targets ?? config.dir?.targets ?? 'targets';
+  const dirTargets =
+    docs.dirTargets ?? docs.dir?.targets ?? config.dir?.targets ?? 'targets';
   const output = docs.output ?? './openapi.json';
   const title = docs.title ?? 'API';
   const version = docs.version ?? '1.0.0';
@@ -116,7 +118,7 @@ function getDocsOptionsFromConfig(config = {}) {
  * @returns {Promise<void>}
  */
 export async function runDocsCommandCI() {
-  const config = loadConfigFile();
+  const config = await loadConfigFile();
   const options = getDocsOptionsFromConfig(config);
   if (!options) {
     console.error(
@@ -128,7 +130,9 @@ export async function runDocsCommandCI() {
   process.stdout.write(`${c.yellow('⏳')} Loading targets...`);
   const fileCount = await loadTargetFiles(dirTargets);
   const endpointCount = targetRegistry.targets?.length ?? 0;
-  process.stdout.write(`\r${c.green('✓')} Loaded ${c.bold(fileCount)} target file(s) — ${c.bold(endpointCount)} endpoint(s)\n`);
+  process.stdout.write(
+    `\r${c.green('✓')} Loaded ${c.bold(fileCount)} target file(s) — ${c.bold(endpointCount)} endpoint(s)\n`,
+  );
   if (endpointCount === 0) {
     console.log(c.yellow('  No endpoints found. Skipping doc generation.\n'));
     return;
@@ -156,19 +160,19 @@ export async function runDocsCommandCI() {
  * @returns {Promise<string[]>} e.g. ['refs/heads/main', 'refs/heads/feature/x']
  */
 function readPrePushRefs() {
-  return new Promise((resolve) => {
-    const chunks = [];
-    stdin.on('data', (chunk) => chunks.push(chunk));
-    stdin.on('end', () => {
-      const lines = Buffer.concat(chunks).toString('utf8').trim().split('\n');
-      const refs = [];
-      for (let i = 0; i < lines.length; i++) {
-        const parts = lines[i].split(/\s+/);
-        if (parts.length >= 4) refs.push(parts[2]); // remote_ref
-      }
-      resolve(refs);
-    });
+  const { promise, resolve } = Promise.withResolvers();
+  const chunks = [];
+  stdin.on('data', (chunk) => chunks.push(chunk));
+  stdin.on('end', () => {
+    const lines = Buffer.concat(chunks).toString('utf8').trim().split('\n');
+    const refs = [];
+    for (let i = 0; i < lines.length; i++) {
+      const parts = lines[i].split(/\s+/);
+      if (parts.length >= 4) refs.push(parts[2]);
+    }
+    resolve(refs);
   });
+  return promise;
 }
 
 /**
@@ -178,7 +182,7 @@ function readPrePushRefs() {
  * Configure via tejas.config.json docs.productionBranch or env DOCS_PRODUCTION_BRANCH (default: main).
  */
 export async function runDocsOnPush() {
-  const config = loadConfigFile();
+  const config = await loadConfigFile();
   const docs = config.docs || config.generateDocs || {};
   const productionBranch =
     docs.productionBranch ?? process.env.DOCS_PRODUCTION_BRANCH ?? 'main';
@@ -186,7 +190,11 @@ export async function runDocsOnPush() {
   const productionRef = `refs/heads/${productionBranch}`;
   const isPushingToProduction = remoteRefs.some((ref) => ref === productionRef);
   if (!isPushingToProduction) return;
-  console.log(c.dim(`  Docs: pushing to ${productionBranch} — generating documentation...\n`));
+  console.log(
+    c.dim(
+      `  Docs: pushing to ${productionBranch} — generating documentation...\n`,
+    ),
+  );
   await runDocsCommandCI();
 }
 
@@ -207,13 +215,13 @@ function serveDocsPreview(spec, port = 3333) {
     res.writeHead(404);
     res.end('Not found');
   });
-  return new Promise((resolve) => {
-    server.listen(port, () => resolve(server));
-  });
+  const { promise, resolve } = Promise.withResolvers();
+  server.listen(port, () => resolve(server));
+  return promise;
 }
 
 export async function runDocsCommand() {
-  const config = loadConfigFile();
+  const config = await loadConfigFile();
   const e = process.env;
 
   console.log();

package/cors/index.test.js

@@ -0,0 +1,82 @@
+/**
+ * @fileoverview Tests for CORS middleware.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import corsMiddleware from './index.js';
+
+function makeAmmo(method = 'GET', origin = 'https://example.com') {
+  const headers = {};
+  return {
+    req: { method, headers: { origin } },
+    res: {
+      _headers: {},
+      setHeader(name, value) {
+        this._headers[name.toLowerCase()] = value;
+      },
+      writeHead(code) {
+        this._status = code;
+      },
+      end() {
+        this._ended = true;
+      },
+    },
+  };
+}
+
+describe('corsMiddleware', () => {
+  it('should set Access-Control-Allow-Origin to * by default', async () => {
+    const mw = corsMiddleware();
+    const ammo = makeAmmo();
+    const next = vi.fn();
+    await mw(ammo, next);
+    expect(ammo.res._headers['access-control-allow-origin']).toBe('*');
+    expect(next).toHaveBeenCalled();
+  });
+
+  it('should respond 204 and not call next for OPTIONS preflight', async () => {
+    const mw = corsMiddleware();
+    const ammo = makeAmmo('OPTIONS');
+    const next = vi.fn();
+    await mw(ammo, next);
+    expect(ammo.res._status).toBe(204);
+    expect(ammo.res._ended).toBe(true);
+    expect(next).not.toHaveBeenCalled();
+  });
+
+  it('should allow specific origin from array', async () => {
+    const mw = corsMiddleware({ origin: ['https://example.com'] });
+    const ammo = makeAmmo('GET', 'https://example.com');
+    const next = vi.fn();
+    await mw(ammo, next);
+    expect(ammo.res._headers['access-control-allow-origin']).toBe(
+      'https://example.com',
+    );
+  });
+
+  it('should block origins not in array', async () => {
+    const mw = corsMiddleware({ origin: ['https://example.com'] });
+    const ammo = makeAmmo('GET', 'https://evil.com');
+    const next = vi.fn();
+    await mw(ammo, next);
+    expect(ammo.res._headers['access-control-allow-origin']).toBeUndefined();
+  });
+
+  it('should set Access-Control-Max-Age when maxAge provided', async () => {
+    const mw = corsMiddleware({ maxAge: 86400 });
+    const ammo = makeAmmo();
+    const next = vi.fn();
+    await mw(ammo, next);
+    expect(ammo.res._headers['access-control-max-age']).toBe('86400');
+  });
+
+  it('should set Access-Control-Allow-Credentials when credentials=true', async () => {
+    const mw = corsMiddleware({
+      credentials: true,
+      origin: 'https://example.com',
+    });
+    const ammo = makeAmmo('GET', 'https://example.com');
+    const next = vi.fn();
+    await mw(ammo, next);
+    expect(ammo.res._headers['access-control-allow-credentials']).toBe('true');
+  });
+});

package/docs/README.md

@@ -18,8 +18,7 @@ Welcome to the documentation for **Tejas** — a Node.js framework for building
 
 ### Features
 
-- [Database Integration](./database.md) — Redis and MongoDB connections with auto-install
-- [Rate Limiting](./rate-limiting.md) — Three algorithms, two storage backends, custom headers
+- [Rate Limiting](./rate-limiting.md) — Three algorithms, memory or Redis storage, custom headers
 - [File Uploads](./file-uploads.md) — Single and multiple file handling with validation
 
 ### Tooling