@fitzzero/quickdraw-core 0.1.0 → 1.1.0

package/dist/server/testing.js

@@ -19,47 +19,84 @@ var ServiceRegistry = class {
   io;
   services = /* @__PURE__ */ new Map();
   logger;
+  methodLoggingEnabled;
+  logPayloads;
+  logResponses;
+  connectionHandlerInstalled = false;
+  // Store method metadata for deferred registration
+  methodRegistry = /* @__PURE__ */ new Map();
   constructor(io, options) {
     this.io = io;
     this.logger = options?.logger?.child({ service: "ServiceRegistry" }) ?? consoleLogger.child({ service: "ServiceRegistry" });
+    this.methodLoggingEnabled = options?.methodLogging?.enabled ?? true;
+    this.logPayloads = options?.methodLogging?.logPayloads ?? false;
+    this.logResponses = options?.methodLogging?.logResponses ?? false;
+    if (this.methodLoggingEnabled) {
+      this.logger.info("Automatic method logging enabled", {
+        logPayloads: this.logPayloads,
+        logResponses: this.logResponses
+      });
+    }
+  }
+  /**
+   * Install the single connection handler that wires all registered services.
+   * This is called lazily on first service registration.
+   */
+  installConnectionHandler() {
+    if (this.connectionHandlerInstalled) return;
+    this.connectionHandlerInstalled = true;
+    this.io.on("connection", (socket) => {
+      const quickdrawSocket = socket;
+      this.setupSocketListeners(quickdrawSocket);
+    });
+    this.logger.info("Installed single connection handler for all services");
+  }
+  /**
+   * Set up all event listeners for a newly connected socket.
+   */
+  setupSocketListeners(socket) {
+    for (const [eventName, { method, service }] of this.methodRegistry) {
+      this.registerMethodListener(socket, eventName, method, service);
+    }
+    for (const [serviceName, service] of this.services) {
+      this.registerSubscriptionListener(
+        socket,
+        `${serviceName}:subscribe`,
+        service
+      );
+      this.registerUnsubscriptionListener(
+        socket,
+        `${serviceName}:unsubscribe`,
+        service
+      );
+    }
   }
   /**
    * Register a service and auto-discover its public methods.
    */
   registerService(serviceName, service) {
     this.services.set(serviceName, service);
+    if (service.setIo) {
+      service.setIo(this.io);
+    }
     this.logger.info(`Registered service: ${serviceName}`);
     this.discoverServiceMethods(serviceName, service);
+    this.installConnectionHandler();
   }
   /**
-   * Discover and register all public methods from a service.
+   * Discover and store all public methods from a service.
    */
   discoverServiceMethods(serviceName, service) {
     const methods = service.getPublicMethods();
     for (const method of methods) {
       const eventName = `${serviceName}:${method.name}`;
       this.logger.info(`Registering socket event: ${eventName}`);
-      this.io.on("connection", (socket) => {
-        this.registerMethodListener(
-          socket,
-          eventName,
-          method,
-          service
-        );
+      this.methodRegistry.set(eventName, {
+        serviceName,
+        method,
+        service
       });
     }
-    this.io.on("connection", (socket) => {
-      this.registerSubscriptionListener(
-        socket,
-        `${serviceName}:subscribe`,
-        service
-      );
-      this.registerUnsubscriptionListener(
-        socket,
-        `${serviceName}:unsubscribe`,
-        service
-      );
-    });
   }
   /**
    * Register a method as a socket event listener.
@@ -105,33 +142,45 @@ var ServiceRegistry = class {
             }
           }
           await service.ensureAccessForMethod(method.access, socket, entryId);
-          this.logger.info(
-            `User ${userIdShort} ${serviceName}.${methodName} -> start`,
-            {
+          if (this.methodLoggingEnabled) {
+            const logContext = {
               category: "request_processing",
               serviceName,
               methodName,
               userId: socket.userId,
               socketId: socket.id
+            };
+            if (this.logPayloads) {
+              logContext.payload = validatedPayload;
             }
-          );
+            this.logger.info(
+              `User ${userIdShort} ${serviceName}.${methodName} -> start`,
+              logContext
+            );
+          }
           const result = await method.handler(validatedPayload, {
             userId: socket.userId,
             socketId: socket.id,
             serviceAccess: socket.serviceAccess ?? {}
           });
-          const durationMs = Date.now() - startedAt;
-          this.logger.info(
-            `User ${userIdShort} ${serviceName}.${methodName} -> success`,
-            {
+          if (this.methodLoggingEnabled) {
+            const durationMs = Date.now() - startedAt;
+            const logContext = {
               category: "request_processing",
               outcome: "success",
               durationMs,
               serviceName,
               methodName,
               userId: socket.userId
+            };
+            if (this.logResponses) {
+              logContext.response = result;
             }
-          );
+            this.logger.info(
+              `User ${userIdShort} ${serviceName}.${methodName} -> success`,
+              logContext
+            );
+          }
           const successResponse = {
             success: true,
             data: result
@@ -139,14 +188,22 @@ var ServiceRegistry = class {
           callback?.(successResponse);
         } catch (error) {
           const durationMs = Date.now() - startedAt;
+          const logContext = {
+            category: "request_processing",
+            outcome: "fail",
+            durationMs,
+            serviceName,
+            methodName,
+            userId: socket.userId,
+            socketId: socket.id,
+            error: error instanceof Error ? error.message : "Unknown error"
+          };
+          if (this.logPayloads) {
+            logContext.payload = payload;
+          }
           this.logger.error(
             `User ${userIdShort} ${serviceName}.${methodName} -> fail`,
-            {
-              category: "request_processing",
-              outcome: "fail",
-              durationMs,
-              error: error instanceof Error ? error.message : "Unknown error"
-            }
+            logContext
           );
           const errorResponse = {
             success: false,
@@ -256,7 +313,10 @@ function createQuickdrawServer(options) {
       credentials: options.cors?.credentials ?? true
     }
   });
-  const registry = new ServiceRegistry(io, { logger });
+  const registry = new ServiceRegistry(io, {
+    logger,
+    methodLogging: options.methodLogging
+  });
   io.use(async (socket, next) => {
     const quickdrawSocket = socket;
     try {
@@ -303,6 +363,34 @@ function createQuickdrawServer(options) {
       `Registered services: ${registry.getServices().join(", ")}`
     );
   });
+  const shutdown = async (signal) => {
+    serverLogger.info(`Received ${signal}, starting graceful shutdown...`);
+    httpServer.close(() => {
+      serverLogger.info("HTTP server closed");
+    });
+    const sockets = await io.fetchSockets();
+    serverLogger.info(`Closing ${sockets.length} active socket connections...`);
+    for (const socket of sockets) {
+      const quickdrawSocket = socket;
+      for (const service of registry.getServiceInstances()) {
+        try {
+          service.unsubscribeSocket(quickdrawSocket);
+        } catch {
+        }
+      }
+      socket.disconnect(true);
+    }
+    io.close(() => {
+      serverLogger.info("Socket.io server closed");
+      process.exit(0);
+    });
+    setTimeout(() => {
+      serverLogger.error("Graceful shutdown timeout, forcing exit");
+      process.exit(1);
+    }, 1e4);
+  };
+  process.on("SIGTERM", () => shutdown("SIGTERM"));
+  process.on("SIGINT", () => shutdown("SIGINT"));
   return { io, httpServer, registry };
 }
 

package/dist/server/testing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shared/types.ts","../../src/server/ServiceRegistry.ts","../../src/server/createServer.ts","../../src/server/testing.ts"],"names":["result","SocketIOServer","ioClient"],"mappings":"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","file":"testing.js","sourcesContent":["import type { z } from \"zod\";\n\n// ============================================================================\n// Access Control Types\n// ============================================================================\n\nexport type AccessLevel = \"Public\" | \"Read\" | \"Moderate\" | \"Admin\";\n\nexport type ACE = {\n  userId: string;\n  level: AccessLevel;\n};\n\nexport type ACL = ACE[];\n\n// ============================================================================\n// Service Response Types\n// ============================================================================\n\nexport type ServiceResponse<T = unknown> =\n  | { success: true; data: T }\n  | { success: false; error: string; code?: number };\n\n// ============================================================================\n// Service Method Definition Types\n// ============================================================================\n\n/**\n * Defines the shape of a service method including its payload and response types.\n * Used to create a type-safe contract between server and client.\n */\nexport interface ServiceMethodDefinition<\n  TPayload = unknown,\n  TResponse = unknown,\n> {\n  name: string;\n  access: AccessLevel;\n  handler: (\n    payload: TPayload,\n    context: ServiceMethodContext\n  ) => Promise<TResponse>;\n  schema?: z.ZodType<TPayload>;\n  resolveEntryId?: (payload: TPayload) => string | null;\n}\n\n/**\n * Context provided to service method handlers\n */\nexport interface ServiceMethodContext {\n  userId: string | undefined;\n  socketId: string;\n  serviceAccess: Record<string, AccessLevel>;\n}\n\n/**\n * Type helper for defining service method maps.\n * Each service should define its methods using this structure.\n *\n * @example\n * ```typescript\n * type ChatServiceMethods = ServiceMethodMap<{\n *   createChat: {\n *     payload: { title: string };\n *     response: { id: string };\n *   };\n *   updateTitle: {\n *     payload: { id: string; title: string };\n *     response: { id: string; title: string };\n *   };\n * }>;\n * ```\n */\nexport type ServiceMethodMap<\n  T extends Record<string, { payload: unknown; response: unknown }>,\n> = T;\n\n// ============================================================================\n// Admin Method Types (Generic shapes for all services)\n// ============================================================================\n\nexport type AdminListPayload = {\n  page?: number;\n  pageSize?: number;\n  sort?: {\n    field?: string;\n    direction?: \"asc\" | \"desc\";\n  };\n  filter?: {\n    id?: string;\n    ids?: string[];\n    createdAfter?: string;\n    createdBefore?: string;\n    updatedAfter?: string;\n    updatedBefore?: string;\n  } & Record<string, unknown>;\n};\n\nexport type AdminListResponse<T> = {\n  rows: T[];\n  page: number;\n  pageSize: number;\n  total: number;\n};\n\nexport type AdminGetPayload = { id: string };\n\nexport type AdminCreatePayload<TInsert> = { data: Partial<TInsert> };\n\nexport type AdminUpdatePayload<TInsert> = {\n  id: string;\n  data: Partial<TInsert>;\n};\n\nexport type AdminDeletePayload = { id: string };\nexport type AdminDeleteResponse = { id: string; deleted: true };\n\nexport type AdminSetEntryACLPayload = {\n  id: string;\n  acl: ACL;\n};\n\nexport type AdminGetSubscribersPayload = { id: string };\nexport type AdminGetSubscribersResponse = {\n  id: string;\n  subscribers: Array<{ socketId: string; userId?: string }>;\n};\n\nexport type AdminReemitPayload = { id: string };\nexport type AdminReemitResponse = { emitted: boolean };\n\nexport type AdminUnsubscribeAllPayload = { id: string };\nexport type AdminUnsubscribeAllResponse = { id: string; unsubscribed: number };\n\n// ============================================================================\n// Subscription Types\n// ============================================================================\n\nexport type SubscribePayload = {\n  entryId: string;\n  requiredLevel?: AccessLevel;\n};\n\nexport type UnsubscribePayload = {\n  entryId: string;\n};\n\n// ============================================================================\n// Utility Types\n// ============================================================================\n\n/**\n * Extracts payload type from a service method definition\n */\nexport type ExtractPayload<T> = T extends { payload: infer P } ? P : never;\n\n/**\n * Extracts response type from a service method definition\n */\nexport type ExtractResponse<T> = T extends { response: infer R } ? R : never;\n\n/**\n * Logger interface compatible with Winston and other loggers\n */\nexport interface Logger {\n  info(message: string, meta?: Record<string, unknown>): void;\n  warn(message: string, meta?: Record<string, unknown>): void;\n  error(message: string, meta?: Record<string, unknown>): void;\n  debug(message: string, meta?: Record<string, unknown>): void;\n  child(options: Record<string, unknown>): Logger;\n}\n\n/**\n * Default console logger implementation\n */\nexport const consoleLogger: Logger = {\n  info: (message, meta) => console.log(`[INFO] ${message}`, meta ?? \"\"),\n  warn: (message, meta) => console.warn(`[WARN] ${message}`, meta ?? \"\"),\n  error: (message, meta) => console.error(`[ERROR] ${message}`, meta ?? \"\"),\n  debug: (message, meta) => console.debug(`[DEBUG] ${message}`, meta ?? \"\"),\n  child: () => consoleLogger,\n};\n","import type { Server as SocketIOServer } from \"socket.io\";\nimport type {\n  ServiceResponse,\n  ServiceMethodDefinition,\n  Logger,\n} from \"../shared/types\";\nimport { consoleLogger } from \"../shared/types\";\nimport type {\n  QuickdrawSocket,\n  BaseServiceInstance,\n  ServiceRegistryInstance,\n} from \"./types\";\n\n/**\n * Central registry for auto-discovering and registering service methods as Socket.io events.\n *\n * Features:\n * - Auto-discovers public methods from registered services\n * - Wires methods to Socket.io events with standardized naming\n * - Handles subscription lifecycle\n * - Provides consistent error handling and logging\n *\n * @example\n * ```typescript\n * const registry = new ServiceRegistry(io, { logger });\n * registry.registerService('chatService', chatService);\n * registry.registerService('userService', userService);\n * ```\n */\nexport class ServiceRegistry implements ServiceRegistryInstance {\n  private readonly io: SocketIOServer;\n  private readonly services: Map<string, BaseServiceInstance> = new Map();\n  private readonly logger: Logger;\n\n  constructor(io: SocketIOServer, options?: { logger?: Logger }) {\n    this.io = io;\n    this.logger = options?.logger?.child({ service: \"ServiceRegistry\" }) ??\n      consoleLogger.child({ service: \"ServiceRegistry\" });\n  }\n\n  /**\n   * Register a service and auto-discover its public methods.\n   */\n  public registerService(\n    serviceName: string,\n    service: BaseServiceInstance\n  ): void {\n    this.services.set(serviceName, service);\n    this.logger.info(`Registered service: ${serviceName}`);\n\n    // Auto-discover and wire public methods\n    this.discoverServiceMethods(serviceName, service);\n  }\n\n  /**\n   * Discover and register all public methods from a service.\n   */\n  private discoverServiceMethods(\n    serviceName: string,\n    service: BaseServiceInstance\n  ): void {\n    const methods = service.getPublicMethods();\n\n    for (const method of methods) {\n      const eventName = `${serviceName}:${method.name}`;\n      this.logger.info(`Registering socket event: ${eventName}`);\n\n      // Register on connection\n      this.io.on(\"connection\", (socket) => {\n        this.registerMethodListener(\n          socket as QuickdrawSocket,\n          eventName,\n          method,\n          service\n        );\n      });\n    }\n\n    // Register subscription handlers\n    this.io.on(\"connection\", (socket) => {\n      this.registerSubscriptionListener(\n        socket as QuickdrawSocket,\n        `${serviceName}:subscribe`,\n        service\n      );\n      this.registerUnsubscriptionListener(\n        socket as QuickdrawSocket,\n        `${serviceName}:unsubscribe`,\n        service\n      );\n    });\n  }\n\n  /**\n   * Register a method as a socket event listener.\n   */\n  private registerMethodListener(\n    socket: QuickdrawSocket,\n    eventName: string,\n    method: ServiceMethodDefinition<unknown, unknown>,\n    service: BaseServiceInstance\n  ): void {\n    socket.on(\n      eventName,\n      async (\n        payload: unknown,\n        callback?: (response: ServiceResponse<unknown>) => void\n      ) => {\n        const startedAt = Date.now();\n        const [serviceName, methodName] = eventName.split(\":\");\n        const userIdShort = socket.userId?.slice(0, 8) ?? \"anon\";\n\n        try {\n          // Authentication check\n          if (!socket.userId && method.access !== \"Public\") {\n            const errorResponse: ServiceResponse<unknown> = {\n              success: false,\n              error: \"Authentication required\",\n              code: 401,\n            };\n            callback?.(errorResponse);\n            return;\n          }\n\n          // Validate payload with Zod schema if provided\n          let validatedPayload = payload;\n          if (method.schema) {\n            const result = method.schema.safeParse(payload);\n            if (!result.success) {\n              const errorResponse: ServiceResponse<unknown> = {\n                success: false,\n                error: `Validation error: ${result.error.message}`,\n                code: 400,\n              };\n              callback?.(errorResponse);\n              return;\n            }\n            validatedPayload = result.data;\n          }\n\n          // Resolve entry ID for access check\n          let entryId: string | undefined;\n          if (method.resolveEntryId) {\n            entryId = method.resolveEntryId(validatedPayload) ?? undefined;\n          } else if (\n            validatedPayload &&\n            typeof validatedPayload === \"object\" &&\n            \"id\" in validatedPayload\n          ) {\n            const idValue = (validatedPayload as Record<string, unknown>).id;\n            if (typeof idValue === \"string\") {\n              entryId = idValue;\n            }\n          }\n\n          // Check access\n          await service.ensureAccessForMethod(method.access, socket, entryId);\n\n          // Log start\n          this.logger.info(\n            `User ${userIdShort} ${serviceName}.${methodName} -> start`,\n            {\n              category: \"request_processing\",\n              serviceName,\n              methodName,\n              userId: socket.userId,\n              socketId: socket.id,\n            }\n          );\n\n          // Execute handler\n          const result = await method.handler(validatedPayload, {\n            userId: socket.userId,\n            socketId: socket.id,\n            serviceAccess: socket.serviceAccess ?? {},\n          });\n\n          const durationMs = Date.now() - startedAt;\n          this.logger.info(\n            `User ${userIdShort} ${serviceName}.${methodName} -> success`,\n            {\n              category: \"request_processing\",\n              outcome: \"success\",\n              durationMs,\n              serviceName,\n              methodName,\n              userId: socket.userId,\n            }\n          );\n\n          const successResponse: ServiceResponse<unknown> = {\n            success: true,\n            data: result,\n          };\n          callback?.(successResponse);\n        } catch (error) {\n          const durationMs = Date.now() - startedAt;\n          this.logger.error(\n            `User ${userIdShort} ${serviceName}.${methodName} -> fail`,\n            {\n              category: \"request_processing\",\n              outcome: \"fail\",\n              durationMs,\n              error: error instanceof Error ? error.message : \"Unknown error\",\n            }\n          );\n\n          const errorResponse: ServiceResponse<unknown> = {\n            success: false,\n            error: error instanceof Error ? error.message : \"Internal error\",\n            code: 500,\n          };\n          callback?.(errorResponse);\n        }\n      }\n    );\n  }\n\n  /**\n   * Register subscription listener for a service.\n   */\n  private registerSubscriptionListener(\n    socket: QuickdrawSocket,\n    eventName: string,\n    service: BaseServiceInstance\n  ): void {\n    socket.on(\n      eventName,\n      async (\n        payload: { entryId: string; requiredLevel?: string },\n        callback?: (response: ServiceResponse<unknown>) => void\n      ) => {\n        try {\n          if (!socket.userId) {\n            callback?.({\n              success: false,\n              error: \"Authentication required\",\n              code: 401,\n            });\n            return;\n          }\n\n          const data = await service.subscribe(\n            payload.entryId,\n            socket,\n            (payload.requiredLevel as \"Read\" | \"Moderate\" | \"Admin\") ?? \"Read\"\n          );\n\n          if (data === null) {\n            callback?.({\n              success: false,\n              error: \"Access denied or entry not found\",\n              code: 403,\n            });\n            return;\n          }\n\n          callback?.({ success: true, data });\n        } catch (error) {\n          this.logger.error(`Error in subscription ${eventName}:`, {\n            error: error instanceof Error ? error.message : \"Unknown error\",\n          });\n          callback?.({\n            success: false,\n            error: error instanceof Error ? error.message : \"Subscription failed\",\n          });\n        }\n      }\n    );\n  }\n\n  /**\n   * Register unsubscription listener for a service.\n   */\n  private registerUnsubscriptionListener(\n    socket: QuickdrawSocket,\n    eventName: string,\n    service: BaseServiceInstance\n  ): void {\n    socket.on(\n      eventName,\n      (\n        payload: { entryId: string },\n        callback?: (\n          response: ServiceResponse<{ unsubscribed: true; entryId: string }>\n        ) => void\n      ) => {\n        try {\n          service.unsubscribe(payload.entryId, socket);\n          callback?.({\n            success: true,\n            data: { unsubscribed: true, entryId: payload.entryId },\n          });\n        } catch (error) {\n          this.logger.error(`Error in unsubscription ${eventName}:`, {\n            error: error instanceof Error ? error.message : \"Unknown error\",\n          });\n          callback?.({\n            success: false,\n            error: error instanceof Error ? error.message : \"Unsubscription failed\",\n          });\n        }\n      }\n    );\n  }\n\n  /**\n   * Get list of registered service names.\n   */\n  public getServices(): string[] {\n    return Array.from(this.services.keys());\n  }\n\n  /**\n   * Get all service instances for lifecycle management.\n   */\n  public getServiceInstances(): BaseServiceInstance[] {\n    return Array.from(this.services.values());\n  }\n}\n","import express from \"express\";\nimport { createServer } from \"http\";\nimport { Server as SocketIOServer } from \"socket.io\";\nimport { consoleLogger } from \"../shared/types\";\nimport type {\n  QuickdrawSocket,\n  QuickdrawServerOptions,\n  QuickdrawServerResult,\n} from \"./types\";\nimport { ServiceRegistry } from \"./ServiceRegistry\";\n\n/**\n * Create a fully configured quickdraw server with one function call.\n *\n * @example\n * ```typescript\n * import { createQuickdrawServer } from '@quickdraw/core/server';\n * import { ChatService, UserService } from './services';\n *\n * const { io, httpServer, registry } = createQuickdrawServer({\n *   port: 4000,\n *   cors: { origin: 'http://localhost:3000' },\n *   services: {\n *     chatService: new ChatService(prisma),\n *     userService: new UserService(prisma),\n *   },\n *   auth: {\n *     authenticate: async (socket, auth) => {\n *       // Verify JWT and return userId\n *       const payload = await verifyJWT(auth.token);\n *       return payload.userId;\n *     },\n *   },\n * });\n * ```\n */\nexport function createQuickdrawServer(\n  options: QuickdrawServerOptions\n): QuickdrawServerResult {\n  const logger = options.logger ?? consoleLogger;\n  const serverLogger = logger.child({ service: \"QuickdrawServer\" });\n\n  // Create Express app with basic middleware\n  const app = express();\n  app.use(express.json());\n\n  // Health check endpoint\n  app.get(\"/health\", (_req, res) => {\n    res.json({ status: \"ok\", timestamp: new Date().toISOString() });\n  });\n\n  // Create HTTP server\n  const httpServer = createServer(app);\n\n  // Create Socket.io server\n  const io = new SocketIOServer(httpServer, {\n    cors: {\n      origin: options.cors?.origin ?? \"*\",\n      methods: options.cors?.methods ?? [\"GET\", \"POST\"],\n      credentials: options.cors?.credentials ?? true,\n    },\n  });\n\n  // Create service registry\n  const registry = new ServiceRegistry(io, { logger });\n\n  // Apply authentication middleware\n  io.use(async (socket, next) => {\n    const quickdrawSocket = socket as QuickdrawSocket;\n\n    try {\n      if (options.auth?.authenticate) {\n        const auth = socket.handshake.auth as Record<string, unknown>;\n        const userId = await options.auth.authenticate(quickdrawSocket, auth);\n        quickdrawSocket.userId = userId;\n\n        // TODO: Load service access from user record\n        // For now, default to empty service access\n        quickdrawSocket.serviceAccess = {};\n      }\n      next();\n    } catch (error) {\n      serverLogger.error(\"Authentication failed\", {\n        error: error instanceof Error ? error.message : \"Unknown error\",\n        socketId: socket.id,\n      });\n      next(new Error(\"Authentication failed\"));\n    }\n  });\n\n  // Register services\n  for (const [serviceName, service] of Object.entries(options.services)) {\n    registry.registerService(serviceName, service);\n  }\n\n  // Handle connection lifecycle\n  io.on(\"connection\", (socket) => {\n    const quickdrawSocket = socket as QuickdrawSocket;\n    serverLogger.info(\"Socket connected\", {\n      socketId: quickdrawSocket.id,\n      userId: quickdrawSocket.userId,\n    });\n\n    quickdrawSocket.on(\"disconnect\", () => {\n      serverLogger.info(\"Socket disconnected\", {\n        socketId: quickdrawSocket.id,\n        userId: quickdrawSocket.userId,\n      });\n\n      // Cleanup subscriptions across all services\n      for (const service of registry.getServiceInstances()) {\n        try {\n          service.unsubscribeSocket(quickdrawSocket);\n        } catch {\n          // Ignore cleanup errors\n        }\n      }\n    });\n  });\n\n  // Start listening\n  httpServer.listen(options.port, \"0.0.0.0\", () => {\n    serverLogger.info(`Server listening on port ${options.port}`);\n    serverLogger.info(\n      `Registered services: ${registry.getServices().join(\", \")}`\n    );\n  });\n\n  return { io, httpServer, registry };\n}\n","import { io as ioClient, Socket } from \"socket.io-client\";\nimport type { ServiceResponse } from \"../shared/types\";\nimport type { BaseServiceInstance, QuickdrawServerResult } from \"./types\";\nimport { createQuickdrawServer } from \"./createServer\";\n\n/**\n * Options for creating a test server.\n */\nexport interface CreateTestServerOptions {\n  services: Record<string, BaseServiceInstance>;\n  seedDb?: () => Promise<void>;\n}\n\n/**\n * Test server instance with helper methods.\n */\nexport interface TestServer {\n  port: number;\n  result: QuickdrawServerResult;\n  stop: () => Promise<void>;\n  connectAs: (userId: string) => Promise<TestClient>;\n}\n\n/**\n * Test client instance with helper methods.\n */\nexport interface TestClient {\n  socket: Socket;\n  emit: <TPayload, TResponse>(\n    event: string,\n    payload: TPayload\n  ) => Promise<TResponse>;\n  close: () => void;\n}\n\nlet nextPort = 10000;\n\n/**\n * Get an available port for testing.\n */\nexport function getAvailablePort(): number {\n  return nextPort++;\n}\n\n/**\n * Create a test server with dev authentication.\n *\n * @example\n * ```typescript\n * const server = await createTestServer({\n *   services: {\n *     chatService: new ChatService(testPrisma),\n *   },\n *   seedDb: async () => {\n *     await testPrisma.user.create({ ... });\n *   },\n * });\n *\n * const client = await server.connectAs('user-id-123');\n * const result = await client.emit('chatService:createChat', { title: 'Test' });\n *\n * await server.stop();\n * ```\n */\nexport async function createTestServer(\n  options: CreateTestServerOptions\n): Promise<TestServer> {\n  const port = getAvailablePort();\n\n  const result = createQuickdrawServer({\n    port,\n    services: options.services,\n    auth: {\n      // Dev mode: accept userId directly from auth\n      authenticate: async (_socket, auth) => {\n        return auth.userId as string | undefined;\n      },\n    },\n  });\n\n  // Wait for server to start\n  await new Promise<void>((resolve) => {\n    result.httpServer.once(\"listening\", resolve);\n  });\n\n  // Seed database if provided\n  if (options.seedDb) {\n    await options.seedDb();\n  }\n\n  return {\n    port,\n    result,\n    stop: () =>\n      new Promise<void>((resolve) => {\n        result.io.close();\n        result.httpServer.close(() => resolve());\n      }),\n    connectAs: (userId: string) => connectAsUser(port, userId),\n  };\n}\n\n/**\n * Connect to a test server as a specific user.\n */\nexport async function connectAsUser(\n  port: number,\n  userId: string\n): Promise<TestClient> {\n  const socket = ioClient(`http://localhost:${port}`, {\n    auth: { userId },\n    transports: [\"websocket\"],\n    autoConnect: true,\n  });\n\n  await new Promise<void>((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      reject(new Error(\"Connection timeout\"));\n    }, 5000);\n\n    socket.on(\"connect\", () => {\n      clearTimeout(timeout);\n      resolve();\n    });\n\n    socket.on(\"connect_error\", (err) => {\n      clearTimeout(timeout);\n      reject(err);\n    });\n  });\n\n  return {\n    socket,\n    emit: <TPayload, TResponse>(event: string, payload: TPayload) =>\n      emitWithAck<TPayload, TResponse>(socket, event, payload),\n    close: () => socket.close(),\n  };\n}\n\n/**\n * Emit an event and wait for acknowledgment.\n */\nexport function emitWithAck<TPayload, TResponse>(\n  socket: Socket,\n  event: string,\n  payload: TPayload,\n  timeoutMs: number = 5000\n): Promise<TResponse> {\n  return new Promise((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      reject(new Error(`Timeout waiting for ${event}`));\n    }, timeoutMs);\n\n    socket.emit(event, payload, (response: ServiceResponse<TResponse>) => {\n      clearTimeout(timeout);\n\n      if (response.success) {\n        resolve(response.data);\n      } else {\n        reject(new Error(response.error));\n      }\n    });\n  });\n}\n\n/**\n * Wait for a specific socket event.\n */\nexport function waitForEvent<T>(\n  socket: Socket,\n  event: string,\n  timeoutMs: number = 5000\n): Promise<T> {\n  return new Promise((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      socket.off(event, handler);\n      reject(new Error(`Timeout waiting for event ${event}`));\n    }, timeoutMs);\n\n    const handler = (data: T) => {\n      clearTimeout(timeout);\n      socket.off(event, handler);\n      resolve(data);\n    };\n\n    socket.on(event, handler);\n  });\n}\n"]}
+{"version":3,"sources":["../../src/shared/types.ts","../../src/server/ServiceRegistry.ts","../../src/server/createServer.ts","../../src/server/testing.ts"],"names":["result","SocketIOServer","ioClient"],"mappings":"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","file":"testing.js","sourcesContent":["import type { z } from \"zod\";\n\n// ============================================================================\n// Access Control Types\n// ============================================================================\n\nexport type AccessLevel = \"Public\" | \"Read\" | \"Moderate\" | \"Admin\";\n\nexport type ACE = {\n  userId: string;\n  level: AccessLevel;\n};\n\nexport type ACL = ACE[];\n\n// ============================================================================\n// Entity and User Interfaces for ACL\n// ============================================================================\n\n/**\n * Interface for entities that support entry-level ACL stored as JSON.\n *\n * Use this pattern when:\n * - You want simple ACL without a separate membership table\n * - Access patterns are straightforward (read/write permissions)\n * - You don't need to query \"all entities user X can access\" efficiently\n *\n * The default `checkEntryACL` in BaseService expects entities to have this shape.\n *\n * @example\n * ```prisma\n * model Document {\n *   id    String @id @default(cuid())\n *   title String\n *   acl   Json?  // Stores ACL array\n * }\n * ```\n *\n * @example\n * ```typescript\n * class DocumentService extends BaseService<Document & ACLEntity, ...> {\n *   constructor(prisma: PrismaClient) {\n *     super({ serviceName: 'documentService', hasEntryACL: true });\n *     this.setDelegate(prisma.document);\n *     // Default checkEntryACL will work automatically\n *   }\n * }\n * ```\n */\nexport interface ACLEntity {\n  id: string;\n  acl?: ACL | null;\n}\n\n/**\n * Interface for users with service-level access control.\n *\n * The `serviceAccess` field maps service names to access levels, granting\n * blanket permissions across all entries in that service.\n *\n * @example\n * ```prisma\n * model User {\n *   id            String @id @default(cuid())\n *   serviceAccess Json?  // { \"chatService\": \"Admin\", \"documentService\": \"Read\" }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // User with Admin access to chatService can perform any operation\n * // on any chat, regardless of entry-level ACL\n * const user: QuickdrawUser = {\n *   id: \"user-123\",\n *   serviceAccess: { chatService: \"Admin\" }\n * };\n * ```\n */\nexport interface QuickdrawUser {\n  id: string;\n  serviceAccess?: Record<string, AccessLevel> | null;\n}\n\n// ============================================================================\n// Service Response Types\n// ============================================================================\n\nexport type ServiceResponse<T = unknown> =\n  | { success: true; data: T }\n  | { success: false; error: string; code?: number };\n\n// ============================================================================\n// Service Method Definition Types\n// ============================================================================\n\n/**\n * Defines the shape of a service method including its payload and response types.\n * Used to create a type-safe contract between server and client.\n */\nexport interface ServiceMethodDefinition<\n  TPayload = unknown,\n  TResponse = unknown,\n> {\n  name: string;\n  access: AccessLevel;\n  handler: (\n    payload: TPayload,\n    context: ServiceMethodContext\n  ) => Promise<TResponse>;\n  schema?: z.ZodType<TPayload>;\n  resolveEntryId?: (payload: TPayload) => string | null;\n}\n\n/**\n * Context provided to service method handlers\n */\nexport interface ServiceMethodContext {\n  userId: string | undefined;\n  socketId: string;\n  serviceAccess: Record<string, AccessLevel>;\n}\n\n/**\n * Type helper for defining service method maps.\n * Each service should define its methods using this structure.\n *\n * @example\n * ```typescript\n * type ChatServiceMethods = ServiceMethodMap<{\n *   createChat: {\n *     payload: { title: string };\n *     response: { id: string };\n *   };\n *   updateTitle: {\n *     payload: { id: string; title: string };\n *     response: { id: string; title: string };\n *   };\n * }>;\n * ```\n */\nexport type ServiceMethodMap<\n  T extends Record<string, { payload: unknown; response: unknown }>,\n> = T;\n\n// ============================================================================\n// Admin Method Types (Generic shapes for all services)\n// ============================================================================\n\nexport type AdminListPayload = {\n  page?: number;\n  pageSize?: number;\n  sort?: {\n    field?: string;\n    direction?: \"asc\" | \"desc\";\n  };\n  filter?: {\n    id?: string;\n    ids?: string[];\n    createdAfter?: string;\n    createdBefore?: string;\n    updatedAfter?: string;\n    updatedBefore?: string;\n  } & Record<string, unknown>;\n};\n\nexport type AdminListResponse<T> = {\n  rows: T[];\n  page: number;\n  pageSize: number;\n  total: number;\n};\n\nexport type AdminGetPayload = { id: string };\n\nexport type AdminCreatePayload<TInsert> = { data: Partial<TInsert> };\n\nexport type AdminUpdatePayload<TInsert> = {\n  id: string;\n  data: Partial<TInsert>;\n};\n\nexport type AdminDeletePayload = { id: string };\nexport type AdminDeleteResponse = { id: string; deleted: true };\n\nexport type AdminSetEntryACLPayload = {\n  id: string;\n  acl: ACL;\n};\n\nexport type AdminGetSubscribersPayload = { id: string };\nexport type AdminGetSubscribersResponse = {\n  id: string;\n  subscribers: Array<{ socketId: string; userId?: string }>;\n};\n\nexport type AdminReemitPayload = { id: string };\nexport type AdminReemitResponse = { emitted: boolean };\n\nexport type AdminUnsubscribeAllPayload = { id: string };\nexport type AdminUnsubscribeAllResponse = { id: string; unsubscribed: number };\n\n// ============================================================================\n// Admin Field Configuration Types\n// ============================================================================\n\n/**\n * Supported field types for admin UI generation.\n */\nexport type AdminFieldType =\n  | \"string\"\n  | \"number\"\n  | \"boolean\"\n  | \"date\"\n  | \"enum\"\n  | \"json\"\n  | \"relation\";\n\n/**\n * Configuration for a single field in the admin UI.\n * Derived from Zod schemas with optional overrides.\n */\nexport interface AdminFieldConfig {\n  /** Field name (property key on the entity) */\n  name: string;\n  /** Field type for rendering appropriate input */\n  type: AdminFieldType;\n  /** Human-readable label */\n  label: string;\n  /** Whether the field is required for creation */\n  required: boolean;\n  /** Whether the field can be edited (false for id, createdAt, etc.) */\n  editable: boolean;\n  /** Whether to show this field as a table column */\n  showInTable: boolean;\n  /** Whether the table can be sorted by this field */\n  sortable: boolean;\n  /** For enum fields, the allowed values */\n  enumValues?: string[];\n  /** For relation fields, the related service name */\n  relationService?: string;\n}\n\n/**\n * Service metadata for admin UI generation.\n * Returned by the adminMeta method.\n */\nexport interface AdminServiceMeta {\n  /** Internal service name (e.g., \"chatService\") */\n  serviceName: string;\n  /** Human-readable display name (e.g., \"Chats\") */\n  displayName: string;\n  /** Field configurations derived from schema */\n  fields: AdminFieldConfig[];\n}\n\n/**\n * Payload for adminMeta method (no parameters needed)\n */\nexport type AdminMetaPayload = Record<string, never>;\n\n/**\n * Response type for adminMeta method\n */\nexport type AdminMetaResponse = AdminServiceMeta;\n\n// ============================================================================\n// Subscription Types\n// ============================================================================\n\nexport type SubscribePayload = {\n  entryId: string;\n  requiredLevel?: AccessLevel;\n};\n\nexport type UnsubscribePayload = {\n  entryId: string;\n};\n\n// ============================================================================\n// Utility Types\n// ============================================================================\n\n/**\n * Extracts payload type from a service method definition\n */\nexport type ExtractPayload<T> = T extends { payload: infer P } ? P : never;\n\n/**\n * Extracts response type from a service method definition\n */\nexport type ExtractResponse<T> = T extends { response: infer R } ? R : never;\n\n/**\n * Logger interface compatible with Winston and other loggers\n */\nexport interface Logger {\n  info(message: string, meta?: Record<string, unknown>): void;\n  warn(message: string, meta?: Record<string, unknown>): void;\n  error(message: string, meta?: Record<string, unknown>): void;\n  debug(message: string, meta?: Record<string, unknown>): void;\n  child(options: Record<string, unknown>): Logger;\n}\n\n/**\n * Default console logger implementation\n */\nexport const consoleLogger: Logger = {\n  info: (message, meta) => console.log(`[INFO] ${message}`, meta ?? \"\"),\n  warn: (message, meta) => console.warn(`[WARN] ${message}`, meta ?? \"\"),\n  error: (message, meta) => console.error(`[ERROR] ${message}`, meta ?? \"\"),\n  debug: (message, meta) => console.debug(`[DEBUG] ${message}`, meta ?? \"\"),\n  child: () => consoleLogger,\n};\n","import type { Server as SocketIOServer } from \"socket.io\";\nimport type {\n  ServiceResponse,\n  ServiceMethodDefinition,\n  Logger,\n} from \"../shared/types\";\nimport { consoleLogger } from \"../shared/types\";\nimport type {\n  QuickdrawSocket,\n  BaseServiceInstance,\n  ServiceRegistryInstance,\n} from \"./types\";\n\n/**\n * Central registry for auto-discovering and registering service methods as Socket.io events.\n *\n * Features:\n * - Auto-discovers public methods from registered services\n * - Wires methods to Socket.io events with standardized naming\n * - Handles subscription lifecycle\n * - Provides consistent error handling and logging\n * - Uses a single connection handler for all services (memory efficient)\n *\n * @example\n * ```typescript\n * const registry = new ServiceRegistry(io, { logger });\n * registry.registerService('chatService', chatService);\n * registry.registerService('userService', userService);\n * ```\n */\nexport interface ServiceRegistryOptions {\n  logger?: Logger;\n  /**\n   * Automatic method logging configuration.\n   * @default { enabled: true, logPayloads: false, logResponses: false }\n   */\n  methodLogging?: {\n    enabled?: boolean;\n    logPayloads?: boolean;\n    logResponses?: boolean;\n  };\n}\n\nexport class ServiceRegistry implements ServiceRegistryInstance {\n  private readonly io: SocketIOServer;\n  private readonly services: Map<string, BaseServiceInstance> = new Map();\n  private readonly logger: Logger;\n  private readonly methodLoggingEnabled: boolean;\n  private readonly logPayloads: boolean;\n  private readonly logResponses: boolean;\n  private connectionHandlerInstalled = false;\n\n  // Store method metadata for deferred registration\n  private readonly methodRegistry: Map<\n    string,\n    {\n      serviceName: string;\n      method: ServiceMethodDefinition<unknown, unknown>;\n      service: BaseServiceInstance;\n    }\n  > = new Map();\n\n  constructor(io: SocketIOServer, options?: ServiceRegistryOptions) {\n    this.io = io;\n    this.logger =\n      options?.logger?.child({ service: \"ServiceRegistry\" }) ??\n      consoleLogger.child({ service: \"ServiceRegistry\" });\n    \n    // Method logging configuration (enabled by default)\n    this.methodLoggingEnabled = options?.methodLogging?.enabled ?? true;\n    this.logPayloads = options?.methodLogging?.logPayloads ?? false;\n    this.logResponses = options?.methodLogging?.logResponses ?? false;\n\n    if (this.methodLoggingEnabled) {\n      this.logger.info(\"Automatic method logging enabled\", {\n        logPayloads: this.logPayloads,\n        logResponses: this.logResponses,\n      });\n    }\n  }\n\n  /**\n   * Install the single connection handler that wires all registered services.\n   * This is called lazily on first service registration.\n   */\n  private installConnectionHandler(): void {\n    if (this.connectionHandlerInstalled) return;\n    this.connectionHandlerInstalled = true;\n\n    this.io.on(\"connection\", (socket) => {\n      const quickdrawSocket = socket as QuickdrawSocket;\n      this.setupSocketListeners(quickdrawSocket);\n    });\n\n    this.logger.info(\"Installed single connection handler for all services\");\n  }\n\n  /**\n   * Set up all event listeners for a newly connected socket.\n   */\n  private setupSocketListeners(socket: QuickdrawSocket): void {\n    // Register method listeners for all registered services\n    for (const [eventName, { method, service }] of this.methodRegistry) {\n      this.registerMethodListener(socket, eventName, method, service);\n    }\n\n    // Register subscription/unsubscription listeners for all services\n    for (const [serviceName, service] of this.services) {\n      this.registerSubscriptionListener(\n        socket,\n        `${serviceName}:subscribe`,\n        service\n      );\n      this.registerUnsubscriptionListener(\n        socket,\n        `${serviceName}:unsubscribe`,\n        service\n      );\n    }\n  }\n\n  /**\n   * Register a service and auto-discover its public methods.\n   */\n  public registerService(\n    serviceName: string,\n    service: BaseServiceInstance\n  ): void {\n    this.services.set(serviceName, service);\n\n    // Pass io instance to service for room-based broadcasts\n    if (service.setIo) {\n      service.setIo(this.io);\n    }\n\n    this.logger.info(`Registered service: ${serviceName}`);\n\n    // Auto-discover and store method metadata\n    this.discoverServiceMethods(serviceName, service);\n\n    // Ensure connection handler is installed\n    this.installConnectionHandler();\n  }\n\n  /**\n   * Discover and store all public methods from a service.\n   */\n  private discoverServiceMethods(\n    serviceName: string,\n    service: BaseServiceInstance\n  ): void {\n    const methods = service.getPublicMethods();\n\n    for (const method of methods) {\n      const eventName = `${serviceName}:${method.name}`;\n      this.logger.info(`Registering socket event: ${eventName}`);\n\n      // Store method metadata for deferred registration on connection\n      this.methodRegistry.set(eventName, {\n        serviceName,\n        method,\n        service,\n      });\n    }\n  }\n\n  /**\n   * Register a method as a socket event listener.\n   */\n  private registerMethodListener(\n    socket: QuickdrawSocket,\n    eventName: string,\n    method: ServiceMethodDefinition<unknown, unknown>,\n    service: BaseServiceInstance\n  ): void {\n    socket.on(\n      eventName,\n      async (\n        payload: unknown,\n        callback?: (response: ServiceResponse<unknown>) => void\n      ) => {\n        const startedAt = Date.now();\n        const [serviceName, methodName] = eventName.split(\":\");\n        const userIdShort = socket.userId?.slice(0, 8) ?? \"anon\";\n\n        try {\n          // Authentication check\n          if (!socket.userId && method.access !== \"Public\") {\n            const errorResponse: ServiceResponse<unknown> = {\n              success: false,\n              error: \"Authentication required\",\n              code: 401,\n            };\n            callback?.(errorResponse);\n            return;\n          }\n\n          // Validate payload with Zod schema if provided\n          let validatedPayload = payload;\n          if (method.schema) {\n            const result = method.schema.safeParse(payload);\n            if (!result.success) {\n              const errorResponse: ServiceResponse<unknown> = {\n                success: false,\n                error: `Validation error: ${result.error.message}`,\n                code: 400,\n              };\n              callback?.(errorResponse);\n              return;\n            }\n            validatedPayload = result.data;\n          }\n\n          // Resolve entry ID for access check\n          let entryId: string | undefined;\n          if (method.resolveEntryId) {\n            entryId = method.resolveEntryId(validatedPayload) ?? undefined;\n          } else if (\n            validatedPayload &&\n            typeof validatedPayload === \"object\" &&\n            \"id\" in validatedPayload\n          ) {\n            const idValue = (validatedPayload as Record<string, unknown>).id;\n            if (typeof idValue === \"string\") {\n              entryId = idValue;\n            }\n          }\n\n          // Check access\n          await service.ensureAccessForMethod(method.access, socket, entryId);\n\n          // Log start (if enabled)\n          if (this.methodLoggingEnabled) {\n            const logContext: Record<string, unknown> = {\n              category: \"request_processing\",\n              serviceName,\n              methodName,\n              userId: socket.userId,\n              socketId: socket.id,\n            };\n            if (this.logPayloads) {\n              logContext.payload = validatedPayload;\n            }\n            this.logger.info(\n              `User ${userIdShort} ${serviceName}.${methodName} -> start`,\n              logContext\n            );\n          }\n\n          // Execute handler\n          const result = await method.handler(validatedPayload, {\n            userId: socket.userId,\n            socketId: socket.id,\n            serviceAccess: socket.serviceAccess ?? {},\n          });\n\n          // Log success (if enabled)\n          if (this.methodLoggingEnabled) {\n            const durationMs = Date.now() - startedAt;\n            const logContext: Record<string, unknown> = {\n              category: \"request_processing\",\n              outcome: \"success\",\n              durationMs,\n              serviceName,\n              methodName,\n              userId: socket.userId,\n            };\n            if (this.logResponses) {\n              logContext.response = result;\n            }\n            this.logger.info(\n              `User ${userIdShort} ${serviceName}.${methodName} -> success`,\n              logContext\n            );\n          }\n\n          const successResponse: ServiceResponse<unknown> = {\n            success: true,\n            data: result,\n          };\n          callback?.(successResponse);\n        } catch (error) {\n          // Always log errors, even if methodLogging is disabled\n          const durationMs = Date.now() - startedAt;\n          const logContext: Record<string, unknown> = {\n            category: \"request_processing\",\n            outcome: \"fail\",\n            durationMs,\n            serviceName,\n            methodName,\n            userId: socket.userId,\n            socketId: socket.id,\n            error: error instanceof Error ? error.message : \"Unknown error\",\n          };\n          if (this.logPayloads) {\n            logContext.payload = payload;\n          }\n          this.logger.error(\n            `User ${userIdShort} ${serviceName}.${methodName} -> fail`,\n            logContext\n          );\n\n          const errorResponse: ServiceResponse<unknown> = {\n            success: false,\n            error: error instanceof Error ? error.message : \"Internal error\",\n            code: 500,\n          };\n          callback?.(errorResponse);\n        }\n      }\n    );\n  }\n\n  /**\n   * Register subscription listener for a service.\n   */\n  private registerSubscriptionListener(\n    socket: QuickdrawSocket,\n    eventName: string,\n    service: BaseServiceInstance\n  ): void {\n    socket.on(\n      eventName,\n      async (\n        payload: { entryId: string; requiredLevel?: string },\n        callback?: (response: ServiceResponse<unknown>) => void\n      ) => {\n        try {\n          if (!socket.userId) {\n            callback?.({\n              success: false,\n              error: \"Authentication required\",\n              code: 401,\n            });\n            return;\n          }\n\n          const data = await service.subscribe(\n            payload.entryId,\n            socket,\n            (payload.requiredLevel as \"Read\" | \"Moderate\" | \"Admin\") ?? \"Read\"\n          );\n\n          if (data === null) {\n            callback?.({\n              success: false,\n              error: \"Access denied or entry not found\",\n              code: 403,\n            });\n            return;\n          }\n\n          callback?.({ success: true, data });\n        } catch (error) {\n          this.logger.error(`Error in subscription ${eventName}:`, {\n            error: error instanceof Error ? error.message : \"Unknown error\",\n          });\n          callback?.({\n            success: false,\n            error:\n              error instanceof Error ? error.message : \"Subscription failed\",\n          });\n        }\n      }\n    );\n  }\n\n  /**\n   * Register unsubscription listener for a service.\n   */\n  private registerUnsubscriptionListener(\n    socket: QuickdrawSocket,\n    eventName: string,\n    service: BaseServiceInstance\n  ): void {\n    socket.on(\n      eventName,\n      (\n        payload: { entryId: string },\n        callback?: (\n          response: ServiceResponse<{ unsubscribed: true; entryId: string }>\n        ) => void\n      ) => {\n        try {\n          service.unsubscribe(payload.entryId, socket);\n          callback?.({\n            success: true,\n            data: { unsubscribed: true, entryId: payload.entryId },\n          });\n        } catch (error) {\n          this.logger.error(`Error in unsubscription ${eventName}:`, {\n            error: error instanceof Error ? error.message : \"Unknown error\",\n          });\n          callback?.({\n            success: false,\n            error:\n              error instanceof Error ? error.message : \"Unsubscription failed\",\n          });\n        }\n      }\n    );\n  }\n\n  /**\n   * Get list of registered service names.\n   */\n  public getServices(): string[] {\n    return Array.from(this.services.keys());\n  }\n\n  /**\n   * Get all service instances for lifecycle management.\n   */\n  public getServiceInstances(): BaseServiceInstance[] {\n    return Array.from(this.services.values());\n  }\n}\n","import express from \"express\";\nimport { createServer } from \"http\";\nimport { Server as SocketIOServer } from \"socket.io\";\nimport { consoleLogger } from \"../shared/types\";\nimport type {\n  QuickdrawSocket,\n  QuickdrawServerOptions,\n  QuickdrawServerResult,\n} from \"./types\";\nimport { ServiceRegistry } from \"./ServiceRegistry\";\n\n/**\n * Create a fully configured quickdraw server with one function call.\n *\n * @example\n * ```typescript\n * import { createQuickdrawServer } from '@quickdraw/core/server';\n * import { ChatService, UserService } from './services';\n *\n * const { io, httpServer, registry } = createQuickdrawServer({\n *   port: 4000,\n *   cors: { origin: 'http://localhost:3000' },\n *   services: {\n *     chatService: new ChatService(prisma),\n *     userService: new UserService(prisma),\n *   },\n *   auth: {\n *     authenticate: async (socket, auth) => {\n *       // Verify JWT and return userId\n *       const payload = await verifyJWT(auth.token);\n *       return payload.userId;\n *     },\n *   },\n * });\n * ```\n */\nexport function createQuickdrawServer(\n  options: QuickdrawServerOptions\n): QuickdrawServerResult {\n  const logger = options.logger ?? consoleLogger;\n  const serverLogger = logger.child({ service: \"QuickdrawServer\" });\n\n  // Create Express app with basic middleware\n  const app = express();\n  app.use(express.json());\n\n  // Health check endpoint\n  app.get(\"/health\", (_req, res) => {\n    res.json({ status: \"ok\", timestamp: new Date().toISOString() });\n  });\n\n  // Create HTTP server\n  const httpServer = createServer(app);\n\n  // Create Socket.io server\n  const io = new SocketIOServer(httpServer, {\n    cors: {\n      origin: options.cors?.origin ?? \"*\",\n      methods: options.cors?.methods ?? [\"GET\", \"POST\"],\n      credentials: options.cors?.credentials ?? true,\n    },\n  });\n\n  // Create service registry with method logging configuration\n  const registry = new ServiceRegistry(io, { \n    logger,\n    methodLogging: options.methodLogging,\n  });\n\n  // Apply authentication middleware\n  io.use(async (socket, next) => {\n    const quickdrawSocket = socket as QuickdrawSocket;\n\n    try {\n      if (options.auth?.authenticate) {\n        const auth = socket.handshake.auth as Record<string, unknown>;\n        const userId = await options.auth.authenticate(quickdrawSocket, auth);\n        quickdrawSocket.userId = userId;\n\n        // TODO: Load service access from user record\n        // For now, default to empty service access\n        quickdrawSocket.serviceAccess = {};\n      }\n      next();\n    } catch (error) {\n      serverLogger.error(\"Authentication failed\", {\n        error: error instanceof Error ? error.message : \"Unknown error\",\n        socketId: socket.id,\n      });\n      next(new Error(\"Authentication failed\"));\n    }\n  });\n\n  // Register services\n  for (const [serviceName, service] of Object.entries(options.services)) {\n    registry.registerService(serviceName, service);\n  }\n\n  // Handle connection lifecycle\n  io.on(\"connection\", (socket) => {\n    const quickdrawSocket = socket as QuickdrawSocket;\n    serverLogger.info(\"Socket connected\", {\n      socketId: quickdrawSocket.id,\n      userId: quickdrawSocket.userId,\n    });\n\n    quickdrawSocket.on(\"disconnect\", () => {\n      serverLogger.info(\"Socket disconnected\", {\n        socketId: quickdrawSocket.id,\n        userId: quickdrawSocket.userId,\n      });\n\n      // Cleanup subscriptions across all services\n      for (const service of registry.getServiceInstances()) {\n        try {\n          service.unsubscribeSocket(quickdrawSocket);\n        } catch {\n          // Ignore cleanup errors\n        }\n      }\n    });\n  });\n\n  // Start listening\n  httpServer.listen(options.port, \"0.0.0.0\", () => {\n    serverLogger.info(`Server listening on port ${options.port}`);\n    serverLogger.info(\n      `Registered services: ${registry.getServices().join(\", \")}`\n    );\n  });\n\n  // Graceful shutdown handler\n  const shutdown = async (signal: string) => {\n    serverLogger.info(`Received ${signal}, starting graceful shutdown...`);\n\n    // Stop accepting new connections\n    httpServer.close(() => {\n      serverLogger.info(\"HTTP server closed\");\n    });\n\n    // Close all Socket.io connections gracefully\n    const sockets = await io.fetchSockets();\n    serverLogger.info(`Closing ${sockets.length} active socket connections...`);\n\n    for (const socket of sockets) {\n      const quickdrawSocket = socket as unknown as QuickdrawSocket;\n      \n      // Unsubscribe from all services\n      for (const service of registry.getServiceInstances()) {\n        try {\n          service.unsubscribeSocket(quickdrawSocket);\n        } catch {\n          // Ignore cleanup errors\n        }\n      }\n\n      // Disconnect socket\n      socket.disconnect(true);\n    }\n\n    // Close Socket.io server\n    io.close(() => {\n      serverLogger.info(\"Socket.io server closed\");\n      process.exit(0);\n    });\n\n    // Force exit after timeout\n    setTimeout(() => {\n      serverLogger.error(\"Graceful shutdown timeout, forcing exit\");\n      process.exit(1);\n    }, 10000); // 10 second timeout\n  };\n\n  // Register shutdown handlers\n  process.on(\"SIGTERM\", () => shutdown(\"SIGTERM\"));\n  process.on(\"SIGINT\", () => shutdown(\"SIGINT\"));\n\n  return { io, httpServer, registry };\n}\n","import { io as ioClient, Socket } from \"socket.io-client\";\nimport type { ServiceResponse } from \"../shared/types\";\nimport type { BaseServiceInstance, QuickdrawServerResult } from \"./types\";\nimport { createQuickdrawServer } from \"./createServer\";\n\n/**\n * Options for creating a test server.\n */\nexport interface CreateTestServerOptions {\n  services: Record<string, BaseServiceInstance>;\n  seedDb?: () => Promise<void>;\n}\n\n/**\n * Test server instance with helper methods.\n */\nexport interface TestServer {\n  port: number;\n  result: QuickdrawServerResult;\n  stop: () => Promise<void>;\n  connectAs: (userId: string) => Promise<TestClient>;\n}\n\n/**\n * Test client instance with helper methods.\n */\nexport interface TestClient {\n  socket: Socket;\n  emit: <TPayload, TResponse>(\n    event: string,\n    payload: TPayload\n  ) => Promise<TResponse>;\n  close: () => void;\n}\n\nlet nextPort = 10000;\n\n/**\n * Get an available port for testing.\n */\nexport function getAvailablePort(): number {\n  return nextPort++;\n}\n\n/**\n * Create a test server with dev authentication.\n *\n * @example\n * ```typescript\n * const server = await createTestServer({\n *   services: {\n *     chatService: new ChatService(testPrisma),\n *   },\n *   seedDb: async () => {\n *     await testPrisma.user.create({ ... });\n *   },\n * });\n *\n * const client = await server.connectAs('user-id-123');\n * const result = await client.emit('chatService:createChat', { title: 'Test' });\n *\n * await server.stop();\n * ```\n */\nexport async function createTestServer(\n  options: CreateTestServerOptions\n): Promise<TestServer> {\n  const port = getAvailablePort();\n\n  const result = createQuickdrawServer({\n    port,\n    services: options.services,\n    auth: {\n      // Dev mode: accept userId directly from auth\n      authenticate: async (_socket, auth) => {\n        return auth.userId as string | undefined;\n      },\n    },\n  });\n\n  // Wait for server to start\n  await new Promise<void>((resolve) => {\n    result.httpServer.once(\"listening\", resolve);\n  });\n\n  // Seed database if provided\n  if (options.seedDb) {\n    await options.seedDb();\n  }\n\n  return {\n    port,\n    result,\n    stop: () =>\n      new Promise<void>((resolve) => {\n        result.io.close();\n        result.httpServer.close(() => resolve());\n      }),\n    connectAs: (userId: string) => connectAsUser(port, userId),\n  };\n}\n\n/**\n * Connect to a test server as a specific user.\n */\nexport async function connectAsUser(\n  port: number,\n  userId: string\n): Promise<TestClient> {\n  const socket = ioClient(`http://localhost:${port}`, {\n    auth: { userId },\n    transports: [\"websocket\"],\n    autoConnect: true,\n  });\n\n  await new Promise<void>((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      reject(new Error(\"Connection timeout\"));\n    }, 5000);\n\n    socket.on(\"connect\", () => {\n      clearTimeout(timeout);\n      resolve();\n    });\n\n    socket.on(\"connect_error\", (err) => {\n      clearTimeout(timeout);\n      reject(err);\n    });\n  });\n\n  return {\n    socket,\n    emit: <TPayload, TResponse>(event: string, payload: TPayload) =>\n      emitWithAck<TPayload, TResponse>(socket, event, payload),\n    close: () => socket.close(),\n  };\n}\n\n/**\n * Emit an event and wait for acknowledgment.\n */\nexport function emitWithAck<TPayload, TResponse>(\n  socket: Socket,\n  event: string,\n  payload: TPayload,\n  timeoutMs: number = 5000\n): Promise<TResponse> {\n  return new Promise((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      reject(new Error(`Timeout waiting for ${event}`));\n    }, timeoutMs);\n\n    socket.emit(event, payload, (response: ServiceResponse<TResponse>) => {\n      clearTimeout(timeout);\n\n      if (response.success) {\n        resolve(response.data);\n      } else {\n        reject(new Error(response.error));\n      }\n    });\n  });\n}\n\n/**\n * Wait for a specific socket event.\n */\nexport function waitForEvent<T>(\n  socket: Socket,\n  event: string,\n  timeoutMs: number = 5000\n): Promise<T> {\n  return new Promise((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      socket.off(event, handler);\n      reject(new Error(`Timeout waiting for event ${event}`));\n    }, timeoutMs);\n\n    const handler = (data: T) => {\n      clearTimeout(timeout);\n      socket.off(event, handler);\n      resolve(data);\n    };\n\n    socket.on(event, handler);\n  });\n}\n"]}

package/dist/shared/index.d.ts

@@ -6,6 +6,68 @@ type ACE = {
     level: AccessLevel;
 };
 type ACL = ACE[];
+/**
+ * Interface for entities that support entry-level ACL stored as JSON.
+ *
+ * Use this pattern when:
+ * - You want simple ACL without a separate membership table
+ * - Access patterns are straightforward (read/write permissions)
+ * - You don't need to query "all entities user X can access" efficiently
+ *
+ * The default `checkEntryACL` in BaseService expects entities to have this shape.
+ *
+ * @example
+ * ```prisma
+ * model Document {
+ *   id    String @id @default(cuid())
+ *   title String
+ *   acl   Json?  // Stores ACL array
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * class DocumentService extends BaseService<Document & ACLEntity, ...> {
+ *   constructor(prisma: PrismaClient) {
+ *     super({ serviceName: 'documentService', hasEntryACL: true });
+ *     this.setDelegate(prisma.document);
+ *     // Default checkEntryACL will work automatically
+ *   }
+ * }
+ * ```
+ */
+interface ACLEntity {
+    id: string;
+    acl?: ACL | null;
+}
+/**
+ * Interface for users with service-level access control.
+ *
+ * The `serviceAccess` field maps service names to access levels, granting
+ * blanket permissions across all entries in that service.
+ *
+ * @example
+ * ```prisma
+ * model User {
+ *   id            String @id @default(cuid())
+ *   serviceAccess Json?  // { "chatService": "Admin", "documentService": "Read" }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // User with Admin access to chatService can perform any operation
+ * // on any chat, regardless of entry-level ACL
+ * const user: QuickdrawUser = {
+ *   id: "user-123",
+ *   serviceAccess: { chatService: "Admin" }
+ * };
+ * ```
+ */
+interface QuickdrawUser {
+    id: string;
+    serviceAccess?: Record<string, AccessLevel> | null;
+}
 type ServiceResponse<T = unknown> = {
     success: true;
     data: T;
@@ -121,6 +183,54 @@ type AdminUnsubscribeAllResponse = {
     id: string;
     unsubscribed: number;
 };
+/**
+ * Supported field types for admin UI generation.
+ */
+type AdminFieldType = "string" | "number" | "boolean" | "date" | "enum" | "json" | "relation";
+/**
+ * Configuration for a single field in the admin UI.
+ * Derived from Zod schemas with optional overrides.
+ */
+interface AdminFieldConfig {
+    /** Field name (property key on the entity) */
+    name: string;
+    /** Field type for rendering appropriate input */
+    type: AdminFieldType;
+    /** Human-readable label */
+    label: string;
+    /** Whether the field is required for creation */
+    required: boolean;
+    /** Whether the field can be edited (false for id, createdAt, etc.) */
+    editable: boolean;
+    /** Whether to show this field as a table column */
+    showInTable: boolean;
+    /** Whether the table can be sorted by this field */
+    sortable: boolean;
+    /** For enum fields, the allowed values */
+    enumValues?: string[];
+    /** For relation fields, the related service name */
+    relationService?: string;
+}
+/**
+ * Service metadata for admin UI generation.
+ * Returned by the adminMeta method.
+ */
+interface AdminServiceMeta {
+    /** Internal service name (e.g., "chatService") */
+    serviceName: string;
+    /** Human-readable display name (e.g., "Chats") */
+    displayName: string;
+    /** Field configurations derived from schema */
+    fields: AdminFieldConfig[];
+}
+/**
+ * Payload for adminMeta method (no parameters needed)
+ */
+type AdminMetaPayload = Record<string, never>;
+/**
+ * Response type for adminMeta method
+ */
+type AdminMetaResponse = AdminServiceMeta;
 type SubscribePayload = {
     entryId: string;
     requiredLevel?: AccessLevel;
@@ -155,4 +265,4 @@ interface Logger {
  */
 declare const consoleLogger: Logger;
 
-export { type ACE, type ACL, type AccessLevel, type AdminCreatePayload, type AdminDeletePayload, type AdminDeleteResponse, type AdminGetPayload, type AdminGetSubscribersPayload, type AdminGetSubscribersResponse, type AdminListPayload, type AdminListResponse, type AdminReemitPayload, type AdminReemitResponse, type AdminSetEntryACLPayload, type AdminUnsubscribeAllPayload, type AdminUnsubscribeAllResponse, type AdminUpdatePayload, type ExtractPayload, type ExtractResponse, type Logger, type ServiceMethodContext, type ServiceMethodDefinition, type ServiceMethodMap, type ServiceResponse, type SubscribePayload, type UnsubscribePayload, consoleLogger };
+export { type ACE, type ACL, type ACLEntity, type AccessLevel, type AdminCreatePayload, type AdminDeletePayload, type AdminDeleteResponse, type AdminFieldConfig, type AdminFieldType, type AdminGetPayload, type AdminGetSubscribersPayload, type AdminGetSubscribersResponse, type AdminListPayload, type AdminListResponse, type AdminMetaPayload, type AdminMetaResponse, type AdminReemitPayload, type AdminReemitResponse, type AdminServiceMeta, type AdminSetEntryACLPayload, type AdminUnsubscribeAllPayload, type AdminUnsubscribeAllResponse, type AdminUpdatePayload, type ExtractPayload, type ExtractResponse, type Logger, type QuickdrawUser, type ServiceMethodContext, type ServiceMethodDefinition, type ServiceMethodMap, type ServiceResponse, type SubscribePayload, type UnsubscribePayload, consoleLogger };

package/dist/shared/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shared/types.ts"],"names":[],"mappings":";AA8KO,IAAM,aAAA,GAAwB;AAAA,EACnC,IAAA,EAAM,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,IAAI,CAAA,OAAA,EAAU,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACpE,IAAA,EAAM,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,KAAK,CAAA,OAAA,EAAU,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACrE,KAAA,EAAO,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,MAAM,CAAA,QAAA,EAAW,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACxE,KAAA,EAAO,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,MAAM,CAAA,QAAA,EAAW,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACxE,OAAO,MAAM;AACf","file":"index.js","sourcesContent":["import type { z } from \"zod\";\n\n// ============================================================================\n// Access Control Types\n// ============================================================================\n\nexport type AccessLevel = \"Public\" | \"Read\" | \"Moderate\" | \"Admin\";\n\nexport type ACE = {\n  userId: string;\n  level: AccessLevel;\n};\n\nexport type ACL = ACE[];\n\n// ============================================================================\n// Service Response Types\n// ============================================================================\n\nexport type ServiceResponse<T = unknown> =\n  | { success: true; data: T }\n  | { success: false; error: string; code?: number };\n\n// ============================================================================\n// Service Method Definition Types\n// ============================================================================\n\n/**\n * Defines the shape of a service method including its payload and response types.\n * Used to create a type-safe contract between server and client.\n */\nexport interface ServiceMethodDefinition<\n  TPayload = unknown,\n  TResponse = unknown,\n> {\n  name: string;\n  access: AccessLevel;\n  handler: (\n    payload: TPayload,\n    context: ServiceMethodContext\n  ) => Promise<TResponse>;\n  schema?: z.ZodType<TPayload>;\n  resolveEntryId?: (payload: TPayload) => string | null;\n}\n\n/**\n * Context provided to service method handlers\n */\nexport interface ServiceMethodContext {\n  userId: string | undefined;\n  socketId: string;\n  serviceAccess: Record<string, AccessLevel>;\n}\n\n/**\n * Type helper for defining service method maps.\n * Each service should define its methods using this structure.\n *\n * @example\n * ```typescript\n * type ChatServiceMethods = ServiceMethodMap<{\n *   createChat: {\n *     payload: { title: string };\n *     response: { id: string };\n *   };\n *   updateTitle: {\n *     payload: { id: string; title: string };\n *     response: { id: string; title: string };\n *   };\n * }>;\n * ```\n */\nexport type ServiceMethodMap<\n  T extends Record<string, { payload: unknown; response: unknown }>,\n> = T;\n\n// ============================================================================\n// Admin Method Types (Generic shapes for all services)\n// ============================================================================\n\nexport type AdminListPayload = {\n  page?: number;\n  pageSize?: number;\n  sort?: {\n    field?: string;\n    direction?: \"asc\" | \"desc\";\n  };\n  filter?: {\n    id?: string;\n    ids?: string[];\n    createdAfter?: string;\n    createdBefore?: string;\n    updatedAfter?: string;\n    updatedBefore?: string;\n  } & Record<string, unknown>;\n};\n\nexport type AdminListResponse<T> = {\n  rows: T[];\n  page: number;\n  pageSize: number;\n  total: number;\n};\n\nexport type AdminGetPayload = { id: string };\n\nexport type AdminCreatePayload<TInsert> = { data: Partial<TInsert> };\n\nexport type AdminUpdatePayload<TInsert> = {\n  id: string;\n  data: Partial<TInsert>;\n};\n\nexport type AdminDeletePayload = { id: string };\nexport type AdminDeleteResponse = { id: string; deleted: true };\n\nexport type AdminSetEntryACLPayload = {\n  id: string;\n  acl: ACL;\n};\n\nexport type AdminGetSubscribersPayload = { id: string };\nexport type AdminGetSubscribersResponse = {\n  id: string;\n  subscribers: Array<{ socketId: string; userId?: string }>;\n};\n\nexport type AdminReemitPayload = { id: string };\nexport type AdminReemitResponse = { emitted: boolean };\n\nexport type AdminUnsubscribeAllPayload = { id: string };\nexport type AdminUnsubscribeAllResponse = { id: string; unsubscribed: number };\n\n// ============================================================================\n// Subscription Types\n// ============================================================================\n\nexport type SubscribePayload = {\n  entryId: string;\n  requiredLevel?: AccessLevel;\n};\n\nexport type UnsubscribePayload = {\n  entryId: string;\n};\n\n// ============================================================================\n// Utility Types\n// ============================================================================\n\n/**\n * Extracts payload type from a service method definition\n */\nexport type ExtractPayload<T> = T extends { payload: infer P } ? P : never;\n\n/**\n * Extracts response type from a service method definition\n */\nexport type ExtractResponse<T> = T extends { response: infer R } ? R : never;\n\n/**\n * Logger interface compatible with Winston and other loggers\n */\nexport interface Logger {\n  info(message: string, meta?: Record<string, unknown>): void;\n  warn(message: string, meta?: Record<string, unknown>): void;\n  error(message: string, meta?: Record<string, unknown>): void;\n  debug(message: string, meta?: Record<string, unknown>): void;\n  child(options: Record<string, unknown>): Logger;\n}\n\n/**\n * Default console logger implementation\n */\nexport const consoleLogger: Logger = {\n  info: (message, meta) => console.log(`[INFO] ${message}`, meta ?? \"\"),\n  warn: (message, meta) => console.warn(`[WARN] ${message}`, meta ?? \"\"),\n  error: (message, meta) => console.error(`[ERROR] ${message}`, meta ?? \"\"),\n  debug: (message, meta) => console.debug(`[DEBUG] ${message}`, meta ?? \"\"),\n  child: () => consoleLogger,\n};\n"]}
+{"version":3,"sources":["../../src/shared/types.ts"],"names":[],"mappings":";AAkTO,IAAM,aAAA,GAAwB;AAAA,EACnC,IAAA,EAAM,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,IAAI,CAAA,OAAA,EAAU,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACpE,IAAA,EAAM,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,KAAK,CAAA,OAAA,EAAU,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACrE,KAAA,EAAO,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,MAAM,CAAA,QAAA,EAAW,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACxE,KAAA,EAAO,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,MAAM,CAAA,QAAA,EAAW,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACxE,OAAO,MAAM;AACf","file":"index.js","sourcesContent":["import type { z } from \"zod\";\n\n// ============================================================================\n// Access Control Types\n// ============================================================================\n\nexport type AccessLevel = \"Public\" | \"Read\" | \"Moderate\" | \"Admin\";\n\nexport type ACE = {\n  userId: string;\n  level: AccessLevel;\n};\n\nexport type ACL = ACE[];\n\n// ============================================================================\n// Entity and User Interfaces for ACL\n// ============================================================================\n\n/**\n * Interface for entities that support entry-level ACL stored as JSON.\n *\n * Use this pattern when:\n * - You want simple ACL without a separate membership table\n * - Access patterns are straightforward (read/write permissions)\n * - You don't need to query \"all entities user X can access\" efficiently\n *\n * The default `checkEntryACL` in BaseService expects entities to have this shape.\n *\n * @example\n * ```prisma\n * model Document {\n *   id    String @id @default(cuid())\n *   title String\n *   acl   Json?  // Stores ACL array\n * }\n * ```\n *\n * @example\n * ```typescript\n * class DocumentService extends BaseService<Document & ACLEntity, ...> {\n *   constructor(prisma: PrismaClient) {\n *     super({ serviceName: 'documentService', hasEntryACL: true });\n *     this.setDelegate(prisma.document);\n *     // Default checkEntryACL will work automatically\n *   }\n * }\n * ```\n */\nexport interface ACLEntity {\n  id: string;\n  acl?: ACL | null;\n}\n\n/**\n * Interface for users with service-level access control.\n *\n * The `serviceAccess` field maps service names to access levels, granting\n * blanket permissions across all entries in that service.\n *\n * @example\n * ```prisma\n * model User {\n *   id            String @id @default(cuid())\n *   serviceAccess Json?  // { \"chatService\": \"Admin\", \"documentService\": \"Read\" }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // User with Admin access to chatService can perform any operation\n * // on any chat, regardless of entry-level ACL\n * const user: QuickdrawUser = {\n *   id: \"user-123\",\n *   serviceAccess: { chatService: \"Admin\" }\n * };\n * ```\n */\nexport interface QuickdrawUser {\n  id: string;\n  serviceAccess?: Record<string, AccessLevel> | null;\n}\n\n// ============================================================================\n// Service Response Types\n// ============================================================================\n\nexport type ServiceResponse<T = unknown> =\n  | { success: true; data: T }\n  | { success: false; error: string; code?: number };\n\n// ============================================================================\n// Service Method Definition Types\n// ============================================================================\n\n/**\n * Defines the shape of a service method including its payload and response types.\n * Used to create a type-safe contract between server and client.\n */\nexport interface ServiceMethodDefinition<\n  TPayload = unknown,\n  TResponse = unknown,\n> {\n  name: string;\n  access: AccessLevel;\n  handler: (\n    payload: TPayload,\n    context: ServiceMethodContext\n  ) => Promise<TResponse>;\n  schema?: z.ZodType<TPayload>;\n  resolveEntryId?: (payload: TPayload) => string | null;\n}\n\n/**\n * Context provided to service method handlers\n */\nexport interface ServiceMethodContext {\n  userId: string | undefined;\n  socketId: string;\n  serviceAccess: Record<string, AccessLevel>;\n}\n\n/**\n * Type helper for defining service method maps.\n * Each service should define its methods using this structure.\n *\n * @example\n * ```typescript\n * type ChatServiceMethods = ServiceMethodMap<{\n *   createChat: {\n *     payload: { title: string };\n *     response: { id: string };\n *   };\n *   updateTitle: {\n *     payload: { id: string; title: string };\n *     response: { id: string; title: string };\n *   };\n * }>;\n * ```\n */\nexport type ServiceMethodMap<\n  T extends Record<string, { payload: unknown; response: unknown }>,\n> = T;\n\n// ============================================================================\n// Admin Method Types (Generic shapes for all services)\n// ============================================================================\n\nexport type AdminListPayload = {\n  page?: number;\n  pageSize?: number;\n  sort?: {\n    field?: string;\n    direction?: \"asc\" | \"desc\";\n  };\n  filter?: {\n    id?: string;\n    ids?: string[];\n    createdAfter?: string;\n    createdBefore?: string;\n    updatedAfter?: string;\n    updatedBefore?: string;\n  } & Record<string, unknown>;\n};\n\nexport type AdminListResponse<T> = {\n  rows: T[];\n  page: number;\n  pageSize: number;\n  total: number;\n};\n\nexport type AdminGetPayload = { id: string };\n\nexport type AdminCreatePayload<TInsert> = { data: Partial<TInsert> };\n\nexport type AdminUpdatePayload<TInsert> = {\n  id: string;\n  data: Partial<TInsert>;\n};\n\nexport type AdminDeletePayload = { id: string };\nexport type AdminDeleteResponse = { id: string; deleted: true };\n\nexport type AdminSetEntryACLPayload = {\n  id: string;\n  acl: ACL;\n};\n\nexport type AdminGetSubscribersPayload = { id: string };\nexport type AdminGetSubscribersResponse = {\n  id: string;\n  subscribers: Array<{ socketId: string; userId?: string }>;\n};\n\nexport type AdminReemitPayload = { id: string };\nexport type AdminReemitResponse = { emitted: boolean };\n\nexport type AdminUnsubscribeAllPayload = { id: string };\nexport type AdminUnsubscribeAllResponse = { id: string; unsubscribed: number };\n\n// ============================================================================\n// Admin Field Configuration Types\n// ============================================================================\n\n/**\n * Supported field types for admin UI generation.\n */\nexport type AdminFieldType =\n  | \"string\"\n  | \"number\"\n  | \"boolean\"\n  | \"date\"\n  | \"enum\"\n  | \"json\"\n  | \"relation\";\n\n/**\n * Configuration for a single field in the admin UI.\n * Derived from Zod schemas with optional overrides.\n */\nexport interface AdminFieldConfig {\n  /** Field name (property key on the entity) */\n  name: string;\n  /** Field type for rendering appropriate input */\n  type: AdminFieldType;\n  /** Human-readable label */\n  label: string;\n  /** Whether the field is required for creation */\n  required: boolean;\n  /** Whether the field can be edited (false for id, createdAt, etc.) */\n  editable: boolean;\n  /** Whether to show this field as a table column */\n  showInTable: boolean;\n  /** Whether the table can be sorted by this field */\n  sortable: boolean;\n  /** For enum fields, the allowed values */\n  enumValues?: string[];\n  /** For relation fields, the related service name */\n  relationService?: string;\n}\n\n/**\n * Service metadata for admin UI generation.\n * Returned by the adminMeta method.\n */\nexport interface AdminServiceMeta {\n  /** Internal service name (e.g., \"chatService\") */\n  serviceName: string;\n  /** Human-readable display name (e.g., \"Chats\") */\n  displayName: string;\n  /** Field configurations derived from schema */\n  fields: AdminFieldConfig[];\n}\n\n/**\n * Payload for adminMeta method (no parameters needed)\n */\nexport type AdminMetaPayload = Record<string, never>;\n\n/**\n * Response type for adminMeta method\n */\nexport type AdminMetaResponse = AdminServiceMeta;\n\n// ============================================================================\n// Subscription Types\n// ============================================================================\n\nexport type SubscribePayload = {\n  entryId: string;\n  requiredLevel?: AccessLevel;\n};\n\nexport type UnsubscribePayload = {\n  entryId: string;\n};\n\n// ============================================================================\n// Utility Types\n// ============================================================================\n\n/**\n * Extracts payload type from a service method definition\n */\nexport type ExtractPayload<T> = T extends { payload: infer P } ? P : never;\n\n/**\n * Extracts response type from a service method definition\n */\nexport type ExtractResponse<T> = T extends { response: infer R } ? R : never;\n\n/**\n * Logger interface compatible with Winston and other loggers\n */\nexport interface Logger {\n  info(message: string, meta?: Record<string, unknown>): void;\n  warn(message: string, meta?: Record<string, unknown>): void;\n  error(message: string, meta?: Record<string, unknown>): void;\n  debug(message: string, meta?: Record<string, unknown>): void;\n  child(options: Record<string, unknown>): Logger;\n}\n\n/**\n * Default console logger implementation\n */\nexport const consoleLogger: Logger = {\n  info: (message, meta) => console.log(`[INFO] ${message}`, meta ?? \"\"),\n  warn: (message, meta) => console.warn(`[WARN] ${message}`, meta ?? \"\"),\n  error: (message, meta) => console.error(`[ERROR] ${message}`, meta ?? \"\"),\n  debug: (message, meta) => console.debug(`[DEBUG] ${message}`, meta ?? \"\"),\n  child: () => consoleLogger,\n};\n"]}