te.js 2.0.0 → 2.0.3

package/example/start-redis.js

@@ -1,2 +0,0 @@
-process.env.REDIS_URL = 'redis://localhost:6379';
-import('./index.js');

package/example/targets/cache.target.js

@@ -1,35 +0,0 @@
-import { Target, TejError } from 'te.js';
-import * as cacheService from '../services/cache.service.js';
-
-const cache = new Target('/cache');
-
-// Middleware: require Redis to be available
-cache.midair((ammo, next) => {
-  if (!cacheService.isAvailable()) {
-    throw new TejError(503, 'Cache service unavailable. Set REDIS_URL to enable Redis.');
-  }
-  next();
-});
-
-cache.register('/:key', async (ammo) => {
-  if (!ammo.GET) return ammo.notAllowed();
-
-  const { key } = ammo.payload;
-  const value = await cacheService.get(key);
-
-  if (value === null) return ammo.notFound();
-
-  ammo.fire({ key, value });
-});
-
-cache.register('/', async (ammo) => {
-  if (!ammo.POST) return ammo.notAllowed();
-
-  const { key, value, ttl } = ammo.payload;
-  if (!key || value === undefined) {
-    throw new TejError(400, 'key and value are required');
-  }
-
-  await cacheService.set(key, value, ttl ? parseInt(ttl, 10) : undefined);
-  ammo.fire(201, { message: 'Cached successfully', key });
-});

package/example/targets/index.target.js

@@ -1,16 +0,0 @@
-import { Target, listAllEndpoints } from 'te.js';
-
-const target = new Target();
-
-target.register('/', (ammo) => {
-  ammo.defaultEntry();
-});
-
-target.register('/health', (ammo) => {
-  ammo.fire({ status: 'ok', timestamp: new Date().toISOString() });
-});
-
-target.register('/routes', (ammo) => {
-  const grouped = listAllEndpoints(true);
-  ammo.fire(grouped);
-});

package/example/targets/users.target.js

@@ -1,60 +0,0 @@
-import { Target, TejError, TejFileUploader } from 'te.js';
-import userService from '../services/user.service.js';
-
-const users = new Target('/users');
-
-const uploader = new TejFileUploader({
-  destination: 'public/uploads',
-  maxFileSize: 5 * 1024 * 1024, // 5MB
-});
-
-users.register('/', (ammo) => {
-  if (ammo.GET) {
-    return ammo.fire(userService.list());
-  }
-  if (ammo.POST) {
-    const user = userService.create(ammo.payload);
-    if (!user) {
-      throw new TejError(400, 'name and email are required');
-    }
-    return ammo.fire(201, user);
-  }
-  ammo.notAllowed();
-});
-
-users.register('/:id', (ammo) => {
-  const { id } = ammo.payload;
-  const user = userService.getById(id);
-
-  if (ammo.GET) {
-    if (!user) return ammo.notFound();
-    return ammo.fire(user);
-  }
-  if (ammo.PUT) {
-    if (!user) return ammo.notFound();
-    const updated = userService.update(id, ammo.payload);
-    return ammo.fire(updated);
-  }
-  if (ammo.DELETE) {
-    if (!userService.delete(id)) return ammo.notFound();
-    return ammo.fire(204);
-  }
-
-  ammo.notAllowed();
-});
-
-users.register('/:id/updateProfileImage', uploader.file('image'), (ammo) => {
-  const { image } = ammo.payload;
-  ammo.fire(200, {
-    message: 'Profile image updated successfully!',
-    file: image,
-  });
-});
-
-users.register('/:id/uploadDocuments', uploader.files('documents'), (ammo) => {
-  const { documents } = ammo.payload;
-  ammo.fire(200, {
-    message: `${documents?.length ?? 0} document(s) uploaded`,
-    files: documents,
-  });
-});

package/example/tejas.config.json

@@ -1,22 +0,0 @@
-{
-  "port": 1403,
-  "log": {
-    "http_requests": true,
-    "exceptions": true
-  },
-  "dir": {
-    "targets": "targets"
-  },
-  "body": {
-    "max_size": 5242880,
-    "timeout": 15000
-  },
-  "docs": {
-    "dirTargets": "targets",
-    "output": "./openapi.json",
-    "title": "Example API",
-    "version": "1.0.0",
-    "level": 1,
-    "productionBranch": "main"
-  }
-}

