@commandkit/ratelimit 0.0.0-dev.20260317060555

package/dist/api.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Public rate limit helpers.
+ *
+ * Used by handlers and admin tools to inspect, reset, and manage exemptions.
+ */
+import type { CommandKitEnvironment, Context } from 'commandkit';
+import type { RateLimitExemptionGrantParams, RateLimitExemptionInfo, RateLimitExemptionListParams, RateLimitExemptionRevokeParams, RateLimitScope, RateLimitStoreValue } from './types';
+/**
+ * Parameters for resetting a single key or scope-derived key.
+ */
+export interface ResetRateLimitParams {
+    key?: string;
+    scope?: RateLimitScope;
+    userId?: string;
+    guildId?: string;
+    channelId?: string;
+    commandName?: string;
+    keyPrefix?: string;
+}
+/**
+ * Parameters for batch resets by scope, prefix, or pattern.
+ */
+export interface ResetAllRateLimitsParams {
+    scope?: RateLimitScope;
+    userId?: string;
+    guildId?: string;
+    channelId?: string;
+    commandName?: string;
+    keyPrefix?: string;
+    pattern?: string;
+    prefix?: string;
+}
+/**
+ * Read aggregated rate limit info stored on a CommandKit env or context.
+ *
+ * @param envOrCtx - CommandKit environment or context holding the rate-limit store.
+ * @returns Aggregated rate-limit info or null when no store is present.
+ */
+export declare function getRateLimitInfo(envOrCtx: CommandKitEnvironment | Context | null | undefined): RateLimitStoreValue | null;
+/**
+ * Reset a single key and its violation/window variants to keep state consistent.
+ *
+ * @param params - Reset parameters for a single key or scope-derived key.
+ * @returns Resolves when deletes and reset hooks (if any) complete.
+ * @throws Error when required scope identifiers are missing.
+ */
+export declare function resetRateLimit(params: ResetRateLimitParams): Promise<void>;
+/**
+ * Reset multiple keys by scope, command name, prefix, or pattern for bulk cleanup.
+ *
+ * @param params - Batch reset parameters, defaulting to an empty config.
+ * @returns Resolves when all matching keys are deleted.
+ * @throws Error when the storage backend lacks required delete helpers.
+ * @throws Error when scope identifiers are missing for scope-based resets.
+ */
+export declare function resetAllRateLimits(params?: ResetAllRateLimitsParams): Promise<void>;
+/**
+ * Grant a temporary exemption for a scope/id pair.
+ *
+ * @param params - Exemption scope, id, and duration.
+ * @returns Resolves when the exemption key is written.
+ * @throws Error when duration is missing or non-positive.
+ */
+export declare function grantRateLimitExemption(params: RateLimitExemptionGrantParams): Promise<void>;
+/**
+ * Revoke a temporary exemption for a scope/id pair.
+ *
+ * @param params - Exemption scope and id to revoke.
+ * @returns Resolves when the exemption key is removed.
+ */
+export declare function revokeRateLimitExemption(params: RateLimitExemptionRevokeParams): Promise<void>;
+/**
+ * List exemptions by scope and/or id for admin/reporting.
+ *
+ * @param params - Optional scope/id filters and limits.
+ * @returns Exemption info entries that match the requested filters.
+ * @throws Error when scope is required but missing or listing is unsupported.
+ */
+export declare function listRateLimitExemptions(params?: RateLimitExemptionListParams): Promise<RateLimitExemptionInfo[]>;

package/dist/api.js

