@getvision/server 0.0.1 → 0.1.0-5d94ff9-develop

package/.turbo/turbo-build.log

@@ -1,2 +1 @@
-
-$ tsc --noEmit
+$ tsc --noEmit

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getvision/server",
-  "version": "0.0.1",
+  "version": "0.1.0-5d94ff9-develop",
   "type": "module",
   "description": "Vision Server - Meta-framework with built-in observability, pub/sub, and type-safe APIs",
   "exports": {
@@ -16,14 +16,14 @@
     "@getvision/core": "0.0.1",
     "@hono/node-server": "^1.19.5",
     "bullmq": "^5.62.0",
-    "hono": "^4.10.3",
+    "hono": "^4.10.4",
     "ioredis": "^5.8.2",
     "zod": "^4.1.11"
   },
   "peerDependencies": {},
   "devDependencies": {
-    "@repo/eslint-config": "0.0.0",
-    "@repo/typescript-config": "0.0.0",
+    "@repo/eslint-config": "0.0.1",
+    "@repo/typescript-config": "0.0.1",
     "@types/node": "^20.14.9",
     "typescript": "5.9.3"
   },

package/src/service.ts

@@ -1,7 +1,7 @@
-import type { Hono, Context, MiddlewareHandler } from 'hono'
+import type { Hono, Context, MiddlewareHandler, Env, Input } from 'hono'
 import type { z } from 'zod'
 import { VisionCore, generateZodTemplate } from '@getvision/core'
-import type { EndpointConfig, Handler, VisionContext } from './types'
+import type { EndpointConfig, Handler } from './types'
 import { getVisionContext } from './vision-app'
 import { eventRegistry } from './event-registry'
 import type { EventBus } from './event-bus'
