chore(deps): add pino logger dependency

Add pino v10.3.1 to project dependencies for structured logging support, along with its transitive dependencies (pino-abstract-transport, pino-std-serializers, quick-format-unescaped, atomic-sleep, etc.).
2026-06-11 14:23:30 +08:00
parent 2b6d3924fd
commit d189a18f03
3 changed files with 167 additions and 0 deletions
@@ -23,6 +23,7 @@
    "next": "16.2.7",
    "next-auth": "^4.24.14",
    "ofetch": "^1.5.1",
+    "pino": "^10.3.1",
    "react": "19.2.4",
    "react-dom": "19.2.4",
    "unstorage": "^1.17.5",
@@ -32,6 +32,9 @@ importers:
      ofetch:
        specifier: ^1.5.1
        version: 1.5.1
+      pino:
+        specifier: ^10.3.1
+        version: 10.3.1
      react:
        specifier: 19.2.4
        version: 19.2.4
@@ -561,6 +564,9 @@ packages:
  '@panva/hkdf@1.2.1':
    resolution: {integrity: sha512-6oclG6Y3PiDFcoyk8srjLfVKyMfVCKJ27JwNPViuXziFpmdz+MZnZN/aKY0JGXgYuO/VghU0jcOAZgWXZ1Dmrw==}

+  '@pinojs/redact@0.4.0':
+    resolution: {integrity: sha512-k2ENnmBugE/rzQfEcdWHcCY+/FM3VLzH9cYEsbdsoqrvzAKRhUZeRNhAZvB8OitQJ1TBed3yqWtdjzS6wJKBwg==}
+
  '@polka/url@1.0.0-next.29':
    resolution: {integrity: sha512-wwQAWhWSuHaag8c4q/KN/vCoeOJYshAIvMQwD4GpSb3OiZklFfvAgmj0VCBBImRpuF/aFgIRzllXlVX93Jevww==}

@@ -1111,6 +1117,10 @@ packages:
    resolution: {integrity: sha512-hsU18Ae8CDTR6Kgu9DYf0EbCr/a5iGL0rytQDobUcdpYOKokk8LEjVphnXkDkgpi0wYVsqrXuP0bZxJaTqdgoA==}
    engines: {node: '>= 0.4'}

+  atomic-sleep@1.0.0:
+    resolution: {integrity: sha512-kNOjDqAh7px0XWNI+4QbzoiR/nTkHAWNud2uvnJquD1/x5a7EQZMJT0AczqK0Qn67oY/TTQ1LbUKajZpp3I9tQ==}
+    engines: {node: '>=8.0.0'}
+
  available-typed-arrays@1.0.7:
    resolution: {integrity: sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ==}
    engines: {node: '>= 0.4'}
@@ -2189,6 +2199,10 @@ packages:
    resolution: {integrity: sha512-6gj2m8cJZ+iSW8bm0FXdGF0YhIQbKrfP4yWTNzxc31U6MOjfEmB1rHvlYvxI1B7t7BCi1F2vYTT6YhtQRG4hxw==}
    engines: {node: ^10.13.0 || >=12.0.0}

+  on-exit-leak-free@2.1.2:
+    resolution: {integrity: sha512-0eJJY6hXLGf1udHwfNftBqH+g73EU4B504nZeKpz1sYRKafAghwxEJunB2O7rDZkL4PGfsMVnTXZ2EjibbqcsA==}
+    engines: {node: '>=14.0.0'}
+
  openid-client@5.7.1:
    resolution: {integrity: sha512-jDBPgSVfTnkIh71Hg9pRvtJc6wTwqjRkN88+gCFtYWrlP4Yx2Dsrow8uPi3qLr/aeymPF3o2+dS+wOpglK04ew==}

@@ -2264,6 +2278,16 @@ packages:
    resolution: {integrity: sha512-C3FsVNH1udSEX48gGX1xfvwTWfsYWj5U+8/uK15BGzIGrKoUpghX8hWZwa/OFnakBiiVNmBvemTJR5mcy7iPcg==}
    engines: {node: '>=4'}

