expressentials 0.0.1

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/status/index.ts","../src/message/index.ts","../src/errors/api-error.ts","../src/errors/http-error.ts","../src/logger/index.ts","../src/context/index.ts","../src/middleware/error-handler.ts","../src/middleware/request-id.ts","../src/middleware/request-context.ts","../src/middleware/http-logger.ts","../src/middleware/validate.ts","../src/middleware/async-handler.ts","../src/middleware/timeout.ts","../src/middleware/health-check.ts"],"sourcesContent":["export { status } from \"./status/index.js\";\nexport { message } from \"./message/index.js\";\nexport { ApiError } from \"./errors/api-error.js\";\nexport {\n  NotFound,\n  BadRequest,\n  Unauthorized,\n  Forbidden,\n  Conflict,\n  InternalServerError,\n  ServiceUnavailable,\n  TooManyRequests,\n  ValidationError,\n  GatewayTimeout,\n} from \"./errors/http-error.js\";\nexport { Logger, createLogger } from \"./logger/index.js\";\nexport { getRequestContext, getLogger, getRequestId, runWithContext } from \"./context/index.js\";\nexport {\n  errorHandler,\n  requestId,\n  requestContext,\n  httpLogger,\n  validate,\n  asyncHandler,\n  timeout,\n  healthCheck,\n} from \"./middleware/index.js\";\n","export const status = {\n  // 1xx Informational\n  continue: 100,\n  switchingProtocols: 101,\n  processing: 102,\n  earlyHints: 103,\n\n  // 2xx Success\n  ok: 200,\n  created: 201,\n  accepted: 202,\n  nonAuthoritativeInformation: 203,\n  noContent: 204,\n  resetContent: 205,\n  partialContent: 206,\n\n  // 3xx Redirection\n  multipleChoices: 300,\n  movedPermanently: 301,\n  found: 302,\n  seeOther: 303,\n  notModified: 304,\n  useProxy: 305,\n  temporaryRedirect: 307,\n  permanentRedirect: 308,\n\n  // 4xx Client Error\n  badRequest: 400,\n  unauthorized: 401,\n  paymentRequired: 402,\n  forbidden: 403,\n  notFound: 404,\n  methodNotAllowed: 405,\n  notAcceptable: 406,\n  proxyAuthenticationRequired: 407,\n  requestTimeout: 408,\n  conflict: 409,\n  gone: 410,\n  lengthRequired: 411,\n  preconditionFailed: 412,\n  payloadTooLarge: 413,\n  uriTooLong: 414,\n  unsupportedMediaType: 415,\n  rangeNotSatisfiable: 416,\n  expectationFailed: 417,\n  imATeapot: 418,\n  unprocessableEntity: 422,\n  tooEarly: 425,\n  upgradeRequired: 426,\n  preconditionRequired: 428,\n  tooManyRequests: 429,\n  requestHeaderFieldsTooLarge: 431,\n  unavailableForLegalReasons: 451,\n\n  // 5xx Server Error\n  internalServerError: 500,\n  notImplemented: 501,\n  badGateway: 502,\n  serviceUnavailable: 503,\n  gatewayTimeout: 504,\n  httpVersionNotSupported: 505,\n  insufficientStorage: 507,\n  loopDetected: 508,\n  notExtended: 510,\n  networkAuthenticationRequired: 511,\n} as const;\n","export const message = {\n  // 1xx Informational\n  continue: \"Continue\",\n  switchingProtocols: \"Switching Protocols\",\n  processing: \"Processing request\",\n  earlyHints: \"Early hints available\",\n\n  // 2xx Success\n  ok: \"Success\",\n  created: \"Created successfully\",\n  accepted: \"Request accepted\",\n  nonAuthoritativeInformation: \"Non-authoritative information\",\n  noContent: \"No content\",\n  resetContent: \"Reset content\",\n  partialContent: \"Partial content\",\n\n  // 3xx Redirection\n  multipleChoices: \"Multiple redirect options available\",\n  movedPermanently: \"Resource moved permanently\",\n  found: \"Resource found elsewhere\",\n  seeOther: \"See other resource\",\n  notModified: \"Resource not modified\",\n  useProxy: \"Use proxy to access resource\",\n  temporaryRedirect: \"Resource temporarily moved\",\n  permanentRedirect: \"Resource permanently moved\",\n\n  // 4xx Client Error\n  badRequest: \"Invalid request\",\n  unauthorized: \"Authentication required\",\n  paymentRequired: \"Payment required\",\n  forbidden: \"You don't have permission to access this resource\",\n  notFound: \"Resource not found\",\n  methodNotAllowed: \"Method not allowed for this resource\",\n  notAcceptable: \"Requested format not available\",\n  proxyAuthenticationRequired: \"Proxy authentication required\",\n  requestTimeout: \"Request timed out\",\n  conflict: \"Resource conflict detected\",\n  gone: \"Resource no longer available\",\n  lengthRequired: \"Content length header is required\",\n  preconditionFailed: \"Request precondition failed\",\n  payloadTooLarge: \"Request payload exceeds size limit\",\n  uriTooLong: \"Request URI exceeds length limit\",\n  unsupportedMediaType: \"Unsupported media type\",\n  rangeNotSatisfiable: \"Requested range is not available\",\n  expectationFailed: \"Request expectation could not be met\",\n  imATeapot: \"I'm a teapot\",\n  unprocessableEntity: \"Unable to process request entity\",\n  tooEarly: \"Request sent too early, retry later\",\n  upgradeRequired: \"Protocol upgrade required\",\n  preconditionRequired: \"Precondition header is required\",\n  tooManyRequests: \"Too many requests, please slow down\",\n  requestHeaderFieldsTooLarge: \"Request headers exceed size limit\",\n  unavailableForLegalReasons: \"Resource unavailable for legal reasons\",\n\n  // 5xx Server Error\n  internalServerError: \"Something went wrong on our end\",\n  notImplemented: \"Feature not yet implemented\",\n  badGateway: \"Bad gateway response from upstream\",\n  serviceUnavailable: \"Service temporarily unavailable, try again later\",\n  gatewayTimeout: \"Upstream server timed out\",\n  httpVersionNotSupported: \"HTTP version not supported by server\",\n  insufficientStorage: \"Server has insufficient storage\",\n  loopDetected: \"Infinite request loop detected\",\n  notExtended: \"Server cannot fulfill extended request\",\n  networkAuthenticationRequired: \"Network authentication required\",\n} as const;\n","import { status } from \"../status/index.js\";\nimport { message } from \"../message/index.js\";\n\nexport class ApiError extends Error {\n  constructor(\n    public readonly statusCode: number,\n    message?: string,\n    public readonly details?: unknown,\n  ) {\n    super(message ??= getDefaultMessage(statusCode));\n    this.name = \"ApiError\";\n  }\n\n  static notFound(message?: string) {\n    return new ApiError(status.notFound, message);\n  }\n\n  static badRequest(message?: string) {\n    return new ApiError(status.badRequest, message);\n  }\n\n  static unauthorized(message?: string) {\n    return new ApiError(status.unauthorized, message);\n  }\n\n  static forbidden(message?: string) {\n    return new ApiError(status.forbidden, message);\n  }\n\n  static conflict(message?: string) {\n    return new ApiError(status.conflict, message);\n  }\n\n  static internalServerError(message?: string) {\n    return new ApiError(status.internalServerError, message);\n  }\n\n  static serviceUnavailable(message?: string) {\n    return new ApiError(status.serviceUnavailable, message);\n  }\n\n  static tooManyRequests(message?: string) {\n    return new ApiError(status.tooManyRequests, message);\n  }\n}\n\nfunction getDefaultMessage(code: number): string {\n  const entry = Object.entries(status).find(([, v]) => v === code);\n  if (!entry) return \"Error\";\n  return message[entry[0] as keyof typeof message];\n}\n","import { ApiError } from \"./api-error.js\";\n\nexport class NotFound extends ApiError {\n  constructor(message?: string) {\n    super(404, message);\n  }\n}\n\nexport class BadRequest extends ApiError {\n  constructor(message?: string) {\n    super(400, message);\n  }\n}\n\nexport class Unauthorized extends ApiError {\n  constructor(message?: string) {\n    super(401, message);\n  }\n}\n\nexport class Forbidden extends ApiError {\n  constructor(message?: string) {\n    super(403, message);\n  }\n}\n\nexport class Conflict extends ApiError {\n  constructor(message?: string) {\n    super(409, message);\n  }\n}\n\nexport class InternalServerError extends ApiError {\n  constructor(message?: string) {\n    super(500, message);\n  }\n}\n\nexport class ServiceUnavailable extends ApiError {\n  constructor(message?: string) {\n    super(503, message);\n  }\n}\n\nexport class TooManyRequests extends ApiError {\n  constructor(message?: string) {\n    super(429, message);\n  }\n}\n\nexport class ValidationError extends ApiError {\n  constructor(message?: string, details?: unknown) {\n    super(422, message ?? \"Validation failed\", details);\n  }\n}\n\nexport class GatewayTimeout extends ApiError {\n  constructor(message?: string) {\n    super(504, message);\n  }\n}\n","export type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nconst levelPriority: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nexport interface LoggerEntry {\n  level: LogLevel;\n  message?: string;\n  [key: string]: unknown;\n}\n\nexport type LogDestination = (entry: LoggerEntry) => void;\n\nexport interface LoggerOptions {\n  level?: LogLevel;\n  destination?: LogDestination;\n}\n\nconst defaultDestination: LogDestination = (entry) => {\n  console.log(JSON.stringify(entry));\n};\n\nexport class Logger {\n  private level: LogLevel;\n  private destination: LogDestination;\n  private bindings: Record<string, unknown>;\n\n  constructor(options: LoggerOptions = {}, bindings: Record<string, unknown> = {}) {\n    this.level = options.level ?? \"info\";\n    this.destination = options.destination ?? defaultDestination;\n    this.bindings = bindings;\n  }\n\n  private shouldLog(level: LogLevel): boolean {\n    return levelPriority[level] >= levelPriority[this.level];\n  }\n\n  private log(level: LogLevel, ...args: [unknown, ...unknown[]]) {\n    if (!this.shouldLog(level)) return;\n\n    let message: string | undefined;\n    let meta: Record<string, unknown> = {};\n\n    if (args.length === 1) {\n      message = String(args[0]);\n    } else if (typeof args[0] === \"object\" && args[0] !== null) {\n      meta = { ...args[0] as Record<string, unknown> };\n      message = String(args[1]);\n    } else {\n      message = String(args[0]);\n      if (args[1] !== undefined) {\n        meta = args[1] as Record<string, unknown>;\n      }\n    }\n\n    this.destination({\n      level,\n      ...this.bindings,\n      ...meta,\n      ...(message ? { message } : {}),\n    });\n  }\n\n  debug(...args: [unknown, ...unknown[]]) {\n    this.log(\"debug\", ...args);\n  }\n\n  info(...args: [unknown, ...unknown[]]) {\n    this.log(\"info\", ...args);\n  }\n\n  warn(...args: [unknown, ...unknown[]]) {\n    this.log(\"warn\", ...args);\n  }\n\n  error(...args: [unknown, ...unknown[]]) {\n    this.log(\"error\", ...args);\n  }\n\n  child(bindings: Record<string, unknown>): Logger {\n    return new Logger(\n      { level: this.level, destination: this.destination },\n      { ...this.bindings, ...bindings },\n    );\n  }\n}\n\nexport function createLogger(options?: LoggerOptions): Logger {\n  return new Logger(options);\n}\n","import { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { Logger } from \"../logger/index.js\";\n\nexport interface RequestContext {\n  requestId: string;\n  log: Logger;\n}\n\nconst storage = new AsyncLocalStorage<RequestContext>();\n\nexport function getRequestContext(): RequestContext | undefined {\n  return storage.getStore();\n}\n\nexport function getLogger(): Logger | undefined {\n  return storage.getStore()?.log;\n}\n\nexport function getRequestId(): string | undefined {\n  return storage.getStore()?.requestId;\n}\n\nexport function runWithContext(context: RequestContext, fn: () => void): void {\n  storage.run(context, fn);\n}\n\nexport { storage };\n","import type { Request, Response, NextFunction } from \"express\";\nimport { ApiError } from \"../errors/api-error.js\";\nimport { message } from \"../message/index.js\";\n\nexport interface ErrorHandlerOptions {\n  log?: boolean;\n}\n\nexport function errorHandler(options: ErrorHandlerOptions = {}) {\n  const log = options.log ?? true;\n\n  return (err: unknown, _req: Request, res: Response, _next: NextFunction): void => {\n    if (err instanceof ApiError) {\n      res.status(err.statusCode).json({\n        error: {\n          message: err.message,\n          statusCode: err.statusCode,\n          ...(err.details !== undefined && { details: err.details }),\n        },\n      });\n      return;\n    }\n\n    if (log) {\n      console.error(err);\n    }\n\n    res.status(500).json({\n      error: {\n        message: message.internalServerError,\n        statusCode: 500,\n      },\n    });\n  };\n}\n","import type { Request, Response, NextFunction } from \"express\";\nimport crypto from \"node:crypto\";\n\ndeclare global {\n  namespace Express {\n    interface Request {\n      requestId: string;\n    }\n  }\n}\n\nexport interface RequestIdOptions {\n  header?: string;\n  generator?: () => string;\n  respectExisting?: boolean;\n}\n\nexport function requestId(options: RequestIdOptions = {}) {\n  const {\n    header = \"x-request-id\",\n    generator = crypto.randomUUID,\n    respectExisting = true,\n  } = options;\n\n  return (req: Request, res: Response, next: NextFunction): void => {\n    const existing = req.get(header);\n    const id = existing && respectExisting ? existing : generator();\n\n    req.requestId = id;\n    res.setHeader(header, id);\n    next();\n  };\n}\n","import type { Request, Response, NextFunction } from \"express\";\nimport { Logger } from \"../logger/index.js\";\nimport { runWithContext } from \"../context/index.js\";\n\ndeclare global {\n  namespace Express {\n    interface Request {\n      log: Logger;\n    }\n  }\n}\n\nexport interface RequestContextOptions {\n  logger?: Logger;\n}\n\nexport function requestContext(options: RequestContextOptions = {}) {\n  const logger = options.logger ?? new Logger();\n\n  return (req: Request, _res: Response, next: NextFunction): void => {\n    const scoped = logger.child({ requestId: req.requestId });\n    req.log = scoped;\n\n    runWithContext({ requestId: req.requestId, log: scoped }, () => {\n      next();\n    });\n  };\n}\n","import type { Request, Response, NextFunction } from \"express\";\n\nexport interface HttpLoggerOptions {\n  skip?: (req: Request, res: Response) => boolean;\n}\n\nexport function httpLogger(options: HttpLoggerOptions = {}) {\n  const { skip } = options;\n\n  return (req: Request, res: Response, next: NextFunction): void => {\n    if (skip?.(req, res)) {\n      next();\n      return;\n    }\n\n    const start = Date.now();\n\n    res.on(\"finish\", () => {\n      req.log.info({\n        method: req.method,\n        path: req.originalUrl ?? req.url,\n        status: res.statusCode,\n        durationMs: Date.now() - start,\n      });\n    });\n\n    next();\n  };\n}\n","import type { Request, Response, NextFunction } from \"express\";\nimport { ValidationError } from \"../errors/http-error.js\";\n\nexport interface Schema {\n  parse: (data: unknown) => unknown;\n}\n\nexport interface ValidationSchemas {\n  body?: Schema;\n  params?: Schema;\n  query?: Schema;\n}\n\nexport interface ValidationIssue {\n  path: (string | number)[];\n  message: string;\n  code?: string;\n}\n\nexport type IssueFormatter = (error: unknown) => ValidationIssue[];\n\nfunction defaultFormatter(error: unknown): ValidationIssue[] {\n  if (\n    error &&\n    typeof error === \"object\" &&\n    \"issues\" in error &&\n    Array.isArray((error as { issues: unknown }).issues)\n  ) {\n    return (error as { issues: ValidationIssue[] }).issues;\n  }\n\n  if (error instanceof Error) {\n    return [{ path: [], message: error.message }];\n  }\n\n  return [{ path: [], message: String(error) }];\n}\n\nexport interface ValidateOptions {\n  formatError?: IssueFormatter;\n}\n\nexport function validate(\n  schemas: ValidationSchemas,\n  options: ValidateOptions = {},\n) {\n  const formatError = options.formatError ?? defaultFormatter;\n\n  return (req: Request, _res: Response, next: NextFunction): void => {\n    try {\n      if (schemas.body) req.body = schemas.body.parse(req.body);\n      if (schemas.params) req.params = schemas.params.parse(req.params) as typeof req.params;\n      if (schemas.query) req.query = schemas.query.parse(req.query) as typeof req.query;\n      next();\n    } catch (err) {\n      next(new ValidationError(\"Validation failed\", formatError(err)));\n    }\n  };\n}\n","import type { Request, Response, NextFunction } from \"express\";\n\nexport function asyncHandler(\n  fn: (req: Request, res: Response, next: NextFunction) => Promise<void>,\n) {\n  return (req: Request, res: Response, next: NextFunction): void => {\n    Promise.resolve(fn(req, res, next)).catch(next);\n  };\n}\n","import type { Request, Response, NextFunction } from \"express\";\nimport { GatewayTimeout } from \"../errors/http-error.js\";\n\nexport interface TimeoutOptions {\n  message?: string;\n}\n\nexport function timeout(ms: number, options: TimeoutOptions = {}) {\n  return (req: Request, _res: Response, next: NextFunction): void => {\n    const timer = setTimeout(() => {\n      next(new GatewayTimeout(options.message ?? \"Request timed out\"));\n    }, ms);\n\n    const done = () => clearTimeout(timer);\n\n    _res.on(\"finish\", done);\n    _res.on(\"close\", done);\n\n    next();\n  };\n}\n","import type { Request, Response, NextFunction } from \"express\";\n\nexport interface HealthCheckOptions {\n  uptime?: () => number;\n  timestamp?: () => string;\n  checks?: () => Record<string, unknown>;\n}\n\nexport function healthCheck(options: HealthCheckOptions = {}) {\n  const getUptime = options.uptime ?? (() => process.uptime());\n  const getTimestamp = options.timestamp ?? (() => new Date().toISOString());\n\n  return (_req: Request, res: Response, _next: NextFunction): void => {\n    res.json({\n      status: \"ok\",\n      uptime: getUptime(),\n      timestamp: getTimestamp(),\n      ...(options.checks?.() ?? {}),\n    });\n  };\n}\n"],"mappings":"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","names":["message","message","message","crypto"]}

