@parsrun/server 0.1.0

package/README.md

@@ -0,0 +1,142 @@
+# @parsrun/server
+
+Edge-compatible, multi-tenant server framework for Pars built on Hono.
+
+## Features
+
+- **Edge-First**: Cloudflare Workers, Deno Deploy, Vercel Edge
+- **Multi-Tenant**: RLS (Row-Level Security), tenant context
+- **RBAC**: Role-based access control
+- **Modular**: Dynamic module loading
+- **Health Checks**: Kubernetes-ready health endpoints
+
+## Installation
+
+```bash
+pnpm add @parsrun/server hono
+```
+
+## Quick Start
+
+```typescript
+import { createApp, createContext } from '@parsrun/server';
+
+const app = createApp({
+  name: 'my-api',
+  version: '1.0.0',
+});
+
+app.get('/', (c) => c.json({ status: 'ok' }));
+
+export default app;
+```
+
+## API Overview
+
+### App Creation
+
+```typescript
+import { createApp } from '@parsrun/server';
+
+const app = createApp({
+  name: 'my-api',
+  version: '1.0.0',
+  cors: true,
+  logging: true,
+});
+```
+
+### Context & Middleware
+
+```typescript
+import { createContext, withTenant } from '@parsrun/server/context';
+
+// Tenant-aware context
+app.use(withTenant());
+
+app.get('/data', (c) => {
+  const tenantId = c.get('tenantId');
+  // ...
+});
+```
+
+### Row-Level Security (RLS)
+
+```typescript
+import { createRLS } from '@parsrun/server/rls';
+
+const rls = createRLS({
+  tenantColumn: 'tenant_id',
+  userColumn: 'user_id',
+});
+
+// Apply RLS to queries
+const query = rls.apply(baseQuery, context);
+```
+
+### RBAC
+
+```typescript
+import { createRBAC, requireRole, requirePermission } from '@parsrun/server/rbac';
+
+const rbac = createRBAC({
+  roles: {
+    admin: ['users:*', 'settings:*'],
+    member: ['users:read', 'content:*'],
+  },
+});
+
+app.get('/admin', requireRole('admin'), handler);
+app.delete('/users/:id', requirePermission('users:delete'), handler);
+```
+
+### Health Checks
+
+```typescript
+import { createHealthRoutes } from '@parsrun/server/health';
+
+app.route('/health', createHealthRoutes({
+  checks: {
+    database: async () => ({ status: 'ok' }),
+    cache: async () => ({ status: 'ok' }),
+  },
+}));
+```
+
+### Module Loader
+
+```typescript
+import { createModuleLoader } from '@parsrun/server/module-loader';
+
+const loader = createModuleLoader({
+  modulesDir: './modules',
+  autoload: true,
+});
+
+await loader.loadModules(app);
+```
+
+### Validation
+
+```typescript
+import { validate, schemas } from '@parsrun/server/validation';
+
+app.post('/users', validate(schemas.createUser), handler);
+```
+
+## Exports
+
+```typescript
+import { ... } from '@parsrun/server';            // Main exports
+import { ... } from '@parsrun/server/app';        // App creation
+import { ... } from '@parsrun/server/context';    // Context utilities
+import { ... } from '@parsrun/server/rls';        // Row-level security
+import { ... } from '@parsrun/server/rbac';       // Role-based access
+import { ... } from '@parsrun/server/health';     // Health checks
+import { ... } from '@parsrun/server/middleware'; // Middleware
+import { ... } from '@parsrun/server/validation'; // Validation
+```
+
+## License
+
+MIT

package/dist/app.d.ts

