@commandkit/ratelimit 0.0.0-dev.20260317060555

package/dist/utils/time.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Time helpers for rate limits.
+ *
+ * Converts user-friendly durations into milliseconds and clamps values
+ * so storage and algorithms always receive safe inputs.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDuration = resolveDuration;
+exports.clampAtLeast = clampAtLeast;
+const ms_1 = __importDefault(require("ms"));
+const WEEK_MS = 7 * 24 * 60 * 60 * 1000;
+const MONTH_MS = 30 * 24 * 60 * 60 * 1000;
+/**
+ * Resolve a duration input into milliseconds with a fallback.
+ *
+ * @param value - Duration input as ms or string.
+ * @param fallback - Fallback value used when parsing fails.
+ * @returns Parsed duration in milliseconds.
+ */
+function resolveDuration(value, fallback) {
+    if (value == null)
+        return fallback;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string') {
+        /**
+         * Allow week/month units so config can use human-friendly windows.
+         */
+        const custom = parseExtendedDuration(value);
+        if (custom != null)
+            return custom;
+        const parsed = (0, ms_1.default)(value);
+        if (typeof parsed === 'number' && Number.isFinite(parsed))
+            return parsed;
+    }
+    return fallback;
+}
+/**
+ * Parse week/month duration strings that ms does not support.
+ *
+ * @param value - Raw duration string.
+ * @returns Parsed duration in ms or null when invalid.
+ */
+function parseExtendedDuration(value) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return null;
+    const match = trimmed.match(/^(\d+(?:\.\d+)?)\s*(w|week|weeks|mo|month|months)$/i);
+    if (!match)
+        return null;
+    const amount = Number(match[1]);
+    if (!Number.isFinite(amount) || amount <= 0)
+        return null;
+    const unit = match[2].toLowerCase();
+    const multiplier = unit === 'w' || unit === 'week' || unit === 'weeks' ? WEEK_MS : MONTH_MS;
+    return Math.round(amount * multiplier);
+}
+/**
+ * Clamp a number to a minimum value to avoid zero/negative windows.
+ *
+ * @param value - Value to clamp.
+ * @param min - Minimum allowed value.
+ * @returns The clamped value.
+ */
+function clampAtLeast(value, min) {
+    return value < min ? min : value;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGltZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy90aW1lLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7Ozs7R0FLRzs7Ozs7QUFlSCwwQ0FnQkM7QUFrQ0Qsb0NBRUM7QUFqRUQsNENBQTBDO0FBRzFDLE1BQU0sT0FBTyxHQUFHLENBQUMsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUM7QUFDeEMsTUFBTSxRQUFRLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FBQztBQUUxQzs7Ozs7O0dBTUc7QUFDSCxTQUFnQixlQUFlLENBQzdCLEtBQStCLEVBQy9CLFFBQWdCO0lBRWhCLElBQUksS0FBSyxJQUFJLElBQUk7UUFBRSxPQUFPLFFBQVEsQ0FBQztJQUNuQyxJQUFJLE9BQU8sS0FBSyxLQUFLLFFBQVEsSUFBSSxNQUFNLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQztRQUFFLE9BQU8sS0FBSyxDQUFDO0lBQ3RFLElBQUksT0FBTyxLQUFLLEtBQUssUUFBUSxFQUFFLENBQUM7UUFDOUI7O1dBRUc7UUFDSCxNQUFNLE1BQU0sR0FBRyxxQkFBcUIsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUM1QyxJQUFJLE1BQU0sSUFBSSxJQUFJO1lBQUUsT0FBTyxNQUFNLENBQUM7UUFDbEMsTUFBTSxNQUFNLEdBQUcsSUFBQSxZQUFFLEVBQUMsS0FBb0IsQ0FBQyxDQUFDO1FBQ3hDLElBQUksT0FBTyxNQUFNLEtBQUssUUFBUSxJQUFJLE1BQU0sQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDO1lBQUUsT0FBTyxNQUFNLENBQUM7SUFDM0UsQ0FBQztJQUNELE9BQU8sUUFBUSxDQUFDO0FBQ2xCLENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILFNBQVMscUJBQXFCLENBQUMsS0FBYTtJQUMxQyxNQUFNLE9BQU8sR0FBRyxLQUFLLENBQUMsSUFBSSxFQUFFLENBQUM7SUFDN0IsSUFBSSxDQUFDLE9BQU87UUFBRSxPQUFPLElBQUksQ0FBQztJQUUxQixNQUFNLEtBQUssR0FBRyxPQUFPLENBQUMsS0FBSyxDQUN6QixxREFBcUQsQ0FDdEQsQ0FBQztJQUNGLElBQUksQ0FBQyxLQUFLO1FBQUUsT0FBTyxJQUFJLENBQUM7SUFFeEIsTUFBTSxNQUFNLEdBQUcsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQ2hDLElBQUksQ0FBQyxNQUFNLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxJQUFJLE1BQU0sSUFBSSxDQUFDO1FBQUUsT0FBTyxJQUFJLENBQUM7SUFFekQsTUFBTSxJQUFJLEdBQUcsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLFdBQVcsRUFBRSxDQUFDO0lBQ3BDLE1BQU0sVUFBVSxHQUNkLElBQUksS0FBSyxHQUFHLElBQUksSUFBSSxLQUFLLE1BQU0sSUFBSSxJQUFJLEtBQUssT0FBTyxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQztJQUUzRSxPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsTUFBTSxHQUFHLFVBQVUsQ0FBQyxDQUFDO0FBQ3pDLENBQUM7QUFFRDs7Ozs7O0dBTUc7QUFDSCxTQUFnQixZQUFZLENBQUMsS0FBYSxFQUFFLEdBQVc7SUFDckQsT0FBTyxLQUFLLEdBQUcsR0FBRyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQztBQUNuQyxDQUFDIn0=

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@commandkit/ratelimit",
+  "version": "0.0.0-dev.20260317060555",
+  "description": "CommandKit plugin that provides advanced rate limiting",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./redis": {
+      "import": "./dist/providers/redis.js",
+      "types": "./dist/providers/redis.d.ts"
+    },
+    "./memory": {
+      "import": "./dist/providers/memory.js",
+      "types": "./dist/providers/memory.d.ts"
+    },
+    "./fallback": {
+      "import": "./dist/providers/fallback.js",
+      "types": "./dist/providers/fallback.d.ts"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/neplextech/commandkit.git",
+    "directory": "packages/ratelimit"
+  },
+  "keywords": [
+    "commandkit",
+    "ratelimit",
+    "rate limiting"
+  ],
+  "contributors": [
+    "Twilight <hello@twlite.dev>",
+    "Avraj <avraj@underctrl.io>"
+  ],
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/neplextech/commandkit/issues"
+  },
+  "homepage": "https://commandkit.dev",
+  "dependencies": {
+    "ioredis": "^5.10.0",
+    "ms": "^2.1.3"
+  },
+  "devDependencies": {
+    "@types/ms": "^2.1.0",
+    "discord.js": "^14.25.1",
+    "directive-to-hof": "^0.0.3",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18",
+    "commandkit": "1.2.1-dev.20260317060555",
+    "tsconfig": "0.0.0-dev.20260317060555"
+  },
+  "scripts": {
+    "check-types": "tsc --noEmit",
+    "build": "tsc",
+    "test": "vitest"
+  }
+}