Skip to content
Color theme

API: @loopstack/quota

Classes

QuotaClientService

Service that reads and reports Redis-backed quota counters; inject it to check usage or report consumption.

import { QuotaClientService } from '@loopstack/quota';

Provided by: QuotaModule

export class QuotaClientService implements QuotaClientServiceInterface {
constructor(redis: Redis | null);
checkQuota(userId: string, quotaType: string): Promise<QuotaCheckResult>;
report(userId: string, quotaType: string, amount: number): Promise<void>;
}

QuotaModule

NestJS module that provides opt-in quota tracking and enforcement for tool calls — the QuotaInterceptor, QuotaClientService, QuotaCalculatorRegistry, and built-in AI-cost and processing-time calculators.

Registration:

  • QuotaModule.forRoot(QuotaModuleOptions) — use when you configure the module in code; sets the enabled flag and the Redis connection (redisHost/redisPort/redisPassword/redisDb) and registers the module globally.
  • QuotaModule.forRootAsync() — use when configuration comes from the environment at runtime; reads QUOTA_ENABLED, QUOTA_REDIS_HOST, QUOTA_REDIS_PORT, QUOTA_REDIS_PASSWORD and QUOTA_REDIS_DB, then delegates to forRoot. Anything left unset falls back to the deployment’s own Redis connection (REDIS_URL, or REDIS_HOST / REDIS_PORT / REDIS_PASSWORD / REDIS_DB).

Requires: a reachable Redis instance when enabled: true (usage counters are Redis-backed). When enabled is false (the default), the Redis connection is skipped and the interceptor is a no-op.

import { QuotaModule } from '@loopstack/quota';
export class QuotaModule implements OnModuleInit {
constructor(calculatorRegistry: QuotaCalculatorRegistry);
onModuleInit(): void;
static forRoot(options?: QuotaModuleOptions): DynamicModule;
static forRootAsync(): DynamicModule;
}

Interfaces

QuotaModuleOptions

Options for QuotaModule.forRoot() — toggles quota tracking and configures the Redis connection.

import { QuotaModuleOptions } from '@loopstack/quota';
export interface QuotaModuleOptions {
enabled: boolean;
redisHost?: string;
redisPort?: number;
redisPassword?: string;
redisDb?: number;
}

Type Aliases

QuotaCheckResult

Result of QuotaClientService.checkQuota() — whether the limit is exceeded plus current used and limit values.

import { QuotaCheckResult } from '@loopstack/quota';
export type QuotaCheckResult = {
exceeded: boolean;
used: number;
limit: number;
};