package/tests/auto-docs/handler-analyzer.test.js

@@ -1,44 +0,0 @@
-/**
- * Unit tests for auto-docs handler-analyzer (detectMethods, analyzeHandler).
- */
-import { describe, it, expect } from 'vitest';
-import { detectMethods, analyzeHandler, ALL_METHODS } from '../../auto-docs/analysis/handler-analyzer.js';
-
-describe('handler-analyzer', () => {
-  describe('detectMethods', () => {
-    it('returns all methods when handler is not a function', () => {
-      expect(detectMethods(null)).toEqual(ALL_METHODS);
-      expect(detectMethods(undefined)).toEqual(ALL_METHODS);
-    });
-
-    it('detects GET when handler uses ammo.GET', () => {
-      const handler = (ammo) => { if (ammo.GET) ammo.fire(200, {}); };
-      expect(detectMethods(handler)).toContain('GET');
-    });
-
-    it('detects POST and GET when handler checks both', () => {
-      const handler = (ammo) => {
-        if (ammo.GET) ammo.fire(200, {});
-        if (ammo.POST) ammo.fire(201, {});
-      };
-      const detected = detectMethods(handler);
-      expect(detected).toContain('GET');
-      expect(detected).toContain('POST');
-    });
-
-    it('returns all methods when no method checks found (method-agnostic)', () => {
-      const handler = () => {};
-      expect(detectMethods(handler)).toEqual(ALL_METHODS);
-    });
-  });
-
-  describe('analyzeHandler', () => {
-    it('returns object with methods array', () => {
-      const handler = (ammo) => { if (ammo.GET) ammo.fire(200); };
-      const result = analyzeHandler(handler);
-      expect(result).toHaveProperty('methods');
-      expect(Array.isArray(result.methods)).toBe(true);
-      expect(result.methods).toContain('GET');
-    });
-  });
-});

package/tests/auto-docs/openapi-generator.test.js