package/dist/index.d.cts

@@ -0,0 +1,268 @@
+import { Request, Response, NextFunction } from 'express';
+
+declare const status: {
+    readonly continue: 100;
+    readonly switchingProtocols: 101;
+    readonly processing: 102;
+    readonly earlyHints: 103;
+    readonly ok: 200;
+    readonly created: 201;
+    readonly accepted: 202;
+    readonly nonAuthoritativeInformation: 203;
+    readonly noContent: 204;
+    readonly resetContent: 205;
+    readonly partialContent: 206;
+    readonly multipleChoices: 300;
+    readonly movedPermanently: 301;
+    readonly found: 302;
+    readonly seeOther: 303;
+    readonly notModified: 304;
+    readonly useProxy: 305;
+    readonly temporaryRedirect: 307;
+    readonly permanentRedirect: 308;
+    readonly badRequest: 400;
+    readonly unauthorized: 401;
+    readonly paymentRequired: 402;
+    readonly forbidden: 403;
+    readonly notFound: 404;
+    readonly methodNotAllowed: 405;
+    readonly notAcceptable: 406;
+    readonly proxyAuthenticationRequired: 407;
+    readonly requestTimeout: 408;
+    readonly conflict: 409;
+    readonly gone: 410;
+    readonly lengthRequired: 411;
+    readonly preconditionFailed: 412;
+    readonly payloadTooLarge: 413;
+    readonly uriTooLong: 414;
+    readonly unsupportedMediaType: 415;
+    readonly rangeNotSatisfiable: 416;
+    readonly expectationFailed: 417;
+    readonly imATeapot: 418;
+    readonly unprocessableEntity: 422;
+    readonly tooEarly: 425;
+    readonly upgradeRequired: 426;
+    readonly preconditionRequired: 428;
+    readonly tooManyRequests: 429;
+    readonly requestHeaderFieldsTooLarge: 431;
+    readonly unavailableForLegalReasons: 451;
+    readonly internalServerError: 500;
+    readonly notImplemented: 501;
+    readonly badGateway: 502;
+    readonly serviceUnavailable: 503;
+    readonly gatewayTimeout: 504;
+    readonly httpVersionNotSupported: 505;
+    readonly insufficientStorage: 507;
+    readonly loopDetected: 508;
+    readonly notExtended: 510;
+    readonly networkAuthenticationRequired: 511;
+};
+
+declare const message: {
+    readonly continue: "Continue";
+    readonly switchingProtocols: "Switching Protocols";
+    readonly processing: "Processing request";
+    readonly earlyHints: "Early hints available";
+    readonly ok: "Success";
+    readonly created: "Created successfully";
+    readonly accepted: "Request accepted";
+    readonly nonAuthoritativeInformation: "Non-authoritative information";
+    readonly noContent: "No content";
+    readonly resetContent: "Reset content";
+    readonly partialContent: "Partial content";
+    readonly multipleChoices: "Multiple redirect options available";
+    readonly movedPermanently: "Resource moved permanently";
+    readonly found: "Resource found elsewhere";
+    readonly seeOther: "See other resource";
+    readonly notModified: "Resource not modified";
+    readonly useProxy: "Use proxy to access resource";
+    readonly temporaryRedirect: "Resource temporarily moved";
+    readonly permanentRedirect: "Resource permanently moved";
+    readonly badRequest: "Invalid request";
+    readonly unauthorized: "Authentication required";
+    readonly paymentRequired: "Payment required";
+    readonly forbidden: "You don't have permission to access this resource";
+    readonly notFound: "Resource not found";
+    readonly methodNotAllowed: "Method not allowed for this resource";
+    readonly notAcceptable: "Requested format not available";
+    readonly proxyAuthenticationRequired: "Proxy authentication required";
+    readonly requestTimeout: "Request timed out";
+    readonly conflict: "Resource conflict detected";
+    readonly gone: "Resource no longer available";
+    readonly lengthRequired: "Content length header is required";
+    readonly preconditionFailed: "Request precondition failed";
+    readonly payloadTooLarge: "Request payload exceeds size limit";
+    readonly uriTooLong: "Request URI exceeds length limit";
+    readonly unsupportedMediaType: "Unsupported media type";
+    readonly rangeNotSatisfiable: "Requested range is not available";
+    readonly expectationFailed: "Request expectation could not be met";
+    readonly imATeapot: "I'm a teapot";
+    readonly unprocessableEntity: "Unable to process request entity";
+    readonly tooEarly: "Request sent too early, retry later";
+    readonly upgradeRequired: "Protocol upgrade required";
+    readonly preconditionRequired: "Precondition header is required";
+    readonly tooManyRequests: "Too many requests, please slow down";
+    readonly requestHeaderFieldsTooLarge: "Request headers exceed size limit";
+    readonly unavailableForLegalReasons: "Resource unavailable for legal reasons";
+    readonly internalServerError: "Something went wrong on our end";
+    readonly notImplemented: "Feature not yet implemented";
+    readonly badGateway: "Bad gateway response from upstream";
+    readonly serviceUnavailable: "Service temporarily unavailable, try again later";
+    readonly gatewayTimeout: "Upstream server timed out";
+    readonly httpVersionNotSupported: "HTTP version not supported by server";
+    readonly insufficientStorage: "Server has insufficient storage";
+    readonly loopDetected: "Infinite request loop detected";
+    readonly notExtended: "Server cannot fulfill extended request";
+    readonly networkAuthenticationRequired: "Network authentication required";
+};
+
+declare class ApiError extends Error {
+    readonly statusCode: number;
+    readonly details?: unknown | undefined;
+    constructor(statusCode: number, message?: string, details?: unknown | undefined);
+    static notFound(message?: string): ApiError;
+    static badRequest(message?: string): ApiError;
+    static unauthorized(message?: string): ApiError;
+    static forbidden(message?: string): ApiError;
+    static conflict(message?: string): ApiError;
+    static internalServerError(message?: string): ApiError;
+    static serviceUnavailable(message?: string): ApiError;
+    static tooManyRequests(message?: string): ApiError;
+}
+
+declare class NotFound extends ApiError {
+    constructor(message?: string);
+}
+declare class BadRequest extends ApiError {
+    constructor(message?: string);
+}
+declare class Unauthorized extends ApiError {
+    constructor(message?: string);
+}
+declare class Forbidden extends ApiError {
+    constructor(message?: string);
+}
+declare class Conflict extends ApiError {
+    constructor(message?: string);
+}
+declare class InternalServerError extends ApiError {
+    constructor(message?: string);
+}
+declare class ServiceUnavailable extends ApiError {
+    constructor(message?: string);
+}
+declare class TooManyRequests extends ApiError {
+    constructor(message?: string);
+}
+declare class ValidationError extends ApiError {
+    constructor(message?: string, details?: unknown);
+}
+declare class GatewayTimeout extends ApiError {
+    constructor(message?: string);
+}
+
+type LogLevel = "debug" | "info" | "warn" | "error";
+interface LoggerEntry {
+    level: LogLevel;
+    message?: string;
+    [key: string]: unknown;
+}
+type LogDestination = (entry: LoggerEntry) => void;
+interface LoggerOptions {
+    level?: LogLevel;
+    destination?: LogDestination;
+}
+declare class Logger {
+    private level;
+    private destination;
+    private bindings;
+    constructor(options?: LoggerOptions, bindings?: Record<string, unknown>);
+    private shouldLog;
+    private log;
+    debug(...args: [unknown, ...unknown[]]): void;
+    info(...args: [unknown, ...unknown[]]): void;
+    warn(...args: [unknown, ...unknown[]]): void;
+    error(...args: [unknown, ...unknown[]]): void;
+    child(bindings: Record<string, unknown>): Logger;
+}
+declare function createLogger(options?: LoggerOptions): Logger;
+
+interface RequestContext {
+    requestId: string;
+    log: Logger;
+}
+declare function getRequestContext(): RequestContext | undefined;
+declare function getLogger(): Logger | undefined;
+declare function getRequestId(): string | undefined;
+declare function runWithContext(context: RequestContext, fn: () => void): void;
+
+interface ErrorHandlerOptions {
+    log?: boolean;
+}
+declare function errorHandler(options?: ErrorHandlerOptions): (err: unknown, _req: Request, res: Response, _next: NextFunction) => void;
+
+declare global {
+    namespace Express {
+        interface Request {
+            requestId: string;
+        }
+    }
+}
+interface RequestIdOptions {
+    header?: string;
+    generator?: () => string;
+    respectExisting?: boolean;
+}
+declare function requestId(options?: RequestIdOptions): (req: Request, res: Response, next: NextFunction) => void;
+
+declare global {
+    namespace Express {
+        interface Request {
+            log: Logger;
+        }
+    }
+}
+interface RequestContextOptions {
+    logger?: Logger;
+}
+declare function requestContext(options?: RequestContextOptions): (req: Request, _res: Response, next: NextFunction) => void;
+
+interface HttpLoggerOptions {
+    skip?: (req: Request, res: Response) => boolean;
+}
+declare function httpLogger(options?: HttpLoggerOptions): (req: Request, res: Response, next: NextFunction) => void;
+
+interface Schema {
+    parse: (data: unknown) => unknown;
+}
+interface ValidationSchemas {
+    body?: Schema;
+    params?: Schema;
+    query?: Schema;
+}
+interface ValidationIssue {
+    path: (string | number)[];
+    message: string;
+    code?: string;
+}
+type IssueFormatter = (error: unknown) => ValidationIssue[];
+interface ValidateOptions {
+    formatError?: IssueFormatter;
+}
+declare function validate(schemas: ValidationSchemas, options?: ValidateOptions): (req: Request, _res: Response, next: NextFunction) => void;
+
+declare function asyncHandler(fn: (req: Request, res: Response, next: NextFunction) => Promise<void>): (req: Request, res: Response, next: NextFunction) => void;
+
+interface TimeoutOptions {
+    message?: string;
+}
+declare function timeout(ms: number, options?: TimeoutOptions): (req: Request, _res: Response, next: NextFunction) => void;
+
+interface HealthCheckOptions {
+    uptime?: () => number;
+    timestamp?: () => string;
+    checks?: () => Record<string, unknown>;
+}
+declare function healthCheck(options?: HealthCheckOptions): (_req: Request, res: Response, _next: NextFunction) => void;
+
+export { ApiError, BadRequest, Conflict, Forbidden, GatewayTimeout, InternalServerError, Logger, NotFound, ServiceUnavailable, TooManyRequests, Unauthorized, ValidationError, asyncHandler, createLogger, errorHandler, getLogger, getRequestContext, getRequestId, healthCheck, httpLogger, message, requestContext, requestId, runWithContext, status, timeout, validate };

