@jiangnian520/midway-response 0.0.0-stage → 1.0.1

package/dist/config/config.default.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/config/config.default.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmRlZmF1bHQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29uZmlnL2NvbmZpZy5kZWZhdWx0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/dist/configuration.d.ts

@@ -0,0 +1,4 @@
+export declare class ResponseConfiguration {
+    app: any;
+    onReady(): Promise<void>;
+}

package/dist/configuration.js

@@ -0,0 +1,71 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseConfiguration = void 0;
+const core_1 = require("@midwayjs/core");
+const DefaultConfig = __importStar(require("./config/config.default"));
+const global_exception_filter_1 = require("./core/global-exception.filter");
+const response_middleware_1 = require("./core/response.middleware");
+let ResponseConfiguration = class ResponseConfiguration {
+    async onReady() {
+        if (this.app && typeof this.app.useMiddleware === 'function') {
+            this.app.useMiddleware([response_middleware_1.ResponseMiddleware]);
+        }
+        if (this.app && typeof this.app.useFilter === 'function') {
+            this.app.useFilter([global_exception_filter_1.GlobalExceptionFilter]);
+        }
+    }
+};
+exports.ResponseConfiguration = ResponseConfiguration;
+__decorate([
+    (0, core_1.MainApp)(),
+    __metadata("design:type", Object)
+], ResponseConfiguration.prototype, "app", void 0);
+exports.ResponseConfiguration = ResponseConfiguration = __decorate([
+    (0, core_1.Configuration)({
+        namespace: 'response',
+        importConfigs: [{ default: DefaultConfig }],
+    })
+], ResponseConfiguration);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlndXJhdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9jb25maWd1cmF0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLHlDQUF3RDtBQUN4RCx1RUFBeUQ7QUFDekQsNEVBQXVFO0FBQ3ZFLG9FQUFnRTtBQU16RCxJQUFNLHFCQUFxQixHQUEzQixNQUFNLHFCQUFxQjtJQUloQyxLQUFLLENBQUMsT0FBTztRQUNYLElBQUksSUFBSSxDQUFDLEdBQUcsSUFBSSxPQUFPLElBQUksQ0FBQyxHQUFHLENBQUMsYUFBYSxLQUFLLFVBQVUsRUFBRSxDQUFDO1lBQzdELElBQUksQ0FBQyxHQUFHLENBQUMsYUFBYSxDQUFDLENBQUMsd0NBQWtCLENBQUMsQ0FBQyxDQUFDO1FBQy9DLENBQUM7UUFDRCxJQUFJLElBQUksQ0FBQyxHQUFHLElBQUksT0FBTyxJQUFJLENBQUMsR0FBRyxDQUFDLFNBQVMsS0FBSyxVQUFVLEVBQUUsQ0FBQztZQUN6RCxJQUFJLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQyxDQUFDLCtDQUFxQixDQUFDLENBQUMsQ0FBQztRQUM5QyxDQUFDO0lBQ0gsQ0FBQztDQUNGLENBQUE7QUFaWSxzREFBcUI7QUFFaEM7SUFEQyxJQUFBLGNBQU8sR0FBRTs7a0RBQ0Q7Z0NBRkUscUJBQXFCO0lBSmpDLElBQUEsb0JBQWEsRUFBQztRQUNiLFNBQVMsRUFBRSxVQUFVO1FBQ3JCLGFBQWEsRUFBRSxDQUFDLEVBQUUsT0FBTyxFQUFFLGFBQWEsRUFBRSxDQUFDO0tBQzVDLENBQUM7R0FDVyxxQkFBcUIsQ0FZakMifQ==

package/dist/core/ajax-result.d.ts

@@ -0,0 +1,16 @@
+import type { StandardResponse, PageResult } from '../interface';
+export declare class AjaxResult<T = any> implements StandardResponse<T> {
+    code: number;
+    msg: string;
+    data: T | null;
+    startTime?: string;
+    endTime?: string;
+    wasteTime?: string;
+    constructor(code?: number, msg?: string, data?: T | null);
+    static success<T>(data?: T, msg?: string): AjaxResult<T>;
+    static error(code?: number, msg?: string, data?: any): AjaxResult;
+    static page<T>(rows: T[], count: number, msg?: string): AjaxResult<PageResult<T>>;
+    /** 附加耗时信息 */
+    withMeta(startTime: string, endTime: string, wasteTime: string): this;
+    toJSON(): StandardResponse<T>;
+}