@@ -0,0 +1,87 @@
+import * as hono from 'hono';
+import { ServerConfig, HonoApp } from './context.js';
+import '@parsrun/core';
+
+/**
+ * Extended server options
+ */
+interface CreateServerOptions extends ServerConfig {
+    /** Enable request logging */
+    logging?: boolean;
+    /** Enable request ID generation */
+    requestId?: boolean;
+    /** Base path for all routes */
+    basePath?: string;
+    /** Strict mode - trailing slashes matter */
+    strict?: boolean;
+}
+/**
+ * Create a new Pars server instance
+ *
+ * @example
+ * ```typescript
+ * const app = createServer({
+ *   database: db,
+ *   cors: { origin: '*' },
+ *   logging: true,
+ * });
+ *
+ * app.get('/health', (c) => c.json({ status: 'ok' }));
+ *
+ * export default app;
+ * ```
+ */
+declare function createServer(options: CreateServerOptions): HonoApp;
+/**
+ * Create a router (sub-app) with shared context
+ *
+ * @example
+ * ```typescript
+ * const usersRouter = createRouter();
+ *
+ * usersRouter.get('/', async (c) => {
+ *   const users = await getUsers(c.get('db'));
+ *   return c.json(success(users));
+ * });
+ *
+ * usersRouter.post('/', async (c) => {
+ *   // ...
+ * });
+ *
+ * app.route('/api/users', usersRouter);
+ * ```
+ */
+declare function createRouter(): HonoApp;
+/**
+ * Create a versioned API router
+ *
+ * @example
+ * ```typescript
+ * const v1 = createVersionedRouter('v1');
+ * v1.get('/users', handler);
+ *
+ * app.route('/api', v1); // Results in /api/v1/users
+ * ```
+ */
+declare function createVersionedRouter(version: string): HonoApp;
+/**
+ * Create a module router with prefix
+ *
+ * @example
+ * ```typescript
+ * const inventoryModule = createModuleRouter('inventory', {
+ *   routes: (router) => {
+ *     router.get('/items', listItems);
+ *     router.post('/items', createItem);
+ *   },
+ * });
+ *
+ * app.route('/api', inventoryModule);
+ * ```
+ */
+declare function createModuleRouter(moduleName: string, options: {
+    routes: (router: HonoApp) => void;
+    middleware?: Array<(c: hono.Context, next: () => Promise<void>) => Promise<Response | void>>;
+}): HonoApp;
+
+export { type CreateServerOptions, createModuleRouter, createRouter, createServer, createVersionedRouter };

package/dist/app.js