@@ -29,11 +29,15 @@ type EventSchemaMap = Record<string, z.ZodSchema<any>>
  *   })
  * ```
  */
-export class ServiceBuilder<TEvents extends EventSchemaMap = {}> {
+export class ServiceBuilder<
+  TEvents extends EventSchemaMap = {},
+  E extends Env = Env,
+  I extends Input = {}
+> {
   private endpoints: Map<string, any> = new Map()
   private eventHandlers: Map<string, any> = new Map()
   private cronJobs: Map<string, any> = new Map()
-  private globalMiddleware: MiddlewareHandler[] = []
+  private globalMiddleware: MiddlewareHandler<E, string, any, any>[] = []
   private eventSchemas: EventSchemaMap = {}
   
   constructor(
@@ -45,7 +49,7 @@ export class ServiceBuilder<TEvents extends EventSchemaMap = {}> {
   /**
    * Add global middleware for all endpoints in this service
    */
-  use(...middleware: MiddlewareHandler[]) {
+  use(...middleware: MiddlewareHandler<E, string, any, any>[]) {
     this.globalMiddleware.push(...middleware)
     return this
   }
@@ -109,15 +113,23 @@ export class ServiceBuilder<TEvents extends EventSchemaMap = {}> {
    */
   endpoint<
     TInputSchema extends z.ZodType,
-    TOutputSchema extends z.ZodType
+    TOutputSchema extends z.ZodType | undefined,
+    PPath extends string
   >(
     method: EndpointConfig['method'],
-    path: string,
+    path: PPath,
     schema: {
       input: TInputSchema
-      output: TOutputSchema
+      output?: TOutputSchema
     },
-    handler: Handler<z.infer<TInputSchema>, z.infer<TOutputSchema>, TEvents>,
+    handler: Handler<
+      z.infer<TInputSchema>,
+      TOutputSchema extends z.ZodType ? z.infer<TOutputSchema> : any,
+      TEvents,
+      E,
+      PPath,
+      I
+    >,
     config?: Partial<EndpointConfig>
   ) {
     this.endpoints.set(`${method}:${path}`, {
@@ -166,7 +178,7 @@ export class ServiceBuilder<TEvents extends EventSchemaMap = {}> {
       tags?: string[]
       handler: (event: T) => Promise<void>
     }
-  ): ServiceBuilder<TEvents & { [key in K]: T }> {
+  ): ServiceBuilder<TEvents & { [key in K]: T }, E, I> {
     const { schema, handler, description, icon, tags } = config
     
     // Store schema for type inference
@@ -187,7 +199,7 @@ export class ServiceBuilder<TEvents extends EventSchemaMap = {}> {
     this.eventHandlers.set(eventName, config)
     
     // Return typed ServiceBuilder with accumulated events
-    return this as ServiceBuilder<TEvents & { [key in K]: T }>
+    return this as ServiceBuilder<TEvents & { [key in K]: T }, E, I>
   }
   
   /**
@@ -307,7 +319,7 @@ export class ServiceBuilder<TEvents extends EventSchemaMap = {}> {
       const allMiddleware = [...this.globalMiddleware, ...ep.middleware]
       
       // Create handler with middleware chain
-      const finalHandler = async (c: Context) => {
+      const finalHandler = async (c: Context<E, any, I>) => {
         try {
           // Add span helper and emit to context
           const visionCtx = getVisionContext()
@@ -378,11 +390,18 @@ export class ServiceBuilder<TEvents extends EventSchemaMap = {}> {
           
           // Execute handler
           const result = await ep.handler(validated, c as any)
-          
-          // Validate output with Zod
-          const validatedOutput = ep.schema.output.parse(result)
-          
-          return c.json(validatedOutput)
+
+          // If an output schema exists, validate and return JSON
+          if (ep.schema.output) {
+            const validatedOutput = ep.schema.output.parse(result)
+            return c.json(validatedOutput)
+          }
+
+          // No output schema: allow raw Response or JSON
+          if (result instanceof Response) {
+            return result
+          }
+          return c.json(result)
         } catch (error) {
           if ((error as any).name === 'ZodError') {
             return c.json({ 

package/src/types.ts

@@ -1,11 +1,10 @@
-import type { Context, MiddlewareHandler } from 'hono'
-import type { z } from 'zod'
+import type { Context, Env, Input, MiddlewareHandler } from 'hono'
 import type { VisionCore } from '@getvision/core'
 
 /**
  * Vision context stored in AsyncLocalStorage
  */
-export interface VisionContext {
+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
@@ -18,6 +17,7 @@ export interface EndpointConfig {
   method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'
   path: string
   middleware?: MiddlewareHandler[]
+  // TODO: Below not implemented yet features
   auth?: boolean
   ratelimit?: { requests: number; window: string }
   cache?: { ttl: number }
@@ -28,7 +28,12 @@ export interface EndpointConfig {
  * 
  * Generic TEvents parameter allows type-safe event emission
  */
-export interface ExtendedContext<TEvents extends Record<string, any> = {}> extends Context {
+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>,
@@ -68,7 +73,14 @@ export interface ExtendedContext<TEvents extends Record<string, any> = {}> exten
 /**
  * Handler type with Zod-validated input and Vision-enhanced context
  */
-export type Handler<TInput = any, TOutput = any, TEvents extends Record<string, any> = {}> = (
+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>
+  ctx: ExtendedContext<TEvents, E, P, I>
 ) => Promise<TOutput> | TOutput

package/src/vision-app.ts

@@ -6,11 +6,16 @@ import { AsyncLocalStorage } from 'async_hooks'
 import { existsSync } from 'fs'
 import { spawn, type ChildProcess } from 'child_process'
 import { ServiceBuilder } from './service'
-import type { VisionContext } from './types'
 import { EventBus } from './event-bus'
 import { eventRegistry } from './event-registry'
 
-const visionContext = new AsyncLocalStorage<VisionContext>()
+export interface VisionALSContext {
+  vision: VisionCore
+  traceId: string
+  rootSpanId: string
+}
+
+const visionContext = new AsyncLocalStorage<VisionALSContext>()
 
 /**
  * Vision Server configuration
@@ -81,7 +86,7 @@ export class Vision<
   private visionCore: VisionCore
   private eventBus: EventBus
   private config: VisionConfig
-  private serviceBuilders: ServiceBuilder<any>[] = []
+  private serviceBuilders: ServiceBuilder<any, E>[] = []
   private fileBasedRoutes: RouteMetadata[] = []
 
   constructor(config?: VisionConfig) {
@@ -253,11 +258,11 @@ export class Vision<
       
       // Run request in AsyncLocalStorage context
       return visionContext.run(
-        { 
-          vision: this.visionCore, 
-          traceId: trace.id, 
-          rootSpanId: '' 
-        }, 
+        {
+          vision: this.visionCore,
+          traceId: trace.id,
+          rootSpanId: ''
+        },
         async () => {
           // Start main span
           const tracer = this.visionCore.getTracer()
@@ -427,11 +432,11 @@ export class Vision<
    *   .on('user/created', handler)
    * ```
    */
-  service<TEvents extends Record<string, any> = {}>(name: string) {
-    const builder = new ServiceBuilder<TEvents>(name, this.eventBus, this.visionCore)
+  service<E2 extends Env = E, TEvents extends Record<string, any> = {}>(name: string) {
+    const builder = new ServiceBuilder<TEvents, E2>(name, this.eventBus, this.visionCore)
     
-    // Зберігаємо builder для реєстрації в start()
-    this.serviceBuilders.push(builder)
+    // Preserve builder for registration in start()
+    this.serviceBuilders.push(builder as unknown as ServiceBuilder<any, E>)
     
     return builder
   }
@@ -610,7 +615,7 @@ export class Vision<
 /**
  * Get Vision context (internal use)
  */
-export function getVisionContext(): VisionContext | undefined {
+export function getVisionContext(): VisionALSContext | undefined {
   return visionContext.getStore()
 }