@futuristic.digital/logger 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,49 @@
-# Temporary Holding Version
+# `@futuristic.digital/logger`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Structured server logging. Every Node package that logs should go through this logger so production emits JSON lines, secrets are redacted, and request logs can carry an OpenTelemetry trace id.
+
+This package uses `node:util` and `process.env`. It is server-only.
+
+## What Belongs Here
+
+- `createLogger` / `createLoggerForModule` and the `Logger` type.
+- `getTraceContext()` so a request-scoped child logger can attach `traceId` / `spanId`.
+- Default redaction of common secret keys (`password`, `token`, `authorization`, …).
+
+## What Does Not
+
+- Domain-specific log events or message catalogs. Callers pass a message string plus a context object.
+- Browser logging. Client code uses `console` or nothing.
+
+Keep this package independent of consuming applications.
+
+## Usage
+
+Create one module-scoped logger from `import.meta.url`, then a per-request child with the active trace:
+
+```ts
+import {
+  createLoggerForModule,
+  getTraceContext
+} from "@futuristic.digital/logger";
+
+const logger = createLoggerForModule(import.meta.url);
+
+export async function handleRequest() {
+  const requestLogger = logger.child(getTraceContext());
+  requestLogger.info("Handled request", { requestId: "request-123" });
+}
+```
+
+`createLoggerForModule` names the logger from the file path (extensions stripped) so log lines stay stable across bundlers. `child` merges extra context; `withName` replaces the name.
+
+## Output
+
+- **Development:** colored, human-readable lines with `util.inspect` context.
+- **Production:** one JSON object per line (`ts`, `level`, `name`, `msg`, plus context). Level defaults to `debug` in development and `info` in production.
+
+Context values are normalized to JSON (errors become `{ name, message, stack }`, dates to ISO, cycles to `"[Circular]"`) and then redacted. Passing `redactKeys` replaces the default list entirely — include every key you still need redacted. Do not log raw tokens, cookies, or request bodies that contain them — redaction is a backstop, not a license.
+
+## Testing
+
+`npm run test -w @futuristic.digital/logger` runs Vitest against logger behavior via a custom `sink` (no console assertions). Prefer that override in unit tests so output stays deterministic.

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+import { type LogLevel } from "./log-level.js";
+export type { LogLevel } from "./log-level.js";
+/** Arbitrary structured fields attached to a log line (request ids, ids, errors, …). */
+export type LogContext = Record<string, unknown>;
+export interface LogEvent {
+    level: Exclude<LogLevel, "silent">;
+    name?: string;
+    message: string;
+    context: LogContext;
+    /** ISO-8601 timestamp taken when the line is emitted. */
+    timestamp: string;
+}
+export interface Logger {
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, context?: LogContext): void;
+    /** Returns a logger that merges `context` into every subsequent line. */
+    child(context: LogContext): Logger;
+    /** Returns a logger with the same config but a different `name` label. */
+    withName(name: string): Logger;
+    isLevelEnabled(level: Exclude<LogLevel, "silent">): boolean;
+}
+export interface LoggerOptions {
+    name?: string;
+    level: LogLevel;
+    context?: LogContext;
+    /** Extra key names (case-insensitive) to replace with `[REDACTED]` in context. */
+    redactKeys?: string[];
+    /** Override the console transport — used by tests and alternate sinks. */
+    sink?: (event: LogEvent) => void;
+}
+/** OpenTelemetry ids for correlating a log line with the active span. */
+export type TraceContext = {
+    traceId?: string;
+    spanId?: string;
+};
+/**
+ * Creates a logger with optional name, level, base context, redaction, and sink.
+ *
+ * @param options Partial overrides; omitted `level` uses LOG_LEVEL, then the Node env default.
+ */
+export declare function createLogger(options?: Partial<LoggerOptions>): Logger;
+/**
+ * Creates a module-scoped logger named from the caller's file path.
+ *
+ * @param moduleUrl Pass `import.meta.url` so the name tracks the source file.
+ * @param options Same as `createLogger`, except `name` is always derived.
+ */
+export declare function createLoggerForModule(moduleUrl: string, options?: Omit<Partial<LoggerOptions>, "name">): Logger;
+/**
+ * Reads the active OpenTelemetry span so a child logger can attach `traceId` / `spanId`.
+ * Returns an empty object when no span is active.
+ */
+export declare function getTraceContext(): TraceContext;
+/** Process-wide default logger (no module name). Prefer `createLoggerForModule` in app code. */
+export declare const logger: Logger;