package/dist/core/ajax-result.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AjaxResult = void 0;
+class AjaxResult {
+    constructor(code = 200, msg = 'OK', data = null) {
+        this.code = code;
+        this.msg = msg;
+        this.data = data;
+    }
+    static success(data, msg = '操作成功') {
+        return new AjaxResult(200, msg, data ?? null);
+    }
+    static error(code = 500, msg = '操作失败', data = null) {
+        return new AjaxResult(code, msg, data);
+    }
+    static page(rows, count, msg = '查询成功') {
+        return new AjaxResult(200, msg, { rows, count });
+    }
+    /** 附加耗时信息 */
+    withMeta(startTime, endTime, wasteTime) {
+        this.startTime = startTime;
+        this.endTime = endTime;
+        this.wasteTime = wasteTime;
+        return this;
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            msg: this.msg,
+            data: this.data,
+            ...(this.startTime ? { startTime: this.startTime, endTime: this.endTime, wasteTime: this.wasteTime } : {})
+        };
+    }
+}
+exports.AjaxResult = AjaxResult;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWpheC1yZXN1bHQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29yZS9hamF4LXJlc3VsdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFFQSxNQUFhLFVBQVU7SUFVbkIsWUFBWSxPQUFlLEdBQUcsRUFBRSxNQUFjLElBQUksRUFBRSxPQUFpQixJQUFJO1FBQ3JFLElBQUksQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFDO1FBQ2pCLElBQUksQ0FBQyxHQUFHLEdBQUcsR0FBRyxDQUFDO1FBQ2YsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUM7SUFDckIsQ0FBQztJQUVELE1BQU0sQ0FBQyxPQUFPLENBQUksSUFBUSxFQUFFLE1BQWMsTUFBTTtRQUM1QyxPQUFPLElBQUksVUFBVSxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsSUFBSSxJQUFJLElBQUksQ0FBQyxDQUFDO0lBQ2xELENBQUM7SUFFRCxNQUFNLENBQUMsS0FBSyxDQUFDLE9BQWUsR0FBRyxFQUFFLE1BQWMsTUFBTSxFQUFFLE9BQVksSUFBSTtRQUNuRSxPQUFPLElBQUksVUFBVSxDQUFDLElBQUksRUFBRSxHQUFHLEVBQUUsSUFBSSxDQUFDLENBQUM7SUFDM0MsQ0FBQztJQUVELE1BQU0sQ0FBQyxJQUFJLENBQUksSUFBUyxFQUFFLEtBQWEsRUFBRSxNQUFjLE1BQU07UUFDekQsT0FBTyxJQUFJLFVBQVUsQ0FBQyxHQUFHLEVBQUUsR0FBRyxFQUFFLEVBQUUsSUFBSSxFQUFFLEtBQUssRUFBRSxDQUFDLENBQUM7SUFDckQsQ0FBQztJQUVELGFBQWE7SUFDYixRQUFRLENBQUMsU0FBaUIsRUFBRSxPQUFlLEVBQUUsU0FBaUI7UUFDMUQsSUFBSSxDQUFDLFNBQVMsR0FBRyxTQUFTLENBQUM7UUFDM0IsSUFBSSxDQUFDLE9BQU8sR0FBRyxPQUFPLENBQUM7UUFDdkIsSUFBSSxDQUFDLFNBQVMsR0FBRyxTQUFTLENBQUM7UUFDM0IsT0FBTyxJQUFJLENBQUM7SUFDaEIsQ0FBQztJQUVELE1BQU07UUFDRixPQUFPO1lBQ0gsSUFBSSxFQUFFLElBQUksQ0FBQyxJQUFJO1lBQ2YsR0FBRyxFQUFFLElBQUksQ0FBQyxHQUFHO1lBQ2IsSUFBSSxFQUFFLElBQUksQ0FBQyxJQUFJO1lBQ2YsR0FBRyxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLEVBQUUsU0FBUyxFQUFFLElBQUksQ0FBQyxTQUFTLEVBQUUsT0FBTyxFQUFFLElBQUksQ0FBQyxPQUFPLEVBQUUsU0FBUyxFQUFFLElBQUksQ0FBQyxTQUFTLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1NBQzdHLENBQUM7SUFDTixDQUFDO0NBQ0o7QUE1Q0QsZ0NBNENDIn0=

