@getvision/server 0.4.3-d4c761e-develop → 0.4.4-44d79d9-develop

package/dist/service.js

@@ -0,0 +1,341 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/service.ts
+import { generateTemplate } from "@getvision/core";
+import {
+  ValidationError,
+  createValidationErrorResponse,
+  UniversalValidator
+} from "@getvision/core";
+import { getVisionContext } from "./vision-app";
+import { eventRegistry } from "./event-registry";
+import { rateLimiter } from "hono-rate-limiter";
+function parseWindowMs(window) {
+  const trimmed = window.trim();
+  if (/^\d+$/.test(trimmed))
+    return Number(trimmed);
+  const match = trimmed.match(/^(\d+)\s*([smhd])$/i);
+  if (!match)
+    throw new Error(`Invalid ratelimit window: ${window}`);
+  const value = Number(match[1]);
+  const unit = match[2].toLowerCase();
+  const multipliers = { s: 1000, m: 60000, h: 3600000, d: 86400000 };
+  return value * multipliers[unit];
+}
+function getClientKey(c, method, path) {
+  const ip = c.req.header("x-forwarded-for")?.split(",")[0].trim() || c.req.header("x-real-ip") || c.req.header("cf-connecting-ip") || c.req.header("fly-client-ip") || c.req.header("x-client-ip") || "";
+  const ua = c.req.header("user-agent") || "unknown";
+  return `${ip || ua}:${method}:${path}`;
+}
+function createEventContext() {
+  const store = {};
+  const mockRequest = new Request("http://localhost/event-trigger");
+  const resHeaders = new Headers;
+  const fake = {
+    get: (key) => store[key],
+    set: (key, value) => {
+      store[key] = value;
+    },
+    header: (key, value) => {
+      if (value === undefined) {
+        resHeaders.delete(key);
+      } else {
+        resHeaders.set(key, value);
+      }
+    },
+    status: (code) => {},
+    req: {
+      header: (name) => name ? undefined : {},
+      param: () => ({}),
+      query: () => ({}),
+      json: async () => ({}),
+      raw: mockRequest,
+      url: "http://localhost/event-trigger",
+      method: "POST"
+    },
+    res: {
+      headers: resHeaders
+    }
+  };
+  return fake;
+}
+async function runMiddlewareChain(middlewares, c) {
+  let index = -1;
+  const dispatch = async (i) => {
+    if (i <= index)
+      throw new Error("next() called multiple times");
+    index = i;
+    const mw = middlewares[i];
+    if (!mw)
+      return;
+    await mw(c, () => dispatch(i + 1));
+  };
+  await dispatch(0);
+}
+
+class ServiceBuilder {
+  name;
+  eventBus;
+  visionCore;
+  endpoints = new Map;
+  eventHandlers = new Map;
+  cronJobs = new Map;
+  globalMiddleware = [];
+  eventSchemas = {};
+  constructor(name, eventBus, visionCore) {
+    this.name = name;
+    this.eventBus = eventBus;
+    this.visionCore = visionCore;
+  }
+  use(...middleware) {
+    this.globalMiddleware.push(...middleware);
+    return this;
+  }
+  getRoutesMetadata() {
+    const routes = [];
+    this.endpoints.forEach((ep) => {
+      let requestBody = undefined;
+      let queryParams = undefined;
+      if (ep.schema.input) {
+        if (["POST", "PUT", "PATCH"].includes(ep.method)) {
+          requestBody = generateTemplate(ep.schema.input);
+        } else if (ep.method === "GET" || ep.method === "DELETE") {
+          const pathParamNames = (ep.path.match(/:([^/]+)/g) || []).map((p) => p.slice(1));
+          const fullTemplate = generateTemplate(ep.schema.input);
+          if (fullTemplate && pathParamNames.length > 0) {
+            const queryFields = fullTemplate.fields.filter((f) => !pathParamNames.includes(f.name));
+            if (queryFields.length > 0) {
+              queryParams = { ...fullTemplate, fields: queryFields };
+            }
+          } else {
+            queryParams = fullTemplate;
+          }
+        }
+      }
+      let responseBody = undefined;
+      if (ep.schema.output) {
+        responseBody = generateTemplate(ep.schema.output);
+      }
+      routes.push({
+        method: ep.method,
+        path: ep.path,
+        queryParams,
+        requestBody,
+        responseBody
+      });
+    });
+    return routes;
+  }
+  getDisplayName() {
+    return this.name.charAt(0).toUpperCase() + this.name.slice(1);
+  }
+  endpoint(method, path, schema, handler, config) {
+    this.endpoints.set(`${method}:${path}`, {
+      method,
+      path,
+      handler,
+      schema,
+      config: { ...config, method, path },
+      middleware: config?.middleware || []
+    });
+    return this;
+  }
+  on(eventName, config) {
+    const { schema, handler, description, icon, tags } = config;
+    this.eventSchemas[eventName] = schema;
+    const wrappedHandler = async (data) => {
+      const ctx = createEventContext();
+      if (this.globalMiddleware.length > 0) {
+        await runMiddlewareChain(this.globalMiddleware, ctx);
+      }
+      await handler(data, ctx);
+    };
+    eventRegistry.registerEvent(eventName, schema, wrappedHandler, { description, icon, tags });
+    this.eventBus.registerHandler(eventName, wrappedHandler, {
+      concurrency: config.concurrency
+    });
+    this.eventHandlers.set(eventName, config);
+    return this;
+  }
+  cron(schedule, config) {
+    const { handler, description, icon, tags } = config;
+    const cronName = `${this.name}.cron.${schedule}`;
+    eventRegistry.registerCron(cronName, schedule, handler, { description, icon, tags });
+    this.cronJobs.set(cronName, { schedule, ...config });
+    this.setupCronJob(cronName, schedule, handler);
+    return this;
+  }
+  async setupCronJob(cronName, schedule, handler) {
+    const queue = await this.eventBus.getQueueForCron(cronName);
+    await queue.upsertJobScheduler(cronName, {
+      pattern: schedule
+    }, {
+      name: cronName,
+      data: {},
+      opts: {}
+    });
+    this.eventBus.registerCronHandler(cronName, handler);
+  }
+  build(app, servicesAccumulator) {
+    const routes = Array.from(this.endpoints.values()).map((ep) => {
+      let requestBody = undefined;
+      let queryParams = undefined;
+      if (ep.schema.input) {
+        if (["POST", "PUT", "PATCH"].includes(ep.method)) {
+          requestBody = generateTemplate(ep.schema.input);
+        } else if (ep.method === "GET" || ep.method === "DELETE") {
+          const pathParamNames = (ep.path.match(/:([^/]+)/g) || []).map((p) => p.slice(1));
+          const fullTemplate = generateTemplate(ep.schema.input);
+          if (fullTemplate && pathParamNames.length > 0) {
+            const queryFields = fullTemplate.fields.filter((f) => !pathParamNames.includes(f.name));
+            if (queryFields.length > 0) {
+              queryParams = { ...fullTemplate, fields: queryFields };
+            }
+          } else {
+            queryParams = fullTemplate;
+          }
+        }
+      }
+      let responseBody = undefined;
+      if (ep.schema.output) {
+        responseBody = generateTemplate(ep.schema.output);
+      }
+      return {
+        method: ep.method,
+        path: ep.path,
+        handler: this.name,
+        middleware: [],
+        queryParams,
+        requestBody,
+        responseBody
+      };
+    });
+    const capitalizedName = this.name.charAt(0).toUpperCase() + this.name.slice(1);
+    if (servicesAccumulator) {
+      servicesAccumulator.push({
+        name: capitalizedName,
+        routes
+      });
+    }
+    this.endpoints.forEach((ep) => {
+      let rateLimitMw;
+      const rl = ep.config?.ratelimit;
+      if (rl) {
+        const windowMs = parseWindowMs(rl.window);
+        const limit = rl.requests;
+        rateLimitMw = rateLimiter({
+          windowMs,
+          limit,
+          standardHeaders: "draft-6",
+          keyGenerator: (c) => getClientKey(c, ep.method, ep.path),
+          ...rl.store ? { store: rl.store } : {}
+        });
+      }
+      const allMiddleware = [
+        ...this.globalMiddleware,
+        ...rateLimitMw ? [rateLimitMw] : [],
+        ...ep.middleware
+      ];
+      const finalHandler = async (c) => {
+        try {
+          const visionCtx = getVisionContext();
+          if (visionCtx && this.visionCore) {
+            const { vision, traceId, rootSpanId } = visionCtx;
+            const tracer = vision.getTracer();
+            c.addContext = (context) => {
+              const current = getVisionContext();
+              const targetTraceId = current?.traceId || traceId;
+              const visionTrace = vision.getTraceStore().getTrace(targetTraceId);
+              if (visionTrace) {
+                visionTrace.metadata = { ...visionTrace.metadata || {}, ...context };
+              }
+            };
+            c.span = (name, attributes = {}, fn) => {
+              const span = tracer.startSpan(name, traceId, rootSpanId);
+              for (const [key, value] of Object.entries(attributes)) {
+                tracer.setAttribute(span.id, key, value);
+              }
+              try {
+                const result2 = fn ? fn() : undefined;
+                const completedSpan = tracer.endSpan(span.id);
+                if (completedSpan) {
+                  vision.getTraceStore().addSpan(traceId, completedSpan);
+                }
+                return result2;
+              } catch (error) {
+                tracer.setAttribute(span.id, "error", true);
+                tracer.setAttribute(span.id, "error.message", error instanceof Error ? error.message : String(error));
+                const completedSpan = tracer.endSpan(span.id);
+                if (completedSpan) {
+                  vision.getTraceStore().addSpan(traceId, completedSpan);
+                }
+                throw error;
+              }
+            };
+          }
+          if (!c.emit) {
+            c.emit = async (eventName, data) => {
+              return this.eventBus.emit(eventName, data);
+            };
+          }
+          const params = c.req.param();
+          const query = c.req.query();
+          let body = {};
+          if (["POST", "PUT", "PATCH"].includes(ep.method)) {
+            body = await c.req.json().catch(() => ({}));
+          }
+          const input = { ...params, ...query, ...body };
+          const validated = UniversalValidator.parse(ep.schema.input, input);
+          const finalInput = { ...params, ...validated || {} };
+          const result = await ep.handler(finalInput, c);
+          if (ep.schema.output) {
+            const validatedOutput = UniversalValidator.parse(ep.schema.output, result);
+            return c.json(validatedOutput);
+          }
+          if (result instanceof Response) {
+            return result;
+          }
+          return c.json(result);
+        } catch (error) {
+          if (error instanceof ValidationError) {
+            const requestId = c.req.header("x-request-id");
+            return c.json(createValidationErrorResponse(error.issues, requestId), 400);
+          }
+          throw error;
+        }
+      };
+      if (allMiddleware.length > 0) {
+        app.on([ep.method], ep.path, ...allMiddleware, finalHandler);
+      } else {
+        app.on([ep.method], ep.path, finalHandler);
+      }
+    });
+    return {
+      endpoints: Array.from(this.endpoints.values()),
+      eventHandlers: Array.from(this.eventHandlers.values()),
+      cronJobs: Array.from(this.cronJobs.values())
+    };
+  }
+}
+export {
+  ServiceBuilder
+};
+
+//# debugId=786008A0EDA35F9864756E2164756E21