@@ -1,103 +0,0 @@
-/**
- * Unit tests for auto-docs openapi/generator pure functions.
- */
-import { describe, it, expect } from 'vitest';
-import {
-  toOpenAPIPath,
-  getPathParameters,
-  getQueryParameters,
-  buildSchemaFromMetadata,
-  buildResponses,
-  buildOperation,
-  mergeMetadata,
-} from '../../auto-docs/openapi/generator.js';
-
-describe('openapi-generator', () => {
-  describe('toOpenAPIPath', () => {
-    it('converts :param to {param}', () => {
-      expect(toOpenAPIPath('/users/:id')).toBe('/users/{id}');
-    });
-    it('converts multiple params', () => {
-      expect(toOpenAPIPath('/users/:userId/posts/:postId')).toBe('/users/{userId}/posts/{postId}');
-    });
-    it('returns / for empty or non-string', () => {
-      expect(toOpenAPIPath('')).toBe('/');
-      expect(toOpenAPIPath(null)).toBe('/');
-    });
-  });
-
-  describe('getPathParameters', () => {
-    it('extracts path params from te.js path', () => {
-      const params = getPathParameters('/users/:id');
-      expect(params).toHaveLength(1);
-      expect(params[0]).toMatchObject({ name: 'id', in: 'path', required: true, schema: { type: 'string' } });
-    });
-    it('returns empty array for path without params', () => {
-      expect(getPathParameters('/users')).toEqual([]);
-    });
-  });
-
-  describe('getQueryParameters', () => {
-    it('builds query params from metadata', () => {
-      const queryMeta = { limit: { type: 'integer', required: false }, q: { type: 'string', required: true } };
-      const params = getQueryParameters(queryMeta);
-      expect(params).toHaveLength(2);
-      expect(params.find((p) => p.name === 'limit')).toMatchObject({ in: 'query', required: false });
-      expect(params.find((p) => p.name === 'q')).toMatchObject({ in: 'query', required: true });
-    });
-    it('returns empty array for invalid meta', () => {
-      expect(getQueryParameters(null)).toEqual([]);
-    });
-  });
-
-  describe('buildSchemaFromMetadata', () => {
-    it('builds OpenAPI schema from field meta', () => {
-      const meta = { name: { type: 'string' }, email: { type: 'string', format: 'email', required: true } };
-      const schema = buildSchemaFromMetadata(meta);
-      expect(schema.type).toBe('object');
-      expect(schema.properties.name.type).toBe('string');
-      expect(schema.properties.email.format).toBe('email');
-      expect(schema.required).toContain('email');
-    });
-  });
-
-  describe('buildResponses', () => {
-    it('returns 200 Success when responseMeta empty', () => {
-      const r = buildResponses(null);
-      expect(r['200']).toEqual({ description: 'Success' });
-    });
-    it('builds responses from metadata', () => {
-      const meta = { 200: { description: 'OK' }, 201: { description: 'Created' } };
-      const r = buildResponses(meta);
-      expect(r['200'].description).toBe('OK');
-      expect(r['201'].description).toBe('Created');
-    });
-  });
-
-  describe('buildOperation', () => {
-    it('builds operation with summary and responses', () => {
-      const meta = { summary: 'Get user', response: { 200: { description: 'OK' } } };
-      const pathParams = [];
-      const op = buildOperation('get', meta, pathParams);
-      expect(op.summary).toBe('Get user');
-      expect(op.responses['200'].description).toBe('OK');
-    });
-  });
-
-  describe('mergeMetadata', () => {
-    it('prefers explicit when preferEnhanced false', () => {
-      const explicit = { summary: 'A', description: 'B' };
-      const enhanced = { summary: 'C', description: 'D' };
-      const merged = mergeMetadata(explicit, enhanced, { preferEnhanced: false });
-      expect(merged.summary).toBe('A');
-      expect(merged.description).toBe('B');
-    });
-    it('prefers enhanced when preferEnhanced true', () => {
-      const explicit = { summary: 'A' };
-      const enhanced = { summary: 'C', description: 'D' };
-      const merged = mergeMetadata(explicit, enhanced, { preferEnhanced: true });
-      expect(merged.summary).toBe('C');
-      expect(merged.description).toBe('D');
-    });
-  });
-});

package/tests/auto-docs/parse.test.js

@@ -1,63 +0,0 @@
-/**
- * Unit tests for auto-docs llm/parse (extractJSON, extractJSONArray, reconcileOrderedTags).
- */
-import { describe, it, expect } from 'vitest';
-import {
-  extractJSON,
-  extractJSONArray,
-  reconcileOrderedTags,
-} from '../../auto-docs/llm/parse.js';
-
-describe('llm/parse', () => {
-  describe('extractJSON', () => {
-    it('extracts object from plain JSON string', () => {
-      const str = '{"name":"Users","description":"CRUD"}';
-      expect(extractJSON(str)).toEqual({ name: 'Users', description: 'CRUD' });
-    });
-    it('extracts first object from text with markdown', () => {
-      const str = 'Here is the result:\n```json\n{"summary":"Get item"}\n```';
-      expect(extractJSON(str)).toEqual({ summary: 'Get item' });
-    });
-    it('returns null for empty or no object', () => {
-      expect(extractJSON('')).toBeNull();
-      expect(extractJSON('no brace here')).toBeNull();
-    });
-  });
-
-  describe('extractJSONArray', () => {
-    it('extracts array from string', () => {
-      const str = '["Users", "Auth", "Health"]';
-      expect(extractJSONArray(str)).toEqual(['Users', 'Auth', 'Health']);
-    });
-    it('returns null when no array', () => {
-      expect(extractJSONArray('')).toBeNull();
-      expect(extractJSONArray('nothing')).toBeNull();
-    });
-  });
-
-  describe('reconcileOrderedTags', () => {
-    it('reorders tags by orderedTagNames', () => {
-      const tags = [
-        { name: 'Health', description: '...' },
-        { name: 'Users', description: '...' },
-        { name: 'Auth', description: '...' },
-      ];
-      const ordered = reconcileOrderedTags(['Users', 'Auth', 'Health'], tags);
-      expect(ordered.map((t) => t.name)).toEqual(['Users', 'Auth', 'Health']);
-    });
-    it('appends tags not in orderedTagNames', () => {
-      const tags = [
-        { name: 'Users' },
-        { name: 'Other' },
-      ];
-      const ordered = reconcileOrderedTags(['Users'], tags);
-      expect(ordered.map((t) => t.name)).toEqual(['Users', 'Other']);
-    });
-    it('returns copy of tags when orderedTagNames empty', () => {
-      const tags = [{ name: 'A' }];
-      const ordered = reconcileOrderedTags([], tags);
-      expect(ordered).toEqual([{ name: 'A' }]);
-      expect(ordered).not.toBe(tags);
-    });
-  });
-});