+  pino-abstract-transport@3.0.0:
+    resolution: {integrity: sha512-wlfUczU+n7Hy/Ha5j9a/gZNy7We5+cXp8YL+X+PG8S0KXxw7n/JXA3c46Y0zQznIJ83URJiwy7Lh56WLokNuxg==}
+
+  pino-std-serializers@7.1.0:
+    resolution: {integrity: sha512-BndPH67/JxGExRgiX1dX0w1FvZck5Wa4aal9198SrRhZjH3GxKQUKIBnYJTdj2HDN3UQAS06HlfcSbQj2OHmaw==}
+
+  pino@10.3.1:
+    resolution: {integrity: sha512-r34yH/GlQpKZbU1BvFFqOjhISRo1MNx1tWYsYvmj6KIRHSPMT2+yHOEb1SG6NMvRoHRF0a07kCOox/9yakl1vg==}
+    hasBin: true
+
  pkg-conf@2.1.0:
    resolution: {integrity: sha512-C+VUP+8jis7EsQZIhDYmS5qlNtjv2yP4SNtjXK9AP1ZcTRlnSfuumaTnRfYZnYgUUYVIKqL0fRvmUGDV2fmp6g==}
    engines: {node: '>=4'}
@@ -2295,6 +2319,9 @@ packages:
  pretty-format@3.8.0:
    resolution: {integrity: sha512-WuxUnVtlWL1OfZFQFuqvnvs6MiAGk9UNsBostyBOB0Is9wb5uRESevA6rnl/rkksXaGX3GzZhPup5d6Vp1nFew==}

+  process-warning@5.0.0:
+    resolution: {integrity: sha512-a39t9ApHNx2L4+HBnQKqxxHNs1r7KF+Intd8Q/g1bUh6q0WIp9voPXJ/x0j+ZL45KF1pJd9+q2jLIRMfvEshkA==}
+
  prop-types@15.8.1:
    resolution: {integrity: sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg==}

@@ -2305,6 +2332,9 @@ packages:
  queue-microtask@1.2.3:
    resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==}

+  quick-format-unescaped@4.0.4:
+    resolution: {integrity: sha512-tYC1Q1hgyRuHgloV/YXs2w15unPVh8qfu/qCTfhTYamaw7fyhumKa2yGpdSo87vY32rIclj+4fWYQXUMs9EHvg==}
+
  radix3@1.1.2:
    resolution: {integrity: sha512-b484I/7b8rDEdSDKckSSBA8knMpcdsXudlE/LNL639wFoHKwLbEkQFZHWEYwDC0wa0FKUcCY+GAF73Z7wxNVFA==}

@@ -2324,6 +2354,13 @@ packages:
    resolution: {integrity: sha512-9u/XQ1pvrQtYyMpZe7DXKv2p5CNvyVwzUB6uhLAnQwHMSgKMBR62lc7AHljaeteeHXn11XTAaLLUVZYVZyuRBQ==}
    engines: {node: '>= 20.19.0'}

+  real-require@0.2.0:
+    resolution: {integrity: sha512-57frrGM/OCTLqLOAh0mhVA9VBMHd+9U7Zb2THMGdBUoZVOtGbJzjxsYGDJ3A9AYYCP4hn6y1TVbaOfzWtm5GFg==}
+    engines: {node: '>= 12.13.0'}
+
+  real-require@1.0.0:
+    resolution: {integrity: sha512-P4nbQYQfePJxRSmY+v/KINxVucm4NF3p3s7pJveMTtom52FR4YGltUQLB8idDXwDDWW+eYrWDFbuzUnjoWHF7g==}
+
  reflect.getprototypeof@1.0.10:
    resolution: {integrity: sha512-00o4I+DVrefhv+nX0ulyi3biSHCPDe+yLv5o/p6d/UVlirijB8E16FtfwSAi4g3tcqrQ4lRAqQSoFEZJehYEcw==}
    engines: {node: '>= 0.4'}
@@ -2376,6 +2413,10 @@ packages:
    resolution: {integrity: sha512-x/+Cz4YrimQxQccJf5mKEbIa1NzeCRNI5Ecl/ekmlYaampdNLPalVyIcCZNNH3MvmqBugV5TMYZXv0ljslUlaw==}
    engines: {node: '>= 0.4'}