package/dist/index.js

@@ -0,0 +1,330 @@
+import { trace } from "@opentelemetry/api";
+import util from "node:util";
+import { LEVEL_ORDER, resolveDefaultLevel } from "./log-level.js";
+const DEFAULT_REDACT_KEYS = [
+    "password",
+    "pass",
+    "secret",
+    "token",
+    "access_token",
+    "refresh_token",
+    "authorization",
+    "cookie",
+    "set-cookie",
+    "api_key",
+    "apikey",
+    "client_secret"
+];
+const REDACTED_VALUE = "[REDACTED]";
+// Captured at module load so the sink format stays stable for the process lifetime.
+const isProduction = process.env.NODE_ENV === "production";
+const ANSI_RESET = "\x1b[0m";
+const ANSI_DIM = "\x1b[2m";
+const LEVEL_COLORS = {
+    debug: "\x1b[36m",
+    info: "\x1b[32m",
+    warn: "\x1b[33m",
+    error: "\x1b[31m"
+};
+/**
+ * Flattens an `Error` into JSON-safe fields sinks can serialize.
+ *
+ * @param error Any thrown or logged Error instance.
+ */
+function normalizeError(error) {
+    return {
+        name: error.name,
+        message: error.message,
+        stack: error.stack ?? null
+    };
+}
+/**
+ * Converts any runtime value into JSON-safe data for structured logs.
+ * Dates become ISO strings, Errors become `{ name, message, stack }`, cycles
+ * become `"[Circular]"`, and unsupported types fall back to `String(value)`.
+ *
+ * @param value Context field or nested value from the caller.
+ * @param seen Objects already visiting on this path — detects cycles.
+ */
+function normalizeValue(value, seen = new WeakSet()) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean") {
+        return value;
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (value instanceof Error) {
+        return normalizeError(value);
+    }
+    if (typeof value === "bigint") {
+        return value.toString();
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => normalizeValue(item, seen));
+    }
+    if (typeof value === "object") {
+        const objectValue = value;
+        if (seen.has(objectValue)) {
+            return "[Circular]";
+        }
+        seen.add(objectValue);
+        const normalizedEntries = Object.entries(objectValue).map(([key, entryValue]) => [key, normalizeValue(entryValue, seen)]);
+        // Drop after this branch so the same object can appear under sibling keys
+        // without being treated as a cycle.
+        seen.delete(objectValue);
+        return Object.fromEntries(normalizedEntries);
+    }
+    return String(value);
+}
+/**
+ * Walks a normalized payload and replaces sensitive key values.
+ * Matching is case-insensitive on the key name only — values are not scanned.
+ *
+ * @param value Already-normalized JSON tree from `normalizeValue`.
+ * @param redactKeysSet Lowercased key names that must never leave the process.
+ */
+function redactContext(value, redactKeysSet) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => redactContext(entry, redactKeysSet));
+    }
+    if (value && typeof value === "object") {
+        const output = {};
+        for (const [key, nestedValue] of Object.entries(value)) {
+            if (redactKeysSet.has(key.toLowerCase())) {
+                output[key] = REDACTED_VALUE;
+            }
+            else {
+                output[key] = redactContext(nestedValue, redactKeysSet);
+            }
+        }
+        return output;
+    }
+    return value;
+}
+/**
+ * Merges caller context over base context so request-scoped values can override defaults.
+ *
+ * @param base Context baked into the logger (module or child).
+ * @param next Per-call context; omitted keys keep the base value.
+ */
+function mergeContexts(base, next) {
+    if (!next) {
+        return base;
+    }
+    return { ...base, ...next };
+}
+/**
+ * Formats an ISO timestamp for the human-readable dev sink.
+ *
+ * @param timestamp ISO-8601 string from the log event.
+ * @returns `YYYY-MM-DD HH:mm:ss.SSS` in the process local zone, or the raw string if invalid.
+ */
+function formatTimestamp(timestamp) {
+    const date = new Date(timestamp);
+    if (Number.isNaN(date.getTime())) {
+        return timestamp;
+    }
+    return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")} ${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}:${String(date.getSeconds()).padStart(2, "0")}.${String(date.getMilliseconds()).padStart(3, "0")}`;
+}
+/**
+ * Default transport: colored human lines in development, JSON lines in production.
+ *
+ * @param event Fully normalized and redacted log event.
+ */
+function defaultSink(event) {
+    const { level, message, name, context, timestamp } = event;
+    const prefix = name ? `[${name}]` : "";
+    if (!isProduction) {
+        const formattedTimestamp = formatTimestamp(timestamp);
+        const levelLabel = level.toUpperCase().padEnd(5, " ");
+        const coloredLevelLabel = `${LEVEL_COLORS[level]}${levelLabel}${ANSI_RESET}`;
+        const coloredPrefix = prefix ? `${ANSI_DIM}${prefix}${ANSI_RESET}` : "";
+        const line = `${formattedTimestamp} ${coloredLevelLabel} ${coloredPrefix} ${message}`.trim();
+        const hasContext = Object.keys(context).length > 0;
+        const formattedContext = hasContext
+            ? util.inspect(context, { depth: 10, colors: true })
+            : undefined;
+        if (level === "error") {
+            // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+            hasContext ? console.error(line, formattedContext) : console.error(line);
+        }
+        else if (level === "warn") {
+            // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+            hasContext ? console.warn(line, formattedContext) : console.warn(line);
+        }
+        else {
+            // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+            hasContext ? console.log(line, formattedContext) : console.log(line);
+        }
+        return;
+    }
+    const payload = {
+        ts: timestamp,
+        level,
+        name,
+        msg: message,
+        ...context
+    };
+    const line = JSON.stringify(payload);
+    if (level === "error") {
+        console.error(line);
+    }
+    else if (level === "warn") {
+        console.warn(line);
+    }
+    else {
+        console.log(line);
+    }
+}
+class BaseLogger {
+    name;
+    level;
+    baseContext;
+    redactKeysSet;
+    sink;
+    constructor(options) {
+        this.name = options.name;
+        this.level = options.level;
+        this.baseContext = options.context ?? {};
+        this.redactKeysSet = new Set((options.redactKeys ?? DEFAULT_REDACT_KEYS).map((key) => key.toLowerCase()));
+        this.sink = options.sink ?? defaultSink;
+    }
+    debug(message, context) {
+        this.log("debug", message, context);
+    }
+    info(message, context) {
+        this.log("info", message, context);
+    }
+    warn(message, context) {
+        this.log("warn", message, context);
+    }
+    error(message, context) {
+        this.log("error", message, context);
+    }
+    child(context) {
+        return new BaseLogger({
+            name: this.name,
+            level: this.level,
+            context: mergeContexts(this.baseContext, context),
+            redactKeys: [...this.redactKeysSet],
+            sink: this.sink
+        });
+    }
+    withName(name) {
+        return new BaseLogger({
+            name,
+            level: this.level,
+            context: this.baseContext,
+            redactKeys: [...this.redactKeysSet],
+            sink: this.sink
+        });
+    }
+    isLevelEnabled(level) {
+        return LEVEL_ORDER[level] >= LEVEL_ORDER[this.level];
+    }
+    log(level, message, context) {
+        if (!this.isLevelEnabled(level)) {
+            return;
+        }
+        // Normalize first, then redact, so every sink receives safe, predictable payloads.
+        const mergedContext = mergeContexts(this.baseContext, context);
+        const normalizedContext = normalizeValue(mergedContext);
+        const redactedContext = redactContext(normalizedContext, this.redactKeysSet);
+        this.sink({
+            level,
+            name: this.name,
+            message,
+            context: redactedContext,
+            timestamp: new Date().toISOString()
+        });
+    }
+}
+/**
+ * Creates a logger with optional name, level, base context, redaction, and sink.
+ *
+ * @param options Partial overrides; omitted `level` uses LOG_LEVEL, then the Node env default.
+ */
+export function createLogger(options = {}) {
+    return new BaseLogger({
+        name: options.name,
+        level: options.level ?? resolveDefaultLevel(),
+        context: options.context,
+        redactKeys: options.redactKeys,
+        sink: options.sink
+    });
+}
+/**
+ * Normalizes Windows path separators so module names match across platforms.
+ *
+ * @param value Absolute or relative filesystem path.
+ */
+function toPosixPath(value) {
+    return value.replaceAll("\\", "/");
+}
+/**
+ * Strips TS/JS extensions so logger names remain stable across build tools.
+ *
+ * @param value Path or bare module specifier that may end in `.ts` / `.js` / etc.
+ */
+function stripKnownExtensions(value) {
+    return value.replace(/\.(?:m|c)?(?:t|j)sx?$/, "");
+}
+/**
+ * Builds a readable logger name from `import.meta.url` for module-scoped loggers.
+ * Prefers a path relative to `process.cwd()` when the URL is a `file://` under the repo.
+ *
+ * @param moduleUrl Typically `import.meta.url` from the calling module.
+ */
+function deriveLoggerNameFromModuleUrl(moduleUrl) {
+    if (!moduleUrl) {
+        return "unknown-module";
+    }
+    try {
+        if (moduleUrl.startsWith("file://")) {
+            const pathname = toPosixPath(decodeURIComponent(new URL(moduleUrl).pathname));
+            const cwd = typeof process !== "undefined" && typeof process.cwd === "function"
+                ? toPosixPath(process.cwd())
+                : "";
+            const pathWithoutCwd = cwd && pathname.startsWith(`${cwd}/`)
+                ? pathname.slice(cwd.length + 1)
+                : pathname.replace(/^\/+/, "");
+            return stripKnownExtensions(pathWithoutCwd) || "unknown-module";
+        }
+        return stripKnownExtensions(moduleUrl);
+    }
+    catch {
+        return stripKnownExtensions(moduleUrl) || "unknown-module";
+    }
+}
+/**
+ * Creates a module-scoped logger named from the caller's file path.
+ *
+ * @param moduleUrl Pass `import.meta.url` so the name tracks the source file.
+ * @param options Same as `createLogger`, except `name` is always derived.
+ */
+export function createLoggerForModule(moduleUrl, options = {}) {
+    return createLogger({
+        ...options,
+        name: deriveLoggerNameFromModuleUrl(moduleUrl)
+    });
+}
+/**
+ * Reads the active OpenTelemetry span so a child logger can attach `traceId` / `spanId`.
+ * Returns an empty object when no span is active.
+ */
+export function getTraceContext() {
+    const span = trace.getActiveSpan();
+    if (!span) {
+        return {};
+    }
+    const { traceId, spanId } = span.spanContext();
+    return { traceId, spanId };
+}
+/** Process-wide default logger (no module name). Prefer `createLoggerForModule` in app code. */
+export const logger = createLogger();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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","sourcesContent":["import { trace } from \"@opentelemetry/api\";\nimport util from \"node:util\";\n\nimport {\n  LEVEL_ORDER,\n  resolveDefaultLevel,\n  type LogLevel\n} from \"./log-level.js\";\n\nexport type { LogLevel } from \"./log-level.js\";\n\ntype JsonPrimitive = string | number | boolean | null;\ntype JsonValue = JsonPrimitive | JsonValue[] | { [key: string]: JsonValue };\n\n/** Arbitrary structured fields attached to a log line (request ids, ids, errors, …). */\nexport type LogContext = Record<string, unknown>;\n\nexport interface LogEvent {\n  level: Exclude<LogLevel, \"silent\">;\n  name?: string;\n  message: string;\n  context: LogContext;\n  /** ISO-8601 timestamp taken when the line is emitted. */\n  timestamp: string;\n}\n\nexport interface Logger {\n  debug(message: string, context?: LogContext): void;\n  info(message: string, context?: LogContext): void;\n  warn(message: string, context?: LogContext): void;\n  error(message: string, context?: LogContext): void;\n  /** Returns a logger that merges `context` into every subsequent line. */\n  child(context: LogContext): Logger;\n  /** Returns a logger with the same config but a different `name` label. */\n  withName(name: string): Logger;\n  isLevelEnabled(level: Exclude<LogLevel, \"silent\">): boolean;\n}\n\nexport interface LoggerOptions {\n  name?: string;\n  level: LogLevel;\n  context?: LogContext;\n  /** Extra key names (case-insensitive) to replace with `[REDACTED]` in context. */\n  redactKeys?: string[];\n  /** Override the console transport — used by tests and alternate sinks. */\n  sink?: (event: LogEvent) => void;\n}\n\n/** OpenTelemetry ids for correlating a log line with the active span. */\nexport type TraceContext = {\n  traceId?: string;\n  spanId?: string;\n};\n\nconst DEFAULT_REDACT_KEYS = [\n  \"password\",\n  \"pass\",\n  \"secret\",\n  \"token\",\n  \"access_token\",\n  \"refresh_token\",\n  \"authorization\",\n  \"cookie\",\n  \"set-cookie\",\n  \"api_key\",\n  \"apikey\",\n  \"client_secret\"\n];\n\nconst REDACTED_VALUE = \"[REDACTED]\";\n\n// Captured at module load so the sink format stays stable for the process lifetime.\nconst isProduction = process.env.NODE_ENV === \"production\";\nconst ANSI_RESET = \"\\x1b[0m\";\nconst ANSI_DIM = \"\\x1b[2m\";\nconst LEVEL_COLORS: Record<Exclude<LogLevel, \"silent\">, string> = {\n  debug: \"\\x1b[36m\",\n  info: \"\\x1b[32m\",\n  warn: \"\\x1b[33m\",\n  error: \"\\x1b[31m\"\n};\n\n/**\n * Flattens an `Error` into JSON-safe fields sinks can serialize.\n *\n * @param error Any thrown or logged Error instance.\n */\nfunction normalizeError(error: Error): { [key: string]: JsonValue } {\n  return {\n    name: error.name,\n    message: error.message,\n    stack: error.stack ?? null\n  };\n}\n\n/**\n * Converts any runtime value into JSON-safe data for structured logs.\n * Dates become ISO strings, Errors become `{ name, message, stack }`, cycles\n * become `\"[Circular]\"`, and unsupported types fall back to `String(value)`.\n *\n * @param value Context field or nested value from the caller.\n * @param seen Objects already visiting on this path — detects cycles.\n */\nfunction normalizeValue(\n  value: unknown,\n  seen = new WeakSet<object>()\n): JsonValue {\n  if (value === null || value === undefined) {\n    return null;\n  }\n\n  if (\n    typeof value === \"string\" ||\n    typeof value === \"number\" ||\n    typeof value === \"boolean\"\n  ) {\n    return value;\n  }\n\n  if (value instanceof Date) {\n    return value.toISOString();\n  }\n\n  if (value instanceof Error) {\n    return normalizeError(value);\n  }\n\n  if (typeof value === \"bigint\") {\n    return value.toString();\n  }\n\n  if (Array.isArray(value)) {\n    return value.map((item) => normalizeValue(item, seen));\n  }\n\n  if (typeof value === \"object\") {\n    const objectValue = value as Record<string, unknown>;\n\n    if (seen.has(objectValue)) {\n      return \"[Circular]\";\n    }\n\n    seen.add(objectValue);\n\n    const normalizedEntries = Object.entries(objectValue).map(\n      ([key, entryValue]) => [key, normalizeValue(entryValue, seen)]\n    );\n\n    // Drop after this branch so the same object can appear under sibling keys\n    // without being treated as a cycle.\n    seen.delete(objectValue);\n\n    return Object.fromEntries(normalizedEntries);\n  }\n\n  return String(value);\n}\n\n/**\n * Walks a normalized payload and replaces sensitive key values.\n * Matching is case-insensitive on the key name only — values are not scanned.\n *\n * @param value Already-normalized JSON tree from `normalizeValue`.\n * @param redactKeysSet Lowercased key names that must never leave the process.\n */\nfunction redactContext(\n  value: JsonValue,\n  redactKeysSet: ReadonlySet<string>\n): JsonValue {\n  if (Array.isArray(value)) {\n    return value.map((entry) => redactContext(entry, redactKeysSet));\n  }\n\n  if (value && typeof value === \"object\") {\n    const output: Record<string, JsonValue> = {};\n\n    for (const [key, nestedValue] of Object.entries(value)) {\n      if (redactKeysSet.has(key.toLowerCase())) {\n        output[key] = REDACTED_VALUE;\n      } else {\n        output[key] = redactContext(nestedValue, redactKeysSet);\n      }\n    }\n\n    return output;\n  }\n\n  return value;\n}\n\n/**\n * Merges caller context over base context so request-scoped values can override defaults.\n *\n * @param base Context baked into the logger (module or child).\n * @param next Per-call context; omitted keys keep the base value.\n */\nfunction mergeContexts(base: LogContext, next?: LogContext): LogContext {\n  if (!next) {\n    return base;\n  }\n\n  return { ...base, ...next };\n}\n\n/**\n * Formats an ISO timestamp for the human-readable dev sink.\n *\n * @param timestamp ISO-8601 string from the log event.\n * @returns `YYYY-MM-DD HH:mm:ss.SSS` in the process local zone, or the raw string if invalid.\n */\nfunction formatTimestamp(timestamp: string): string {\n  const date = new Date(timestamp);\n  if (Number.isNaN(date.getTime())) {\n    return timestamp;\n  }\n\n  return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(\n    2,\n    \"0\"\n  )}-${String(date.getDate()).padStart(2, \"0\")} ${String(\n    date.getHours()\n  ).padStart(2, \"0\")}:${String(date.getMinutes()).padStart(2, \"0\")}:${String(\n    date.getSeconds()\n  ).padStart(2, \"0\")}.${String(date.getMilliseconds()).padStart(3, \"0\")}`;\n}\n\n/**\n * Default transport: colored human lines in development, JSON lines in production.\n *\n * @param event Fully normalized and redacted log event.\n */\nfunction defaultSink(event: LogEvent): void {\n  const { level, message, name, context, timestamp } = event;\n  const prefix = name ? `[${name}]` : \"\";\n\n  if (!isProduction) {\n    const formattedTimestamp = formatTimestamp(timestamp);\n    const levelLabel = level.toUpperCase().padEnd(5, \" \");\n    const coloredLevelLabel = `${LEVEL_COLORS[level]}${levelLabel}${ANSI_RESET}`;\n    const coloredPrefix = prefix ? `${ANSI_DIM}${prefix}${ANSI_RESET}` : \"\";\n    const line =\n      `${formattedTimestamp} ${coloredLevelLabel} ${coloredPrefix} ${message}`.trim();\n    const hasContext = Object.keys(context).length > 0;\n    const formattedContext = hasContext\n      ? util.inspect(context, { depth: 10, colors: true })\n      : undefined;\n\n    if (level === \"error\") {\n      // eslint-disable-next-line @typescript-eslint/no-unused-expressions\n      hasContext ? console.error(line, formattedContext) : console.error(line);\n    } else if (level === \"warn\") {\n      // eslint-disable-next-line @typescript-eslint/no-unused-expressions\n      hasContext ? console.warn(line, formattedContext) : console.warn(line);\n    } else {\n      // eslint-disable-next-line @typescript-eslint/no-unused-expressions\n      hasContext ? console.log(line, formattedContext) : console.log(line);\n    }\n\n    return;\n  }\n\n  const payload = {\n    ts: timestamp,\n    level,\n    name,\n    msg: message,\n    ...context\n  };\n\n  const line = JSON.stringify(payload);\n\n  if (level === \"error\") {\n    console.error(line);\n  } else if (level === \"warn\") {\n    console.warn(line);\n  } else {\n    console.log(line);\n  }\n}\n\nclass BaseLogger implements Logger {\n  private readonly name?: string;\n  private readonly level: LogLevel;\n  private readonly baseContext: LogContext;\n  private readonly redactKeysSet: ReadonlySet<string>;\n  private readonly sink: (event: LogEvent) => void;\n\n  constructor(options: LoggerOptions) {\n    this.name = options.name;\n    this.level = options.level;\n    this.baseContext = options.context ?? {};\n    this.redactKeysSet = new Set(\n      (options.redactKeys ?? DEFAULT_REDACT_KEYS).map((key) =>\n        key.toLowerCase()\n      )\n    );\n    this.sink = options.sink ?? defaultSink;\n  }\n\n  debug(message: string, context?: LogContext): void {\n    this.log(\"debug\", message, context);\n  }\n\n  info(message: string, context?: LogContext): void {\n    this.log(\"info\", message, context);\n  }\n\n  warn(message: string, context?: LogContext): void {\n    this.log(\"warn\", message, context);\n  }\n\n  error(message: string, context?: LogContext): void {\n    this.log(\"error\", message, context);\n  }\n\n  child(context: LogContext): Logger {\n    return new BaseLogger({\n      name: this.name,\n      level: this.level,\n      context: mergeContexts(this.baseContext, context),\n      redactKeys: [...this.redactKeysSet],\n      sink: this.sink\n    });\n  }\n\n  withName(name: string): Logger {\n    return new BaseLogger({\n      name,\n      level: this.level,\n      context: this.baseContext,\n      redactKeys: [...this.redactKeysSet],\n      sink: this.sink\n    });\n  }\n\n  isLevelEnabled(level: Exclude<LogLevel, \"silent\">): boolean {\n    return LEVEL_ORDER[level] >= LEVEL_ORDER[this.level];\n  }\n\n  private log(\n    level: Exclude<LogLevel, \"silent\">,\n    message: string,\n    context?: LogContext\n  ): void {\n    if (!this.isLevelEnabled(level)) {\n      return;\n    }\n\n    // Normalize first, then redact, so every sink receives safe, predictable payloads.\n    const mergedContext = mergeContexts(this.baseContext, context);\n    const normalizedContext = normalizeValue(mergedContext) as JsonValue;\n    const redactedContext = redactContext(\n      normalizedContext,\n      this.redactKeysSet\n    ) as LogContext;\n\n    this.sink({\n      level,\n      name: this.name,\n      message,\n      context: redactedContext,\n      timestamp: new Date().toISOString()\n    });\n  }\n}\n\n/**\n * Creates a logger with optional name, level, base context, redaction, and sink.\n *\n * @param options Partial overrides; omitted `level` uses LOG_LEVEL, then the Node env default.\n */\nexport function createLogger(options: Partial<LoggerOptions> = {}): Logger {\n  return new BaseLogger({\n    name: options.name,\n    level: options.level ?? resolveDefaultLevel(),\n    context: options.context,\n    redactKeys: options.redactKeys,\n    sink: options.sink\n  });\n}\n\n/**\n * Normalizes Windows path separators so module names match across platforms.\n *\n * @param value Absolute or relative filesystem path.\n */\nfunction toPosixPath(value: string): string {\n  return value.replaceAll(\"\\\\\", \"/\");\n}\n\n/**\n * Strips TS/JS extensions so logger names remain stable across build tools.\n *\n * @param value Path or bare module specifier that may end in `.ts` / `.js` / etc.\n */\nfunction stripKnownExtensions(value: string): string {\n  return value.replace(/\\.(?:m|c)?(?:t|j)sx?$/, \"\");\n}\n\n/**\n * Builds a readable logger name from `import.meta.url` for module-scoped loggers.\n * Prefers a path relative to `process.cwd()` when the URL is a `file://` under the repo.\n *\n * @param moduleUrl Typically `import.meta.url` from the calling module.\n */\nfunction deriveLoggerNameFromModuleUrl(moduleUrl: string): string {\n  if (!moduleUrl) {\n    return \"unknown-module\";\n  }\n\n  try {\n    if (moduleUrl.startsWith(\"file://\")) {\n      const pathname = toPosixPath(\n        decodeURIComponent(new URL(moduleUrl).pathname)\n      );\n      const cwd =\n        typeof process !== \"undefined\" && typeof process.cwd === \"function\"\n          ? toPosixPath(process.cwd())\n          : \"\";\n\n      const pathWithoutCwd =\n        cwd && pathname.startsWith(`${cwd}/`)\n          ? pathname.slice(cwd.length + 1)\n          : pathname.replace(/^\\/+/, \"\");\n\n      return stripKnownExtensions(pathWithoutCwd) || \"unknown-module\";\n    }\n\n    return stripKnownExtensions(moduleUrl);\n  } catch {\n    return stripKnownExtensions(moduleUrl) || \"unknown-module\";\n  }\n}\n\n/**\n * Creates a module-scoped logger named from the caller's file path.\n *\n * @param moduleUrl Pass `import.meta.url` so the name tracks the source file.\n * @param options Same as `createLogger`, except `name` is always derived.\n */\nexport function createLoggerForModule(\n  moduleUrl: string,\n  options: Omit<Partial<LoggerOptions>, \"name\"> = {}\n): Logger {\n  return createLogger({\n    ...options,\n    name: deriveLoggerNameFromModuleUrl(moduleUrl)\n  });\n}\n\n/**\n * Reads the active OpenTelemetry span so a child logger can attach `traceId` / `spanId`.\n * Returns an empty object when no span is active.\n */\nexport function getTraceContext(): TraceContext {\n  const span = trace.getActiveSpan();\n  if (!span) {\n    return {};\n  }\n\n  const { traceId, spanId } = span.spanContext();\n  return { traceId, spanId };\n}\n\n/** Process-wide default logger (no module name). Prefer `createLoggerForModule` in app code. */\nexport const logger = createLogger();\n"]}

