koa-boot-runtime 1.0.0

package/dist/common/types/index.js

@@ -0,0 +1,18 @@
+"use strict";
+// common/types - 统一类型导出
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pageSuccess = exports.fail = exports.success = exports.BizCode = exports.toPrismaMultiOrderBy = exports.toPrismaOrderBy = exports.resolveSort = exports.SortDirection = exports.buildPaginationMeta = exports.resolvePagination = void 0;
+var pagination_1 = require("./pagination");
+Object.defineProperty(exports, "resolvePagination", { enumerable: true, get: function () { return pagination_1.resolvePagination; } });
+Object.defineProperty(exports, "buildPaginationMeta", { enumerable: true, get: function () { return pagination_1.buildPaginationMeta; } });
+var sort_1 = require("./sort");
+Object.defineProperty(exports, "SortDirection", { enumerable: true, get: function () { return sort_1.SortDirection; } });
+Object.defineProperty(exports, "resolveSort", { enumerable: true, get: function () { return sort_1.resolveSort; } });
+Object.defineProperty(exports, "toPrismaOrderBy", { enumerable: true, get: function () { return sort_1.toPrismaOrderBy; } });
+Object.defineProperty(exports, "toPrismaMultiOrderBy", { enumerable: true, get: function () { return sort_1.toPrismaMultiOrderBy; } });
+var response_1 = require("./response");
+Object.defineProperty(exports, "BizCode", { enumerable: true, get: function () { return response_1.BizCode; } });
+Object.defineProperty(exports, "success", { enumerable: true, get: function () { return response_1.success; } });
+Object.defineProperty(exports, "fail", { enumerable: true, get: function () { return response_1.fail; } });
+Object.defineProperty(exports, "pageSuccess", { enumerable: true, get: function () { return response_1.pageSuccess; } });
+//# sourceMappingURL=index.js.map

package/dist/common/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/types/index.ts"],"names":[],"mappings":";AAAA,wBAAwB;;;AAUxB,2CAGsB;AAFpB,+GAAA,iBAAiB,OAAA;AACjB,iHAAA,mBAAmB,OAAA;AAUrB,+BAKgB;AAJd,qGAAA,aAAa,OAAA;AACb,mGAAA,WAAW,OAAA;AACX,uGAAA,eAAe,OAAA;AACf,4GAAA,oBAAoB,OAAA;AAoBtB,uCAKoB;AAJlB,mGAAA,OAAO,OAAA;AACP,mGAAA,OAAO,OAAA;AACP,gGAAA,IAAI,OAAA;AACJ,uGAAA,WAAW,OAAA"}

package/dist/common/types/pagination.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 分页查询参数
+ *
+ * @example
+ * ```ts
+ * // GET /api/users?page=1&pageSize=10
+ * const params: PaginationParams = { page: 1, pageSize: 10 };
+ * ```
+ */
+export interface PaginationParams {
+    /** 当前页码，从 1 开始 */
+    page: number;
+    /** 每页条数 */
+    pageSize: number;
+}
+/**
+ * 分页查询参数（可选，用于接收请求参数）
+ *
+ * @example
+ * ```ts
+ * @Get()
+ * public async getUsers(@Query() page?: number, @Query() pageSize?: number): Promise<PageResult<User>> {
+ *   const params: OptionalPaginationParams = { page, pageSize };
+ *   // ...
+ * }
+ * ```
+ */
+export interface OptionalPaginationParams {
+    /** 当前页码，从 1 开始，默认 1 */
+    page?: number;
+    /** 每页条数，默认 10 */
+    pageSize?: number;
+}
+/**
+ * 分页元数据
+ */
+export interface PaginationMeta {
+    /** 当前页码 */
+    page: number;
+    /** 每页条数 */
+    pageSize: number;
+    /** 总记录数 */
+    total: number;
+    /** 总页数 */
+    totalPages: number;
+    /** 是否有上一页 */
+    hasPrev: boolean;
+    /** 是否有下一页 */
+    hasNext: boolean;
+}
+/**
+ * 分页结果
+ *
+ * @example
+ * ```ts
+ * const result: PageResult<User> = {
+ *   list: users,
+ *   pagination: { page: 1, pageSize: 10, total: 100, totalPages: 10, hasPrev: false, hasNext: true }
+ * };
+ * ```
+ */
+export interface PageResult<T> {
+    /** 当前页数据列表 */
+    list: T[];
+    /** 分页元数据 */
+    pagination: PaginationMeta;
+}
+/**
+ * 从可选分页参数中解析出标准分页参数（填充默认值）
+ */
+export declare function resolvePagination(params?: OptionalPaginationParams): PaginationParams;
+/**
+ * 根据总数和分页参数生成分页元数据
+ */
+export declare function buildPaginationMeta(total: number, params: PaginationParams): PaginationMeta;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/common/types/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/common/types/pagination.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,wBAAwB;IACvC,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU;IACV,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,cAAc;IACd,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,YAAY;IACZ,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,wBAAwB,GAAG,gBAAgB,CAKrF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,gBAAgB,GACvB,cAAc,CAUhB"}

