headplane/app/utils/log.ts

// MARK: Side-Effects
// This module contains a side-effect because everything running here
// is static and logger is later modified in `app/server/index.ts` to
// disable debug logging if the `HEADPLANE_DEBUG_LOG` specifies as such.

const levels = ["info", "warn", "error", "debug"] as const;
type Category = "server" | "config" | "agent" | "api" | "auth" | "sse";

export interface Logger extends Record<
  (typeof levels)[number],
  (category: Category, message: string, ...args: unknown[]) => void
> {
  debugEnabled: boolean;
}

const logLevels = getLogLevels();
export default {
  debugEnabled: logLevels.includes("debug"),
  debug: (..._: Parameters<Logger["debug"]>) => {},
  ...Object.fromEntries(
    logLevels.map((level) => [
      level,
      (category: Category, message: string, ...args: unknown[]) => {
        const date = new Date().toISOString();
        console.log(`${date} [${category}] ${level.toUpperCase()}: ${message}`, ...args);
      },
    ]),
  ),
} as Logger;

function getLogLevels() {
  const debugLog = process.env.HEADPLANE_DEBUG_LOG;
  if (debugLog == null) {
    return ["info", "warn", "error"];
  }

  const normalized = debugLog.trim().toLowerCase();
  const truthyValues = ["1", "true", "yes", "on"];
  if (!truthyValues.includes(normalized)) {
    return ["info", "warn", "error"];
  }

  return ["info", "warn", "error", "debug"];
}