@@ -0,0 +1,59 @@
+// src/app.ts
+import { Hono } from "hono";
+import { createLogger } from "@parsrun/core";
+
+// src/context.ts
+function generateRequestId() {
+  return crypto.randomUUID();
+}
+
+// src/app.ts
+function createServer(options) {
+  const app = new Hono({
+    strict: options.strict ?? false
+  });
+  const logger = options.logger ?? createLogger({ name: "pars-server" });
+  app.use("*", async (c, next) => {
+    c.set("db", options.database);
+    c.set("config", options);
+    c.set("logger", logger);
+    c.set("enabledModules", /* @__PURE__ */ new Set());
+    c.set("cookiePrefix", options.cookiePrefix);
+    c.set("custom", options.custom ?? {});
+    if (options.requestId !== false) {
+      const requestId = c.req.header("x-request-id") ?? generateRequestId();
+      c.set("requestId", requestId);
+      c.header("x-request-id", requestId);
+    }
+    await next();
+  });
+  return app;
+}
+function createRouter() {
+  return new Hono();
+}
+function createVersionedRouter(version) {
+  const router = new Hono();
+  const versionedRouter = new Hono();
+  versionedRouter.route(`/${version}`, router);
+  return versionedRouter;
+}
+function createModuleRouter(moduleName, options) {
+  const moduleRouter = new Hono();
+  if (options.middleware) {
+    for (const mw of options.middleware) {
+      moduleRouter.use("*", mw);
+    }
+  }
+  options.routes(moduleRouter);
+  const wrappedRouter = new Hono();
+  wrappedRouter.route(`/${moduleName}`, moduleRouter);
+  return wrappedRouter;
+}
+export {
+  createModuleRouter,
+  createRouter,
+  createServer,
+  createVersionedRouter
+};
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/app.ts","../src/context.ts"],"sourcesContent":["/**\n * @parsrun/server - App Factory\n * Create and configure Hono server instances\n */\n\nimport { Hono } from \"hono\";\nimport { createLogger } from \"@parsrun/core\";\nimport type {\n  ServerConfig,\n  ServerContextVariables,\n  HonoApp,\n} from \"./context.js\";\nimport { generateRequestId } from \"./context.js\";\n\n/**\n * Extended server options\n */\nexport interface CreateServerOptions extends ServerConfig {\n  /** Enable request logging */\n  logging?: boolean;\n  /** Enable request ID generation */\n  requestId?: boolean;\n  /** Base path for all routes */\n  basePath?: string;\n  /** Strict mode - trailing slashes matter */\n  strict?: boolean;\n}\n\n/**\n * Create a new Pars server instance\n *\n * @example\n * ```typescript\n * const app = createServer({\n *   database: db,\n *   cors: { origin: '*' },\n *   logging: true,\n * });\n *\n * app.get('/health', (c) => c.json({ status: 'ok' }));\n *\n * export default app;\n * ```\n */\nexport function createServer(options: CreateServerOptions): HonoApp {\n  const app = new Hono<{ Variables: ServerContextVariables }>({\n    strict: options.strict ?? false,\n  });\n\n  const logger = options.logger ?? createLogger({ name: \"pars-server\" });\n\n  // Initialize context for all requests\n  app.use(\"*\", async (c, next) => {\n    // Set core context variables\n    c.set(\"db\", options.database);\n    c.set(\"config\", options);\n    c.set(\"logger\", logger);\n    c.set(\"enabledModules\", new Set<string>());\n    c.set(\"cookiePrefix\", options.cookiePrefix);\n    c.set(\"custom\", options.custom ?? {});\n\n    // Generate request ID if enabled\n    if (options.requestId !== false) {\n      const requestId = c.req.header(\"x-request-id\") ?? generateRequestId();\n      c.set(\"requestId\", requestId);\n      c.header(\"x-request-id\", requestId);\n    }\n\n    await next();\n  });\n\n  return app;\n}\n\n/**\n * Create a router (sub-app) with shared context\n *\n * @example\n * ```typescript\n * const usersRouter = createRouter();\n *\n * usersRouter.get('/', async (c) => {\n *   const users = await getUsers(c.get('db'));\n *   return c.json(success(users));\n * });\n *\n * usersRouter.post('/', async (c) => {\n *   // ...\n * });\n *\n * app.route('/api/users', usersRouter);\n * ```\n */\nexport function createRouter(): HonoApp {\n  return new Hono<{ Variables: ServerContextVariables }>();\n}\n\n/**\n * Create a versioned API router\n *\n * @example\n * ```typescript\n * const v1 = createVersionedRouter('v1');\n * v1.get('/users', handler);\n *\n * app.route('/api', v1); // Results in /api/v1/users\n * ```\n */\nexport function createVersionedRouter(version: string): HonoApp {\n  const router = new Hono<{ Variables: ServerContextVariables }>();\n\n  // Add version to all routes\n  const versionedRouter = new Hono<{ Variables: ServerContextVariables }>();\n  versionedRouter.route(`/${version}`, router);\n\n  return versionedRouter;\n}\n\n/**\n * Create a module router with prefix\n *\n * @example\n * ```typescript\n * const inventoryModule = createModuleRouter('inventory', {\n *   routes: (router) => {\n *     router.get('/items', listItems);\n *     router.post('/items', createItem);\n *   },\n * });\n *\n * app.route('/api', inventoryModule);\n * ```\n */\nexport function createModuleRouter(\n  moduleName: string,\n  options: {\n    routes: (router: HonoApp) => void;\n    middleware?: Array<(c: import(\"hono\").Context, next: () => Promise<void>) => Promise<Response | void>>;\n  }\n): HonoApp {\n  const moduleRouter = new Hono<{ Variables: ServerContextVariables }>();\n\n  // Apply module-specific middleware\n  if (options.middleware) {\n    for (const mw of options.middleware) {\n      moduleRouter.use(\"*\", mw);\n    }\n  }\n\n  // Register routes\n  options.routes(moduleRouter);\n\n  // Wrap in module path\n  const wrappedRouter = new Hono<{ Variables: ServerContextVariables }>();\n  wrappedRouter.route(`/${moduleName}`, moduleRouter);\n\n  return wrappedRouter;\n}\n","/**\n * @parsrun/server - Server Context\n * Type definitions for server context and configuration\n */\n\nimport type { Logger } from \"@parsrun/core\";\n\n/**\n * Database adapter interface\n * Implement this for your database (Drizzle, Prisma, etc.)\n */\nexport interface DatabaseAdapter {\n  /** Execute raw SQL query */\n  execute(sql: string): Promise<unknown>;\n  /** Check connection */\n  ping?(): Promise<boolean>;\n}\n\n/**\n * Module manifest for registering modules\n */\nexport interface ModuleManifest {\n  /** Unique module name */\n  name: string;\n  /** Module version */\n  version: string;\n  /** Module description */\n  description: string;\n  /** Required permissions for this module */\n  permissions: Record<string, string[]>;\n  /** Module dependencies (other module names) */\n  dependencies?: string[];\n  /** Register routes for this module */\n  registerRoutes: (app: HonoApp) => void;\n  /** Called when module is enabled */\n  onEnable?: () => Promise<void>;\n  /** Called when module is disabled */\n  onDisable?: () => Promise<void>;\n}\n\n/**\n * Server configuration\n */\nexport interface ServerConfig {\n  /** Database adapter */\n  database: DatabaseAdapter;\n  /** CORS configuration */\n  cors?: CorsConfig;\n  /** Base path for API */\n  basePath?: string;\n  /** Cookie prefix for all cookies */\n  cookiePrefix?: string;\n  /** Logger instance */\n  logger?: Logger;\n  /** Custom context data */\n  custom?: Record<string, unknown>;\n}\n\n/**\n * CORS configuration\n */\nexport interface CorsConfig {\n  /** Allowed origins */\n  origin: string | string[] | ((origin: string) => boolean);\n  /** Allow credentials */\n  credentials?: boolean;\n  /** Allowed methods */\n  methods?: string[];\n  /** Allowed headers */\n  allowedHeaders?: string[];\n  /** Exposed headers */\n  exposedHeaders?: string[];\n  /** Max age in seconds */\n  maxAge?: number;\n}\n\n/**\n * User information in context\n */\nexport interface ContextUser {\n  id: string;\n  email: string | undefined;\n  tenantId: string | undefined;\n  role: string | undefined;\n  permissions: string[];\n}\n\n/**\n * Tenant information in context\n */\nexport interface ContextTenant {\n  id: string;\n  slug: string | undefined;\n  name: string | undefined;\n  status: string;\n}\n\n/**\n * Server context variables\n * Available in Hono context via c.get()\n */\nexport interface ServerContextVariables {\n  /** Database adapter */\n  db: DatabaseAdapter;\n  /** Server configuration */\n  config: ServerConfig;\n  /** Enabled modules set */\n  enabledModules: Set<string>;\n  /** Current user (if authenticated) */\n  user: ContextUser | undefined;\n  /** Current tenant (if resolved) */\n  tenant: ContextTenant | undefined;\n  /** Request logger */\n  logger: Logger;\n  /** Request ID */\n  requestId: string;\n  /** Cookie prefix */\n  cookiePrefix: string | undefined;\n  /** Custom context data */\n  custom: Record<string, unknown>;\n}\n\n/**\n * Hono app type with server context\n */\nexport type HonoApp = import(\"hono\").Hono<{ Variables: ServerContextVariables }>;\n\n/**\n * Hono context type with server context\n */\nexport type HonoContext = import(\"hono\").Context<{ Variables: ServerContextVariables }>;\n\n/**\n * Middleware next function\n */\nexport type HonoNext = () => Promise<void>;\n\n/**\n * Middleware function type\n */\nexport type Middleware = (c: HonoContext, next: HonoNext) => Promise<Response | void>;\n\n/**\n * Route handler function type\n */\nexport type RouteHandler = (c: HonoContext) => Promise<Response> | Response;\n\n/**\n * Permission check input\n */\nexport interface PermissionCheck {\n  /** Resource name (e.g., \"users\", \"items\") */\n  resource: string;\n  /** Action name (e.g., \"read\", \"create\", \"update\", \"delete\") */\n  action: string;\n  /** Permission scope */\n  scope?: \"tenant\" | \"global\" | \"own\";\n}\n\n/**\n * Permission definition\n */\nexport interface PermissionDefinition {\n  /** Permission name (e.g., \"users:read\") */\n  name: string;\n  /** Resource part */\n  resource: string;\n  /** Action part */\n  action: string;\n  /** Description */\n  description?: string;\n  /** Scope */\n  scope?: \"tenant\" | \"global\" | \"own\";\n}\n\n/**\n * Role definition\n */\nexport interface RoleDefinition {\n  /** Role name */\n  name: string;\n  /** Display name */\n  displayName?: string;\n  /** Description */\n  description?: string;\n  /** Permissions assigned to this role */\n  permissions: string[];\n  /** Is this a system role */\n  isSystem?: boolean;\n}\n\n/**\n * Standard API response structure\n */\nexport interface ApiResponse<T = unknown> {\n  success: boolean;\n  data?: T;\n  error?: {\n    code: string;\n    message: string;\n    details?: Record<string, unknown> | undefined;\n  };\n  meta?: {\n    page?: number | undefined;\n    limit?: number | undefined;\n    total?: number | undefined;\n    requestId?: string | undefined;\n  } | undefined;\n}\n\n/**\n * Create a success response\n */\nexport function success<T>(data: T, meta?: ApiResponse[\"meta\"]): ApiResponse<T> {\n  return {\n    success: true,\n    data,\n    meta: meta ?? undefined,\n  };\n}\n\n/**\n * Create an error response\n */\nexport function error(\n  code: string,\n  message: string,\n  details?: Record<string, unknown>\n): ApiResponse<never> {\n  return {\n    success: false,\n    error: { code, message, details: details ?? undefined },\n  };\n}\n\n/**\n * Generate a request ID\n */\nexport function generateRequestId(): string {\n  return crypto.randomUUID();\n}\n"],"mappings":";AAKA,SAAS,YAAY;AACrB,SAAS,oBAAoB;;;ACwOtB,SAAS,oBAA4B;AAC1C,SAAO,OAAO,WAAW;AAC3B;;;ADpMO,SAAS,aAAa,SAAuC;AAClE,QAAM,MAAM,IAAI,KAA4C;AAAA,IAC1D,QAAQ,QAAQ,UAAU;AAAA,EAC5B,CAAC;AAED,QAAM,SAAS,QAAQ,UAAU,aAAa,EAAE,MAAM,cAAc,CAAC;AAGrE,MAAI,IAAI,KAAK,OAAO,GAAG,SAAS;AAE9B,MAAE,IAAI,MAAM,QAAQ,QAAQ;AAC5B,MAAE,IAAI,UAAU,OAAO;AACvB,MAAE,IAAI,UAAU,MAAM;AACtB,MAAE,IAAI,kBAAkB,oBAAI,IAAY,CAAC;AACzC,MAAE,IAAI,gBAAgB,QAAQ,YAAY;AAC1C,MAAE,IAAI,UAAU,QAAQ,UAAU,CAAC,CAAC;AAGpC,QAAI,QAAQ,cAAc,OAAO;AAC/B,YAAM,YAAY,EAAE,IAAI,OAAO,cAAc,KAAK,kBAAkB;AACpE,QAAE,IAAI,aAAa,SAAS;AAC5B,QAAE,OAAO,gBAAgB,SAAS;AAAA,IACpC;AAEA,UAAM,KAAK;AAAA,EACb,CAAC;AAED,SAAO;AACT;AAqBO,SAAS,eAAwB;AACtC,SAAO,IAAI,KAA4C;AACzD;AAaO,SAAS,sBAAsB,SAA0B;AAC9D,QAAM,SAAS,IAAI,KAA4C;AAG/D,QAAM,kBAAkB,IAAI,KAA4C;AACxE,kBAAgB,MAAM,IAAI,OAAO,IAAI,MAAM;AAE3C,SAAO;AACT;AAiBO,SAAS,mBACd,YACA,SAIS;AACT,QAAM,eAAe,IAAI,KAA4C;AAGrE,MAAI,QAAQ,YAAY;AACtB,eAAW,MAAM,QAAQ,YAAY;AACnC,mBAAa,IAAI,KAAK,EAAE;AAAA,IAC1B;AAAA,EACF;AAGA,UAAQ,OAAO,YAAY;AAG3B,QAAM,gBAAgB,IAAI,KAA4C;AACtE,gBAAc,MAAM,IAAI,UAAU,IAAI,YAAY;AAElD,SAAO;AACT;","names":[]}