package/dist/core/base-controller.d.ts

@@ -0,0 +1,43 @@
+import type { Context } from '@midwayjs/koa';
+import { AjaxResult } from './ajax-result';
+/**
+ * # 业务 Controller 的基类
+ *
+ * 强烈建议业务项目的所有 Controller 都继承此类。
+ * 它封装了常用了响应格式化方法，让业务代码保持极简。
+ *
+ * @example
+ * // 业务代码中的使用方式
+ * export class UserController extends BaseController {
+ *   async getUser() {
+ *     const user = await this.userService.getUser();
+ *     return this.success(user); // 直接使用 this.success
+ *   }
+ * }
+ */
+export declare abstract class BaseController {
+    ctx: Context;
+    /**
+     * 快速返回成功消息
+     * @param data 数据
+     * @param msg 提示语，默认 '操作成功'
+     */
+    success<T>(data?: T, msg?: string): AjaxResult<T>;
+    /**
+     * 快速返回失败消息
+     * @param msg 提示语，默认 '操作失败'
+     * @param code 错误码，默认 500
+     */
+    error(msg?: string, code?: number): AjaxResult<any>;
+    /**
+     * 快速返回分页数据
+     * @param rows 列表数据
+     * @param count 总条数
+     */
+    toRaw<T>(rows: T[], count: number): AjaxResult<import("..").PageResult<T>>;
+    /**
+     * 根据影响行数返回成功或失败 (常用于 Update/Delete)
+     * @param rows 影响行数，或者布尔值
+     */
+    toAjax(rows: number | boolean): AjaxResult<any>;
+}

package/dist/core/base-controller.js

@@ -0,0 +1,68 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseController = void 0;
+const core_1 = require("@midwayjs/core");
+const ajax_result_1 = require("./ajax-result");
+/**
+ * # 业务 Controller 的基类
+ *
+ * 强烈建议业务项目的所有 Controller 都继承此类。
+ * 它封装了常用了响应格式化方法，让业务代码保持极简。
+ *
+ * @example
+ * // 业务代码中的使用方式
+ * export class UserController extends BaseController {
+ *   async getUser() {
+ *     const user = await this.userService.getUser();
+ *     return this.success(user); // 直接使用 this.success
+ *   }
+ * }
+ */
+class BaseController {
+    /**
+     * 快速返回成功消息
+     * @param data 数据
+     * @param msg 提示语，默认 '操作成功'
+     */
+    success(data, msg = '操作成功') {
+        return ajax_result_1.AjaxResult.success(data, msg);
+    }
+    /**
+     * 快速返回失败消息
+     * @param msg 提示语，默认 '操作失败'
+     * @param code 错误码，默认 500
+     */
+    error(msg = '操作失败', code = 500) {
+        return ajax_result_1.AjaxResult.error(code, msg);
+    }
+    /**
+     * 快速返回分页数据
+     * @param rows 列表数据
+     * @param count 总条数
+     */
+    toRaw(rows, count) {
+        return ajax_result_1.AjaxResult.page(rows, count);
+    }
+    /**
+     * 根据影响行数返回成功或失败 (常用于 Update/Delete)
+     * @param rows 影响行数，或者布尔值
+     */
+    toAjax(rows) {
+        return Number(rows) > 0 ? this.success() : this.error('操作失败');
+    }
+}
+exports.BaseController = BaseController;
+__decorate([
+    (0, core_1.Inject)(),
+    __metadata("design:type", Object)
+], BaseController.prototype, "ctx", void 0);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmFzZS1jb250cm9sbGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NvcmUvYmFzZS1jb250cm9sbGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7OztBQUFBLHlDQUF3QztBQUV4QywrQ0FBMkM7QUFFM0M7Ozs7Ozs7Ozs7Ozs7O0dBY0c7QUFDSCxNQUFzQixjQUFjO0lBSWhDOzs7O09BSUc7SUFDSCxPQUFPLENBQUksSUFBUSxFQUFFLE1BQWMsTUFBTTtRQUNyQyxPQUFPLHdCQUFVLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxHQUFHLENBQUMsQ0FBQztJQUN6QyxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILEtBQUssQ0FBQyxNQUFjLE1BQU0sRUFBRSxPQUFlLEdBQUc7UUFDMUMsT0FBTyx3QkFBVSxDQUFDLEtBQUssQ0FBQyxJQUFJLEVBQUUsR0FBRyxDQUFDLENBQUM7SUFDdkMsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxLQUFLLENBQUksSUFBUyxFQUFFLEtBQWE7UUFDN0IsT0FBTyx3QkFBVSxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsS0FBSyxDQUFDLENBQUM7SUFDeEMsQ0FBQztJQUVEOzs7T0FHRztJQUNILE1BQU0sQ0FBQyxJQUFzQjtRQUN6QixPQUFPLE1BQU0sQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUNsRSxDQUFDO0NBQ0o7QUF0Q0Qsd0NBc0NDO0FBcENHO0lBREMsSUFBQSxhQUFNLEdBQUU7OzJDQUNJIn0=