package/dist/service.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/service.ts"],
+  "sourcesContent": [
+    "import type { Hono, Context, MiddlewareHandler, Env, Input } from 'hono'\nimport type { z } from 'zod'\nimport { VisionCore, generateTemplate } from '@getvision/core'\nimport {\n  ValidationError,\n  createValidationErrorResponse,\n  UniversalValidator\n} from '@getvision/core'\nimport type { EndpointConfig, Handler } from './types'\nimport { getVisionContext } from './vision-app'\nimport { eventRegistry } from './event-registry'\nimport type { EventBus } from './event-bus'\nimport { rateLimiter } from 'hono-rate-limiter'\n\n// Simple window parser supporting values like '15m', '1h', '30s', '2d' or plain milliseconds as number string\nfunction parseWindowMs(window: string): number {\n  const trimmed = window.trim()\n  if (/^\\d+$/.test(trimmed)) return Number(trimmed)\n  const match = trimmed.match(/^(\\d+)\\s*([smhd])$/i)\n  if (!match) throw new Error(`Invalid ratelimit window: ${window}`)\n  const value = Number(match[1])\n  const unit = match[2].toLowerCase()\n  const multipliers: Record<string, number> = { s: 1000, m: 60_000, h: 3_600_000, d: 86_400_000 }\n  return value * multipliers[unit]\n}\n\nfunction getClientKey(c: Context, method: string, path: string): string {\n  const ip =\n    c.req.header('x-forwarded-for')?.split(',')[0].trim() ||\n    c.req.header('x-real-ip') ||\n    c.req.header('cf-connecting-ip') ||\n    c.req.header('fly-client-ip') ||\n    c.req.header('x-client-ip') ||\n    ''\n  // Fallback to UA if no IP available (still scoped per endpoint)\n  const ua = c.req.header('user-agent') || 'unknown'\n  return `${ip || ua}:${method}:${path}`\n}\n\n/**\n * Create a minimal Hono-like Context for event handlers\n * so service-level middleware can populate c.set(...)\n */\nfunction createEventContext<E extends Env = any, I extends Input = {}>(): Context<E, any, I> {\n  const store: Record<string, any> = {}\n  const mockRequest = new Request('http://localhost/event-trigger')\n  const resHeaders = new Headers()\n  \n  const fake: Partial<Context<E, any, I>> = {\n    get: (key: string) => store[key],\n    set: (key: string, value: any) => { store[key] = value },\n    header: (key: string, value: string | undefined) => { \n      if (value === undefined) {\n        resHeaders.delete(key)\n      } else {\n        resHeaders.set(key, value) \n      }\n    },\n    status: (code: number) => {},\n    req: {\n      header: ((name?: string) => name ? undefined : {}) as any,\n      param: () => ({}),\n      query: () => ({}),\n      json: async () => ({}),\n      raw: mockRequest,\n      url: 'http://localhost/event-trigger',\n      method: 'POST',\n    } as any,\n    res: {\n      headers: resHeaders,\n    } as any,\n  }\n  return fake as Context<E, any, I>\n}\n\n/**\n * Run Hono middleware chain on a context\n */\nasync function runMiddlewareChain<E extends Env, I extends Input>(\n  middlewares: MiddlewareHandler<E, string, any, any>[],\n  c: Context<E, any, I>\n): Promise<void> {\n  let index = -1\n  const dispatch = async (i: number): Promise<void> => {\n    if (i <= index) throw new Error('next() called multiple times')\n    index = i\n    const mw = middlewares[i]\n    if (!mw) return\n    await mw(c, () => dispatch(i + 1))\n  }\n  await dispatch(0)\n}\n\n/**\n * Event schema map - accumulates event types as they're registered\n */\ntype EventSchemaMap = Record<string, z.ZodSchema<any>>\n\n/**\n * ServiceBuilder - Builder pattern API for defining services\n * \n * Automatically infers event types from Zod schemas passed to .on()\n * \n * @example\n * ```ts\n * const userService = app.service('users')\n *   .use(logger())\n *   .endpoint('GET', '/users/:id', { input, output }, handler)\n *   .on('user/created', {\n *     schema: z.object({ userId: z.string(), email: z.string() }),\n *     handler: async (event) => {\n *       // event is fully typed: { userId: string, email: string }\n *     }\n *   })\n * ```\n */\nexport class ServiceBuilder<\n  TEvents extends EventSchemaMap = {},\n  E extends Env = Env,\n  I extends Input = {}\n> {\n  private endpoints: Map<string, any> = new Map()\n  private eventHandlers: Map<string, any> = new Map()\n  private cronJobs: Map<string, any> = new Map()\n  private globalMiddleware: MiddlewareHandler<E, string, any, any>[] = []\n  private eventSchemas: EventSchemaMap = {}\n  \n  constructor(\n    private name: string,\n    private eventBus: EventBus,\n    private visionCore?: VisionCore\n  ) {}\n  \n  /**\n   * Add global middleware for all endpoints in this service\n   */\n  use(...middleware: MiddlewareHandler<E, string, any, any>[]) {\n    this.globalMiddleware.push(...middleware)\n    return this\n  }\n\n  /**\n   * Get service name (capitalized) and route metadata without registering\n   */\n  public getRoutesMetadata(): Array<{\n    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'\n    path: string\n    queryParams?: any\n    requestBody?: any\n    responseBody?: any\n  }> {\n    const routes: Array<{\n      method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'\n      path: string\n      queryParams?: any\n      requestBody?: any\n      responseBody?: any\n    }> = []\n    this.endpoints.forEach((ep) => {\n      let requestBody = undefined\n      let queryParams = undefined\n      \n      if (ep.schema.input) {\n        if (['POST', 'PUT', 'PATCH'].includes(ep.method)) {\n          requestBody = generateTemplate(ep.schema.input)\n        } else if (ep.method === 'GET' || ep.method === 'DELETE') {\n          // Exclude path params from query params\n          const pathParamNames = (ep.path.match(/:([^/]+)/g) || []).map((p: string) => p.slice(1))\n          const fullTemplate = generateTemplate(ep.schema.input)\n          \n          if (fullTemplate && pathParamNames.length > 0) {\n            const queryFields = fullTemplate.fields.filter(\n              (f: { name: string }) => !pathParamNames.includes(f.name)\n            )\n            if (queryFields.length > 0) {\n              queryParams = { ...fullTemplate, fields: queryFields }\n            }\n          } else {\n            queryParams = fullTemplate\n          }\n        }\n      }\n      \n      let responseBody = undefined\n      if (ep.schema.output) {\n        responseBody = generateTemplate(ep.schema.output)\n      }\n      routes.push({\n        method: ep.method,\n        path: ep.path,\n        queryParams,\n        requestBody,\n        responseBody,\n      })\n    })\n    return routes\n  }\n\n  public getDisplayName(): string {\n    return this.name.charAt(0).toUpperCase() + this.name.slice(1)\n  }\n  \n  /**\n   * Define an HTTP endpoint with Zod validation\n   * \n   * @example\n   * ```ts\n   * service.endpoint(\n   *   'GET',\n   *   '/users/:id',\n   *   {\n   *     input: z.object({ id: z.string() }),\n   *     output: z.object({ id: z.string(), name: z.string() })\n   *   },\n   *   async ({ id }, c) => {\n   *     return { id, name: 'John' }\n   *   },\n   *   { middleware: [authMiddleware] }\n   * )\n   * ```\n   */\n  endpoint<\n    TInputSchema extends z.ZodType,\n    TOutputSchema extends z.ZodType | undefined,\n    PPath extends string\n  >(\n    method: EndpointConfig['method'],\n    path: PPath,\n    schema: {\n      input: TInputSchema\n      output?: TOutputSchema\n    },\n    handler: Handler<\n      z.infer<TInputSchema>,\n      TOutputSchema extends z.ZodType ? z.infer<TOutputSchema> : any,\n      TEvents,\n      E,\n      PPath,\n      I\n    >,\n    config?: Partial<EndpointConfig>\n  ) {\n    this.endpoints.set(`${method}:${path}`, {\n      method,\n      path,\n      handler,\n      schema,\n      config: { ...config, method, path },\n      middleware: config?.middleware || []\n    })\n    return this\n  }\n  \n  /**\n   * Subscribe to events with Zod schema validation\n   * \n   * Automatically infers the event type from the Zod schema.\n   * TypeScript will ensure that c.emit() calls match the registered schema.\n   * \n   * @example\n   * ```ts\n   * service.on('user/created', {\n   *   schema: z.object({\n   *     userId: z.string().uuid(),\n   *     email: z.string().email()\n   *   }),\n   *   description: 'User account created',\n   *   icon: '👤',\n   *   tags: ['user', 'auth'],\n   *   handler: async (event) => {\n   *     // event is fully typed: { userId: string, email: string }\n   *     console.log('User created:', event.email)\n   *   }\n   * })\n   * ```\n   */\n  on<\n    K extends string,\n    T extends Record<string, any>\n  >(\n    eventName: K,\n    config: {\n      schema: z.ZodSchema<T>\n      description?: string\n      icon?: string\n      tags?: string[]\n      /**\n       * Max number of concurrent jobs this handler will process.\n       * Falls back to EventBus config.workerConcurrency (or 1).\n       */\n      concurrency?: number\n      handler: (event: T, c: Context<E, any, I>) => Promise<void>\n    }\n  ): ServiceBuilder<TEvents & { [key in K]: T }, E, I> {\n    const { schema, handler, description, icon, tags } = config\n    \n    // Store schema for type inference\n    this.eventSchemas[eventName] = schema\n    \n    // Wrap handler to provide Hono-like context with middleware support\n    const wrappedHandler = async (data: T) => {\n      const ctx = createEventContext<E, I>()\n      // Run service-level middleware to populate ctx (e.g., c.set('db', db))\n      if (this.globalMiddleware.length > 0) {\n        await runMiddlewareChain(this.globalMiddleware, ctx)\n      }\n      // Call original handler with event data and context\n      await handler(data, ctx)\n    }\n    \n    // Register wrapped handler in event registry (for metadata/stats)\n    eventRegistry.registerEvent(\n      eventName,\n      schema,\n      wrappedHandler,\n      { description, icon, tags }\n    )\n    \n    // Register wrapped handler in event bus\n    this.eventBus.registerHandler(eventName, wrappedHandler, {\n      concurrency: config.concurrency,\n    })\n    \n    // Store for later reference\n    this.eventHandlers.set(eventName, config)\n    \n    // Return typed ServiceBuilder with accumulated events\n    return this as ServiceBuilder<TEvents & { [key in K]: T }, E, I>\n  }\n  \n  /**\n   * Schedule a cron job using BullMQ Repeatable\n   * \n   * @example\n   * ```ts\n   * service.cron('0 0 * * *', {\n   *   description: 'Daily cleanup',\n   *   icon: '🧹',\n   *   tags: ['maintenance'],\n   *   handler: async (c) => {\n   *     console.log('Daily cleanup')\n   *   }\n   * })\n   * ```\n   */\n  cron(\n    schedule: string,\n    config: {\n      description?: string\n      icon?: string\n      tags?: string[]\n      handler: (context: any) => Promise<void>\n    }\n  ) {\n    const { handler, description, icon, tags } = config\n    const cronName = `${this.name}.cron.${schedule}`\n    \n    // Register in event registry\n    eventRegistry.registerCron(\n      cronName,\n      schedule,\n      handler,\n      { description, icon, tags }\n    )\n    \n    // Store for later reference\n    this.cronJobs.set(cronName, { schedule, ...config })\n    \n    // Setup BullMQ repeatable job\n    // This will be called when the service is built\n    this.setupCronJob(cronName, schedule, handler)\n    \n    return this\n  }\n  \n  /**\n   * Setup BullMQ repeatable job for cron\n   */\n  private async setupCronJob(\n    cronName: string,\n    schedule: string,\n    handler: (context: any) => Promise<void>\n  ) {\n    // Get queue from EventBus (we'll add a getQueue method)\n    const queue = await this.eventBus.getQueueForCron(cronName)\n    \n    // Register cron job using BullMQ upsertJobScheduler\n    await queue.upsertJobScheduler(\n      cronName,\n      {\n        pattern: schedule,  // Cron expression (e.g., '0 0 * * *')\n      },\n      {\n        name: cronName,\n        data: {},\n        opts: {},\n      }\n    )\n    \n    // Register worker to process cron jobs\n    this.eventBus.registerCronHandler(cronName, handler)\n  }\n  \n  /**\n   * Build and register all endpoints with Hono\n   */\n  build(app: Hono, servicesAccumulator?: Array<{ name: string; routes: any[] }>) {\n    // Prepare routes with Zod schemas\n    const routes = Array.from(this.endpoints.values()).map(ep => {\n      // Generate requestBody schema (input) for POST/PUT/PATCH\n      let requestBody = undefined\n      let queryParams = undefined\n      \n      if (ep.schema.input) {\n        if (['POST', 'PUT', 'PATCH'].includes(ep.method)) {\n          requestBody = generateTemplate(ep.schema.input)\n        } else if (ep.method === 'GET' || ep.method === 'DELETE') {\n          // For GET/DELETE, input schema represents query parameters\n          // BUT we need to exclude path params from query params\n          const pathParamNames = (ep.path.match(/:([^/]+)/g) || []).map((p: string) => p.slice(1))\n          const fullTemplate = generateTemplate(ep.schema.input)\n          \n          if (fullTemplate && pathParamNames.length > 0) {\n            // Filter out path params from query params\n            const queryFields = fullTemplate.fields.filter(\n              (f: { name: string }) => !pathParamNames.includes(f.name)\n            )\n            if (queryFields.length > 0) {\n              queryParams = { ...fullTemplate, fields: queryFields }\n            }\n          } else {\n            queryParams = fullTemplate\n          }\n        }\n      }\n      \n      // Generate responseBody schema (output)\n      let responseBody = undefined\n      if (ep.schema.output) {\n        responseBody = generateTemplate(ep.schema.output)\n      }\n      \n      return {\n        method: ep.method,\n        path: ep.path,\n        handler: this.name,\n        middleware: [],\n        queryParams,\n        requestBody,\n        responseBody,\n      }\n    })\n    \n    const capitalizedName = this.name.charAt(0).toUpperCase() + this.name.slice(1)\n    \n    // Add to accumulator (для батч реєстрації в buildAllServices)\n    if (servicesAccumulator) {\n      servicesAccumulator.push({\n        name: capitalizedName,\n        routes\n      })\n    }\n    \n    // Register HTTP endpoints\n    this.endpoints.forEach((ep) => {\n      // Prepare rate limiter when configured per-endpoint\n      let rateLimitMw: MiddlewareHandler<E, string, any, any> | undefined\n      const rl = ep.config?.ratelimit as EndpointConfig['ratelimit'] | undefined\n      if (rl) {\n        const windowMs = parseWindowMs(rl.window)\n        const limit = rl.requests\n        rateLimitMw = rateLimiter({\n          windowMs,\n          limit,\n          standardHeaders: 'draft-6',\n          keyGenerator: (c) => getClientKey(c, ep.method, ep.path),\n          // If user provides a distributed store (e.g., RedisStore), pass it through\n          ...(rl.store ? { store: rl.store } : {}),\n        })\n      }\n\n      // Combine global + rate-limit (if any) + endpoint-specific middleware\n      const allMiddleware = [\n        ...this.globalMiddleware,\n        ...(rateLimitMw ? [rateLimitMw] as MiddlewareHandler<E, string, any, any>[] : []),\n        ...ep.middleware,\n      ]\n      \n      // Create handler with middleware chain\n      const finalHandler = async (c: Context<E, any, I>) => {\n        try {\n          // Add span helper and emit to context\n          const visionCtx = getVisionContext()\n          if (visionCtx && this.visionCore) {\n            const { vision, traceId, rootSpanId } = visionCtx\n            const tracer = vision.getTracer();\n            \n            // Add addContext() method to context\n            (c as any).addContext = (context: Record<string, unknown>) => {\n              const current = getVisionContext()\n              // Use current traceId from context if available (handles nested spans/async correctly)\n              const targetTraceId = current?.traceId || traceId\n              \n              const visionTrace = vision.getTraceStore().getTrace(targetTraceId)\n              if (visionTrace) {\n                visionTrace.metadata = { ...(visionTrace.metadata || {}), ...context }\n              }\n            }\n\n            // Add span() method to context\n            (c as any).span = <T>(\n              name: string,\n              attributes: Record<string, any> = {},\n              fn?: () => T\n            ): T => {\n              const span = tracer.startSpan(name, traceId, rootSpanId)\n              \n              for (const [key, value] of Object.entries(attributes)) {\n                tracer.setAttribute(span.id, key, value)\n              }\n              \n              try {\n                const result = fn ? fn() : (undefined as any)\n                const completedSpan = tracer.endSpan(span.id)\n                \n                if (completedSpan) {\n                  vision.getTraceStore().addSpan(traceId, completedSpan)\n                }\n                \n                return result\n              } catch (error) {\n                tracer.setAttribute(span.id, 'error', true)\n                tracer.setAttribute(\n                  span.id,\n                  'error.message',\n                  error instanceof Error ? error.message : String(error)\n                )\n                const completedSpan = tracer.endSpan(span.id)\n                \n                if (completedSpan) {\n                  vision.getTraceStore().addSpan(traceId, completedSpan)\n                }\n                \n                throw error\n              }\n            }\n          }\n\n          // Always provide emit() so events work in sub-apps without local VisionCore\n          if (!(c as any).emit) {\n            (c as any).emit = async <K extends keyof TEvents>(\n              eventName: K,\n              data: TEvents[K]\n            ): Promise<void> => {\n              return this.eventBus.emit(eventName as string, data)\n            }\n          }\n          \n          // Parse and merge params, body, query\n          const params = c.req.param()\n          const query = c.req.query()\n          let body = {}\n          \n          if (['POST', 'PUT', 'PATCH'].includes(ep.method)) {\n            body = await c.req.json().catch(() => ({}))\n          }\n          \n          const input = { ...params, ...query, ...body }\n          \n          // Validate input with UniversalValidator (supports Zod, Valibot, etc.)\n          const validated = UniversalValidator.parse(ep.schema.input, input)\n          \n          // Merge back path params that are not in the schema\n          // This ensures path params like :id are always available to the handler\n          const finalInput = { ...params, ...(validated || {}) }\n          \n          // Execute handler\n          const result = await ep.handler(finalInput, c as any)\n\n          // If an output schema exists, validate and return JSON\n          if (ep.schema.output) {\n            const validatedOutput = UniversalValidator.parse(ep.schema.output, result)\n            return c.json(validatedOutput)\n          }\n\n          // No output schema: allow raw Response or JSON\n          if (result instanceof Response) {\n            return result\n          }\n          return c.json(result)\n        } catch (error) {\n          if (error instanceof ValidationError) {\n            const requestId = c.req.header('x-request-id')\n            return c.json(\n              createValidationErrorResponse(error.issues, requestId),\n              400\n            )\n          }\n          throw error\n        }\n      }\n      \n      // Register with middleware chain\n      if (allMiddleware.length > 0) {\n        app.on([ep.method], ep.path, ...allMiddleware, finalHandler)\n      } else {\n        app.on([ep.method], ep.path, finalHandler)\n      }\n    })\n    \n    return {\n      endpoints: Array.from(this.endpoints.values()),\n      eventHandlers: Array.from(this.eventHandlers.values()),\n      cronJobs: Array.from(this.cronJobs.values())\n    }\n  }\n}\n\n"
+  ],
+  "mappings": "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",
+  "debugId": "786008A0EDA35F9864756E2164756E21",
+  "names": []
+}

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+import type { Context, Env, Input, MiddlewareHandler } from 'hono';
+import type { VisionCore } from '@getvision/core';
+/**
+ * Vision context stored in AsyncLocalStorage
+ */
+export interface VisionContext<E extends Env = any, P extends string = any, I extends Input = {}> extends Context<E, P, I> {
+    vision: VisionCore;
+    traceId: string;
+    rootSpanId: string;
+}
+/**
+ * Endpoint configuration options
+ */
+export interface EndpointConfig {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    middleware?: MiddlewareHandler[];
+    auth?: boolean;
+    ratelimit?: {
+        requests: number;
+        window: string;
+        store?: any;
+    };
+    cache?: {
+        ttl: number;
+    };
+}
+/**
+ * Extended Context with span helper and emit
+ *
+ * Generic TEvents parameter allows type-safe event emission
+ */
+export interface ExtendedContext<TEvents extends Record<string, any> = {}, E extends Env = any, P extends string = any, I extends Input = {}> extends Context<E, P, I> {
+    span<T>(name: string, attributes?: Record<string, any>, fn?: () => T): T;
+    /**
+     * Add context to the current active trace
+     * This is the "Wide Event" API - allowing adding high-cardinality data
+     * to the current request context.
+     */
+    addContext(context: Record<string, unknown>): void;
+    /**
+     * Emit an event with type-safe validation
+     *
+     * The event name and data are validated against registered Zod schemas.
+     * TypeScript will ensure:
+     * 1. The event name is registered (via .on())
+     * 2. The data matches the schema exactly
+     *
+     * @example
+     * ```ts
+     * // After .on('user/created', { schema: z.object({ userId: z.string(), email: z.string() }) })
+     *
+     * // ✅ TypeScript allows this:
+     * await c.emit('user/created', {
+     *   userId: '123',
+     *   email: 'user@example.com'
+     * })
+     *
+     * // ❌ TypeScript errors:
+     * await c.emit('unknown/event', {})  // Event not registered
+     * await c.emit('user/created', { userId: '123' })  // Missing email
+     * await c.emit('user/created', { userId: '123', email: 'x', extra: 'extra' })  // Extra field
+     * ```
+     */
+    emit<K extends keyof TEvents>(eventName: K, data: TEvents[K]): Promise<void>;
+}
+/**
+ * Handler type with Zod-validated input and Vision-enhanced context
+ */
+export type Handler<TInput = any, TOutput = any, TEvents extends Record<string, any> = {}, E extends Env = any, P extends string = any, I extends Input = {}> = (req: TInput, ctx: ExtendedContext<TEvents, E, P, I>) => Promise<TOutput> | TOutput;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,CAAC,SAAS,MAAM,GAAG,GAAG,EAAE,CAAC,SAAS,KAAK,GAAG,EAAE,CAAE,SAAQ,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACxH,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAA;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAEhC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE,CAAA;IAC7D,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAC9B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,EACxC,CAAC,SAAS,GAAG,GAAG,GAAG,EACnB,CAAC,SAAS,MAAM,GAAG,GAAG,EACtB,CAAC,SAAS,KAAK,GAAG,EAAE,CACpB,SAAQ,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACxB,IAAI,CAAC,CAAC,EACJ,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,EAAE,CAAC,EAAE,MAAM,CAAC,GACX,CAAC,CAAA;IAEJ;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAElD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAC1B,SAAS,EAAE,CAAC,EACZ,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GACf,OAAO,CAAC,IAAI,CAAC,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,CACjB,MAAM,GAAG,GAAG,EACZ,OAAO,GAAG,GAAG,EACb,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,EACxC,CAAC,SAAS,GAAG,GAAG,GAAG,EACnB,CAAC,SAAS,MAAM,GAAG,GAAG,EACtB,CAAC,SAAS,KAAK,GAAG,EAAE,IAClB,CACF,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,eAAe,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KACnC,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+
+//# debugId=9FCB033A2878230664756E2164756E21