package/dist/context.d.ts

@@ -0,0 +1,208 @@
+import * as hono from 'hono';
+import { Logger } from '@parsrun/core';
+
+/**
+ * Database adapter interface
+ * Implement this for your database (Drizzle, Prisma, etc.)
+ */
+interface DatabaseAdapter {
+    /** Execute raw SQL query */
+    execute(sql: string): Promise<unknown>;
+    /** Check connection */
+    ping?(): Promise<boolean>;
+}
+/**
+ * Module manifest for registering modules
+ */
+interface ModuleManifest {
+    /** Unique module name */
+    name: string;
+    /** Module version */
+    version: string;
+    /** Module description */
+    description: string;
+    /** Required permissions for this module */
+    permissions: Record<string, string[]>;
+    /** Module dependencies (other module names) */
+    dependencies?: string[];
+    /** Register routes for this module */
+    registerRoutes: (app: HonoApp) => void;
+    /** Called when module is enabled */
+    onEnable?: () => Promise<void>;
+    /** Called when module is disabled */
+    onDisable?: () => Promise<void>;
+}
+/**
+ * Server configuration
+ */
+interface ServerConfig {
+    /** Database adapter */
+    database: DatabaseAdapter;
+    /** CORS configuration */
+    cors?: CorsConfig;
+    /** Base path for API */
+    basePath?: string;
+    /** Cookie prefix for all cookies */
+    cookiePrefix?: string;
+    /** Logger instance */
+    logger?: Logger;
+    /** Custom context data */
+    custom?: Record<string, unknown>;
+}
+/**
+ * CORS configuration
+ */
+interface CorsConfig {
+    /** Allowed origins */
+    origin: string | string[] | ((origin: string) => boolean);
+    /** Allow credentials */
+    credentials?: boolean;
+    /** Allowed methods */
+    methods?: string[];
+    /** Allowed headers */
+    allowedHeaders?: string[];
+    /** Exposed headers */
+    exposedHeaders?: string[];
+    /** Max age in seconds */
+    maxAge?: number;
+}
+/**
+ * User information in context
+ */
+interface ContextUser {
+    id: string;
+    email: string | undefined;
+    tenantId: string | undefined;
+    role: string | undefined;
+    permissions: string[];
+}
+/**
+ * Tenant information in context
+ */
+interface ContextTenant {
+    id: string;
+    slug: string | undefined;
+    name: string | undefined;
+    status: string;
+}
+/**
+ * Server context variables
+ * Available in Hono context via c.get()
+ */
+interface ServerContextVariables {
+    /** Database adapter */
+    db: DatabaseAdapter;
+    /** Server configuration */
+    config: ServerConfig;
+    /** Enabled modules set */
+    enabledModules: Set<string>;
+    /** Current user (if authenticated) */
+    user: ContextUser | undefined;
+    /** Current tenant (if resolved) */
+    tenant: ContextTenant | undefined;
+    /** Request logger */
+    logger: Logger;
+    /** Request ID */
+    requestId: string;
+    /** Cookie prefix */
+    cookiePrefix: string | undefined;
+    /** Custom context data */
+    custom: Record<string, unknown>;
+}
+/**
+ * Hono app type with server context
+ */
+type HonoApp = hono.Hono<{
+    Variables: ServerContextVariables;
+}>;
+/**
+ * Hono context type with server context
+ */
+type HonoContext = hono.Context<{
+    Variables: ServerContextVariables;
+}>;
+/**
+ * Middleware next function
+ */
+type HonoNext = () => Promise<void>;
+/**
+ * Middleware function type
+ */
+type Middleware = (c: HonoContext, next: HonoNext) => Promise<Response | void>;
+/**
+ * Route handler function type
+ */
+type RouteHandler = (c: HonoContext) => Promise<Response> | Response;
+/**
+ * Permission check input
+ */
+interface PermissionCheck {
+    /** Resource name (e.g., "users", "items") */
+    resource: string;
+    /** Action name (e.g., "read", "create", "update", "delete") */
+    action: string;
+    /** Permission scope */
+    scope?: "tenant" | "global" | "own";
+}
+/**
+ * Permission definition
+ */
+interface PermissionDefinition {
+    /** Permission name (e.g., "users:read") */
+    name: string;
+    /** Resource part */
+    resource: string;
+    /** Action part */
+    action: string;
+    /** Description */
+    description?: string;
+    /** Scope */
+    scope?: "tenant" | "global" | "own";
+}
+/**
+ * Role definition
+ */
+interface RoleDefinition {
+    /** Role name */
+    name: string;
+    /** Display name */
+    displayName?: string;
+    /** Description */
+    description?: string;
+    /** Permissions assigned to this role */
+    permissions: string[];
+    /** Is this a system role */
+    isSystem?: boolean;
+}
+/**
+ * Standard API response structure
+ */
+interface ApiResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    };
+    meta?: {
+        page?: number | undefined;
+        limit?: number | undefined;
+        total?: number | undefined;
+        requestId?: string | undefined;
+    } | undefined;
+}
+/**
+ * Create a success response
+ */
+declare function success<T>(data: T, meta?: ApiResponse["meta"]): ApiResponse<T>;
+/**
+ * Create an error response
+ */
+declare function error(code: string, message: string, details?: Record<string, unknown>): ApiResponse<never>;
+/**
+ * Generate a request ID
+ */
+declare function generateRequestId(): string;
+
+export { type ApiResponse, type ContextTenant, type ContextUser, type CorsConfig, type DatabaseAdapter, type HonoApp, type HonoContext, type HonoNext, type Middleware, type ModuleManifest, type PermissionCheck, type PermissionDefinition, type RoleDefinition, type RouteHandler, type ServerConfig, type ServerContextVariables, error, generateRequestId, success };