+  safe-stable-stringify@2.5.0:
+    resolution: {integrity: sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA==}
+    engines: {node: '>=10'}
+
  saxes@6.0.0:
    resolution: {integrity: sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==}
    engines: {node: '>=v12.22.7'}
@@ -2443,6 +2484,9 @@ packages:
    resolution: {integrity: sha512-2wcC/oGxHis/BoHkkPwldgiPSYcpZK3JU28WoMVv55yHJgcZ8rlXvuG9iZggz+sU1d4bRgIGASwyWqjxu3FM0g==}
    engines: {node: '>=18'}

+  sonic-boom@4.2.1:
+    resolution: {integrity: sha512-w6AxtubXa2wTXAUsZMMWERrsIRAdrK0Sc+FUytWvYAhBJLyuI4llrMIC1DtlNSdI99EI86KZum2MMq3EAZlF9Q==}
+
  source-map-js@1.2.1:
    resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==}
    engines: {node: '>=0.10.0'}
@@ -2454,6 +2498,10 @@ packages:
    resolution: {integrity: sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==}
    engines: {node: '>=0.10.0'}

+  split2@4.2.0:
+    resolution: {integrity: sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==}
+    engines: {node: '>= 10.x'}
+
  stable-hash@0.0.5:
    resolution: {integrity: sha512-+L3ccpzibovGXFK+Ap/f8LOS0ahMrHTf3xu7mMLSpEGU0EO9ucaysSylKo9eRDFNhWve/y275iPmIZ4z39a9iA==}

@@ -2546,6 +2594,10 @@ packages:
    engines: {node: '>=10'}
    hasBin: true

+  thread-stream@4.2.0:
+    resolution: {integrity: sha512-e2zZ96wSChazBsbENf/Pcm/4swHt2cEKQ92rhUjkL9GCKiTDJIaTBenjE/m9DXi0QBmTMDkFDdOomUy20A1tDQ==}
+    engines: {node: '>=20'}
+
  tinybench@2.9.0:
    resolution: {integrity: sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==}

@@ -3328,6 +3380,8 @@ snapshots:

  '@panva/hkdf@1.2.1': {}

+  '@pinojs/redact@0.4.0': {}
+
  '@polka/url@1.0.0-next.29': {}

  '@rolldown/binding-android-arm64@1.0.3':
@@ -3842,6 +3896,8 @@ snapshots:

  async-function@1.0.0: {}

+  atomic-sleep@1.0.0: {}
+
  available-typed-arrays@1.0.7:
    dependencies:
      possible-typed-array-names: 1.1.0
@@ -5044,6 +5100,8 @@ snapshots:

  oidc-token-hash@5.2.0: {}

+  on-exit-leak-free@2.1.2: {}
+
  openid-client@5.7.1:
    dependencies:
      jose: 4.15.9
@@ -5115,6 +5173,26 @@ snapshots:

  pify@3.0.0: {}

+  pino-abstract-transport@3.0.0:
+    dependencies:
+      split2: 4.2.0
+
+  pino-std-serializers@7.1.0: {}
+
+  pino@10.3.1:
+    dependencies:
+      '@pinojs/redact': 0.4.0
+      atomic-sleep: 1.0.0
+      on-exit-leak-free: 2.1.2
+      pino-abstract-transport: 3.0.0
+      pino-std-serializers: 7.1.0
+      process-warning: 5.0.0
+      quick-format-unescaped: 4.0.4
+      real-require: 0.2.0
+      safe-stable-stringify: 2.5.0
+      sonic-boom: 4.2.1
+      thread-stream: 4.2.0
+
  pkg-conf@2.1.0:
    dependencies:
      find-up: 2.1.0
@@ -5145,6 +5223,8 @@ snapshots:

  pretty-format@3.8.0: {}

+  process-warning@5.0.0: {}
+
  prop-types@15.8.1:
    dependencies:
      loose-envify: 1.4.0