package/dist/index.d.ts

@@ -0,0 +1,268 @@
+import { Request, Response, NextFunction } from 'express';
+
+declare const status: {
+    readonly continue: 100;
+    readonly switchingProtocols: 101;
+    readonly processing: 102;
+    readonly earlyHints: 103;
+    readonly ok: 200;
+    readonly created: 201;
+    readonly accepted: 202;
+    readonly nonAuthoritativeInformation: 203;
+    readonly noContent: 204;
+    readonly resetContent: 205;
+    readonly partialContent: 206;
+    readonly multipleChoices: 300;
+    readonly movedPermanently: 301;
+    readonly found: 302;
+    readonly seeOther: 303;
+    readonly notModified: 304;
+    readonly useProxy: 305;
+    readonly temporaryRedirect: 307;
+    readonly permanentRedirect: 308;
+    readonly badRequest: 400;
+    readonly unauthorized: 401;
+    readonly paymentRequired: 402;
+    readonly forbidden: 403;
+    readonly notFound: 404;
+    readonly methodNotAllowed: 405;
+    readonly notAcceptable: 406;
+    readonly proxyAuthenticationRequired: 407;
+    readonly requestTimeout: 408;
+    readonly conflict: 409;
+    readonly gone: 410;
+    readonly lengthRequired: 411;
+    readonly preconditionFailed: 412;
+    readonly payloadTooLarge: 413;
+    readonly uriTooLong: 414;
+    readonly unsupportedMediaType: 415;
+    readonly rangeNotSatisfiable: 416;
+    readonly expectationFailed: 417;
+    readonly imATeapot: 418;
+    readonly unprocessableEntity: 422;
+    readonly tooEarly: 425;
+    readonly upgradeRequired: 426;
+    readonly preconditionRequired: 428;
+    readonly tooManyRequests: 429;
+    readonly requestHeaderFieldsTooLarge: 431;
+    readonly unavailableForLegalReasons: 451;
+    readonly internalServerError: 500;
+    readonly notImplemented: 501;
+    readonly badGateway: 502;
+    readonly serviceUnavailable: 503;
+    readonly gatewayTimeout: 504;
+    readonly httpVersionNotSupported: 505;
+    readonly insufficientStorage: 507;
+    readonly loopDetected: 508;
+    readonly notExtended: 510;
+    readonly networkAuthenticationRequired: 511;
+};
+
+declare const message: {
+    readonly continue: "Continue";
+    readonly switchingProtocols: "Switching Protocols";
+    readonly processing: "Processing request";
+    readonly earlyHints: "Early hints available";
+    readonly ok: "Success";
+    readonly created: "Created successfully";
+    readonly accepted: "Request accepted";
+    readonly nonAuthoritativeInformation: "Non-authoritative information";
+    readonly noContent: "No content";
+    readonly resetContent: "Reset content";
+    readonly partialContent: "Partial content";
+    readonly multipleChoices: "Multiple redirect options available";
+    readonly movedPermanently: "Resource moved permanently";
+    readonly found: "Resource found elsewhere";
+    readonly seeOther: "See other resource";
+    readonly notModified: "Resource not modified";
+    readonly useProxy: "Use proxy to access resource";
+    readonly temporaryRedirect: "Resource temporarily moved";
+    readonly permanentRedirect: "Resource permanently moved";
+    readonly badRequest: "Invalid request";
+    readonly unauthorized: "Authentication required";
+    readonly paymentRequired: "Payment required";
+    readonly forbidden: "You don't have permission to access this resource";
+    readonly notFound: "Resource not found";
+    readonly methodNotAllowed: "Method not allowed for this resource";
+    readonly notAcceptable: "Requested format not available";
+    readonly proxyAuthenticationRequired: "Proxy authentication required";
+    readonly requestTimeout: "Request timed out";
+    readonly conflict: "Resource conflict detected";
+    readonly gone: "Resource no longer available";
+    readonly lengthRequired: "Content length header is required";
+    readonly preconditionFailed: "Request precondition failed";
+    readonly payloadTooLarge: "Request payload exceeds size limit";
+    readonly uriTooLong: "Request URI exceeds length limit";
+    readonly unsupportedMediaType: "Unsupported media type";
+    readonly rangeNotSatisfiable: "Requested range is not available";
+    readonly expectationFailed: "Request expectation could not be met";
+    readonly imATeapot: "I'm a teapot";
+    readonly unprocessableEntity: "Unable to process request entity";
+    readonly tooEarly: "Request sent too early, retry later";
+    readonly upgradeRequired: "Protocol upgrade required";
+    readonly preconditionRequired: "Precondition header is required";
+    readonly tooManyRequests: "Too many requests, please slow down";
+    readonly requestHeaderFieldsTooLarge: "Request headers exceed size limit";
+    readonly unavailableForLegalReasons: "Resource unavailable for legal reasons";
+    readonly internalServerError: "Something went wrong on our end";
+    readonly notImplemented: "Feature not yet implemented";
+    readonly badGateway: "Bad gateway response from upstream";
+    readonly serviceUnavailable: "Service temporarily unavailable, try again later";
+    readonly gatewayTimeout: "Upstream server timed out";
+    readonly httpVersionNotSupported: "HTTP version not supported by server";
+    readonly insufficientStorage: "Server has insufficient storage";
+    readonly loopDetected: "Infinite request loop detected";
+    readonly notExtended: "Server cannot fulfill extended request";
+    readonly networkAuthenticationRequired: "Network authentication required";
+};
+
+declare class ApiError extends Error {
+    readonly statusCode: number;
+    readonly details?: unknown | undefined;
+    constructor(statusCode: number, message?: string, details?: unknown | undefined);
+    static notFound(message?: string): ApiError;
+    static badRequest(message?: string): ApiError;
+    static unauthorized(message?: string): ApiError;
+    static forbidden(message?: string): ApiError;
+    static conflict(message?: string): ApiError;
+    static internalServerError(message?: string): ApiError;
+    static serviceUnavailable(message?: string): ApiError;
+    static tooManyRequests(message?: string): ApiError;
+}
+
+declare class NotFound extends ApiError {
+    constructor(message?: string);
+}
+declare class BadRequest extends ApiError {
+    constructor(message?: string);
+}
+declare class Unauthorized extends ApiError {
+    constructor(message?: string);
+}
+declare class Forbidden extends ApiError {
+    constructor(message?: string);
+}
+declare class Conflict extends ApiError {
+    constructor(message?: string);
+}
+declare class InternalServerError extends ApiError {
+    constructor(message?: string);
+}
+declare class ServiceUnavailable extends ApiError {
+    constructor(message?: string);
+}
+declare class TooManyRequests extends ApiError {
+    constructor(message?: string);
+}
+declare class ValidationError extends ApiError {
+    constructor(message?: string, details?: unknown);
+}
+declare class GatewayTimeout extends ApiError {
+    constructor(message?: string);
+}
+
+type LogLevel = "debug" | "info" | "warn" | "error";
+interface LoggerEntry {
+    level: LogLevel;
+    message?: string;
+    [key: string]: unknown;
+}
+type LogDestination = (entry: LoggerEntry) => void;
+interface LoggerOptions {
+    level?: LogLevel;
+    destination?: LogDestination;
+}
+declare class Logger {
+    private level;
+    private destination;
+    private bindings;
+    constructor(options?: LoggerOptions, bindings?: Record<string, unknown>);
+    private shouldLog;
+    private log;
+    debug(...args: [unknown, ...unknown[]]): void;
+    info(...args: [unknown, ...unknown[]]): void;
+    warn(...args: [unknown, ...unknown[]]): void;
+    error(...args: [unknown, ...unknown[]]): void;
+    child(bindings: Record<string, unknown>): Logger;
+}
+declare function createLogger(options?: LoggerOptions): Logger;
+
+interface RequestContext {
+    requestId: string;
+    log: Logger;
+}
+declare function getRequestContext(): RequestContext | undefined;
+declare function getLogger(): Logger | undefined;
+declare function getRequestId(): string | undefined;
+declare function runWithContext(context: RequestContext, fn: () => void): void;
+
+interface ErrorHandlerOptions {
+    log?: boolean;
+}
+declare function errorHandler(options?: ErrorHandlerOptions): (err: unknown, _req: Request, res: Response, _next: NextFunction) => void;
+
+declare global {
+    namespace Express {
+        interface Request {
+            requestId: string;
+        }
+    }
+}
+interface RequestIdOptions {
+    header?: string;
+    generator?: () => string;
+    respectExisting?: boolean;
+}
+declare function requestId(options?: RequestIdOptions): (req: Request, res: Response, next: NextFunction) => void;
+
+declare global {
+    namespace Express {
+        interface Request {
+            log: Logger;
+        }
+    }
+}
+interface RequestContextOptions {
+    logger?: Logger;
+}
+declare function requestContext(options?: RequestContextOptions): (req: Request, _res: Response, next: NextFunction) => void;
+
+interface HttpLoggerOptions {
+    skip?: (req: Request, res: Response) => boolean;
+}
+declare function httpLogger(options?: HttpLoggerOptions): (req: Request, res: Response, next: NextFunction) => void;
+
+interface Schema {
+    parse: (data: unknown) => unknown;
+}
+interface ValidationSchemas {
+    body?: Schema;
+    params?: Schema;
+    query?: Schema;
+}
+interface ValidationIssue {
+    path: (string | number)[];
+    message: string;
+    code?: string;
+}
+type IssueFormatter = (error: unknown) => ValidationIssue[];
+interface ValidateOptions {
+    formatError?: IssueFormatter;
+}
+declare function validate(schemas: ValidationSchemas, options?: ValidateOptions): (req: Request, _res: Response, next: NextFunction) => void;
+
+declare function asyncHandler(fn: (req: Request, res: Response, next: NextFunction) => Promise<void>): (req: Request, res: Response, next: NextFunction) => void;
+
+interface TimeoutOptions {
+    message?: string;
+}
+declare function timeout(ms: number, options?: TimeoutOptions): (req: Request, _res: Response, next: NextFunction) => void;
+
+interface HealthCheckOptions {
+    uptime?: () => number;
+    timestamp?: () => string;
+    checks?: () => Record<string, unknown>;
+}
+declare function healthCheck(options?: HealthCheckOptions): (_req: Request, res: Response, _next: NextFunction) => void;
+
+export { ApiError, BadRequest, Conflict, Forbidden, GatewayTimeout, InternalServerError, Logger, NotFound, ServiceUnavailable, TooManyRequests, Unauthorized, ValidationError, asyncHandler, createLogger, errorHandler, getLogger, getRequestContext, getRequestId, healthCheck, httpLogger, message, requestContext, requestId, runWithContext, status, timeout, validate };