package/dist/context.js

@@ -0,0 +1,23 @@
+// src/context.ts
+function success(data, meta) {
+  return {
+    success: true,
+    data,
+    meta: meta ?? void 0
+  };
+}
+function error(code, message, details) {
+  return {
+    success: false,
+    error: { code, message, details: details ?? void 0 }
+  };
+}
+function generateRequestId() {
+  return crypto.randomUUID();
+}
+export {
+  error,
+  generateRequestId,
+  success
+};
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts"],"sourcesContent":["/**\n * @parsrun/server - Server Context\n * Type definitions for server context and configuration\n */\n\nimport type { Logger } from \"@parsrun/core\";\n\n/**\n * Database adapter interface\n * Implement this for your database (Drizzle, Prisma, etc.)\n */\nexport interface DatabaseAdapter {\n  /** Execute raw SQL query */\n  execute(sql: string): Promise<unknown>;\n  /** Check connection */\n  ping?(): Promise<boolean>;\n}\n\n/**\n * Module manifest for registering modules\n */\nexport interface ModuleManifest {\n  /** Unique module name */\n  name: string;\n  /** Module version */\n  version: string;\n  /** Module description */\n  description: string;\n  /** Required permissions for this module */\n  permissions: Record<string, string[]>;\n  /** Module dependencies (other module names) */\n  dependencies?: string[];\n  /** Register routes for this module */\n  registerRoutes: (app: HonoApp) => void;\n  /** Called when module is enabled */\n  onEnable?: () => Promise<void>;\n  /** Called when module is disabled */\n  onDisable?: () => Promise<void>;\n}\n\n/**\n * Server configuration\n */\nexport interface ServerConfig {\n  /** Database adapter */\n  database: DatabaseAdapter;\n  /** CORS configuration */\n  cors?: CorsConfig;\n  /** Base path for API */\n  basePath?: string;\n  /** Cookie prefix for all cookies */\n  cookiePrefix?: string;\n  /** Logger instance */\n  logger?: Logger;\n  /** Custom context data */\n  custom?: Record<string, unknown>;\n}\n\n/**\n * CORS configuration\n */\nexport interface CorsConfig {\n  /** Allowed origins */\n  origin: string | string[] | ((origin: string) => boolean);\n  /** Allow credentials */\n  credentials?: boolean;\n  /** Allowed methods */\n  methods?: string[];\n  /** Allowed headers */\n  allowedHeaders?: string[];\n  /** Exposed headers */\n  exposedHeaders?: string[];\n  /** Max age in seconds */\n  maxAge?: number;\n}\n\n/**\n * User information in context\n */\nexport interface ContextUser {\n  id: string;\n  email: string | undefined;\n  tenantId: string | undefined;\n  role: string | undefined;\n  permissions: string[];\n}\n\n/**\n * Tenant information in context\n */\nexport interface ContextTenant {\n  id: string;\n  slug: string | undefined;\n  name: string | undefined;\n  status: string;\n}\n\n/**\n * Server context variables\n * Available in Hono context via c.get()\n */\nexport interface ServerContextVariables {\n  /** Database adapter */\n  db: DatabaseAdapter;\n  /** Server configuration */\n  config: ServerConfig;\n  /** Enabled modules set */\n  enabledModules: Set<string>;\n  /** Current user (if authenticated) */\n  user: ContextUser | undefined;\n  /** Current tenant (if resolved) */\n  tenant: ContextTenant | undefined;\n  /** Request logger */\n  logger: Logger;\n  /** Request ID */\n  requestId: string;\n  /** Cookie prefix */\n  cookiePrefix: string | undefined;\n  /** Custom context data */\n  custom: Record<string, unknown>;\n}\n\n/**\n * Hono app type with server context\n */\nexport type HonoApp = import(\"hono\").Hono<{ Variables: ServerContextVariables }>;\n\n/**\n * Hono context type with server context\n */\nexport type HonoContext = import(\"hono\").Context<{ Variables: ServerContextVariables }>;\n\n/**\n * Middleware next function\n */\nexport type HonoNext = () => Promise<void>;\n\n/**\n * Middleware function type\n */\nexport type Middleware = (c: HonoContext, next: HonoNext) => Promise<Response | void>;\n\n/**\n * Route handler function type\n */\nexport type RouteHandler = (c: HonoContext) => Promise<Response> | Response;\n\n/**\n * Permission check input\n */\nexport interface PermissionCheck {\n  /** Resource name (e.g., \"users\", \"items\") */\n  resource: string;\n  /** Action name (e.g., \"read\", \"create\", \"update\", \"delete\") */\n  action: string;\n  /** Permission scope */\n  scope?: \"tenant\" | \"global\" | \"own\";\n}\n\n/**\n * Permission definition\n */\nexport interface PermissionDefinition {\n  /** Permission name (e.g., \"users:read\") */\n  name: string;\n  /** Resource part */\n  resource: string;\n  /** Action part */\n  action: string;\n  /** Description */\n  description?: string;\n  /** Scope */\n  scope?: \"tenant\" | \"global\" | \"own\";\n}\n\n/**\n * Role definition\n */\nexport interface RoleDefinition {\n  /** Role name */\n  name: string;\n  /** Display name */\n  displayName?: string;\n  /** Description */\n  description?: string;\n  /** Permissions assigned to this role */\n  permissions: string[];\n  /** Is this a system role */\n  isSystem?: boolean;\n}\n\n/**\n * Standard API response structure\n */\nexport interface ApiResponse<T = unknown> {\n  success: boolean;\n  data?: T;\n  error?: {\n    code: string;\n    message: string;\n    details?: Record<string, unknown> | undefined;\n  };\n  meta?: {\n    page?: number | undefined;\n    limit?: number | undefined;\n    total?: number | undefined;\n    requestId?: string | undefined;\n  } | undefined;\n}\n\n/**\n * Create a success response\n */\nexport function success<T>(data: T, meta?: ApiResponse[\"meta\"]): ApiResponse<T> {\n  return {\n    success: true,\n    data,\n    meta: meta ?? undefined,\n  };\n}\n\n/**\n * Create an error response\n */\nexport function error(\n  code: string,\n  message: string,\n  details?: Record<string, unknown>\n): ApiResponse<never> {\n  return {\n    success: false,\n    error: { code, message, details: details ?? undefined },\n  };\n}\n\n/**\n * Generate a request ID\n */\nexport function generateRequestId(): string {\n  return crypto.randomUUID();\n}\n"],"mappings":";AAqNO,SAAS,QAAW,MAAS,MAA4C;AAC9E,SAAO;AAAA,IACL,SAAS;AAAA,IACT;AAAA,IACA,MAAM,QAAQ;AAAA,EAChB;AACF;AAKO,SAAS,MACd,MACA,SACA,SACoB;AACpB,SAAO;AAAA,IACL,SAAS;AAAA,IACT,OAAO,EAAE,MAAM,SAAS,SAAS,WAAW,OAAU;AAAA,EACxD;AACF;AAKO,SAAS,oBAA4B;AAC1C,SAAO,OAAO,WAAW;AAC3B;","names":[]}