package/dist/core/global-exception.filter.d.ts

@@ -0,0 +1,5 @@
+import type { Context } from '@midwayjs/koa';
+import { AjaxResult } from './ajax-result';
+export declare class GlobalExceptionFilter {
+    catch(err: Error, ctx: Context): Promise<AjaxResult<any>>;
+}

package/dist/core/global-exception.filter.js

@@ -0,0 +1,48 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlobalExceptionFilter = void 0;
+const core_1 = require("@midwayjs/core");
+const ajax_result_1 = require("./ajax-result");
+let GlobalExceptionFilter = class GlobalExceptionFilter {
+    async catch(err, ctx) {
+        let code = 500;
+        let msg = '服务器内部错误';
+        if (err instanceof core_1.MidwayHttpError) {
+            code = err.status;
+            msg = err.message;
+        }
+        else if (err instanceof core_1.MidwayError) {
+            msg = err.message;
+        }
+        else {
+            ctx.logger.error('[GlobalExceptionFilter] 运行时异常:', err);
+            if (process.env.NODE_ENV === 'local') {
+                msg = err.message;
+            }
+        }
+        const end = Date.now();
+        const stTime = ctx.state.__req_start_time__ || new Date().toISOString();
+        const startMs = ctx.state.__req_start_ms__ || end;
+        const edTime = new Date().toISOString();
+        const waste = `${end - startMs}ms`;
+        // ========================================================
+        // ✅ 核心区别：把 HTTP 状态码设置为真实的错误码
+        // 这样 401 就是 401，500 就是 500。
+        // 前端 Axios 会自动进入 catch 或 response.error 拦截器。
+        // ========================================================
+        ctx.status = code;
+        // 依然返回标准的 JSON 结构
+        return ajax_result_1.AjaxResult.error(code, msg).withMeta(stTime, edTime, waste);
+    }
+};
+exports.GlobalExceptionFilter = GlobalExceptionFilter;
+exports.GlobalExceptionFilter = GlobalExceptionFilter = __decorate([
+    (0, core_1.Catch)()
+], GlobalExceptionFilter);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2xvYmFsLWV4Y2VwdGlvbi5maWx0ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29yZS9nbG9iYWwtZXhjZXB0aW9uLmZpbHRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7QUFBQSx5Q0FBcUU7QUFFckUsK0NBQTJDO0FBR3BDLElBQU0scUJBQXFCLEdBQTNCLE1BQU0scUJBQXFCO0lBQzlCLEtBQUssQ0FBQyxLQUFLLENBQUMsR0FBVSxFQUFFLEdBQVk7UUFDaEMsSUFBSSxJQUFJLEdBQUcsR0FBRyxDQUFDO1FBQ2YsSUFBSSxHQUFHLEdBQUcsU0FBUyxDQUFDO1FBRXBCLElBQUksR0FBRyxZQUFZLHNCQUFlLEVBQUUsQ0FBQztZQUNqQyxJQUFJLEdBQUcsR0FBRyxDQUFDLE1BQU0sQ0FBQztZQUNsQixHQUFHLEdBQUcsR0FBRyxDQUFDLE9BQU8sQ0FBQztRQUN0QixDQUFDO2FBQU0sSUFBSSxHQUFHLFlBQVksa0JBQVcsRUFBRSxDQUFDO1lBQ3BDLEdBQUcsR0FBRyxHQUFHLENBQUMsT0FBTyxDQUFDO1FBQ3RCLENBQUM7YUFBTSxDQUFDO1lBQ0osR0FBRyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsZ0NBQWdDLEVBQUUsR0FBRyxDQUFDLENBQUM7WUFDeEQsSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLFFBQVEsS0FBSyxPQUFPLEVBQUUsQ0FBQztnQkFDbkMsR0FBRyxHQUFHLEdBQUcsQ0FBQyxPQUFPLENBQUM7WUFDdEIsQ0FBQztRQUNMLENBQUM7UUFFRCxNQUFNLEdBQUcsR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7UUFDdkIsTUFBTSxNQUFNLEdBQUcsR0FBRyxDQUFDLEtBQUssQ0FBQyxrQkFBa0IsSUFBSSxJQUFJLElBQUksRUFBRSxDQUFDLFdBQVcsRUFBRSxDQUFDO1FBQ3hFLE1BQU0sT0FBTyxHQUFHLEdBQUcsQ0FBQyxLQUFLLENBQUMsZ0JBQWdCLElBQUksR0FBRyxDQUFDO1FBQ2xELE1BQU0sTUFBTSxHQUFHLElBQUksSUFBSSxFQUFFLENBQUMsV0FBVyxFQUFFLENBQUM7UUFDeEMsTUFBTSxLQUFLLEdBQUcsR0FBRyxHQUFHLEdBQUcsT0FBTyxJQUFJLENBQUM7UUFFbkMsMkRBQTJEO1FBQzNELDZCQUE2QjtRQUM3Qiw0QkFBNEI7UUFDNUIsNkNBQTZDO1FBQzdDLDJEQUEyRDtRQUMzRCxHQUFHLENBQUMsTUFBTSxHQUFHLElBQUksQ0FBQztRQUVsQixrQkFBa0I7UUFDbEIsT0FBTyx3QkFBVSxDQUFDLEtBQUssQ0FBQyxJQUFJLEVBQUUsR0FBRyxDQUFDLENBQUMsUUFBUSxDQUFDLE1BQU0sRUFBRSxNQUFNLEVBQUUsS0FBSyxDQUFDLENBQUM7SUFDdkUsQ0FBQztDQUNKLENBQUE7QUFqQ1ksc0RBQXFCO2dDQUFyQixxQkFBcUI7SUFEakMsSUFBQSxZQUFLLEdBQUU7R0FDSyxxQkFBcUIsQ0FpQ2pDIn0=