package/tests/auto-docs/source-resolver.test.js

@@ -1,58 +0,0 @@
-/**
- * Unit tests for auto-docs source-resolver (extractRelativeImports, resolveTargetFilePath, formatDependencyContext).
- */
-import { describe, it, expect } from 'vitest';
-import path from 'node:path';
-import {
-  extractRelativeImports,
-  resolveTargetFilePath,
-  formatDependencyContext,
-} from '../../auto-docs/analysis/source-resolver.js';
-
-describe('source-resolver', () => {
-  describe('extractRelativeImports', () => {
-    it('extracts relative import paths', () => {
-      const source = `import x from './foo.js';\nimport { y } from '../bar.js';`;
-      const imports = extractRelativeImports(source);
-      expect(imports).toContain('./foo.js');
-      expect(imports).toContain('../bar.js');
-    });
-    it('ignores absolute or node imports', () => {
-      const source = `import path from 'path';\nimport x from './local.js';`;
-      const imports = extractRelativeImports(source);
-      expect(imports).toEqual(['./local.js']);
-    });
-    it('returns unique paths', () => {
-      const source = `import a from './foo.js';\nimport b from './foo.js';`;
-      expect(extractRelativeImports(source)).toHaveLength(1);
-    });
-  });
-
-  describe('resolveTargetFilePath', () => {
-    it('joins dirTargets with groupId and .target.js', () => {
-      const resolved = resolveTargetFilePath('users', 'targets');
-      expect(resolved).toMatch(/targets[\\/]users\.target\.js$/);
-    });
-    it('converts groupId slashes to path sep', () => {
-      const resolved = resolveTargetFilePath('subdir/users', 'targets');
-      expect(resolved).toMatch(/subdir[\\/]users\.target\.js$/);
-    });
-  });
-
-  describe('formatDependencyContext', () => {
-    it('returns empty string for empty sources', () => {
-      expect(formatDependencyContext(new Map(), null)).toBe('');
-    });
-    it('formats map of path -> source with labels', () => {
-      const sources = new Map([
-        ['/cwd/targets/users.target.js', 'const x = 1;'],
-        ['/cwd/services/user.js', 'const y = 2;'],
-      ]);
-      const targetPath = '/cwd/targets/users.target.js';
-      const out = formatDependencyContext(sources, targetPath, 1000);
-      expect(out).toContain('Target');
-      expect(out).toContain('const x = 1;');
-      expect(out).toContain('const y = 2;');
-    });
-  });
-});

package/tests/helpers/index.js

@@ -1,37 +0,0 @@
-/**
- * Test Helpers Index
- * Central export for all test utilities and mocks
- */
-
-// HTTP Mocks
-export {
-  MockRequest,
-  MockResponse,
-  createMockRequest,
-  createMockResponse,
-  createMockPair,
-  createJsonRequest,
-  createFormRequest,
-  createMultipartRequest,
-  createMultipartBody,
-} from './mock-http.js';
-
-// Test Utilities
-export {
-  createTestAmmo,
-  createEnhancedAmmo,
-  createTestRegistry,
-  createMockEndpoint,
-  createMockMiddleware,
-  createExpressStyleMiddleware,
-  sleep,
-  waitFor,
-  createMockDbConnection,
-  createMockFile,
-  createMockStorage,
-  assertResponse,
-  mockConsole,
-  captureResponse,
-} from './test-utils.js';
-
-