package/dist/health.d.ts

@@ -0,0 +1,81 @@
+import * as hono_utils_http_status from 'hono/utils/http-status';
+import * as hono from 'hono';
+import { HonoApp, ServerContextVariables } from './context.js';
+import '@parsrun/core';
+
+/**
+ * Health check status
+ */
+type HealthStatus = "healthy" | "degraded" | "unhealthy";
+/**
+ * Health check result
+ */
+interface HealthCheckResult {
+    status: HealthStatus;
+    message?: string;
+    latency?: number;
+}
+/**
+ * Health check function
+ */
+type HealthCheck = () => Promise<HealthCheckResult> | HealthCheckResult;
+/**
+ * Health response
+ */
+interface HealthResponse {
+    status: HealthStatus;
+    timestamp: string;
+    uptime: number;
+    checks: Record<string, HealthCheckResult>;
+}
+/**
+ * Health check options
+ */
+interface HealthCheckOptions {
+    /** Custom health checks */
+    checks?: Record<string, HealthCheck>;
+    /** Include detailed info (disable in production) */
+    detailed?: boolean;
+}
+/**
+ * Create health check router
+ *
+ * @example
+ * ```typescript
+ * const health = createHealthRouter({
+ *   checks: {
+ *     redis: async () => {
+ *       await redis.ping();
+ *       return { status: 'healthy' };
+ *     },
+ *     external: async () => {
+ *       const res = await fetch('https://api.example.com/health');
+ *       return { status: res.ok ? 'healthy' : 'unhealthy' };
+ *     },
+ *   },
+ * });
+ *
+ * app.route('/health', health);
+ * // GET /health - Full health check
+ * // GET /health/live - Liveness probe
+ * // GET /health/ready - Readiness probe
+ * ```
+ */
+declare function createHealthRouter(options?: HealthCheckOptions): HonoApp;
+/**
+ * Simple health endpoint handler
+ *
+ * @example
+ * ```typescript
+ * app.get('/health', healthHandler);
+ * ```
+ */
+declare function healthHandler(c: hono.Context<{
+    Variables: ServerContextVariables;
+}>): Promise<Response & hono.TypedResponse<{
+    status: string;
+    timestamp: string;
+    uptime: number;
+}, hono_utils_http_status.ContentfulStatusCode, "json">>;
+
+export { type HealthCheck, type HealthCheckOptions, type HealthCheckResult, type HealthResponse, type HealthStatus, createHealthRouter, healthHandler };