@pori15/logixlysia 6.0.15 → 6.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pori15/logixlysia",
-  "version": "6.0.15",
+  "version": "6.0.16",
   "description": "🦊 Logixlysia is a logger for Elysia",
   "type": "module",
   "exports": {

package/src/index.ts

@@ -123,7 +123,8 @@ export type { Code } from "./error/type";
 // Utils Exports
 // ==========================================
 
-export { getErrorCode } from "./utils/get-error-code";
+export type { ErrorMeta } from "./utils/get-error-code";
+export { getErrorCode, getErrorMeta } from "./utils/get-error-code";
 export { normalizeToProblem } from "./utils/handle-error";
 
 // ==========================================

package/src/interfaces.ts

@@ -4,6 +4,7 @@ import type {
 } from "pino";
 import type { ProblemError } from "./error/errors";
 import type { Code } from "./error/type";
+import type { ErrorMeta } from "./utils/get-error-code";
 
 /** Pino Logger 实例类型 */
 export type Pino = PinoLogger<never, boolean>;
@@ -64,8 +65,8 @@ export interface LogRotationConfig {
 
 /** 错误码到 HTTP 响应的映射条目 */
 export interface ErrorMapping {
-  /** 错误详情描述 */
-  detail?: string;
+  /** 错误详情，支持静态文案或根据数据库错误元数据动态生成 */
+  detail?: string | ((meta: ErrorMeta) => string);
   /** HTTP 状态码 */
   status: number;
   /** 错误标题 */

package/src/utils/get-error-code.ts

@@ -21,3 +21,56 @@ export const getErrorCode = (error: unknown): string | undefined => {
 
   return undefined;
 };
+
+/** 从数据库错误中提取的结构化元数据 */
+export interface ErrorMeta {
+  /** 错误码（如 Postgres "23505"） */
+  code: string;
+  /** 列名（部分驱动提供） */
+  column?: string;
+  /** 约束名（如 "uk_site_product_slug"） */
+  constraint?: string;
+  /** 数据库原生详情（如 "Key (slug)=(xxx) already exists."） */
+  detail?: string;
+  /** 表名 */
+  table?: string;
+}
+
+/**
+ * 递归提取数据库错误的元数据
+ * 从 Postgres / MySQL 等驱动的错误对象中提取 constraint、table、column、detail 等字段
+ */
+export const getErrorMeta = (error: unknown): ErrorMeta | undefined => {
+  if (typeof error !== "object" || error === null) return undefined;
+
+  const obj = error as Record<string, unknown>;
+
+  if ("code" in obj && typeof obj.code === "string") {
+    return {
+      code: obj.code,
+      column:
+        "column" in obj && typeof obj.column === "string"
+          ? obj.column
+          : undefined,
+      constraint:
+        "constraint" in obj && typeof obj.constraint === "string"
+          ? obj.constraint
+          : undefined,
+      detail:
+        "detail" in obj && typeof obj.detail === "string"
+          ? obj.detail
+          : undefined,
+      table:
+        "table_name" in obj && typeof obj.table_name === "string"
+          ? obj.table_name
+          : "table" in obj && typeof obj.table === "string"
+            ? obj.table
+            : undefined,
+    };
+  }
+
+  if ("cause" in obj) return getErrorMeta(obj.cause);
+  if ("error" in obj) return getErrorMeta(obj.error);
+
+  return undefined;
+};

package/src/utils/handle-error.ts

@@ -17,7 +17,7 @@ import {
 } from "../error/errors";
 import type { Code } from "../error/type";
 import type { ErrorMapping, ErrorResolver } from "../interfaces";
-import { getErrorCode } from "./get-error-code";
+import { getErrorCode, getErrorMeta } from "./get-error-code";
 
 // Layer 5: Elysia 内置错误码映射
 const CODE_MAP: Record<
@@ -98,15 +98,19 @@ export const normalizeToProblem = (
   }
 
   // ==========================================
-  // Layer 4: errorMap 查表（递归 getErrorCode）
+  // Layer 4: errorMap 查表（递归 getErrorCode / getErrorMeta）
   // ==========================================
   if (errorMap) {
     const errorCode = getErrorCode(error);
     if (errorCode && errorCode in errorMap) {
       const mapping = errorMap[errorCode];
+      const detail =
+        typeof mapping.detail === "function"
+          ? mapping.detail(getErrorMeta(error) ?? { code: errorCode })
+          : mapping.detail;
       return createProblem(mapping.status, {
         title: mapping.title,
-        detail: mapping.detail,
+        detail,
         type: buildType(errorCode),
         instance: path,
       });