@dofe/infra-common 0.1.1

package/dist/ts-rest/response.helper.d.ts

@@ -0,0 +1,261 @@
+/**
+ * ts-rest Response Helpers
+ * ts-rest 响应辅助工具
+ *
+ * 提供标准化的响应格式：
+ * - 成功响应：{ code: 200, msg: 'ok', data: ... }
+ * - 错误响应：{ code: xxx, msg: 'xxxx', data: { error: ... } }
+ *
+ * 配合 ApiResponseSchema 定义的 Contract 使用
+ */
+import { ApiErrorCode } from '@dofe/infra-contracts';
+/**
+ * 标准成功响应格式
+ */
+export interface SuccessBody<T> {
+    code: number;
+    msg: string;
+    data: T;
+}
+/**
+ * 标准错误响应格式（用于 ts-rest，使用 data 字段）
+ */
+export interface ErrorBody<T = unknown> {
+    code: number;
+    msg: string;
+    data: T;
+}
+/**
+ * ts-rest 处理器响应类型
+ */
+export type TsRestResponse<T, S extends number = 200> = {
+    status: S;
+    body: SuccessBody<T>;
+};
+/**
+ * ts-rest 成功响应类型（仅包含成功体）
+ */
+export type TsRestSuccessResponse<T, S extends number = 200> = {
+    status: S;
+    body: SuccessBody<T>;
+};
+/**
+ * 创建成功响应
+ *
+ * @example
+ * ```typescript
+ * @TsRestHandler(c.getItem)
+ * async getItem() {
+ *   return tsRestHandler(c.getItem, async ({ params }) => {
+ *     const data = await this.service.findById(params.id);
+ *     return success(data);
+ *   });
+ * }
+ * ```
+ */
+export declare function success<T>(data: T, status?: 200): TsRestSuccessResponse<T, 200>;
+/**
+ * 创建分页成功响应
+ *
+ * @example
+ * ```typescript
+ * return paginated(items, total, query.page, query.limit);
+ * ```
+ */
+export declare function paginated<T>(list: T[], total: number, page: number, limit: number): TsRestSuccessResponse<{
+    list: T[];
+    total: number;
+    page: number;
+    limit: number;
+}, 200>;
+/**
+ * 创建 201 响应（创建成功）
+ */
+export declare function created<T>(data: T): TsRestSuccessResponse<T, 201>;
+/**
+ * 创建删除成功响应
+ */
+export declare function deleted(): TsRestResponse<{
+    success: boolean;
+}, 200>;
+/**
+ * 创建成功响应体（用于普通 NestJS 控制器，不使用 ts-rest）
+ *
+ * @example
+ * ```typescript
+ * @Get('items')
+ * async getItems() {
+ *   const items = await this.service.findAll();
+ *   return successBody({ list: items });
+ * }
+ * ```
+ */
+export declare function successBody<T>(data: T): SuccessBody<T>;
+/**
+ * 创建分页成功响应体（用于普通 NestJS 控制器）
+ */
+export declare function paginatedBody<T>(list: T[], total: number, page: number, limit: number): SuccessBody<{
+    list: T[];
+    total: number;
+    page: number;
+    limit: number;
+}>;
+/**
+ * 创建删除成功响应体（用于普通 NestJS 控制器）
+ */
+export declare function deletedBody(): SuccessBody<{
+    success: boolean;
+}>;
+/**
+ * 创建错误响应体（用于普通 NestJS 控制器）
+ */
+export declare function errorBody<T = unknown>(errorCode: ApiErrorCode, errorData?: T): ErrorBody<T>;
+export declare function deletedWithData<T>(data: T): TsRestResponse<T, 200>;
+/**
+ * HTTP Status 字面量类型
+ */
+type HttpStatus = 200 | 201 | 204 | 400 | 401 | 403 | 404 | 409 | 410 | 429 | 500;
+/**
+ * 创建 ts-rest 错误响应（使用 data 字段，符合 ApiResponseSchema）
+ *
+ * 注意：此函数返回 status: 200 类型以兼容 ts-rest 类型推断。
+ * 实际 HTTP 状态码由 errorCode 决定。
+ *
+ * @example
+ * ```typescript
+ * if (!item) {
+ *   return error(CommonErrorCode.NotFound, { error: 'Item not found' });
+ * }
+ * ```
+ */
+export declare function error<T = {
+    error: string;
+}>(errorCode: ApiErrorCode, errorData?: T): {
+    status: HttpStatus;
+    body: SuccessBody<T>;
+};
+/**
+ * 404 Not Found 错误响应（类型安全）
+ *
+ * @example
+ * ```typescript
+ * if (!item) {
+ *   return notFound('Item not found');
+ * }
+ * ```
+ */
+export declare function notFound<T = {
+    error: string;
+}>(errorData?: T): {
+    status: 404;
+    body: SuccessBody<T>;
+};
+/**
+ * 400 Bad Request 错误响应（类型安全）
+ */
+export declare function badRequest<T = {
+    error: string;
+}>(errorData?: T): {
+    status: 400;
+    body: SuccessBody<T>;
+};
+/**
+ * 401 Unauthorized 错误响应（类型安全）
+ */
+export declare function unauthorized<T = {
+    error: string;
+}>(errorData?: T): {
+    status: 401;
+    body: SuccessBody<T>;
+};
+/**
+ * 403 Forbidden 错误响应（类型安全）
+ */
+export declare function forbidden<T = {
+    error: string;
+}>(errorData?: T): {
+    status: 403;
+    body: SuccessBody<T>;
+};
+/**
+ * 409 Conflict 错误响应（类型安全）
+ */
+export declare function conflict<T = {
+    error: string;
+}>(errorData?: T): {
+    status: 409;
+    body: SuccessBody<T>;
+};
+/**
+ * 500 Internal Server Error 响应（类型安全）
+ */
+export declare function internalError<T = {
+    error: string;
+}>(errorData?: T): {
+    status: 500;
+    body: SuccessBody<T>;
+};
+/**
+ * 从错误码创建符合 Contract 标准的错误响应
+ *
+ * 与 error() 相同，提供更好的语义化命名。
+ *
+ * @example
+ * ```typescript
+ * if (!item) {
+ *   return errorResponse(CommonErrorCode.NotFound, { error: 'Item not found' });
+ * }
+ * ```
+ */
+export declare function errorResponse<T = {
+    error: string;
+}>(errorCode: ApiErrorCode, errorData?: T): {
+    status: HttpStatus;
+    body: SuccessBody<T>;
+};
+/**
+ * 从错误类型字符串创建错误响应
+ *
+ * @example
+ * ```typescript
+ * return errorFromType('userNotFound', 200401, 404);
+ * ```
+ */
+export declare function errorFromType<T = unknown>(errorType: string, errorCode: number, httpStatus?: HttpStatus, errorData?: T): {
+    status: HttpStatus;
+    body: SuccessBody<T>;
+};
+/**
+ * 创建简单错误响应（不带 error 详情）
+ */
+export declare function errorSimple(code: number, msg: string, httpStatus?: HttpStatus): {
+    status: HttpStatus;
+    body: SuccessBody<unknown>;
+};
+/**
+ * 递归地将对象中的 Date 类型转换为 ISO 字符串
+ * 用于确保 ts-rest 响应符合 zod schema（Date 字段定义为 z.coerce.date()）
+ *
+ * @example
+ * ```typescript
+ * const data = await this.service.findById(id);
+ * return success(serializeDates(data));
+ * ```
+ */
+export declare function serializeDates<T>(obj: T): any;
+/**
+ * 安全获取数据 - 如果查询抛出 NotFoundException 则返回 null
+ * 用于配合 notFound() 辅助函数，简化类型安全的错误处理
+ *
+ * @example
+ * ```typescript
+ * const result = await fetchOrNull(() =>
+ *   this.service.findById(params.id),
+ * );
+ * if (result === null) return notFound({ error: 'Item not found' });
+ * return success(result);
+ * ```
+ */
+export declare function fetchOrNull<T>(fn: () => Promise<T>): Promise<T | null>;
+export {};
+//# sourceMappingURL=response.helper.d.ts.map

