@emeryld/rrroutes-server 2.3.13 → 2.3.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +3 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +3 -1
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/dist/index.cjs
CHANGED
|
@@ -262,11 +262,13 @@ function createRRRoute(router, config) {
|
|
|
262
262
|
let responsePayload;
|
|
263
263
|
let hasResponsePayload = false;
|
|
264
264
|
const downstreamNext = next;
|
|
265
|
-
logger?.info?.(`${methodUpper}@${path} (${requestUrl})`);
|
|
266
265
|
const ctx = res.locals[CTX_SYMBOL];
|
|
267
266
|
const ctxRoutesLogger = ctx?.routesLogger;
|
|
268
267
|
const emitWithCtx = (event, details) => {
|
|
269
268
|
const decorated = decorateDebugEvent(isVerboseDebug, event, details);
|
|
269
|
+
if (!config.debug || !config.debug[decorated.type]) {
|
|
270
|
+
return;
|
|
271
|
+
}
|
|
270
272
|
if (decorated.type === "handler" && ctxRoutesLogger) {
|
|
271
273
|
logHandlerDebugWithRoutesLogger(ctxRoutesLogger, decorated);
|
|
272
274
|
} else {
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts","../src/routesV3.server.ts","../src/sockets/socket.server.debug.ts","../src/sockets/socket.server.sys.ts","../src/sockets/socket.server.index.ts","../src/sockets/socket.server.middleware.ts"],"sourcesContent":["export { keyOf as contractKeyOf } from '@emeryld/rrroutes-contract'\nexport * from './routesV3.server'\nexport * from './sockets/socket.server.index'\nexport * from './sockets/socket.server.middleware'\n","/**\n * routesV3.server.ts\n * -----------------------------------------------------------------------------\n * Bind an Express router/app to a `finalize(...)` registry of AnyLeafs.\n * - Fully typed handlers (params/query/body/output)\n * - Zod parsing + optional output validation\n * - buildCtx runs as a middleware *first*, before all other middlewares\n * - Global, per-route, and cfg-derived middlewares (auth, uploads)\n * - Helper to warn about unimplemented routes\n * - DX helpers to use `ctx` in any middleware with proper types\n */\n\nimport {\n AnyLeafLowProfile,\n FileField,\n HttpMethod,\n InferBody,\n InferOutput,\n InferParams,\n InferQuery,\n keyOf,\n lowProfileParse,\n} from '@emeryld/rrroutes-contract'\nimport type * as express from 'express'\nimport type { RequestHandler, Router } from 'express'\nimport { z } from 'zod'\n\n/** Shape expected from optional logger implementations. */\nexport type LoggerLike = {\n info?: (...args: any[]) => void\n warn?: (...args: any[]) => void\n error?: (...args: any[]) => void\n debug?: (...args: any[]) => void\n verbose?: (...args: any[]) => void\n system?: (...args: any[]) => void\n log?: (...args: any[]) => void\n}\n\ntype RoutesLoggerCarrier = {\n routesLogger?: LoggerLike\n}\n\ntype CtxWithRoutesLogger<Ctx> = Ctx & RoutesLoggerCarrier\n\n// Debug logging --------------------------------------------------------------\nexport type RouteServerDebugMode = 'minimal' | 'complete'\n\ntype RouteServerDebugEventBase = {\n /** Optional logical name assigned via `RouteDef.debug?.debugName` (or `RouteDef.debugName`). */\n name?: string\n}\n\nexport type RouteServerDebugEvent =\n | (RouteServerDebugEventBase & {\n type: 'request'\n stage: 'start' | 'success' | 'error'\n method: Uppercase<HttpMethod>\n path: string\n url: string\n durationMs?: number\n params?: unknown\n query?: unknown\n body?: unknown\n output?: unknown\n error?: unknown\n })\n | (RouteServerDebugEventBase & {\n type: 'register'\n method: Uppercase<HttpMethod>\n path: string\n })\n | (RouteServerDebugEventBase & {\n type: 'buildCtx'\n stage: 'start' | 'success' | 'error'\n method: Uppercase<HttpMethod>\n path: string\n url: string\n durationMs?: number\n error?: unknown\n })\n | (RouteServerDebugEventBase & {\n type: 'handler'\n stage: 'start' | 'success' | 'error'\n method: Uppercase<HttpMethod>\n path: string\n durationMs?: number\n params?: unknown\n query?: unknown\n body?: unknown\n output?: unknown\n error?: unknown\n })\n\nexport type RouteServerDebugLogger = (event: RouteServerDebugEvent) => void\n\n/**\n * Configure server-side debug logging.\n * - Use booleans or `'minimal'/'complete'` for quick toggles.\n * - Pass a custom logger function to redirect structured events.\n * - Provide a map to enable specific event types, opt into verbose payload logging, or restrict logs via `only`.\n */\nexport type RouteServerDebugOptions<Names extends string = string> =\n RouteServerDebugToggleOptions<Names>\n\n/**\n * Fine-grained toggle map for server debug logging.\n * Enable individual event types, opt into verbose payload logging, override the logger, or restrict to named routes.\n * Use `RouteDef.debug?.debugName` (or the deprecated `RouteDef.debugName`) to set the name that `only` will match against.\n */\nexport type RouteServerDebugToggleOptions<Names extends string = string> =\n Partial<Record<RouteServerDebugEvent['type'], boolean>> & {\n verbose?: boolean\n logger?: RouteServerDebugLogger\n only?: Names[]\n }\n\n/**\n * Per-route debug overrides. Same toggles as `RouteServerDebugOptions`, but limited to a single route\n * and therefore replaces the `only` filter with a local `debugName`.\n */\nexport type RouteDefDebugOptions<Names extends string = string> = Omit<\n RouteServerDebugToggleOptions<Names>,\n 'only'\n> & {\n debugName?: Names\n}\n\nconst serverDebugEventTypes: RouteServerDebugEvent['type'][] = [\n 'register',\n 'request',\n 'buildCtx',\n 'handler',\n]\n\ntype ServerDebugEmitter<Names extends string> = {\n emit: (event: RouteServerDebugEvent, name?: Names) => void\n mode: RouteServerDebugMode\n}\n\nconst noopServerEmit = () => {}\n\nfunction createServerDebugEmitter<Names extends string>(\n option?: RouteServerDebugOptions<Names>,\n): ServerDebugEmitter<Names> {\n const disabled: ServerDebugEmitter<Names> = {\n emit: noopServerEmit,\n mode: 'minimal',\n }\n if (!option) return disabled\n\n if (typeof option === 'object') {\n const toggles = option as RouteServerDebugToggleOptions<Names>\n const verbose = Boolean(toggles.verbose)\n const enabledTypes = serverDebugEventTypes.filter((type) => toggles[type])\n if (enabledTypes.length === 0) {\n return { emit: noopServerEmit, mode: verbose ? 'complete' : 'minimal' }\n }\n const whitelist = new Set<RouteServerDebugEvent['type']>(enabledTypes)\n const onlySet =\n toggles.only && toggles.only.length > 0\n ? new Set<Names>(toggles.only)\n : undefined\n const logger = toggles.logger\n const emit: ServerDebugEmitter<Names>['emit'] = (event, name) => {\n if (!whitelist.has(event.type) || !logger) return\n if (onlySet && (!name || !onlySet.has(name))) return\n logger(name ? { ...event, name } : event)\n }\n return { emit, mode: verbose ? 'complete' : 'minimal' }\n }\n\n return disabled\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Keys + leaf helpers (derive keys from byKey to avoid template-literal pitfalls)\n// ──────────────────────────────────────────────────────────────────────────────\n\n/** Keys like \"GET /v1/foo\" that *actually* exist in the registry */\nexport type KeysOfRegistry<\n R extends { byKey: Record<string, AnyLeafLowProfile> },\n> = keyof R['byKey'] & string\n\ntype MethodFromKey<K extends string> = K extends `${infer M} ${string}`\n ? Lowercase<M>\n : never\ntype PathFromKey<K extends string> = K extends `${string} ${infer P}`\n ? P\n : never\n\n/** Given a registry and a key, pick the exact leaf for that method+path */\nexport type LeafFromKey<\n R extends { all: readonly AnyLeafLowProfile[] },\n K extends string,\n> = Extract<\n R['all'][number],\n { method: MethodFromKey<K> & HttpMethod; path: PathFromKey<K> }\n>\n\n/** Optional-ify types if your core returns `never` when a schema isn't defined */\ntype Maybe<T> = [T] extends [never] ? void : T\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst decodeJsonLikeQueryValue = (value: unknown): unknown => {\n if (Array.isArray(value)) {\n return value.map((entry) => decodeJsonLikeQueryValue(entry))\n }\n if (isPlainObject(value)) {\n const next: Record<string, unknown> = {}\n for (const [key, child] of Object.entries(value)) {\n next[key] = decodeJsonLikeQueryValue(child)\n }\n return next\n }\n if (typeof value === 'string') {\n const trimmed = value.trim()\n if (\n (trimmed.startsWith('{') && trimmed.endsWith('}')) ||\n (trimmed.startsWith('[') && trimmed.endsWith(']'))\n ) {\n try {\n return JSON.parse(trimmed)\n } catch {\n return value\n }\n }\n }\n return value\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Context typing & DX helpers (so ctx is usable in *any* middleware)\n// ──────────────────────────────────────────────────────────────────────────────\n\n/**\n * Unique symbol used to stash ctx on res.locals.\n * (Symbols are safer than string keys against collisions.)\n */\nexport const CTX_SYMBOL: unique symbol = Symbol.for('typedLeaves.ctx')\n\n/** Response type that *has* a ctx on locals for DX in middlewares */\nexport type ResponseWithCtx<Ctx> =\n // Replace locals with an intersection that guarantees CTX_SYMBOL exists\n Omit<express.Response, 'locals'> & {\n locals: express.Response['locals'] & {\n [CTX_SYMBOL]: CtxWithRoutesLogger<Ctx>\n }\n }\n\n/** A middleware signature that can *use* ctx via `res.locals[CTX_SYMBOL]` */\nexport type CtxRequestHandler<Ctx> = (args: {\n req: express.Request\n res: express.Response\n next: express.NextFunction\n ctx: CtxWithRoutesLogger<Ctx>\n}) => any\n\n/**\n * Safely read ctx from any Response.\n * @param res Express response whose locals contain the ctx symbol.\n * @returns Strongly typed context object.\n */\nexport function getCtx<Ctx = unknown>(\n res: express.Response,\n): CtxWithRoutesLogger<Ctx> {\n return (res.locals as any)[CTX_SYMBOL] as CtxWithRoutesLogger<Ctx>\n}\n\n/**\n * Wrap a ctx-typed middleware to a plain RequestHandler (for arrays, etc.).\n * @param mw Middleware that expects a typed response with ctx available.\n * @returns Standard Express request handler.\n */\nfunction adaptCtxMw<Ctx>(mw: CtxRequestHandler<Ctx>): RequestHandler {\n return (req, res, next) => {\n try {\n const result = mw({ req, res, next, ctx: getCtx<Ctx>(res) })\n if (result && typeof (result as Promise<unknown>).then === 'function') {\n return (result as Promise<unknown>).catch((err) => next(err))\n }\n return result as any\n } catch (err) {\n next(err as any)\n return undefined\n }\n }\n}\n\nfunction logHandlerDebugWithRoutesLogger(\n logger: LoggerLike | undefined,\n event: RouteServerDebugEvent,\n) {\n if (!logger || event.type !== 'handler') return\n const payload: [string, RouteServerDebugEvent] = [\n `[rrroutes-server][handler:${event.stage}] ${event.method} ${event.path}`,\n event,\n ]\n if (event.stage === 'error') {\n ;(\n logger.error ??\n logger.warn ??\n logger.debug ??\n logger.info ??\n logger.log ??\n logger.system\n )?.call(logger, ...payload)\n return\n }\n ;(\n logger.debug ??\n logger.verbose ??\n logger.info ??\n logger.log ??\n logger.system\n )?.call(logger, ...payload)\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Controller types — object form only (simpler, clearer typings)\n// ──────────────────────────────────────────────────────────────────────────────\n\n/** Typed route handler for a specific leaf */\n\nexport type Handler<L extends AnyLeafLowProfile, Ctx = unknown> = (args: {\n req: express.Request\n res: express.Response\n next: express.NextFunction\n ctx: CtxWithRoutesLogger<Ctx>\n params: Maybe<InferParams<L>>\n query: Maybe<InferQuery<L>>\n body: Maybe<InferBody<L>>\n}) => Promise<Maybe<InferOutput<L>>> | Maybe<InferOutput<L>>\n\n/** Route definition for one key */\nexport type RouteDef<\n L extends AnyLeafLowProfile,\n Ctx = unknown,\n Names extends string = string,\n> = {\n /** Middlewares before the handler (run after buildCtx/global/derived) */\n before?: Array<CtxRequestHandler<Ctx>>\n /** Your business logic */\n handler: Handler<L, Ctx>\n /**\n * Optional per-route debug overrides. When provided, these replace the global debug options.\n */\n debug?: RouteDefDebugOptions<Names>\n}\n\n/** Map of registry keys -> route defs */\nexport type ControllerMap<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n> = {\n [P in KeysOfRegistry<R>]: RouteDef<LeafFromKey<R, P>, Ctx, Names>\n}\n\nexport type PartialControllerMap<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n> = Partial<ControllerMap<R, Ctx, Names>>\n\n// ──────────────────────────────────────────────────────────────────────────────\n/** Options + derivation helpers */\n// ──────────────────────────────────────────────────────────────────────────────\n\nexport type RouteServerConfig<Ctx = unknown, Names extends string = string> = {\n /**\n * Build a request-scoped context. We wrap this in a middleware that runs\n * *first* (before global/derived/route middlewares), and stash it on\n * `res.locals[CTX_SYMBOL]` so *all* later middlewares can use it.\n * You can optionally include `routesLogger` to override handler debug logging per request.\n */\n buildCtx: (\n req: express.Request,\n res: express.Response,\n ) => CtxWithRoutesLogger<Ctx> | Promise<CtxWithRoutesLogger<Ctx>>\n\n /** Grouped global middlewares that run before the handler for every route. */\n globalMiddleware?: Array<CtxRequestHandler<Ctx>>\n\n /**\n * Derive middleware from MethodCfg.\n * - `upload` runs when cfg.bodyFiles has entries\n */\n fromCfg?: {\n upload?: (files: FileField[] | undefined) => RequestHandler[]\n }\n\n /** Validate handler return values with outputSchema (default: true) */\n validateOutput?: boolean\n\n /** Custom responder (default: res.json(data)) */\n send?: (res: express.Response, data: unknown) => void\n\n /** Optional logger hooks */\n logger?: LoggerLike\n\n /**\n * Optional debug logging for the request lifecycle.\n * Supports booleans/modes/loggers, or a toggle map with per-event enabling, verbose payload logging,\n * and `only` filters tied to `RouteDef.debug?.debugName` (or the deprecated `RouteDef.debugName`).\n */\n debug?: RouteServerDebugOptions<Names>\n}\n\n/** Default JSON responder (typed to avoid implicit-any diagnostics) */\nconst defaultSend: (res: express.Response, data: unknown) => void = (\n res,\n data,\n) => {\n res.json(data as any)\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Core builder\n// ──────────────────────────────────────────────────────────────────────────────\n\nconst REGISTERED_ROUTES_SYMBOL = Symbol.for('routesV3.registeredRoutes')\n\ntype RegisteredRouteStore = Set<string>\n\n/**\n * Retrieve or initialize the shared store of registered route keys.\n * @param router Express router/application that carries previously registered keys.\n * @returns Set of string keys describing registered routes.\n */\nfunction getRegisteredRouteStore(router: Router): RegisteredRouteStore {\n const existing = (router as any)[REGISTERED_ROUTES_SYMBOL] as\n | RegisteredRouteStore\n | undefined\n if (existing) return existing\n const store: RegisteredRouteStore = new Set()\n ;(router as any)[REGISTERED_ROUTES_SYMBOL] = store\n return store\n}\n\n/**\n * Inspect the Express layer stack to discover already-registered routes.\n * @param appOrRouter Express application or router to inspect.\n * @returns All keys in the form `\"METHOD /path\"` found on the stack.\n */\nfunction collectRoutesFromStack(appOrRouter: Router): string[] {\n const result: string[] = []\n const stack: any[] =\n (appOrRouter as any).stack ??\n ((appOrRouter as any)._router\n ? (appOrRouter as any)._router.stack\n : undefined) ??\n []\n\n if (!Array.isArray(stack)) return result\n\n for (const layer of stack) {\n const route = layer && layer.route\n if (!route) continue\n\n const paths = Array.isArray(route.path) ? route.path : [route.path]\n const methodEntries = Object.entries(route.methods ?? {}).filter(\n ([, enabled]) => enabled,\n )\n\n for (const path of paths) {\n for (const [method] of methodEntries) {\n result.push(`${method.toUpperCase()} ${path}`)\n }\n }\n }\n\n return result\n}\n\n/** Runtime helpers returned by `createRRRoute`. */\nexport type RouteServer<Ctx = unknown, Names extends string = string> = {\n router: Router\n register<L extends AnyLeafLowProfile>(\n leaf: L,\n def: RouteDef<L, Ctx, Names>,\n ): void\n registerControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n F extends boolean = false,\n >(\n registry: R,\n controllers: F extends false\n ? PartialControllerMap<R, Ctx, Names>\n : ControllerMap<R, Ctx, Names>,\n all?: F,\n ): void\n warnMissingControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n >(\n registry: R,\n logger: { warn: (...args: any[]) => void },\n ): void\n getRegisteredKeys(): string[]\n}\n\n/**\n * Create an Express binding helper that keeps routes and controllers in sync.\n * @param router Express router or app to register handlers on.\n * @param config Optional configuration controlling ctx building, auth, uploads, etc.\n * @param middleware The order of the middlewares is: buildCtx -> global -> fromCfg -> route -> handler. Remember to call `ctx.next()` in your middlewares to continue the chain.\n * @returns Object with helpers to register controllers and inspect registered keys.\n */\nexport function createRRRoute<Ctx = unknown, Names extends string = string>(\n router: Router,\n config: RouteServerConfig<Ctx, Names>,\n): RouteServer<Ctx, Names> {\n const validateOutput = config.validateOutput ?? true\n const send = config.send ?? defaultSend\n const logger = config.logger\n const { emit: defaultEmitDebug, mode: defaultDebugMode } =\n createServerDebugEmitter<Names>(config.debug)\n\n const knownLeaves = new Map<string, AnyLeafLowProfile>()\n\n const decorateDebugEvent = <T extends RouteServerDebugEvent>(\n isVerbose: boolean,\n event: T,\n details?: Partial<RouteServerDebugEvent>,\n ): RouteServerDebugEvent => {\n if (!isVerbose || !details) return event\n return { ...event, ...details } as RouteServerDebugEvent\n }\n\n const globalBeforeMws = [...(config.globalMiddleware ?? [])].map((mw) =>\n adaptCtxMw<Ctx>(mw),\n )\n const registered = getRegisteredRouteStore(router)\n\n const buildDerived = (leaf: AnyLeafLowProfile): RequestHandler[] => {\n const derived: RequestHandler[] = []\n if (\n config.fromCfg?.upload &&\n Array.isArray(leaf.cfg.bodyFiles) &&\n leaf.cfg.bodyFiles.length > 0\n ) {\n derived.push(...config.fromCfg.upload(leaf.cfg.bodyFiles))\n }\n\n return derived\n }\n\n /** Register a single leaf/controller pair on the underlying router. */\n function register<L extends AnyLeafLowProfile>(\n leaf: L,\n def: RouteDef<L, Ctx, Names>,\n ) {\n const method = leaf.method as HttpMethod\n const methodUpper = method.toUpperCase() as Uppercase<HttpMethod>\n const path = leaf.path as string\n const key = keyOf(leaf.method, leaf.path, false)\n const defDebug = def.debug\n let debugName = undefined as Names | undefined\n let routeDebugEmitter: ServerDebugEmitter<Names> | undefined\n if (defDebug) {\n const { debugName: overrideName, ...rest } = defDebug\n const hasOverrides = Object.values(rest).some(\n (value) => value !== undefined,\n )\n if (hasOverrides) {\n routeDebugEmitter = createServerDebugEmitter<Names>({\n ...config.debug,\n ...rest,\n })\n }\n debugName = (overrideName ?? debugName) as Names | undefined\n }\n const activeEmit = routeDebugEmitter?.emit ?? defaultEmitDebug\n const activeDebugMode = routeDebugEmitter?.mode ?? defaultDebugMode\n const emit = (event: RouteServerDebugEvent) => activeEmit(event, debugName)\n const isVerboseDebug = activeDebugMode === 'complete'\n emit({ type: 'register', method: methodUpper, path })\n\n const routeSpecific = (def?.before ?? []).map((mw) => adaptCtxMw<Ctx>(mw))\n const derived = buildDerived(leaf)\n const ctxMw: RequestHandler = async (req, res, next) => {\n const requestUrl = req.originalUrl ?? path\n const startedAt = Date.now()\n emit({\n type: 'buildCtx',\n stage: 'start',\n method: methodUpper,\n path,\n url: requestUrl,\n })\n try {\n const ctx = await config.buildCtx(req, res)\n ;(res.locals as any)[CTX_SYMBOL] = ctx\n emit({\n type: 'buildCtx',\n stage: 'success',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n })\n next()\n } catch (err) {\n emit({\n type: 'buildCtx',\n stage: 'error',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n error: err,\n })\n logger?.error?.('buildCtx error', err)\n next(err as any)\n }\n }\n const before: RequestHandler[] = [\n ctxMw,\n ...globalBeforeMws,\n ...derived,\n ...routeSpecific,\n ]\n\n const wrapped: RequestHandler = async (req, res, next) => {\n const requestUrl = req.originalUrl.split('?')[0] ?? path\n const startedAt = Date.now()\n emit({\n type: 'request',\n stage: 'start',\n method: methodUpper,\n path,\n url: requestUrl,\n })\n let params: InferParams<L> | undefined\n let query: InferQuery<L> | undefined\n let body: InferBody<L> | undefined\n let responsePayload: InferOutput<L> | undefined\n let hasResponsePayload = false\n const downstreamNext: express.NextFunction = next\n\n logger?.info?.(`${methodUpper}@${path} (${requestUrl})`)\n const ctx = (res.locals as any)[CTX_SYMBOL] as CtxWithRoutesLogger<Ctx>\n const ctxRoutesLogger = ctx?.routesLogger\n const emitWithCtx = (\n event: RouteServerDebugEvent,\n details?: Partial<RouteServerDebugEvent>,\n ) => {\n const decorated = decorateDebugEvent(isVerboseDebug, event, details)\n if (decorated.type === 'handler' && ctxRoutesLogger) {\n logHandlerDebugWithRoutesLogger(ctxRoutesLogger, decorated)\n } else {\n emit(decorated)\n }\n }\n try {\n params = (\n leaf.cfg.paramsSchema\n ? lowProfileParse(leaf.cfg.paramsSchema, req.params)\n : Object.keys(req.params || {}).length\n ? (req.params as any)\n : undefined\n ) as InferParams<L>\n\n try {\n const parsedQueryInput =\n leaf.cfg.querySchema && req.query\n ? (decodeJsonLikeQueryValue(req.query) as Record<\n string,\n unknown\n >)\n : req.query\n query = leaf.cfg.querySchema\n ? lowProfileParse(leaf.cfg.querySchema, parsedQueryInput)\n : Object.keys(req.query || {}).length\n ? (req.query as any)\n : undefined\n } catch (e) {\n logger?.error?.('Query parsing error', {\n path,\n method: methodUpper,\n error: e,\n raw: JSON.stringify(req.query),\n })\n throw e\n }\n\n body = (\n leaf.cfg.bodySchema\n ? lowProfileParse(leaf.cfg.bodySchema, req.body)\n : req.body !== undefined\n ? (req.body as any)\n : undefined\n ) as InferBody<L>\n\n logger?.verbose?.(`${methodUpper}@${path} (${requestUrl})`, {\n params,\n query,\n body,\n })\n\n const handlerStartedAt = Date.now()\n emitWithCtx(\n {\n type: 'handler',\n stage: 'start',\n method: methodUpper,\n path,\n },\n isVerboseDebug ? { params, query, body } : undefined,\n )\n\n let result\n try {\n result = await def.handler({\n req,\n res,\n next: downstreamNext,\n ctx,\n params: params as Maybe<InferParams<L>>,\n query: query as Maybe<InferQuery<L>>,\n body: body as Maybe<InferBody<L>>,\n })\n emitWithCtx(\n {\n type: 'handler',\n stage: 'success',\n method: methodUpper,\n path,\n durationMs: Date.now() - handlerStartedAt,\n },\n isVerboseDebug\n ? {\n params,\n query,\n body,\n ...(result !== undefined ? { output: result } : {}),\n }\n : undefined,\n )\n } catch (e) {\n emitWithCtx(\n {\n type: 'handler',\n stage: 'error',\n method: methodUpper,\n path,\n durationMs: Date.now() - handlerStartedAt,\n error: e,\n },\n isVerboseDebug ? { params, query, body } : undefined,\n )\n logger?.error?.('Handler error', e)\n throw e\n }\n\n const out =\n validateOutput && leaf.cfg.outputSchema\n ? lowProfileParse(leaf.cfg.outputSchema, result)\n : result\n responsePayload = out as InferOutput<L>\n hasResponsePayload = true\n logger?.verbose?.(`${methodUpper}@${path} result`, out)\n send(res, out)\n\n emitWithCtx(\n {\n type: 'request',\n stage: 'success',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n },\n isVerboseDebug\n ? {\n params,\n query,\n body,\n ...(hasResponsePayload ? { output: responsePayload } : {}),\n }\n : undefined,\n )\n } catch (err) {\n emitWithCtx(\n {\n type: 'request',\n stage: 'error',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n error: err,\n },\n isVerboseDebug ? { params, query, body } : undefined,\n )\n logger?.error?.('Route error', err)\n next(err as any)\n }\n }\n\n ;(router as any)[method](path, ...before, wrapped)\n registered.add(key)\n }\n\n /**\n * Register controller definitions for the provided keys.\n * @param registry Finalized registry of leaves.\n * @param controllers Partial controller map keyed by `\"METHOD /path\"`.\n * @param all Deprecated runtime toggle. Passing any truthy value will throw.\n */\n function registerControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n F extends boolean = false,\n >(registry: R, controllers: PartialControllerMap<R, Ctx, Names>, all?: F) {\n if (all !== undefined && all !== false) {\n const label =\n typeof all === 'string'\n ? all\n : all === true\n ? 'true'\n : String(all)\n throw new Error(\n `registerControllers: \"${label}\" is not allowed at runtime. Use bindAll(...) for compile-time coverage or warnMissingControllers(...) to surface missing routes.`,\n )\n }\n\n for (const leaf of registry.all) {\n const key = keyOf(leaf.method, leaf.path, false)\n knownLeaves.set(key, leaf)\n }\n\n ;(Object.keys(controllers) as Array<KeysOfRegistry<R>>).forEach((key) => {\n const leaf = registry.byKey[key] as unknown as\n | LeafFromKey<R, typeof key>\n | undefined\n if (!leaf) {\n logger?.warn?.(\n `No leaf found for controller key: ${key}. Not registering route.`,\n )\n return\n }\n const def = controllers[key]\n if (!def) return\n register(leaf as LeafFromKey<R, typeof key>, def)\n })\n }\n\n /**\n * Warn about leaves that do not have a registered controller.\n * @param registry Finalized registry of leaves.\n * @param warnLogger Logger used for warning output.\n */\n function warnMissing<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n >(registry: R, warnLogger: { warn: (...args: any[]) => void }) {\n const registeredFromStore = new Set<string>(Array.from(registered))\n if (registeredFromStore.size === 0) {\n collectRoutesFromStack(router).forEach((key) =>\n registeredFromStore.add(key),\n )\n }\n for (const leaf of registry.all) {\n const key = keyOf(leaf.method, leaf.path, false)\n if (!registeredFromStore.has(key)) {\n warnLogger.warn(`No controller registered for route: ${key}`)\n }\n }\n }\n\n return {\n router,\n register,\n registerControllers,\n warnMissingControllers: warnMissing,\n getRegisteredKeys: () => Array.from(registered),\n }\n}\n\n/**\n * Bind only the controllers that are present in the provided map.\n * @param router Express router or app.\n * @param registry Finalized registry produced by `finalize(...)`.\n * @param controllers Partial map of controllers keyed by `\"METHOD /path\"`.\n * @param config Optional route server configuration.\n * @returns The same router instance for chaining.\n */\nexport function bindExpressRoutes<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n>(\n router: Router,\n registry: R,\n controllers: PartialControllerMap<R, Ctx, Names>,\n config: RouteServerConfig<Ctx, Names>,\n) {\n const server = createRRRoute<Ctx, Names>(router, config)\n server.registerControllers(registry, controllers)\n return router\n}\n\n/**\n * Bind controllers for every leaf. Missing entries fail at compile time.\n * @param router Express router or app.\n * @param registry Finalized registry produced by `finalize(...)`.\n * @param controllers Complete map of controllers keyed by `\"METHOD /path\"`.\n * @param config Optional route server configuration.\n * @returns The same router instance for chaining.\n */\nexport function bindAll<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n>(\n router: Router,\n registry: R,\n controllers: {\n [K in KeysOfRegistry<R>]: RouteDef<LeafFromKey<R, K>, Ctx, Names>\n },\n config: RouteServerConfig<Ctx, Names>,\n) {\n const server = createRRRoute<Ctx, Names>(router, config)\n server.registerControllers(registry, controllers)\n return router\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// DX helpers\n// ──────────────────────────────────────────────────────────────────────────────\n\n/**\n * Helper for great IntelliSense when authoring controller maps.\n * @returns Function that enforces key names while preserving partial flexibility.\n */\nexport const defineControllers =\n <\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n >() =>\n <M extends PartialControllerMap<R, Ctx, Names>>(m: M) =>\n m\n\n/**\n * Warn about leaves that don't have controllers.\n * Call this during startup to surface missing routes.\n * @param router Express router or app to inspect.\n * @param registry Finalized registry produced by `finalize(...)`.\n * @param logger Logger where warnings are emitted.\n */\nexport function warnMissingControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n>(router: Router, registry: R, logger: { warn: (...args: any[]) => void }) {\n const registeredStore = (router as any)[REGISTERED_ROUTES_SYMBOL] as\n | Set<string>\n | undefined\n const initial = registeredStore\n ? Array.from(registeredStore)\n : collectRoutesFromStack(router)\n const registeredKeys = new Set<string>(initial)\n\n for (const leaf of registry.all) {\n const k = keyOf(leaf.method, leaf.path, false)\n if (!registeredKeys.has(k)) {\n logger.warn(`No controller registered for route: ${k}`)\n }\n }\n}\n","// socket.server.debug.ts\nimport type { IncomingHttpHeaders } from 'http'\n\nexport type SocketServerConfigSnapshot = {\n url?: string\n transport?: string\n protocol?: string\n address?: string\n issued?: number\n time?: string\n query?: Record<string, unknown>\n auth?: Record<string, unknown>\n headers?: IncomingHttpHeaders\n}\n\nexport type SocketServerLifecycleStage =\n | 'server_init'\n | 'connection_listener_installed'\n | 'connection_init'\n | 'connection_handlers_attached'\n | 'connection_cleanup'\n | 'destroy_start'\n | 'destroy_complete'\n | 'connection_cleanup_fallback'\n\nexport type SocketServerHeartbeatPhase = 'ping' | 'pong' | 'skip'\n\nexport type SocketServerDebugEvent =\n | {\n type: 'register'\n action: 'register' | 'unregister'\n event: string\n msg?: string\n }\n | {\n type: 'handler'\n phase:\n | 'receive'\n | 'validation_error'\n | 'handler_success'\n | 'handler_error'\n event: string\n socketId?: string\n nsp?: string\n rooms?: string[]\n raw?: unknown\n issues?: any[]\n error?: unknown\n details?: Record<string, unknown>\n }\n | {\n type: 'emit'\n event: string\n rooms: string[]\n envelope?: unknown\n error?: {\n reason: string\n message?: string\n issues?: unknown\n }\n metadata?: unknown\n }\n | {\n type: 'rooms'\n action: 'join' | 'leave'\n rooms?: string | string[]\n socketId: string\n phase?: string\n payload?: unknown\n issues?: any[]\n }\n | {\n type: 'heartbeat'\n phase: SocketServerHeartbeatPhase\n socketId: string\n payload?: unknown\n issues?: any[]\n error?: boolean\n details?: Record<string, unknown>\n }\n | {\n type: 'config'\n socketId: string\n nsp: string\n snapshot: SocketServerConfigSnapshot\n }\n | {\n type: 'lifecycle'\n stage: SocketServerLifecycleStage\n socketId?: string\n nsp?: string\n details?: Record<string, unknown>\n }\n\nexport type SocketDebugOptions = {\n verbose?: boolean\n /** filters event-based logs (register/handler/emit) by event name */\n only?: string[]\n logger?: (e: SocketServerDebugEvent) => void\n} & {\n [P in SocketServerDebugEvent['type']]?: boolean\n}\n\nexport function createDebugger(options?: SocketDebugOptions) {\n const debug = options ?? {}\n\n return (maybeEvent: string | null, e: SocketServerDebugEvent) => {\n if (!debug.logger) return\n if (!debug[e.type]) return\n\n // only filter applies to event-shaped logs\n if (\n debug.only &&\n maybeEvent &&\n (e.type === 'register' || e.type === 'handler' || e.type === 'emit') &&\n !debug.only.includes(maybeEvent)\n ) {\n return\n }\n\n debug.logger(e)\n }\n}\n","// socket.server.sys.ts\nimport type { Socket } from 'socket.io'\nimport { z } from 'zod'\nimport type {\n EventMap,\n Payload,\n SocketConnectionConfigOutput,\n SocketSchemaOutput,\n SysEventName,\n} from '@emeryld/rrroutes-contract'\nimport type {\n SocketServerConfigSnapshot,\n SocketServerDebugEvent,\n} from './socket.server.debug'\nimport type { HandlerCtxNoAck } from './socket.server.types'\n\nexport type SocketConnectionHelper<Events extends EventMap> = {\n emit<K extends keyof Events & string>(\n event: K,\n payload: Payload<Events, K>,\n metadata?: Record<string, unknown>,\n onAck?: (ack: unknown) => void,\n ): void\n}\n\n/** Heartbeat configuration that is not tied to payload shapes (which live in sys event schemas). */\nexport type HeartbeatServerOptions = {\n /** Enable/disable built-in heartbeat handling. Defaults to true. */\n enabled?: boolean\n}\n\nexport type SysServerEventMap<\n Config extends SocketConnectionConfigOutput = SocketConnectionConfigOutput,\n Events extends EventMap = EventMap,\n> = {\n 'sys:connect': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n /**\n * Call to proceed with the default connection initialization\n * (attaches heartbeat, join, leave and disconnect handlers).\n */\n complete: () => void\n }) => void | Promise<void>\n\n 'sys:disconnect': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n /** cleans up all handlers */\n cleanup: () => void\n reason: string\n }) => void | Promise<void>\n\n 'sys:ping': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n ping: SocketSchemaOutput<Config['pingPayload']>\n ctx: HandlerCtxNoAck\n }) =>\n | SocketSchemaOutput<Config['pongPayload']>\n | Promise<SocketSchemaOutput<Config['pongPayload']>>\n\n 'sys:room_join': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n rooms: string[]\n meta: SocketSchemaOutput<Config['joinMetaMessage']>\n join: (room: string) => Promise<void>\n }) => void | Promise<void>\n\n 'sys:room_leave': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n rooms: string[]\n meta: SocketSchemaOutput<Config['leaveMetaMessage']>\n leave: (room: string) => Promise<void>\n }) => void | Promise<void>\n}\n\nconst normalizeError = (error: unknown) => {\n if (error instanceof Error) {\n return { name: error.name, message: error.message }\n }\n if (typeof error === 'string') return { message: error }\n return { message: 'Unknown error' }\n}\n\nconst roomValueSchema = z.union([z.string(), z.array(z.string())])\n\nconst buildRoomPayloadSchema = <Meta extends z.ZodTypeAny>(metaSchema: Meta) =>\n z.object({\n rooms: roomValueSchema,\n meta: metaSchema,\n })\n\ntype DebugFn = (maybeEvent: string | null, e: SocketServerDebugEvent) => void\n\nconst toArray = (rooms?: string[] | string): string[] =>\n rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms]\n\nconst snapshotSocketConfig = (socket: Socket): SocketServerConfigSnapshot => {\n const conn = socket.conn as\n | {\n transport?: { name?: string }\n protocol?: string | number\n remoteAddress?: string\n }\n | undefined\n const protocol = conn?.protocol\n return {\n url: socket.handshake.url,\n transport: conn?.transport?.name,\n protocol: protocol != null ? String(protocol) : undefined,\n address: conn?.remoteAddress ?? socket.handshake.address,\n issued: socket.handshake.issued,\n time: socket.handshake.time,\n query: socket.handshake.query as Record<string, unknown>,\n auth: socket.handshake.auth as Record<string, unknown>,\n headers: socket.handshake.headers,\n }\n}\n\nexport function createBuiltInConnectionHandlers<\n C extends SocketConnectionConfigOutput,\n Events extends EventMap,\n>(opts: {\n heartbeat?: HeartbeatServerOptions\n sys: SysServerEventMap<C, Events>\n dbg: DebugFn\n config: C\n createCtx: (socket: Socket) => HandlerCtxNoAck\n debugVerbose?: boolean\n createHelper: (socket: Socket) => SocketConnectionHelper<Events>\n}) {\n const { heartbeat, sys, dbg, config, createCtx, debugVerbose, createHelper } =\n opts\n\n const roomJoinEvent: SysEventName = 'sys:room_join'\n const roomLeaveEvent: SysEventName = 'sys:room_leave'\n const pingEvent: SysEventName = 'sys:ping'\n const pongEvent: SysEventName = 'sys:pong'\n const heartbeatEnabled = heartbeat?.enabled !== false\n\n const joinPayloadSchema = buildRoomPayloadSchema(config.joinMetaMessage)\n const leavePayloadSchema = buildRoomPayloadSchema(config.leaveMetaMessage)\n const pingPayloadSchema = config.pingPayload as C['pingPayload']\n const pongPayloadSchema = config.pongPayload as C['pongPayload']\n\n const sysEvents = sys\n const getSysEvent = <\n K extends keyof SysServerEventMap<C, Events> & SysEventName,\n >(\n name: K,\n ) => sysEvents[name]\n\n /** Track per-socket teardown for built-in handlers to ensure explicit cleanup on destroy(). */\n const socketTeardowns = new WeakMap<Socket, (reason: string) => void>()\n\n const builtInConnectionListener = (socket: Socket) => {\n const helper = createHelper(socket)\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_init',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: {\n rooms: Array.from(socket.rooms),\n handshakeIssued: socket.handshake.issued,\n },\n })\n dbg(null, {\n type: 'config',\n socketId: socket.id,\n nsp: socket.nsp.name,\n snapshot: snapshotSocketConfig(socket),\n })\n\n const defaultConnect = () => {\n const includeRaw = debugVerbose === true\n\n // built-in room handlers (wrapped with sys:room_join / sys:room_leave)\n const joinHandler = async (msg: unknown) => {\n dbg(roomJoinEvent, {\n type: 'rooms',\n phase: 'receive',\n action: 'join',\n socketId: socket.id,\n payload: msg,\n })\n const parsed = joinPayloadSchema.safeParse(msg)\n\n if (!parsed.success) {\n socket.emit(`${roomJoinEvent}:error`, {\n eventName: roomJoinEvent,\n issues: parsed.error.issues,\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n action: 'join',\n phase: 'validation_error',\n socketId: socket.id,\n issues: parsed.error.issues,\n payload: msg,\n })\n return\n }\n const list = toArray(parsed.data.rooms)\n\n const join = async (room: string) => {\n await socket.join(room)\n dbg(null, {\n type: 'rooms',\n action: 'join',\n rooms: room,\n socketId: socket.id,\n })\n }\n\n const run = async () => {\n await getSysEvent('sys:room_join')({\n socket,\n helper,\n rooms: list,\n meta: parsed.data.meta as SocketSchemaOutput<C['joinMetaMessage']>,\n join,\n })\n }\n\n try {\n await run()\n } catch (error) {\n socket.emit(`${roomJoinEvent}:error`, {\n error: normalizeError(error),\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n action: 'join',\n phase: 'handler_error',\n payload: includeRaw\n ? { rooms: list, meta: parsed.data.meta }\n : undefined,\n socketId: socket.id,\n issues: [error],\n })\n }\n }\n\n const leaveHandler = async (msg: unknown) => {\n dbg(roomLeaveEvent, {\n type: 'rooms',\n phase: 'receive',\n action: 'leave',\n socketId: socket.id,\n payload: msg,\n })\n const parsed = leavePayloadSchema.safeParse(msg)\n if (!parsed.success) {\n socket.emit(`${roomLeaveEvent}:error`, {\n eventName: roomLeaveEvent,\n issues: parsed.error.issues,\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n action: 'leave',\n phase: 'validation_error',\n socketId: socket.id,\n issues: parsed.error.issues,\n payload: msg,\n })\n return\n }\n\n const list = toArray(parsed.data.rooms)\n\n const leave = async (room: string) => {\n await socket.leave(room)\n dbg(null, {\n type: 'rooms',\n action: 'leave',\n rooms: room,\n socketId: socket.id,\n })\n }\n\n const run = async () => {\n await getSysEvent('sys:room_leave')({\n socket,\n helper,\n rooms: list,\n meta: parsed.data.meta as SocketSchemaOutput<C['leaveMetaMessage']>,\n leave,\n })\n }\n\n try {\n await run()\n } catch (error) {\n socket.emit(`${roomLeaveEvent}:error`, {\n error: normalizeError(error),\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n phase: 'handler_error',\n payload: { rooms: list, meta: parsed.data.meta },\n socketId: socket.id,\n issues: [error],\n action: 'join',\n })\n }\n }\n\n // heartbeat, wrapped with sys:ping/sys:pong\n const pingHandler = async (msg: unknown) => {\n if (!heartbeatEnabled) {\n dbg(null, {\n type: 'heartbeat',\n phase: 'skip',\n socketId: socket.id,\n details: { reason: 'heartbeat_disabled' },\n error: false,\n })\n return\n }\n\n const parsedPing = pingPayloadSchema.safeParse(msg)\n if (!parsedPing.success) {\n socket.emit(`${pingEvent}:error`, {\n eventName: pingEvent,\n issues: parsedPing.error.issues,\n })\n dbg(null, {\n type: 'heartbeat',\n phase: 'ping',\n socketId: socket.id,\n payload: includeRaw ? msg : undefined,\n issues: parsedPing.error.issues,\n error: true,\n details: { step: 'parse' },\n })\n return\n }\n const ctx = createCtx(socket)\n\n dbg(null, {\n type: 'heartbeat',\n phase: 'ping',\n socketId: socket.id,\n payload: parsedPing.data,\n error: false,\n })\n\n let pongPayload: SocketSchemaOutput<C['pongPayload']>\n try {\n pongPayload = await getSysEvent('sys:ping')({\n ping: parsedPing.data as SocketSchemaOutput<C['pingPayload']>,\n ctx,\n socket,\n helper,\n })\n } catch (error) {\n socket.emit(`${pingEvent}:error`, { error: normalizeError(error) })\n dbg(null, {\n type: 'heartbeat',\n phase: 'ping',\n socketId: socket.id,\n payload: parsedPing.data,\n error: true,\n details: { step: 'sys_handler_error' },\n })\n return\n }\n\n const parsedPong = pongPayloadSchema.safeParse(pongPayload)\n if (!parsedPong.success) {\n socket.emit(`${pongEvent}:error`, {\n eventName: pongEvent,\n issues: parsedPong.error.issues,\n })\n dbg(null, {\n type: 'heartbeat',\n phase: 'pong',\n socketId: socket.id,\n payload: includeRaw ? pongPayload : undefined,\n issues: parsedPong.error.issues,\n error: true,\n details: { step: 'parse' },\n })\n return\n }\n socket.emit(pongEvent, parsedPong.data)\n dbg(null, {\n type: 'heartbeat',\n phase: 'pong',\n socketId: socket.id,\n payload: parsedPong.data,\n error: false,\n })\n }\n\n // attach built-in handlers\n socket.on(roomJoinEvent, joinHandler)\n socket.on(roomLeaveEvent, leaveHandler)\n if (heartbeatEnabled) {\n socket.on(pingEvent, pingHandler)\n }\n\n const cleanup = (reason: string) => {\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_cleanup',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: { reason },\n })\n socket.off(roomJoinEvent, joinHandler)\n socket.off(roomLeaveEvent, leaveHandler)\n if (heartbeatEnabled) {\n socket.off(pingEvent, pingHandler)\n }\n }\n\n socketTeardowns.set(socket, cleanup)\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_handlers_attached',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: {\n heartbeatEnabled,\n joinEvent: roomJoinEvent,\n leaveEvent: roomLeaveEvent,\n pingEvent: heartbeatEnabled ? pingEvent : undefined,\n },\n })\n\n socket.once('disconnect', (reason) => {\n dbg('sys:disconnect', {\n type: 'lifecycle',\n stage: 'connection_cleanup',\n nsp: socket.nsp.name,\n socketId: socket.id,\n details: { reason },\n })\n const defaultDisconnect = () => {\n cleanup(reason)\n socketTeardowns.delete(socket)\n }\n getSysEvent('sys:disconnect')({\n socket,\n helper,\n reason: String(reason),\n cleanup: defaultDisconnect,\n })\n })\n }\n getSysEvent('sys:connect')({\n socket,\n helper,\n complete: defaultConnect,\n })\n }\n\n return {\n builtInConnectionListener,\n socketTeardowns,\n roomJoinEvent,\n roomLeaveEvent,\n pingEvent,\n }\n}\n","// socket.server.index.ts\nimport { Server, Socket } from 'socket.io'\nimport { z } from 'zod'\nimport type {\n EventMap,\n SocketConnectionConfigOutput,\n Payload,\n} from '@emeryld/rrroutes-contract'\nimport { createDebugger } from './socket.server.debug'\nimport type {\n SocketServerDebugEvent,\n SocketDebugOptions,\n} from './socket.server.debug'\nimport { createBuiltInConnectionHandlers } from './socket.server.sys'\nimport type {\n HeartbeatServerOptions,\n SocketConnectionHelper,\n SysServerEventMap,\n} from './socket.server.sys'\nimport type { HandlerCtx, HandlerCtxNoAck } from './socket.server.types'\n\nconst createBaseHandlerCtx = (socket: Socket): HandlerCtxNoAck => ({\n sentAt: new Date(),\n socket,\n socketId: socket.id,\n nsp: socket.nsp.name,\n rooms: Array.from(socket.rooms),\n user: socket.data?.user,\n scopes: socket.data?.scopes,\n})\n\nconst normalizeError = (error: unknown, verbose?: boolean) => {\n if (error instanceof Error) {\n return {\n name: error.name,\n message: error.message,\n stack: verbose ? error.stack : undefined,\n }\n }\n if (typeof error === 'string') return { message: error }\n if (typeof error === 'object' && error !== null) {\n return verbose ? error : { message: 'Unknown error' }\n }\n return { message: String(error) }\n}\n\nexport interface SocketConnection<T extends EventMap> {\n on<K extends keyof T & string>(\n eventName: K,\n handler: (payload: Payload<T, K>, ctx: HandlerCtx) => void | Promise<void>,\n ): () => void\n\n off<K extends keyof T & string>(eventName: K): void\n\n emit<K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n toRooms?: string[] | string,\n metadata?: Record<string, unknown>,\n onAck?: (ack: unknown) => void,\n ): void\n\n /** Dispose all listeners, timers, and room memberships created by this instance. */\n destroy(): void\n}\n\nexport function createSocketConnections<\n T extends EventMap,\n TConfig extends SocketConnectionConfigOutput = SocketConnectionConfigOutput,\n>(\n io: Server,\n events: T,\n opts: {\n debug?: SocketDebugOptions\n heartbeat?: HeartbeatServerOptions\n /** System event customization (connect / disconnect / ping / pong / room join/leave) */\n sys: SysServerEventMap<TConfig, T>\n config: TConfig\n },\n): SocketConnection<T> {\n const dbg = createDebugger(opts?.debug)\n const socketConfig = opts.config\n const heartbeatEnabled = opts?.heartbeat?.enabled !== false\n const eventNames = Object.keys(events)\n dbg(null, {\n type: 'lifecycle',\n stage: 'server_init',\n details: {\n prefinedEvents: eventNames,\n heartbeatEnabled,\n path: io?.path(),\n namespaces: Array.from(io._nsps.keys()),\n transport: io?._opts.transports,\n sysEvents: Object.keys(opts.sys ?? {}),\n },\n })\n\n const getSchema = <K extends keyof T & string>(k: K) => events[k].message\n const toArray = (rooms?: string[] | string): string[] =>\n rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms]\n const emitToTargets = <K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n targets: string[],\n metadata?: Record<string, unknown>,\n ) => {\n const schema = getSchema(eventName)\n const check = schema.safeParse(payload)\n if (!check.success) {\n dbg(String(eventName), {\n type: 'emit',\n event: String(eventName),\n rooms: targets,\n ...(opts?.debug?.verbose ? { attemptedPayload: payload } : {}),\n error: {\n reason: 'invalid_payload',\n message: check.error.message,\n issues: check.error.issues,\n },\n metadata,\n })\n throw new Error(\n `Invalid payload for \"${String(eventName)}\": ${check.error.message}`,\n )\n }\n\n const envelope = {\n eventName,\n sentAt: new Date(),\n sentTo: targets,\n data: check.data as Payload<T, K>,\n metadata: metadata ?? {},\n }\n\n if (targets.length === 0) io.emit(String(eventName), envelope)\n else if (targets.length === 1) {\n const sid = targets[0]!\n const sock = io.sockets.sockets.get(sid as any)\n if (sock) {\n sock.emit(String(eventName), envelope)\n } else {\n io.to(targets).emit(String(eventName), envelope)\n }\n } else {\n io.to(targets).emit(String(eventName), envelope)\n }\n\n dbg(String(eventName), {\n type: 'emit',\n event: String(eventName),\n rooms: targets,\n envelope: opts?.debug?.verbose ? envelope : undefined,\n })\n }\n const createSocketHelper = (socket: Socket): SocketConnectionHelper<T> => ({\n emit<K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n metadata?: Record<string, unknown>,\n ) {\n emitToTargets(eventName, payload, [socket.id], metadata)\n },\n })\n\n // registrations\n const registrations = new Map<\n string,\n Set<{\n connectionListener: (socket: Socket) => void\n socketListeners: WeakMap<Socket, (raw: unknown) => void>\n }>\n >()\n\n const addRegistration = (\n eventName: string,\n reg: {\n connectionListener: (socket: Socket) => void\n socketListeners: WeakMap<Socket, (raw: unknown) => void>\n },\n ) => {\n let set = registrations.get(eventName)\n if (!set) {\n set = new Set()\n registrations.set(eventName, set)\n }\n set.add(reg)\n }\n\n const removeAllForEvent = (eventName: string) => {\n const set = registrations.get(eventName)\n if (!set) {\n dbg(null, {\n type: 'register',\n event: eventName,\n action: 'unregister',\n msg: 'no handlers registered',\n })\n return\n }\n for (const reg of set) {\n io.off('connection', reg.connectionListener)\n for (const socket of io.sockets.sockets.values()) {\n const wrapped = reg.socketListeners.get(socket)\n if (wrapped) socket.off(String(eventName), wrapped)\n }\n }\n registrations.delete(eventName)\n dbg(eventName, {\n type: 'register',\n action: 'unregister',\n event: eventName,\n msg: 'unregistered',\n })\n }\n\n const {\n builtInConnectionListener,\n socketTeardowns,\n roomJoinEvent,\n roomLeaveEvent,\n pingEvent,\n } = createBuiltInConnectionHandlers<TConfig, T>({\n heartbeat: opts?.heartbeat,\n sys: opts.sys,\n dbg,\n config: socketConfig,\n createCtx: createBaseHandlerCtx,\n debugVerbose: opts?.debug?.verbose === true,\n createHelper: createSocketHelper,\n })\n\n // install built-in connection listener\n io.on('connection', builtInConnectionListener)\n\n const conn = {\n on<K extends keyof T & string>(\n eventName: K,\n handler: (\n payload: Payload<T, K>,\n ctx: HandlerCtx,\n ) => void | Promise<void>,\n ): () => void {\n const socketListeners = new WeakMap<Socket, (raw: unknown) => void>()\n\n const connectionListener = (socket: Socket) => {\n const wrapped = async (raw: unknown) => {\n const schema = getSchema(eventName)\n const parsed = schema.safeParse(raw)\n\n const ctx = createBaseHandlerCtx(socket)\n\n dbg(String(eventName), {\n type: 'handler',\n phase: 'receive',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n rooms: ctx.rooms,\n raw: opts?.debug?.verbose ? raw : undefined,\n })\n\n if (!parsed.success) {\n socket.emit(`${String(eventName)}:error`, {\n eventName,\n sentAt: ctx.sentAt,\n issues: parsed.error.issues,\n })\n dbg(String(eventName), {\n type: 'handler',\n phase: 'validation_error',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n issues: parsed.error.issues,\n })\n return\n }\n\n try {\n await handler(parsed.data as Payload<T, K>, ctx)\n dbg(String(eventName), {\n type: 'handler',\n phase: 'handler_success',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n rooms: ctx.rooms,\n })\n } catch (error) {\n dbg(String(eventName), {\n type: 'handler',\n phase: 'handler_error',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n rooms: ctx.rooms,\n error,\n })\n socket.emit(`${String(eventName)}:error`, {\n eventName,\n sentAt: ctx.sentAt,\n error: normalizeError(error, opts?.debug?.verbose),\n })\n }\n }\n\n socketListeners.set(socket, wrapped)\n socket.on(String(eventName), wrapped)\n socket.once('disconnect', () => {\n const w = socketListeners.get(socket)\n if (w) socket.off(String(eventName), w)\n })\n }\n\n io.on('connection', connectionListener)\n addRegistration(String(eventName), {\n connectionListener,\n socketListeners,\n })\n dbg(String(eventName), {\n type: 'register',\n action: 'register',\n event: String(eventName),\n })\n\n return () => {\n const set = registrations.get(String(eventName))\n if (!set) {\n dbg(null, {\n type: 'register',\n action: 'unregister',\n event: String(eventName),\n msg: `No registration under ${eventName}`,\n })\n return\n }\n for (const reg of Array.from(set)) {\n if (reg.connectionListener === connectionListener) {\n io.off('connection', reg.connectionListener)\n for (const socket of io.sockets.sockets.values()) {\n const wrapped = reg.socketListeners.get(socket)\n if (wrapped) socket.off(String(eventName), wrapped)\n }\n set.delete(reg)\n break\n }\n }\n if (set.size === 0) registrations.delete(String(eventName))\n dbg(String(eventName), {\n type: 'register',\n action: 'unregister',\n event: String(eventName),\n })\n }\n },\n\n off<K extends keyof T & string>(eventName: K): void {\n removeAllForEvent(String(eventName))\n },\n\n emit<K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n rooms?: string[] | string,\n metadata?: Record<string, unknown>,\n ): void {\n const targets = toArray(rooms)\n emitToTargets(eventName, payload, targets, metadata)\n },\n\n destroy(): void {\n dbg(null, {\n type: 'lifecycle',\n stage: 'destroy_start',\n details: {\n socketCount: io.sockets.sockets.size,\n registrationCount: registrations.size,\n },\n })\n // 1) Remove built-in connection listener so no new sockets get handlers\n io.off('connection', builtInConnectionListener)\n\n // 2) Cleanup built-in handlers for all current sockets and leave rooms\n for (const socket of io.sockets.sockets.values()) {\n const cleanup = socketTeardowns.get(socket)\n if (cleanup) {\n cleanup('destroy')\n socketTeardowns.delete(socket)\n } else {\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_cleanup_fallback',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: { reason: 'teardown_missing' },\n })\n // Fallback if socket was attached before map population\n try {\n socket.removeAllListeners(roomJoinEvent)\n socket.removeAllListeners(roomLeaveEvent)\n socket.removeAllListeners(pingEvent)\n } catch {\n // noop\n }\n }\n }\n\n // 3) Remove all user-registered event listeners and their connection hooks\n for (const eventName of Array.from(registrations.keys())) {\n removeAllForEvent(eventName)\n }\n\n // 4) Defensive: clear any residual maps\n registrations.clear()\n dbg(null, {\n type: 'lifecycle',\n stage: 'destroy_complete',\n details: {\n socketCount: io.sockets.sockets.size,\n registrationCount: registrations.size,\n },\n })\n },\n } as const satisfies SocketConnection<T>\n\n return conn\n}\n\nexport type { EventMap, Payload }\nexport type { HandlerCtx } from './socket.server.types'\nexport type {\n SocketServerDebugEvent,\n SocketDebugOptions,\n SocketServerConfigSnapshot,\n SocketServerLifecycleStage,\n SocketServerHeartbeatPhase,\n} from './socket.server.debug'\nexport type {\n HeartbeatServerOptions,\n SocketConnectionHelper,\n SysServerEventMap,\n} from './socket.server.sys'\n","import type { IncomingHttpHeaders } from 'http'\nimport type { Socket } from 'socket.io'\n\nexport type ConnectionMiddlewareStage = 'incoming'\n\nexport type ConnectionMiddlewareContext = {\n socketId?: string\n nsp?: string\n rooms: string[]\n user?: unknown\n scopes?: string[]\n address?: string\n transport?: string\n protocol?: string\n handshake: {\n url?: string\n issued?: number\n time?: string\n query?: Record<string, unknown>\n auth?: Record<string, unknown>\n headers?: IncomingHttpHeaders\n }\n}\n\nexport type ConnectionMiddlewareEvent = {\n type: 'connection'\n stage: ConnectionMiddlewareStage\n timestamp: Date\n context: ConnectionMiddlewareContext\n}\n\nexport type ConnectionLoggingMiddlewareOptions = {\n /**\n * Custom logger invoked with the structured event.\n * Defaults to console.info.\n */\n logger?: (event: ConnectionMiddlewareEvent) => void\n /**\n * Include raw headers from the handshake. Defaults to false to avoid leaking PII.\n */\n includeHeaders?: boolean\n /**\n * List of auth keys that should be redacted (case-insensitive). Defaults to ['authorization'].\n */\n redactAuthKeys?: string[]\n}\n\nconst defaultRedactedValue = '[REDACTED]'\n\nconst defaultLogger = (event: ConnectionMiddlewareEvent) => {\n const {\n stage,\n context: { socketId, nsp, address, transport, handshake },\n } = event\n // eslint-disable-next-line no-console\n console.info('[socket-connection]', {\n stage,\n socketId,\n nsp,\n address,\n transport,\n url: handshake.url,\n query: handshake.query,\n auth: handshake.auth,\n })\n}\n\nconst redactAuth = (\n auth: Record<string, unknown> | undefined,\n redactKeys: Set<string>,\n): Record<string, unknown> | undefined => {\n if (!auth) return undefined\n if (redactKeys.size === 0) return auth\n\n const clone: Record<string, unknown> = {}\n for (const [key, value] of Object.entries(auth)) {\n const normalizedKey = key.toLowerCase()\n clone[key] = redactKeys.has(normalizedKey) ? defaultRedactedValue : value\n }\n return clone\n}\n\nconst buildContext = (\n socket: Socket,\n includeHeaders: boolean,\n redactKeys: Set<string>,\n): ConnectionMiddlewareContext => {\n const conn = socket.conn as\n | {\n remoteAddress?: string\n transport?: { name?: string }\n protocol?: string | number\n }\n | undefined\n\n const handshake = socket.handshake ?? {}\n\n const protocolValue = conn?.protocol\n\n return {\n socketId: socket.id,\n nsp: socket.nsp?.name,\n rooms: Array.from(socket.rooms ?? []),\n user: (socket.data as any)?.user,\n scopes: (socket.data as any)?.scopes,\n address: conn?.remoteAddress ?? (handshake as any).address,\n transport: conn?.transport?.name,\n protocol: protocolValue != null ? String(protocolValue) : undefined,\n handshake: {\n url: handshake.url,\n issued: handshake.issued,\n time: handshake.time,\n query: handshake.query as Record<string, unknown>,\n auth: redactAuth(handshake.auth as Record<string, unknown>, redactKeys),\n headers: includeHeaders\n ? (handshake.headers as IncomingHttpHeaders)\n : undefined,\n },\n }\n}\n\nexport const createConnectionLoggingMiddleware = (\n options: ConnectionLoggingMiddlewareOptions = {},\n) => {\n const logger = options.logger ?? defaultLogger\n const includeHeaders = options.includeHeaders ?? false\n const redactKeys = new Set(\n (options.redactAuthKeys ?? ['authorization', 'token']).map((key) =>\n key.toLowerCase(),\n ),\n )\n\n return (socket: Socket, next: (err?: Error) => void) => {\n const context = buildContext(socket, includeHeaders, redactKeys)\n logger({\n type: 'connection',\n stage: 'incoming',\n timestamp: new Date(),\n context,\n })\n next()\n }\n}\n\nexport type ConnectionLoggingMiddleware = ReturnType<\n typeof createConnectionLoggingMiddleware\n>\n"],"mappings":"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","names":["import_rrroutes_contract","normalizeError","toArray"]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/routesV3.server.ts","../src/sockets/socket.server.debug.ts","../src/sockets/socket.server.sys.ts","../src/sockets/socket.server.index.ts","../src/sockets/socket.server.middleware.ts"],"sourcesContent":["export { keyOf as contractKeyOf } from '@emeryld/rrroutes-contract'\nexport * from './routesV3.server'\nexport * from './sockets/socket.server.index'\nexport * from './sockets/socket.server.middleware'\n","/**\n * routesV3.server.ts\n * -----------------------------------------------------------------------------\n * Bind an Express router/app to a `finalize(...)` registry of AnyLeafs.\n * - Fully typed handlers (params/query/body/output)\n * - Zod parsing + optional output validation\n * - buildCtx runs as a middleware *first*, before all other middlewares\n * - Global, per-route, and cfg-derived middlewares (auth, uploads)\n * - Helper to warn about unimplemented routes\n * - DX helpers to use `ctx` in any middleware with proper types\n */\n\nimport {\n AnyLeafLowProfile,\n FileField,\n HttpMethod,\n InferBody,\n InferOutput,\n InferParams,\n InferQuery,\n keyOf,\n lowProfileParse,\n} from '@emeryld/rrroutes-contract'\nimport type * as express from 'express'\nimport type { RequestHandler, Router } from 'express'\n\n/** Shape expected from optional logger implementations. */\nexport type LoggerLike = {\n info?: (...args: any[]) => void\n warn?: (...args: any[]) => void\n error?: (...args: any[]) => void\n debug?: (...args: any[]) => void\n verbose?: (...args: any[]) => void\n system?: (...args: any[]) => void\n log?: (...args: any[]) => void\n}\n\ntype RoutesLoggerCarrier = {\n routesLogger?: LoggerLike\n}\n\ntype CtxWithRoutesLogger<Ctx> = Ctx & RoutesLoggerCarrier\n\n// Debug logging --------------------------------------------------------------\nexport type RouteServerDebugMode = 'minimal' | 'complete'\n\ntype RouteServerDebugEventBase = {\n /** Optional logical name assigned via `RouteDef.debug?.debugName` (or `RouteDef.debugName`). */\n name?: string\n}\n\nexport type RouteServerDebugEvent =\n | (RouteServerDebugEventBase & {\n type: 'request'\n stage: 'start' | 'success' | 'error'\n method: Uppercase<HttpMethod>\n path: string\n url: string\n durationMs?: number\n params?: unknown\n query?: unknown\n body?: unknown\n output?: unknown\n error?: unknown\n })\n | (RouteServerDebugEventBase & {\n type: 'register'\n method: Uppercase<HttpMethod>\n path: string\n })\n | (RouteServerDebugEventBase & {\n type: 'buildCtx'\n stage: 'start' | 'success' | 'error'\n method: Uppercase<HttpMethod>\n path: string\n url: string\n durationMs?: number\n error?: unknown\n })\n | (RouteServerDebugEventBase & {\n type: 'handler'\n stage: 'start' | 'success' | 'error'\n method: Uppercase<HttpMethod>\n path: string\n durationMs?: number\n params?: unknown\n query?: unknown\n body?: unknown\n output?: unknown\n error?: unknown\n })\n\nexport type RouteServerDebugLogger = (event: RouteServerDebugEvent) => void\n\n/**\n * Configure server-side debug logging.\n * - Use booleans or `'minimal'/'complete'` for quick toggles.\n * - Pass a custom logger function to redirect structured events.\n * - Provide a map to enable specific event types, opt into verbose payload logging, or restrict logs via `only`.\n */\nexport type RouteServerDebugOptions<Names extends string = string> =\n RouteServerDebugToggleOptions<Names>\n\n/**\n * Fine-grained toggle map for server debug logging.\n * Enable individual event types, opt into verbose payload logging, override the logger, or restrict to named routes.\n * Use `RouteDef.debug?.debugName` (or the deprecated `RouteDef.debugName`) to set the name that `only` will match against.\n */\nexport type RouteServerDebugToggleOptions<Names extends string = string> =\n Partial<Record<RouteServerDebugEvent['type'], boolean>> & {\n verbose?: boolean\n logger?: RouteServerDebugLogger\n only?: Names[]\n }\n\n/**\n * Per-route debug overrides. Same toggles as `RouteServerDebugOptions`, but limited to a single route\n * and therefore replaces the `only` filter with a local `debugName`.\n */\nexport type RouteDefDebugOptions<Names extends string = string> = Omit<\n RouteServerDebugToggleOptions<Names>,\n 'only'\n> & {\n debugName?: Names\n}\n\nconst serverDebugEventTypes: RouteServerDebugEvent['type'][] = [\n 'register',\n 'request',\n 'buildCtx',\n 'handler',\n]\n\ntype ServerDebugEmitter<Names extends string> = {\n emit: (event: RouteServerDebugEvent, name?: Names) => void\n mode: RouteServerDebugMode\n}\n\nconst noopServerEmit = () => {}\n\nfunction createServerDebugEmitter<Names extends string>(\n option?: RouteServerDebugOptions<Names>,\n): ServerDebugEmitter<Names> {\n const disabled: ServerDebugEmitter<Names> = {\n emit: noopServerEmit,\n mode: 'minimal',\n }\n if (!option) return disabled\n\n if (typeof option === 'object') {\n const toggles = option as RouteServerDebugToggleOptions<Names>\n const verbose = Boolean(toggles.verbose)\n const enabledTypes = serverDebugEventTypes.filter((type) => toggles[type])\n if (enabledTypes.length === 0) {\n return { emit: noopServerEmit, mode: verbose ? 'complete' : 'minimal' }\n }\n const whitelist = new Set<RouteServerDebugEvent['type']>(enabledTypes)\n const onlySet =\n toggles.only && toggles.only.length > 0\n ? new Set<Names>(toggles.only)\n : undefined\n const logger = toggles.logger\n const emit: ServerDebugEmitter<Names>['emit'] = (event, name) => {\n if (!whitelist.has(event.type) || !logger) return\n if (onlySet && (!name || !onlySet.has(name))) return\n logger(name ? { ...event, name } : event)\n }\n return { emit, mode: verbose ? 'complete' : 'minimal' }\n }\n\n return disabled\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Keys + leaf helpers (derive keys from byKey to avoid template-literal pitfalls)\n// ──────────────────────────────────────────────────────────────────────────────\n\n/** Keys like \"GET /v1/foo\" that *actually* exist in the registry */\nexport type KeysOfRegistry<\n R extends { byKey: Record<string, AnyLeafLowProfile> },\n> = keyof R['byKey'] & string\n\ntype MethodFromKey<K extends string> = K extends `${infer M} ${string}`\n ? Lowercase<M>\n : never\ntype PathFromKey<K extends string> = K extends `${string} ${infer P}`\n ? P\n : never\n\n/** Given a registry and a key, pick the exact leaf for that method+path */\nexport type LeafFromKey<\n R extends { all: readonly AnyLeafLowProfile[] },\n K extends string,\n> = Extract<\n R['all'][number],\n { method: MethodFromKey<K> & HttpMethod; path: PathFromKey<K> }\n>\n\n/** Optional-ify types if your core returns `never` when a schema isn't defined */\ntype Maybe<T> = [T] extends [never] ? void : T\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst decodeJsonLikeQueryValue = (value: unknown): unknown => {\n if (Array.isArray(value)) {\n return value.map((entry) => decodeJsonLikeQueryValue(entry))\n }\n if (isPlainObject(value)) {\n const next: Record<string, unknown> = {}\n for (const [key, child] of Object.entries(value)) {\n next[key] = decodeJsonLikeQueryValue(child)\n }\n return next\n }\n if (typeof value === 'string') {\n const trimmed = value.trim()\n if (\n (trimmed.startsWith('{') && trimmed.endsWith('}')) ||\n (trimmed.startsWith('[') && trimmed.endsWith(']'))\n ) {\n try {\n return JSON.parse(trimmed)\n } catch {\n return value\n }\n }\n }\n return value\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Context typing & DX helpers (so ctx is usable in *any* middleware)\n// ──────────────────────────────────────────────────────────────────────────────\n\n/**\n * Unique symbol used to stash ctx on res.locals.\n * (Symbols are safer than string keys against collisions.)\n */\nexport const CTX_SYMBOL: unique symbol = Symbol.for('typedLeaves.ctx')\n\n/** Response type that *has* a ctx on locals for DX in middlewares */\nexport type ResponseWithCtx<Ctx> =\n // Replace locals with an intersection that guarantees CTX_SYMBOL exists\n Omit<express.Response, 'locals'> & {\n locals: express.Response['locals'] & {\n [CTX_SYMBOL]: CtxWithRoutesLogger<Ctx>\n }\n }\n\n/** A middleware signature that can *use* ctx via `res.locals[CTX_SYMBOL]` */\nexport type CtxRequestHandler<Ctx> = (args: {\n req: express.Request\n res: express.Response\n next: express.NextFunction\n ctx: CtxWithRoutesLogger<Ctx>\n}) => any\n\n/**\n * Safely read ctx from any Response.\n * @param res Express response whose locals contain the ctx symbol.\n * @returns Strongly typed context object.\n */\nexport function getCtx<Ctx = unknown>(\n res: express.Response,\n): CtxWithRoutesLogger<Ctx> {\n return (res.locals as any)[CTX_SYMBOL] as CtxWithRoutesLogger<Ctx>\n}\n\n/**\n * Wrap a ctx-typed middleware to a plain RequestHandler (for arrays, etc.).\n * @param mw Middleware that expects a typed response with ctx available.\n * @returns Standard Express request handler.\n */\nfunction adaptCtxMw<Ctx>(mw: CtxRequestHandler<Ctx>): RequestHandler {\n return (req, res, next) => {\n try {\n const result = mw({ req, res, next, ctx: getCtx<Ctx>(res) })\n if (result && typeof (result as Promise<unknown>).then === 'function') {\n return (result as Promise<unknown>).catch((err) => next(err))\n }\n return result as any\n } catch (err) {\n next(err as any)\n return undefined\n }\n }\n}\n\nfunction logHandlerDebugWithRoutesLogger(\n logger: LoggerLike | undefined,\n event: RouteServerDebugEvent,\n) {\n if (!logger || event.type !== 'handler') return\n const payload: [string, RouteServerDebugEvent] = [\n `[rrroutes-server][handler:${event.stage}] ${event.method} ${event.path}`,\n event,\n ]\n if (event.stage === 'error') {\n ;(\n logger.error ??\n logger.warn ??\n logger.debug ??\n logger.info ??\n logger.log ??\n logger.system\n )?.call(logger, ...payload)\n return\n }\n ;(\n logger.debug ??\n logger.verbose ??\n logger.info ??\n logger.log ??\n logger.system\n )?.call(logger, ...payload)\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Controller types — object form only (simpler, clearer typings)\n// ──────────────────────────────────────────────────────────────────────────────\n\n/** Typed route handler for a specific leaf */\n\nexport type Handler<L extends AnyLeafLowProfile, Ctx = unknown> = (args: {\n req: express.Request\n res: express.Response\n next: express.NextFunction\n ctx: CtxWithRoutesLogger<Ctx>\n params: Maybe<InferParams<L>>\n query: Maybe<InferQuery<L>>\n body: Maybe<InferBody<L>>\n}) => Promise<Maybe<InferOutput<L>>> | Maybe<InferOutput<L>>\n\n/** Route definition for one key */\nexport type RouteDef<\n L extends AnyLeafLowProfile,\n Ctx = unknown,\n Names extends string = string,\n> = {\n /** Middlewares before the handler (run after buildCtx/global/derived) */\n before?: Array<CtxRequestHandler<Ctx>>\n /** Your business logic */\n handler: Handler<L, Ctx>\n /**\n * Optional per-route debug overrides. When provided, these replace the global debug options.\n */\n debug?: RouteDefDebugOptions<Names>\n}\n\n/** Map of registry keys -> route defs */\nexport type ControllerMap<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n> = {\n [P in KeysOfRegistry<R>]: RouteDef<LeafFromKey<R, P>, Ctx, Names>\n}\n\nexport type PartialControllerMap<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n> = Partial<ControllerMap<R, Ctx, Names>>\n\n// ──────────────────────────────────────────────────────────────────────────────\n/** Options + derivation helpers */\n// ──────────────────────────────────────────────────────────────────────────────\n\nexport type RouteServerConfig<Ctx = unknown, Names extends string = string> = {\n /**\n * Build a request-scoped context. We wrap this in a middleware that runs\n * *first* (before global/derived/route middlewares), and stash it on\n * `res.locals[CTX_SYMBOL]` so *all* later middlewares can use it.\n * You can optionally include `routesLogger` to override handler debug logging per request.\n */\n buildCtx: (\n req: express.Request,\n res: express.Response,\n ) => CtxWithRoutesLogger<Ctx> | Promise<CtxWithRoutesLogger<Ctx>>\n\n /** Grouped global middlewares that run before the handler for every route. */\n globalMiddleware?: Array<CtxRequestHandler<Ctx>>\n\n /**\n * Derive middleware from MethodCfg.\n * - `upload` runs when cfg.bodyFiles has entries\n */\n fromCfg?: {\n upload?: (files: FileField[] | undefined) => RequestHandler[]\n }\n\n /** Validate handler return values with outputSchema (default: true) */\n validateOutput?: boolean\n\n /** Custom responder (default: res.json(data)) */\n send?: (res: express.Response, data: unknown) => void\n\n /** Optional logger hooks */\n logger?: LoggerLike\n\n /**\n * Optional debug logging for the request lifecycle.\n * Supports booleans/modes/loggers, or a toggle map with per-event enabling, verbose payload logging,\n * and `only` filters tied to `RouteDef.debug?.debugName` (or the deprecated `RouteDef.debugName`).\n */\n debug?: RouteServerDebugOptions<Names>\n}\n\n/** Default JSON responder (typed to avoid implicit-any diagnostics) */\nconst defaultSend: (res: express.Response, data: unknown) => void = (\n res,\n data,\n) => {\n res.json(data as any)\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Core builder\n// ──────────────────────────────────────────────────────────────────────────────\n\nconst REGISTERED_ROUTES_SYMBOL = Symbol.for('routesV3.registeredRoutes')\n\ntype RegisteredRouteStore = Set<string>\n\n/**\n * Retrieve or initialize the shared store of registered route keys.\n * @param router Express router/application that carries previously registered keys.\n * @returns Set of string keys describing registered routes.\n */\nfunction getRegisteredRouteStore(router: Router): RegisteredRouteStore {\n const existing = (router as any)[REGISTERED_ROUTES_SYMBOL] as\n | RegisteredRouteStore\n | undefined\n if (existing) return existing\n const store: RegisteredRouteStore = new Set()\n ;(router as any)[REGISTERED_ROUTES_SYMBOL] = store\n return store\n}\n\n/**\n * Inspect the Express layer stack to discover already-registered routes.\n * @param appOrRouter Express application or router to inspect.\n * @returns All keys in the form `\"METHOD /path\"` found on the stack.\n */\nfunction collectRoutesFromStack(appOrRouter: Router): string[] {\n const result: string[] = []\n const stack: any[] =\n (appOrRouter as any).stack ??\n ((appOrRouter as any)._router\n ? (appOrRouter as any)._router.stack\n : undefined) ??\n []\n\n if (!Array.isArray(stack)) return result\n\n for (const layer of stack) {\n const route = layer && layer.route\n if (!route) continue\n\n const paths = Array.isArray(route.path) ? route.path : [route.path]\n const methodEntries = Object.entries(route.methods ?? {}).filter(\n ([, enabled]) => enabled,\n )\n\n for (const path of paths) {\n for (const [method] of methodEntries) {\n result.push(`${method.toUpperCase()} ${path}`)\n }\n }\n }\n\n return result\n}\n\n/** Runtime helpers returned by `createRRRoute`. */\nexport type RouteServer<Ctx = unknown, Names extends string = string> = {\n router: Router\n register<L extends AnyLeafLowProfile>(\n leaf: L,\n def: RouteDef<L, Ctx, Names>,\n ): void\n registerControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n F extends boolean = false,\n >(\n registry: R,\n controllers: F extends false\n ? PartialControllerMap<R, Ctx, Names>\n : ControllerMap<R, Ctx, Names>,\n all?: F,\n ): void\n warnMissingControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n >(\n registry: R,\n logger: { warn: (...args: any[]) => void },\n ): void\n getRegisteredKeys(): string[]\n}\n\n/**\n * Create an Express binding helper that keeps routes and controllers in sync.\n * @param router Express router or app to register handlers on.\n * @param config Optional configuration controlling ctx building, auth, uploads, etc.\n * @param middleware The order of the middlewares is: buildCtx -> global -> fromCfg -> route -> handler. Remember to call `ctx.next()` in your middlewares to continue the chain.\n * @returns Object with helpers to register controllers and inspect registered keys.\n */\nexport function createRRRoute<Ctx = unknown, Names extends string = string>(\n router: Router,\n config: RouteServerConfig<Ctx, Names>,\n): RouteServer<Ctx, Names> {\n const validateOutput = config.validateOutput ?? true\n const send = config.send ?? defaultSend\n const logger = config.logger\n const { emit: defaultEmitDebug, mode: defaultDebugMode } =\n createServerDebugEmitter<Names>(config.debug)\n\n const knownLeaves = new Map<string, AnyLeafLowProfile>()\n\n const decorateDebugEvent = <T extends RouteServerDebugEvent>(\n isVerbose: boolean,\n event: T,\n details?: Partial<RouteServerDebugEvent>,\n ): RouteServerDebugEvent => {\n if (!isVerbose || !details) return event\n return { ...event, ...details } as RouteServerDebugEvent\n }\n\n const globalBeforeMws = [...(config.globalMiddleware ?? [])].map((mw) =>\n adaptCtxMw<Ctx>(mw),\n )\n const registered = getRegisteredRouteStore(router)\n\n const buildDerived = (leaf: AnyLeafLowProfile): RequestHandler[] => {\n const derived: RequestHandler[] = []\n if (\n config.fromCfg?.upload &&\n Array.isArray(leaf.cfg.bodyFiles) &&\n leaf.cfg.bodyFiles.length > 0\n ) {\n derived.push(...config.fromCfg.upload(leaf.cfg.bodyFiles))\n }\n\n return derived\n }\n\n /** Register a single leaf/controller pair on the underlying router. */\n function register<L extends AnyLeafLowProfile>(\n leaf: L,\n def: RouteDef<L, Ctx, Names>,\n ) {\n const method = leaf.method as HttpMethod\n const methodUpper = method.toUpperCase() as Uppercase<HttpMethod>\n const path = leaf.path as string\n const key = keyOf(leaf.method, leaf.path, false)\n const defDebug = def.debug\n let debugName = undefined as Names | undefined\n let routeDebugEmitter: ServerDebugEmitter<Names> | undefined\n if (defDebug) {\n const { debugName: overrideName, ...rest } = defDebug\n const hasOverrides = Object.values(rest).some(\n (value) => value !== undefined,\n )\n if (hasOverrides) {\n routeDebugEmitter = createServerDebugEmitter<Names>({\n ...config.debug,\n ...rest,\n })\n }\n debugName = (overrideName ?? debugName) as Names | undefined\n }\n const activeEmit = routeDebugEmitter?.emit ?? defaultEmitDebug\n const activeDebugMode = routeDebugEmitter?.mode ?? defaultDebugMode\n const emit = (event: RouteServerDebugEvent) => activeEmit(event, debugName)\n const isVerboseDebug = activeDebugMode === 'complete'\n emit({ type: 'register', method: methodUpper, path })\n\n const routeSpecific = (def?.before ?? []).map((mw) => adaptCtxMw<Ctx>(mw))\n const derived = buildDerived(leaf)\n const ctxMw: RequestHandler = async (req, res, next) => {\n const requestUrl = req.originalUrl ?? path\n const startedAt = Date.now()\n emit({\n type: 'buildCtx',\n stage: 'start',\n method: methodUpper,\n path,\n url: requestUrl,\n })\n try {\n const ctx = await config.buildCtx(req, res)\n ;(res.locals as any)[CTX_SYMBOL] = ctx\n emit({\n type: 'buildCtx',\n stage: 'success',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n })\n next()\n } catch (err) {\n emit({\n type: 'buildCtx',\n stage: 'error',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n error: err,\n })\n logger?.error?.('buildCtx error', err)\n next(err as any)\n }\n }\n const before: RequestHandler[] = [\n ctxMw,\n ...globalBeforeMws,\n ...derived,\n ...routeSpecific,\n ]\n\n const wrapped: RequestHandler = async (req, res, next) => {\n const requestUrl = req.originalUrl.split('?')[0] ?? path\n const startedAt = Date.now()\n emit({\n type: 'request',\n stage: 'start',\n method: methodUpper,\n path,\n url: requestUrl,\n })\n let params: InferParams<L> | undefined\n let query: InferQuery<L> | undefined\n let body: InferBody<L> | undefined\n let responsePayload: InferOutput<L> | undefined\n let hasResponsePayload = false\n const downstreamNext: express.NextFunction = next\n\n const ctx = (res.locals as any)[CTX_SYMBOL] as CtxWithRoutesLogger<Ctx>\n const ctxRoutesLogger = ctx?.routesLogger\n const emitWithCtx = (\n event: RouteServerDebugEvent,\n details?: Partial<RouteServerDebugEvent>,\n ) => {\n const decorated = decorateDebugEvent(isVerboseDebug, event, details)\n if (!config.debug || !config.debug[decorated.type]) {\n return\n }\n if (decorated.type === 'handler' && ctxRoutesLogger) {\n logHandlerDebugWithRoutesLogger(ctxRoutesLogger, decorated)\n } else {\n emit(decorated)\n }\n }\n try {\n params = (\n leaf.cfg.paramsSchema\n ? lowProfileParse(leaf.cfg.paramsSchema, req.params)\n : Object.keys(req.params || {}).length\n ? (req.params as any)\n : undefined\n ) as InferParams<L>\n\n try {\n const parsedQueryInput =\n leaf.cfg.querySchema && req.query\n ? (decodeJsonLikeQueryValue(req.query) as Record<string, unknown>)\n : req.query\n query = leaf.cfg.querySchema\n ? lowProfileParse(leaf.cfg.querySchema, parsedQueryInput)\n : Object.keys(req.query || {}).length\n ? (req.query as any)\n : undefined\n } catch (e) {\n logger?.error?.('Query parsing error', {\n path,\n method: methodUpper,\n error: e,\n raw: JSON.stringify(req.query),\n })\n throw e\n }\n\n body = (\n leaf.cfg.bodySchema\n ? lowProfileParse(leaf.cfg.bodySchema, req.body)\n : req.body !== undefined\n ? (req.body as any)\n : undefined\n ) as InferBody<L>\n\n logger?.verbose?.(`${methodUpper}@${path} (${requestUrl})`, {\n params,\n query,\n body,\n })\n\n const handlerStartedAt = Date.now()\n emitWithCtx(\n {\n type: 'handler',\n stage: 'start',\n method: methodUpper,\n path,\n },\n isVerboseDebug ? { params, query, body } : undefined,\n )\n\n let result\n try {\n result = await def.handler({\n req,\n res,\n next: downstreamNext,\n ctx,\n params: params as Maybe<InferParams<L>>,\n query: query as Maybe<InferQuery<L>>,\n body: body as Maybe<InferBody<L>>,\n })\n emitWithCtx(\n {\n type: 'handler',\n stage: 'success',\n method: methodUpper,\n path,\n durationMs: Date.now() - handlerStartedAt,\n },\n isVerboseDebug\n ? {\n params,\n query,\n body,\n ...(result !== undefined ? { output: result } : {}),\n }\n : undefined,\n )\n } catch (e) {\n emitWithCtx(\n {\n type: 'handler',\n stage: 'error',\n method: methodUpper,\n path,\n durationMs: Date.now() - handlerStartedAt,\n error: e,\n },\n isVerboseDebug ? { params, query, body } : undefined,\n )\n logger?.error?.('Handler error', e)\n throw e\n }\n\n const out =\n validateOutput && leaf.cfg.outputSchema\n ? lowProfileParse(leaf.cfg.outputSchema, result)\n : result\n responsePayload = out as InferOutput<L>\n hasResponsePayload = true\n logger?.verbose?.(`${methodUpper}@${path} result`, out)\n send(res, out)\n\n emitWithCtx(\n {\n type: 'request',\n stage: 'success',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n },\n isVerboseDebug\n ? {\n params,\n query,\n body,\n ...(hasResponsePayload ? { output: responsePayload } : {}),\n }\n : undefined,\n )\n } catch (err) {\n emitWithCtx(\n {\n type: 'request',\n stage: 'error',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n error: err,\n },\n isVerboseDebug ? { params, query, body } : undefined,\n )\n logger?.error?.('Route error', err)\n next(err as any)\n }\n }\n\n ;(router as any)[method](path, ...before, wrapped)\n registered.add(key)\n }\n\n /**\n * Register controller definitions for the provided keys.\n * @param registry Finalized registry of leaves.\n * @param controllers Partial controller map keyed by `\"METHOD /path\"`.\n * @param all Deprecated runtime toggle. Passing any truthy value will throw.\n */\n function registerControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n F extends boolean = false,\n >(registry: R, controllers: PartialControllerMap<R, Ctx, Names>, all?: F) {\n if (all !== undefined && all !== false) {\n const label =\n typeof all === 'string' ? all : all === true ? 'true' : String(all)\n throw new Error(\n `registerControllers: \"${label}\" is not allowed at runtime. Use bindAll(...) for compile-time coverage or warnMissingControllers(...) to surface missing routes.`,\n )\n }\n\n for (const leaf of registry.all) {\n const key = keyOf(leaf.method, leaf.path, false)\n knownLeaves.set(key, leaf)\n }\n\n ;(Object.keys(controllers) as Array<KeysOfRegistry<R>>).forEach((key) => {\n const leaf = registry.byKey[key] as unknown as\n | LeafFromKey<R, typeof key>\n | undefined\n if (!leaf) {\n logger?.warn?.(\n `No leaf found for controller key: ${key}. Not registering route.`,\n )\n return\n }\n const def = controllers[key]\n if (!def) return\n register(leaf as LeafFromKey<R, typeof key>, def)\n })\n }\n\n /**\n * Warn about leaves that do not have a registered controller.\n * @param registry Finalized registry of leaves.\n * @param warnLogger Logger used for warning output.\n */\n function warnMissing<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n >(registry: R, warnLogger: { warn: (...args: any[]) => void }) {\n const registeredFromStore = new Set<string>(Array.from(registered))\n if (registeredFromStore.size === 0) {\n collectRoutesFromStack(router).forEach((key) =>\n registeredFromStore.add(key),\n )\n }\n for (const leaf of registry.all) {\n const key = keyOf(leaf.method, leaf.path, false)\n if (!registeredFromStore.has(key)) {\n warnLogger.warn(`No controller registered for route: ${key}`)\n }\n }\n }\n\n return {\n router,\n register,\n registerControllers,\n warnMissingControllers: warnMissing,\n getRegisteredKeys: () => Array.from(registered),\n }\n}\n\n/**\n * Bind only the controllers that are present in the provided map.\n * @param router Express router or app.\n * @param registry Finalized registry produced by `finalize(...)`.\n * @param controllers Partial map of controllers keyed by `\"METHOD /path\"`.\n * @param config Optional route server configuration.\n * @returns The same router instance for chaining.\n */\nexport function bindExpressRoutes<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n>(\n router: Router,\n registry: R,\n controllers: PartialControllerMap<R, Ctx, Names>,\n config: RouteServerConfig<Ctx, Names>,\n) {\n const server = createRRRoute<Ctx, Names>(router, config)\n server.registerControllers(registry, controllers)\n return router\n}\n\n/**\n * Bind controllers for every leaf. Missing entries fail at compile time.\n * @param router Express router or app.\n * @param registry Finalized registry produced by `finalize(...)`.\n * @param controllers Complete map of controllers keyed by `\"METHOD /path\"`.\n * @param config Optional route server configuration.\n * @returns The same router instance for chaining.\n */\nexport function bindAll<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n>(\n router: Router,\n registry: R,\n controllers: {\n [K in KeysOfRegistry<R>]: RouteDef<LeafFromKey<R, K>, Ctx, Names>\n },\n config: RouteServerConfig<Ctx, Names>,\n) {\n const server = createRRRoute<Ctx, Names>(router, config)\n server.registerControllers(registry, controllers)\n return router\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// DX helpers\n// ──────────────────────────────────────────────────────────────────────────────\n\n/**\n * Helper for great IntelliSense when authoring controller maps.\n * @returns Function that enforces key names while preserving partial flexibility.\n */\nexport const defineControllers =\n <\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n >() =>\n <M extends PartialControllerMap<R, Ctx, Names>>(m: M) =>\n m\n\n/**\n * Warn about leaves that don't have controllers.\n * Call this during startup to surface missing routes.\n * @param router Express router or app to inspect.\n * @param registry Finalized registry produced by `finalize(...)`.\n * @param logger Logger where warnings are emitted.\n */\nexport function warnMissingControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n>(router: Router, registry: R, logger: { warn: (...args: any[]) => void }) {\n const registeredStore = (router as any)[REGISTERED_ROUTES_SYMBOL] as\n | Set<string>\n | undefined\n const initial = registeredStore\n ? Array.from(registeredStore)\n : collectRoutesFromStack(router)\n const registeredKeys = new Set<string>(initial)\n\n for (const leaf of registry.all) {\n const k = keyOf(leaf.method, leaf.path, false)\n if (!registeredKeys.has(k)) {\n logger.warn(`No controller registered for route: ${k}`)\n }\n }\n}\n","// socket.server.debug.ts\nimport type { IncomingHttpHeaders } from 'http'\n\nexport type SocketServerConfigSnapshot = {\n url?: string\n transport?: string\n protocol?: string\n address?: string\n issued?: number\n time?: string\n query?: Record<string, unknown>\n auth?: Record<string, unknown>\n headers?: IncomingHttpHeaders\n}\n\nexport type SocketServerLifecycleStage =\n | 'server_init'\n | 'connection_listener_installed'\n | 'connection_init'\n | 'connection_handlers_attached'\n | 'connection_cleanup'\n | 'destroy_start'\n | 'destroy_complete'\n | 'connection_cleanup_fallback'\n\nexport type SocketServerHeartbeatPhase = 'ping' | 'pong' | 'skip'\n\nexport type SocketServerDebugEvent =\n | {\n type: 'register'\n action: 'register' | 'unregister'\n event: string\n msg?: string\n }\n | {\n type: 'handler'\n phase:\n | 'receive'\n | 'validation_error'\n | 'handler_success'\n | 'handler_error'\n event: string\n socketId?: string\n nsp?: string\n rooms?: string[]\n raw?: unknown\n issues?: any[]\n error?: unknown\n details?: Record<string, unknown>\n }\n | {\n type: 'emit'\n event: string\n rooms: string[]\n envelope?: unknown\n error?: {\n reason: string\n message?: string\n issues?: unknown\n }\n metadata?: unknown\n }\n | {\n type: 'rooms'\n action: 'join' | 'leave'\n rooms?: string | string[]\n socketId: string\n phase?: string\n payload?: unknown\n issues?: any[]\n }\n | {\n type: 'heartbeat'\n phase: SocketServerHeartbeatPhase\n socketId: string\n payload?: unknown\n issues?: any[]\n error?: boolean\n details?: Record<string, unknown>\n }\n | {\n type: 'config'\n socketId: string\n nsp: string\n snapshot: SocketServerConfigSnapshot\n }\n | {\n type: 'lifecycle'\n stage: SocketServerLifecycleStage\n socketId?: string\n nsp?: string\n details?: Record<string, unknown>\n }\n\nexport type SocketDebugOptions = {\n verbose?: boolean\n /** filters event-based logs (register/handler/emit) by event name */\n only?: string[]\n logger?: (e: SocketServerDebugEvent) => void\n} & {\n [P in SocketServerDebugEvent['type']]?: boolean\n}\n\nexport function createDebugger(options?: SocketDebugOptions) {\n const debug = options ?? {}\n\n return (maybeEvent: string | null, e: SocketServerDebugEvent) => {\n if (!debug.logger) return\n if (!debug[e.type]) return\n\n // only filter applies to event-shaped logs\n if (\n debug.only &&\n maybeEvent &&\n (e.type === 'register' || e.type === 'handler' || e.type === 'emit') &&\n !debug.only.includes(maybeEvent)\n ) {\n return\n }\n\n debug.logger(e)\n }\n}\n","// socket.server.sys.ts\nimport type { Socket } from 'socket.io'\nimport { z } from 'zod'\nimport type {\n EventMap,\n Payload,\n SocketConnectionConfigOutput,\n SocketSchemaOutput,\n SysEventName,\n} from '@emeryld/rrroutes-contract'\nimport type {\n SocketServerConfigSnapshot,\n SocketServerDebugEvent,\n} from './socket.server.debug'\nimport type { HandlerCtxNoAck } from './socket.server.types'\n\nexport type SocketConnectionHelper<Events extends EventMap> = {\n emit<K extends keyof Events & string>(\n event: K,\n payload: Payload<Events, K>,\n metadata?: Record<string, unknown>,\n onAck?: (ack: unknown) => void,\n ): void\n}\n\n/** Heartbeat configuration that is not tied to payload shapes (which live in sys event schemas). */\nexport type HeartbeatServerOptions = {\n /** Enable/disable built-in heartbeat handling. Defaults to true. */\n enabled?: boolean\n}\n\nexport type SysServerEventMap<\n Config extends SocketConnectionConfigOutput = SocketConnectionConfigOutput,\n Events extends EventMap = EventMap,\n> = {\n 'sys:connect': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n /**\n * Call to proceed with the default connection initialization\n * (attaches heartbeat, join, leave and disconnect handlers).\n */\n complete: () => void\n }) => void | Promise<void>\n\n 'sys:disconnect': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n /** cleans up all handlers */\n cleanup: () => void\n reason: string\n }) => void | Promise<void>\n\n 'sys:ping': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n ping: SocketSchemaOutput<Config['pingPayload']>\n ctx: HandlerCtxNoAck\n }) =>\n | SocketSchemaOutput<Config['pongPayload']>\n | Promise<SocketSchemaOutput<Config['pongPayload']>>\n\n 'sys:room_join': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n rooms: string[]\n meta: SocketSchemaOutput<Config['joinMetaMessage']>\n join: (room: string) => Promise<void>\n }) => void | Promise<void>\n\n 'sys:room_leave': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n rooms: string[]\n meta: SocketSchemaOutput<Config['leaveMetaMessage']>\n leave: (room: string) => Promise<void>\n }) => void | Promise<void>\n}\n\nconst normalizeError = (error: unknown) => {\n if (error instanceof Error) {\n return { name: error.name, message: error.message }\n }\n if (typeof error === 'string') return { message: error }\n return { message: 'Unknown error' }\n}\n\nconst roomValueSchema = z.union([z.string(), z.array(z.string())])\n\nconst buildRoomPayloadSchema = <Meta extends z.ZodTypeAny>(metaSchema: Meta) =>\n z.object({\n rooms: roomValueSchema,\n meta: metaSchema,\n })\n\ntype DebugFn = (maybeEvent: string | null, e: SocketServerDebugEvent) => void\n\nconst toArray = (rooms?: string[] | string): string[] =>\n rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms]\n\nconst snapshotSocketConfig = (socket: Socket): SocketServerConfigSnapshot => {\n const conn = socket.conn as\n | {\n transport?: { name?: string }\n protocol?: string | number\n remoteAddress?: string\n }\n | undefined\n const protocol = conn?.protocol\n return {\n url: socket.handshake.url,\n transport: conn?.transport?.name,\n protocol: protocol != null ? String(protocol) : undefined,\n address: conn?.remoteAddress ?? socket.handshake.address,\n issued: socket.handshake.issued,\n time: socket.handshake.time,\n query: socket.handshake.query as Record<string, unknown>,\n auth: socket.handshake.auth as Record<string, unknown>,\n headers: socket.handshake.headers,\n }\n}\n\nexport function createBuiltInConnectionHandlers<\n C extends SocketConnectionConfigOutput,\n Events extends EventMap,\n>(opts: {\n heartbeat?: HeartbeatServerOptions\n sys: SysServerEventMap<C, Events>\n dbg: DebugFn\n config: C\n createCtx: (socket: Socket) => HandlerCtxNoAck\n debugVerbose?: boolean\n createHelper: (socket: Socket) => SocketConnectionHelper<Events>\n}) {\n const { heartbeat, sys, dbg, config, createCtx, debugVerbose, createHelper } =\n opts\n\n const roomJoinEvent: SysEventName = 'sys:room_join'\n const roomLeaveEvent: SysEventName = 'sys:room_leave'\n const pingEvent: SysEventName = 'sys:ping'\n const pongEvent: SysEventName = 'sys:pong'\n const heartbeatEnabled = heartbeat?.enabled !== false\n\n const joinPayloadSchema = buildRoomPayloadSchema(config.joinMetaMessage)\n const leavePayloadSchema = buildRoomPayloadSchema(config.leaveMetaMessage)\n const pingPayloadSchema = config.pingPayload as C['pingPayload']\n const pongPayloadSchema = config.pongPayload as C['pongPayload']\n\n const sysEvents = sys\n const getSysEvent = <\n K extends keyof SysServerEventMap<C, Events> & SysEventName,\n >(\n name: K,\n ) => sysEvents[name]\n\n /** Track per-socket teardown for built-in handlers to ensure explicit cleanup on destroy(). */\n const socketTeardowns = new WeakMap<Socket, (reason: string) => void>()\n\n const builtInConnectionListener = (socket: Socket) => {\n const helper = createHelper(socket)\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_init',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: {\n rooms: Array.from(socket.rooms),\n handshakeIssued: socket.handshake.issued,\n },\n })\n dbg(null, {\n type: 'config',\n socketId: socket.id,\n nsp: socket.nsp.name,\n snapshot: snapshotSocketConfig(socket),\n })\n\n const defaultConnect = () => {\n const includeRaw = debugVerbose === true\n\n // built-in room handlers (wrapped with sys:room_join / sys:room_leave)\n const joinHandler = async (msg: unknown) => {\n dbg(roomJoinEvent, {\n type: 'rooms',\n phase: 'receive',\n action: 'join',\n socketId: socket.id,\n payload: msg,\n })\n const parsed = joinPayloadSchema.safeParse(msg)\n\n if (!parsed.success) {\n socket.emit(`${roomJoinEvent}:error`, {\n eventName: roomJoinEvent,\n issues: parsed.error.issues,\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n action: 'join',\n phase: 'validation_error',\n socketId: socket.id,\n issues: parsed.error.issues,\n payload: msg,\n })\n return\n }\n const list = toArray(parsed.data.rooms)\n\n const join = async (room: string) => {\n await socket.join(room)\n dbg(null, {\n type: 'rooms',\n action: 'join',\n rooms: room,\n socketId: socket.id,\n })\n }\n\n const run = async () => {\n await getSysEvent('sys:room_join')({\n socket,\n helper,\n rooms: list,\n meta: parsed.data.meta as SocketSchemaOutput<C['joinMetaMessage']>,\n join,\n })\n }\n\n try {\n await run()\n } catch (error) {\n socket.emit(`${roomJoinEvent}:error`, {\n error: normalizeError(error),\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n action: 'join',\n phase: 'handler_error',\n payload: includeRaw\n ? { rooms: list, meta: parsed.data.meta }\n : undefined,\n socketId: socket.id,\n issues: [error],\n })\n }\n }\n\n const leaveHandler = async (msg: unknown) => {\n dbg(roomLeaveEvent, {\n type: 'rooms',\n phase: 'receive',\n action: 'leave',\n socketId: socket.id,\n payload: msg,\n })\n const parsed = leavePayloadSchema.safeParse(msg)\n if (!parsed.success) {\n socket.emit(`${roomLeaveEvent}:error`, {\n eventName: roomLeaveEvent,\n issues: parsed.error.issues,\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n action: 'leave',\n phase: 'validation_error',\n socketId: socket.id,\n issues: parsed.error.issues,\n payload: msg,\n })\n return\n }\n\n const list = toArray(parsed.data.rooms)\n\n const leave = async (room: string) => {\n await socket.leave(room)\n dbg(null, {\n type: 'rooms',\n action: 'leave',\n rooms: room,\n socketId: socket.id,\n })\n }\n\n const run = async () => {\n await getSysEvent('sys:room_leave')({\n socket,\n helper,\n rooms: list,\n meta: parsed.data.meta as SocketSchemaOutput<C['leaveMetaMessage']>,\n leave,\n })\n }\n\n try {\n await run()\n } catch (error) {\n socket.emit(`${roomLeaveEvent}:error`, {\n error: normalizeError(error),\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n phase: 'handler_error',\n payload: { rooms: list, meta: parsed.data.meta },\n socketId: socket.id,\n issues: [error],\n action: 'join',\n })\n }\n }\n\n // heartbeat, wrapped with sys:ping/sys:pong\n const pingHandler = async (msg: unknown) => {\n if (!heartbeatEnabled) {\n dbg(null, {\n type: 'heartbeat',\n phase: 'skip',\n socketId: socket.id,\n details: { reason: 'heartbeat_disabled' },\n error: false,\n })\n return\n }\n\n const parsedPing = pingPayloadSchema.safeParse(msg)\n if (!parsedPing.success) {\n socket.emit(`${pingEvent}:error`, {\n eventName: pingEvent,\n issues: parsedPing.error.issues,\n })\n dbg(null, {\n type: 'heartbeat',\n phase: 'ping',\n socketId: socket.id,\n payload: includeRaw ? msg : undefined,\n issues: parsedPing.error.issues,\n error: true,\n details: { step: 'parse' },\n })\n return\n }\n const ctx = createCtx(socket)\n\n dbg(null, {\n type: 'heartbeat',\n phase: 'ping',\n socketId: socket.id,\n payload: parsedPing.data,\n error: false,\n })\n\n let pongPayload: SocketSchemaOutput<C['pongPayload']>\n try {\n pongPayload = await getSysEvent('sys:ping')({\n ping: parsedPing.data as SocketSchemaOutput<C['pingPayload']>,\n ctx,\n socket,\n helper,\n })\n } catch (error) {\n socket.emit(`${pingEvent}:error`, { error: normalizeError(error) })\n dbg(null, {\n type: 'heartbeat',\n phase: 'ping',\n socketId: socket.id,\n payload: parsedPing.data,\n error: true,\n details: { step: 'sys_handler_error' },\n })\n return\n }\n\n const parsedPong = pongPayloadSchema.safeParse(pongPayload)\n if (!parsedPong.success) {\n socket.emit(`${pongEvent}:error`, {\n eventName: pongEvent,\n issues: parsedPong.error.issues,\n })\n dbg(null, {\n type: 'heartbeat',\n phase: 'pong',\n socketId: socket.id,\n payload: includeRaw ? pongPayload : undefined,\n issues: parsedPong.error.issues,\n error: true,\n details: { step: 'parse' },\n })\n return\n }\n socket.emit(pongEvent, parsedPong.data)\n dbg(null, {\n type: 'heartbeat',\n phase: 'pong',\n socketId: socket.id,\n payload: parsedPong.data,\n error: false,\n })\n }\n\n // attach built-in handlers\n socket.on(roomJoinEvent, joinHandler)\n socket.on(roomLeaveEvent, leaveHandler)\n if (heartbeatEnabled) {\n socket.on(pingEvent, pingHandler)\n }\n\n const cleanup = (reason: string) => {\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_cleanup',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: { reason },\n })\n socket.off(roomJoinEvent, joinHandler)\n socket.off(roomLeaveEvent, leaveHandler)\n if (heartbeatEnabled) {\n socket.off(pingEvent, pingHandler)\n }\n }\n\n socketTeardowns.set(socket, cleanup)\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_handlers_attached',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: {\n heartbeatEnabled,\n joinEvent: roomJoinEvent,\n leaveEvent: roomLeaveEvent,\n pingEvent: heartbeatEnabled ? pingEvent : undefined,\n },\n })\n\n socket.once('disconnect', (reason) => {\n dbg('sys:disconnect', {\n type: 'lifecycle',\n stage: 'connection_cleanup',\n nsp: socket.nsp.name,\n socketId: socket.id,\n details: { reason },\n })\n const defaultDisconnect = () => {\n cleanup(reason)\n socketTeardowns.delete(socket)\n }\n getSysEvent('sys:disconnect')({\n socket,\n helper,\n reason: String(reason),\n cleanup: defaultDisconnect,\n })\n })\n }\n getSysEvent('sys:connect')({\n socket,\n helper,\n complete: defaultConnect,\n })\n }\n\n return {\n builtInConnectionListener,\n socketTeardowns,\n roomJoinEvent,\n roomLeaveEvent,\n pingEvent,\n }\n}\n","// socket.server.index.ts\nimport { Server, Socket } from 'socket.io'\nimport { z } from 'zod'\nimport type {\n EventMap,\n SocketConnectionConfigOutput,\n Payload,\n} from '@emeryld/rrroutes-contract'\nimport { createDebugger } from './socket.server.debug'\nimport type {\n SocketServerDebugEvent,\n SocketDebugOptions,\n} from './socket.server.debug'\nimport { createBuiltInConnectionHandlers } from './socket.server.sys'\nimport type {\n HeartbeatServerOptions,\n SocketConnectionHelper,\n SysServerEventMap,\n} from './socket.server.sys'\nimport type { HandlerCtx, HandlerCtxNoAck } from './socket.server.types'\n\nconst createBaseHandlerCtx = (socket: Socket): HandlerCtxNoAck => ({\n sentAt: new Date(),\n socket,\n socketId: socket.id,\n nsp: socket.nsp.name,\n rooms: Array.from(socket.rooms),\n user: socket.data?.user,\n scopes: socket.data?.scopes,\n})\n\nconst normalizeError = (error: unknown, verbose?: boolean) => {\n if (error instanceof Error) {\n return {\n name: error.name,\n message: error.message,\n stack: verbose ? error.stack : undefined,\n }\n }\n if (typeof error === 'string') return { message: error }\n if (typeof error === 'object' && error !== null) {\n return verbose ? error : { message: 'Unknown error' }\n }\n return { message: String(error) }\n}\n\nexport interface SocketConnection<T extends EventMap> {\n on<K extends keyof T & string>(\n eventName: K,\n handler: (payload: Payload<T, K>, ctx: HandlerCtx) => void | Promise<void>,\n ): () => void\n\n off<K extends keyof T & string>(eventName: K): void\n\n emit<K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n toRooms?: string[] | string,\n metadata?: Record<string, unknown>,\n onAck?: (ack: unknown) => void,\n ): void\n\n /** Dispose all listeners, timers, and room memberships created by this instance. */\n destroy(): void\n}\n\nexport function createSocketConnections<\n T extends EventMap,\n TConfig extends SocketConnectionConfigOutput = SocketConnectionConfigOutput,\n>(\n io: Server,\n events: T,\n opts: {\n debug?: SocketDebugOptions\n heartbeat?: HeartbeatServerOptions\n /** System event customization (connect / disconnect / ping / pong / room join/leave) */\n sys: SysServerEventMap<TConfig, T>\n config: TConfig\n },\n): SocketConnection<T> {\n const dbg = createDebugger(opts?.debug)\n const socketConfig = opts.config\n const heartbeatEnabled = opts?.heartbeat?.enabled !== false\n const eventNames = Object.keys(events)\n dbg(null, {\n type: 'lifecycle',\n stage: 'server_init',\n details: {\n prefinedEvents: eventNames,\n heartbeatEnabled,\n path: io?.path(),\n namespaces: Array.from(io._nsps.keys()),\n transport: io?._opts.transports,\n sysEvents: Object.keys(opts.sys ?? {}),\n },\n })\n\n const getSchema = <K extends keyof T & string>(k: K) => events[k].message\n const toArray = (rooms?: string[] | string): string[] =>\n rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms]\n const emitToTargets = <K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n targets: string[],\n metadata?: Record<string, unknown>,\n ) => {\n const schema = getSchema(eventName)\n const check = schema.safeParse(payload)\n if (!check.success) {\n dbg(String(eventName), {\n type: 'emit',\n event: String(eventName),\n rooms: targets,\n ...(opts?.debug?.verbose ? { attemptedPayload: payload } : {}),\n error: {\n reason: 'invalid_payload',\n message: check.error.message,\n issues: check.error.issues,\n },\n metadata,\n })\n throw new Error(\n `Invalid payload for \"${String(eventName)}\": ${check.error.message}`,\n )\n }\n\n const envelope = {\n eventName,\n sentAt: new Date(),\n sentTo: targets,\n data: check.data as Payload<T, K>,\n metadata: metadata ?? {},\n }\n\n if (targets.length === 0) io.emit(String(eventName), envelope)\n else if (targets.length === 1) {\n const sid = targets[0]!\n const sock = io.sockets.sockets.get(sid as any)\n if (sock) {\n sock.emit(String(eventName), envelope)\n } else {\n io.to(targets).emit(String(eventName), envelope)\n }\n } else {\n io.to(targets).emit(String(eventName), envelope)\n }\n\n dbg(String(eventName), {\n type: 'emit',\n event: String(eventName),\n rooms: targets,\n envelope: opts?.debug?.verbose ? envelope : undefined,\n })\n }\n const createSocketHelper = (socket: Socket): SocketConnectionHelper<T> => ({\n emit<K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n metadata?: Record<string, unknown>,\n ) {\n emitToTargets(eventName, payload, [socket.id], metadata)\n },\n })\n\n // registrations\n const registrations = new Map<\n string,\n Set<{\n connectionListener: (socket: Socket) => void\n socketListeners: WeakMap<Socket, (raw: unknown) => void>\n }>\n >()\n\n const addRegistration = (\n eventName: string,\n reg: {\n connectionListener: (socket: Socket) => void\n socketListeners: WeakMap<Socket, (raw: unknown) => void>\n },\n ) => {\n let set = registrations.get(eventName)\n if (!set) {\n set = new Set()\n registrations.set(eventName, set)\n }\n set.add(reg)\n }\n\n const removeAllForEvent = (eventName: string) => {\n const set = registrations.get(eventName)\n if (!set) {\n dbg(null, {\n type: 'register',\n event: eventName,\n action: 'unregister',\n msg: 'no handlers registered',\n })\n return\n }\n for (const reg of set) {\n io.off('connection', reg.connectionListener)\n for (const socket of io.sockets.sockets.values()) {\n const wrapped = reg.socketListeners.get(socket)\n if (wrapped) socket.off(String(eventName), wrapped)\n }\n }\n registrations.delete(eventName)\n dbg(eventName, {\n type: 'register',\n action: 'unregister',\n event: eventName,\n msg: 'unregistered',\n })\n }\n\n const {\n builtInConnectionListener,\n socketTeardowns,\n roomJoinEvent,\n roomLeaveEvent,\n pingEvent,\n } = createBuiltInConnectionHandlers<TConfig, T>({\n heartbeat: opts?.heartbeat,\n sys: opts.sys,\n dbg,\n config: socketConfig,\n createCtx: createBaseHandlerCtx,\n debugVerbose: opts?.debug?.verbose === true,\n createHelper: createSocketHelper,\n })\n\n // install built-in connection listener\n io.on('connection', builtInConnectionListener)\n\n const conn = {\n on<K extends keyof T & string>(\n eventName: K,\n handler: (\n payload: Payload<T, K>,\n ctx: HandlerCtx,\n ) => void | Promise<void>,\n ): () => void {\n const socketListeners = new WeakMap<Socket, (raw: unknown) => void>()\n\n const connectionListener = (socket: Socket) => {\n const wrapped = async (raw: unknown) => {\n const schema = getSchema(eventName)\n const parsed = schema.safeParse(raw)\n\n const ctx = createBaseHandlerCtx(socket)\n\n dbg(String(eventName), {\n type: 'handler',\n phase: 'receive',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n rooms: ctx.rooms,\n raw: opts?.debug?.verbose ? raw : undefined,\n })\n\n if (!parsed.success) {\n socket.emit(`${String(eventName)}:error`, {\n eventName,\n sentAt: ctx.sentAt,\n issues: parsed.error.issues,\n })\n dbg(String(eventName), {\n type: 'handler',\n phase: 'validation_error',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n issues: parsed.error.issues,\n })\n return\n }\n\n try {\n await handler(parsed.data as Payload<T, K>, ctx)\n dbg(String(eventName), {\n type: 'handler',\n phase: 'handler_success',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n rooms: ctx.rooms,\n })\n } catch (error) {\n dbg(String(eventName), {\n type: 'handler',\n phase: 'handler_error',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n rooms: ctx.rooms,\n error,\n })\n socket.emit(`${String(eventName)}:error`, {\n eventName,\n sentAt: ctx.sentAt,\n error: normalizeError(error, opts?.debug?.verbose),\n })\n }\n }\n\n socketListeners.set(socket, wrapped)\n socket.on(String(eventName), wrapped)\n socket.once('disconnect', () => {\n const w = socketListeners.get(socket)\n if (w) socket.off(String(eventName), w)\n })\n }\n\n io.on('connection', connectionListener)\n addRegistration(String(eventName), {\n connectionListener,\n socketListeners,\n })\n dbg(String(eventName), {\n type: 'register',\n action: 'register',\n event: String(eventName),\n })\n\n return () => {\n const set = registrations.get(String(eventName))\n if (!set) {\n dbg(null, {\n type: 'register',\n action: 'unregister',\n event: String(eventName),\n msg: `No registration under ${eventName}`,\n })\n return\n }\n for (const reg of Array.from(set)) {\n if (reg.connectionListener === connectionListener) {\n io.off('connection', reg.connectionListener)\n for (const socket of io.sockets.sockets.values()) {\n const wrapped = reg.socketListeners.get(socket)\n if (wrapped) socket.off(String(eventName), wrapped)\n }\n set.delete(reg)\n break\n }\n }\n if (set.size === 0) registrations.delete(String(eventName))\n dbg(String(eventName), {\n type: 'register',\n action: 'unregister',\n event: String(eventName),\n })\n }\n },\n\n off<K extends keyof T & string>(eventName: K): void {\n removeAllForEvent(String(eventName))\n },\n\n emit<K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n rooms?: string[] | string,\n metadata?: Record<string, unknown>,\n ): void {\n const targets = toArray(rooms)\n emitToTargets(eventName, payload, targets, metadata)\n },\n\n destroy(): void {\n dbg(null, {\n type: 'lifecycle',\n stage: 'destroy_start',\n details: {\n socketCount: io.sockets.sockets.size,\n registrationCount: registrations.size,\n },\n })\n // 1) Remove built-in connection listener so no new sockets get handlers\n io.off('connection', builtInConnectionListener)\n\n // 2) Cleanup built-in handlers for all current sockets and leave rooms\n for (const socket of io.sockets.sockets.values()) {\n const cleanup = socketTeardowns.get(socket)\n if (cleanup) {\n cleanup('destroy')\n socketTeardowns.delete(socket)\n } else {\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_cleanup_fallback',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: { reason: 'teardown_missing' },\n })\n // Fallback if socket was attached before map population\n try {\n socket.removeAllListeners(roomJoinEvent)\n socket.removeAllListeners(roomLeaveEvent)\n socket.removeAllListeners(pingEvent)\n } catch {\n // noop\n }\n }\n }\n\n // 3) Remove all user-registered event listeners and their connection hooks\n for (const eventName of Array.from(registrations.keys())) {\n removeAllForEvent(eventName)\n }\n\n // 4) Defensive: clear any residual maps\n registrations.clear()\n dbg(null, {\n type: 'lifecycle',\n stage: 'destroy_complete',\n details: {\n socketCount: io.sockets.sockets.size,\n registrationCount: registrations.size,\n },\n })\n },\n } as const satisfies SocketConnection<T>\n\n return conn\n}\n\nexport type { EventMap, Payload }\nexport type { HandlerCtx } from './socket.server.types'\nexport type {\n SocketServerDebugEvent,\n SocketDebugOptions,\n SocketServerConfigSnapshot,\n SocketServerLifecycleStage,\n SocketServerHeartbeatPhase,\n} from './socket.server.debug'\nexport type {\n HeartbeatServerOptions,\n SocketConnectionHelper,\n SysServerEventMap,\n} from './socket.server.sys'\n","import type { IncomingHttpHeaders } from 'http'\nimport type { Socket } from 'socket.io'\n\nexport type ConnectionMiddlewareStage = 'incoming'\n\nexport type ConnectionMiddlewareContext = {\n socketId?: string\n nsp?: string\n rooms: string[]\n user?: unknown\n scopes?: string[]\n address?: string\n transport?: string\n protocol?: string\n handshake: {\n url?: string\n issued?: number\n time?: string\n query?: Record<string, unknown>\n auth?: Record<string, unknown>\n headers?: IncomingHttpHeaders\n }\n}\n\nexport type ConnectionMiddlewareEvent = {\n type: 'connection'\n stage: ConnectionMiddlewareStage\n timestamp: Date\n context: ConnectionMiddlewareContext\n}\n\nexport type ConnectionLoggingMiddlewareOptions = {\n /**\n * Custom logger invoked with the structured event.\n * Defaults to console.info.\n */\n logger?: (event: ConnectionMiddlewareEvent) => void\n /**\n * Include raw headers from the handshake. Defaults to false to avoid leaking PII.\n */\n includeHeaders?: boolean\n /**\n * List of auth keys that should be redacted (case-insensitive). Defaults to ['authorization'].\n */\n redactAuthKeys?: string[]\n}\n\nconst defaultRedactedValue = '[REDACTED]'\n\nconst defaultLogger = (event: ConnectionMiddlewareEvent) => {\n const {\n stage,\n context: { socketId, nsp, address, transport, handshake },\n } = event\n // eslint-disable-next-line no-console\n console.info('[socket-connection]', {\n stage,\n socketId,\n nsp,\n address,\n transport,\n url: handshake.url,\n query: handshake.query,\n auth: handshake.auth,\n })\n}\n\nconst redactAuth = (\n auth: Record<string, unknown> | undefined,\n redactKeys: Set<string>,\n): Record<string, unknown> | undefined => {\n if (!auth) return undefined\n if (redactKeys.size === 0) return auth\n\n const clone: Record<string, unknown> = {}\n for (const [key, value] of Object.entries(auth)) {\n const normalizedKey = key.toLowerCase()\n clone[key] = redactKeys.has(normalizedKey) ? defaultRedactedValue : value\n }\n return clone\n}\n\nconst buildContext = (\n socket: Socket,\n includeHeaders: boolean,\n redactKeys: Set<string>,\n): ConnectionMiddlewareContext => {\n const conn = socket.conn as\n | {\n remoteAddress?: string\n transport?: { name?: string }\n protocol?: string | number\n }\n | undefined\n\n const handshake = socket.handshake ?? {}\n\n const protocolValue = conn?.protocol\n\n return {\n socketId: socket.id,\n nsp: socket.nsp?.name,\n rooms: Array.from(socket.rooms ?? []),\n user: (socket.data as any)?.user,\n scopes: (socket.data as any)?.scopes,\n address: conn?.remoteAddress ?? (handshake as any).address,\n transport: conn?.transport?.name,\n protocol: protocolValue != null ? String(protocolValue) : undefined,\n handshake: {\n url: handshake.url,\n issued: handshake.issued,\n time: handshake.time,\n query: handshake.query as Record<string, unknown>,\n auth: redactAuth(handshake.auth as Record<string, unknown>, redactKeys),\n headers: includeHeaders\n ? (handshake.headers as IncomingHttpHeaders)\n : undefined,\n },\n }\n}\n\nexport const createConnectionLoggingMiddleware = (\n options: ConnectionLoggingMiddlewareOptions = {},\n) => {\n const logger = options.logger ?? defaultLogger\n const includeHeaders = options.includeHeaders ?? false\n const redactKeys = new Set(\n (options.redactAuthKeys ?? ['authorization', 'token']).map((key) =>\n key.toLowerCase(),\n ),\n )\n\n return (socket: Socket, next: (err?: Error) => void) => {\n const context = buildContext(socket, includeHeaders, redactKeys)\n logger({\n type: 'connection',\n stage: 'incoming',\n timestamp: new Date(),\n context,\n })\n next()\n }\n}\n\nexport type ConnectionLoggingMiddleware = ReturnType<\n typeof createConnectionLoggingMiddleware\n>\n"],"mappings":"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","names":["import_rrroutes_contract","normalizeError","toArray"]}
|
package/dist/index.js
CHANGED
|
@@ -232,11 +232,13 @@ function createRRRoute(router, config) {
|
|
|
232
232
|
let responsePayload;
|
|
233
233
|
let hasResponsePayload = false;
|
|
234
234
|
const downstreamNext = next;
|
|
235
|
-
logger?.info?.(`${methodUpper}@${path} (${requestUrl})`);
|
|
236
235
|
const ctx = res.locals[CTX_SYMBOL];
|
|
237
236
|
const ctxRoutesLogger = ctx?.routesLogger;
|
|
238
237
|
const emitWithCtx = (event, details) => {
|
|
239
238
|
const decorated = decorateDebugEvent(isVerboseDebug, event, details);
|
|
239
|
+
if (!config.debug || !config.debug[decorated.type]) {
|
|
240
|
+
return;
|
|
241
|
+
}
|
|
240
242
|
if (decorated.type === "handler" && ctxRoutesLogger) {
|
|
241
243
|
logHandlerDebugWithRoutesLogger(ctxRoutesLogger, decorated);
|
|
242
244
|
} else {
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts","../src/routesV3.server.ts","../src/sockets/socket.server.debug.ts","../src/sockets/socket.server.sys.ts","../src/sockets/socket.server.index.ts","../src/sockets/socket.server.middleware.ts"],"sourcesContent":["export { keyOf as contractKeyOf } from '@emeryld/rrroutes-contract'\nexport * from './routesV3.server'\nexport * from './sockets/socket.server.index'\nexport * from './sockets/socket.server.middleware'\n","/**\n * routesV3.server.ts\n * -----------------------------------------------------------------------------\n * Bind an Express router/app to a `finalize(...)` registry of AnyLeafs.\n * - Fully typed handlers (params/query/body/output)\n * - Zod parsing + optional output validation\n * - buildCtx runs as a middleware *first*, before all other middlewares\n * - Global, per-route, and cfg-derived middlewares (auth, uploads)\n * - Helper to warn about unimplemented routes\n * - DX helpers to use `ctx` in any middleware with proper types\n */\n\nimport {\n AnyLeafLowProfile,\n FileField,\n HttpMethod,\n InferBody,\n InferOutput,\n InferParams,\n InferQuery,\n keyOf,\n lowProfileParse,\n} from '@emeryld/rrroutes-contract'\nimport type * as express from 'express'\nimport type { RequestHandler, Router } from 'express'\nimport { z } from 'zod'\n\n/** Shape expected from optional logger implementations. */\nexport type LoggerLike = {\n info?: (...args: any[]) => void\n warn?: (...args: any[]) => void\n error?: (...args: any[]) => void\n debug?: (...args: any[]) => void\n verbose?: (...args: any[]) => void\n system?: (...args: any[]) => void\n log?: (...args: any[]) => void\n}\n\ntype RoutesLoggerCarrier = {\n routesLogger?: LoggerLike\n}\n\ntype CtxWithRoutesLogger<Ctx> = Ctx & RoutesLoggerCarrier\n\n// Debug logging --------------------------------------------------------------\nexport type RouteServerDebugMode = 'minimal' | 'complete'\n\ntype RouteServerDebugEventBase = {\n /** Optional logical name assigned via `RouteDef.debug?.debugName` (or `RouteDef.debugName`). */\n name?: string\n}\n\nexport type RouteServerDebugEvent =\n | (RouteServerDebugEventBase & {\n type: 'request'\n stage: 'start' | 'success' | 'error'\n method: Uppercase<HttpMethod>\n path: string\n url: string\n durationMs?: number\n params?: unknown\n query?: unknown\n body?: unknown\n output?: unknown\n error?: unknown\n })\n | (RouteServerDebugEventBase & {\n type: 'register'\n method: Uppercase<HttpMethod>\n path: string\n })\n | (RouteServerDebugEventBase & {\n type: 'buildCtx'\n stage: 'start' | 'success' | 'error'\n method: Uppercase<HttpMethod>\n path: string\n url: string\n durationMs?: number\n error?: unknown\n })\n | (RouteServerDebugEventBase & {\n type: 'handler'\n stage: 'start' | 'success' | 'error'\n method: Uppercase<HttpMethod>\n path: string\n durationMs?: number\n params?: unknown\n query?: unknown\n body?: unknown\n output?: unknown\n error?: unknown\n })\n\nexport type RouteServerDebugLogger = (event: RouteServerDebugEvent) => void\n\n/**\n * Configure server-side debug logging.\n * - Use booleans or `'minimal'/'complete'` for quick toggles.\n * - Pass a custom logger function to redirect structured events.\n * - Provide a map to enable specific event types, opt into verbose payload logging, or restrict logs via `only`.\n */\nexport type RouteServerDebugOptions<Names extends string = string> =\n RouteServerDebugToggleOptions<Names>\n\n/**\n * Fine-grained toggle map for server debug logging.\n * Enable individual event types, opt into verbose payload logging, override the logger, or restrict to named routes.\n * Use `RouteDef.debug?.debugName` (or the deprecated `RouteDef.debugName`) to set the name that `only` will match against.\n */\nexport type RouteServerDebugToggleOptions<Names extends string = string> =\n Partial<Record<RouteServerDebugEvent['type'], boolean>> & {\n verbose?: boolean\n logger?: RouteServerDebugLogger\n only?: Names[]\n }\n\n/**\n * Per-route debug overrides. Same toggles as `RouteServerDebugOptions`, but limited to a single route\n * and therefore replaces the `only` filter with a local `debugName`.\n */\nexport type RouteDefDebugOptions<Names extends string = string> = Omit<\n RouteServerDebugToggleOptions<Names>,\n 'only'\n> & {\n debugName?: Names\n}\n\nconst serverDebugEventTypes: RouteServerDebugEvent['type'][] = [\n 'register',\n 'request',\n 'buildCtx',\n 'handler',\n]\n\ntype ServerDebugEmitter<Names extends string> = {\n emit: (event: RouteServerDebugEvent, name?: Names) => void\n mode: RouteServerDebugMode\n}\n\nconst noopServerEmit = () => {}\n\nfunction createServerDebugEmitter<Names extends string>(\n option?: RouteServerDebugOptions<Names>,\n): ServerDebugEmitter<Names> {\n const disabled: ServerDebugEmitter<Names> = {\n emit: noopServerEmit,\n mode: 'minimal',\n }\n if (!option) return disabled\n\n if (typeof option === 'object') {\n const toggles = option as RouteServerDebugToggleOptions<Names>\n const verbose = Boolean(toggles.verbose)\n const enabledTypes = serverDebugEventTypes.filter((type) => toggles[type])\n if (enabledTypes.length === 0) {\n return { emit: noopServerEmit, mode: verbose ? 'complete' : 'minimal' }\n }\n const whitelist = new Set<RouteServerDebugEvent['type']>(enabledTypes)\n const onlySet =\n toggles.only && toggles.only.length > 0\n ? new Set<Names>(toggles.only)\n : undefined\n const logger = toggles.logger\n const emit: ServerDebugEmitter<Names>['emit'] = (event, name) => {\n if (!whitelist.has(event.type) || !logger) return\n if (onlySet && (!name || !onlySet.has(name))) return\n logger(name ? { ...event, name } : event)\n }\n return { emit, mode: verbose ? 'complete' : 'minimal' }\n }\n\n return disabled\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Keys + leaf helpers (derive keys from byKey to avoid template-literal pitfalls)\n// ──────────────────────────────────────────────────────────────────────────────\n\n/** Keys like \"GET /v1/foo\" that *actually* exist in the registry */\nexport type KeysOfRegistry<\n R extends { byKey: Record<string, AnyLeafLowProfile> },\n> = keyof R['byKey'] & string\n\ntype MethodFromKey<K extends string> = K extends `${infer M} ${string}`\n ? Lowercase<M>\n : never\ntype PathFromKey<K extends string> = K extends `${string} ${infer P}`\n ? P\n : never\n\n/** Given a registry and a key, pick the exact leaf for that method+path */\nexport type LeafFromKey<\n R extends { all: readonly AnyLeafLowProfile[] },\n K extends string,\n> = Extract<\n R['all'][number],\n { method: MethodFromKey<K> & HttpMethod; path: PathFromKey<K> }\n>\n\n/** Optional-ify types if your core returns `never` when a schema isn't defined */\ntype Maybe<T> = [T] extends [never] ? void : T\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst decodeJsonLikeQueryValue = (value: unknown): unknown => {\n if (Array.isArray(value)) {\n return value.map((entry) => decodeJsonLikeQueryValue(entry))\n }\n if (isPlainObject(value)) {\n const next: Record<string, unknown> = {}\n for (const [key, child] of Object.entries(value)) {\n next[key] = decodeJsonLikeQueryValue(child)\n }\n return next\n }\n if (typeof value === 'string') {\n const trimmed = value.trim()\n if (\n (trimmed.startsWith('{') && trimmed.endsWith('}')) ||\n (trimmed.startsWith('[') && trimmed.endsWith(']'))\n ) {\n try {\n return JSON.parse(trimmed)\n } catch {\n return value\n }\n }\n }\n return value\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Context typing & DX helpers (so ctx is usable in *any* middleware)\n// ──────────────────────────────────────────────────────────────────────────────\n\n/**\n * Unique symbol used to stash ctx on res.locals.\n * (Symbols are safer than string keys against collisions.)\n */\nexport const CTX_SYMBOL: unique symbol = Symbol.for('typedLeaves.ctx')\n\n/** Response type that *has* a ctx on locals for DX in middlewares */\nexport type ResponseWithCtx<Ctx> =\n // Replace locals with an intersection that guarantees CTX_SYMBOL exists\n Omit<express.Response, 'locals'> & {\n locals: express.Response['locals'] & {\n [CTX_SYMBOL]: CtxWithRoutesLogger<Ctx>\n }\n }\n\n/** A middleware signature that can *use* ctx via `res.locals[CTX_SYMBOL]` */\nexport type CtxRequestHandler<Ctx> = (args: {\n req: express.Request\n res: express.Response\n next: express.NextFunction\n ctx: CtxWithRoutesLogger<Ctx>\n}) => any\n\n/**\n * Safely read ctx from any Response.\n * @param res Express response whose locals contain the ctx symbol.\n * @returns Strongly typed context object.\n */\nexport function getCtx<Ctx = unknown>(\n res: express.Response,\n): CtxWithRoutesLogger<Ctx> {\n return (res.locals as any)[CTX_SYMBOL] as CtxWithRoutesLogger<Ctx>\n}\n\n/**\n * Wrap a ctx-typed middleware to a plain RequestHandler (for arrays, etc.).\n * @param mw Middleware that expects a typed response with ctx available.\n * @returns Standard Express request handler.\n */\nfunction adaptCtxMw<Ctx>(mw: CtxRequestHandler<Ctx>): RequestHandler {\n return (req, res, next) => {\n try {\n const result = mw({ req, res, next, ctx: getCtx<Ctx>(res) })\n if (result && typeof (result as Promise<unknown>).then === 'function') {\n return (result as Promise<unknown>).catch((err) => next(err))\n }\n return result as any\n } catch (err) {\n next(err as any)\n return undefined\n }\n }\n}\n\nfunction logHandlerDebugWithRoutesLogger(\n logger: LoggerLike | undefined,\n event: RouteServerDebugEvent,\n) {\n if (!logger || event.type !== 'handler') return\n const payload: [string, RouteServerDebugEvent] = [\n `[rrroutes-server][handler:${event.stage}] ${event.method} ${event.path}`,\n event,\n ]\n if (event.stage === 'error') {\n ;(\n logger.error ??\n logger.warn ??\n logger.debug ??\n logger.info ??\n logger.log ??\n logger.system\n )?.call(logger, ...payload)\n return\n }\n ;(\n logger.debug ??\n logger.verbose ??\n logger.info ??\n logger.log ??\n logger.system\n )?.call(logger, ...payload)\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Controller types — object form only (simpler, clearer typings)\n// ──────────────────────────────────────────────────────────────────────────────\n\n/** Typed route handler for a specific leaf */\n\nexport type Handler<L extends AnyLeafLowProfile, Ctx = unknown> = (args: {\n req: express.Request\n res: express.Response\n next: express.NextFunction\n ctx: CtxWithRoutesLogger<Ctx>\n params: Maybe<InferParams<L>>\n query: Maybe<InferQuery<L>>\n body: Maybe<InferBody<L>>\n}) => Promise<Maybe<InferOutput<L>>> | Maybe<InferOutput<L>>\n\n/** Route definition for one key */\nexport type RouteDef<\n L extends AnyLeafLowProfile,\n Ctx = unknown,\n Names extends string = string,\n> = {\n /** Middlewares before the handler (run after buildCtx/global/derived) */\n before?: Array<CtxRequestHandler<Ctx>>\n /** Your business logic */\n handler: Handler<L, Ctx>\n /**\n * Optional per-route debug overrides. When provided, these replace the global debug options.\n */\n debug?: RouteDefDebugOptions<Names>\n}\n\n/** Map of registry keys -> route defs */\nexport type ControllerMap<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n> = {\n [P in KeysOfRegistry<R>]: RouteDef<LeafFromKey<R, P>, Ctx, Names>\n}\n\nexport type PartialControllerMap<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n> = Partial<ControllerMap<R, Ctx, Names>>\n\n// ──────────────────────────────────────────────────────────────────────────────\n/** Options + derivation helpers */\n// ──────────────────────────────────────────────────────────────────────────────\n\nexport type RouteServerConfig<Ctx = unknown, Names extends string = string> = {\n /**\n * Build a request-scoped context. We wrap this in a middleware that runs\n * *first* (before global/derived/route middlewares), and stash it on\n * `res.locals[CTX_SYMBOL]` so *all* later middlewares can use it.\n * You can optionally include `routesLogger` to override handler debug logging per request.\n */\n buildCtx: (\n req: express.Request,\n res: express.Response,\n ) => CtxWithRoutesLogger<Ctx> | Promise<CtxWithRoutesLogger<Ctx>>\n\n /** Grouped global middlewares that run before the handler for every route. */\n globalMiddleware?: Array<CtxRequestHandler<Ctx>>\n\n /**\n * Derive middleware from MethodCfg.\n * - `upload` runs when cfg.bodyFiles has entries\n */\n fromCfg?: {\n upload?: (files: FileField[] | undefined) => RequestHandler[]\n }\n\n /** Validate handler return values with outputSchema (default: true) */\n validateOutput?: boolean\n\n /** Custom responder (default: res.json(data)) */\n send?: (res: express.Response, data: unknown) => void\n\n /** Optional logger hooks */\n logger?: LoggerLike\n\n /**\n * Optional debug logging for the request lifecycle.\n * Supports booleans/modes/loggers, or a toggle map with per-event enabling, verbose payload logging,\n * and `only` filters tied to `RouteDef.debug?.debugName` (or the deprecated `RouteDef.debugName`).\n */\n debug?: RouteServerDebugOptions<Names>\n}\n\n/** Default JSON responder (typed to avoid implicit-any diagnostics) */\nconst defaultSend: (res: express.Response, data: unknown) => void = (\n res,\n data,\n) => {\n res.json(data as any)\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Core builder\n// ──────────────────────────────────────────────────────────────────────────────\n\nconst REGISTERED_ROUTES_SYMBOL = Symbol.for('routesV3.registeredRoutes')\n\ntype RegisteredRouteStore = Set<string>\n\n/**\n * Retrieve or initialize the shared store of registered route keys.\n * @param router Express router/application that carries previously registered keys.\n * @returns Set of string keys describing registered routes.\n */\nfunction getRegisteredRouteStore(router: Router): RegisteredRouteStore {\n const existing = (router as any)[REGISTERED_ROUTES_SYMBOL] as\n | RegisteredRouteStore\n | undefined\n if (existing) return existing\n const store: RegisteredRouteStore = new Set()\n ;(router as any)[REGISTERED_ROUTES_SYMBOL] = store\n return store\n}\n\n/**\n * Inspect the Express layer stack to discover already-registered routes.\n * @param appOrRouter Express application or router to inspect.\n * @returns All keys in the form `\"METHOD /path\"` found on the stack.\n */\nfunction collectRoutesFromStack(appOrRouter: Router): string[] {\n const result: string[] = []\n const stack: any[] =\n (appOrRouter as any).stack ??\n ((appOrRouter as any)._router\n ? (appOrRouter as any)._router.stack\n : undefined) ??\n []\n\n if (!Array.isArray(stack)) return result\n\n for (const layer of stack) {\n const route = layer && layer.route\n if (!route) continue\n\n const paths = Array.isArray(route.path) ? route.path : [route.path]\n const methodEntries = Object.entries(route.methods ?? {}).filter(\n ([, enabled]) => enabled,\n )\n\n for (const path of paths) {\n for (const [method] of methodEntries) {\n result.push(`${method.toUpperCase()} ${path}`)\n }\n }\n }\n\n return result\n}\n\n/** Runtime helpers returned by `createRRRoute`. */\nexport type RouteServer<Ctx = unknown, Names extends string = string> = {\n router: Router\n register<L extends AnyLeafLowProfile>(\n leaf: L,\n def: RouteDef<L, Ctx, Names>,\n ): void\n registerControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n F extends boolean = false,\n >(\n registry: R,\n controllers: F extends false\n ? PartialControllerMap<R, Ctx, Names>\n : ControllerMap<R, Ctx, Names>,\n all?: F,\n ): void\n warnMissingControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n >(\n registry: R,\n logger: { warn: (...args: any[]) => void },\n ): void\n getRegisteredKeys(): string[]\n}\n\n/**\n * Create an Express binding helper that keeps routes and controllers in sync.\n * @param router Express router or app to register handlers on.\n * @param config Optional configuration controlling ctx building, auth, uploads, etc.\n * @param middleware The order of the middlewares is: buildCtx -> global -> fromCfg -> route -> handler. Remember to call `ctx.next()` in your middlewares to continue the chain.\n * @returns Object with helpers to register controllers and inspect registered keys.\n */\nexport function createRRRoute<Ctx = unknown, Names extends string = string>(\n router: Router,\n config: RouteServerConfig<Ctx, Names>,\n): RouteServer<Ctx, Names> {\n const validateOutput = config.validateOutput ?? true\n const send = config.send ?? defaultSend\n const logger = config.logger\n const { emit: defaultEmitDebug, mode: defaultDebugMode } =\n createServerDebugEmitter<Names>(config.debug)\n\n const knownLeaves = new Map<string, AnyLeafLowProfile>()\n\n const decorateDebugEvent = <T extends RouteServerDebugEvent>(\n isVerbose: boolean,\n event: T,\n details?: Partial<RouteServerDebugEvent>,\n ): RouteServerDebugEvent => {\n if (!isVerbose || !details) return event\n return { ...event, ...details } as RouteServerDebugEvent\n }\n\n const globalBeforeMws = [...(config.globalMiddleware ?? [])].map((mw) =>\n adaptCtxMw<Ctx>(mw),\n )\n const registered = getRegisteredRouteStore(router)\n\n const buildDerived = (leaf: AnyLeafLowProfile): RequestHandler[] => {\n const derived: RequestHandler[] = []\n if (\n config.fromCfg?.upload &&\n Array.isArray(leaf.cfg.bodyFiles) &&\n leaf.cfg.bodyFiles.length > 0\n ) {\n derived.push(...config.fromCfg.upload(leaf.cfg.bodyFiles))\n }\n\n return derived\n }\n\n /** Register a single leaf/controller pair on the underlying router. */\n function register<L extends AnyLeafLowProfile>(\n leaf: L,\n def: RouteDef<L, Ctx, Names>,\n ) {\n const method = leaf.method as HttpMethod\n const methodUpper = method.toUpperCase() as Uppercase<HttpMethod>\n const path = leaf.path as string\n const key = keyOf(leaf.method, leaf.path, false)\n const defDebug = def.debug\n let debugName = undefined as Names | undefined\n let routeDebugEmitter: ServerDebugEmitter<Names> | undefined\n if (defDebug) {\n const { debugName: overrideName, ...rest } = defDebug\n const hasOverrides = Object.values(rest).some(\n (value) => value !== undefined,\n )\n if (hasOverrides) {\n routeDebugEmitter = createServerDebugEmitter<Names>({\n ...config.debug,\n ...rest,\n })\n }\n debugName = (overrideName ?? debugName) as Names | undefined\n }\n const activeEmit = routeDebugEmitter?.emit ?? defaultEmitDebug\n const activeDebugMode = routeDebugEmitter?.mode ?? defaultDebugMode\n const emit = (event: RouteServerDebugEvent) => activeEmit(event, debugName)\n const isVerboseDebug = activeDebugMode === 'complete'\n emit({ type: 'register', method: methodUpper, path })\n\n const routeSpecific = (def?.before ?? []).map((mw) => adaptCtxMw<Ctx>(mw))\n const derived = buildDerived(leaf)\n const ctxMw: RequestHandler = async (req, res, next) => {\n const requestUrl = req.originalUrl ?? path\n const startedAt = Date.now()\n emit({\n type: 'buildCtx',\n stage: 'start',\n method: methodUpper,\n path,\n url: requestUrl,\n })\n try {\n const ctx = await config.buildCtx(req, res)\n ;(res.locals as any)[CTX_SYMBOL] = ctx\n emit({\n type: 'buildCtx',\n stage: 'success',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n })\n next()\n } catch (err) {\n emit({\n type: 'buildCtx',\n stage: 'error',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n error: err,\n })\n logger?.error?.('buildCtx error', err)\n next(err as any)\n }\n }\n const before: RequestHandler[] = [\n ctxMw,\n ...globalBeforeMws,\n ...derived,\n ...routeSpecific,\n ]\n\n const wrapped: RequestHandler = async (req, res, next) => {\n const requestUrl = req.originalUrl.split('?')[0] ?? path\n const startedAt = Date.now()\n emit({\n type: 'request',\n stage: 'start',\n method: methodUpper,\n path,\n url: requestUrl,\n })\n let params: InferParams<L> | undefined\n let query: InferQuery<L> | undefined\n let body: InferBody<L> | undefined\n let responsePayload: InferOutput<L> | undefined\n let hasResponsePayload = false\n const downstreamNext: express.NextFunction = next\n\n logger?.info?.(`${methodUpper}@${path} (${requestUrl})`)\n const ctx = (res.locals as any)[CTX_SYMBOL] as CtxWithRoutesLogger<Ctx>\n const ctxRoutesLogger = ctx?.routesLogger\n const emitWithCtx = (\n event: RouteServerDebugEvent,\n details?: Partial<RouteServerDebugEvent>,\n ) => {\n const decorated = decorateDebugEvent(isVerboseDebug, event, details)\n if (decorated.type === 'handler' && ctxRoutesLogger) {\n logHandlerDebugWithRoutesLogger(ctxRoutesLogger, decorated)\n } else {\n emit(decorated)\n }\n }\n try {\n params = (\n leaf.cfg.paramsSchema\n ? lowProfileParse(leaf.cfg.paramsSchema, req.params)\n : Object.keys(req.params || {}).length\n ? (req.params as any)\n : undefined\n ) as InferParams<L>\n\n try {\n const parsedQueryInput =\n leaf.cfg.querySchema && req.query\n ? (decodeJsonLikeQueryValue(req.query) as Record<\n string,\n unknown\n >)\n : req.query\n query = leaf.cfg.querySchema\n ? lowProfileParse(leaf.cfg.querySchema, parsedQueryInput)\n : Object.keys(req.query || {}).length\n ? (req.query as any)\n : undefined\n } catch (e) {\n logger?.error?.('Query parsing error', {\n path,\n method: methodUpper,\n error: e,\n raw: JSON.stringify(req.query),\n })\n throw e\n }\n\n body = (\n leaf.cfg.bodySchema\n ? lowProfileParse(leaf.cfg.bodySchema, req.body)\n : req.body !== undefined\n ? (req.body as any)\n : undefined\n ) as InferBody<L>\n\n logger?.verbose?.(`${methodUpper}@${path} (${requestUrl})`, {\n params,\n query,\n body,\n })\n\n const handlerStartedAt = Date.now()\n emitWithCtx(\n {\n type: 'handler',\n stage: 'start',\n method: methodUpper,\n path,\n },\n isVerboseDebug ? { params, query, body } : undefined,\n )\n\n let result\n try {\n result = await def.handler({\n req,\n res,\n next: downstreamNext,\n ctx,\n params: params as Maybe<InferParams<L>>,\n query: query as Maybe<InferQuery<L>>,\n body: body as Maybe<InferBody<L>>,\n })\n emitWithCtx(\n {\n type: 'handler',\n stage: 'success',\n method: methodUpper,\n path,\n durationMs: Date.now() - handlerStartedAt,\n },\n isVerboseDebug\n ? {\n params,\n query,\n body,\n ...(result !== undefined ? { output: result } : {}),\n }\n : undefined,\n )\n } catch (e) {\n emitWithCtx(\n {\n type: 'handler',\n stage: 'error',\n method: methodUpper,\n path,\n durationMs: Date.now() - handlerStartedAt,\n error: e,\n },\n isVerboseDebug ? { params, query, body } : undefined,\n )\n logger?.error?.('Handler error', e)\n throw e\n }\n\n const out =\n validateOutput && leaf.cfg.outputSchema\n ? lowProfileParse(leaf.cfg.outputSchema, result)\n : result\n responsePayload = out as InferOutput<L>\n hasResponsePayload = true\n logger?.verbose?.(`${methodUpper}@${path} result`, out)\n send(res, out)\n\n emitWithCtx(\n {\n type: 'request',\n stage: 'success',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n },\n isVerboseDebug\n ? {\n params,\n query,\n body,\n ...(hasResponsePayload ? { output: responsePayload } : {}),\n }\n : undefined,\n )\n } catch (err) {\n emitWithCtx(\n {\n type: 'request',\n stage: 'error',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n error: err,\n },\n isVerboseDebug ? { params, query, body } : undefined,\n )\n logger?.error?.('Route error', err)\n next(err as any)\n }\n }\n\n ;(router as any)[method](path, ...before, wrapped)\n registered.add(key)\n }\n\n /**\n * Register controller definitions for the provided keys.\n * @param registry Finalized registry of leaves.\n * @param controllers Partial controller map keyed by `\"METHOD /path\"`.\n * @param all Deprecated runtime toggle. Passing any truthy value will throw.\n */\n function registerControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n F extends boolean = false,\n >(registry: R, controllers: PartialControllerMap<R, Ctx, Names>, all?: F) {\n if (all !== undefined && all !== false) {\n const label =\n typeof all === 'string'\n ? all\n : all === true\n ? 'true'\n : String(all)\n throw new Error(\n `registerControllers: \"${label}\" is not allowed at runtime. Use bindAll(...) for compile-time coverage or warnMissingControllers(...) to surface missing routes.`,\n )\n }\n\n for (const leaf of registry.all) {\n const key = keyOf(leaf.method, leaf.path, false)\n knownLeaves.set(key, leaf)\n }\n\n ;(Object.keys(controllers) as Array<KeysOfRegistry<R>>).forEach((key) => {\n const leaf = registry.byKey[key] as unknown as\n | LeafFromKey<R, typeof key>\n | undefined\n if (!leaf) {\n logger?.warn?.(\n `No leaf found for controller key: ${key}. Not registering route.`,\n )\n return\n }\n const def = controllers[key]\n if (!def) return\n register(leaf as LeafFromKey<R, typeof key>, def)\n })\n }\n\n /**\n * Warn about leaves that do not have a registered controller.\n * @param registry Finalized registry of leaves.\n * @param warnLogger Logger used for warning output.\n */\n function warnMissing<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n >(registry: R, warnLogger: { warn: (...args: any[]) => void }) {\n const registeredFromStore = new Set<string>(Array.from(registered))\n if (registeredFromStore.size === 0) {\n collectRoutesFromStack(router).forEach((key) =>\n registeredFromStore.add(key),\n )\n }\n for (const leaf of registry.all) {\n const key = keyOf(leaf.method, leaf.path, false)\n if (!registeredFromStore.has(key)) {\n warnLogger.warn(`No controller registered for route: ${key}`)\n }\n }\n }\n\n return {\n router,\n register,\n registerControllers,\n warnMissingControllers: warnMissing,\n getRegisteredKeys: () => Array.from(registered),\n }\n}\n\n/**\n * Bind only the controllers that are present in the provided map.\n * @param router Express router or app.\n * @param registry Finalized registry produced by `finalize(...)`.\n * @param controllers Partial map of controllers keyed by `\"METHOD /path\"`.\n * @param config Optional route server configuration.\n * @returns The same router instance for chaining.\n */\nexport function bindExpressRoutes<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n>(\n router: Router,\n registry: R,\n controllers: PartialControllerMap<R, Ctx, Names>,\n config: RouteServerConfig<Ctx, Names>,\n) {\n const server = createRRRoute<Ctx, Names>(router, config)\n server.registerControllers(registry, controllers)\n return router\n}\n\n/**\n * Bind controllers for every leaf. Missing entries fail at compile time.\n * @param router Express router or app.\n * @param registry Finalized registry produced by `finalize(...)`.\n * @param controllers Complete map of controllers keyed by `\"METHOD /path\"`.\n * @param config Optional route server configuration.\n * @returns The same router instance for chaining.\n */\nexport function bindAll<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n>(\n router: Router,\n registry: R,\n controllers: {\n [K in KeysOfRegistry<R>]: RouteDef<LeafFromKey<R, K>, Ctx, Names>\n },\n config: RouteServerConfig<Ctx, Names>,\n) {\n const server = createRRRoute<Ctx, Names>(router, config)\n server.registerControllers(registry, controllers)\n return router\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// DX helpers\n// ──────────────────────────────────────────────────────────────────────────────\n\n/**\n * Helper for great IntelliSense when authoring controller maps.\n * @returns Function that enforces key names while preserving partial flexibility.\n */\nexport const defineControllers =\n <\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n >() =>\n <M extends PartialControllerMap<R, Ctx, Names>>(m: M) =>\n m\n\n/**\n * Warn about leaves that don't have controllers.\n * Call this during startup to surface missing routes.\n * @param router Express router or app to inspect.\n * @param registry Finalized registry produced by `finalize(...)`.\n * @param logger Logger where warnings are emitted.\n */\nexport function warnMissingControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n>(router: Router, registry: R, logger: { warn: (...args: any[]) => void }) {\n const registeredStore = (router as any)[REGISTERED_ROUTES_SYMBOL] as\n | Set<string>\n | undefined\n const initial = registeredStore\n ? Array.from(registeredStore)\n : collectRoutesFromStack(router)\n const registeredKeys = new Set<string>(initial)\n\n for (const leaf of registry.all) {\n const k = keyOf(leaf.method, leaf.path, false)\n if (!registeredKeys.has(k)) {\n logger.warn(`No controller registered for route: ${k}`)\n }\n }\n}\n","// socket.server.debug.ts\nimport type { IncomingHttpHeaders } from 'http'\n\nexport type SocketServerConfigSnapshot = {\n url?: string\n transport?: string\n protocol?: string\n address?: string\n issued?: number\n time?: string\n query?: Record<string, unknown>\n auth?: Record<string, unknown>\n headers?: IncomingHttpHeaders\n}\n\nexport type SocketServerLifecycleStage =\n | 'server_init'\n | 'connection_listener_installed'\n | 'connection_init'\n | 'connection_handlers_attached'\n | 'connection_cleanup'\n | 'destroy_start'\n | 'destroy_complete'\n | 'connection_cleanup_fallback'\n\nexport type SocketServerHeartbeatPhase = 'ping' | 'pong' | 'skip'\n\nexport type SocketServerDebugEvent =\n | {\n type: 'register'\n action: 'register' | 'unregister'\n event: string\n msg?: string\n }\n | {\n type: 'handler'\n phase:\n | 'receive'\n | 'validation_error'\n | 'handler_success'\n | 'handler_error'\n event: string\n socketId?: string\n nsp?: string\n rooms?: string[]\n raw?: unknown\n issues?: any[]\n error?: unknown\n details?: Record<string, unknown>\n }\n | {\n type: 'emit'\n event: string\n rooms: string[]\n envelope?: unknown\n error?: {\n reason: string\n message?: string\n issues?: unknown\n }\n metadata?: unknown\n }\n | {\n type: 'rooms'\n action: 'join' | 'leave'\n rooms?: string | string[]\n socketId: string\n phase?: string\n payload?: unknown\n issues?: any[]\n }\n | {\n type: 'heartbeat'\n phase: SocketServerHeartbeatPhase\n socketId: string\n payload?: unknown\n issues?: any[]\n error?: boolean\n details?: Record<string, unknown>\n }\n | {\n type: 'config'\n socketId: string\n nsp: string\n snapshot: SocketServerConfigSnapshot\n }\n | {\n type: 'lifecycle'\n stage: SocketServerLifecycleStage\n socketId?: string\n nsp?: string\n details?: Record<string, unknown>\n }\n\nexport type SocketDebugOptions = {\n verbose?: boolean\n /** filters event-based logs (register/handler/emit) by event name */\n only?: string[]\n logger?: (e: SocketServerDebugEvent) => void\n} & {\n [P in SocketServerDebugEvent['type']]?: boolean\n}\n\nexport function createDebugger(options?: SocketDebugOptions) {\n const debug = options ?? {}\n\n return (maybeEvent: string | null, e: SocketServerDebugEvent) => {\n if (!debug.logger) return\n if (!debug[e.type]) return\n\n // only filter applies to event-shaped logs\n if (\n debug.only &&\n maybeEvent &&\n (e.type === 'register' || e.type === 'handler' || e.type === 'emit') &&\n !debug.only.includes(maybeEvent)\n ) {\n return\n }\n\n debug.logger(e)\n }\n}\n","// socket.server.sys.ts\nimport type { Socket } from 'socket.io'\nimport { z } from 'zod'\nimport type {\n EventMap,\n Payload,\n SocketConnectionConfigOutput,\n SocketSchemaOutput,\n SysEventName,\n} from '@emeryld/rrroutes-contract'\nimport type {\n SocketServerConfigSnapshot,\n SocketServerDebugEvent,\n} from './socket.server.debug'\nimport type { HandlerCtxNoAck } from './socket.server.types'\n\nexport type SocketConnectionHelper<Events extends EventMap> = {\n emit<K extends keyof Events & string>(\n event: K,\n payload: Payload<Events, K>,\n metadata?: Record<string, unknown>,\n onAck?: (ack: unknown) => void,\n ): void\n}\n\n/** Heartbeat configuration that is not tied to payload shapes (which live in sys event schemas). */\nexport type HeartbeatServerOptions = {\n /** Enable/disable built-in heartbeat handling. Defaults to true. */\n enabled?: boolean\n}\n\nexport type SysServerEventMap<\n Config extends SocketConnectionConfigOutput = SocketConnectionConfigOutput,\n Events extends EventMap = EventMap,\n> = {\n 'sys:connect': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n /**\n * Call to proceed with the default connection initialization\n * (attaches heartbeat, join, leave and disconnect handlers).\n */\n complete: () => void\n }) => void | Promise<void>\n\n 'sys:disconnect': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n /** cleans up all handlers */\n cleanup: () => void\n reason: string\n }) => void | Promise<void>\n\n 'sys:ping': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n ping: SocketSchemaOutput<Config['pingPayload']>\n ctx: HandlerCtxNoAck\n }) =>\n | SocketSchemaOutput<Config['pongPayload']>\n | Promise<SocketSchemaOutput<Config['pongPayload']>>\n\n 'sys:room_join': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n rooms: string[]\n meta: SocketSchemaOutput<Config['joinMetaMessage']>\n join: (room: string) => Promise<void>\n }) => void | Promise<void>\n\n 'sys:room_leave': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n rooms: string[]\n meta: SocketSchemaOutput<Config['leaveMetaMessage']>\n leave: (room: string) => Promise<void>\n }) => void | Promise<void>\n}\n\nconst normalizeError = (error: unknown) => {\n if (error instanceof Error) {\n return { name: error.name, message: error.message }\n }\n if (typeof error === 'string') return { message: error }\n return { message: 'Unknown error' }\n}\n\nconst roomValueSchema = z.union([z.string(), z.array(z.string())])\n\nconst buildRoomPayloadSchema = <Meta extends z.ZodTypeAny>(metaSchema: Meta) =>\n z.object({\n rooms: roomValueSchema,\n meta: metaSchema,\n })\n\ntype DebugFn = (maybeEvent: string | null, e: SocketServerDebugEvent) => void\n\nconst toArray = (rooms?: string[] | string): string[] =>\n rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms]\n\nconst snapshotSocketConfig = (socket: Socket): SocketServerConfigSnapshot => {\n const conn = socket.conn as\n | {\n transport?: { name?: string }\n protocol?: string | number\n remoteAddress?: string\n }\n | undefined\n const protocol = conn?.protocol\n return {\n url: socket.handshake.url,\n transport: conn?.transport?.name,\n protocol: protocol != null ? String(protocol) : undefined,\n address: conn?.remoteAddress ?? socket.handshake.address,\n issued: socket.handshake.issued,\n time: socket.handshake.time,\n query: socket.handshake.query as Record<string, unknown>,\n auth: socket.handshake.auth as Record<string, unknown>,\n headers: socket.handshake.headers,\n }\n}\n\nexport function createBuiltInConnectionHandlers<\n C extends SocketConnectionConfigOutput,\n Events extends EventMap,\n>(opts: {\n heartbeat?: HeartbeatServerOptions\n sys: SysServerEventMap<C, Events>\n dbg: DebugFn\n config: C\n createCtx: (socket: Socket) => HandlerCtxNoAck\n debugVerbose?: boolean\n createHelper: (socket: Socket) => SocketConnectionHelper<Events>\n}) {\n const { heartbeat, sys, dbg, config, createCtx, debugVerbose, createHelper } =\n opts\n\n const roomJoinEvent: SysEventName = 'sys:room_join'\n const roomLeaveEvent: SysEventName = 'sys:room_leave'\n const pingEvent: SysEventName = 'sys:ping'\n const pongEvent: SysEventName = 'sys:pong'\n const heartbeatEnabled = heartbeat?.enabled !== false\n\n const joinPayloadSchema = buildRoomPayloadSchema(config.joinMetaMessage)\n const leavePayloadSchema = buildRoomPayloadSchema(config.leaveMetaMessage)\n const pingPayloadSchema = config.pingPayload as C['pingPayload']\n const pongPayloadSchema = config.pongPayload as C['pongPayload']\n\n const sysEvents = sys\n const getSysEvent = <\n K extends keyof SysServerEventMap<C, Events> & SysEventName,\n >(\n name: K,\n ) => sysEvents[name]\n\n /** Track per-socket teardown for built-in handlers to ensure explicit cleanup on destroy(). */\n const socketTeardowns = new WeakMap<Socket, (reason: string) => void>()\n\n const builtInConnectionListener = (socket: Socket) => {\n const helper = createHelper(socket)\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_init',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: {\n rooms: Array.from(socket.rooms),\n handshakeIssued: socket.handshake.issued,\n },\n })\n dbg(null, {\n type: 'config',\n socketId: socket.id,\n nsp: socket.nsp.name,\n snapshot: snapshotSocketConfig(socket),\n })\n\n const defaultConnect = () => {\n const includeRaw = debugVerbose === true\n\n // built-in room handlers (wrapped with sys:room_join / sys:room_leave)\n const joinHandler = async (msg: unknown) => {\n dbg(roomJoinEvent, {\n type: 'rooms',\n phase: 'receive',\n action: 'join',\n socketId: socket.id,\n payload: msg,\n })\n const parsed = joinPayloadSchema.safeParse(msg)\n\n if (!parsed.success) {\n socket.emit(`${roomJoinEvent}:error`, {\n eventName: roomJoinEvent,\n issues: parsed.error.issues,\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n action: 'join',\n phase: 'validation_error',\n socketId: socket.id,\n issues: parsed.error.issues,\n payload: msg,\n })\n return\n }\n const list = toArray(parsed.data.rooms)\n\n const join = async (room: string) => {\n await socket.join(room)\n dbg(null, {\n type: 'rooms',\n action: 'join',\n rooms: room,\n socketId: socket.id,\n })\n }\n\n const run = async () => {\n await getSysEvent('sys:room_join')({\n socket,\n helper,\n rooms: list,\n meta: parsed.data.meta as SocketSchemaOutput<C['joinMetaMessage']>,\n join,\n })\n }\n\n try {\n await run()\n } catch (error) {\n socket.emit(`${roomJoinEvent}:error`, {\n error: normalizeError(error),\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n action: 'join',\n phase: 'handler_error',\n payload: includeRaw\n ? { rooms: list, meta: parsed.data.meta }\n : undefined,\n socketId: socket.id,\n issues: [error],\n })\n }\n }\n\n const leaveHandler = async (msg: unknown) => {\n dbg(roomLeaveEvent, {\n type: 'rooms',\n phase: 'receive',\n action: 'leave',\n socketId: socket.id,\n payload: msg,\n })\n const parsed = leavePayloadSchema.safeParse(msg)\n if (!parsed.success) {\n socket.emit(`${roomLeaveEvent}:error`, {\n eventName: roomLeaveEvent,\n issues: parsed.error.issues,\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n action: 'leave',\n phase: 'validation_error',\n socketId: socket.id,\n issues: parsed.error.issues,\n payload: msg,\n })\n return\n }\n\n const list = toArray(parsed.data.rooms)\n\n const leave = async (room: string) => {\n await socket.leave(room)\n dbg(null, {\n type: 'rooms',\n action: 'leave',\n rooms: room,\n socketId: socket.id,\n })\n }\n\n const run = async () => {\n await getSysEvent('sys:room_leave')({\n socket,\n helper,\n rooms: list,\n meta: parsed.data.meta as SocketSchemaOutput<C['leaveMetaMessage']>,\n leave,\n })\n }\n\n try {\n await run()\n } catch (error) {\n socket.emit(`${roomLeaveEvent}:error`, {\n error: normalizeError(error),\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n phase: 'handler_error',\n payload: { rooms: list, meta: parsed.data.meta },\n socketId: socket.id,\n issues: [error],\n action: 'join',\n })\n }\n }\n\n // heartbeat, wrapped with sys:ping/sys:pong\n const pingHandler = async (msg: unknown) => {\n if (!heartbeatEnabled) {\n dbg(null, {\n type: 'heartbeat',\n phase: 'skip',\n socketId: socket.id,\n details: { reason: 'heartbeat_disabled' },\n error: false,\n })\n return\n }\n\n const parsedPing = pingPayloadSchema.safeParse(msg)\n if (!parsedPing.success) {\n socket.emit(`${pingEvent}:error`, {\n eventName: pingEvent,\n issues: parsedPing.error.issues,\n })\n dbg(null, {\n type: 'heartbeat',\n phase: 'ping',\n socketId: socket.id,\n payload: includeRaw ? msg : undefined,\n issues: parsedPing.error.issues,\n error: true,\n details: { step: 'parse' },\n })\n return\n }\n const ctx = createCtx(socket)\n\n dbg(null, {\n type: 'heartbeat',\n phase: 'ping',\n socketId: socket.id,\n payload: parsedPing.data,\n error: false,\n })\n\n let pongPayload: SocketSchemaOutput<C['pongPayload']>\n try {\n pongPayload = await getSysEvent('sys:ping')({\n ping: parsedPing.data as SocketSchemaOutput<C['pingPayload']>,\n ctx,\n socket,\n helper,\n })\n } catch (error) {\n socket.emit(`${pingEvent}:error`, { error: normalizeError(error) })\n dbg(null, {\n type: 'heartbeat',\n phase: 'ping',\n socketId: socket.id,\n payload: parsedPing.data,\n error: true,\n details: { step: 'sys_handler_error' },\n })\n return\n }\n\n const parsedPong = pongPayloadSchema.safeParse(pongPayload)\n if (!parsedPong.success) {\n socket.emit(`${pongEvent}:error`, {\n eventName: pongEvent,\n issues: parsedPong.error.issues,\n })\n dbg(null, {\n type: 'heartbeat',\n phase: 'pong',\n socketId: socket.id,\n payload: includeRaw ? pongPayload : undefined,\n issues: parsedPong.error.issues,\n error: true,\n details: { step: 'parse' },\n })\n return\n }\n socket.emit(pongEvent, parsedPong.data)\n dbg(null, {\n type: 'heartbeat',\n phase: 'pong',\n socketId: socket.id,\n payload: parsedPong.data,\n error: false,\n })\n }\n\n // attach built-in handlers\n socket.on(roomJoinEvent, joinHandler)\n socket.on(roomLeaveEvent, leaveHandler)\n if (heartbeatEnabled) {\n socket.on(pingEvent, pingHandler)\n }\n\n const cleanup = (reason: string) => {\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_cleanup',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: { reason },\n })\n socket.off(roomJoinEvent, joinHandler)\n socket.off(roomLeaveEvent, leaveHandler)\n if (heartbeatEnabled) {\n socket.off(pingEvent, pingHandler)\n }\n }\n\n socketTeardowns.set(socket, cleanup)\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_handlers_attached',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: {\n heartbeatEnabled,\n joinEvent: roomJoinEvent,\n leaveEvent: roomLeaveEvent,\n pingEvent: heartbeatEnabled ? pingEvent : undefined,\n },\n })\n\n socket.once('disconnect', (reason) => {\n dbg('sys:disconnect', {\n type: 'lifecycle',\n stage: 'connection_cleanup',\n nsp: socket.nsp.name,\n socketId: socket.id,\n details: { reason },\n })\n const defaultDisconnect = () => {\n cleanup(reason)\n socketTeardowns.delete(socket)\n }\n getSysEvent('sys:disconnect')({\n socket,\n helper,\n reason: String(reason),\n cleanup: defaultDisconnect,\n })\n })\n }\n getSysEvent('sys:connect')({\n socket,\n helper,\n complete: defaultConnect,\n })\n }\n\n return {\n builtInConnectionListener,\n socketTeardowns,\n roomJoinEvent,\n roomLeaveEvent,\n pingEvent,\n }\n}\n","// socket.server.index.ts\nimport { Server, Socket } from 'socket.io'\nimport { z } from 'zod'\nimport type {\n EventMap,\n SocketConnectionConfigOutput,\n Payload,\n} from '@emeryld/rrroutes-contract'\nimport { createDebugger } from './socket.server.debug'\nimport type {\n SocketServerDebugEvent,\n SocketDebugOptions,\n} from './socket.server.debug'\nimport { createBuiltInConnectionHandlers } from './socket.server.sys'\nimport type {\n HeartbeatServerOptions,\n SocketConnectionHelper,\n SysServerEventMap,\n} from './socket.server.sys'\nimport type { HandlerCtx, HandlerCtxNoAck } from './socket.server.types'\n\nconst createBaseHandlerCtx = (socket: Socket): HandlerCtxNoAck => ({\n sentAt: new Date(),\n socket,\n socketId: socket.id,\n nsp: socket.nsp.name,\n rooms: Array.from(socket.rooms),\n user: socket.data?.user,\n scopes: socket.data?.scopes,\n})\n\nconst normalizeError = (error: unknown, verbose?: boolean) => {\n if (error instanceof Error) {\n return {\n name: error.name,\n message: error.message,\n stack: verbose ? error.stack : undefined,\n }\n }\n if (typeof error === 'string') return { message: error }\n if (typeof error === 'object' && error !== null) {\n return verbose ? error : { message: 'Unknown error' }\n }\n return { message: String(error) }\n}\n\nexport interface SocketConnection<T extends EventMap> {\n on<K extends keyof T & string>(\n eventName: K,\n handler: (payload: Payload<T, K>, ctx: HandlerCtx) => void | Promise<void>,\n ): () => void\n\n off<K extends keyof T & string>(eventName: K): void\n\n emit<K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n toRooms?: string[] | string,\n metadata?: Record<string, unknown>,\n onAck?: (ack: unknown) => void,\n ): void\n\n /** Dispose all listeners, timers, and room memberships created by this instance. */\n destroy(): void\n}\n\nexport function createSocketConnections<\n T extends EventMap,\n TConfig extends SocketConnectionConfigOutput = SocketConnectionConfigOutput,\n>(\n io: Server,\n events: T,\n opts: {\n debug?: SocketDebugOptions\n heartbeat?: HeartbeatServerOptions\n /** System event customization (connect / disconnect / ping / pong / room join/leave) */\n sys: SysServerEventMap<TConfig, T>\n config: TConfig\n },\n): SocketConnection<T> {\n const dbg = createDebugger(opts?.debug)\n const socketConfig = opts.config\n const heartbeatEnabled = opts?.heartbeat?.enabled !== false\n const eventNames = Object.keys(events)\n dbg(null, {\n type: 'lifecycle',\n stage: 'server_init',\n details: {\n prefinedEvents: eventNames,\n heartbeatEnabled,\n path: io?.path(),\n namespaces: Array.from(io._nsps.keys()),\n transport: io?._opts.transports,\n sysEvents: Object.keys(opts.sys ?? {}),\n },\n })\n\n const getSchema = <K extends keyof T & string>(k: K) => events[k].message\n const toArray = (rooms?: string[] | string): string[] =>\n rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms]\n const emitToTargets = <K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n targets: string[],\n metadata?: Record<string, unknown>,\n ) => {\n const schema = getSchema(eventName)\n const check = schema.safeParse(payload)\n if (!check.success) {\n dbg(String(eventName), {\n type: 'emit',\n event: String(eventName),\n rooms: targets,\n ...(opts?.debug?.verbose ? { attemptedPayload: payload } : {}),\n error: {\n reason: 'invalid_payload',\n message: check.error.message,\n issues: check.error.issues,\n },\n metadata,\n })\n throw new Error(\n `Invalid payload for \"${String(eventName)}\": ${check.error.message}`,\n )\n }\n\n const envelope = {\n eventName,\n sentAt: new Date(),\n sentTo: targets,\n data: check.data as Payload<T, K>,\n metadata: metadata ?? {},\n }\n\n if (targets.length === 0) io.emit(String(eventName), envelope)\n else if (targets.length === 1) {\n const sid = targets[0]!\n const sock = io.sockets.sockets.get(sid as any)\n if (sock) {\n sock.emit(String(eventName), envelope)\n } else {\n io.to(targets).emit(String(eventName), envelope)\n }\n } else {\n io.to(targets).emit(String(eventName), envelope)\n }\n\n dbg(String(eventName), {\n type: 'emit',\n event: String(eventName),\n rooms: targets,\n envelope: opts?.debug?.verbose ? envelope : undefined,\n })\n }\n const createSocketHelper = (socket: Socket): SocketConnectionHelper<T> => ({\n emit<K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n metadata?: Record<string, unknown>,\n ) {\n emitToTargets(eventName, payload, [socket.id], metadata)\n },\n })\n\n // registrations\n const registrations = new Map<\n string,\n Set<{\n connectionListener: (socket: Socket) => void\n socketListeners: WeakMap<Socket, (raw: unknown) => void>\n }>\n >()\n\n const addRegistration = (\n eventName: string,\n reg: {\n connectionListener: (socket: Socket) => void\n socketListeners: WeakMap<Socket, (raw: unknown) => void>\n },\n ) => {\n let set = registrations.get(eventName)\n if (!set) {\n set = new Set()\n registrations.set(eventName, set)\n }\n set.add(reg)\n }\n\n const removeAllForEvent = (eventName: string) => {\n const set = registrations.get(eventName)\n if (!set) {\n dbg(null, {\n type: 'register',\n event: eventName,\n action: 'unregister',\n msg: 'no handlers registered',\n })\n return\n }\n for (const reg of set) {\n io.off('connection', reg.connectionListener)\n for (const socket of io.sockets.sockets.values()) {\n const wrapped = reg.socketListeners.get(socket)\n if (wrapped) socket.off(String(eventName), wrapped)\n }\n }\n registrations.delete(eventName)\n dbg(eventName, {\n type: 'register',\n action: 'unregister',\n event: eventName,\n msg: 'unregistered',\n })\n }\n\n const {\n builtInConnectionListener,\n socketTeardowns,\n roomJoinEvent,\n roomLeaveEvent,\n pingEvent,\n } = createBuiltInConnectionHandlers<TConfig, T>({\n heartbeat: opts?.heartbeat,\n sys: opts.sys,\n dbg,\n config: socketConfig,\n createCtx: createBaseHandlerCtx,\n debugVerbose: opts?.debug?.verbose === true,\n createHelper: createSocketHelper,\n })\n\n // install built-in connection listener\n io.on('connection', builtInConnectionListener)\n\n const conn = {\n on<K extends keyof T & string>(\n eventName: K,\n handler: (\n payload: Payload<T, K>,\n ctx: HandlerCtx,\n ) => void | Promise<void>,\n ): () => void {\n const socketListeners = new WeakMap<Socket, (raw: unknown) => void>()\n\n const connectionListener = (socket: Socket) => {\n const wrapped = async (raw: unknown) => {\n const schema = getSchema(eventName)\n const parsed = schema.safeParse(raw)\n\n const ctx = createBaseHandlerCtx(socket)\n\n dbg(String(eventName), {\n type: 'handler',\n phase: 'receive',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n rooms: ctx.rooms,\n raw: opts?.debug?.verbose ? raw : undefined,\n })\n\n if (!parsed.success) {\n socket.emit(`${String(eventName)}:error`, {\n eventName,\n sentAt: ctx.sentAt,\n issues: parsed.error.issues,\n })\n dbg(String(eventName), {\n type: 'handler',\n phase: 'validation_error',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n issues: parsed.error.issues,\n })\n return\n }\n\n try {\n await handler(parsed.data as Payload<T, K>, ctx)\n dbg(String(eventName), {\n type: 'handler',\n phase: 'handler_success',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n rooms: ctx.rooms,\n })\n } catch (error) {\n dbg(String(eventName), {\n type: 'handler',\n phase: 'handler_error',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n rooms: ctx.rooms,\n error,\n })\n socket.emit(`${String(eventName)}:error`, {\n eventName,\n sentAt: ctx.sentAt,\n error: normalizeError(error, opts?.debug?.verbose),\n })\n }\n }\n\n socketListeners.set(socket, wrapped)\n socket.on(String(eventName), wrapped)\n socket.once('disconnect', () => {\n const w = socketListeners.get(socket)\n if (w) socket.off(String(eventName), w)\n })\n }\n\n io.on('connection', connectionListener)\n addRegistration(String(eventName), {\n connectionListener,\n socketListeners,\n })\n dbg(String(eventName), {\n type: 'register',\n action: 'register',\n event: String(eventName),\n })\n\n return () => {\n const set = registrations.get(String(eventName))\n if (!set) {\n dbg(null, {\n type: 'register',\n action: 'unregister',\n event: String(eventName),\n msg: `No registration under ${eventName}`,\n })\n return\n }\n for (const reg of Array.from(set)) {\n if (reg.connectionListener === connectionListener) {\n io.off('connection', reg.connectionListener)\n for (const socket of io.sockets.sockets.values()) {\n const wrapped = reg.socketListeners.get(socket)\n if (wrapped) socket.off(String(eventName), wrapped)\n }\n set.delete(reg)\n break\n }\n }\n if (set.size === 0) registrations.delete(String(eventName))\n dbg(String(eventName), {\n type: 'register',\n action: 'unregister',\n event: String(eventName),\n })\n }\n },\n\n off<K extends keyof T & string>(eventName: K): void {\n removeAllForEvent(String(eventName))\n },\n\n emit<K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n rooms?: string[] | string,\n metadata?: Record<string, unknown>,\n ): void {\n const targets = toArray(rooms)\n emitToTargets(eventName, payload, targets, metadata)\n },\n\n destroy(): void {\n dbg(null, {\n type: 'lifecycle',\n stage: 'destroy_start',\n details: {\n socketCount: io.sockets.sockets.size,\n registrationCount: registrations.size,\n },\n })\n // 1) Remove built-in connection listener so no new sockets get handlers\n io.off('connection', builtInConnectionListener)\n\n // 2) Cleanup built-in handlers for all current sockets and leave rooms\n for (const socket of io.sockets.sockets.values()) {\n const cleanup = socketTeardowns.get(socket)\n if (cleanup) {\n cleanup('destroy')\n socketTeardowns.delete(socket)\n } else {\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_cleanup_fallback',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: { reason: 'teardown_missing' },\n })\n // Fallback if socket was attached before map population\n try {\n socket.removeAllListeners(roomJoinEvent)\n socket.removeAllListeners(roomLeaveEvent)\n socket.removeAllListeners(pingEvent)\n } catch {\n // noop\n }\n }\n }\n\n // 3) Remove all user-registered event listeners and their connection hooks\n for (const eventName of Array.from(registrations.keys())) {\n removeAllForEvent(eventName)\n }\n\n // 4) Defensive: clear any residual maps\n registrations.clear()\n dbg(null, {\n type: 'lifecycle',\n stage: 'destroy_complete',\n details: {\n socketCount: io.sockets.sockets.size,\n registrationCount: registrations.size,\n },\n })\n },\n } as const satisfies SocketConnection<T>\n\n return conn\n}\n\nexport type { EventMap, Payload }\nexport type { HandlerCtx } from './socket.server.types'\nexport type {\n SocketServerDebugEvent,\n SocketDebugOptions,\n SocketServerConfigSnapshot,\n SocketServerLifecycleStage,\n SocketServerHeartbeatPhase,\n} from './socket.server.debug'\nexport type {\n HeartbeatServerOptions,\n SocketConnectionHelper,\n SysServerEventMap,\n} from './socket.server.sys'\n","import type { IncomingHttpHeaders } from 'http'\nimport type { Socket } from 'socket.io'\n\nexport type ConnectionMiddlewareStage = 'incoming'\n\nexport type ConnectionMiddlewareContext = {\n socketId?: string\n nsp?: string\n rooms: string[]\n user?: unknown\n scopes?: string[]\n address?: string\n transport?: string\n protocol?: string\n handshake: {\n url?: string\n issued?: number\n time?: string\n query?: Record<string, unknown>\n auth?: Record<string, unknown>\n headers?: IncomingHttpHeaders\n }\n}\n\nexport type ConnectionMiddlewareEvent = {\n type: 'connection'\n stage: ConnectionMiddlewareStage\n timestamp: Date\n context: ConnectionMiddlewareContext\n}\n\nexport type ConnectionLoggingMiddlewareOptions = {\n /**\n * Custom logger invoked with the structured event.\n * Defaults to console.info.\n */\n logger?: (event: ConnectionMiddlewareEvent) => void\n /**\n * Include raw headers from the handshake. Defaults to false to avoid leaking PII.\n */\n includeHeaders?: boolean\n /**\n * List of auth keys that should be redacted (case-insensitive). Defaults to ['authorization'].\n */\n redactAuthKeys?: string[]\n}\n\nconst defaultRedactedValue = '[REDACTED]'\n\nconst defaultLogger = (event: ConnectionMiddlewareEvent) => {\n const {\n stage,\n context: { socketId, nsp, address, transport, handshake },\n } = event\n // eslint-disable-next-line no-console\n console.info('[socket-connection]', {\n stage,\n socketId,\n nsp,\n address,\n transport,\n url: handshake.url,\n query: handshake.query,\n auth: handshake.auth,\n })\n}\n\nconst redactAuth = (\n auth: Record<string, unknown> | undefined,\n redactKeys: Set<string>,\n): Record<string, unknown> | undefined => {\n if (!auth) return undefined\n if (redactKeys.size === 0) return auth\n\n const clone: Record<string, unknown> = {}\n for (const [key, value] of Object.entries(auth)) {\n const normalizedKey = key.toLowerCase()\n clone[key] = redactKeys.has(normalizedKey) ? defaultRedactedValue : value\n }\n return clone\n}\n\nconst buildContext = (\n socket: Socket,\n includeHeaders: boolean,\n redactKeys: Set<string>,\n): ConnectionMiddlewareContext => {\n const conn = socket.conn as\n | {\n remoteAddress?: string\n transport?: { name?: string }\n protocol?: string | number\n }\n | undefined\n\n const handshake = socket.handshake ?? {}\n\n const protocolValue = conn?.protocol\n\n return {\n socketId: socket.id,\n nsp: socket.nsp?.name,\n rooms: Array.from(socket.rooms ?? []),\n user: (socket.data as any)?.user,\n scopes: (socket.data as any)?.scopes,\n address: conn?.remoteAddress ?? (handshake as any).address,\n transport: conn?.transport?.name,\n protocol: protocolValue != null ? String(protocolValue) : undefined,\n handshake: {\n url: handshake.url,\n issued: handshake.issued,\n time: handshake.time,\n query: handshake.query as Record<string, unknown>,\n auth: redactAuth(handshake.auth as Record<string, unknown>, redactKeys),\n headers: includeHeaders\n ? (handshake.headers as IncomingHttpHeaders)\n : undefined,\n },\n }\n}\n\nexport const createConnectionLoggingMiddleware = (\n options: ConnectionLoggingMiddlewareOptions = {},\n) => {\n const logger = options.logger ?? defaultLogger\n const includeHeaders = options.includeHeaders ?? false\n const redactKeys = new Set(\n (options.redactAuthKeys ?? ['authorization', 'token']).map((key) =>\n key.toLowerCase(),\n ),\n )\n\n return (socket: Socket, next: (err?: Error) => void) => {\n const context = buildContext(socket, includeHeaders, redactKeys)\n logger({\n type: 'connection',\n stage: 'incoming',\n timestamp: new Date(),\n context,\n })\n next()\n }\n}\n\nexport type ConnectionLoggingMiddleware = ReturnType<\n typeof createConnectionLoggingMiddleware\n>\n"],"mappings":"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","names":["keyOf","normalizeError","toArray"]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/routesV3.server.ts","../src/sockets/socket.server.debug.ts","../src/sockets/socket.server.sys.ts","../src/sockets/socket.server.index.ts","../src/sockets/socket.server.middleware.ts"],"sourcesContent":["export { keyOf as contractKeyOf } from '@emeryld/rrroutes-contract'\nexport * from './routesV3.server'\nexport * from './sockets/socket.server.index'\nexport * from './sockets/socket.server.middleware'\n","/**\n * routesV3.server.ts\n * -----------------------------------------------------------------------------\n * Bind an Express router/app to a `finalize(...)` registry of AnyLeafs.\n * - Fully typed handlers (params/query/body/output)\n * - Zod parsing + optional output validation\n * - buildCtx runs as a middleware *first*, before all other middlewares\n * - Global, per-route, and cfg-derived middlewares (auth, uploads)\n * - Helper to warn about unimplemented routes\n * - DX helpers to use `ctx` in any middleware with proper types\n */\n\nimport {\n AnyLeafLowProfile,\n FileField,\n HttpMethod,\n InferBody,\n InferOutput,\n InferParams,\n InferQuery,\n keyOf,\n lowProfileParse,\n} from '@emeryld/rrroutes-contract'\nimport type * as express from 'express'\nimport type { RequestHandler, Router } from 'express'\n\n/** Shape expected from optional logger implementations. */\nexport type LoggerLike = {\n info?: (...args: any[]) => void\n warn?: (...args: any[]) => void\n error?: (...args: any[]) => void\n debug?: (...args: any[]) => void\n verbose?: (...args: any[]) => void\n system?: (...args: any[]) => void\n log?: (...args: any[]) => void\n}\n\ntype RoutesLoggerCarrier = {\n routesLogger?: LoggerLike\n}\n\ntype CtxWithRoutesLogger<Ctx> = Ctx & RoutesLoggerCarrier\n\n// Debug logging --------------------------------------------------------------\nexport type RouteServerDebugMode = 'minimal' | 'complete'\n\ntype RouteServerDebugEventBase = {\n /** Optional logical name assigned via `RouteDef.debug?.debugName` (or `RouteDef.debugName`). */\n name?: string\n}\n\nexport type RouteServerDebugEvent =\n | (RouteServerDebugEventBase & {\n type: 'request'\n stage: 'start' | 'success' | 'error'\n method: Uppercase<HttpMethod>\n path: string\n url: string\n durationMs?: number\n params?: unknown\n query?: unknown\n body?: unknown\n output?: unknown\n error?: unknown\n })\n | (RouteServerDebugEventBase & {\n type: 'register'\n method: Uppercase<HttpMethod>\n path: string\n })\n | (RouteServerDebugEventBase & {\n type: 'buildCtx'\n stage: 'start' | 'success' | 'error'\n method: Uppercase<HttpMethod>\n path: string\n url: string\n durationMs?: number\n error?: unknown\n })\n | (RouteServerDebugEventBase & {\n type: 'handler'\n stage: 'start' | 'success' | 'error'\n method: Uppercase<HttpMethod>\n path: string\n durationMs?: number\n params?: unknown\n query?: unknown\n body?: unknown\n output?: unknown\n error?: unknown\n })\n\nexport type RouteServerDebugLogger = (event: RouteServerDebugEvent) => void\n\n/**\n * Configure server-side debug logging.\n * - Use booleans or `'minimal'/'complete'` for quick toggles.\n * - Pass a custom logger function to redirect structured events.\n * - Provide a map to enable specific event types, opt into verbose payload logging, or restrict logs via `only`.\n */\nexport type RouteServerDebugOptions<Names extends string = string> =\n RouteServerDebugToggleOptions<Names>\n\n/**\n * Fine-grained toggle map for server debug logging.\n * Enable individual event types, opt into verbose payload logging, override the logger, or restrict to named routes.\n * Use `RouteDef.debug?.debugName` (or the deprecated `RouteDef.debugName`) to set the name that `only` will match against.\n */\nexport type RouteServerDebugToggleOptions<Names extends string = string> =\n Partial<Record<RouteServerDebugEvent['type'], boolean>> & {\n verbose?: boolean\n logger?: RouteServerDebugLogger\n only?: Names[]\n }\n\n/**\n * Per-route debug overrides. Same toggles as `RouteServerDebugOptions`, but limited to a single route\n * and therefore replaces the `only` filter with a local `debugName`.\n */\nexport type RouteDefDebugOptions<Names extends string = string> = Omit<\n RouteServerDebugToggleOptions<Names>,\n 'only'\n> & {\n debugName?: Names\n}\n\nconst serverDebugEventTypes: RouteServerDebugEvent['type'][] = [\n 'register',\n 'request',\n 'buildCtx',\n 'handler',\n]\n\ntype ServerDebugEmitter<Names extends string> = {\n emit: (event: RouteServerDebugEvent, name?: Names) => void\n mode: RouteServerDebugMode\n}\n\nconst noopServerEmit = () => {}\n\nfunction createServerDebugEmitter<Names extends string>(\n option?: RouteServerDebugOptions<Names>,\n): ServerDebugEmitter<Names> {\n const disabled: ServerDebugEmitter<Names> = {\n emit: noopServerEmit,\n mode: 'minimal',\n }\n if (!option) return disabled\n\n if (typeof option === 'object') {\n const toggles = option as RouteServerDebugToggleOptions<Names>\n const verbose = Boolean(toggles.verbose)\n const enabledTypes = serverDebugEventTypes.filter((type) => toggles[type])\n if (enabledTypes.length === 0) {\n return { emit: noopServerEmit, mode: verbose ? 'complete' : 'minimal' }\n }\n const whitelist = new Set<RouteServerDebugEvent['type']>(enabledTypes)\n const onlySet =\n toggles.only && toggles.only.length > 0\n ? new Set<Names>(toggles.only)\n : undefined\n const logger = toggles.logger\n const emit: ServerDebugEmitter<Names>['emit'] = (event, name) => {\n if (!whitelist.has(event.type) || !logger) return\n if (onlySet && (!name || !onlySet.has(name))) return\n logger(name ? { ...event, name } : event)\n }\n return { emit, mode: verbose ? 'complete' : 'minimal' }\n }\n\n return disabled\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Keys + leaf helpers (derive keys from byKey to avoid template-literal pitfalls)\n// ──────────────────────────────────────────────────────────────────────────────\n\n/** Keys like \"GET /v1/foo\" that *actually* exist in the registry */\nexport type KeysOfRegistry<\n R extends { byKey: Record<string, AnyLeafLowProfile> },\n> = keyof R['byKey'] & string\n\ntype MethodFromKey<K extends string> = K extends `${infer M} ${string}`\n ? Lowercase<M>\n : never\ntype PathFromKey<K extends string> = K extends `${string} ${infer P}`\n ? P\n : never\n\n/** Given a registry and a key, pick the exact leaf for that method+path */\nexport type LeafFromKey<\n R extends { all: readonly AnyLeafLowProfile[] },\n K extends string,\n> = Extract<\n R['all'][number],\n { method: MethodFromKey<K> & HttpMethod; path: PathFromKey<K> }\n>\n\n/** Optional-ify types if your core returns `never` when a schema isn't defined */\ntype Maybe<T> = [T] extends [never] ? void : T\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst decodeJsonLikeQueryValue = (value: unknown): unknown => {\n if (Array.isArray(value)) {\n return value.map((entry) => decodeJsonLikeQueryValue(entry))\n }\n if (isPlainObject(value)) {\n const next: Record<string, unknown> = {}\n for (const [key, child] of Object.entries(value)) {\n next[key] = decodeJsonLikeQueryValue(child)\n }\n return next\n }\n if (typeof value === 'string') {\n const trimmed = value.trim()\n if (\n (trimmed.startsWith('{') && trimmed.endsWith('}')) ||\n (trimmed.startsWith('[') && trimmed.endsWith(']'))\n ) {\n try {\n return JSON.parse(trimmed)\n } catch {\n return value\n }\n }\n }\n return value\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Context typing & DX helpers (so ctx is usable in *any* middleware)\n// ──────────────────────────────────────────────────────────────────────────────\n\n/**\n * Unique symbol used to stash ctx on res.locals.\n * (Symbols are safer than string keys against collisions.)\n */\nexport const CTX_SYMBOL: unique symbol = Symbol.for('typedLeaves.ctx')\n\n/** Response type that *has* a ctx on locals for DX in middlewares */\nexport type ResponseWithCtx<Ctx> =\n // Replace locals with an intersection that guarantees CTX_SYMBOL exists\n Omit<express.Response, 'locals'> & {\n locals: express.Response['locals'] & {\n [CTX_SYMBOL]: CtxWithRoutesLogger<Ctx>\n }\n }\n\n/** A middleware signature that can *use* ctx via `res.locals[CTX_SYMBOL]` */\nexport type CtxRequestHandler<Ctx> = (args: {\n req: express.Request\n res: express.Response\n next: express.NextFunction\n ctx: CtxWithRoutesLogger<Ctx>\n}) => any\n\n/**\n * Safely read ctx from any Response.\n * @param res Express response whose locals contain the ctx symbol.\n * @returns Strongly typed context object.\n */\nexport function getCtx<Ctx = unknown>(\n res: express.Response,\n): CtxWithRoutesLogger<Ctx> {\n return (res.locals as any)[CTX_SYMBOL] as CtxWithRoutesLogger<Ctx>\n}\n\n/**\n * Wrap a ctx-typed middleware to a plain RequestHandler (for arrays, etc.).\n * @param mw Middleware that expects a typed response with ctx available.\n * @returns Standard Express request handler.\n */\nfunction adaptCtxMw<Ctx>(mw: CtxRequestHandler<Ctx>): RequestHandler {\n return (req, res, next) => {\n try {\n const result = mw({ req, res, next, ctx: getCtx<Ctx>(res) })\n if (result && typeof (result as Promise<unknown>).then === 'function') {\n return (result as Promise<unknown>).catch((err) => next(err))\n }\n return result as any\n } catch (err) {\n next(err as any)\n return undefined\n }\n }\n}\n\nfunction logHandlerDebugWithRoutesLogger(\n logger: LoggerLike | undefined,\n event: RouteServerDebugEvent,\n) {\n if (!logger || event.type !== 'handler') return\n const payload: [string, RouteServerDebugEvent] = [\n `[rrroutes-server][handler:${event.stage}] ${event.method} ${event.path}`,\n event,\n ]\n if (event.stage === 'error') {\n ;(\n logger.error ??\n logger.warn ??\n logger.debug ??\n logger.info ??\n logger.log ??\n logger.system\n )?.call(logger, ...payload)\n return\n }\n ;(\n logger.debug ??\n logger.verbose ??\n logger.info ??\n logger.log ??\n logger.system\n )?.call(logger, ...payload)\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Controller types — object form only (simpler, clearer typings)\n// ──────────────────────────────────────────────────────────────────────────────\n\n/** Typed route handler for a specific leaf */\n\nexport type Handler<L extends AnyLeafLowProfile, Ctx = unknown> = (args: {\n req: express.Request\n res: express.Response\n next: express.NextFunction\n ctx: CtxWithRoutesLogger<Ctx>\n params: Maybe<InferParams<L>>\n query: Maybe<InferQuery<L>>\n body: Maybe<InferBody<L>>\n}) => Promise<Maybe<InferOutput<L>>> | Maybe<InferOutput<L>>\n\n/** Route definition for one key */\nexport type RouteDef<\n L extends AnyLeafLowProfile,\n Ctx = unknown,\n Names extends string = string,\n> = {\n /** Middlewares before the handler (run after buildCtx/global/derived) */\n before?: Array<CtxRequestHandler<Ctx>>\n /** Your business logic */\n handler: Handler<L, Ctx>\n /**\n * Optional per-route debug overrides. When provided, these replace the global debug options.\n */\n debug?: RouteDefDebugOptions<Names>\n}\n\n/** Map of registry keys -> route defs */\nexport type ControllerMap<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n> = {\n [P in KeysOfRegistry<R>]: RouteDef<LeafFromKey<R, P>, Ctx, Names>\n}\n\nexport type PartialControllerMap<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n> = Partial<ControllerMap<R, Ctx, Names>>\n\n// ──────────────────────────────────────────────────────────────────────────────\n/** Options + derivation helpers */\n// ──────────────────────────────────────────────────────────────────────────────\n\nexport type RouteServerConfig<Ctx = unknown, Names extends string = string> = {\n /**\n * Build a request-scoped context. We wrap this in a middleware that runs\n * *first* (before global/derived/route middlewares), and stash it on\n * `res.locals[CTX_SYMBOL]` so *all* later middlewares can use it.\n * You can optionally include `routesLogger` to override handler debug logging per request.\n */\n buildCtx: (\n req: express.Request,\n res: express.Response,\n ) => CtxWithRoutesLogger<Ctx> | Promise<CtxWithRoutesLogger<Ctx>>\n\n /** Grouped global middlewares that run before the handler for every route. */\n globalMiddleware?: Array<CtxRequestHandler<Ctx>>\n\n /**\n * Derive middleware from MethodCfg.\n * - `upload` runs when cfg.bodyFiles has entries\n */\n fromCfg?: {\n upload?: (files: FileField[] | undefined) => RequestHandler[]\n }\n\n /** Validate handler return values with outputSchema (default: true) */\n validateOutput?: boolean\n\n /** Custom responder (default: res.json(data)) */\n send?: (res: express.Response, data: unknown) => void\n\n /** Optional logger hooks */\n logger?: LoggerLike\n\n /**\n * Optional debug logging for the request lifecycle.\n * Supports booleans/modes/loggers, or a toggle map with per-event enabling, verbose payload logging,\n * and `only` filters tied to `RouteDef.debug?.debugName` (or the deprecated `RouteDef.debugName`).\n */\n debug?: RouteServerDebugOptions<Names>\n}\n\n/** Default JSON responder (typed to avoid implicit-any diagnostics) */\nconst defaultSend: (res: express.Response, data: unknown) => void = (\n res,\n data,\n) => {\n res.json(data as any)\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// Core builder\n// ──────────────────────────────────────────────────────────────────────────────\n\nconst REGISTERED_ROUTES_SYMBOL = Symbol.for('routesV3.registeredRoutes')\n\ntype RegisteredRouteStore = Set<string>\n\n/**\n * Retrieve or initialize the shared store of registered route keys.\n * @param router Express router/application that carries previously registered keys.\n * @returns Set of string keys describing registered routes.\n */\nfunction getRegisteredRouteStore(router: Router): RegisteredRouteStore {\n const existing = (router as any)[REGISTERED_ROUTES_SYMBOL] as\n | RegisteredRouteStore\n | undefined\n if (existing) return existing\n const store: RegisteredRouteStore = new Set()\n ;(router as any)[REGISTERED_ROUTES_SYMBOL] = store\n return store\n}\n\n/**\n * Inspect the Express layer stack to discover already-registered routes.\n * @param appOrRouter Express application or router to inspect.\n * @returns All keys in the form `\"METHOD /path\"` found on the stack.\n */\nfunction collectRoutesFromStack(appOrRouter: Router): string[] {\n const result: string[] = []\n const stack: any[] =\n (appOrRouter as any).stack ??\n ((appOrRouter as any)._router\n ? (appOrRouter as any)._router.stack\n : undefined) ??\n []\n\n if (!Array.isArray(stack)) return result\n\n for (const layer of stack) {\n const route = layer && layer.route\n if (!route) continue\n\n const paths = Array.isArray(route.path) ? route.path : [route.path]\n const methodEntries = Object.entries(route.methods ?? {}).filter(\n ([, enabled]) => enabled,\n )\n\n for (const path of paths) {\n for (const [method] of methodEntries) {\n result.push(`${method.toUpperCase()} ${path}`)\n }\n }\n }\n\n return result\n}\n\n/** Runtime helpers returned by `createRRRoute`. */\nexport type RouteServer<Ctx = unknown, Names extends string = string> = {\n router: Router\n register<L extends AnyLeafLowProfile>(\n leaf: L,\n def: RouteDef<L, Ctx, Names>,\n ): void\n registerControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n F extends boolean = false,\n >(\n registry: R,\n controllers: F extends false\n ? PartialControllerMap<R, Ctx, Names>\n : ControllerMap<R, Ctx, Names>,\n all?: F,\n ): void\n warnMissingControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n >(\n registry: R,\n logger: { warn: (...args: any[]) => void },\n ): void\n getRegisteredKeys(): string[]\n}\n\n/**\n * Create an Express binding helper that keeps routes and controllers in sync.\n * @param router Express router or app to register handlers on.\n * @param config Optional configuration controlling ctx building, auth, uploads, etc.\n * @param middleware The order of the middlewares is: buildCtx -> global -> fromCfg -> route -> handler. Remember to call `ctx.next()` in your middlewares to continue the chain.\n * @returns Object with helpers to register controllers and inspect registered keys.\n */\nexport function createRRRoute<Ctx = unknown, Names extends string = string>(\n router: Router,\n config: RouteServerConfig<Ctx, Names>,\n): RouteServer<Ctx, Names> {\n const validateOutput = config.validateOutput ?? true\n const send = config.send ?? defaultSend\n const logger = config.logger\n const { emit: defaultEmitDebug, mode: defaultDebugMode } =\n createServerDebugEmitter<Names>(config.debug)\n\n const knownLeaves = new Map<string, AnyLeafLowProfile>()\n\n const decorateDebugEvent = <T extends RouteServerDebugEvent>(\n isVerbose: boolean,\n event: T,\n details?: Partial<RouteServerDebugEvent>,\n ): RouteServerDebugEvent => {\n if (!isVerbose || !details) return event\n return { ...event, ...details } as RouteServerDebugEvent\n }\n\n const globalBeforeMws = [...(config.globalMiddleware ?? [])].map((mw) =>\n adaptCtxMw<Ctx>(mw),\n )\n const registered = getRegisteredRouteStore(router)\n\n const buildDerived = (leaf: AnyLeafLowProfile): RequestHandler[] => {\n const derived: RequestHandler[] = []\n if (\n config.fromCfg?.upload &&\n Array.isArray(leaf.cfg.bodyFiles) &&\n leaf.cfg.bodyFiles.length > 0\n ) {\n derived.push(...config.fromCfg.upload(leaf.cfg.bodyFiles))\n }\n\n return derived\n }\n\n /** Register a single leaf/controller pair on the underlying router. */\n function register<L extends AnyLeafLowProfile>(\n leaf: L,\n def: RouteDef<L, Ctx, Names>,\n ) {\n const method = leaf.method as HttpMethod\n const methodUpper = method.toUpperCase() as Uppercase<HttpMethod>\n const path = leaf.path as string\n const key = keyOf(leaf.method, leaf.path, false)\n const defDebug = def.debug\n let debugName = undefined as Names | undefined\n let routeDebugEmitter: ServerDebugEmitter<Names> | undefined\n if (defDebug) {\n const { debugName: overrideName, ...rest } = defDebug\n const hasOverrides = Object.values(rest).some(\n (value) => value !== undefined,\n )\n if (hasOverrides) {\n routeDebugEmitter = createServerDebugEmitter<Names>({\n ...config.debug,\n ...rest,\n })\n }\n debugName = (overrideName ?? debugName) as Names | undefined\n }\n const activeEmit = routeDebugEmitter?.emit ?? defaultEmitDebug\n const activeDebugMode = routeDebugEmitter?.mode ?? defaultDebugMode\n const emit = (event: RouteServerDebugEvent) => activeEmit(event, debugName)\n const isVerboseDebug = activeDebugMode === 'complete'\n emit({ type: 'register', method: methodUpper, path })\n\n const routeSpecific = (def?.before ?? []).map((mw) => adaptCtxMw<Ctx>(mw))\n const derived = buildDerived(leaf)\n const ctxMw: RequestHandler = async (req, res, next) => {\n const requestUrl = req.originalUrl ?? path\n const startedAt = Date.now()\n emit({\n type: 'buildCtx',\n stage: 'start',\n method: methodUpper,\n path,\n url: requestUrl,\n })\n try {\n const ctx = await config.buildCtx(req, res)\n ;(res.locals as any)[CTX_SYMBOL] = ctx\n emit({\n type: 'buildCtx',\n stage: 'success',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n })\n next()\n } catch (err) {\n emit({\n type: 'buildCtx',\n stage: 'error',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n error: err,\n })\n logger?.error?.('buildCtx error', err)\n next(err as any)\n }\n }\n const before: RequestHandler[] = [\n ctxMw,\n ...globalBeforeMws,\n ...derived,\n ...routeSpecific,\n ]\n\n const wrapped: RequestHandler = async (req, res, next) => {\n const requestUrl = req.originalUrl.split('?')[0] ?? path\n const startedAt = Date.now()\n emit({\n type: 'request',\n stage: 'start',\n method: methodUpper,\n path,\n url: requestUrl,\n })\n let params: InferParams<L> | undefined\n let query: InferQuery<L> | undefined\n let body: InferBody<L> | undefined\n let responsePayload: InferOutput<L> | undefined\n let hasResponsePayload = false\n const downstreamNext: express.NextFunction = next\n\n const ctx = (res.locals as any)[CTX_SYMBOL] as CtxWithRoutesLogger<Ctx>\n const ctxRoutesLogger = ctx?.routesLogger\n const emitWithCtx = (\n event: RouteServerDebugEvent,\n details?: Partial<RouteServerDebugEvent>,\n ) => {\n const decorated = decorateDebugEvent(isVerboseDebug, event, details)\n if (!config.debug || !config.debug[decorated.type]) {\n return\n }\n if (decorated.type === 'handler' && ctxRoutesLogger) {\n logHandlerDebugWithRoutesLogger(ctxRoutesLogger, decorated)\n } else {\n emit(decorated)\n }\n }\n try {\n params = (\n leaf.cfg.paramsSchema\n ? lowProfileParse(leaf.cfg.paramsSchema, req.params)\n : Object.keys(req.params || {}).length\n ? (req.params as any)\n : undefined\n ) as InferParams<L>\n\n try {\n const parsedQueryInput =\n leaf.cfg.querySchema && req.query\n ? (decodeJsonLikeQueryValue(req.query) as Record<string, unknown>)\n : req.query\n query = leaf.cfg.querySchema\n ? lowProfileParse(leaf.cfg.querySchema, parsedQueryInput)\n : Object.keys(req.query || {}).length\n ? (req.query as any)\n : undefined\n } catch (e) {\n logger?.error?.('Query parsing error', {\n path,\n method: methodUpper,\n error: e,\n raw: JSON.stringify(req.query),\n })\n throw e\n }\n\n body = (\n leaf.cfg.bodySchema\n ? lowProfileParse(leaf.cfg.bodySchema, req.body)\n : req.body !== undefined\n ? (req.body as any)\n : undefined\n ) as InferBody<L>\n\n logger?.verbose?.(`${methodUpper}@${path} (${requestUrl})`, {\n params,\n query,\n body,\n })\n\n const handlerStartedAt = Date.now()\n emitWithCtx(\n {\n type: 'handler',\n stage: 'start',\n method: methodUpper,\n path,\n },\n isVerboseDebug ? { params, query, body } : undefined,\n )\n\n let result\n try {\n result = await def.handler({\n req,\n res,\n next: downstreamNext,\n ctx,\n params: params as Maybe<InferParams<L>>,\n query: query as Maybe<InferQuery<L>>,\n body: body as Maybe<InferBody<L>>,\n })\n emitWithCtx(\n {\n type: 'handler',\n stage: 'success',\n method: methodUpper,\n path,\n durationMs: Date.now() - handlerStartedAt,\n },\n isVerboseDebug\n ? {\n params,\n query,\n body,\n ...(result !== undefined ? { output: result } : {}),\n }\n : undefined,\n )\n } catch (e) {\n emitWithCtx(\n {\n type: 'handler',\n stage: 'error',\n method: methodUpper,\n path,\n durationMs: Date.now() - handlerStartedAt,\n error: e,\n },\n isVerboseDebug ? { params, query, body } : undefined,\n )\n logger?.error?.('Handler error', e)\n throw e\n }\n\n const out =\n validateOutput && leaf.cfg.outputSchema\n ? lowProfileParse(leaf.cfg.outputSchema, result)\n : result\n responsePayload = out as InferOutput<L>\n hasResponsePayload = true\n logger?.verbose?.(`${methodUpper}@${path} result`, out)\n send(res, out)\n\n emitWithCtx(\n {\n type: 'request',\n stage: 'success',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n },\n isVerboseDebug\n ? {\n params,\n query,\n body,\n ...(hasResponsePayload ? { output: responsePayload } : {}),\n }\n : undefined,\n )\n } catch (err) {\n emitWithCtx(\n {\n type: 'request',\n stage: 'error',\n method: methodUpper,\n path,\n url: requestUrl,\n durationMs: Date.now() - startedAt,\n error: err,\n },\n isVerboseDebug ? { params, query, body } : undefined,\n )\n logger?.error?.('Route error', err)\n next(err as any)\n }\n }\n\n ;(router as any)[method](path, ...before, wrapped)\n registered.add(key)\n }\n\n /**\n * Register controller definitions for the provided keys.\n * @param registry Finalized registry of leaves.\n * @param controllers Partial controller map keyed by `\"METHOD /path\"`.\n * @param all Deprecated runtime toggle. Passing any truthy value will throw.\n */\n function registerControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n F extends boolean = false,\n >(registry: R, controllers: PartialControllerMap<R, Ctx, Names>, all?: F) {\n if (all !== undefined && all !== false) {\n const label =\n typeof all === 'string' ? all : all === true ? 'true' : String(all)\n throw new Error(\n `registerControllers: \"${label}\" is not allowed at runtime. Use bindAll(...) for compile-time coverage or warnMissingControllers(...) to surface missing routes.`,\n )\n }\n\n for (const leaf of registry.all) {\n const key = keyOf(leaf.method, leaf.path, false)\n knownLeaves.set(key, leaf)\n }\n\n ;(Object.keys(controllers) as Array<KeysOfRegistry<R>>).forEach((key) => {\n const leaf = registry.byKey[key] as unknown as\n | LeafFromKey<R, typeof key>\n | undefined\n if (!leaf) {\n logger?.warn?.(\n `No leaf found for controller key: ${key}. Not registering route.`,\n )\n return\n }\n const def = controllers[key]\n if (!def) return\n register(leaf as LeafFromKey<R, typeof key>, def)\n })\n }\n\n /**\n * Warn about leaves that do not have a registered controller.\n * @param registry Finalized registry of leaves.\n * @param warnLogger Logger used for warning output.\n */\n function warnMissing<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n >(registry: R, warnLogger: { warn: (...args: any[]) => void }) {\n const registeredFromStore = new Set<string>(Array.from(registered))\n if (registeredFromStore.size === 0) {\n collectRoutesFromStack(router).forEach((key) =>\n registeredFromStore.add(key),\n )\n }\n for (const leaf of registry.all) {\n const key = keyOf(leaf.method, leaf.path, false)\n if (!registeredFromStore.has(key)) {\n warnLogger.warn(`No controller registered for route: ${key}`)\n }\n }\n }\n\n return {\n router,\n register,\n registerControllers,\n warnMissingControllers: warnMissing,\n getRegisteredKeys: () => Array.from(registered),\n }\n}\n\n/**\n * Bind only the controllers that are present in the provided map.\n * @param router Express router or app.\n * @param registry Finalized registry produced by `finalize(...)`.\n * @param controllers Partial map of controllers keyed by `\"METHOD /path\"`.\n * @param config Optional route server configuration.\n * @returns The same router instance for chaining.\n */\nexport function bindExpressRoutes<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n>(\n router: Router,\n registry: R,\n controllers: PartialControllerMap<R, Ctx, Names>,\n config: RouteServerConfig<Ctx, Names>,\n) {\n const server = createRRRoute<Ctx, Names>(router, config)\n server.registerControllers(registry, controllers)\n return router\n}\n\n/**\n * Bind controllers for every leaf. Missing entries fail at compile time.\n * @param router Express router or app.\n * @param registry Finalized registry produced by `finalize(...)`.\n * @param controllers Complete map of controllers keyed by `\"METHOD /path\"`.\n * @param config Optional route server configuration.\n * @returns The same router instance for chaining.\n */\nexport function bindAll<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n>(\n router: Router,\n registry: R,\n controllers: {\n [K in KeysOfRegistry<R>]: RouteDef<LeafFromKey<R, K>, Ctx, Names>\n },\n config: RouteServerConfig<Ctx, Names>,\n) {\n const server = createRRRoute<Ctx, Names>(router, config)\n server.registerControllers(registry, controllers)\n return router\n}\n\n// ──────────────────────────────────────────────────────────────────────────────\n// DX helpers\n// ──────────────────────────────────────────────────────────────────────────────\n\n/**\n * Helper for great IntelliSense when authoring controller maps.\n * @returns Function that enforces key names while preserving partial flexibility.\n */\nexport const defineControllers =\n <\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n Ctx = unknown,\n Names extends string = string,\n >() =>\n <M extends PartialControllerMap<R, Ctx, Names>>(m: M) =>\n m\n\n/**\n * Warn about leaves that don't have controllers.\n * Call this during startup to surface missing routes.\n * @param router Express router or app to inspect.\n * @param registry Finalized registry produced by `finalize(...)`.\n * @param logger Logger where warnings are emitted.\n */\nexport function warnMissingControllers<\n R extends {\n all: readonly AnyLeafLowProfile[]\n byKey: Record<string, AnyLeafLowProfile>\n },\n>(router: Router, registry: R, logger: { warn: (...args: any[]) => void }) {\n const registeredStore = (router as any)[REGISTERED_ROUTES_SYMBOL] as\n | Set<string>\n | undefined\n const initial = registeredStore\n ? Array.from(registeredStore)\n : collectRoutesFromStack(router)\n const registeredKeys = new Set<string>(initial)\n\n for (const leaf of registry.all) {\n const k = keyOf(leaf.method, leaf.path, false)\n if (!registeredKeys.has(k)) {\n logger.warn(`No controller registered for route: ${k}`)\n }\n }\n}\n","// socket.server.debug.ts\nimport type { IncomingHttpHeaders } from 'http'\n\nexport type SocketServerConfigSnapshot = {\n url?: string\n transport?: string\n protocol?: string\n address?: string\n issued?: number\n time?: string\n query?: Record<string, unknown>\n auth?: Record<string, unknown>\n headers?: IncomingHttpHeaders\n}\n\nexport type SocketServerLifecycleStage =\n | 'server_init'\n | 'connection_listener_installed'\n | 'connection_init'\n | 'connection_handlers_attached'\n | 'connection_cleanup'\n | 'destroy_start'\n | 'destroy_complete'\n | 'connection_cleanup_fallback'\n\nexport type SocketServerHeartbeatPhase = 'ping' | 'pong' | 'skip'\n\nexport type SocketServerDebugEvent =\n | {\n type: 'register'\n action: 'register' | 'unregister'\n event: string\n msg?: string\n }\n | {\n type: 'handler'\n phase:\n | 'receive'\n | 'validation_error'\n | 'handler_success'\n | 'handler_error'\n event: string\n socketId?: string\n nsp?: string\n rooms?: string[]\n raw?: unknown\n issues?: any[]\n error?: unknown\n details?: Record<string, unknown>\n }\n | {\n type: 'emit'\n event: string\n rooms: string[]\n envelope?: unknown\n error?: {\n reason: string\n message?: string\n issues?: unknown\n }\n metadata?: unknown\n }\n | {\n type: 'rooms'\n action: 'join' | 'leave'\n rooms?: string | string[]\n socketId: string\n phase?: string\n payload?: unknown\n issues?: any[]\n }\n | {\n type: 'heartbeat'\n phase: SocketServerHeartbeatPhase\n socketId: string\n payload?: unknown\n issues?: any[]\n error?: boolean\n details?: Record<string, unknown>\n }\n | {\n type: 'config'\n socketId: string\n nsp: string\n snapshot: SocketServerConfigSnapshot\n }\n | {\n type: 'lifecycle'\n stage: SocketServerLifecycleStage\n socketId?: string\n nsp?: string\n details?: Record<string, unknown>\n }\n\nexport type SocketDebugOptions = {\n verbose?: boolean\n /** filters event-based logs (register/handler/emit) by event name */\n only?: string[]\n logger?: (e: SocketServerDebugEvent) => void\n} & {\n [P in SocketServerDebugEvent['type']]?: boolean\n}\n\nexport function createDebugger(options?: SocketDebugOptions) {\n const debug = options ?? {}\n\n return (maybeEvent: string | null, e: SocketServerDebugEvent) => {\n if (!debug.logger) return\n if (!debug[e.type]) return\n\n // only filter applies to event-shaped logs\n if (\n debug.only &&\n maybeEvent &&\n (e.type === 'register' || e.type === 'handler' || e.type === 'emit') &&\n !debug.only.includes(maybeEvent)\n ) {\n return\n }\n\n debug.logger(e)\n }\n}\n","// socket.server.sys.ts\nimport type { Socket } from 'socket.io'\nimport { z } from 'zod'\nimport type {\n EventMap,\n Payload,\n SocketConnectionConfigOutput,\n SocketSchemaOutput,\n SysEventName,\n} from '@emeryld/rrroutes-contract'\nimport type {\n SocketServerConfigSnapshot,\n SocketServerDebugEvent,\n} from './socket.server.debug'\nimport type { HandlerCtxNoAck } from './socket.server.types'\n\nexport type SocketConnectionHelper<Events extends EventMap> = {\n emit<K extends keyof Events & string>(\n event: K,\n payload: Payload<Events, K>,\n metadata?: Record<string, unknown>,\n onAck?: (ack: unknown) => void,\n ): void\n}\n\n/** Heartbeat configuration that is not tied to payload shapes (which live in sys event schemas). */\nexport type HeartbeatServerOptions = {\n /** Enable/disable built-in heartbeat handling. Defaults to true. */\n enabled?: boolean\n}\n\nexport type SysServerEventMap<\n Config extends SocketConnectionConfigOutput = SocketConnectionConfigOutput,\n Events extends EventMap = EventMap,\n> = {\n 'sys:connect': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n /**\n * Call to proceed with the default connection initialization\n * (attaches heartbeat, join, leave and disconnect handlers).\n */\n complete: () => void\n }) => void | Promise<void>\n\n 'sys:disconnect': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n /** cleans up all handlers */\n cleanup: () => void\n reason: string\n }) => void | Promise<void>\n\n 'sys:ping': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n ping: SocketSchemaOutput<Config['pingPayload']>\n ctx: HandlerCtxNoAck\n }) =>\n | SocketSchemaOutput<Config['pongPayload']>\n | Promise<SocketSchemaOutput<Config['pongPayload']>>\n\n 'sys:room_join': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n rooms: string[]\n meta: SocketSchemaOutput<Config['joinMetaMessage']>\n join: (room: string) => Promise<void>\n }) => void | Promise<void>\n\n 'sys:room_leave': (args: {\n socket: Socket\n helper: SocketConnectionHelper<Events>\n rooms: string[]\n meta: SocketSchemaOutput<Config['leaveMetaMessage']>\n leave: (room: string) => Promise<void>\n }) => void | Promise<void>\n}\n\nconst normalizeError = (error: unknown) => {\n if (error instanceof Error) {\n return { name: error.name, message: error.message }\n }\n if (typeof error === 'string') return { message: error }\n return { message: 'Unknown error' }\n}\n\nconst roomValueSchema = z.union([z.string(), z.array(z.string())])\n\nconst buildRoomPayloadSchema = <Meta extends z.ZodTypeAny>(metaSchema: Meta) =>\n z.object({\n rooms: roomValueSchema,\n meta: metaSchema,\n })\n\ntype DebugFn = (maybeEvent: string | null, e: SocketServerDebugEvent) => void\n\nconst toArray = (rooms?: string[] | string): string[] =>\n rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms]\n\nconst snapshotSocketConfig = (socket: Socket): SocketServerConfigSnapshot => {\n const conn = socket.conn as\n | {\n transport?: { name?: string }\n protocol?: string | number\n remoteAddress?: string\n }\n | undefined\n const protocol = conn?.protocol\n return {\n url: socket.handshake.url,\n transport: conn?.transport?.name,\n protocol: protocol != null ? String(protocol) : undefined,\n address: conn?.remoteAddress ?? socket.handshake.address,\n issued: socket.handshake.issued,\n time: socket.handshake.time,\n query: socket.handshake.query as Record<string, unknown>,\n auth: socket.handshake.auth as Record<string, unknown>,\n headers: socket.handshake.headers,\n }\n}\n\nexport function createBuiltInConnectionHandlers<\n C extends SocketConnectionConfigOutput,\n Events extends EventMap,\n>(opts: {\n heartbeat?: HeartbeatServerOptions\n sys: SysServerEventMap<C, Events>\n dbg: DebugFn\n config: C\n createCtx: (socket: Socket) => HandlerCtxNoAck\n debugVerbose?: boolean\n createHelper: (socket: Socket) => SocketConnectionHelper<Events>\n}) {\n const { heartbeat, sys, dbg, config, createCtx, debugVerbose, createHelper } =\n opts\n\n const roomJoinEvent: SysEventName = 'sys:room_join'\n const roomLeaveEvent: SysEventName = 'sys:room_leave'\n const pingEvent: SysEventName = 'sys:ping'\n const pongEvent: SysEventName = 'sys:pong'\n const heartbeatEnabled = heartbeat?.enabled !== false\n\n const joinPayloadSchema = buildRoomPayloadSchema(config.joinMetaMessage)\n const leavePayloadSchema = buildRoomPayloadSchema(config.leaveMetaMessage)\n const pingPayloadSchema = config.pingPayload as C['pingPayload']\n const pongPayloadSchema = config.pongPayload as C['pongPayload']\n\n const sysEvents = sys\n const getSysEvent = <\n K extends keyof SysServerEventMap<C, Events> & SysEventName,\n >(\n name: K,\n ) => sysEvents[name]\n\n /** Track per-socket teardown for built-in handlers to ensure explicit cleanup on destroy(). */\n const socketTeardowns = new WeakMap<Socket, (reason: string) => void>()\n\n const builtInConnectionListener = (socket: Socket) => {\n const helper = createHelper(socket)\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_init',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: {\n rooms: Array.from(socket.rooms),\n handshakeIssued: socket.handshake.issued,\n },\n })\n dbg(null, {\n type: 'config',\n socketId: socket.id,\n nsp: socket.nsp.name,\n snapshot: snapshotSocketConfig(socket),\n })\n\n const defaultConnect = () => {\n const includeRaw = debugVerbose === true\n\n // built-in room handlers (wrapped with sys:room_join / sys:room_leave)\n const joinHandler = async (msg: unknown) => {\n dbg(roomJoinEvent, {\n type: 'rooms',\n phase: 'receive',\n action: 'join',\n socketId: socket.id,\n payload: msg,\n })\n const parsed = joinPayloadSchema.safeParse(msg)\n\n if (!parsed.success) {\n socket.emit(`${roomJoinEvent}:error`, {\n eventName: roomJoinEvent,\n issues: parsed.error.issues,\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n action: 'join',\n phase: 'validation_error',\n socketId: socket.id,\n issues: parsed.error.issues,\n payload: msg,\n })\n return\n }\n const list = toArray(parsed.data.rooms)\n\n const join = async (room: string) => {\n await socket.join(room)\n dbg(null, {\n type: 'rooms',\n action: 'join',\n rooms: room,\n socketId: socket.id,\n })\n }\n\n const run = async () => {\n await getSysEvent('sys:room_join')({\n socket,\n helper,\n rooms: list,\n meta: parsed.data.meta as SocketSchemaOutput<C['joinMetaMessage']>,\n join,\n })\n }\n\n try {\n await run()\n } catch (error) {\n socket.emit(`${roomJoinEvent}:error`, {\n error: normalizeError(error),\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n action: 'join',\n phase: 'handler_error',\n payload: includeRaw\n ? { rooms: list, meta: parsed.data.meta }\n : undefined,\n socketId: socket.id,\n issues: [error],\n })\n }\n }\n\n const leaveHandler = async (msg: unknown) => {\n dbg(roomLeaveEvent, {\n type: 'rooms',\n phase: 'receive',\n action: 'leave',\n socketId: socket.id,\n payload: msg,\n })\n const parsed = leavePayloadSchema.safeParse(msg)\n if (!parsed.success) {\n socket.emit(`${roomLeaveEvent}:error`, {\n eventName: roomLeaveEvent,\n issues: parsed.error.issues,\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n action: 'leave',\n phase: 'validation_error',\n socketId: socket.id,\n issues: parsed.error.issues,\n payload: msg,\n })\n return\n }\n\n const list = toArray(parsed.data.rooms)\n\n const leave = async (room: string) => {\n await socket.leave(room)\n dbg(null, {\n type: 'rooms',\n action: 'leave',\n rooms: room,\n socketId: socket.id,\n })\n }\n\n const run = async () => {\n await getSysEvent('sys:room_leave')({\n socket,\n helper,\n rooms: list,\n meta: parsed.data.meta as SocketSchemaOutput<C['leaveMetaMessage']>,\n leave,\n })\n }\n\n try {\n await run()\n } catch (error) {\n socket.emit(`${roomLeaveEvent}:error`, {\n error: normalizeError(error),\n })\n dbg(roomJoinEvent, {\n type: 'rooms',\n phase: 'handler_error',\n payload: { rooms: list, meta: parsed.data.meta },\n socketId: socket.id,\n issues: [error],\n action: 'join',\n })\n }\n }\n\n // heartbeat, wrapped with sys:ping/sys:pong\n const pingHandler = async (msg: unknown) => {\n if (!heartbeatEnabled) {\n dbg(null, {\n type: 'heartbeat',\n phase: 'skip',\n socketId: socket.id,\n details: { reason: 'heartbeat_disabled' },\n error: false,\n })\n return\n }\n\n const parsedPing = pingPayloadSchema.safeParse(msg)\n if (!parsedPing.success) {\n socket.emit(`${pingEvent}:error`, {\n eventName: pingEvent,\n issues: parsedPing.error.issues,\n })\n dbg(null, {\n type: 'heartbeat',\n phase: 'ping',\n socketId: socket.id,\n payload: includeRaw ? msg : undefined,\n issues: parsedPing.error.issues,\n error: true,\n details: { step: 'parse' },\n })\n return\n }\n const ctx = createCtx(socket)\n\n dbg(null, {\n type: 'heartbeat',\n phase: 'ping',\n socketId: socket.id,\n payload: parsedPing.data,\n error: false,\n })\n\n let pongPayload: SocketSchemaOutput<C['pongPayload']>\n try {\n pongPayload = await getSysEvent('sys:ping')({\n ping: parsedPing.data as SocketSchemaOutput<C['pingPayload']>,\n ctx,\n socket,\n helper,\n })\n } catch (error) {\n socket.emit(`${pingEvent}:error`, { error: normalizeError(error) })\n dbg(null, {\n type: 'heartbeat',\n phase: 'ping',\n socketId: socket.id,\n payload: parsedPing.data,\n error: true,\n details: { step: 'sys_handler_error' },\n })\n return\n }\n\n const parsedPong = pongPayloadSchema.safeParse(pongPayload)\n if (!parsedPong.success) {\n socket.emit(`${pongEvent}:error`, {\n eventName: pongEvent,\n issues: parsedPong.error.issues,\n })\n dbg(null, {\n type: 'heartbeat',\n phase: 'pong',\n socketId: socket.id,\n payload: includeRaw ? pongPayload : undefined,\n issues: parsedPong.error.issues,\n error: true,\n details: { step: 'parse' },\n })\n return\n }\n socket.emit(pongEvent, parsedPong.data)\n dbg(null, {\n type: 'heartbeat',\n phase: 'pong',\n socketId: socket.id,\n payload: parsedPong.data,\n error: false,\n })\n }\n\n // attach built-in handlers\n socket.on(roomJoinEvent, joinHandler)\n socket.on(roomLeaveEvent, leaveHandler)\n if (heartbeatEnabled) {\n socket.on(pingEvent, pingHandler)\n }\n\n const cleanup = (reason: string) => {\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_cleanup',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: { reason },\n })\n socket.off(roomJoinEvent, joinHandler)\n socket.off(roomLeaveEvent, leaveHandler)\n if (heartbeatEnabled) {\n socket.off(pingEvent, pingHandler)\n }\n }\n\n socketTeardowns.set(socket, cleanup)\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_handlers_attached',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: {\n heartbeatEnabled,\n joinEvent: roomJoinEvent,\n leaveEvent: roomLeaveEvent,\n pingEvent: heartbeatEnabled ? pingEvent : undefined,\n },\n })\n\n socket.once('disconnect', (reason) => {\n dbg('sys:disconnect', {\n type: 'lifecycle',\n stage: 'connection_cleanup',\n nsp: socket.nsp.name,\n socketId: socket.id,\n details: { reason },\n })\n const defaultDisconnect = () => {\n cleanup(reason)\n socketTeardowns.delete(socket)\n }\n getSysEvent('sys:disconnect')({\n socket,\n helper,\n reason: String(reason),\n cleanup: defaultDisconnect,\n })\n })\n }\n getSysEvent('sys:connect')({\n socket,\n helper,\n complete: defaultConnect,\n })\n }\n\n return {\n builtInConnectionListener,\n socketTeardowns,\n roomJoinEvent,\n roomLeaveEvent,\n pingEvent,\n }\n}\n","// socket.server.index.ts\nimport { Server, Socket } from 'socket.io'\nimport { z } from 'zod'\nimport type {\n EventMap,\n SocketConnectionConfigOutput,\n Payload,\n} from '@emeryld/rrroutes-contract'\nimport { createDebugger } from './socket.server.debug'\nimport type {\n SocketServerDebugEvent,\n SocketDebugOptions,\n} from './socket.server.debug'\nimport { createBuiltInConnectionHandlers } from './socket.server.sys'\nimport type {\n HeartbeatServerOptions,\n SocketConnectionHelper,\n SysServerEventMap,\n} from './socket.server.sys'\nimport type { HandlerCtx, HandlerCtxNoAck } from './socket.server.types'\n\nconst createBaseHandlerCtx = (socket: Socket): HandlerCtxNoAck => ({\n sentAt: new Date(),\n socket,\n socketId: socket.id,\n nsp: socket.nsp.name,\n rooms: Array.from(socket.rooms),\n user: socket.data?.user,\n scopes: socket.data?.scopes,\n})\n\nconst normalizeError = (error: unknown, verbose?: boolean) => {\n if (error instanceof Error) {\n return {\n name: error.name,\n message: error.message,\n stack: verbose ? error.stack : undefined,\n }\n }\n if (typeof error === 'string') return { message: error }\n if (typeof error === 'object' && error !== null) {\n return verbose ? error : { message: 'Unknown error' }\n }\n return { message: String(error) }\n}\n\nexport interface SocketConnection<T extends EventMap> {\n on<K extends keyof T & string>(\n eventName: K,\n handler: (payload: Payload<T, K>, ctx: HandlerCtx) => void | Promise<void>,\n ): () => void\n\n off<K extends keyof T & string>(eventName: K): void\n\n emit<K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n toRooms?: string[] | string,\n metadata?: Record<string, unknown>,\n onAck?: (ack: unknown) => void,\n ): void\n\n /** Dispose all listeners, timers, and room memberships created by this instance. */\n destroy(): void\n}\n\nexport function createSocketConnections<\n T extends EventMap,\n TConfig extends SocketConnectionConfigOutput = SocketConnectionConfigOutput,\n>(\n io: Server,\n events: T,\n opts: {\n debug?: SocketDebugOptions\n heartbeat?: HeartbeatServerOptions\n /** System event customization (connect / disconnect / ping / pong / room join/leave) */\n sys: SysServerEventMap<TConfig, T>\n config: TConfig\n },\n): SocketConnection<T> {\n const dbg = createDebugger(opts?.debug)\n const socketConfig = opts.config\n const heartbeatEnabled = opts?.heartbeat?.enabled !== false\n const eventNames = Object.keys(events)\n dbg(null, {\n type: 'lifecycle',\n stage: 'server_init',\n details: {\n prefinedEvents: eventNames,\n heartbeatEnabled,\n path: io?.path(),\n namespaces: Array.from(io._nsps.keys()),\n transport: io?._opts.transports,\n sysEvents: Object.keys(opts.sys ?? {}),\n },\n })\n\n const getSchema = <K extends keyof T & string>(k: K) => events[k].message\n const toArray = (rooms?: string[] | string): string[] =>\n rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms]\n const emitToTargets = <K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n targets: string[],\n metadata?: Record<string, unknown>,\n ) => {\n const schema = getSchema(eventName)\n const check = schema.safeParse(payload)\n if (!check.success) {\n dbg(String(eventName), {\n type: 'emit',\n event: String(eventName),\n rooms: targets,\n ...(opts?.debug?.verbose ? { attemptedPayload: payload } : {}),\n error: {\n reason: 'invalid_payload',\n message: check.error.message,\n issues: check.error.issues,\n },\n metadata,\n })\n throw new Error(\n `Invalid payload for \"${String(eventName)}\": ${check.error.message}`,\n )\n }\n\n const envelope = {\n eventName,\n sentAt: new Date(),\n sentTo: targets,\n data: check.data as Payload<T, K>,\n metadata: metadata ?? {},\n }\n\n if (targets.length === 0) io.emit(String(eventName), envelope)\n else if (targets.length === 1) {\n const sid = targets[0]!\n const sock = io.sockets.sockets.get(sid as any)\n if (sock) {\n sock.emit(String(eventName), envelope)\n } else {\n io.to(targets).emit(String(eventName), envelope)\n }\n } else {\n io.to(targets).emit(String(eventName), envelope)\n }\n\n dbg(String(eventName), {\n type: 'emit',\n event: String(eventName),\n rooms: targets,\n envelope: opts?.debug?.verbose ? envelope : undefined,\n })\n }\n const createSocketHelper = (socket: Socket): SocketConnectionHelper<T> => ({\n emit<K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n metadata?: Record<string, unknown>,\n ) {\n emitToTargets(eventName, payload, [socket.id], metadata)\n },\n })\n\n // registrations\n const registrations = new Map<\n string,\n Set<{\n connectionListener: (socket: Socket) => void\n socketListeners: WeakMap<Socket, (raw: unknown) => void>\n }>\n >()\n\n const addRegistration = (\n eventName: string,\n reg: {\n connectionListener: (socket: Socket) => void\n socketListeners: WeakMap<Socket, (raw: unknown) => void>\n },\n ) => {\n let set = registrations.get(eventName)\n if (!set) {\n set = new Set()\n registrations.set(eventName, set)\n }\n set.add(reg)\n }\n\n const removeAllForEvent = (eventName: string) => {\n const set = registrations.get(eventName)\n if (!set) {\n dbg(null, {\n type: 'register',\n event: eventName,\n action: 'unregister',\n msg: 'no handlers registered',\n })\n return\n }\n for (const reg of set) {\n io.off('connection', reg.connectionListener)\n for (const socket of io.sockets.sockets.values()) {\n const wrapped = reg.socketListeners.get(socket)\n if (wrapped) socket.off(String(eventName), wrapped)\n }\n }\n registrations.delete(eventName)\n dbg(eventName, {\n type: 'register',\n action: 'unregister',\n event: eventName,\n msg: 'unregistered',\n })\n }\n\n const {\n builtInConnectionListener,\n socketTeardowns,\n roomJoinEvent,\n roomLeaveEvent,\n pingEvent,\n } = createBuiltInConnectionHandlers<TConfig, T>({\n heartbeat: opts?.heartbeat,\n sys: opts.sys,\n dbg,\n config: socketConfig,\n createCtx: createBaseHandlerCtx,\n debugVerbose: opts?.debug?.verbose === true,\n createHelper: createSocketHelper,\n })\n\n // install built-in connection listener\n io.on('connection', builtInConnectionListener)\n\n const conn = {\n on<K extends keyof T & string>(\n eventName: K,\n handler: (\n payload: Payload<T, K>,\n ctx: HandlerCtx,\n ) => void | Promise<void>,\n ): () => void {\n const socketListeners = new WeakMap<Socket, (raw: unknown) => void>()\n\n const connectionListener = (socket: Socket) => {\n const wrapped = async (raw: unknown) => {\n const schema = getSchema(eventName)\n const parsed = schema.safeParse(raw)\n\n const ctx = createBaseHandlerCtx(socket)\n\n dbg(String(eventName), {\n type: 'handler',\n phase: 'receive',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n rooms: ctx.rooms,\n raw: opts?.debug?.verbose ? raw : undefined,\n })\n\n if (!parsed.success) {\n socket.emit(`${String(eventName)}:error`, {\n eventName,\n sentAt: ctx.sentAt,\n issues: parsed.error.issues,\n })\n dbg(String(eventName), {\n type: 'handler',\n phase: 'validation_error',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n issues: parsed.error.issues,\n })\n return\n }\n\n try {\n await handler(parsed.data as Payload<T, K>, ctx)\n dbg(String(eventName), {\n type: 'handler',\n phase: 'handler_success',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n rooms: ctx.rooms,\n })\n } catch (error) {\n dbg(String(eventName), {\n type: 'handler',\n phase: 'handler_error',\n event: String(eventName),\n socketId: ctx.socketId,\n nsp: ctx.nsp,\n rooms: ctx.rooms,\n error,\n })\n socket.emit(`${String(eventName)}:error`, {\n eventName,\n sentAt: ctx.sentAt,\n error: normalizeError(error, opts?.debug?.verbose),\n })\n }\n }\n\n socketListeners.set(socket, wrapped)\n socket.on(String(eventName), wrapped)\n socket.once('disconnect', () => {\n const w = socketListeners.get(socket)\n if (w) socket.off(String(eventName), w)\n })\n }\n\n io.on('connection', connectionListener)\n addRegistration(String(eventName), {\n connectionListener,\n socketListeners,\n })\n dbg(String(eventName), {\n type: 'register',\n action: 'register',\n event: String(eventName),\n })\n\n return () => {\n const set = registrations.get(String(eventName))\n if (!set) {\n dbg(null, {\n type: 'register',\n action: 'unregister',\n event: String(eventName),\n msg: `No registration under ${eventName}`,\n })\n return\n }\n for (const reg of Array.from(set)) {\n if (reg.connectionListener === connectionListener) {\n io.off('connection', reg.connectionListener)\n for (const socket of io.sockets.sockets.values()) {\n const wrapped = reg.socketListeners.get(socket)\n if (wrapped) socket.off(String(eventName), wrapped)\n }\n set.delete(reg)\n break\n }\n }\n if (set.size === 0) registrations.delete(String(eventName))\n dbg(String(eventName), {\n type: 'register',\n action: 'unregister',\n event: String(eventName),\n })\n }\n },\n\n off<K extends keyof T & string>(eventName: K): void {\n removeAllForEvent(String(eventName))\n },\n\n emit<K extends keyof T & string>(\n eventName: K,\n payload: Payload<T, K>,\n rooms?: string[] | string,\n metadata?: Record<string, unknown>,\n ): void {\n const targets = toArray(rooms)\n emitToTargets(eventName, payload, targets, metadata)\n },\n\n destroy(): void {\n dbg(null, {\n type: 'lifecycle',\n stage: 'destroy_start',\n details: {\n socketCount: io.sockets.sockets.size,\n registrationCount: registrations.size,\n },\n })\n // 1) Remove built-in connection listener so no new sockets get handlers\n io.off('connection', builtInConnectionListener)\n\n // 2) Cleanup built-in handlers for all current sockets and leave rooms\n for (const socket of io.sockets.sockets.values()) {\n const cleanup = socketTeardowns.get(socket)\n if (cleanup) {\n cleanup('destroy')\n socketTeardowns.delete(socket)\n } else {\n dbg(null, {\n type: 'lifecycle',\n stage: 'connection_cleanup_fallback',\n socketId: socket.id,\n nsp: socket.nsp.name,\n details: { reason: 'teardown_missing' },\n })\n // Fallback if socket was attached before map population\n try {\n socket.removeAllListeners(roomJoinEvent)\n socket.removeAllListeners(roomLeaveEvent)\n socket.removeAllListeners(pingEvent)\n } catch {\n // noop\n }\n }\n }\n\n // 3) Remove all user-registered event listeners and their connection hooks\n for (const eventName of Array.from(registrations.keys())) {\n removeAllForEvent(eventName)\n }\n\n // 4) Defensive: clear any residual maps\n registrations.clear()\n dbg(null, {\n type: 'lifecycle',\n stage: 'destroy_complete',\n details: {\n socketCount: io.sockets.sockets.size,\n registrationCount: registrations.size,\n },\n })\n },\n } as const satisfies SocketConnection<T>\n\n return conn\n}\n\nexport type { EventMap, Payload }\nexport type { HandlerCtx } from './socket.server.types'\nexport type {\n SocketServerDebugEvent,\n SocketDebugOptions,\n SocketServerConfigSnapshot,\n SocketServerLifecycleStage,\n SocketServerHeartbeatPhase,\n} from './socket.server.debug'\nexport type {\n HeartbeatServerOptions,\n SocketConnectionHelper,\n SysServerEventMap,\n} from './socket.server.sys'\n","import type { IncomingHttpHeaders } from 'http'\nimport type { Socket } from 'socket.io'\n\nexport type ConnectionMiddlewareStage = 'incoming'\n\nexport type ConnectionMiddlewareContext = {\n socketId?: string\n nsp?: string\n rooms: string[]\n user?: unknown\n scopes?: string[]\n address?: string\n transport?: string\n protocol?: string\n handshake: {\n url?: string\n issued?: number\n time?: string\n query?: Record<string, unknown>\n auth?: Record<string, unknown>\n headers?: IncomingHttpHeaders\n }\n}\n\nexport type ConnectionMiddlewareEvent = {\n type: 'connection'\n stage: ConnectionMiddlewareStage\n timestamp: Date\n context: ConnectionMiddlewareContext\n}\n\nexport type ConnectionLoggingMiddlewareOptions = {\n /**\n * Custom logger invoked with the structured event.\n * Defaults to console.info.\n */\n logger?: (event: ConnectionMiddlewareEvent) => void\n /**\n * Include raw headers from the handshake. Defaults to false to avoid leaking PII.\n */\n includeHeaders?: boolean\n /**\n * List of auth keys that should be redacted (case-insensitive). Defaults to ['authorization'].\n */\n redactAuthKeys?: string[]\n}\n\nconst defaultRedactedValue = '[REDACTED]'\n\nconst defaultLogger = (event: ConnectionMiddlewareEvent) => {\n const {\n stage,\n context: { socketId, nsp, address, transport, handshake },\n } = event\n // eslint-disable-next-line no-console\n console.info('[socket-connection]', {\n stage,\n socketId,\n nsp,\n address,\n transport,\n url: handshake.url,\n query: handshake.query,\n auth: handshake.auth,\n })\n}\n\nconst redactAuth = (\n auth: Record<string, unknown> | undefined,\n redactKeys: Set<string>,\n): Record<string, unknown> | undefined => {\n if (!auth) return undefined\n if (redactKeys.size === 0) return auth\n\n const clone: Record<string, unknown> = {}\n for (const [key, value] of Object.entries(auth)) {\n const normalizedKey = key.toLowerCase()\n clone[key] = redactKeys.has(normalizedKey) ? defaultRedactedValue : value\n }\n return clone\n}\n\nconst buildContext = (\n socket: Socket,\n includeHeaders: boolean,\n redactKeys: Set<string>,\n): ConnectionMiddlewareContext => {\n const conn = socket.conn as\n | {\n remoteAddress?: string\n transport?: { name?: string }\n protocol?: string | number\n }\n | undefined\n\n const handshake = socket.handshake ?? {}\n\n const protocolValue = conn?.protocol\n\n return {\n socketId: socket.id,\n nsp: socket.nsp?.name,\n rooms: Array.from(socket.rooms ?? []),\n user: (socket.data as any)?.user,\n scopes: (socket.data as any)?.scopes,\n address: conn?.remoteAddress ?? (handshake as any).address,\n transport: conn?.transport?.name,\n protocol: protocolValue != null ? String(protocolValue) : undefined,\n handshake: {\n url: handshake.url,\n issued: handshake.issued,\n time: handshake.time,\n query: handshake.query as Record<string, unknown>,\n auth: redactAuth(handshake.auth as Record<string, unknown>, redactKeys),\n headers: includeHeaders\n ? (handshake.headers as IncomingHttpHeaders)\n : undefined,\n },\n }\n}\n\nexport const createConnectionLoggingMiddleware = (\n options: ConnectionLoggingMiddlewareOptions = {},\n) => {\n const logger = options.logger ?? defaultLogger\n const includeHeaders = options.includeHeaders ?? false\n const redactKeys = new Set(\n (options.redactAuthKeys ?? ['authorization', 'token']).map((key) =>\n key.toLowerCase(),\n ),\n )\n\n return (socket: Socket, next: (err?: Error) => void) => {\n const context = buildContext(socket, includeHeaders, redactKeys)\n logger({\n type: 'connection',\n stage: 'incoming',\n timestamp: new Date(),\n context,\n })\n next()\n }\n}\n\nexport type ConnectionLoggingMiddleware = ReturnType<\n typeof createConnectionLoggingMiddleware\n>\n"],"mappings":"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","names":["keyOf","normalizeError","toArray"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@emeryld/rrroutes-server",
|
|
3
|
-
"version": "2.3.
|
|
3
|
+
"version": "2.3.15",
|
|
4
4
|
"private": false,
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.cjs",
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
"dist"
|
|
18
18
|
],
|
|
19
19
|
"dependencies": {
|
|
20
|
-
"@emeryld/rrroutes-contract": "^2.4.
|
|
20
|
+
"@emeryld/rrroutes-contract": "^2.4.19",
|
|
21
21
|
"jose": "^6.1.3",
|
|
22
22
|
"socket.io": "^4.8.1",
|
|
23
23
|
"zod": "^4.1.13"
|