@@ -0,0 +1,266 @@
+"use strict";
+/**
+ * Public rate limit helpers.
+ *
+ * Used by handlers and admin tools to inspect, reset, and manage exemptions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRateLimitInfo = getRateLimitInfo;
+exports.resetRateLimit = resetRateLimit;
+exports.resetAllRateLimits = resetAllRateLimits;
+exports.grantRateLimitExemption = grantRateLimitExemption;
+exports.revokeRateLimitExemption = revokeRateLimitExemption;
+exports.listRateLimitExemptions = listRateLimitExemptions;
+const constants_1 = require("./constants");
+const runtime_1 = require("./runtime");
+const keys_1 = require("./utils/keys");
+const time_1 = require("./utils/time");
+/**
+ * Read aggregated rate limit info stored on a CommandKit env or context.
+ *
+ * @param envOrCtx - CommandKit environment or context holding the rate-limit store.
+ * @returns Aggregated rate-limit info or null when no store is present.
+ */
+function getRateLimitInfo(envOrCtx) {
+    if (!envOrCtx)
+        return null;
+    const store = 'store' in envOrCtx ? envOrCtx.store : null;
+    if (!store)
+        return null;
+    return store.get(constants_1.RATELIMIT_STORE_KEY) ?? null;
+}
+/**
+ * Resolve the active storage or throw when none is configured.
+ *
+ * @returns Configured rate-limit storage.
+ * @throws Error when storage is not configured.
+ */
+function getRequiredStorage() {
+    return getRuntimeStorage().storage;
+}
+/**
+ * Resolve runtime context plus the effective storage to use.
+ *
+ * @returns Runtime context (if any) and the resolved storage.
+ * @throws Error when storage is not configured.
+ */
+function getRuntimeStorage() {
+    const runtime = (0, runtime_1.getRateLimitRuntime)();
+    const storage = runtime?.storage ?? (0, runtime_1.getRateLimitStorage)();
+    if (!storage) {
+        throw new Error('Rate limit storage not configured');
+    }
+    return { runtime, storage };
+}
+/**
+ * Normalize a prefix to include the window suffix marker.
+ *
+ * @param prefix - Base key prefix.
+ * @returns Prefix guaranteed to end with `w:`.
+ */
+function toWindowPrefix(prefix) {
+    return prefix.endsWith(':') ? `${prefix}w:` : `${prefix}:w:`;
+}
+/**
+ * Reset a single key and its violation/window variants to keep state consistent.
+ *
+ * @param params - Reset parameters for a single key or scope-derived key.
+ * @returns Resolves when deletes and reset hooks (if any) complete.
+ * @throws Error when required scope identifiers are missing.
+ */
+async function resetRateLimit(params) {
+    const storage = getRequiredStorage();
+    const hooks = (0, runtime_1.getRateLimitRuntime)()?.hooks;
+    if (params.key) {
+        await storage.delete(params.key);
+        await storage.delete(`violation:${params.key}`);
+        await deleteWindowVariants(storage, params.key);
+        if (hooks?.onReset) {
+            await hooks.onReset(params.key);
+        }
+        return;
+    }
+    if (!params.scope || !params.commandName) {
+        throw new Error('scope and commandName are required when key is not provided');
+    }
+    const prefix = (0, keys_1.buildScopePrefix)(params.scope, params.keyPrefix, {
+        userId: params.userId,
+        guildId: params.guildId,
+        channelId: params.channelId,
+    });
+    if (!prefix) {
+        throw new Error('Missing identifiers for scope');
+    }
+    const key = `${prefix}${params.commandName}`;
+    await storage.delete(key);
+    await storage.delete(`violation:${key}`);
+    await deleteWindowVariants(storage, key);
+    if (hooks?.onReset) {
+        await hooks.onReset(key);
+    }
+}
+/**
+ * Reset multiple keys by scope, command name, prefix, or pattern for bulk cleanup.
+ *
+ * @param params - Batch reset parameters, defaulting to an empty config.
+ * @returns Resolves when all matching keys are deleted.
+ * @throws Error when the storage backend lacks required delete helpers.
+ * @throws Error when scope identifiers are missing for scope-based resets.
+ */
+async function resetAllRateLimits(params = {}) {
+    const storage = getRequiredStorage();
+    if (params.pattern) {
+        if (!storage.deleteByPattern) {
+            throw new Error('Storage does not support pattern deletes');
+        }
+        await storage.deleteByPattern(params.pattern);
+        await storage.deleteByPattern(`violation:${params.pattern}`);
+        await storage.deleteByPattern(`${params.pattern}:w:*`);
+        await storage.deleteByPattern(`violation:${params.pattern}:w:*`);
+        return;
+    }
+    if (params.prefix) {
+        if (!storage.deleteByPrefix) {
+            throw new Error('Storage does not support prefix deletes');
+        }
+        const windowPrefix = toWindowPrefix(params.prefix);
+        await storage.deleteByPrefix(params.prefix);
+        await storage.deleteByPrefix(`violation:${params.prefix}`);
+        await storage.deleteByPrefix(windowPrefix);
+        await storage.deleteByPrefix(`violation:${windowPrefix}`);
+        return;
+    }
+    if (params.commandName) {
+        if (!storage.deleteByPattern) {
+            throw new Error('Storage does not support pattern deletes');
+        }
+        const prefix = params.keyPrefix ?? '';
+        const pattern = `${prefix}*:${params.commandName}`;
+        await storage.deleteByPattern(pattern);
+        await storage.deleteByPattern(`violation:${pattern}`);
+        await storage.deleteByPattern(`${pattern}:w:*`);
+        await storage.deleteByPattern(`violation:${pattern}:w:*`);
+        return;
+    }
+    if (!params.scope) {
+        throw new Error('scope is required when commandName is not provided');
+    }
+    const scopePrefix = (0, keys_1.buildScopePrefix)(params.scope, params.keyPrefix, {
+        userId: params.userId,
+        guildId: params.guildId,
+        channelId: params.channelId,
+    });
+    if (!scopePrefix) {
+        throw new Error('Missing identifiers for scope');
+    }
+    if (!storage.deleteByPrefix) {
+        throw new Error('Storage does not support prefix deletes');
+    }
+    const windowPrefix = toWindowPrefix(scopePrefix);
+    await storage.deleteByPrefix(scopePrefix);
+    await storage.deleteByPrefix(`violation:${scopePrefix}`);
+    await storage.deleteByPrefix(windowPrefix);
+    await storage.deleteByPrefix(`violation:${windowPrefix}`);
+}
+/**
+ * Grant a temporary exemption for a scope/id pair.
+ *
+ * @param params - Exemption scope, id, and duration.
+ * @returns Resolves when the exemption key is written.
+ * @throws Error when duration is missing or non-positive.
+ */
+async function grantRateLimitExemption(params) {
+    const { runtime, storage } = getRuntimeStorage();
+    const keyPrefix = params.keyPrefix ?? runtime?.keyPrefix;
+    const ttlMs = (0, time_1.resolveDuration)(params.duration, 0);
+    if (!ttlMs || ttlMs <= 0) {
+        throw new Error('duration must be a positive value');
+    }
+    const key = (0, keys_1.buildExemptionKey)(params.scope, params.id, keyPrefix);
+    await storage.set(key, true, ttlMs);
+}
+/**
+ * Revoke a temporary exemption for a scope/id pair.
+ *
+ * @param params - Exemption scope and id to revoke.
+ * @returns Resolves when the exemption key is removed.
+ */
+async function revokeRateLimitExemption(params) {
+    const { runtime, storage } = getRuntimeStorage();
+    const keyPrefix = params.keyPrefix ?? runtime?.keyPrefix;
+    const key = (0, keys_1.buildExemptionKey)(params.scope, params.id, keyPrefix);
+    await storage.delete(key);
+}
+/**
+ * List exemptions by scope and/or id for admin/reporting.
+ *
+ * @param params - Optional scope/id filters and limits.
+ * @returns Exemption info entries that match the requested filters.
+ * @throws Error when scope is required but missing or listing is unsupported.
+ */
+async function listRateLimitExemptions(params = {}) {
+    const { runtime, storage } = getRuntimeStorage();
+    const keyPrefix = params.keyPrefix ?? runtime?.keyPrefix;
+    if (params.id && !params.scope) {
+        throw new Error('scope is required when id is provided');
+    }
+    if (params.scope && params.id) {
+        const key = (0, keys_1.buildExemptionKey)(params.scope, params.id, keyPrefix);
+        const exists = await storage.get(key);
+        if (!exists)
+            return [];
+        const expiresInMs = storage.ttl ? await storage.ttl(key) : null;
+        return [
+            {
+                key,
+                scope: params.scope,
+                id: params.id,
+                expiresInMs,
+            },
+        ];
+    }
+    if (!storage.keysByPrefix) {
+        throw new Error('Storage does not support listing exemptions');
+    }
+    const prefix = (0, keys_1.buildExemptionPrefix)(keyPrefix, params.scope);
+    const keys = await storage.keysByPrefix(prefix);
+    const results = [];
+    for (const key of keys) {
+        const parsed = (0, keys_1.parseExemptionKey)(key, keyPrefix);
+        if (!parsed)
+            continue;
+        if (params.scope && parsed.scope !== params.scope)
+            continue;
+        const expiresInMs = storage.ttl ? await storage.ttl(key) : null;
+        results.push({
+            key,
+            scope: parsed.scope,
+            id: parsed.id,
+            expiresInMs,
+        });
+        if (params.limit && results.length >= params.limit) {
+            break;
+        }
+    }
+    return results;
+}
+/**
+ * Delete windowed variants for a base key using available storage helpers.
+ *
+ * @param storage - Storage driver to delete from.
+ * @param key - Base key to delete window variants for.
+ * @returns Resolves after window variants are removed.
+ */
+async function deleteWindowVariants(storage, key) {
+    const prefix = `${key}:w:`;
+    if (storage.deleteByPrefix) {
+        await storage.deleteByPrefix(prefix);
+        await storage.deleteByPrefix(`violation:${prefix}`);
+        return;
+    }
+    if (storage.deleteByPattern) {
+        await storage.deleteByPattern(`${key}:w:*`);
+        await storage.deleteByPattern(`violation:${key}:w:*`);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2FwaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7R0FJRzs7QUF1REgsNENBT0M7QUErQ0Qsd0NBdUNDO0FBVUQsZ0RBZ0VDO0FBU0QsMERBYUM7QUFRRCw0REFPQztBQVNELDBEQW9EQztBQTdURCwyQ0FBa0Q7QUFDbEQsdUNBQXFFO0FBVXJFLHVDQUtzQjtBQUN0Qix1Q0FBK0M7QUE2Qi9DOzs7OztHQUtHO0FBQ0gsU0FBZ0IsZ0JBQWdCLENBQzlCLFFBQTREO0lBRTVELElBQUksQ0FBQyxRQUFRO1FBQUUsT0FBTyxJQUFJLENBQUM7SUFDM0IsTUFBTSxLQUFLLEdBQUcsT0FBTyxJQUFJLFFBQVEsQ0FBQyxDQUFDLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDO0lBQzFELElBQUksQ0FBQyxLQUFLO1FBQUUsT0FBTyxJQUFJLENBQUM7SUFDeEIsT0FBUSxLQUFLLENBQUMsR0FBRyxDQUFDLCtCQUFtQixDQUF5QixJQUFJLElBQUksQ0FBQztBQUN6RSxDQUFDO0FBRUQ7Ozs7O0dBS0c7QUFDSCxTQUFTLGtCQUFrQjtJQUN6QixPQUFPLGlCQUFpQixFQUFFLENBQUMsT0FBTyxDQUFDO0FBQ3JDLENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILFNBQVMsaUJBQWlCO0lBSXhCLE1BQU0sT0FBTyxHQUFHLElBQUEsNkJBQW1CLEdBQUUsQ0FBQztJQUN0QyxNQUFNLE9BQU8sR0FBRyxPQUFPLEVBQUUsT0FBTyxJQUFJLElBQUEsNkJBQW1CLEdBQUUsQ0FBQztJQUMxRCxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUM7UUFDYixNQUFNLElBQUksS0FBSyxDQUFDLG1DQUFtQyxDQUFDLENBQUM7SUFDdkQsQ0FBQztJQUNELE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLENBQUM7QUFDOUIsQ0FBQztBQUVEOzs7OztHQUtHO0FBQ0gsU0FBUyxj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

package/dist/augmentation.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CommandKit metadata augmentation.
+ *
+ * Extends CommandKit metadata so commands can declare per-command limits.
+ */
+import type { RateLimitCommandConfig } from './types';
+declare module 'commandkit' {
+    interface CommandMetadata {
+        ratelimit?: RateLimitCommandConfig | boolean;
+    }
+}

package/dist/augmentation.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * CommandKit metadata augmentation.
+ *
+ * Extends CommandKit metadata so commands can declare per-command limits.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXVnbWVudGF0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2F1Z21lbnRhdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7R0FJRyJ9

package/dist/configure.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Runtime configuration for the rate limit plugin.
+ *
+ * Mirrors configureAI so runtime options can be set outside commandkit.config
+ * before the plugin evaluates commands.
+ */
+import type { RateLimitPluginOptions } from './types';
+/**
+ * Returns true once configureRatelimit has been called.
+ *
+ * @returns True when runtime configuration has been initialized.
+ */
+export declare function isRateLimitConfigured(): boolean;
+/**
+ * Retrieves the current rate limit configuration.
+ *
+ * @returns The current in-memory rate limit config object.
+ */
+export declare function getRateLimitConfig(): RateLimitPluginOptions;
+/**
+ * Configures the rate limit plugin runtime options.
+ *
+ * Call this once during startup (for example in src/ratelimit.ts).
+ *
+ * @param config - Runtime options to merge into the active configuration.
+ * @returns Nothing; updates runtime state in place.
+ */
+export declare function configureRatelimit(config?: RateLimitPluginOptions): void;

package/dist/configure.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Runtime configuration for the rate limit plugin.
+ *
+ * Mirrors configureAI so runtime options can be set outside commandkit.config
+ * before the plugin evaluates commands.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRateLimitConfigured = isRateLimitConfigured;
+exports.getRateLimitConfig = getRateLimitConfig;
+exports.configureRatelimit = configureRatelimit;
+const config_1 = require("./utils/config");
+const runtime_1 = require("./runtime");
+const rateLimitConfig = {};
+let configured = false;
+/**
+ * Normalize a storage config into a storage driver instance.
+ *
+ * @param config - Storage config or driver.
+ * @returns Storage driver instance or null when not configured.
+ */
+function resolveStorage(config) {
+    if (!config)
+        return null;
+    if (typeof config === 'object' && 'driver' in config) {
+        return config.driver;
+    }
+    return config;
+}
+/**
+ * Apply updated config to the active runtime context.
+ *
+ * @param config - Runtime configuration updates.
+ * @returns Nothing; mutates the active runtime context when present.
+ */
+function updateRuntime(config) {
+    const runtime = (0, runtime_1.getRateLimitRuntime)();
+    const storageOverride = config.storage
+        ? resolveStorage(config.storage)
+        : null;
+    if (storageOverride) {
+        (0, runtime_1.setRateLimitStorage)(storageOverride);
+    }
+    if (!runtime) {
+        return;
+    }
+    const nextRuntime = {
+        storage: storageOverride ?? runtime.storage,
+        keyPrefix: config.keyPrefix ?? runtime.keyPrefix,
+        defaultLimiter: config.defaultLimiter ?? runtime.defaultLimiter ?? config_1.DEFAULT_LIMITER,
+        limiters: config.limiters ?? runtime.limiters,
+        hooks: config.hooks ?? runtime.hooks,
+    };
+    (0, runtime_1.setRateLimitRuntime)(nextRuntime);
+}
+/**
+ * Returns true once configureRatelimit has been called.
+ *
+ * @returns True when runtime configuration has been initialized.
+ */
+function isRateLimitConfigured() {
+    return configured;
+}
+/**
+ * Retrieves the current rate limit configuration.
+ *
+ * @returns The current in-memory rate limit config object.
+ */
+function getRateLimitConfig() {
+    return rateLimitConfig;
+}
+/**
+ * Configures the rate limit plugin runtime options.
+ *
+ * Call this once during startup (for example in src/ratelimit.ts).
+ *
+ * @param config - Runtime options to merge into the active configuration.
+ * @returns Nothing; updates runtime state in place.
+ */
+function configureRatelimit(config = {}) {
+    configured = true;
+    Object.assign(rateLimitConfig, config);
+    updateRuntime(config);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlndXJlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbmZpZ3VyZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7O0dBS0c7O0FBdUVILHNEQUVDO0FBT0QsZ0RBRUM7QUFVRCxnREFJQztBQTlGRCwyQ0FBaUQ7QUFDakQsdUNBSW1CO0FBUW5CLE1BQU0sZUFBZSxHQUEyQixFQUFFLENBQUM7QUFDbkQsSUFBSSxVQUFVLEdBQUcsS0FBSyxDQUFDO0FBRXZCOzs7OztHQUtHO0FBQ0gsU0FBUyxjQUFjLENBQ3JCLE1BQThCO0lBRTlCLElBQUksQ0FBQyxNQUFNO1FBQUUsT0FBTyxJQUFJLENBQUM7SUFDekIsSUFBSSxPQUFPLE1BQU0sS0FBSyxRQUFRLElBQUksUUFBUSxJQUFJLE1BQU0sRUFBRSxDQUFDO1FBQ3JELE9BQU8sTUFBTSxDQUFDLE1BQU0sQ0FBQztJQUN2QixDQUFDO0lBQ0QsT0FBTyxNQUFNLENBQUM7QUFDaEIsQ0FBQztBQUVEOzs7OztHQUtHO0FBQ0gsU0FBUyxhQUFhLENBQUMsTUFBOEI7SUFDbkQsTUFBTSxPQUFPLEdBQUcsSUFBQSw2QkFBbUIsR0FBRSxDQUFDO0lBQ3RDLE1BQU0sZUFBZSxHQUFHLE1BQU0sQ0FBQyxPQUFPO1FBQ3BDLENBQUMsQ0FBQyxjQUFjLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBQztRQUNoQyxDQUFDLENBQUMsSUFBSSxDQUFDO0lBRVQsSUFBSSxlQUFlLEVBQUUsQ0FBQztRQUNwQixJQUFBLDZCQUFtQixFQUFDLGVBQWUsQ0FBQyxDQUFDO0lBQ3ZDLENBQUM7SUFFRCxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUM7UUFDYixPQUFPO0lBQ1QsQ0FBQztJQUVELE1BQU0sV0FBVyxHQUE0QjtRQUMzQyxPQUFPLEVBQUUsZUFBZSxJQUFJLE9BQU8sQ0FBQyxPQUFPO1FBQzNDLFNBQVMsRUFBRSxNQUFNLENBQUMsU0FBUyxJQUFJLE9BQU8sQ0FBQyxTQUFTO1FBQ2hELGNBQWMsRUFDWixNQUFNLENBQUMsY0FBYyxJQUFJLE9BQU8sQ0FBQyxjQUFjLElBQUksd0JBQWU7UUFDcEUsUUFBUSxFQUFFLE1BQU0sQ0FBQyxRQUFRLElBQUksT0FBTyxDQUFDLFFBQVE7UUFDN0MsS0FBSyxFQUFFLE1BQU0sQ0FBQyxLQUFLLElBQUksT0FBTyxDQUFDLEtBQUs7S0FDckMsQ0FBQztJQUVGLElBQUEsNkJBQW1CLEVBQUMsV0FBVyxDQUFDLENBQUM7QUFDbkMsQ0FBQztBQUVEOzs7O0dBSUc7QUFDSCxTQUFnQixxQkFBcUI7SUFDbkMsT0FBTyxVQUFVLENBQUM7QUFDcEIsQ0FBQztBQUVEOzs7O0dBSUc7QUFDSCxTQUFnQixrQkFBa0I7SUFDaEMsT0FBTyxlQUFlLENBQUM7QUFDekIsQ0FBQztBQUVEOzs7Ozs7O0dBT0c7QUFDSCxTQUFnQixrQkFBa0IsQ0FBQyxTQUFpQyxFQUFFO0lBQ3BFLFVBQVUsR0FBRyxJQUFJLENBQUM7SUFDbEIsTUFBTSxDQUFDLE1BQU0sQ0FBQyxlQUFlLEVBQUUsTUFBTSxDQUFDLENBQUM7SUFDdkMsYUFBYSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0FBQ3hCLENBQUMifQ==

package/dist/constants.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Rate limit constants shared across runtime and tests.
+ *
+ * Keeps key names consistent across storage, runtime, and docs.
+ */
+/**
+ * Store key used to stash aggregated results in CommandKit envs.
+ *
+ * @default 'ratelimit'
+ */
+export declare const RATELIMIT_STORE_KEY = "ratelimit";
+/**
+ * Default prefix for storage keys; can be overridden per config.
+ *
+ * @default 'rl:'
+ */
+export declare const DEFAULT_KEY_PREFIX = "rl:";

package/dist/constants.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Rate limit constants shared across runtime and tests.
+ *
+ * Keeps key names consistent across storage, runtime, and docs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_KEY_PREFIX = exports.RATELIMIT_STORE_KEY = void 0;
+/**
+ * Store key used to stash aggregated results in CommandKit envs.
+ *
+ * @default 'ratelimit'
+ */
+exports.RATELIMIT_STORE_KEY = 'ratelimit';
+/**
+ * Default prefix for storage keys; can be overridden per config.
+ *
+ * @default 'rl:'
+ */
+exports.DEFAULT_KEY_PREFIX = 'rl:';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbnN0YW50cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7R0FJRzs7O0FBRUg7Ozs7R0FJRztBQUNVLFFBQUEsbUJBQW1CLEdBQUcsV0FBVyxDQUFDO0FBRS9DOzs7O0dBSUc7QUFDVSxRQUFBLGtCQUFrQixHQUFHLEtBQUssQ0FBQyJ9

package/dist/directive/use-ratelimit-directive.d.ts

@@ -0,0 +1,22 @@
+import { CommonDirectiveTransformer, type CommonDirectiveTransformerOptions, type CompilerPluginRuntime } from 'commandkit';
+/**
+ * Compiler plugin for the "use ratelimit" directive.
+ *
+ * @extends CommonDirectiveTransformer
+ */
+export declare class UseRateLimitDirectivePlugin extends CommonDirectiveTransformer {
+    readonly name = "UseRateLimitDirectivePlugin";
+    /**
+     * Create the directive compiler plugin with optional overrides.
+     *
+     * @param options - Common directive transformer overrides.
+     */
+    constructor(options?: Partial<CommonDirectiveTransformerOptions>);
+    /**
+     * Activate the compiler plugin in the current build runtime.
+     *
+     * @param ctx - Compiler plugin runtime.
+     * @returns Resolves after activation completes.
+     */
+    activate(ctx: CompilerPluginRuntime): Promise<void>;
+}

package/dist/directive/use-ratelimit-directive.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UseRateLimitDirectivePlugin = void 0;
+const commandkit_1 = require("commandkit");
+/**
+ * Compiler plugin for the "use ratelimit" directive.
+ *
+ * @extends CommonDirectiveTransformer
+ */
+class UseRateLimitDirectivePlugin extends commandkit_1.CommonDirectiveTransformer {
+    /**
+     * Create the directive compiler plugin with optional overrides.
+     *
+     * @param options - Common directive transformer overrides.
+     */
+    constructor(options) {
+        super({
+            enabled: true,
+            ...options,
+            directive: 'use ratelimit',
+            importPath: '@commandkit/ratelimit',
+            importName: '$ckitirl',
+            asyncOnly: true,
+        });
+        this.name = 'UseRateLimitDirectivePlugin';
+    }
+    /**
+     * Activate the compiler plugin in the current build runtime.
+     *
+     * @param ctx - Compiler plugin runtime.
+     * @returns Resolves after activation completes.
+     */
+    async activate(ctx) {
+        await super.activate(ctx);
+    }
+}
+exports.UseRateLimitDirectivePlugin = UseRateLimitDirectivePlugin;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlLXJhdGVsaW1pdC1kaXJlY3RpdmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZGlyZWN0aXZlL3VzZS1yYXRlbGltaXQtZGlyZWN0aXZlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLDJDQUlvQjtBQUVwQjs7OztHQUlHO0FBQ0gsTUFBYSwyQkFBNEIsU0FBUSx1Q0FBMEI7SUFHekU7Ozs7T0FJRztJQUNILFlBQW1CLE9BQW9EO1FBQ3JFLEtBQUssQ0FBQztZQUNKLE9BQU8sRUFBRSxJQUFJO1lBQ2IsR0FBRyxPQUFPO1lBQ1YsU0FBUyxFQUFFLGVBQWU7WUFDMUIsVUFBVSxFQUFFLHVCQUF1QjtZQUNuQyxVQUFVLEVBQUUsVUFBVTtZQUN0QixTQUFTLEVBQUUsSUFBSTtTQUNoQixDQUFDLENBQUM7UUFmVyxTQUFJLEdBQUcsNkJBQTZCLENBQUM7SUFnQnJELENBQUM7SUFFRDs7Ozs7T0FLRztJQUNJLEtBQUssQ0FBQyxRQUFRLENBQUMsR0FBMEI7UUFDOUMsTUFBTSxLQUFLLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQzVCLENBQUM7Q0FDRjtBQTVCRCxrRUE0QkMifQ==

package/dist/directive/use-ratelimit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Runtime wrapper for the "use ratelimit" directive.
+ *
+ * Uses the runtime default limiter for arbitrary async functions.
+ * Throws RateLimitError when the call is limited.
+ */
+import type { GenericFunction } from 'commandkit';
+/**
+ * Wrapper symbol injected by the compiler plugin.
+ *
+ * @param fn - Generic function to wrap with runtime rate limiting.
+ * @returns Wrapped function that enforces the runtime default limiter.
+ */
+export declare const $ckitirl: GenericFunction;