package/dist/core/response.middleware.d.ts

@@ -0,0 +1,6 @@
+import type { IMiddleware } from '@midwayjs/core';
+import type { NextFunction, Context } from '@midwayjs/koa';
+export declare class ResponseMiddleware implements IMiddleware<Context, NextFunction> {
+    resolve(): (ctx: Context, next: NextFunction) => Promise<void>;
+    static getName(): string;
+}

package/dist/core/response.middleware.js

@@ -0,0 +1,84 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseMiddleware = void 0;
+const core_1 = require("@midwayjs/core");
+const ajax_result_1 = require("./ajax-result");
+const stream = __importStar(require("stream"));
+let ResponseMiddleware = class ResponseMiddleware {
+    resolve() {
+        return async (ctx, next) => {
+            const start = Date.now();
+            const stTime = new Date().toISOString(); // 也可以换成你之前的格式化工具
+            // 将开始时间挂载到 ctx 上，给异常过滤器用
+            ctx.state.__req_start_time__ = stTime;
+            ctx.state.__req_start_ms__ = start;
+            await next();
+            // 1. 如果是文件流、Buffer、或者没返回值，直接跳过不包装
+            if (ctx.body === undefined ||
+                ctx.body === null ||
+                ctx.body instanceof stream.Stream ||
+                Buffer.isBuffer(ctx.body)) {
+                return;
+            }
+            // 2. 如果业务代码已经手动返回了 AjaxResult，则补充耗时信息即可
+            const end = Date.now();
+            const edTime = new Date().toISOString();
+            const waste = `${end - start}ms`;
+            if (ctx.body instanceof ajax_result_1.AjaxResult) {
+                ctx.body.withMeta(stTime, edTime, waste);
+                return;
+            }
+            // 3. 如果返回的是普通对象或数组（且状态码为 2xx），自动包装！
+            if (ctx.status >= 200 && ctx.status < 300) {
+                ctx.body = ajax_result_1.AjaxResult.success(ctx.body).withMeta(stTime, edTime, waste);
+            }
+        };
+    }
+    static getName() {
+        return 'responseMiddleware';
+    }
+};
+exports.ResponseMiddleware = ResponseMiddleware;
+exports.ResponseMiddleware = ResponseMiddleware = __decorate([
+    (0, core_1.Middleware)()
+], ResponseMiddleware);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVzcG9uc2UubWlkZGxld2FyZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb3JlL3Jlc3BvbnNlLm1pZGRsZXdhcmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUEseUNBQTRDO0FBRzVDLCtDQUEyQztBQUMzQywrQ0FBaUM7QUFHMUIsSUFBTSxrQkFBa0IsR0FBeEIsTUFBTSxrQkFBa0I7SUFDM0IsT0FBTztRQUNILE9BQU8sS0FBSyxFQUFFLEdBQVksRUFBRSxJQUFrQixFQUFFLEVBQUU7WUFDOUMsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO1lBQ3pCLE1BQU0sTUFBTSxHQUFHLElBQUksSUFBSSxFQUFFLENBQUMsV0FBVyxFQUFFLENBQUMsQ0FBQyxpQkFBaUI7WUFFMUQseUJBQXlCO1lBQ3pCLEdBQUcsQ0FBQyxLQUFLLENBQUMsa0JBQWtCLEdBQUcsTUFBTSxDQUFDO1lBQ3RDLEdBQUcsQ0FBQyxLQUFLLENBQUMsZ0JBQWdCLEdBQUcsS0FBSyxDQUFDO1lBRW5DLE1BQU0sSUFBSSxFQUFFLENBQUM7WUFFYixrQ0FBa0M7WUFDbEMsSUFDSSxHQUFHLENBQUMsSUFBSSxLQUFLLFNBQVM7Z0JBQ3RCLEdBQUcsQ0FBQyxJQUFJLEtBQUssSUFBSTtnQkFDakIsR0FBRyxDQUFDLElBQUksWUFBWSxNQUFNLENBQUMsTUFBTTtnQkFDakMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLEVBQzNCLENBQUM7Z0JBQ0MsT0FBTztZQUNYLENBQUM7WUFFRCx3Q0FBd0M7WUFDeEMsTUFBTSxHQUFHLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO1lBQ3ZCLE1BQU0sTUFBTSxHQUFHLElBQUksSUFBSSxFQUFFLENBQUMsV0FBVyxFQUFFLENBQUM7WUFDeEMsTUFBTSxLQUFLLEdBQUcsR0FBRyxHQUFHLEdBQUcsS0FBSyxJQUFJLENBQUM7WUFFakMsSUFBSSxHQUFHLENBQUMsSUFBSSxZQUFZLHdCQUFVLEVBQUUsQ0FBQztnQkFDakMsR0FBRyxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsTUFBTSxFQUFFLE1BQU0sRUFBRSxLQUFLLENBQUMsQ0FBQztnQkFDekMsT0FBTztZQUNYLENBQUM7WUFFRCxvQ0FBb0M7WUFDcEMsSUFBSSxHQUFHLENBQUMsTUFBTSxJQUFJLEdBQUcsSUFBSSxHQUFHLENBQUMsTUFBTSxHQUFHLEdBQUcsRUFBRSxDQUFDO2dCQUN4QyxHQUFHLENBQUMsSUFBSSxHQUFHLHdCQUFVLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsQ0FBQyxRQUFRLENBQUMsTUFBTSxFQUFFLE1BQU0sRUFBRSxLQUFLLENBQUMsQ0FBQztZQUM1RSxDQUFDO1FBQ0wsQ0FBQyxDQUFDO0lBQ04sQ0FBQztJQUVELE1BQU0sQ0FBQyxPQUFPO1FBQ1YsT0FBTyxvQkFBb0IsQ0FBQztJQUNoQyxDQUFDO0NBQ0osQ0FBQTtBQTFDWSxnREFBa0I7NkJBQWxCLGtCQUFrQjtJQUQ5QixJQUFBLGlCQUFVLEdBQUU7R0FDQSxrQkFBa0IsQ0EwQzlCIn0=

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+export { ResponseConfiguration as Configuration } from './configuration';
+export { AjaxResult } from './core/ajax-result';
+export { BaseController } from './core/base-controller';
+export { GlobalExceptionFilter } from './core/global-exception.filter';
+export { ResponseMiddleware } from './core/response.middleware';
+export * from './interface';
+/**
+ * ==========================================
+ * 💡 用户使用指南
+ * ==========================================
+ *
+ * 1. 在 configuration.ts 中引入组件：
+ * ```typescript
+ * import * as response from '@jiangnian520/midway-response';
+ *
+ * @Configuration({ imports: [koa, response] })
+ * export class MainConfiguration {}
+ * ```
+ *
+ * 2. 在 Controller 中继承 BaseController 直接使用：
+ * ```typescript
+ * import { BaseController } from '@jiangnian520/midway-response';
+ *
+ * @Controller('/user')
+ * export class UserController extends BaseController {
+ *
+ *   @Get('/info')
+ *   async getInfo() {
+ *     const data = await this.userService.getInfo();
+ *     // 自动格式化为 { code: 200, msg: '操作成功', data: xxx }
+ *     return this.success(data);
+ *   }
+ *
+ * }
+ * ```
+ *
+ * 3. 如果业务抛出异常：
+ * ```typescript
+ * import { httpError } from '@midwayjs/core';
+ *
+ * throw new httpError.BadRequestError('参数错误');
+ * // 框架会自动捕获，并返回 { code: 400, msg: '参数错误', data: null }
+ * ```
+ */ 