@@ -5155,6 +5235,8 @@ snapshots:

  queue-microtask@1.2.3: {}

+  quick-format-unescaped@4.0.4: {}
+
  radix3@1.1.2: {}

  react-dom@19.2.4(react@19.2.4):
@@ -5168,6 +5250,10 @@ snapshots:

  readdirp@5.0.0: {}

+  real-require@0.2.0: {}
+
+  real-require@1.0.0: {}
+
  reflect.getprototypeof@1.0.10:
    dependencies:
      call-bind: 1.0.9
@@ -5251,6 +5337,8 @@ snapshots:
      es-errors: 1.3.0
      is-regex: 1.2.1

+  safe-stable-stringify@2.5.0: {}
+
  saxes@6.0.0:
    dependencies:
      xmlchars: 2.2.0
@@ -5363,6 +5451,10 @@ snapshots:
      mrmime: 2.0.1
      totalist: 3.0.1

+  sonic-boom@4.2.1:
+    dependencies:
+      atomic-sleep: 1.0.0
+
  source-map-js@1.2.1: {}

  source-map-support@0.5.21:
@@ -5374,6 +5466,8 @@ snapshots:
  source-map@0.6.1:
    optional: true

+  split2@4.2.0: {}
+
  stable-hash@0.0.5: {}

  stackback@0.0.2: {}
@@ -5480,6 +5574,10 @@ snapshots:
      source-map-support: 0.5.21
    optional: true

+  thread-stream@4.2.0:
+    dependencies:
+      real-require: 1.0.0
+
  tinybench@2.9.0: {}

  tinyexec@1.2.4: {}
@@ -0,0 +1,68 @@
+import pino, { type Logger as PinoLogger, type LoggerOptions } from "pino";
+
+import { isProduction, isTest } from "./app-env";
+
+/**
+ * 全局 pino root logger（单例，进程级复用）。
+ *
+ * 配置驱动（基于 `app-env.ts` 的 `isProduction()` / `isTest()`）：
+ *   - production:  info 级别 + JSON（机器可解析，接入日志平台）
+ *   - test:        warn 级别（减少 vitest 噪音）
+ *   - development: debug 级别 + ISO 时间戳（人眼友好）
+ */
+const rootLogger: PinoLogger = pino(createLoggerOptions());
+
+function createLoggerOptions(): LoggerOptions {
+  if (isProduction()) {
+    return { level: "info" };
+  }
+  if (isTest()) {
+    return { level: "warn" };
+  }
+  // development
+  return { level: "debug", timestamp: pino.stdTimeFunctions.isoTime };
+}
+
+/**
+ * Logger 工具类（pino 包装）
+ *
+ * 设计：
+ *   - 构造时绑定 `component` 名（业务模块标识）
+ *   - 所有日志自动带 `{ component: "AuthRepository" }` 字段
+ *   - 透传 pino 原生 5 个 level：debug / info / warn / error / fatal
+ *
+ * 用法：
+ *   const log = new Logger("AuthRepository");
+ *   log.info("login success");
+ *   log.warn({ err }, "storage write failed");
+ *   log.error(e, "consumer error");
+ *   log.debug({ userId: 123 }, "fetched user");
+ */
+export class Logger {
+  private readonly logger: PinoLogger;
+
+  constructor(component: string) {
+    this.logger = rootLogger.child({ component });
+  }
+
+  debug(...args: Parameters<PinoLogger["debug"]>): void {
+    this.logger.debug(...args);
+  }
+  info(...args: Parameters<PinoLogger["info"]>): void {
+    this.logger.info(...args);
+  }
+  warn(...args: Parameters<PinoLogger["warn"]>): void {
+    this.logger.warn(...args);
+  }
+  error(...args: Parameters<PinoLogger["error"]>): void {
+    this.logger.error(...args);
+  }
+  fatal(...args: Parameters<PinoLogger["fatal"]>): void {
+    this.logger.fatal(...args);
+  }
+
+  /** 透传 raw pino logger（高级用法：自定义 binding / child / serializers） */
+  get raw(): PinoLogger {
+    return this.logger;
+  }
+}