@criterionx/server 0.3.1 → 0.3.2

package/dist/index.d.ts

@@ -130,6 +130,39 @@ interface DecisionInfo {
     description?: string;
     meta?: Record<string, unknown>;
 }
+/**
+ * Error codes for structured error responses
+ */
+type ErrorCode = "DECISION_NOT_FOUND" | "INVALID_JSON" | "MISSING_INPUT" | "MISSING_PROFILE" | "VALIDATION_ERROR" | "EVALUATION_ERROR" | "INTERNAL_ERROR";
+/**
+ * Structured error response
+ */
+interface ErrorResponse {
+    error: {
+        code: ErrorCode;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+    requestId?: string;
+    timestamp: string;
+}
+/**
+ * Health check status
+ */
+type HealthStatus = "healthy" | "degraded" | "unhealthy";
+/**
+ * Health check response
+ */
+interface HealthResponse {
+    status: HealthStatus;
+    version: string;
+    uptime: number;
+    timestamp: string;
+    checks?: Record<string, {
+        status: HealthStatus;
+        message?: string;
+    }>;
+}
 
 /**
  * Generate OpenAPI-compatible schema for a decision endpoint
@@ -269,6 +302,7 @@ declare class CriterionServer {
     private metricsOptions;
     private openApiOptions;
     private openApiSpec;
+    private startTime;
     constructor(options: ServerOptions);
     private setupRoutes;
     private generateDocsHtml;
@@ -290,4 +324,4 @@ declare class CriterionServer {
  */
 declare function createServer(options: ServerOptions): CriterionServer;
 
-export { type AfterEvaluateHook, type BeforeEvaluateHook, CriterionServer, type DecisionInfo, type EvaluateRequest, type HookContext, type Hooks, METRIC_EVALUATIONS_TOTAL, METRIC_EVALUATION_DURATION_SECONDS, METRIC_RULE_MATCHES_TOTAL, MetricsCollector, type MetricsOptions$1 as MetricsOptions, type OnErrorHook, type OpenAPIInfo, type OpenAPIOptions, type OpenAPISpec, type ServerOptions, createServer, generateEndpointSchema, generateOpenAPISpec, generateSwaggerUIHtml };
+export { type AfterEvaluateHook, type BeforeEvaluateHook, CriterionServer, type DecisionInfo, type ErrorCode, type ErrorResponse, type EvaluateRequest, type HealthResponse, type HealthStatus, type HookContext, type Hooks, METRIC_EVALUATIONS_TOTAL, METRIC_EVALUATION_DURATION_SECONDS, METRIC_RULE_MATCHES_TOTAL, MetricsCollector, type MetricsOptions$1 as MetricsOptions, type OnErrorHook, type OpenAPIInfo, type OpenAPIOptions, type OpenAPISpec, type ServerOptions, createServer, generateEndpointSchema, generateOpenAPISpec, generateSwaggerUIHtml };

package/dist/index.js

@@ -457,9 +457,21 @@ import { Hono } from "hono";
 import { cors } from "hono/cors";
 import { serve } from "@hono/node-server";
 import { Engine } from "@criterionx/core";
+var SERVER_VERSION = "0.3.2";
 function generateRequestId() {
   return `req_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 9)}`;
 }
+function createErrorResponse(code, message, requestId, details) {
+  return {
+    error: {
+      code,
+      message,
+      ...details && { details }
+    },
+    ...requestId && { requestId },
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
 var CriterionServer = class {
   app;
   engine;
@@ -471,6 +483,7 @@ var CriterionServer = class {
   metricsOptions;
   openApiOptions;
   openApiSpec = null;
+  startTime;
   constructor(options) {
     this.app = new Hono();
     this.engine = new Engine();
@@ -479,6 +492,7 @@ var CriterionServer = class {
     this.hooks = options.hooks ?? {};
     this.metricsOptions = options.metrics ?? {};
     this.openApiOptions = options.openapi ?? {};
+    this.startTime = /* @__PURE__ */ new Date();
     if (this.metricsOptions.enabled) {
       this.metricsCollector = new MetricsCollector(this.metricsOptions);
     }
@@ -505,11 +519,32 @@ var CriterionServer = class {
     this.app.get("/", (c) => {
       return c.json({
         name: "Criterion Server",
-        version: "0.1.0",
+        version: SERVER_VERSION,
         decisions: this.decisions.size,
-        metrics: this.metricsCollector !== null
+        docs: "/docs",
+        health: "/health"
       });
     });
+    this.app.get("/health", (c) => {
+      const uptime = Math.floor((Date.now() - this.startTime.getTime()) / 1e3);
+      const response = {
+        status: "healthy",
+        version: SERVER_VERSION,
+        uptime,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        checks: {
+          decisions: {
+            status: this.decisions.size > 0 ? "healthy" : "degraded",
+            message: `${this.decisions.size} decision(s) registered`
+          },
+          engine: {
+            status: "healthy",
+            message: "Engine operational"
+          }
+        }
+      };
+      return c.json(response);
+    });
     if (this.metricsCollector) {
       const endpoint = this.metricsOptions.endpoint ?? "/metrics";
       this.app.get(endpoint, (c) => {
@@ -546,7 +581,10 @@ var CriterionServer = class {
       const id = c.req.param("id");
       const decision = this.decisions.get(id);
       if (!decision) {
-        return c.json({ error: `Decision not found: ${id}` }, 404);
+        return c.json(
+          createErrorResponse("DECISION_NOT_FOUND", `Decision not found: ${id}`),
+          404
+        );
       }
       const schema = extractDecisionSchema(decision);
       return c.json(schema);
@@ -555,34 +593,49 @@ var CriterionServer = class {
       const id = c.req.param("id");
       const decision = this.decisions.get(id);
       if (!decision) {
-        return c.json({ error: `Decision not found: ${id}` }, 404);
+        return c.json(
+          createErrorResponse("DECISION_NOT_FOUND", `Decision not found: ${id}`),
+          404
+        );
       }
       const schema = generateEndpointSchema(decision);
       return c.json(schema);
     });
     this.app.post("/decisions/:id", async (c) => {
       const id = c.req.param("id");
+      const requestId = generateRequestId();
       const decision = this.decisions.get(id);
       if (!decision) {
-        return c.json({ error: `Decision not found: ${id}` }, 404);
+        return c.json(
+          createErrorResponse("DECISION_NOT_FOUND", `Decision not found: ${id}`, requestId),
+          404
+        );
       }
       let body;
       try {
         body = await c.req.json();
       } catch {
-        return c.json({ error: "Invalid JSON body" }, 400);
+        return c.json(
+          createErrorResponse("INVALID_JSON", "Invalid JSON body", requestId),
+          400
+        );
       }
       if (body.input === void 0) {
-        return c.json({ error: "Missing 'input' in request body" }, 400);
+        return c.json(
+          createErrorResponse("MISSING_INPUT", "Missing 'input' in request body", requestId),
+          400
+        );
       }
       let profile = body.profile;
       if (!profile) {
         profile = this.profiles.get(id);
         if (!profile) {
           return c.json(
-            {
-              error: `No profile provided and no default profile for decision: ${id}`
-            },
+            createErrorResponse(
+              "MISSING_PROFILE",
+              `No profile provided and no default profile for decision: ${id}`,
+              requestId
+            ),
             400
           );
         }
@@ -591,7 +644,7 @@ var CriterionServer = class {
         decisionId: id,
         input: body.input,
         profile,
-        requestId: generateRequestId(),
+        requestId,
         timestamp: /* @__PURE__ */ new Date()
       };
       const startTime = performance.now();
@@ -635,13 +688,19 @@ var CriterionServer = class {
             status: "ERROR"
           });
         }
+        const err = error instanceof Error ? error : new Error(String(error));
         if (this.hooks.onError) {
-          await this.hooks.onError(
-            ctx,
-            error instanceof Error ? error : new Error(String(error))
-          );
+          await this.hooks.onError(ctx, err);
         }
-        throw error;
+        return c.json(
+          createErrorResponse(
+            "EVALUATION_ERROR",
+            err.message,
+            requestId,
+            { decisionId: id }
+          ),
+          500
+        );
       }
     });
     this.app.get("/docs", (c) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@criterionx/server",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "HTTP server for Criterion decisions with auto-generated docs",
   "type": "module",
   "main": "dist/index.js",
@@ -42,7 +42,7 @@
     "@hono/node-server": "^1.13.0",
     "hono": "^4.6.0",
     "zod-to-json-schema": "^3.24.0",
-    "@criterionx/core": "0.3.1"
+    "@criterionx/core": "0.3.2"
   },
   "peerDependencies": {
     "zod": "^3.22.0"