package/dist/index.js

@@ -0,0 +1,67 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseMiddleware = exports.GlobalExceptionFilter = exports.BaseController = exports.AjaxResult = exports.Configuration = void 0;
+var configuration_1 = require("./configuration");
+Object.defineProperty(exports, "Configuration", { enumerable: true, get: function () { return configuration_1.ResponseConfiguration; } });
+var ajax_result_1 = require("./core/ajax-result");
+Object.defineProperty(exports, "AjaxResult", { enumerable: true, get: function () { return ajax_result_1.AjaxResult; } });
+var base_controller_1 = require("./core/base-controller");
+Object.defineProperty(exports, "BaseController", { enumerable: true, get: function () { return base_controller_1.BaseController; } });
+var global_exception_filter_1 = require("./core/global-exception.filter");
+Object.defineProperty(exports, "GlobalExceptionFilter", { enumerable: true, get: function () { return global_exception_filter_1.GlobalExceptionFilter; } });
+var response_middleware_1 = require("./core/response.middleware");
+Object.defineProperty(exports, "ResponseMiddleware", { enumerable: true, get: function () { return response_middleware_1.ResponseMiddleware; } });
+__exportStar(require("./interface"), exports);
+/**
+ * ==========================================
+ * 💡 用户使用指南
+ * ==========================================
+ *
+ * 1. 在 configuration.ts 中引入组件：
+ * ```typescript
+ * import * as response from '@jiangnian520/midway-response';
+ *
+ * @Configuration({ imports: [koa, response] })
+ * export class MainConfiguration {}
+ * ```
+ *
+ * 2. 在 Controller 中继承 BaseController 直接使用：
+ * ```typescript
+ * import { BaseController } from '@jiangnian520/midway-response';
+ *
+ * @Controller('/user')
+ * export class UserController extends BaseController {
+ *
+ *   @Get('/info')
+ *   async getInfo() {
+ *     const data = await this.userService.getInfo();
+ *     // 自动格式化为 { code: 200, msg: '操作成功', data: xxx }
+ *     return this.success(data);
+ *   }
+ *
+ * }
+ * ```
+ *
+ * 3. 如果业务抛出异常：
+ * ```typescript
+ * import { httpError } from '@midwayjs/core';
+ *
+ * throw new httpError.BadRequestError('参数错误');
+ * // 框架会自动捕获，并返回 { code: 400, msg: '参数错误', data: null }
+ * ```
+ */ 
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxpREFBeUU7QUFBaEUsOEdBQUEscUJBQXFCLE9BQWlCO0FBQy9DLGtEQUFnRDtBQUF2Qyx5R0FBQSxVQUFVLE9BQUE7QUFDbkIsMERBQXdEO0FBQS9DLGlIQUFBLGNBQWMsT0FBQTtBQUN2QiwwRUFBdUU7QUFBOUQsZ0lBQUEscUJBQXFCLE9BQUE7QUFDOUIsa0VBQWdFO0FBQXZELHlIQUFBLGtCQUFrQixPQUFBO0FBQzNCLDhDQUE0QjtBQUU1Qjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXFDRyJ9

