@jiangnian520/midway-repeat-submit 0.0.0-stage → 1.0.0

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

@@ -0,0 +1,5 @@
+import type { RepeatSubmitConfig } from '../interface';
+declare const _default: {
+    repeatSubmit: RepeatSubmitConfig;
+};
+export default _default;

package/dist/config/config.default.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = {
+    repeatSubmit: {
+        enable: true,
+        interval: 5,
+        errorMessage: '请勿重复提交，请稍候再试',
+        useRedis: false,
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmRlZmF1bHQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29uZmlnL2NvbmZpZy5kZWZhdWx0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBRUEsa0JBQWU7SUFDWCxZQUFZLEVBQUU7UUFDVixNQUFNLEVBQUUsSUFBSTtRQUNaLFFBQVEsRUFBRSxDQUFDO1FBQ1gsWUFBWSxFQUFFLGNBQWM7UUFDNUIsUUFBUSxFQUFFLEtBQUs7S0FDSTtDQUMxQixDQUFDIn0=

package/dist/configuration.d.ts

@@ -0,0 +1,8 @@
+import { MidwayDecoratorService } from '@midwayjs/core';
+import type { ILifeCycle } from '@midwayjs/core';
+import type { RepeatSubmitConfig } from './interface';
+export declare class RepeatSubmitConfiguration implements ILifeCycle {
+    decoratorService: MidwayDecoratorService;
+    config: RepeatSubmitConfig;
+    onReady(): Promise<void>;
+}

package/dist/configuration.js

@@ -0,0 +1,135 @@
+"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.RepeatSubmitConfiguration = void 0;
+const core_1 = require("@midwayjs/core");
+const DefaultConfig = __importStar(require("./config/config.default"));
+const interface_1 = require("./interface");
+const memory_storage_1 = require("./storage/memory.storage");
+const redis_storage_1 = require("./storage/redis.storage");
+const utils_1 = require("./utils");
+let RepeatSubmitConfiguration = class RepeatSubmitConfiguration {
+    async onReady() {
+        if (this.config.enable === false)
+            return;
+        // 动态选择存储驱动
+        const storage = this.config.useRedis && this.config.redisDb
+            ? new redis_storage_1.RedisStorage(this.config.redisDb)
+            : new memory_storage_1.MemoryStorage();
+        if (storage instanceof memory_storage_1.MemoryStorage) {
+            await storage.init();
+        }
+        this.decoratorService.registerMethodHandler(interface_1.REPEAT_SUBMIT_KEY, (options) => {
+            const meta = options.metadata;
+            const targetClass = options.target;
+            const methodName = options.propertyName;
+            const interval = meta.interval ?? this.config.interval;
+            const errorMessage = meta.errorMessage ?? this.config.errorMessage;
+            const fromSources = meta.from ?? ['body', 'query'];
+            return {
+                around: async (joinPoint) => {
+                    const ctx = joinPoint.target[core_1.REQUEST_OBJ_CTX_KEY];
+                    if (!ctx)
+                        return joinPoint.proceed(...joinPoint.args);
+                    // 1. 收集用于对比的参数数据
+                    const sourceData = {};
+                    if (fromSources.includes('body') && ctx.request.body)
+                        sourceData.body = ctx.request.body;
+                    if (fromSources.includes('query') && ctx.query)
+                        sourceData.query = ctx.query;
+                    if (fromSources.includes('params') && ctx.params)
+                        sourceData.params = ctx.params;
+                    // 2. 提取参与防重的核心数据
+                    let coreData = sourceData;
+                    const keys = Array.isArray(meta.keys) ? meta.keys : meta.keys ? [meta.keys] : [];
+                    if (keys.length > 0) {
+                        coreData = {};
+                        for (const k of keys) {
+                            // 如果 keys 带了前缀，或者默认全查，这里简单处理：在拼接后的数据里找
+                            let val;
+                            if (k.includes('.')) {
+                                // 优先在合并后的对象中找路径
+                                val = (0, utils_1.getValueByPath)(sourceData, k);
+                            }
+                            else {
+                                val = sourceData.body?.[k] ?? sourceData.query?.[k] ?? sourceData.params?.[k];
+                            }
+                            if (val !== undefined)
+                                coreData[k] = val;
+                        }
+                    }
+                    // 3. 生成稳定 Hash
+                    const ip = (0, utils_1.getClientIp)(ctx);
+                    const stableStr = JSON.stringify((0, utils_1.sortKeys)(coreData));
+                    // Key 的组成：业务前缀 + IP + 类名.方法名 + 参数哈希
+                    const finalKey = `repeat:${(0, utils_1.md5)(`${ip}:${targetClass.name}.${methodName}:${stableStr}`)}`;
+                    // 4. 尝试抢占锁/占位
+                    const acquired = await storage.acquire(finalKey, stableStr, interval);
+                    if (!acquired) {
+                        ctx.status = 429; // 可选：429 Too Many Requests
+                        ctx.throw(400, errorMessage); // 抛出业务异常，交给你的全局错误过滤器
+                    }
+                    // 5. 放行
+                    return joinPoint.proceed(...joinPoint.args);
+                },
+            };
+        });
+    }
+};
+exports.RepeatSubmitConfiguration = RepeatSubmitConfiguration;
+__decorate([
+    (0, core_1.Inject)(),
+    __metadata("design:type", core_1.MidwayDecoratorService)
+], RepeatSubmitConfiguration.prototype, "decoratorService", void 0);
+__decorate([
+    (0, core_1.Config)('repeatSubmit'),
+    __metadata("design:type", Object)
+], RepeatSubmitConfiguration.prototype, "config", void 0);
+exports.RepeatSubmitConfiguration = RepeatSubmitConfiguration = __decorate([
+    (0, core_1.Configuration)({
+        namespace: 'repeatSubmit',
+        importConfigs: [{ default: DefaultConfig }],
+    })
+], RepeatSubmitConfiguration);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlndXJhdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9jb25maWd1cmF0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLHlDQU93QjtBQUV4Qix1RUFBeUQ7QUFDekQsMkNBQWdEO0FBRWhELDZEQUF5RDtBQUN6RCwyREFBdUQ7QUFDdkQsbUNBQXFFO0FBTTlELElBQU0seUJBQXlCLEdBQS9CLE1BQU0seUJBQXlCO0lBT3BDLEtBQUssQ0FBQyxPQUFPO1FBQ1gsSUFBSSxJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sS0FBSyxLQUFLO1lBQUUsT0FBTztRQUV6QyxXQUFXO1FBQ1gsTUFBTSxPQUFPLEdBQUcsSUFBSSxDQUFDLE1BQU0sQ0FBQyxRQUFRLElBQUksSUFBSSxDQUFDLE1BQU0sQ0FBQyxPQUFPO1lBQ3pELENBQUMsQ0FBQyxJQUFJLDRCQUFZLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxPQUFPLENBQUM7WUFDdkMsQ0FBQyxDQUFDLElBQUksOEJBQWEsRUFBRSxDQUFDO1FBRXhCLElBQUksT0FBTyxZQUFZLDhCQUFhLEVBQUUsQ0FBQztZQUNyQyxNQUFNLE9BQU8sQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUN2QixDQUFDO1FBRUQsSUFBSSxDQUFDLGdCQUFnQixDQUFDLHFCQUFxQixDQUFDLDZCQUFpQixFQUFFLENBQUMsT0FBTyxFQUFFLEVBQUU7WUFDekUsTUFBTSxJQUFJLEdBQUcsT0FBTyxDQUFDLFFBQStCLENBQUM7WUFDckQsTUFBTSxXQUFXLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQztZQUNuQyxNQUFNLFVBQVUsR0FBRyxPQUFPLENBQUMsWUFBWSxDQUFDO1lBRXhDLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxRQUFRLElBQUksSUFBSSxDQUFDLE1BQU0sQ0FBQyxRQUFTLENBQUM7WUFDeEQsTUFBTSxZQUFZ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

package/dist/decorator/repeat-submit.decorator.d.ts

@@ -0,0 +1,14 @@
+import type { RepeatSubmitOptions } from '../interface';
+/**
+ * # 防重复提交装饰器
+ *
+ * 标记在需要防重的接口上。
+ *
+ * @example
+ * // 默认 5 秒内不允许重复提交相同参数
+ * @RepeatSubmit()
+ *
+ * // 10 秒内，同一个手机号不允许重复提交
+ * @RepeatSubmit({ interval: 10, keys: ['phone'] })
+ */
+export declare function RepeatSubmit(options?: RepeatSubmitOptions): MethodDecorator;

package/dist/decorator/repeat-submit.decorator.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RepeatSubmit = RepeatSubmit;
+const core_1 = require("@midwayjs/core");
+const interface_1 = require("../interface");
+/**
+ * # 防重复提交装饰器
+ *
+ * 标记在需要防重的接口上。
+ *
+ * @example
+ * // 默认 5 秒内不允许重复提交相同参数
+ * @RepeatSubmit()
+ *
+ * // 10 秒内，同一个手机号不允许重复提交
+ * @RepeatSubmit({ interval: 10, keys: ['phone'] })
+ */
+function RepeatSubmit(options = {}) {
+    const defaultOptions = {
+        interval: 5,
+        from: ['body', 'query'],
+        ...options,
+    };
+    return core_1.DecoratorManager.createCustomMethodDecorator(interface_1.REPEAT_SUBMIT_KEY, defaultOptions);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVwZWF0LXN1Ym1pdC5kZWNvcmF0b3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZGVjb3JhdG9yL3JlcGVhdC1zdWJtaXQuZGVjb3JhdG9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBZ0JBLG9DQU9DO0FBdkJELHlDQUFrRDtBQUVsRCw0Q0FBaUQ7QUFFakQ7Ozs7Ozs7Ozs7O0dBV0c7QUFDSCxTQUFnQixZQUFZLENBQUMsVUFBK0IsRUFBRTtJQUMxRCxNQUFNLGNBQWMsR0FBd0I7UUFDeEMsUUFBUSxFQUFFLENBQUM7UUFDWCxJQUFJLEVBQUUsQ0FBQyxNQUFNLEVBQUUsT0FBTyxDQUFDO1FBQ3ZCLEdBQUcsT0FBTztLQUNiLENBQUM7SUFDRixPQUFPLHVCQUFnQixDQUFDLDJCQUEyQixDQUFDLDZCQUFpQixFQUFFLGNBQWMsQ0FBQyxDQUFDO0FBQzNGLENBQUMifQ==

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { RepeatSubmitConfiguration as Configuration } from './configuration';
+export { RepeatSubmit } from './decorator/repeat-submit.decorator';
+export * from './interface';

package/dist/index.js

@@ -0,0 +1,23 @@
+"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.RepeatSubmit = exports.Configuration = void 0;
+var configuration_1 = require("./configuration");
+Object.defineProperty(exports, "Configuration", { enumerable: true, get: function () { return configuration_1.RepeatSubmitConfiguration; } });
+var repeat_submit_decorator_1 = require("./decorator/repeat-submit.decorator");
+Object.defineProperty(exports, "RepeatSubmit", { enumerable: true, get: function () { return repeat_submit_decorator_1.RepeatSubmit; } });
+__exportStar(require("./interface"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxpREFBNkU7QUFBcEUsOEdBQUEseUJBQXlCLE9BQWlCO0FBQ25ELCtFQUFtRTtBQUExRCx1SEFBQSxZQUFZLE9BQUE7QUFDckIsOENBQTRCIn0=

package/dist/interface.d.ts

@@ -0,0 +1,37 @@
+export declare const REPEAT_SUBMIT_KEY = "decorator:repeat_submit";
+/** 装饰器入参 */
+export interface RepeatSubmitOptions {
+    /**
+     * 重复提交拦截间隔时间（秒），默认 5 秒
+     */
+    interval?: number;
+    /**
+     * 参与防重的额外字段（基于请求参数），比如 ['phone', 'userId']。
+     * 支持嵌套，如 'user.id'
+     * 如果传了，防重规则将是：当前用户IP + 方法名 + 这些字段的值。
+     * 如果不传，防重规则将是：当前用户IP + 方法名 + 所有请求参数的值（类似你的原代码）。
+     */
+    keys?: string | string[];
+    /**
+     * 从哪些来源获取参数，默认 ['body', 'query']
+     */
+    from?: Array<'body' | 'query' | 'params'>;
+    /** 自定义错误提示 */
+    errorMessage?: string;
+}
+/** 业务方全局配置 */
+export interface RepeatSubmitConfig {
+    /** 是否启用组件，默认 true */
+    enable?: boolean;
+    /** 默认间隔时间（秒） */
+    interval?: number;
+    /** 默认错误提示 */
+    errorMessage?: string;
+    /**
+     * 是否使用 Redis 存储
+     * 默认为 false（内存存储），开启后需自行安装 ioredis 并在下方提供 db 实例
+     */
+    useRedis?: boolean;
+    /** ioredis 实例 */
+    redisDb?: any;
+}

package/dist/interface.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPEAT_SUBMIT_KEY = void 0;
+exports.REPEAT_SUBMIT_KEY = 'decorator:repeat_submit';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2ludGVyZmFjZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBYSxRQUFBLGlCQUFpQixHQUFHLHlCQUF5QixDQUFDIn0=

package/dist/storage/memory.storage.d.ts

@@ -0,0 +1,8 @@
+import type { IRepeatStorage } from './storage.interface';
+export declare class MemoryStorage implements IRepeatStorage {
+    private cache;
+    private timer;
+    init(): Promise<void>;
+    acquire(key: string, value: string, ttlSeconds: number): Promise<boolean>;
+    destroy(): Promise<void>;
+}

package/dist/storage/memory.storage.js

@@ -0,0 +1,65 @@
+"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.MemoryStorage = void 0;
+const core_1 = require("@midwayjs/core");
+let MemoryStorage = class MemoryStorage {
+    constructor() {
+        this.cache = new Map();
+    }
+    async init() {
+        // 每分钟清理一次过期数据，防止内存泄漏
+        this.timer = setInterval(() => {
+            const now = Date.now();
+            for (const [key, item] of this.cache.entries()) {
+                if (item.expire < now)
+                    this.cache.delete(key);
+            }
+        }, 60000);
+    }
+    async acquire(key, value, ttlSeconds) {
+        const now = Date.now();
+        const existing = this.cache.get(key);
+        if (existing && existing.expire > now) {
+            return false; // 尚未过期，说明重复了
+        }
+        // 写入新值
+        this.cache.set(key, {
+            val: value,
+            expire: now + ttlSeconds * 1000,
+        });
+        return true;
+    }
+    // ✅ 核心修复：在组件销毁时清理定时器，消除警告并防止内存泄漏
+    async destroy() {
+        if (this.timer) {
+            clearInterval(this.timer);
+        }
+    }
+};
+exports.MemoryStorage = MemoryStorage;
+__decorate([
+    (0, core_1.Init)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], MemoryStorage.prototype, "init", null);
+__decorate([
+    (0, core_1.Destroy)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], MemoryStorage.prototype, "destroy", null);
+exports.MemoryStorage = MemoryStorage = __decorate([
+    (0, core_1.Provide)(),
+    (0, core_1.Scope)(core_1.ScopeEnum.Singleton)
+], MemoryStorage);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVtb3J5LnN0b3JhZ2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc3RvcmFnZS9tZW1vcnkuc3RvcmFnZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7QUFBQSx5Q0FBMEU7QUFLbkUsSUFBTSxhQUFhLEdBQW5CLE1BQU0sYUFBYTtJQUFuQjtRQUNLLFVBQUssR0FBRyxJQUFJLEdBQUcsRUFBMkMsQ0FBQztJQXFDdkUsQ0FBQztJQWpDUyxBQUFOLEtBQUssQ0FBQyxJQUFJO1FBQ04scUJBQXFCO1FBQ3JCLElBQUksQ0FBQyxLQUFLLEdBQUcsV0FBVyxDQUFDLEdBQUcsRUFBRTtZQUMxQixNQUFNLEdBQUcsR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7WUFDdkIsS0FBSyxNQUFNLENBQUMsR0FBRyxFQUFFLElBQUksQ0FBQyxJQUFJLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxFQUFFLEVBQUUsQ0FBQztnQkFDN0MsSUFBSSxJQUFJLENBQUMsTUFBTSxHQUFHLEdBQUc7b0JBQUUsSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUM7WUFDbEQsQ0FBQztRQUNMLENBQUMsRUFBRSxLQUFLLENBQUMsQ0FBQztJQUNkLENBQUM7SUFFRCxLQUFLLENBQUMsT0FBTyxDQUFDLEdBQVcsRUFBRSxLQUFhLEVBQUUsVUFBa0I7UUFDeEQsTUFBTSxHQUFHLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO1FBQ3ZCLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBRXJDLElBQUksUUFBUSxJQUFJLFFBQVEsQ0FBQyxNQUFNLEdBQUcsR0FBRyxFQUFFLENBQUM7WUFDcEMsT0FBTyxLQUFLLENBQUMsQ0FBQyxhQUFhO1FBQy9CLENBQUM7UUFFRCxPQUFPO1FBQ1AsSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsR0FBRyxFQUFFO1lBQ2hCLEdBQUcsRUFBRSxLQUFLO1lBQ1YsTUFBTSxFQUFFLEdBQUcsR0FBRyxVQUFVLEdBQUcsSUFBSTtTQUNsQyxDQUFDLENBQUM7UUFDSCxPQUFPLElBQUksQ0FBQztJQUNoQixDQUFDO0lBRUQsaUNBQWlDO0lBRTNCLEFBQU4sS0FBSyxDQUFDLE9BQU87UUFDVCxJQUFJLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUNiLGFBQWEsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDOUIsQ0FBQztJQUNMLENBQUM7Q0FDSixDQUFBO0FBdENZLHNDQUFhO0FBS2hCO0lBREwsSUFBQSxXQUFJLEdBQUU7Ozs7eUNBU047QUFvQks7SUFETCxJQUFBLGNBQU8sR0FBRTs7Ozs0Q0FLVDt3QkFyQ1EsYUFBYTtJQUZ6QixJQUFBLGNBQU8sR0FBRTtJQUNULElBQUEsWUFBSyxFQUFDLGdCQUFTLENBQUMsU0FBUyxDQUFDO0dBQ2QsYUFBYSxDQXNDekIifQ==

package/dist/storage/redis.storage.d.ts

@@ -0,0 +1,7 @@
+import type { IRepeatStorage } from './storage.interface';
+import type { Redis } from 'ioredis';
+export declare class RedisStorage implements IRepeatStorage {
+    private redis;
+    constructor(redis: Redis);
+    acquire(key: string, value: string, ttlSeconds: number): Promise<boolean>;
+}

package/dist/storage/redis.storage.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisStorage = void 0;
+class RedisStorage {
+    constructor(redis) {
+        this.redis = redis;
+    }
+    async acquire(key, value, ttlSeconds) {
+        // ✅ 使用原子操作 SET NX EX 彻底杜绝并发穿透问题
+        const result = await this.redis.set(key, value, 'EX', ttlSeconds, 'NX');
+        return result === 'OK';
+    }
+}
+exports.RedisStorage = RedisStorage;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVkaXMuc3RvcmFnZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zdG9yYWdlL3JlZGlzLnN0b3JhZ2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBR0EsTUFBYSxZQUFZO0lBQ3JCLFlBQW9CLEtBQVk7UUFBWixVQUFLLEdBQUwsS0FBSyxDQUFPO0lBQUksQ0FBQztJQUVyQyxLQUFLLENBQUMsT0FBTyxDQUFDLEdBQVcsRUFBRSxLQUFhLEVBQUUsVUFBa0I7UUFDeEQsZ0NBQWdDO1FBQ2hDLE1BQU0sTUFBTSxHQUFHLE1BQU0sSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsR0FBRyxFQUFFLEtBQUssRUFBRSxJQUFJLEVBQUUsVUFBVSxFQUFFLElBQUksQ0FBQyxDQUFDO1FBQ3hFLE9BQU8sTUFBTSxLQUFLLElBQUksQ0FBQztJQUMzQixDQUFDO0NBQ0o7QUFSRCxvQ0FRQyJ9

package/dist/storage/storage.interface.d.ts

@@ -0,0 +1,10 @@
+export interface IRepeatStorage {
+    /**
+     * 尝试获取锁/占位
+     * @param key 防重 key
+     * @param value 存储的数据（参数 JSON 字符串）
+     * @param ttlSeconds 过期时间（秒）
+     * @returns 如果成功占位返回 true，如果已存在返回 false
+     */
+    acquire(key: string, value: string, ttlSeconds: number): Promise<boolean>;
+}

package/dist/storage/storage.interface.js

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

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+import type { Context } from '@midwayjs/koa';
+/** 计算 MD5 哈希 */
+export declare function md5(str: string): string;
+/** 递归排序对象键，保证 JSON.stringify 结果稳定 */
+export declare function sortKeys(obj: any): any;
+/** 从对象中根据路径提取值，如 a.b.c */
+export declare function getValueByPath(obj: any, path: string): any;
+/** 获取客户端真实 IP */
+export declare function getClientIp(ctx: Context): string;

package/dist/utils/index.js

@@ -0,0 +1,70 @@
+"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 __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.md5 = md5;
+exports.sortKeys = sortKeys;
+exports.getValueByPath = getValueByPath;
+exports.getClientIp = getClientIp;
+const crypto = __importStar(require("crypto"));
+/** 计算 MD5 哈希 */
+function md5(str) {
+    return crypto.createHash('md5').update(str).digest('hex');
+}
+/** 递归排序对象键，保证 JSON.stringify 结果稳定 */
+function sortKeys(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(sortKeys);
+    return Object.keys(obj)
+        .sort()
+        .reduce((acc, key) => {
+        acc[key] = sortKeys(obj[key]);
+        return acc;
+    }, {});
+}
+/** 从对象中根据路径提取值，如 a.b.c */
+function getValueByPath(obj, path) {
+    return path.split('.').reduce((o, k) => (o === null || o === undefined ? o : o[k]), obj);
+}
+/** 获取客户端真实 IP */
+function getClientIp(ctx) {
+    const headers = ctx.headers;
+    return headers['x-forwarded-for']?.split(',')[0] ||
+        headers['x-real-ip'] ||
+        ctx.ip ||
+        'unknown';
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbHMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFJQSxrQkFFQztBQUdELDRCQVNDO0FBR0Qsd0NBRUM7QUFHRCxrQ0FNQztBQWhDRCwrQ0FBaUM7QUFHakMsZ0JBQWdCO0FBQ2hCLFNBQWdCLEdBQUcsQ0FBQyxHQUFXO0lBQzNCLE9BQU8sTUFBTSxDQUFDLFVBQVUsQ0FBQyxLQUFLLENBQUMsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDO0FBQzlELENBQUM7QUFFRCxxQ0FBcUM7QUFDckMsU0FBZ0IsUUFBUSxDQUFDLEdBQVE7SUFDN0IsSUFBSSxPQUFPLEdBQUcsS0FBSyxRQUFRLElBQUksR0FBRyxLQUFLLElBQUk7UUFBRSxPQUFPLEdBQUcsQ0FBQztJQUN4RCxJQUFJLEtBQUssQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDO1FBQUUsT0FBTyxHQUFHLENBQUMsR0FBRyxDQUFDLFFBQVEsQ0FBQyxDQUFDO0lBQ2pELE9BQU8sTUFBTSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUM7U0FDbEIsSUFBSSxFQUFFO1NBQ04sTUFBTSxDQUFDLENBQUMsR0FBd0IsRUFBRSxHQUFHLEVBQUUsRUFBRTtRQUN0QyxHQUFHLENBQUMsR0FBRyxDQUFDLEdBQUcsUUFBUSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDO1FBQzlCLE9BQU8sR0FBRyxDQUFDO0lBQ2YsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDO0FBQ2YsQ0FBQztBQUVELDBCQUEwQjtBQUMxQixTQUFnQixjQUFjLENBQUMsR0FBUSxFQUFFLElBQVk7SUFDakQsT0FBTyxJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxLQUFLLElBQUksSUFBSSxDQUFDLEtBQUssU0FBUyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLEdBQUcsQ0FBQyxDQUFDO0FBQzdGLENBQUM7QUFFRCxpQkFBaUI7QUFDakIsU0FBZ0IsV0FBVyxDQUFDLEdBQVk7SUFDcEMsTUFBTSxPQUFPLEdBQUcsR0FBRyxDQUFDLE9BQU8sQ0FBQztJQUM1QixPQUFRLE9BQU8sQ0FBQyxpQkFBaUIsQ0FBWSxFQUFFLEtBQUssQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDdkQsT0FBTyxDQUFDLFdBQVcsQ0FBWTtRQUNoQyxHQUFHLENBQUMsRUFBRTtRQUNOLFNBQVMsQ0FBQztBQUNsQixDQUFDIn0=

package/index.d.ts

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

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@jiangnian520/midway-repeat-submit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "专为 Midway 4.0 打造的防重复提交组件。支持内存与 Redis 双驱动，基于切面与原子锁实现高并发防重。",
+  "main": "dist/index.js",
+  "typings": "index.d.ts",
+  "keywords": [
+    "midway",
+    "midwayjs",
+    "repeat-submit",
+    "anti-duplicate",
+    "idempotent",
+    "decorator"
+  ],
+  "author": "jiangnian520",
+  "license": "MIT",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "index.d.ts"
+  ],
+  "scripts": {
+    "build": "mwtsc --cleanOutDir"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "@midwayjs/core": ">=4.0.0",
+    "@midwayjs/koa": ">=4.0.0",
+    "ioredis": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@midwayjs/core": "^4.0.0",
+    "@midwayjs/koa": "^4.0.0",
+    "ioredis": "^5.4.1",
+    "@types/node": "^20.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.