@cjanietz/cls-rtracer/index.d.ts

Express & Koa middlewares and Fastify & Hapi plugins for CLS-based request id generation, batteries included

import { Request, Handler } from "express";
import { Context, Middleware } from "koa";
import { IncomingMessage, ServerResponse } from 'http'

export type RequestIdFactory<T> = (req: T) => unknown

export interface IOptions<RequestType = unknown> {
  // Default: false
  echoHeader?: boolean
  // Default: false
  useHeader?: boolean
  // Default: 'X-Request-Id'
  headerName?: string
  // Default: UUID v1
  requestIdFactory?: RequestIdFactory<RequestType>
}

export interface IFastifyOptions {
  // Default: false
  echoHeader?: boolean
  // Default: false
  useHeader?: boolean
  // Default: 'X-Request-Id'
  headerName?: string
  // Default: false
  useFastifyRequestId?: boolean
  // Default: UUID v1
  requestIdFactory?: RequestIdFactory<unknown>
}

export interface IHapiPlugin<T> {
  name: string
  once: boolean
  register: (server: any, options: T) => void | Promise<void>
}

export declare const expressMiddleware: (
  options?: IOptions<Request>,
) => Handler;

export declare const fastifyPlugin: (
  fastify: any,
  options: IFastifyOptions,
  done: (err?: any) => void,
) => void

export declare const fastifyMiddleware: (
  options?: IOptions,
) => (
  req: IncomingMessage,
  res: ServerResponse,
  next: (err?: any) => void,
) => void

export declare const koaMiddleware: (
  options?: IOptions<Context>,
) => Middleware;

export declare const koaV1Middleware: (
  options?: IOptions,
) => GeneratorFunction

export declare const hapiPlugin: IHapiPlugin<IOptions>

export declare function runWithId<T>(fn: () => T, id?: unknown): T

export declare const id: () => unknown | undefined