package/dist/ts-rest/response.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.helper.d.ts","sourceRoot":"","sources":["../../src/ts-rest/response.helper.ts"],"names":[],"mappings":"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"}

package/dist/ts-rest/response.helper.js

@@ -0,0 +1,372 @@
+"use strict";
+/**
+ * ts-rest Response Helpers
+ * ts-rest 响应辅助工具
+ *
+ * 提供标准化的响应格式：
+ * - 成功响应：{ code: 200, msg: 'ok', data: ... }
+ * - 错误响应：{ code: xxx, msg: 'xxxx', data: { error: ... } }
+ *
+ * 配合 ApiResponseSchema 定义的 Contract 使用
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.success = success;
+exports.paginated = paginated;
+exports.created = created;
+exports.deleted = deleted;
+exports.successBody = successBody;
+exports.paginatedBody = paginatedBody;
+exports.deletedBody = deletedBody;
+exports.errorBody = errorBody;
+exports.deletedWithData = deletedWithData;
+exports.error = error;
+exports.notFound = notFound;
+exports.badRequest = badRequest;
+exports.unauthorized = unauthorized;
+exports.forbidden = forbidden;
+exports.conflict = conflict;
+exports.internalError = internalError;
+exports.errorResponse = errorResponse;
+exports.errorFromType = errorFromType;
+exports.errorSimple = errorSimple;
+exports.serializeDates = serializeDates;
+exports.fetchOrNull = fetchOrNull;
+const infra_contracts_1 = require("@dofe/infra-contracts");
+/**
+ * 创建成功响应
+ *
+ * @example
+ * ```typescript
+ * @TsRestHandler(c.getItem)
+ * async getItem() {
+ *   return tsRestHandler(c.getItem, async ({ params }) => {
+ *     const data = await this.service.findById(params.id);
+ *     return success(data);
+ *   });
+ * }
+ * ```
+ */
+function success(data, status = 200) {
+    return {
+        status,
+        body: {
+            code: 200,
+            msg: 'ok',
+            data: serializeDates(data),
+        },
+    };
+}
+/**
+ * 创建分页成功响应
+ *
+ * @example
+ * ```typescript
+ * return paginated(items, total, query.page, query.limit);
+ * ```
+ */
+function paginated(list, total, page, limit) {
+    return success({ list, total, page, limit });
+}
+/**
+ * 创建 201 响应（创建成功）
+ */
+function created(data) {
+    return {
+        status: 201,
+        body: {
+            code: 200,
+            msg: 'ok',
+            data: serializeDates(data),
+        },
+    };
+}
+/**
+ * 创建删除成功响应
+ */
+function deleted() {
+    return {
+        status: 200,
+        body: {
+            code: 200,
+            msg: 'ok',
+            data: { success: true },
+        },
+    };
+}
+// ============================================================================
+// Plain NestJS Controller Helpers (不使用 ts-rest 的控制器)
+// ============================================================================
+/**
+ * 创建成功响应体（用于普通 NestJS 控制器，不使用 ts-rest）
+ *
+ * @example
+ * ```typescript
+ * @Get('items')
+ * async getItems() {
+ *   const items = await this.service.findAll();
+ *   return successBody({ list: items });
+ * }
+ * ```
+ */
+function successBody(data) {
+    return {
+        code: 200,
+        msg: 'ok',
+        data: serializeDates(data),
+    };
+}
+/**
+ * 创建分页成功响应体（用于普通 NestJS 控制器）
+ */
+function paginatedBody(list, total, page, limit) {
+    return successBody({ list, total, page, limit });
+}
+/**
+ * 创建删除成功响应体（用于普通 NestJS 控制器）
+ */
+function deletedBody() {
+    return {
+        code: 200,
+        msg: 'ok',
+        data: { success: true },
+    };
+}
+/**
+ * 创建错误响应体（用于普通 NestJS 控制器）
+ */
+function errorBody(errorCode, errorData) {
+    const errorType = (0, infra_contracts_1.getErrorType)(errorCode) || 'unknown';
+    const numericCode = Number(errorCode);
+    const msg = (0, infra_contracts_1.getErrorMessage)(errorType);
+    return {
+        code: numericCode,
+        msg,
+        data: errorData,
+    };
+}
+function deletedWithData(data) {
+    return {
+        status: 200,
+        body: {
+            code: 200,
+            msg: 'ok',
+            data: serializeDates(data),
+        },
+    };
+}
+/**
+ * 创建 ts-rest 错误响应（使用 data 字段，符合 ApiResponseSchema）
+ *
+ * 注意：此函数返回 status: 200 类型以兼容 ts-rest 类型推断。
+ * 实际 HTTP 状态码由 errorCode 决定。
+ *
+ * @example
+ * ```typescript
+ * if (!item) {
+ *   return error(CommonErrorCode.NotFound, { error: 'Item not found' });
+ * }
+ * ```
+ */
+function error(errorCode, errorData) {
+    const errorType = (0, infra_contracts_1.getErrorType)(errorCode) || 'unknown';
+    const httpStatus = (0, infra_contracts_1.getHttpStatus)(errorCode);
+    const numericCode = Number(errorCode);
+    const msg = (0, infra_contracts_1.getErrorMessage)(errorType);
+    return {
+        status: httpStatus,
+        body: {
+            code: numericCode,
+            msg,
+            data: errorData,
+        },
+    };
+}
+/**
+ * 404 Not Found 错误响应（类型安全）
+ *
+ * @example
+ * ```typescript
+ * if (!item) {
+ *   return notFound('Item not found');
+ * }
+ * ```
+ */
+function notFound(errorData) {
+    return {
+        status: 404,
+        body: {
+            code: 905404,
+            msg: (0, infra_contracts_1.getErrorMessage)('notFound'),
+            data: errorData,
+        },
+    };
+}
+/**
+ * 400 Bad Request 错误响应（类型安全）
+ */
+function badRequest(errorData) {
+    return {
+        status: 400,
+        body: {
+            code: 900400,
+            msg: (0, infra_contracts_1.getErrorMessage)('badRequest'),
+            data: errorData,
+        },
+    };
+}
+/**
+ * 401 Unauthorized 错误响应（类型安全）
+ */
+function unauthorized(errorData) {
+    return {
+        status: 401,
+        body: {
+            code: 923402,
+            msg: (0, infra_contracts_1.getErrorMessage)('unAuthorized'),
+            data: errorData,
+        },
+    };
+}
+/**
+ * 403 Forbidden 错误响应（类型安全）
+ */
+function forbidden(errorData) {
+    return {
+        status: 403,
+        body: {
+            code: 924403,
+            msg: (0, infra_contracts_1.getErrorMessage)('unauthorizedByKey'),
+            data: errorData,
+        },
+    };
+}
+/**
+ * 409 Conflict 错误响应（类型安全）
+ */
+function conflict(errorData) {
+    return {
+        status: 409,
+        body: {
+            code: 900403,
+            msg: (0, infra_contracts_1.getErrorMessage)('featureAlreadyExists'),
+            data: errorData,
+        },
+    };
+}
+/**
+ * 500 Internal Server Error 响应（类型安全）
+ */
+function internalError(errorData) {
+    return {
+        status: 500,
+        body: {
+            code: 900500,
+            msg: (0, infra_contracts_1.getErrorMessage)('innerError'),
+            data: errorData,
+        },
+    };
+}
+/**
+ * 从错误码创建符合 Contract 标准的错误响应
+ *
+ * 与 error() 相同，提供更好的语义化命名。
+ *
+ * @example
+ * ```typescript
+ * if (!item) {
+ *   return errorResponse(CommonErrorCode.NotFound, { error: 'Item not found' });
+ * }
+ * ```
+ */
+function errorResponse(errorCode, errorData) {
+    return error(errorCode, errorData);
+}
+/**
+ * 从错误类型字符串创建错误响应
+ *
+ * @example
+ * ```typescript
+ * return errorFromType('userNotFound', 200401, 404);
+ * ```
+ */
+function errorFromType(errorType, errorCode, httpStatus = 400, errorData) {
+    const msg = (0, infra_contracts_1.getErrorMessage)(errorType);
+    return {
+        status: httpStatus,
+        body: {
+            code: errorCode,
+            msg,
+            data: errorData,
+        },
+    };
+}
+/**
+ * 创建简单错误响应（不带 error 详情）
+ */
+function errorSimple(code, msg, httpStatus = 400) {
+    return {
+        status: httpStatus,
+        body: {
+            code,
+            msg,
+            data: undefined,
+        },
+    };
+}
+/**
+ * 递归地将对象中的 Date 类型转换为 ISO 字符串
+ * 用于确保 ts-rest 响应符合 zod schema（Date 字段定义为 z.coerce.date()）
+ *
+ * @example
+ * ```typescript
+ * const data = await this.service.findById(id);
+ * return success(serializeDates(data));
+ * ```
+ */
+function serializeDates(obj) {
+    if (obj === null || obj === undefined) {
+        return obj;
+    }
+    if (obj instanceof Date) {
+        return obj.toISOString();
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => serializeDates(item));
+    }
+    if (typeof obj === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = serializeDates(value);
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * 安全获取数据 - 如果查询抛出 NotFoundException 则返回 null
+ * 用于配合 notFound() 辅助函数，简化类型安全的错误处理
+ *
+ * @example
+ * ```typescript
+ * const result = await fetchOrNull(() =>
+ *   this.service.findById(params.id),
+ * );
+ * if (result === null) return notFound({ error: 'Item not found' });
+ * return success(result);
+ * ```
+ */
+async function fetchOrNull(fn) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        if (error &&
+            typeof error === 'object' &&
+            'name' in error &&
+            error.name === 'NotFoundException') {
+            return null;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=response.helper.js.map

package/dist/ts-rest/response.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.helper.js","sourceRoot":"","sources":["../../src/ts-rest/response.helper.ts"],"names":[],"mappings":"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"}

package/dist/utils/audit-log-helper.util.d.ts

@@ -0,0 +1,41 @@
+/** Audit log create data — uses loose typing since the Prisma schema may evolve */
+type AuditLogData = Record<string, any>;
+/**
+ * 为审计日志数据添加签名并脱敏敏感数据
+ *
+ * @param data Prisma 创建输入数据
+ * @returns 带签名且脱敏后的数据
+ *
+ * @example
+ * ```typescript
+ * const data = prepareAuditLogWithSignature({
+ *   user: { connect: { id: userId } },
+ *   operateType: 'CREATE',
+ *   target: 'BOT',
+ *   targetId: botId,
+ *   detail: { apiKey: 'sk-xxxx' }, // 会被脱敏为 { apiKey: 'sk-***' }
+ * });
+ *
+ * await operateLogService.create(data);
+ * ```
+ */
+export declare function prepareAuditLogWithSignature<T extends AuditLogData>(data: T): T;
+/**
+ * 验证审计日志记录的签名
+ *
+ * @param log 审计日志记录
+ * @returns 验证是否通过
+ */
+export declare function verifyAuditLogSignature(log: {
+    operateType?: unknown;
+    target?: unknown;
+    targetId?: unknown;
+    targetName?: unknown;
+    tenant?: any;
+    result?: unknown;
+    userId: string;
+    signature?: string | null;
+    createdAt: Date | string;
+}): boolean;
+export {};
+//# sourceMappingURL=audit-log-helper.util.d.ts.map

package/dist/utils/audit-log-helper.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log-helper.util.d.ts","sourceRoot":"","sources":["../../src/utils/audit-log-helper.util.ts"],"names":[],"mappings":"AAkBA,mFAAmF;AAEnF,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAoExC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,YAAY,EACjE,IAAI,EAAE,CAAC,GACN,CAAC,CAaH;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1B,GACA,OAAO,CAkBT"}