package/dist/common/types/pagination.js

@@ -0,0 +1,29 @@
+"use strict";
+// ============ 分页相关类型定义 ============
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePagination = resolvePagination;
+exports.buildPaginationMeta = buildPaginationMeta;
+/**
+ * 从可选分页参数中解析出标准分页参数（填充默认值）
+ */
+function resolvePagination(params) {
+    return {
+        page: Math.max(1, params?.page ?? 1),
+        pageSize: Math.max(1, Math.min(100, params?.pageSize ?? 10)),
+    };
+}
+/**
+ * 根据总数和分页参数生成分页元数据
+ */
+function buildPaginationMeta(total, params) {
+    const totalPages = Math.max(1, Math.ceil(total / params.pageSize));
+    return {
+        page: params.page,
+        pageSize: params.pageSize,
+        total,
+        totalPages,
+        hasPrev: params.page > 1,
+        hasNext: params.page < totalPages,
+    };
+}
+//# sourceMappingURL=pagination.js.map

package/dist/common/types/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/common/types/pagination.ts"],"names":[],"mappings":";AAAA,qCAAqC;;AA4ErC,8CAKC;AAKD,kDAaC;AA1BD;;GAEG;AACH,SAAgB,iBAAiB,CAAC,MAAiC;IACjE,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC;QACpC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CACjC,KAAa,EACb,MAAwB;IAExB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnE,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK;QACL,UAAU;QACV,OAAO,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC,IAAI,GAAG,UAAU;KAClC,CAAC;AACJ,CAAC"}

package/dist/common/types/request.d.ts

@@ -0,0 +1,66 @@
+import { Request } from 'koa';
+/**
+ * 认证用户信息（挂载到 ctx.state.user 或 ctx.request.user 上）
+ *
+ * @example
+ * ```ts
+ * // 在 JWT 中间件中设置
+ * ctx.state.user = { id: 'xxx', username: 'admin', roles: ['admin'] };
+ *
+ * // 在 Controller / Service 中读取
+ * const currentUser = ctx.state.user as AuthUser;
+ * ```
+ */
+export interface AuthUser {
+    /** 用户 ID */
+    id: string;
+    /** 用户名 */
+    username: string;
+    /** 用户拥有的角色编码列表（通过 sys_user_roles 关联获取） */
+    roles: string[];
+}
+/**
+ * 扩展 Koa 的 State 类型，添加用户信息
+ *
+ * 通过 `ctx.state.user` 访问当前认证用户
+ */
+export interface AppState {
+    /** 当前认证用户信息（由认证中间件设置） */
+    user?: AuthUser;
+}
+/**
+ * 扩展 Koa 的 Context 类型，便捷访问常用属性
+ *
+ * @example
+ * ```ts
+ * import { AppContext } from '../common/types';
+ *
+ * // 在中间件中使用
+ * async function myMiddleware(ctx: AppContext, next: Next) {
+ *   const userId = ctx.state.user?.id;
+ *   // ...
+ * }
+ * ```
+ */
+export interface AppContext {
+    /** 请求状态 */
+    state: AppState;
+}
+/**
+ * 扩展 Koa Request，添加用户信息属性
+ *
+ * @example
+ * ```ts
+ * // 在类型声明中合并到 Koa Request
+ * declare module 'koa' {
+ *   interface Request {
+ *     user?: AuthUser;
+ *   }
+ * }
+ * ```
+ */
+export interface AppRequest extends Request {
+    /** 当前认证用户（由认证中间件挂载） */
+    user?: AuthUser;
+}
+//# sourceMappingURL=request.d.ts.map