package/dist/log-level.d.ts

@@ -0,0 +1,5 @@
+export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
+/** Monotonic severity map used to filter log events. */
+export declare const LEVEL_ORDER: Record<LogLevel, number>;
+/** Uses LOG_LEVEL when valid, otherwise the production/development default. */
+export declare function resolveDefaultLevel(): LogLevel;

package/dist/log-level.js

@@ -0,0 +1,23 @@
+/** Monotonic severity map used to filter log events. */
+export const LEVEL_ORDER = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+    silent: Number.POSITIVE_INFINITY
+};
+/** Uses LOG_LEVEL when valid, otherwise the production/development default. */
+export function resolveDefaultLevel() {
+    const level = process.env.LOG_LEVEL;
+    switch (level) {
+        case "debug":
+        case "info":
+        case "warn":
+        case "error":
+        case "silent":
+            return level;
+        default:
+            return process.env.NODE_ENV === "production" ? "info" : "debug";
+    }
+}
+//# sourceMappingURL=log-level.js.map

package/dist/log-level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-level.js","sourceRoot":"","sources":["../log-level.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAA6B;IACnD,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,MAAM,CAAC,iBAAiB;CACjC,CAAC;AAEF,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB;IACjC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IAEpC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC;QACf;YACE,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IACpE,CAAC;AACH,CAAC","sourcesContent":["export type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"silent\";\n\n/** Monotonic severity map used to filter log events. */\nexport const LEVEL_ORDER: Record<LogLevel, number> = {\n  debug: 10,\n  info: 20,\n  warn: 30,\n  error: 40,\n  silent: Number.POSITIVE_INFINITY\n};\n\n/** Uses LOG_LEVEL when valid, otherwise the production/development default. */\nexport function resolveDefaultLevel(): LogLevel {\n  const level = process.env.LOG_LEVEL;\n\n  switch (level) {\n    case \"debug\":\n    case \"info\":\n    case \"warn\":\n    case \"error\":\n    case \"silent\":\n      return level;\n    default:\n      return process.env.NODE_ENV === \"production\" ? \"info\" : \"debug\";\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@futuristic.digital/logger",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "clean": "node --input-type=module -e \"import { rmSync } from 'node:fs'; rmSync('dist', { recursive: true, force: true });\"",
+    "build": "npm run clean && tsc -p tsconfig.json",
+    "check-types": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run check-types"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0"
+  },
+  "description": "Structured Node.js logging with redaction and OpenTelemetry trace context.",
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false
+}