package/dist/types.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "9FCB033A2878230664756E2164756E21",
+  "names": []
+}

package/dist/vision-app.d.ts

@@ -0,0 +1,166 @@
+import { Hono } from 'hono';
+import type { Env, Schema } from 'hono';
+import { VisionCore } from '@getvision/core';
+import type { RouteMetadata } from '@getvision/core';
+import { ServiceBuilder } from './service';
+import { EventBus } from './event-bus';
+import type { serve as honoServe } from '@hono/node-server';
+import type { QueueEventsOptions, QueueOptions, WorkerOptions } from "bullmq";
+export interface VisionALSContext {
+    vision: VisionCore;
+    traceId: string;
+    rootSpanId: string;
+}
+type BunServeOptions = Parameters<typeof Bun['serve']>[0];
+type NodeServeOptions = Parameters<typeof honoServe>[0];
+type VisionStartOptions = Omit<Partial<BunServeOptions>, 'fetch' | 'port'> & Omit<Partial<NodeServeOptions>, 'fetch' | 'port'>;
+/**
+ * Vision Server configuration
+ */
+export interface VisionConfig {
+    service: {
+        name: string;
+        version?: string;
+        description?: string;
+        integrations?: Record<string, string>;
+        drizzle?: {
+            autoStart?: boolean;
+            port?: number;
+        };
+    };
+    vision?: {
+        enabled?: boolean;
+        port?: number;
+        maxTraces?: number;
+        maxLogs?: number;
+        logging?: boolean;
+        apiUrl?: string;
+    };
+    routes?: {
+        autodiscover?: boolean;
+        dirs?: string[];
+    };
+    pubsub?: {
+        redis?: {
+            host?: string;
+            port?: number;
+            password?: string;
+            /**
+             * Enable keepalive to prevent connection timeouts (default: 30000ms)
+             */
+            keepAlive?: number;
+            /**
+             * Max retry attempts for failed commands (default: 20)
+             */
+            maxRetriesPerRequest?: number;
+            /**
+             * Enable ready check before executing commands (default: true)
+             */
+            enableReadyCheck?: boolean;
+            /**
+             * Connection timeout in ms (default: 10000)
+             */
+            connectTimeout?: number;
+            /**
+             * Enable offline queue (default: true)
+             */
+            enableOfflineQueue?: boolean;
+        };
+        devMode?: boolean;
+        eventBus?: EventBus;
+        /**
+         * Default BullMQ worker concurrency for all handlers (overridable per handler)
+         */
+        workerConcurrency?: number;
+        queue?: Omit<QueueOptions, 'connection'>;
+        worker?: Omit<WorkerOptions, 'connection'>;
+        queueEvents?: Omit<QueueEventsOptions, 'connection'>;
+    };
+}
+/**
+ * Vision - Meta-framework built on Hono with observability
+ *
+ * @example
+ * ```ts
+ * const app = new Vision({
+ *   service: {
+ *     name: 'My API',
+ *     version: '1.0.0'
+ *   }
+ * })
+ *
+ * const userService = app.service('users')
+ *   .on('user/created', handler)
+ *   .endpoint('GET', '/users/:id', schema, handler)
+ *
+ * app.start(3000)
+ * ```
+ */
+export declare class Vision<E extends Env = Env, S extends Schema = {}, BasePath extends string = '/'> extends Hono<E, S, BasePath> {
+    private visionCore;
+    private eventBus;
+    private config;
+    private serviceBuilders;
+    private bunServer?;
+    private signalHandler?;
+    constructor(config?: VisionConfig);
+    /**
+     * Register JSON-RPC methods for events and cron jobs
+     */
+    private registerEventMethods;
+    /**
+     * Install Vision tracing middleware
+     */
+    private installVisionMiddleware;
+    /**
+     * Create a new service with builder pattern
+     *
+     * @example
+     * ```ts
+     * const userService = app.service('users')
+     *   .endpoint('GET', '/users/:id', schema, handler)
+     *   .on('user/created', handler)
+     * ```
+     */
+    service<E2 extends Env = E, TEvents extends Record<string, any> = {}>(name: string): ServiceBuilder<TEvents, E2, {}>;
+    /**
+     * Get services and routes metadata without registering to this VisionCore
+     */
+    getServiceSummaries(): Array<{
+        name: string;
+        routes: RouteMetadata[];
+    }>;
+    /**
+     * Build all service builders
+     */
+    buildAllServices(): {
+        name: string;
+        routes: RouteMetadata[];
+    }[];
+    /**
+     * Get Vision Core instance
+     */
+    getVision(): VisionCore;
+    /**
+     * Get EventBus instance
+     */
+    getEventBus(): EventBus;
+    /**
+     * Autoload Vision/Hono sub-apps from configured directories
+     */
+    private autoloadRoutes;
+    /**
+     * Start the server (convenience method)
+     */
+    start(port?: number, options?: VisionStartOptions): Promise<this | undefined>;
+    /**
+     * Set the EventBus instance (used internally by router to inject shared EventBus)
+     */
+    setEventBus(eventBus: EventBus): void;
+}
+/**
+ * Get Vision context (internal use)
+ */
+export declare function getVisionContext(): VisionALSContext | undefined;
+export {};
+//# sourceMappingURL=vision-app.d.ts.map

package/dist/vision-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision-app.d.ts","sourceRoot":"","sources":["../src/vision-app.ts"],"names":[],"mappings":"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"}