@parsrun/server 0.1.0

package/dist/health.js

@@ -0,0 +1,112 @@
+// src/health.ts
+import { Hono } from "hono";
+var startTime = Date.now();
+async function checkDatabase(db) {
+  const start = Date.now();
+  try {
+    if (db.ping) {
+      await db.ping();
+    }
+    return {
+      status: "healthy",
+      latency: Date.now() - start
+    };
+  } catch (err) {
+    return {
+      status: "unhealthy",
+      message: err instanceof Error ? err.message : "Database connection failed",
+      latency: Date.now() - start
+    };
+  }
+}
+function aggregateStatus(checks) {
+  const statuses = Object.values(checks).map((c) => c.status);
+  if (statuses.some((s) => s === "unhealthy")) {
+    return "unhealthy";
+  }
+  if (statuses.some((s) => s === "degraded")) {
+    return "degraded";
+  }
+  return "healthy";
+}
+function createHealthRouter(options = {}) {
+  const router = new Hono();
+  const { checks = {}, detailed = true } = options;
+  router.get("/", async (c) => {
+    const db = c.get("db");
+    const results = {};
+    results["database"] = await checkDatabase(db);
+    const customCheckResults = await Promise.all(
+      Object.entries(checks).map(async ([name, check]) => {
+        try {
+          const result = await check();
+          return [name, result];
+        } catch (err) {
+          return [
+            name,
+            {
+              status: "unhealthy",
+              message: err instanceof Error ? err.message : "Check failed"
+            }
+          ];
+        }
+      })
+    );
+    for (const [name, result] of customCheckResults) {
+      results[name] = result;
+    }
+    const overallStatus = aggregateStatus(results);
+    const response = {
+      status: overallStatus,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      uptime: Math.floor((Date.now() - startTime) / 1e3),
+      checks: detailed ? results : {}
+    };
+    const statusCode = overallStatus === "healthy" ? 200 : overallStatus === "degraded" ? 200 : 503;
+    return c.json(response, statusCode);
+  });
+  router.get("/live", (c) => {
+    return c.json({
+      status: "ok",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  });
+  router.get("/ready", async (c) => {
+    const db = c.get("db");
+    const dbHealth = await checkDatabase(db);
+    if (dbHealth.status === "unhealthy") {
+      return c.json(
+        {
+          status: "not_ready",
+          reason: "database",
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        },
+        503
+      );
+    }
+    return c.json({
+      status: "ready",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  });
+  router.get("/startup", (c) => {
+    return c.json({
+      status: "started",
+      uptime: Math.floor((Date.now() - startTime) / 1e3),
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  });
+  return router;
+}
+async function healthHandler(c) {
+  return c.json({
+    status: "ok",
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    uptime: Math.floor((Date.now() - startTime) / 1e3)
+  });
+}
+export {
+  createHealthRouter,
+  healthHandler
+};
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/health.ts"],"sourcesContent":["/**\n * @parsrun/server - Health Check Endpoints\n * Kubernetes-compatible health and readiness probes\n */\n\nimport { Hono } from \"hono\";\nimport type { HonoApp, ServerContextVariables } from \"./context.js\";\n\n/**\n * Health check status\n */\nexport type HealthStatus = \"healthy\" | \"degraded\" | \"unhealthy\";\n\n/**\n * Health check result\n */\nexport interface HealthCheckResult {\n  status: HealthStatus;\n  message?: string;\n  latency?: number;\n}\n\n/**\n * Health check function\n */\nexport type HealthCheck = () => Promise<HealthCheckResult> | HealthCheckResult;\n\n/**\n * Health response\n */\nexport interface HealthResponse {\n  status: HealthStatus;\n  timestamp: string;\n  uptime: number;\n  checks: Record<string, HealthCheckResult>;\n}\n\n/**\n * Health check options\n */\nexport interface HealthCheckOptions {\n  /** Custom health checks */\n  checks?: Record<string, HealthCheck>;\n  /** Include detailed info (disable in production) */\n  detailed?: boolean;\n}\n\n// Track server start time\nconst startTime = Date.now();\n\n/**\n * Database health check\n */\nasync function checkDatabase(db: { ping?: () => Promise<boolean> }): Promise<HealthCheckResult> {\n  const start = Date.now();\n\n  try {\n    if (db.ping) {\n      await db.ping();\n    }\n    return {\n      status: \"healthy\",\n      latency: Date.now() - start,\n    };\n  } catch (err) {\n    return {\n      status: \"unhealthy\",\n      message: err instanceof Error ? err.message : \"Database connection failed\",\n      latency: Date.now() - start,\n    };\n  }\n}\n\n/**\n * Determine overall status from individual checks\n */\nfunction aggregateStatus(checks: Record<string, HealthCheckResult>): HealthStatus {\n  const statuses = Object.values(checks).map((c) => c.status);\n\n  if (statuses.some((s) => s === \"unhealthy\")) {\n    return \"unhealthy\";\n  }\n\n  if (statuses.some((s) => s === \"degraded\")) {\n    return \"degraded\";\n  }\n\n  return \"healthy\";\n}\n\n/**\n * Create health check router\n *\n * @example\n * ```typescript\n * const health = createHealthRouter({\n *   checks: {\n *     redis: async () => {\n *       await redis.ping();\n *       return { status: 'healthy' };\n *     },\n *     external: async () => {\n *       const res = await fetch('https://api.example.com/health');\n *       return { status: res.ok ? 'healthy' : 'unhealthy' };\n *     },\n *   },\n * });\n *\n * app.route('/health', health);\n * // GET /health - Full health check\n * // GET /health/live - Liveness probe\n * // GET /health/ready - Readiness probe\n * ```\n */\nexport function createHealthRouter(options: HealthCheckOptions = {}): HonoApp {\n  const router = new Hono<{ Variables: ServerContextVariables }>();\n  const { checks = {}, detailed = true } = options;\n\n  /**\n   * GET /health - Full health check\n   * Returns detailed status of all checks\n   */\n  router.get(\"/\", async (c) => {\n    const db = c.get(\"db\");\n    const results: Record<string, HealthCheckResult> = {};\n\n    // Run database check\n    results[\"database\"] = await checkDatabase(db);\n\n    // Run custom checks in parallel\n    const customCheckResults = await Promise.all(\n      Object.entries(checks).map(async ([name, check]) => {\n        try {\n          const result = await check();\n          return [name, result] as const;\n        } catch (err) {\n          return [\n            name,\n            {\n              status: \"unhealthy\" as const,\n              message: err instanceof Error ? err.message : \"Check failed\",\n            },\n          ] as const;\n        }\n      })\n    );\n\n    for (const [name, result] of customCheckResults) {\n      results[name] = result;\n    }\n\n    const overallStatus = aggregateStatus(results);\n    const response: HealthResponse = {\n      status: overallStatus,\n      timestamp: new Date().toISOString(),\n      uptime: Math.floor((Date.now() - startTime) / 1000),\n      checks: detailed ? results : {},\n    };\n\n    const statusCode = overallStatus === \"healthy\" ? 200 : overallStatus === \"degraded\" ? 200 : 503;\n\n    return c.json(response, statusCode as 200);\n  });\n\n  /**\n   * GET /health/live - Liveness probe\n   * Kubernetes liveness probe - returns 200 if server is running\n   */\n  router.get(\"/live\", (c) => {\n    return c.json({\n      status: \"ok\",\n      timestamp: new Date().toISOString(),\n    });\n  });\n\n  /**\n   * GET /health/ready - Readiness probe\n   * Kubernetes readiness probe - returns 200 if server can handle traffic\n   */\n  router.get(\"/ready\", async (c) => {\n    const db = c.get(\"db\");\n\n    // Check database connection\n    const dbHealth = await checkDatabase(db);\n\n    if (dbHealth.status === \"unhealthy\") {\n      return c.json(\n        {\n          status: \"not_ready\",\n          reason: \"database\",\n          timestamp: new Date().toISOString(),\n        },\n        503\n      );\n    }\n\n    return c.json({\n      status: \"ready\",\n      timestamp: new Date().toISOString(),\n    });\n  });\n\n  /**\n   * GET /health/startup - Startup probe\n   * For slow-starting containers\n   */\n  router.get(\"/startup\", (c) => {\n    return c.json({\n      status: \"started\",\n      uptime: Math.floor((Date.now() - startTime) / 1000),\n      timestamp: new Date().toISOString(),\n    });\n  });\n\n  return router;\n}\n\n/**\n * Simple health endpoint handler\n *\n * @example\n * ```typescript\n * app.get('/health', healthHandler);\n * ```\n */\nexport async function healthHandler(c: import(\"hono\").Context<{ Variables: ServerContextVariables }>) {\n  return c.json({\n    status: \"ok\",\n    timestamp: new Date().toISOString(),\n    uptime: Math.floor((Date.now() - startTime) / 1000),\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { CreateServerOptions, createModuleRouter, createRouter, createServer, createVersionedRouter } from './app.js';
+export { ApiResponse, ContextTenant, ContextUser, CorsConfig, DatabaseAdapter, HonoApp, HonoContext, HonoNext, Middleware, ModuleManifest, PermissionCheck, PermissionDefinition, RoleDefinition, RouteHandler, ServerConfig, ServerContextVariables, error, generateRequestId, success } from './context.js';
+export { ModuleLoader, ModuleLoaderOptions, createModuleLoader, defineModule } from './module-loader.js';
+export { RLSConfig, RLSError, RLSManager, createRLSManager, generateDisableRLS, generateRLSPolicy, rlsMiddleware } from './rls.js';
+export { InMemoryRBAC, PermissionChecker, RBACService, StandardRoles, createInMemoryRBAC, createPermission, createRBACService, crudPermissions, parsePermission, requireAnyPermission, requireAnyRole, requireAuth, requirePermission, requireRole, requireTenantMember } from './rbac.js';
+export { ApiError, AuthMiddlewareOptions, BadRequestError, ConflictError, CsrfOptions, ErrorHandlerOptions, ForbiddenError, InternalError, JwtPayload, JwtVerifier, MemoryRateLimitStorage, NotFoundError, QuotaCheckResult, QuotaEnforcementOptions, QuotaExceededError, QuotaManagerLike, RateLimitError, RateLimitOptions, RateLimitStorage, RequestLoggerOptions, ServiceUnavailableError, UnauthorizedError, UsageServiceLike, UsageTrackingOptions, ValidationError, auth, cors, createAuthMiddleware, createQuotaEnforcement, createRateLimiter, createUsageTracking, csrf, doubleSubmitCookie, errorHandler, multiQuotaEnforcement, notFoundHandler, optionalAuth, quotaEnforcement, rateLimit, requestLogger, usageTracking } from './middleware/index.js';
+export { Infer, ValidateOptions, ValidationTarget, validate, validateBody, validateHeaders, validateParams, validateQuery } from './validation/index.js';
+export { CursorPaginatedResponse, CursorPaginationMeta, CursorPaginationParams, PaginatedResponse, PaginationMeta, PaginationOptions, PaginationParams, accepted, createPaginationMeta, created, cursorPaginate, download, json, jsonError, jsonWithMeta, noContent, paginate, parseCursorPagination, parsePagination, redirect, setPaginationHeaders, sse, stream } from './utils/index.js';
+export { HealthCheck, HealthCheckOptions, HealthCheckResult, HealthResponse, HealthStatus, createHealthRouter, healthHandler } from './health.js';
+export { DateRangeQuery, dateRangeQuery as DateRangeQuerySchema, PaginationQuery, paginationQuery as PaginationQuerySchema, SearchQuery, searchQuery as SearchQuerySchema, Type, UuidParam, uuidParam as UuidParamSchema, type } from '@parsrun/types';
+import 'hono';
+import '@parsrun/core';
+import 'hono/utils/types';
+import '@parsrun/core/transports';
+import 'hono/utils/http-status';