package/dist/interface.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 标准单条/对象返回结构 (对应 AjaxResult.toJSON() 的返回值)
+ */
+export interface StandardResponse<T = any> {
+    /** 业务状态码，200表示成功 */
+    code: number;
+    /** 提示消息 */
+    msg: string;
+    /** 业务数据 */
+    data: T | null;
+}
+/**
+ * 标准分页返回结构 (对应 AjaxResult.page() 中的 data 字段)
+ */
+export interface PageResult<T = any> {
+    /** 当前页的数据列表 */
+    rows: T[];
+    /** 数据总条数 */
+    count: number;
+}
+/**
+ * 响应组件全局配置
+ */
+export interface ResponseConfig {
+    /**
+     * 是否启用全局异常过滤器，默认 true。
+     * 关闭后，业务抛出的异常将由 Midway 框架默认处理。
+     */
+    enable?: boolean;
+}
+/**
+ * 标准返回结构 (前端收到的 JSON 长这样)
+ */
+export interface StandardResponse<T = any> {
+    code: number;
+    msg: string;
+    data: T | null;
+    /** 请求开始时间 (ISO格式) */
+    startTime?: string;
+    /** 请求结束时间 (ISO格式) */
+    endTime?: string;
+    /** 接口耗时 (如 "25ms") */
+    wasteTime?: string;
+}
+export interface ResponseConfig {
+    enable?: boolean;
+}

package/dist/interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2ludGVyZmFjZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/index.d.ts

@@ -0,0 +1,7 @@
+export * from './dist/index';
+
+declare module '@midwayjs/core/dist/interface' {
+  interface MidwayConfig {
+    response?: import('./dist/interface').ResponseConfig;
+  }
+}

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@jiangnian520/midway-response",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.1",
+  "description": "专为 Midway 4.0 打造的统一响应与异常格式化组件，支持全自动包装与耗时统计。",
+  "main": "dist/index.js",
+  "typings": "index.d.ts",
+  "keywords": [
+    "midway",
+    "midwayjs",
+    "response",
+    "exception-filter",
+    "ajax-result"
+  ],
+  "author": "jiangnian520",
+  "license": "MIT",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "index.d.ts"
+  ],
+  "scripts": {
+    "build": "mwtsc --cleanOutDir"
+  },
+  "peerDependencies": {
+    "@midwayjs/core": ">=4.0.0",
+    "@midwayjs/koa": ">=4.0.0"
+  },
+  "devDependencies": {
+    "@midwayjs/core": "^4.0.0",
+    "@midwayjs/koa": "^4.0.0",
+    "mwtsc": "^1.4.0",
+    "typescript": "^5.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.