@open-skills-hub/api 1.0.0

package/src/server.ts

@@ -0,0 +1,205 @@
+/**
+ * Open Skills Hub - API Server Configuration
+ */
+
+import Fastify, { FastifyInstance } from 'fastify';
+import cors from '@fastify/cors';
+import helmet from '@fastify/helmet';
+import rateLimit from '@fastify/rate-limit';
+import multipart from '@fastify/multipart';
+
+import {
+  getConfig,
+  getStorage,
+  logger,
+} from '@open-skills-hub/core';
+
+import { errorHandler, notFoundHandler } from './middleware/error.js';
+import { requestLogger } from './middleware/logger.js';
+import { skillsRoutes } from './routes/skills.js';
+import { versionsRoutes } from './routes/versions.js';
+import { searchRoutes } from './routes/search.js';
+import { scanRoutes } from './routes/scan.js';
+import { feedbackRoutes } from './routes/feedback.js';
+import { auditRoutes } from './routes/audit.js';
+import { cacheRoutes } from './routes/cache.js';
+import { healthRoutes } from './routes/health.js';
+
+export interface ServerOptions {
+  host?: string;
+  port?: number;
+}
+
+/**
+ * Create and configure the Fastify server
+ */
+export async function createServer(options?: ServerOptions): Promise<FastifyInstance> {
+  const config = getConfig().get();
+  const serverConfig = config.server;
+  
+  const server = Fastify({
+    logger: false, // We use our own logger
+    trustProxy: serverConfig.trustProxy,
+    requestIdHeader: 'x-request-id',
+    requestIdLogLabel: 'requestId',
+    genReqId: () => `req_${Date.now().toString(36)}_${Math.random().toString(36).substr(2, 9)}`,
+    // Increase body size limit to support large skills with many files (e.g., XSD schemas)
+    bodyLimit: 50 * 1024 * 1024, // 50MB
+  });
+
+  // Register plugins
+  await registerPlugins(server, config);
+
+  // Register middleware
+  await registerMiddleware(server);
+
+  // Register routes
+  await registerRoutes(server);
+
+  // Set error handlers
+  server.setNotFoundHandler(notFoundHandler);
+  server.setErrorHandler(errorHandler);
+
+  return server;
+}
+
+/**
+ * Register Fastify plugins
+ */
+async function registerPlugins(server: FastifyInstance, config: ReturnType<ReturnType<typeof getConfig>['get']>) {
+  // CORS
+  if (config.server.cors) {
+    await server.register(cors, {
+      origin: true,
+      methods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],
+      allowedHeaders: ['Content-Type', 'Authorization', 'X-Request-ID'],
+      exposedHeaders: ['X-Request-ID', 'X-RateLimit-Limit', 'X-RateLimit-Remaining'],
+      credentials: true,
+      maxAge: 86400,
+    });
+  }
+
+  // Security headers
+  await server.register(helmet, {
+    contentSecurityPolicy: false, // Disabled for API
+    crossOriginResourcePolicy: { policy: 'cross-origin' },
+  });
+
+  // Rate limiting
+  if (config.rateLimit.enabled) {
+    await server.register(rateLimit, {
+      global: true,
+      max: config.rateLimit.max,
+      timeWindow: config.rateLimit.windowMs,
+      allowList: ['127.0.0.1'],
+      addHeadersOnExceeding: {
+        'x-ratelimit-limit': true,
+        'x-ratelimit-remaining': true,
+        'x-ratelimit-reset': true,
+      },
+      addHeaders: {
+        'x-ratelimit-limit': true,
+        'x-ratelimit-remaining': true,
+        'x-ratelimit-reset': true,
+        'retry-after': true,
+      },
+    });
+  }
+
+  // Multipart form data (for file uploads)
+  await server.register(multipart, {
+    limits: {
+      fileSize: 10 * 1024 * 1024, // 10MB max file size
+      files: 10, // Max number of files
+    },
+  });
+}
+
+/**
+ * Register middleware
+ */
+async function registerMiddleware(server: FastifyInstance) {
+  // Request logging
+  server.addHook('onRequest', requestLogger);
+
+  // Add request timing
+  server.addHook('onRequest', async (request) => {
+    request.startTime = Date.now();
+  });
+
+  // Add response timing header
+  server.addHook('onSend', async (request, reply) => {
+    if (request.startTime) {
+      const duration = Date.now() - request.startTime;
+      reply.header('X-Response-Time', `${duration}ms`);
+    }
+  });
+}
+
+/**
+ * Register API routes
+ */
+async function registerRoutes(server: FastifyInstance) {
+  // Health check (no prefix)
+  await server.register(healthRoutes);
+
+  // API v1 routes
+  await server.register(async (api) => {
+    await api.register(skillsRoutes, { prefix: '/skills' });
+    await api.register(versionsRoutes, { prefix: '/skills' });
+    await api.register(searchRoutes, { prefix: '/search' });
+    await api.register(scanRoutes, { prefix: '/scan' });
+    await api.register(feedbackRoutes, { prefix: '/feedback' });
+    await api.register(auditRoutes, { prefix: '/audit' });
+    await api.register(cacheRoutes, { prefix: '/cache' });
+  }, { prefix: '/v1' });
+}
+
+/**
+ * Start the server
+ */
+export async function startServer(server: FastifyInstance, options?: ServerOptions): Promise<string> {
+  const config = getConfig().get();
+  const host = options?.host ?? config.server.host;
+  const port = options?.port ?? config.server.port;
+
+  try {
+    // Initialize storage
+    const storage = await getStorage();
+    await storage.initialize();
+    logger.info('Storage initialized');
+
+    // Start listening
+    const address = await server.listen({ host, port });
+    logger.info(`Server started`, { address, mode: config.mode });
+
+    return address;
+  } catch (error) {
+    logger.error('Failed to start server', { error });
+    throw error;
+  }
+}
+
+/**
+ * Stop the server gracefully
+ */
+export async function stopServer(server: FastifyInstance): Promise<void> {
+  try {
+    await server.close();
+    
+    const storage = await getStorage();
+    await storage.close();
+    
+    logger.info('Server stopped gracefully');
+  } catch (error) {
+    logger.error('Error during server shutdown', { error });
+    throw error;
+  }
+}
+
+// Extend FastifyRequest type
+declare module 'fastify' {
+  interface FastifyRequest {
+    startTime?: number;
+  }
+}

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "composite": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"],
+  "references": [
+    { "path": "../core" }
+  ]
+}