package/dist/common/types/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/common/types/request.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAE9B;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,QAAQ;IACvB,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,UAAU;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,yBAAyB;IACzB,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,UAAW,SAAQ,OAAO;IACzC,uBAAuB;IACvB,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB"}

package/dist/common/types/request.js

@@ -0,0 +1,4 @@
+"use strict";
+// ============ Koa Request 类型扩展 ============
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=request.js.map

package/dist/common/types/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../src/common/types/request.ts"],"names":[],"mappings":";AAAA,6CAA6C"}

package/dist/common/types/response.d.ts

@@ -0,0 +1,109 @@
+/**
+ * 业务状态码
+ *
+ * 与 HTTP 状态码分离，用于表达业务层面的结果状态。
+ * SUCCESS 使用 200 对齐前端约定（前端以 code === 200 判断成功）。
+ */
+export declare enum BizCode {
+    /** 成功 */
+    SUCCESS = 200,
+    /** 失败（通用业务错误） */
+    FAIL = -1,
+    /** 未认证（未登录） */
+    UNAUTHORIZED = 401,
+    /** 无权限 */
+    FORBIDDEN = 403,
+    /** 资源不存在 */
+    NOT_FOUND = 404,
+    /** 参数校验失败 */
+    VALIDATION_ERROR = 422,
+    /** 服务器内部错误 */
+    INTERNAL_ERROR = 500
+}
+/**
+ * 统一 API 响应基础结构
+ *
+ * 所有接口返回值都应遵循此格式，保持前后端响应结构一致。
+ *
+ * @example
+ * ```ts
+ * // 成功响应
+ * const res: ApiResponse<User> = { code: BizCode.SUCCESS, message: '操作成功', data: user };
+ *
+ * // 失败响应
+ * const res: ApiResponse<null> = { code: BizCode.FAIL, message: '用户名已存在', data: null };
+ * ```
+ */
+export interface ApiResponse<T = unknown> {
+    /** 业务状态码（200=成功，非200=失败） */
+    code: BizCode | number;
+    /** 响应消息 */
+    message: string;
+    /** 响应数据 */
+    data: T;
+}
+/**
+ * 成功响应（泛型数据）
+ */
+export type SuccessResponse<T> = ApiResponse<T> & {
+    code: BizCode.SUCCESS;
+};
+/**
+ * 失败响应
+ */
+export type FailResponse<T = null> = ApiResponse<T> & {
+    code: number;
+};
+/**
+ * 分页数据响应
+ *
+ * @example
+ * ```ts
+ * const res: PageResponse<User> = {
+ *   code: BizCode.SUCCESS,
+ *   message: '查询成功',
+ *   data: {
+ *     list: users,
+ *     pagination: { page: 1, pageSize: 10, total: 100, totalPages: 10, hasPrev: false, hasNext: true }
+ *   }
+ * };
+ * ```
+ */
+export interface PageResponse<T> extends ApiResponse<{
+    list: T[];
+    pagination: unknown;
+}> {
+}
+/**
+ * 错误响应体
+ *
+ * errorHandler 已统一使用 `fail()` 函数返回 ApiResponse 格式，
+ * 开发环境下额外携带 stack 字段便于调试。
+ */
+export type ErrorResponse = FailResponse & {
+    /** 错误堆栈（仅开发环境） */
+    stack?: string;
+};
+/**
+ * 构建成功响应
+ */
+export declare function success<T>(data: T, message?: string): SuccessResponse<T>;
+/**
+ * 构建失败响应
+ */
+export declare function fail<T = null>(message?: string, code?: number, data?: T): FailResponse<T>;
+/**
+ * 构建分页响应
+ */
+export declare function pageSuccess<T>(list: T[], pagination: {
+    page: number;
+    pageSize: number;
+    total: number;
+    totalPages: number;
+    hasPrev: boolean;
+    hasNext: boolean;
+}, message?: string): ApiResponse<{
+    list: T[];
+    pagination: typeof pagination;
+}>;
+//# sourceMappingURL=response.d.ts.map

