@plandek-utils/logging 0.6.0 → 1.0.0

package/dist/{mod.js → index.mjs}

@@ -1,11 +1,18 @@
-// src/mod.ts
+// src/index.ts
 import chalk from "chalk";
 import { colorize } from "json-colorizer";
 import { pino } from "pino";
-var LOG_LEVELS = ["fatal", "error", "warn", "info", "debug", "trace", "silent"];
+var LOG_LEVELS = [
+  "fatal",
+  "error",
+  "warn",
+  "info",
+  "debug",
+  "trace",
+  "silent"
+];
 function parseLogLevelOrDefault(level, defaultLevel) {
-  if (!level)
-    return defaultLevel;
+  if (!level) return defaultLevel;
   const lowerLevel = level.toLowerCase();
   if (LOG_LEVELS.includes(lowerLevel)) {
     return lowerLevel;
@@ -13,7 +20,10 @@ function parseLogLevelOrDefault(level, defaultLevel) {
   throw new Error(`Invalid log level: ${level}`);
 }
 function buildPinoLogger(level, redactPaths) {
-  const paths = redactPaths ?? ["req.headers.authorization", "req.headers.cookie"];
+  const paths = redactPaths ?? [
+    "req.headers.authorization",
+    "req.headers.cookie"
+  ];
   return pino({
     level,
     timestamp: pino.stdTimeFunctions.isoTime,
@@ -71,7 +81,11 @@ function isLoggingWithRecords(obj) {
   return "messages" in obj;
 }
 function makeLogging(opts) {
-  const logger = loggerFor(opts.logger, opts.section ?? null, opts.context ?? null);
+  const logger = loggerFor(
+    opts.logger,
+    opts.section ?? null,
+    opts.context ?? null
+  );
   return {
     logger,
     info: (msg, obj) => logger.info(obj, msg),
@@ -82,8 +96,7 @@ function makeLogging(opts) {
       return getSectionsFromLogger(logger);
     },
     withSection(section, context) {
-      if (this.getSections().includes(section))
-        return this;
+      if (this.getSections().includes(section)) return this;
       return makeLogging({ logger: this.logger, section, context });
     }
   };
@@ -128,7 +141,10 @@ function loggerFor(givenLogger, section, context) {
   }
   const childBindings = { ...context };
   if (section) {
-    childBindings.logSections = [...getSectionsFromLogger(givenLogger), section];
+    childBindings.logSections = [
+      ...getSectionsFromLogger(givenLogger),
+      section
+    ];
   }
   return givenLogger.child(childBindings);
 }
@@ -152,4 +168,4 @@ export {
   parseLogLevelOrDefault,
   prettyJSON
 };
-//# sourceMappingURL=mod.js.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import chalk from \"chalk\";\nimport { colorize } from \"json-colorizer\";\nimport type { Logger as PinoLogger } from \"pino\";\nimport { pino } from \"pino\";\nimport type { DeepReadonly } from \"simplytyped\";\n\nimport type {\n\tPlainObject,\n\tPlainObjectValue,\n} from \"@plandek-utils/plain-object\";\n\n/**\n * Allowed log levels for the logger.\n */\nexport const LOG_LEVELS = [\n\t\"fatal\",\n\t\"error\",\n\t\"warn\",\n\t\"info\",\n\t\"debug\",\n\t\"trace\",\n\t\"silent\",\n] as const;\n\n/**\n * Possible log levels for preparing the pino logger.\n */\nexport type LogLevel = (typeof LOG_LEVELS)[number];\n\n/**\n * Parses the given log level, or returns the default level if it's not blank. If it is an invalid level it will throw an error.\n */\nexport function parseLogLevelOrDefault(\n\tlevel: string | null | undefined,\n\tdefaultLevel: LogLevel,\n): LogLevel {\n\tif (!level) return defaultLevel;\n\n\tconst lowerLevel = level.toLowerCase() as LogLevel;\n\tif (LOG_LEVELS.includes(lowerLevel)) {\n\t\treturn lowerLevel;\n\t}\n\n\tthrow new Error(`Invalid log level: ${level}`);\n}\n\n/**\n * Prepared pino logger, returned by `buildPinoLogger` or `buildSinkLogger`.\n *\n * @see buildPinoLogger\n * @see buildSinkLogger\n */\nexport type PreparedLogger = Pick<\n\tPinoLogger,\n\t\"level\" | \"info\" | \"debug\" | \"warn\" | \"error\" | \"bindings\"\n> & {\n\tchild: (bindings: PlainObject) => PreparedLogger;\n};\n\n/**\n * Prepares a Pino logger with the common configuration.\n *\n * @param level - The log level to use.\n * @param redactPaths - Paths to redact from the logs. Defaults to `[\"req.headers.authorization\", \"req.headers.cookie\"]`.\n * @returns PinoLogger\n */\nexport function buildPinoLogger(\n\tlevel: LogLevel,\n\tredactPaths?: string[],\n): PreparedLogger {\n\tconst paths = redactPaths ?? [\n\t\t\"req.headers.authorization\",\n\t\t\"req.headers.cookie\",\n\t];\n\treturn pino({\n\t\tlevel,\n\t\ttimestamp: pino.stdTimeFunctions.isoTime,\n\t\tredact: { paths, censor: \"[REDACTED]\" },\n\t});\n}\n\n/**\n * A mock logger that does nothing, holds no binding (sections).\n */\nexport function buildSinkLogger(\n\tlevel: LogLevel,\n\tgivenBindings?: PlainObject,\n): PreparedLogger {\n\tconst bindings = givenBindings ?? {};\n\treturn {\n\t\tlevel,\n\t\tinfo: () => {},\n\t\tdebug: () => {},\n\t\twarn: () => {},\n\t\terror: () => {},\n\t\tchild: (childBindings?: PlainObject) =>\n\t\t\tbuildSinkLogger(level, { ...bindings, ...childBindings }),\n\t\tbindings: () => bindings,\n\t};\n}\n\n/**\n * Util to serialise as JSON the given value, pretty-printed (2 spaces).\n */\nexport function prettyJSON(obj: unknown): string {\n\treturn JSON.stringify(obj, null, 2);\n}\n\n/**\n * Calls `prettyJSON` and then colourises the output.\n */\nexport function colourPrettyJSON(obj: unknown): string {\n\treturn colorize(prettyJSON(obj));\n}\n\n/**\n * Alias for `colourPrettyJSON`.\n * @see colourPrettyJSON\n */\nexport const colorPrettyJSON = colourPrettyJSON;\n\n/**\n * Interface to provide colouring for logs.\n */\nexport type LogColourUtils = {\n\tblue: (x: string) => string;\n\tcyan: (x: string) => string;\n\tgray: (x: string) => string;\n\tmagenta: (x: string) => string;\n\tred: (x: string) => string;\n\tyellow: (x: string) => string;\n};\n\n/**\n * Creates a LogColourUtils object, with actual colours or not depending on the given mode.\n *\n * @param mode: if \"with-colour\", it will return a set of functions that will colour the given string. If \"plain\", it will return a set of functions that will return the string as is.\n */\nexport function makeColourUtils(mode: \"with-colour\" | \"plain\"): LogColourUtils {\n\tif (mode === \"with-colour\") {\n\t\treturn {\n\t\t\tblue: (x: string) => chalk.blue(x),\n\t\t\tcyan: (x: string) => chalk.cyan(x),\n\t\t\tgray: (x: string) => chalk.gray(x),\n\t\t\tmagenta: (x: string) => chalk.magenta(x),\n\t\t\tred: (x: string) => chalk.red(x),\n\t\t\tyellow: (x: string) => chalk.yellow(x),\n\t\t};\n\t}\n\n\tif (mode === \"plain\") {\n\t\treturn {\n\t\t\tblue: (x: string) => x,\n\t\t\tcyan: (x: string) => x,\n\t\t\tgray: (x: string) => x,\n\t\t\tmagenta: (x: string) => x,\n\t\t\tred: (x: string) => x,\n\t\t\tyellow: (x: string) => x,\n\t\t};\n\t}\n\n\tconst _never: never = mode;\n\tthrow new Error(`Unknown mode: ${_never}`);\n}\n\n/**\n * Logging interface. Requires a message (string) and optionally an object to log, which is required to be a Plain Object to ensure serialisation.\n */\ntype LogFn = (msg: string, obj?: DeepReadonly<PlainObject>) => void;\n\n/**\n * Logging interface that provides a way to log messages with different levels. It should be configured with sections. It can return a new instance with a new section.\n */\nexport type Logging = {\n\tlogger: PreparedLogger;\n\tinfo: LogFn;\n\twarn: LogFn;\n\tdebug: LogFn;\n\terror: LogFn;\n\tgetSections(this: Logging): string[];\n\twithSection(this: Logging, section: string, context?: PlainObject): Logging;\n};\n\n/**\n * Variant of the Logging interface that stores the messages that have been logged.\n */\nexport type LoggingWithRecords = Omit<Logging, \"withSection\"> & {\n\twithSection(\n\t\tthis: Logging,\n\t\tsection: string,\n\t\tcontext?: PlainObject,\n\t): LoggingWithRecords;\n\tmessages: {\n\t\tinfo: Array<[string, PlainObject | null]>;\n\t\twarn: Array<[string, PlainObject | null]>;\n\t\tdebug: Array<[string, PlainObject | null]>;\n\t\terror: Array<[string, PlainObject | null]>;\n\t};\n};\n\n/**\n * Checks if the given Logging object is a LoggingWithRecords.\n * @param obj\n * @returns\n */\nexport function isLoggingWithRecords(obj: Logging): obj is LoggingWithRecords {\n\treturn \"messages\" in obj;\n}\n\n/**\n * Creates a Logging object. It requires an actual pino logger to be sent, and optionally a section and a context.\n */\nexport function makeLogging(opts: {\n\tsection?: string;\n\tcontext?: PlainObject;\n\tlogger: PreparedLogger;\n}): Logging {\n\tconst logger = loggerFor(\n\t\topts.logger,\n\t\topts.section ?? null,\n\t\topts.context ?? null,\n\t);\n\n\treturn {\n\t\tlogger,\n\t\tinfo: (msg, obj) => logger.info(obj, msg),\n\t\tdebug: (msg, obj) => logger.debug(obj, msg),\n\t\twarn: (msg, obj) => logger.warn(obj, msg),\n\t\terror: (msg, obj) => logger.error(obj, msg),\n\t\tgetSections(): string[] {\n\t\t\treturn getSectionsFromLogger(logger);\n\t\t},\n\t\twithSection(section, context) {\n\t\t\tif (this.getSections().includes(section)) return this;\n\n\t\t\treturn makeLogging({ logger: this.logger, section, context });\n\t\t},\n\t};\n}\n\n/**\n * Creates a LoggingWithRecords object. It requires an actual pino logger to be sent, and optionally a section and a context. You can pass it a \"messages\" record object to use or a new one will be created.\n */\nexport function makeLoggingWithRecord(opts: {\n\tlogger: PreparedLogger;\n\tsection?: string;\n\tcontext?: PlainObject;\n\tmessages?: LoggingWithRecords[\"messages\"];\n}): LoggingWithRecords {\n\tconst logging = makeLogging(opts);\n\tconst messages = opts.messages ?? {\n\t\tinfo: [],\n\t\twarn: [],\n\t\tdebug: [],\n\t\terror: [],\n\t};\n\n\tfunction makeLogFn(logFn: LogFn, key: keyof typeof messages): LogFn {\n\t\treturn (msg, obj) => {\n\t\t\tmessages[key].push([msg, obj ?? null]);\n\t\t\treturn logFn(msg, obj);\n\t\t};\n\t}\n\n\treturn {\n\t\tmessages,\n\t\tlogger: logging.logger,\n\t\tinfo: makeLogFn(logging.info, \"info\"),\n\t\tdebug: makeLogFn(logging.debug, \"debug\"),\n\t\twarn: makeLogFn(logging.warn, \"warn\"),\n\t\terror: makeLogFn(logging.error, \"error\"),\n\t\tgetSections(): string[] {\n\t\t\treturn logging.getSections();\n\t\t},\n\t\twithSection(section, context) {\n\t\t\treturn makeLoggingWithRecord({\n\t\t\t\tlogger: this.logger,\n\t\t\t\tsection,\n\t\t\t\tmessages,\n\t\t\t\tcontext,\n\t\t\t});\n\t\t},\n\t};\n}\n\n// INTERNAL\n\nfunction loggerFor(\n\tgivenLogger: PreparedLogger,\n\tsection: string | null,\n\tcontext: PlainObject | null,\n) {\n\tif (!context && (!section || loggerHasSection(givenLogger, section))) {\n\t\treturn givenLogger;\n\t}\n\n\tconst childBindings: Record<string, PlainObjectValue> = { ...context };\n\tif (section) {\n\t\tchildBindings.logSections = [\n\t\t\t...getSectionsFromLogger(givenLogger),\n\t\t\tsection,\n\t\t];\n\t}\n\n\treturn givenLogger.child(childBindings);\n}\n\nfunction getSectionsFromLogger(logger: PreparedLogger) {\n\treturn logger.bindings().logSections ?? [];\n}\n\nfunction loggerHasSection(logger: PreparedLogger, section: string) {\n\tconst sections = getSectionsFromLogger(logger);\n\treturn sections.includes(section);\n}\n"],"mappings":";AAAA,OAAO,WAAW;AAClB,SAAS,gBAAgB;AAEzB,SAAS,YAAY;AAWd,IAAM,aAAa;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACD;AAUO,SAAS,uBACf,OACA,cACW;AACX,MAAI,CAAC,MAAO,QAAO;AAEnB,QAAM,aAAa,MAAM,YAAY;AACrC,MAAI,WAAW,SAAS,UAAU,GAAG;AACpC,WAAO;AAAA,EACR;AAEA,QAAM,IAAI,MAAM,sBAAsB,KAAK,EAAE;AAC9C;AAsBO,SAAS,gBACf,OACA,aACiB;AACjB,QAAM,QAAQ,eAAe;AAAA,IAC5B;AAAA,IACA;AAAA,EACD;AACA,SAAO,KAAK;AAAA,IACX;AAAA,IACA,WAAW,KAAK,iBAAiB;AAAA,IACjC,QAAQ,EAAE,OAAO,QAAQ,aAAa;AAAA,EACvC,CAAC;AACF;AAKO,SAAS,gBACf,OACA,eACiB;AACjB,QAAM,WAAW,iBAAiB,CAAC;AACnC,SAAO;AAAA,IACN;AAAA,IACA,MAAM,MAAM;AAAA,IAAC;AAAA,IACb,OAAO,MAAM;AAAA,IAAC;AAAA,IACd,MAAM,MAAM;AAAA,IAAC;AAAA,IACb,OAAO,MAAM;AAAA,IAAC;AAAA,IACd,OAAO,CAAC,kBACP,gBAAgB,OAAO,EAAE,GAAG,UAAU,GAAG,cAAc,CAAC;AAAA,IACzD,UAAU,MAAM;AAAA,EACjB;AACD;AAKO,SAAS,WAAW,KAAsB;AAChD,SAAO,KAAK,UAAU,KAAK,MAAM,CAAC;AACnC;AAKO,SAAS,iBAAiB,KAAsB;AACtD,SAAO,SAAS,WAAW,GAAG,CAAC;AAChC;AAMO,IAAM,kBAAkB;AAmBxB,SAAS,gBAAgB,MAA+C;AAC9E,MAAI,SAAS,eAAe;AAC3B,WAAO;AAAA,MACN,MAAM,CAAC,MAAc,MAAM,KAAK,CAAC;AAAA,MACjC,MAAM,CAAC,MAAc,MAAM,KAAK,CAAC;AAAA,MACjC,MAAM,CAAC,MAAc,MAAM,KAAK,CAAC;AAAA,MACjC,SAAS,CAAC,MAAc,MAAM,QAAQ,CAAC;AAAA,MACvC,KAAK,CAAC,MAAc,MAAM,IAAI,CAAC;AAAA,MAC/B,QAAQ,CAAC,MAAc,MAAM,OAAO,CAAC;AAAA,IACtC;AAAA,EACD;AAEA,MAAI,SAAS,SAAS;AACrB,WAAO;AAAA,MACN,MAAM,CAAC,MAAc;AAAA,MACrB,MAAM,CAAC,MAAc;AAAA,MACrB,MAAM,CAAC,MAAc;AAAA,MACrB,SAAS,CAAC,MAAc;AAAA,MACxB,KAAK,CAAC,MAAc;AAAA,MACpB,QAAQ,CAAC,MAAc;AAAA,IACxB;AAAA,EACD;AAEA,QAAM,SAAgB;AACtB,QAAM,IAAI,MAAM,iBAAiB,MAAM,EAAE;AAC1C;AA0CO,SAAS,qBAAqB,KAAyC;AAC7E,SAAO,cAAc;AACtB;AAKO,SAAS,YAAY,MAIhB;AACX,QAAM,SAAS;AAAA,IACd,KAAK;AAAA,IACL,KAAK,WAAW;AAAA,IAChB,KAAK,WAAW;AAAA,EACjB;AAEA,SAAO;AAAA,IACN;AAAA,IACA,MAAM,CAAC,KAAK,QAAQ,OAAO,KAAK,KAAK,GAAG;AAAA,IACxC,OAAO,CAAC,KAAK,QAAQ,OAAO,MAAM,KAAK,GAAG;AAAA,IAC1C,MAAM,CAAC,KAAK,QAAQ,OAAO,KAAK,KAAK,GAAG;AAAA,IACxC,OAAO,CAAC,KAAK,QAAQ,OAAO,MAAM,KAAK,GAAG;AAAA,IAC1C,cAAwB;AACvB,aAAO,sBAAsB,MAAM;AAAA,IACpC;AAAA,IACA,YAAY,SAAS,SAAS;AAC7B,UAAI,KAAK,YAAY,EAAE,SAAS,OAAO,EAAG,QAAO;AAEjD,aAAO,YAAY,EAAE,QAAQ,KAAK,QAAQ,SAAS,QAAQ,CAAC;AAAA,IAC7D;AAAA,EACD;AACD;AAKO,SAAS,sBAAsB,MAKf;AACtB,QAAM,UAAU,YAAY,IAAI;AAChC,QAAM,WAAW,KAAK,YAAY;AAAA,IACjC,MAAM,CAAC;AAAA,IACP,MAAM,CAAC;AAAA,IACP,OAAO,CAAC;AAAA,IACR,OAAO,CAAC;AAAA,EACT;AAEA,WAAS,UAAU,OAAc,KAAmC;AACnE,WAAO,CAAC,KAAK,QAAQ;AACpB,eAAS,GAAG,EAAE,KAAK,CAAC,KAAK,OAAO,IAAI,CAAC;AACrC,aAAO,MAAM,KAAK,GAAG;AAAA,IACtB;AAAA,EACD;AAEA,SAAO;AAAA,IACN;AAAA,IACA,QAAQ,QAAQ;AAAA,IAChB,MAAM,UAAU,QAAQ,MAAM,MAAM;AAAA,IACpC,OAAO,UAAU,QAAQ,OAAO,OAAO;AAAA,IACvC,MAAM,UAAU,QAAQ,MAAM,MAAM;AAAA,IACpC,OAAO,UAAU,QAAQ,OAAO,OAAO;AAAA,IACvC,cAAwB;AACvB,aAAO,QAAQ,YAAY;AAAA,IAC5B;AAAA,IACA,YAAY,SAAS,SAAS;AAC7B,aAAO,sBAAsB;AAAA,QAC5B,QAAQ,KAAK;AAAA,QACb;AAAA,QACA;AAAA,QACA;AAAA,MACD,CAAC;AAAA,IACF;AAAA,EACD;AACD;AAIA,SAAS,UACR,aACA,SACA,SACC;AACD,MAAI,CAAC,YAAY,CAAC,WAAW,iBAAiB,aAAa,OAAO,IAAI;AACrE,WAAO;AAAA,EACR;AAEA,QAAM,gBAAkD,EAAE,GAAG,QAAQ;AACrE,MAAI,SAAS;AACZ,kBAAc,cAAc;AAAA,MAC3B,GAAG,sBAAsB,WAAW;AAAA,MACpC;AAAA,IACD;AAAA,EACD;AAEA,SAAO,YAAY,MAAM,aAAa;AACvC;AAEA,SAAS,sBAAsB,QAAwB;AACtD,SAAO,OAAO,SAAS,EAAE,eAAe,CAAC;AAC1C;AAEA,SAAS,iBAAiB,QAAwB,SAAiB;AAClE,QAAM,WAAW,sBAAsB,MAAM;AAC7C,SAAO,SAAS,SAAS,OAAO;AACjC;","names":[]}

package/package.json

@@ -1,27 +1,27 @@
 {
   "name": "@plandek-utils/logging",
-  "version": "0.6.0",
+  "version": "1.0.0",
   "description": "TypeScript utils for Logging. Includes prettifying of JSON, logging utils, and colour utils.",
-  "main": "dist/mod.js",
-  "types": "dist/mod.d.ts",
-  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
   "scripts": {
     "commit": "git-cz",
     "build": "npm run build:tsup && npm run build:dts",
     "build:tsup": "tsup",
     "build:dts": "echo 'emitting Declaration using tsc' && tsc --emitDeclarationOnly",
     "fix": "npm run fix:biome",
-    "fix:biome": "biome format --write src && biome check --apply src",
+    "fix:biome": "biome check --write src",
     "check": "npm run check:biome && npm run check:tsc",
-    "check:biome": "biome check --apply src",
+    "check:biome": "biome check src",
     "check:tsc": "tsc --noEmit",
     "test": "vitest run --coverage",
     "test:watch": "vitest",
-    "prepare-release": "npm run fix && npm run check && npm run test && npm run build",
-    "prepare": "husky || true"
+    "prepare-release": "npm run fix && npm run check && npm run test && npm run build"
   },
   "files": [
     "dist",
+    "src",
     "LICENSE",
     "README.md"
   ],
@@ -36,20 +36,22 @@
   "author": "Plandek Ltd.",
   "license": "MIT",
   "dependencies": {
-    "@plandek-utils/plain-object": "^1.1.0",
-    "chalk": "^5.3.0",
+    "chalk": "^5.4.1",
     "json-colorizer": "^3.0.1",
-    "pino": "^9.5.0",
     "simplytyped": "^3.3.0"
   },
+  "peerDependencies": {
+    "@plandek-utils/plain-object": "^2.0.0",
+    "pino": "^9.6.0"
+  },
   "devDependencies": {
-    "@biomejs/biome": "1.5.3",
-    "@types/node": "20.11.0",
-    "@vitest/coverage-v8": "1.1.3",
+    "@biomejs/biome": "1.9.4",
+    "@types/node": "22.10.9",
+    "@vitest/coverage-v8": "3.0.4",
     "biome": "0.3.3",
-    "tsup": "8.0.1",
-    "typescript": "5.3.3",
-    "vitest": "1.1.3"
+    "tsup": "8.3.5",
+    "typescript": "5.7.3",
+    "vitest": "3.0.4"
   },
   "publishConfig": {
     "access": "public"

package/src/__tests__/index.spec.ts

@@ -0,0 +1,210 @@
+import { colorize as colorizeJson } from "json-colorizer";
+import { describe, expect, it } from "vitest";
+
+import {
+	buildPinoLogger,
+	buildSinkLogger,
+	colorPrettyJSON,
+	colourPrettyJSON,
+	isLoggingWithRecords,
+	makeColourUtils,
+	makeLogging,
+	makeLoggingWithRecord,
+	parseLogLevelOrDefault,
+} from "..";
+
+describe("colorPrettyJSON()", () => {
+	it("with null: returns 'null'", () => {
+		expect(colorPrettyJSON(null)).toBe(colorizeJson("null"));
+		expect(colourPrettyJSON(null)).toBe(colorizeJson("null"));
+	});
+
+	it("with 1: returns '1'", () => {
+		expect(colorPrettyJSON(1)).toBe(colorizeJson("1"));
+		expect(colourPrettyJSON(1)).toBe(colorizeJson("1"));
+	});
+
+	it("with 'abc': returns '\"abc\"'", () => {
+		expect(colorPrettyJSON("abc")).toBe(colorizeJson('"abc"'));
+		expect(colourPrettyJSON("abc")).toBe(colorizeJson('"abc"'));
+	});
+
+	it("with []: returns '[]'", () => {
+		expect(colorPrettyJSON([])).toBe(colorizeJson("[]"));
+		expect(colourPrettyJSON([])).toBe(colorizeJson("[]"));
+	});
+
+	it("with {}: returns '{}'", () => {
+		expect(colorPrettyJSON({})).toBe(colorizeJson("{}"));
+		expect(colourPrettyJSON({})).toBe(colorizeJson("{}"));
+	});
+
+	it("with { a: 1 }: returns '{ a: 1 }' formatted", () => {
+		expect(colorPrettyJSON({ a: 1 })).toBe(colorizeJson('{\n  "a": 1\n}'));
+		expect(colourPrettyJSON({ a: 1 })).toBe(colorizeJson('{\n  "a": 1\n}'));
+	});
+});
+
+describe("makeColourUtils", () => {
+	it('should return color functions when mode is "with-colour"', () => {
+		const colorUtils = makeColourUtils("with-colour");
+
+		expect(typeof colorUtils.blue).toBe("function");
+		expect(typeof colorUtils.cyan).toBe("function");
+		expect(typeof colorUtils.gray).toBe("function");
+		expect(typeof colorUtils.magenta).toBe("function");
+		expect(typeof colorUtils.red).toBe("function");
+		expect(typeof colorUtils.yellow).toBe("function");
+	});
+
+	it('should return identity functions when mode is "plain"', () => {
+		const colorUtils = makeColourUtils("plain");
+
+		expect(colorUtils.blue("test")).toBe("test");
+		expect(colorUtils.cyan("test")).toBe("test");
+		expect(colorUtils.gray("test")).toBe("test");
+		expect(colorUtils.magenta("test")).toBe("test");
+		expect(colorUtils.red("test")).toBe("test");
+		expect(colorUtils.yellow("test")).toBe("test");
+	});
+
+	it("should handle unknown modes", () => {
+		expect(() =>
+			makeColourUtils("unknown" as "with-colour" | "plain"),
+		).toThrow();
+	});
+});
+
+describe("buildPinoLogger", () => {
+	it("should create a Pino logger with the given log level", () => {
+		const logger = buildPinoLogger("debug");
+		expect(logger.level).toBe("debug");
+	});
+});
+
+describe("isLoggingWithRecords", () => {
+	it("should return true for LoggingWithRecords", () => {
+		const logger = buildSinkLogger("debug");
+		const loggingWithRecords = makeLoggingWithRecord({ logger });
+		expect(isLoggingWithRecords(loggingWithRecords)).toBe(true);
+	});
+
+	it("should return false for Logging", () => {
+		const logger = buildSinkLogger("debug");
+		const logging = makeLogging({ logger });
+		expect(isLoggingWithRecords(logging)).toBe(false);
+	});
+});
+
+describe("makeLogging", () => {
+	it("should create a Logging object with default settings", () => {
+		const logger = buildSinkLogger("debug");
+		const logging = makeLogging({ logger });
+		expect(typeof logging.info).toBe("function");
+		expect(typeof logging.debug).toBe("function");
+		expect(typeof logging.warn).toBe("function");
+		expect(typeof logging.error).toBe("function");
+	});
+
+	it("should create a Logging object with custom section", () => {
+		const logger = buildSinkLogger("debug");
+		const logging = makeLogging({ logger, section: "custom" });
+		expect(logging.getSections()).toEqual(["custom"]);
+		expect(typeof logging.info).toBe("function");
+		expect(typeof logging.debug).toBe("function");
+		expect(typeof logging.warn).toBe("function");
+		expect(typeof logging.error).toBe("function");
+
+		const newLogging = logging.withSection("another");
+		const sameLogging = logging.withSection("custom");
+		expect(newLogging).not.toBe(logging);
+		expect(newLogging.getSections()).toEqual(["custom", "another"]);
+		expect(sameLogging).toBe(logging);
+		expect(sameLogging.getSections()).toEqual(["custom"]);
+	});
+});
+
+describe("makeLoggingWithRecord", () => {
+	it("should create a LoggingWithRecords object", () => {
+		const logger = buildSinkLogger("debug");
+		const loggingWithRecords = makeLoggingWithRecord({ logger });
+		expect(loggingWithRecords.messages).toBeDefined();
+		expect(typeof loggingWithRecords.info).toBe("function");
+		expect(typeof loggingWithRecords.debug).toBe("function");
+		expect(typeof loggingWithRecords.warn).toBe("function");
+		expect(typeof loggingWithRecords.error).toBe("function");
+	});
+
+	it("should preserve existing messages", () => {
+		const logger = buildSinkLogger("debug");
+		const loggingWithRecords = makeLoggingWithRecord({
+			logger,
+			messages: {
+				info: [["some-test", null]],
+				warn: [["some-test-warn", { a: 1 }]],
+				debug: [],
+				error: [],
+			},
+		});
+		loggingWithRecords.info("another test", { with: "context" });
+		loggingWithRecords.warn("another test2", { with: "context2" });
+		loggingWithRecords.debug("some debug");
+		loggingWithRecords.error("some error");
+		expect(loggingWithRecords.messages.info).toEqual([
+			["some-test", null],
+			["another test", { with: "context" }],
+		]);
+		expect(loggingWithRecords.messages.warn).toEqual([
+			["some-test-warn", { a: 1 }],
+			[
+				"another test2",
+				{
+					with: "context2",
+				},
+			],
+		]);
+		expect(loggingWithRecords.messages.debug).toEqual([["some debug", null]]);
+		expect(loggingWithRecords.messages.error).toEqual([["some error", null]]);
+	});
+
+	it("should create a new LoggingWithRecords instance when withSection is called", () => {
+		const logger = buildSinkLogger("debug");
+		const loggingWithRecords = makeLoggingWithRecord({
+			logger,
+			section: "first",
+		});
+		const newLoggingWithRecords = loggingWithRecords.withSection("custom");
+		expect(newLoggingWithRecords).not.toBe(loggingWithRecords);
+		expect(newLoggingWithRecords.getSections()).toEqual(["first", "custom"]);
+		expect(newLoggingWithRecords.messages).toEqual({
+			info: [],
+			warn: [],
+			debug: [],
+			error: [],
+		});
+	});
+});
+
+describe("parseLogLevelOrDefault()", () => {
+	it("should return the default level when no level is provided", () => {
+		expect(parseLogLevelOrDefault(null, "debug")).toBe("debug");
+		expect(parseLogLevelOrDefault(undefined, "debug")).toBe("debug");
+		expect(parseLogLevelOrDefault("", "debug")).toBe("debug");
+	});
+
+	it("should parse valid log levels", () => {
+		expect(parseLogLevelOrDefault("fatal", "debug")).toBe("fatal");
+		expect(parseLogLevelOrDefault("error", "debug")).toBe("error");
+		expect(parseLogLevelOrDefault("warn", "debug")).toBe("warn");
+		expect(parseLogLevelOrDefault("info", "debug")).toBe("info");
+		expect(parseLogLevelOrDefault("debug", "debug")).toBe("debug");
+		expect(parseLogLevelOrDefault("trace", "debug")).toBe("trace");
+		expect(parseLogLevelOrDefault("silent", "debug")).toBe("silent");
+	});
+
+	it("should throw an error for invalid log levels", () => {
+		expect(() => parseLogLevelOrDefault("invalid", "debug")).toThrow(
+			"Invalid log level: invalid",
+		);
+	});
+});

package/src/index.ts

@@ -0,0 +1,315 @@
+import chalk from "chalk";
+import { colorize } from "json-colorizer";
+import type { Logger as PinoLogger } from "pino";
+import { pino } from "pino";
+import type { DeepReadonly } from "simplytyped";
+
+import type {
+	PlainObject,
+	PlainObjectValue,
+} from "@plandek-utils/plain-object";
+
+/**
+ * Allowed log levels for the logger.
+ */
+export const LOG_LEVELS = [
+	"fatal",
+	"error",
+	"warn",
+	"info",
+	"debug",
+	"trace",
+	"silent",
+] as const;
+
+/**
+ * Possible log levels for preparing the pino logger.
+ */
+export type LogLevel = (typeof LOG_LEVELS)[number];
+
+/**
+ * Parses the given log level, or returns the default level if it's not blank. If it is an invalid level it will throw an error.
+ */
+export function parseLogLevelOrDefault(
+	level: string | null | undefined,
+	defaultLevel: LogLevel,
+): LogLevel {
+	if (!level) return defaultLevel;
+
+	const lowerLevel = level.toLowerCase() as LogLevel;
+	if (LOG_LEVELS.includes(lowerLevel)) {
+		return lowerLevel;
+	}
+
+	throw new Error(`Invalid log level: ${level}`);
+}
+
+/**
+ * Prepared pino logger, returned by `buildPinoLogger` or `buildSinkLogger`.
+ *
+ * @see buildPinoLogger
+ * @see buildSinkLogger
+ */
+export type PreparedLogger = Pick<
+	PinoLogger,
+	"level" | "info" | "debug" | "warn" | "error" | "bindings"
+> & {
+	child: (bindings: PlainObject) => PreparedLogger;
+};
+
+/**
+ * Prepares a Pino logger with the common configuration.
+ *
+ * @param level - The log level to use.
+ * @param redactPaths - Paths to redact from the logs. Defaults to `["req.headers.authorization", "req.headers.cookie"]`.
+ * @returns PinoLogger
+ */
+export function buildPinoLogger(
+	level: LogLevel,
+	redactPaths?: string[],
+): PreparedLogger {
+	const paths = redactPaths ?? [
+		"req.headers.authorization",
+		"req.headers.cookie",
+	];
+	return pino({
+		level,
+		timestamp: pino.stdTimeFunctions.isoTime,
+		redact: { paths, censor: "[REDACTED]" },
+	});
+}
+
+/**
+ * A mock logger that does nothing, holds no binding (sections).
+ */
+export function buildSinkLogger(
+	level: LogLevel,
+	givenBindings?: PlainObject,
+): PreparedLogger {
+	const bindings = givenBindings ?? {};
+	return {
+		level,
+		info: () => {},
+		debug: () => {},
+		warn: () => {},
+		error: () => {},
+		child: (childBindings?: PlainObject) =>
+			buildSinkLogger(level, { ...bindings, ...childBindings }),
+		bindings: () => bindings,
+	};
+}
+
+/**
+ * Util to serialise as JSON the given value, pretty-printed (2 spaces).
+ */
+export function prettyJSON(obj: unknown): string {
+	return JSON.stringify(obj, null, 2);
+}
+
+/**
+ * Calls `prettyJSON` and then colourises the output.
+ */
+export function colourPrettyJSON(obj: unknown): string {
+	return colorize(prettyJSON(obj));
+}
+
+/**
+ * Alias for `colourPrettyJSON`.
+ * @see colourPrettyJSON
+ */
+export const colorPrettyJSON = colourPrettyJSON;
+
+/**
+ * Interface to provide colouring for logs.
+ */
+export type LogColourUtils = {
+	blue: (x: string) => string;
+	cyan: (x: string) => string;
+	gray: (x: string) => string;
+	magenta: (x: string) => string;
+	red: (x: string) => string;
+	yellow: (x: string) => string;
+};
+
+/**
+ * Creates a LogColourUtils object, with actual colours or not depending on the given mode.
+ *
+ * @param mode: if "with-colour", it will return a set of functions that will colour the given string. If "plain", it will return a set of functions that will return the string as is.
+ */
+export function makeColourUtils(mode: "with-colour" | "plain"): LogColourUtils {
+	if (mode === "with-colour") {
+		return {
+			blue: (x: string) => chalk.blue(x),
+			cyan: (x: string) => chalk.cyan(x),
+			gray: (x: string) => chalk.gray(x),
+			magenta: (x: string) => chalk.magenta(x),
+			red: (x: string) => chalk.red(x),
+			yellow: (x: string) => chalk.yellow(x),
+		};
+	}
+
+	if (mode === "plain") {
+		return {
+			blue: (x: string) => x,
+			cyan: (x: string) => x,
+			gray: (x: string) => x,
+			magenta: (x: string) => x,
+			red: (x: string) => x,
+			yellow: (x: string) => x,
+		};
+	}
+
+	const _never: never = mode;
+	throw new Error(`Unknown mode: ${_never}`);
+}
+
+/**
+ * Logging interface. Requires a message (string) and optionally an object to log, which is required to be a Plain Object to ensure serialisation.
+ */
+type LogFn = (msg: string, obj?: DeepReadonly<PlainObject>) => void;
+
+/**
+ * Logging interface that provides a way to log messages with different levels. It should be configured with sections. It can return a new instance with a new section.
+ */
+export type Logging = {
+	logger: PreparedLogger;
+	info: LogFn;
+	warn: LogFn;
+	debug: LogFn;
+	error: LogFn;
+	getSections(this: Logging): string[];
+	withSection(this: Logging, section: string, context?: PlainObject): Logging;
+};
+
+/**
+ * Variant of the Logging interface that stores the messages that have been logged.
+ */
+export type LoggingWithRecords = Omit<Logging, "withSection"> & {
+	withSection(
+		this: Logging,
+		section: string,
+		context?: PlainObject,
+	): LoggingWithRecords;
+	messages: {
+		info: Array<[string, PlainObject | null]>;
+		warn: Array<[string, PlainObject | null]>;
+		debug: Array<[string, PlainObject | null]>;
+		error: Array<[string, PlainObject | null]>;
+	};
+};
+
+/**
+ * Checks if the given Logging object is a LoggingWithRecords.
+ * @param obj
+ * @returns
+ */
+export function isLoggingWithRecords(obj: Logging): obj is LoggingWithRecords {
+	return "messages" in obj;
+}
+
+/**
+ * Creates a Logging object. It requires an actual pino logger to be sent, and optionally a section and a context.
+ */
+export function makeLogging(opts: {
+	section?: string;
+	context?: PlainObject;
+	logger: PreparedLogger;
+}): Logging {
+	const logger = loggerFor(
+		opts.logger,
+		opts.section ?? null,
+		opts.context ?? null,
+	);
+
+	return {
+		logger,
+		info: (msg, obj) => logger.info(obj, msg),
+		debug: (msg, obj) => logger.debug(obj, msg),
+		warn: (msg, obj) => logger.warn(obj, msg),
+		error: (msg, obj) => logger.error(obj, msg),
+		getSections(): string[] {
+			return getSectionsFromLogger(logger);
+		},
+		withSection(section, context) {
+			if (this.getSections().includes(section)) return this;
+
+			return makeLogging({ logger: this.logger, section, context });
+		},
+	};
+}
+
+/**
+ * Creates a LoggingWithRecords object. It requires an actual pino logger to be sent, and optionally a section and a context. You can pass it a "messages" record object to use or a new one will be created.
+ */
+export function makeLoggingWithRecord(opts: {
+	logger: PreparedLogger;
+	section?: string;
+	context?: PlainObject;
+	messages?: LoggingWithRecords["messages"];
+}): LoggingWithRecords {
+	const logging = makeLogging(opts);
+	const messages = opts.messages ?? {
+		info: [],
+		warn: [],
+		debug: [],
+		error: [],
+	};
+
+	function makeLogFn(logFn: LogFn, key: keyof typeof messages): LogFn {
+		return (msg, obj) => {
+			messages[key].push([msg, obj ?? null]);
+			return logFn(msg, obj);
+		};
+	}
+
+	return {
+		messages,
+		logger: logging.logger,
+		info: makeLogFn(logging.info, "info"),
+		debug: makeLogFn(logging.debug, "debug"),
+		warn: makeLogFn(logging.warn, "warn"),
+		error: makeLogFn(logging.error, "error"),
+		getSections(): string[] {
+			return logging.getSections();
+		},
+		withSection(section, context) {
+			return makeLoggingWithRecord({
+				logger: this.logger,
+				section,
+				messages,
+				context,
+			});
+		},
+	};
+}
+
+// INTERNAL
+
+function loggerFor(
+	givenLogger: PreparedLogger,
+	section: string | null,
+	context: PlainObject | null,
+) {
+	if (!context && (!section || loggerHasSection(givenLogger, section))) {
+		return givenLogger;
+	}
+
+	const childBindings: Record<string, PlainObjectValue> = { ...context };
+	if (section) {
+		childBindings.logSections = [
+			...getSectionsFromLogger(givenLogger),
+			section,
+		];
+	}
+
+	return givenLogger.child(childBindings);
+}
+
+function getSectionsFromLogger(logger: PreparedLogger) {
+	return logger.bindings().logSections ?? [];
+}
+
+function loggerHasSection(logger: PreparedLogger, section: string) {
+	const sections = getSectionsFromLogger(logger);
+	return sections.includes(section);
+}

package/dist/mod.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/mod.ts"],"sourcesContent":["import chalk from \"chalk\";\nimport { colorize } from \"json-colorizer\";\nimport type { Logger as PinoLogger } from \"pino\";\nimport { pino } from \"pino\";\nimport type { DeepReadonly } from \"simplytyped\";\n\nimport type { PlainObject, PlainObjectValue } from \"@plandek-utils/plain-object\";\n\n/**\n * Allowed log levels for the logger.\n */\nexport const LOG_LEVELS = [\"fatal\", \"error\", \"warn\", \"info\", \"debug\", \"trace\", \"silent\"] as const;\n\n/**\n * Possible log levels for preparing the pino logger.\n */\nexport type LogLevel = (typeof LOG_LEVELS)[number];\n\n/**\n * Parses the given log level, or returns the default level if it's not blank. If it is an invalid level it will throw an error.\n */\nexport function parseLogLevelOrDefault(level: string | null | undefined, defaultLevel: LogLevel): LogLevel {\n  if (!level) return defaultLevel;\n\n  const lowerLevel = level.toLowerCase() as LogLevel;\n  if (LOG_LEVELS.includes(lowerLevel)) {\n    return lowerLevel;\n  }\n\n  throw new Error(`Invalid log level: ${level}`);\n}\n\n/**\n * Prepared pino logger, returned by `buildPinoLogger` or `buildSinkLogger`.\n *\n * @see buildPinoLogger\n * @see buildSinkLogger\n */\nexport type PreparedLogger = Pick<PinoLogger, \"level\" | \"info\" | \"debug\" | \"warn\" | \"error\" | \"bindings\"> & {\n  child: (bindings: PlainObject) => PreparedLogger;\n};\n\n/**\n * Prepares a Pino logger with the common configuration.\n *\n * @param level - The log level to use.\n * @param redactPaths - Paths to redact from the logs. Defaults to `[\"req.headers.authorization\", \"req.headers.cookie\"]`.\n * @returns PinoLogger\n */\nexport function buildPinoLogger(level: LogLevel, redactPaths?: string[]): PreparedLogger {\n  const paths = redactPaths ?? [\"req.headers.authorization\", \"req.headers.cookie\"];\n  return pino({\n    level,\n    timestamp: pino.stdTimeFunctions.isoTime,\n    redact: { paths, censor: \"[REDACTED]\" },\n  });\n}\n\n/**\n * A mock logger that does nothing, holds no binding (sections).\n */\nexport function buildSinkLogger(level: LogLevel, givenBindings?: PlainObject): PreparedLogger {\n  const bindings = givenBindings ?? {};\n  return {\n    level,\n    info: () => {},\n    debug: () => {},\n    warn: () => {},\n    error: () => {},\n    child: (childBindings?: PlainObject) => buildSinkLogger(level, { ...bindings, ...childBindings }),\n    bindings: () => bindings,\n  };\n}\n\n/**\n * Util to serialise as JSON the given value, pretty-printed (2 spaces).\n */\nexport function prettyJSON(obj: unknown): string {\n  return JSON.stringify(obj, null, 2);\n}\n\n/**\n * Calls `prettyJSON` and then colourises the output.\n */\nexport function colourPrettyJSON(obj: unknown): string {\n  return colorize(prettyJSON(obj));\n}\n\n/**\n * Alias for `colourPrettyJSON`.\n * @see colourPrettyJSON\n */\nexport const colorPrettyJSON = colourPrettyJSON;\n\n/**\n * Interface to provide colouring for logs.\n */\nexport type LogColourUtils = {\n  blue: (x: string) => string;\n  cyan: (x: string) => string;\n  gray: (x: string) => string;\n  magenta: (x: string) => string;\n  red: (x: string) => string;\n  yellow: (x: string) => string;\n};\n\n/**\n * Creates a LogColourUtils object, with actual colours or not depending on the given mode.\n *\n * @param mode: if \"with-colour\", it will return a set of functions that will colour the given string. If \"plain\", it will return a set of functions that will return the string as is.\n */\nexport function makeColourUtils(mode: \"with-colour\" | \"plain\"): LogColourUtils {\n  if (mode === \"with-colour\") {\n    return {\n      blue: (x: string) => chalk.blue(x),\n      cyan: (x: string) => chalk.cyan(x),\n      gray: (x: string) => chalk.gray(x),\n      magenta: (x: string) => chalk.magenta(x),\n      red: (x: string) => chalk.red(x),\n      yellow: (x: string) => chalk.yellow(x),\n    };\n  }\n\n  if (mode === \"plain\") {\n    return {\n      blue: (x: string) => x,\n      cyan: (x: string) => x,\n      gray: (x: string) => x,\n      magenta: (x: string) => x,\n      red: (x: string) => x,\n      yellow: (x: string) => x,\n    };\n  }\n\n  const _never: never = mode;\n  throw new Error(`Unknown mode: ${_never}`);\n}\n\n/**\n * Logging interface. Requires a message (string) and optionally an object to log, which is required to be a Plain Object to ensure serialisation.\n */\ntype LogFn = (msg: string, obj?: DeepReadonly<PlainObject>) => void;\n\n/**\n * Logging interface that provides a way to log messages with different levels. It should be configured with sections. It can return a new instance with a new section.\n */\nexport type Logging = {\n  logger: PreparedLogger;\n  info: LogFn;\n  warn: LogFn;\n  debug: LogFn;\n  error: LogFn;\n  getSections(this: Logging): string[];\n  withSection(this: Logging, section: string, context?: PlainObject): Logging;\n};\n\n/**\n * Variant of the Logging interface that stores the messages that have been logged.\n */\nexport type LoggingWithRecords = Omit<Logging, \"withSection\"> & {\n  withSection(this: Logging, section: string, context?: PlainObject): LoggingWithRecords;\n  messages: {\n    info: Array<[string, PlainObject | null]>;\n    warn: Array<[string, PlainObject | null]>;\n    debug: Array<[string, PlainObject | null]>;\n    error: Array<[string, PlainObject | null]>;\n  };\n};\n\n/**\n * Checks if the given Logging object is a LoggingWithRecords.\n * @param obj\n * @returns\n */\nexport function isLoggingWithRecords(obj: Logging): obj is LoggingWithRecords {\n  return \"messages\" in obj;\n}\n\n/**\n * Creates a Logging object. It requires an actual pino logger to be sent, and optionally a section and a context.\n */\nexport function makeLogging(opts: {\n  section?: string;\n  context?: PlainObject;\n  logger: PreparedLogger;\n}): Logging {\n  const logger = loggerFor(opts.logger, opts.section ?? null, opts.context ?? null);\n\n  return {\n    logger,\n    info: (msg, obj) => logger.info(obj, msg),\n    debug: (msg, obj) => logger.debug(obj, msg),\n    warn: (msg, obj) => logger.warn(obj, msg),\n    error: (msg, obj) => logger.error(obj, msg),\n    getSections(): string[] {\n      return getSectionsFromLogger(logger);\n    },\n    withSection(section, context) {\n      if (this.getSections().includes(section)) return this;\n\n      return makeLogging({ logger: this.logger, section, context });\n    },\n  };\n}\n\n/**\n * Creates a LoggingWithRecords object. It requires an actual pino logger to be sent, and optionally a section and a context. You can pass it a \"messages\" record object to use or a new one will be created.\n */\nexport function makeLoggingWithRecord(opts: {\n  logger: PreparedLogger;\n  section?: string;\n  context?: PlainObject;\n  messages?: LoggingWithRecords[\"messages\"];\n}): LoggingWithRecords {\n  const logging = makeLogging(opts);\n  const messages = opts.messages ?? {\n    info: [],\n    warn: [],\n    debug: [],\n    error: [],\n  };\n\n  function makeLogFn(logFn: LogFn, key: keyof typeof messages): LogFn {\n    return (msg, obj) => {\n      messages[key].push([msg, obj ?? null]);\n      return logFn(msg, obj);\n    };\n  }\n\n  return {\n    messages,\n    logger: logging.logger,\n    info: makeLogFn(logging.info, \"info\"),\n    debug: makeLogFn(logging.debug, \"debug\"),\n    warn: makeLogFn(logging.warn, \"warn\"),\n    error: makeLogFn(logging.error, \"error\"),\n    getSections(): string[] {\n      return logging.getSections();\n    },\n    withSection(section, context) {\n      return makeLoggingWithRecord({\n        logger: this.logger,\n        section,\n        messages,\n        context,\n      });\n    },\n  };\n}\n\n// INTERNAL\n\nfunction loggerFor(givenLogger: PreparedLogger, section: string | null, context: PlainObject | null) {\n  if (!context && (!section || loggerHasSection(givenLogger, section))) {\n    return givenLogger;\n  }\n\n  const childBindings: Record<string, PlainObjectValue> = { ...context };\n  if (section) {\n    childBindings.logSections = [...getSectionsFromLogger(givenLogger), section];\n  }\n\n  return givenLogger.child(childBindings);\n}\n\nfunction getSectionsFromLogger(logger: PreparedLogger) {\n  return logger.bindings().logSections ?? [];\n}\n\nfunction loggerHasSection(logger: PreparedLogger, section: string) {\n  const sections = getSectionsFromLogger(logger);\n  return sections.includes(section);\n}\n"],"mappings":"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","names":[]}