@macss/modular-api 0.1.0 → 0.3.0

package/dist/core/usecase_test_handler.d.ts

@@ -1,4 +1,5 @@
 import type { UseCaseFactory, Input, Output } from './usecase';
+import type { ModularLogger } from './logger/logger';
 export interface TestResponse {
     statusCode: number;
     body: Record<string, unknown>;
@@ -21,4 +22,6 @@ export interface TestResponse {
  * expect(response.body).toEqual({ message: 'Hello, World!' });
  * ```
  */
-export declare function useCaseTestHandler<I extends Input, O extends Output>(factory: UseCaseFactory<I, O>, input?: Record<string, unknown>): Promise<TestResponse>;
+export declare function useCaseTestHandler<I extends Input, O extends Output>(factory: UseCaseFactory<I, O>, input?: Record<string, unknown>, options?: {
+    logger?: ModularLogger;
+}): Promise<TestResponse>;

package/dist/core/usecase_test_handler.js

@@ -25,9 +25,13 @@ const use_case_exception_1 = require("./use_case_exception");
  * expect(response.body).toEqual({ message: 'Hello, World!' });
  * ```
  */
-async function useCaseTestHandler(factory, input = {}) {
+async function useCaseTestHandler(factory, input = {}, options) {
     try {
         const useCase = factory(input);
+        // Inject logger if provided
+        if (options?.logger) {
+            useCase.logger = options.logger;
+        }
         const validationError = useCase.validate();
         if (validationError !== null) {
             return {

package/dist/index.d.ts

@@ -9,3 +9,15 @@ export { useCaseTestHandler } from './core/usecase_test_handler';
 export type { TestResponse } from './core/usecase_test_handler';
 export { cors } from './middlewares/cors';
 export type { CorsOptions } from './middlewares/cors';
+export { HealthCheck, HealthCheckResult } from './core/health/health_check';
+export type { HealthStatus } from './core/health/health_check';
+export { HealthService, HealthResponse } from './core/health/health_service';
+export type { HealthServiceOptions } from './core/health/health_service';
+export { healthHandler } from './core/health/health_handler';
+export { MetricRegistry, MetricsRegistrar } from './core/metrics/metric_registry';
+export { metricsMiddleware, metricsHandler } from './core/metrics/metrics_middleware';
+export type { MetricsMiddlewareOptions } from './core/metrics/metrics_middleware';
+export { LogLevel, RequestScopedLogger } from './core/logger/logger';
+export type { ModularLogger } from './core/logger/logger';
+export { loggingMiddleware, LOGGER_LOCALS_KEY } from './core/logger/logging_middleware';
+export type { LoggingMiddlewareOptions } from './core/logger/logging_middleware';

package/dist/index.js

@@ -5,7 +5,7 @@
 //   import { ModularApi, UseCase, Input, Output } from 'modular_api'
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cors = exports.useCaseTestHandler = exports.ModuleBuilder = exports.ModularApi = exports.UseCaseException = exports.UseCase = exports.Output = exports.Input = void 0;
+exports.LOGGER_LOCALS_KEY = exports.loggingMiddleware = exports.RequestScopedLogger = exports.LogLevel = exports.metricsHandler = exports.metricsMiddleware = exports.MetricsRegistrar = exports.MetricRegistry = exports.healthHandler = exports.HealthResponse = exports.HealthService = exports.HealthCheckResult = exports.HealthCheck = exports.cors = exports.useCaseTestHandler = exports.ModuleBuilder = exports.ModularApi = exports.UseCaseException = exports.UseCase = exports.Output = exports.Input = void 0;
 // Core abstractions
 var usecase_1 = require("./core/usecase");
 Object.defineProperty(exports, "Input", { enumerable: true, get: function () { return usecase_1.Input; } });
@@ -26,3 +26,26 @@ Object.defineProperty(exports, "useCaseTestHandler", { enumerable: true, get: fu
 // Middlewares
 var cors_1 = require("./middlewares/cors");
 Object.defineProperty(exports, "cors", { enumerable: true, get: function () { return cors_1.cors; } });
+// Health — IETF Health Check Response Format
+var health_check_1 = require("./core/health/health_check");
+Object.defineProperty(exports, "HealthCheck", { enumerable: true, get: function () { return health_check_1.HealthCheck; } });
+Object.defineProperty(exports, "HealthCheckResult", { enumerable: true, get: function () { return health_check_1.HealthCheckResult; } });
+var health_service_1 = require("./core/health/health_service");
+Object.defineProperty(exports, "HealthService", { enumerable: true, get: function () { return health_service_1.HealthService; } });
+Object.defineProperty(exports, "HealthResponse", { enumerable: true, get: function () { return health_service_1.HealthResponse; } });
+var health_handler_1 = require("./core/health/health_handler");
+Object.defineProperty(exports, "healthHandler", { enumerable: true, get: function () { return health_handler_1.healthHandler; } });
+// Metrics — Prometheus /metrics endpoint
+var metric_registry_1 = require("./core/metrics/metric_registry");
+Object.defineProperty(exports, "MetricRegistry", { enumerable: true, get: function () { return metric_registry_1.MetricRegistry; } });
+Object.defineProperty(exports, "MetricsRegistrar", { enumerable: true, get: function () { return metric_registry_1.MetricsRegistrar; } });
+var metrics_middleware_1 = require("./core/metrics/metrics_middleware");
+Object.defineProperty(exports, "metricsMiddleware", { enumerable: true, get: function () { return metrics_middleware_1.metricsMiddleware; } });
+Object.defineProperty(exports, "metricsHandler", { enumerable: true, get: function () { return metrics_middleware_1.metricsHandler; } });
+// Logger — Structured JSON logging (Loki/Grafana compatible)
+var logger_1 = require("./core/logger/logger");
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_1.LogLevel; } });
+Object.defineProperty(exports, "RequestScopedLogger", { enumerable: true, get: function () { return logger_1.RequestScopedLogger; } });
+var logging_middleware_1 = require("./core/logger/logging_middleware");
+Object.defineProperty(exports, "loggingMiddleware", { enumerable: true, get: function () { return logging_middleware_1.loggingMiddleware; } });
+Object.defineProperty(exports, "LOGGER_LOCALS_KEY", { enumerable: true, get: function () { return logging_middleware_1.LOGGER_LOCALS_KEY; } });

package/dist/openapi/openapi.js

@@ -19,9 +19,7 @@ const registry_1 = require("../core/registry");
  */
 function buildOpenApiSpec(options) {
     const { title, port, version = '0.1.0', description = 'Auto-generated by modular-api', servers, } = options;
-    const defaultServers = [
-        { url: `http://localhost:${port}`, description: 'Local' },
-    ];
+    const defaultServers = [{ url: `http://localhost:${port}`, description: 'Local' }];
     const paths = {};
     for (const route of registry_1.apiRegistry.routes) {
         const method = route.method.toLowerCase();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@macss/modular-api",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Use-case-centric toolkit for building modular APIs with Express. Define UseCase classes (input → validate → execute → output), connect them to HTTP routes, and expose Swagger/OpenAPI documentation automatically.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,7 +12,9 @@
   "scripts": {
     "build": "tsc --project tsconfig.build.json",
     "dev": "ts-node src/index.ts",
-    "test": "echo \"No tests yet\" && exit 0"
+    "test": "vitest run",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
   },
   "keywords": [
     "api",
@@ -25,13 +27,18 @@
   "license": "MIT",
   "dependencies": {
     "express": "^4.22.1",
+    "prom-client": "^15.1.3",
     "swagger-ui-express": "^5.0.1"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",
     "@types/node": "^22.19.11",
+    "@types/supertest": "^6.0.3",
     "@types/swagger-ui-express": "^4.1.8",
+    "prettier": "^3.8.1",
+    "supertest": "^7.2.2",
     "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   }
 }