package/dist/common/types/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../src/common/types/response.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,oBAAY,OAAO;IACjB,SAAS;IACT,OAAO,MAAM;IACb,iBAAiB;IACjB,IAAI,KAAK;IACT,eAAe;IACf,YAAY,MAAM;IAClB,UAAU;IACV,SAAS,MAAM;IACf,YAAY;IACZ,SAAS,MAAM;IACf,aAAa;IACb,gBAAgB,MAAM;IACtB,cAAc;IACd,cAAc,MAAM;CACrB;AAID;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,4BAA4B;IAC5B,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,IAAI,EAAE,CAAC,CAAC;CACT;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG;IAChD,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG;IACpD,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAIF;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC;CAAG;AAI3F;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG;IACzC,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAIF;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,MAAe,GAAG,eAAe,CAAC,CAAC,CAAC,CAEhF;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,GAAE,MAAe,EAAE,IAAI,GAAE,MAAqB,EAAE,IAAI,GAAE,CAAa,GAAG,YAAY,CAAC,CAAC,CAAC,CAE1H;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,CAAC,EAAE,EACT,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EACrH,OAAO,GAAE,MAAe,GACvB,WAAW,CAAC;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,UAAU,EAAE,OAAO,UAAU,CAAA;CAAE,CAAC,CAE3D"}

package/dist/common/types/response.js

