API Reference¶

createCipherLogger(config?)¶

Creates a Cipher Logger instance.

const cipher = createCipherLogger(config);

Parameter: config?: CipherLoggerConfig — see Configuration for every option.

Returns: CipherLogger

Methods¶

cipher.logRequest(input: RequestLogInput): void¶

Logs a single HTTP request. Useful when you're not going through a supported framework adapter, or when you want to log a request from inside a route handler with final, accurate values.

cipher.logRequest({
  method: "POST",
  path: "/orders",
  status: 201,
  duration: 42,
});

RequestLogInput accepts the required fields plus any optional fields you've enabled in fields.

cipher.express(): ExpressMiddleware¶

Returns middleware compatible with app.use(). Records status and duration on res.finish. See the Express guide.

cipher.next(): NextMiddleware¶

Returns a function compatible with a Next.js middleware.ts default export. See the Next.js guide — including the current timing caveat.

Logger¶

The base logging class, independent of HTTP. Use it for anything that isn't a request — startup messages, background jobs, warnings, caught errors.

import { Logger } from "cipher-logger";

const logger = new Logger({ level: "info", prefix: "app" });

logger.info("Server started");
logger.warn("Deprecated API used", { route: "/old" });
logger.error("Unhandled error", { err: "..." });
logger.debug("Debug info");

Constructor¶

new Logger(options?: LoggerOptions)

Methods¶

Each method accepts a message: string and an optional meta: Record<string, unknown> object that's merged into the log output.

TypeScript exports¶

Every public shape is exported so you can type your own wrappers, tests, or downstream consumers:

import type {
  CipherLogger,
  CipherLoggerConfig,
  RequestLog,
  RequestLogInput,
  OptionalRequestField,
  LogLevel,
  LoggerOptions,
  ExpressMiddleware,
  NextMiddleware,
} from "cipher-logger";

See Log Schema for the field-by-field breakdown of RequestLog.