@@ -0,0 +1,50 @@
+"use strict";
+// ============ 统一 API 响应格式类型 ============
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BizCode = void 0;
+exports.success = success;
+exports.fail = fail;
+exports.pageSuccess = pageSuccess;
+/**
+ * 业务状态码
+ *
+ * 与 HTTP 状态码分离，用于表达业务层面的结果状态。
+ * SUCCESS 使用 200 对齐前端约定（前端以 code === 200 判断成功）。
+ */
+var BizCode;
+(function (BizCode) {
+    /** 成功 */
+    BizCode[BizCode["SUCCESS"] = 200] = "SUCCESS";
+    /** 失败（通用业务错误） */
+    BizCode[BizCode["FAIL"] = -1] = "FAIL";
+    /** 未认证（未登录） */
+    BizCode[BizCode["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    /** 无权限 */
+    BizCode[BizCode["FORBIDDEN"] = 403] = "FORBIDDEN";
+    /** 资源不存在 */
+    BizCode[BizCode["NOT_FOUND"] = 404] = "NOT_FOUND";
+    /** 参数校验失败 */
+    BizCode[BizCode["VALIDATION_ERROR"] = 422] = "VALIDATION_ERROR";
+    /** 服务器内部错误 */
+    BizCode[BizCode["INTERNAL_ERROR"] = 500] = "INTERNAL_ERROR";
+})(BizCode || (exports.BizCode = BizCode = {}));
+// ============ 工厂函数 ============
+/**
+ * 构建成功响应
+ */
+function success(data, message = '操作成功') {
+    return { code: BizCode.SUCCESS, message, data };
+}
+/**
+ * 构建失败响应
+ */
+function fail(message = '操作失败', code = BizCode.FAIL, data = null) {
+    return { code, message, data };
+}
+/**
+ * 构建分页响应
+ */
+function pageSuccess(list, pagination, message = '查询成功') {
+    return { code: BizCode.SUCCESS, message, data: { list, pagination } };
+}
+//# sourceMappingURL=response.js.map

package/dist/common/types/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../src/common/types/response.ts"],"names":[],"mappings":";AAAA,0CAA0C;;;AAqG1C,0BAEC;AAKD,oBAEC;AAKD,kCAMC;AAvHD;;;;;GAKG;AACH,IAAY,OAeX;AAfD,WAAY,OAAO;IACjB,SAAS;IACT,6CAAa,CAAA;IACb,iBAAiB;IACjB,sCAAS,CAAA;IACT,eAAe;IACf,uDAAkB,CAAA;IAClB,UAAU;IACV,iDAAe,CAAA;IACf,YAAY;IACZ,iDAAe,CAAA;IACf,aAAa;IACb,+DAAsB,CAAA;IACtB,cAAc;IACd,2DAAoB,CAAA;AACtB,CAAC,EAfW,OAAO,uBAAP,OAAO,QAelB;AAyED,iCAAiC;AAEjC;;GAEG;AACH,SAAgB,OAAO,CAAI,IAAO,EAAE,UAAkB,MAAM;IAC1D,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAgB,IAAI,CAAW,UAAkB,MAAM,EAAE,OAAe,OAAO,CAAC,IAAI,EAAE,OAAU,IAAS;IACvG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CACzB,IAAS,EACT,UAAqH,EACrH,UAAkB,MAAM;IAExB,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC;AACxE,CAAC"}

package/dist/common/types/sort.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 排序方向
+ */
+export declare enum SortDirection {
+    /** 升序 */
+    ASC = "asc",
+    /** 降序 */
+    DESC = "desc"
+}
+/**
+ * 排序参数（单字段排序）
+ *
+ * @example
+ * ```ts
+ * const sort: SortParams = { field: 'createdAt', direction: SortDirection.DESC };
+ * // 等价于 Prisma 的 orderBy: { createdAt: 'desc' }
+ * ```
+ */
+export interface SortParams {
+    /** 排序字段名（对应模型属性名） */
+    field: string;
+    /** 排序方向 */
+    direction: SortDirection | 'asc' | 'desc';
+}
+/**
+ * 排序参数（可选，用于接收请求参数）
+ *
+ * @example
+ * ```ts
+ * // GET /api/users?sortField=createdAt&sortDirection=desc
+ * const params: OptionalSortParams = { sortField: 'createdAt', sortDirection: 'desc' };
+ * ```
+ */
+export interface OptionalSortParams {
+    /** 排序字段名 */
+    sortField?: string;
+    /** 排序方向 */
+    sortDirection?: SortDirection | 'asc' | 'desc';
+}
+/**
+ * 多字段排序参数
+ *
+ * @example
+ * ```ts
+ * const sorts: MultiSortParams = [
+ *   { field: 'status', direction: SortDirection.ASC },
+ *   { field: 'createdAt', direction: SortDirection.DESC },
+ * ];
+ * ```
+ */
+export type MultiSortParams = SortParams[];
+/**
+ * 从可选排序参数中解析出标准排序参数（填充默认值）
+ */
+export declare function resolveSort(params?: OptionalSortParams, defaultField?: string, defaultDirection?: SortDirection | 'asc' | 'desc'): SortParams;
+/**
+ * 将 SortParams 转换为 Prisma 的 orderBy 格式
+ *
+ * @example
+ * ```ts
+ * const sort = resolveSort({ sortField: 'name', sortDirection: 'asc' });
+ * const orderBy = toPrismaOrderBy(sort);
+ * // { name: 'asc' }
+ * ```
+ */
+export declare function toPrismaOrderBy(sort: SortParams): Record<string, string>;
+/**
+ * 将多个 SortParams 转换为 Prisma 的 orderBy 数组格式
+ */
+export declare function toPrismaMultiOrderBy(sorts: MultiSortParams): Record<string, string>[];
+//# sourceMappingURL=sort.d.ts.map

package/dist/common/types/sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../../src/common/types/sort.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,aAAa;IACvB,SAAS;IACT,GAAG,QAAQ;IACX,SAAS;IACT,IAAI,SAAS;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,SAAS,EAAE,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;CAC3C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,aAAa,CAAC,EAAE,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;CAChD;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,EAAE,CAAC;AAE3C;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,CAAC,EAAE,kBAAkB,EAC3B,YAAY,GAAE,MAAoB,EAClC,gBAAgB,GAAE,aAAa,GAAG,KAAK,GAAG,MAA2B,GACpE,UAAU,CAKZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAErF"}

package/dist/common/types/sort.js

@@ -0,0 +1,46 @@
+"use strict";
+// ============ 排序相关类型定义 ============
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SortDirection = void 0;
+exports.resolveSort = resolveSort;
+exports.toPrismaOrderBy = toPrismaOrderBy;
+exports.toPrismaMultiOrderBy = toPrismaMultiOrderBy;
+/**
+ * 排序方向
+ */
+var SortDirection;
+(function (SortDirection) {
+    /** 升序 */
+    SortDirection["ASC"] = "asc";
+    /** 降序 */
+    SortDirection["DESC"] = "desc";
+})(SortDirection || (exports.SortDirection = SortDirection = {}));
+/**
+ * 从可选排序参数中解析出标准排序参数（填充默认值）
+ */
+function resolveSort(params, defaultField = 'createdAt', defaultDirection = SortDirection.DESC) {
+    return {
+        field: params?.sortField || defaultField,
+        direction: params?.sortDirection || defaultDirection,
+    };
+}
+/**
+ * 将 SortParams 转换为 Prisma 的 orderBy 格式
+ *
+ * @example
+ * ```ts
+ * const sort = resolveSort({ sortField: 'name', sortDirection: 'asc' });
+ * const orderBy = toPrismaOrderBy(sort);
+ * // { name: 'asc' }
+ * ```
+ */
+function toPrismaOrderBy(sort) {
+    return { [sort.field]: sort.direction };
+}
+/**
+ * 将多个 SortParams 转换为 Prisma 的 orderBy 数组格式
+ */
+function toPrismaMultiOrderBy(sorts) {
+    return sorts.map(sort => ({ [sort.field]: sort.direction }));
+}
+//# sourceMappingURL=sort.js.map

package/dist/common/types/sort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.js","sourceRoot":"","sources":["../../../src/common/types/sort.ts"],"names":[],"mappings":";AAAA,qCAAqC;;;AA4DrC,kCASC;AAYD,0CAEC;AAKD,oDAEC;AAxFD;;GAEG;AACH,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,SAAS;IACT,4BAAW,CAAA;IACX,SAAS;IACT,8BAAa,CAAA;AACf,CAAC,EALW,aAAa,6BAAb,aAAa,QAKxB;AA+CD;;GAEG;AACH,SAAgB,WAAW,CACzB,MAA2B,EAC3B,eAAuB,WAAW,EAClC,mBAAmD,aAAa,CAAC,IAAI;IAErE,OAAO;QACL,KAAK,EAAE,MAAM,EAAE,SAAS,IAAI,YAAY;QACxC,SAAS,EAAE,MAAM,EAAE,aAAa,IAAI,gBAAgB;KACrD,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,eAAe,CAAC,IAAgB;IAC9C,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,KAAsB;IACzD,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/config/database.d.ts

@@ -0,0 +1,12 @@
+import { PrismaClient } from '@prisma/client';
+/**
+ * 创建（复用）PrismaClient 单例。
+ *
+ * 系统服务与用户业务共享同一实例，避免连接数翻倍。
+ * 用户可在项目启动时调用一次 createPrismaClient() 获取实例。
+ */
+export declare function createPrismaClient(): PrismaClient;
+/** 框架内部共享实例（系统模块直接使用） */
+export declare const prisma: PrismaClient<import(".prisma/client").Prisma.PrismaClientOptions, never, import("@prisma/client/runtime/library").DefaultArgs>;
+export default prisma;
+//# sourceMappingURL=database.d.ts.map

package/dist/config/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/config/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAOjD;AAED,yBAAyB;AACzB,eAAO,MAAM,MAAM,gIAAuB,CAAC;AAE3C,eAAe,MAAM,CAAC"}

package/dist/config/database.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prisma = void 0;
+exports.createPrismaClient = createPrismaClient;
+const client_1 = require("@prisma/client");
+let instance = null;
+/**
+ * 创建（复用）PrismaClient 单例。
+ *
+ * 系统服务与用户业务共享同一实例，避免连接数翻倍。
+ * 用户可在项目启动时调用一次 createPrismaClient() 获取实例。
+ */
+function createPrismaClient() {
+    if (!instance) {
+        instance = new client_1.PrismaClient({
+            log: process.env.NODE_ENV === 'development' ? ['query'] : [],
+        });
+    }
+    return instance;
+}
+/** 框架内部共享实例（系统模块直接使用） */
+exports.prisma = createPrismaClient();
+exports.default = exports.prisma;
+//# sourceMappingURL=database.js.map

package/dist/config/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/config/database.ts"],"names":[],"mappings":";;;AAUA,gDAOC;AAjBD,2CAA8C;AAE9C,IAAI,QAAQ,GAAwB,IAAI,CAAC;AAEzC;;;;;GAKG;AACH,SAAgB,kBAAkB;IAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,IAAI,qBAAY,CAAC;YAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;SAC7D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,yBAAyB;AACZ,QAAA,MAAM,GAAG,kBAAkB,EAAE,CAAC;AAE3C,kBAAe,cAAM,CAAC"}