@ragemp-mango/server 2.0.6-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Aurėjus Remeika
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+## Mango Framework
+
+A simple, lightweight, and powerful TypeScript framework for building RageMP servers.
+
+## Features
+
+-   Mango Framework is built with TypeScript and provides a powerful type system for your application.
+-   Mango Framework has a wide range of decorators that allow you to easily create and manage your resource flow.
+-   Mango Framework is built with modularity in mind, allowing you to organize your application into small, reusable pieces.
+-   Mango Framework uses InversifyJS under the hood to provide a powerful dependency injection for your application.
+-   Mango Framework uses controllers to group and listen to events/rpcs together under a single class.
+-   Mango Framework uses Guards, Interceptors, and Error Filters to create a powerful pipeline that allows you to easily manage every incoming event/rpc.
+
+## Documentation
+
+[Documentation](https://ragemp-mango.vercel.app)
+
+## License
+
+[MIT](https://choosealicense.com/licenses/mit/)

package/dist/index.d.ts

@@ -0,0 +1,441 @@
+import { MangoRequest as MangoRequest$1, MangoResponse as MangoResponse$1, ErrorFilter as ErrorFilter$1, ExecutionContext as ExecutionContext$1, Guard as Guard$1, Interceptor as Interceptor$1, EventEmmiter, ScriptEventHandler, MultiplayerService, AppBuilder } from '@ragemp-mango/core/app';
+import { RPCCallOptions, RPCResult, ScriptRPCHandler, Newable, Pipe, ModuleOptions, InjectionToken, OnAppShutdown, OnModuleInit, ReflectorService, DynamicModule } from '@ragemp-mango/core';
+export { GuardCancelError, GuardInvalidReturnError, MangoError, TooManyRequests, UnknownError } from '@ragemp-mango/core';
+export { Body, Catch, Controller, Cron, EveryTick, Global, Index, Inject, Injectable, Interval, Module, Optional, Param, Req, Request, Res, Response, SetMetadata, Timeout, UsePipes, applyDecorators, createParamDecorator, forwardRef } from '@ragemp-mango/core/decorators';
+export { ArgumentMetadata, BeforeAppShutdown, CallHandler, ClassProvider, ControllerOptions, CreateDecoratorOptions, CreateDecoratorWithTransformOptions, DynamicModule, ExistingProvider, FactoryProvider, InjectableOptions, LoggerService, ModuleOptions, OnAppBootstrap, OnAppShutdown, OnModuleDestroy, OnModuleInit, OptionalFactoryDependency, Pipe, Provider, RPCCallOptions, RPCError, RPCResult, ReflectableDecorator, ScriptRPCHandler, ValueProvider } from '@ragemp-mango/core/interfaces';
+export { Abstract, CustomDecorator, InjectionToken, Newable } from '@ragemp-mango/core/types';
+export { EVENT_SERVICE, LOGGER_SERVICE, MODULE_CONTAINER, REFLECTOR_SERVICE, RPC_SERVICE, TIMER_SERVICE } from '@ragemp-mango/core/constants';
+export { InjectableScope, RPCResultStatus } from '@ragemp-mango/core/enums';
+export { DefaultValuePipe } from '@ragemp-mango/core/pipes';
+export { generateRandomId, isConstructor, isEmpty, isFunction, isNil, isNumber, isObject, isString, isSymbol, isUndefined } from '@ragemp-mango/core/utils';
+export { ReflectorService, TimerService } from '@ragemp-mango/core/services';
+
+interface MangoRequest extends MangoRequest$1 {
+    player?: PlayerMp;
+}
+
+interface MangoResponse extends MangoResponse$1 {
+}
+
+interface ErrorFilter<T = unknown> extends ErrorFilter$1<T, MangoRequest, MangoResponse> {
+}
+
+interface ExecutionContext<TRequest extends MangoRequest = MangoRequest, TResponse extends MangoResponse = MangoResponse> extends ExecutionContext$1<TRequest, TResponse> {
+}
+
+interface Guard extends Guard$1<MangoRequest, MangoResponse> {
+}
+
+interface Interceptor<THandlerResult = unknown> extends Interceptor$1<THandlerResult, MangoRequest, MangoResponse> {
+}
+
+interface ServerEventEmmiter extends EventEmmiter {
+    emitPlayer(player: MultiplayerPlayer, eventName: string, ...args: any[]): void;
+    emitAllPlayersRaw(eventName: string, ...args: any[]): void;
+    emitAllPlayersUnreliableRaw(eventName: string, ...args: any[]): void;
+    emitUnreliableRaw(players: MultiplayerPlayer[], eventName: string, ...args: any[]): void;
+    onPlayer(eventName: string, listener: (...args: any[]) => void): ScriptEventHandler;
+    oncePlayer(eventName: string, listener: (...args: any[]) => void): ScriptEventHandler;
+    offPlayer(eventName: string, listener: (...args: any[]) => void): void;
+}
+
+interface ServerMultiplayerService extends MultiplayerService {
+    Events: ServerEventEmmiter;
+    getPlayer(): any;
+    setBlipFactory(factory: unknown): void;
+    setMarkerFactory(factory: unknown): void;
+    setColShapeFactory(factory: unknown): void;
+    setCheckpointFactory(factory: unknown): void;
+    setObjectFactory(factory: unknown): void;
+    setPedFactory(factory: unknown): void;
+    setPlayerFactory(factory: unknown): void;
+    setVehicleFactory(factory: unknown): void;
+    setVirtualEntityGroupFactory(factory: unknown): void;
+    setVirtualEntityFactory(factory: unknown): void;
+    setVoiceChannelFactory(factory: unknown): void;
+}
+
+interface MultiplayerPlayer {
+    emit(eventName: string, ...args: any[]): void;
+    emitRaw(eventName: string, ...args: any[]): void;
+    emitWebView(webViewId: string | number, eventName: string, ...args: any[]): void;
+    valid: boolean;
+}
+
+interface EventService {
+    on<E extends keyof MangoEvents.CustomServerEvent>(eventName: E, callback: (body: Parameters<MangoEvents.CustomServerEvent[E]>[0]) => void | Promise<void>): ScriptEventHandler;
+    on<E extends string>(eventName: Exclude<E, keyof MangoEvents.CustomServerEvent>, callback: (body: unknown) => void | Promise<void>): ScriptEventHandler;
+    once<E extends keyof MangoEvents.CustomServerEvent>(eventName: E, callback: (body: Parameters<MangoEvents.CustomServerEvent[E]>[0]) => void | Promise<void>): ScriptEventHandler;
+    once<E extends string>(eventName: Exclude<E, keyof MangoEvents.CustomServerEvent>, callback: (body: unknown) => void | Promise<void>): ScriptEventHandler;
+    emit<E extends keyof MangoEvents.CustomServerEvent>(eventName: E, body?: Parameters<MangoEvents.CustomServerEvent[E]>[0]): void;
+    emit<E extends string>(eventName: Exclude<E, keyof MangoEvents.CustomServerEvent>, body?: any): void;
+    onPlayer<E extends keyof MangoEvents.CustomPlayerToServerEvent, U extends PlayerMp>(eventName: E, callback: (player: U, body: Parameters<MangoEvents.CustomPlayerToServerEvent[E]>[0]) => void | Promise<void>): ScriptEventHandler;
+    onPlayer<E extends string, U extends PlayerMp>(eventName: Exclude<E, keyof MangoEvents.CustomPlayerToServerEvent>, callback: (player: U, body: unknown) => void | Promise<void>): ScriptEventHandler;
+    oncePlayer<E extends keyof MangoEvents.CustomPlayerToServerEvent, U extends PlayerMp>(eventName: E, callback: (player: U, body: Parameters<MangoEvents.CustomPlayerToServerEvent[E]>[0]) => void | Promise<void>): ScriptEventHandler;
+    oncePlayer<E extends string, U extends PlayerMp>(eventName: Exclude<E, keyof MangoEvents.CustomPlayerToServerEvent>, callback: (player: U, body: unknown) => void | Promise<void>): ScriptEventHandler;
+    onRemote<E extends keyof MangoEvents.CustomPlayerToServerEvent, U extends PlayerMp>(eventName: E, callback: (player: U, body: Parameters<MangoEvents.CustomPlayerToServerEvent[E]>[0]) => void | Promise<void>): ScriptEventHandler;
+    onRemote<E extends string, U extends PlayerMp>(eventName: Exclude<E, keyof MangoEvents.CustomPlayerToServerEvent>, callback: (player: U, body: unknown) => void | Promise<void>): ScriptEventHandler;
+    onceRemote<E extends keyof MangoEvents.CustomPlayerToServerEvent, U extends PlayerMp>(eventName: E, callback: (player: U, body: Parameters<MangoEvents.CustomPlayerToServerEvent[E]>[0]) => void | Promise<void>): ScriptEventHandler;
+    onceRemote<E extends string, U extends PlayerMp>(eventName: Exclude<E, keyof MangoEvents.CustomPlayerToServerEvent>, callback: (player: U, body: unknown) => void | Promise<void>): ScriptEventHandler;
+    emitPlayers<E extends keyof MangoEvents.CustomServerToPlayerEvent, U extends MultiplayerPlayer>(player: U[], eventName: E, body?: Parameters<MangoEvents.CustomServerToPlayerEvent[E]>[0]): void;
+    emitPlayers<E extends string, U extends MultiplayerPlayer>(player: U[], eventName: Exclude<E, keyof MangoEvents.CustomServerToPlayerEvent>, body?: unknown): void;
+    emitPlayersUnreliable<E extends keyof MangoEvents.CustomServerToPlayerEvent, U extends MultiplayerPlayer>(player: U[], eventName: E, body?: Parameters<MangoEvents.CustomServerToPlayerEvent[E]>[0]): void;
+    emitPlayersUnreliable<E extends string, U extends MultiplayerPlayer>(player: U[], eventName: Exclude<E, keyof MangoEvents.CustomServerToPlayerEvent>, body?: unknown): void;
+    emitAllPlayers<E extends keyof MangoEvents.CustomServerToPlayerEvent>(eventName: E, body?: Parameters<MangoEvents.CustomServerToPlayerEvent[E]>[0]): void;
+    emitAllPlayers<E extends string>(eventName: Exclude<E, keyof MangoEvents.CustomServerToPlayerEvent>, body?: unknown): void;
+    emitAllPlayersUnreliable<E extends keyof MangoEvents.CustomServerToPlayerEvent>(eventName: E, body?: Parameters<MangoEvents.CustomServerToPlayerEvent[E]>[0]): void;
+    emitAllPlayersUnreliable<E extends string>(eventName: Exclude<E, keyof MangoEvents.CustomServerToPlayerEvent>, body?: unknown): void;
+    onWebView<E extends keyof MangoEvents.CustomWebViewToServerEvent, U extends PlayerMp>(id: string | number, eventName: E, callback: (player: U, body: Parameters<MangoEvents.CustomWebViewToServerEvent[E]>[0]) => void | Promise<void>): ScriptEventHandler;
+    onWebView<E extends string, U extends PlayerMp>(id: string | number, eventName: Exclude<E, keyof MangoEvents.CustomWebViewToServerEvent>, callback: (player: U, body: unknown) => void | Promise<void>): ScriptEventHandler;
+    onceWebView<E extends keyof MangoEvents.CustomWebViewToServerEvent, U extends PlayerMp>(id: string | number, eventName: E, callback: (player: U, body: Parameters<MangoEvents.CustomWebViewToServerEvent[E]>[0]) => void | Promise<void>): ScriptEventHandler;
+    onceWebView<E extends string, U extends PlayerMp>(id: string | number, eventName: Exclude<E, keyof MangoEvents.CustomWebViewToServerEvent>, callback: (player: U, body: unknown) => void | Promise<void>): ScriptEventHandler;
+    emitWebViews<E extends keyof MangoEvents.CustomServerToWebViewEvent, U extends MultiplayerPlayer>(player: U[], id: string | number, eventName: E, body?: Parameters<MangoEvents.CustomServerToWebViewEvent[E]>[0]): void;
+    emitWebViews<E extends string, U extends MultiplayerPlayer>(player: U[], id: string | number, eventName: Exclude<E, keyof MangoEvents.CustomServerToWebViewEvent>, body?: unknown): void;
+    emitAllWebViews<E extends keyof MangoEvents.CustomServerToWebViewEvent>(id: string | number, eventName: E, body?: Parameters<MangoEvents.CustomServerToWebViewEvent[E]>[0]): void;
+    emitAllWebViews<E extends string>(id: string | number, eventName: Exclude<E, keyof MangoEvents.CustomServerToWebViewEvent>, body?: unknown): void;
+    emitAllWebViewsUnreliable<E extends keyof MangoEvents.CustomServerToWebViewEvent>(id: string | number, eventName: E, body?: Parameters<MangoEvents.CustomServerToWebViewEvent[E]>[0]): void;
+    emitAllWebViewsUnreliable<E extends string>(id: string | number, eventName: Exclude<E, keyof MangoEvents.CustomServerToWebViewEvent>, body?: unknown): void;
+    onPlayerJoin(callback: (player: PlayerMp) => void): ScriptEventHandler;
+    onPlayerQuit(callback: (player: PlayerMp, exitType: string, reason: string) => void): ScriptEventHandler;
+    onPlayerReady(callback: (player: PlayerMp) => void): ScriptEventHandler;
+    onPlayerDeath(callback: (player: PlayerMp, reason: number, killer?: PlayerMp) => void): ScriptEventHandler;
+    onPlayerSpawn(callback: (player: PlayerMp) => void): ScriptEventHandler;
+    onPlayerChat(callback: (player: PlayerMp, text: string) => void): ScriptEventHandler;
+    onPlayerCommand(callback: (player: PlayerMp, command: string) => void): ScriptEventHandler;
+    onPlayerEnterVehicle(callback: (player: PlayerMp, vehicle: VehicleMp, seat: number) => void): ScriptEventHandler;
+    onPlayerExitVehicle(callback: (player: PlayerMp, vehicle: VehicleMp) => void): ScriptEventHandler;
+    onPlayerStartEnterVehicle(callback: (player: PlayerMp, vehicle: VehicleMp, seat: number) => void): ScriptEventHandler;
+    onPlayerStartExitVehicle(callback: (player: PlayerMp, vehicle: VehicleMp) => void): ScriptEventHandler;
+    onPlayerWeaponChange(callback: (player: PlayerMp, oldWeapon: number, newWeapon: number) => void): ScriptEventHandler;
+    onPlayerDamage(callback: (player: PlayerMp, healthLoss: number, armorLoss: number) => void): ScriptEventHandler;
+    onVehicleDeath(callback: (vehicle: VehicleMp, hash: number, killer?: PlayerMp) => void): ScriptEventHandler;
+    onVehicleDamage(callback: (vehicle: VehicleMp, bodyHealthLoss: number, engineHealthLoss: number) => void): ScriptEventHandler;
+    onPlayerEnterColshape(callback: (player: PlayerMp, colshape: ColshapeMp) => void): ScriptEventHandler;
+    onPlayerExitColshape(callback: (player: PlayerMp, colshape: ColshapeMp) => void): ScriptEventHandler;
+    onPlayerEnterCheckpoint(callback: (player: PlayerMp, checkpoint: CheckpointMp) => void): ScriptEventHandler;
+    onPlayerExitCheckpoint(callback: (player: PlayerMp, checkpoint: CheckpointMp) => void): ScriptEventHandler;
+    onPlayerConnect(callback: (player: PlayerMp) => void): ScriptEventHandler;
+    onPlayerDisconnect(callback: (context: {
+        player: PlayerMp;
+        exitType: string;
+        reason: string;
+    }) => void): ScriptEventHandler;
+}
+
+interface RPCService {
+    call<E extends keyof MangoRPC.CustomServerRPC>(rpcName: E, body?: Parameters<MangoRPC.CustomServerRPC[E]>[0], options?: RPCCallOptions): Promise<RPCResult<ReturnType<MangoRPC.CustomServerRPC[E]>>>;
+    call<E extends string>(rpcName: Exclude<E, keyof MangoRPC.CustomServerRPC>, body?: unknown, options?: RPCCallOptions): Promise<RPCResult<unknown>>;
+    onRequest<E extends keyof MangoRPC.CustomServerRPC>(rpcName: E, handler: (body: Parameters<MangoRPC.CustomServerRPC[E]>[0]) => ReturnType<MangoRPC.CustomServerRPC[E]>): ScriptRPCHandler;
+    onRequest<E extends string>(rpcName: Exclude<E, keyof MangoRPC.CustomServerRPC>, handler: (body: unknown) => unknown | Promise<unknown>): ScriptRPCHandler;
+    callPlayer<E extends keyof MangoRPC.CustomServerToClientRPC, U extends MultiplayerPlayer>(player: U, rpcName: E, body?: Parameters<MangoRPC.CustomServerToClientRPC[E]>[0], options?: RPCCallOptions): Promise<RPCResult<ReturnType<MangoRPC.CustomServerToClientRPC[E]>>>;
+    callPlayer<E extends string, U extends MultiplayerPlayer>(player: U, rpcName: Exclude<E, keyof MangoRPC.CustomServerToClientRPC>, body?: unknown, options?: RPCCallOptions): Promise<RPCResult>;
+    onPlayerRequest<E extends keyof MangoRPC.CustomClientToServerRPC, U extends MultiplayerPlayer>(rpcName: E, handler: (sender: U, body: Parameters<MangoRPC.CustomClientToServerRPC[E]>[0]) => ReturnType<MangoRPC.CustomClientToServerRPC[E]>): ScriptRPCHandler;
+    onPlayerRequest<E extends string, U extends MultiplayerPlayer>(rpcName: Exclude<E, keyof MangoRPC.CustomClientToServerRPC>, handler: (sender: U, body: unknown) => unknown | Promise<unknown>): ScriptRPCHandler;
+    callWebView<E extends keyof MangoRPC.CustomServerToWebViewRPC, U extends MultiplayerPlayer>(player: U, id: string | number, rpcName: E, body?: Parameters<MangoRPC.CustomServerToWebViewRPC[E]>[0], options?: RPCCallOptions): Promise<RPCResult<ReturnType<MangoRPC.CustomServerToWebViewRPC[E]>>>;
+    callWebView<E extends string, U extends MultiplayerPlayer>(player: U, id: string | number, rpcName: Exclude<E, keyof MangoRPC.CustomServerToWebViewRPC>, body?: unknown, options?: RPCCallOptions): Promise<RPCResult>;
+    onWebViewRequest<E extends string, U extends MultiplayerPlayer>(id: string | number, rpcName: Exclude<E, keyof MangoRPC.CustomWebViewToServerRPC>, handler: (player: U, body: unknown) => unknown | Promise<unknown>): ScriptRPCHandler;
+    onWebViewRequest<E extends keyof MangoRPC.CustomWebViewToServerRPC, U extends MultiplayerPlayer>(id: string | number, rpcName: E, handler: (player: U, body: Parameters<MangoRPC.CustomWebViewToServerRPC[E]>[0]) => ReturnType<MangoRPC.CustomWebViewToServerRPC[E]>): ScriptRPCHandler;
+}
+
+declare function UseFilters(...filters: (Newable<ErrorFilter> | ErrorFilter)[]): ClassDecorator & MethodDecorator;
+
+declare function OnScriptRPC(): MethodDecorator;
+declare function OnceScriptRPC(): MethodDecorator;
+declare function OnScriptRPCAnswer(): MethodDecorator;
+declare function OnceScriptRPCAnswer(): MethodDecorator;
+declare function OnServerStarted(): MethodDecorator;
+declare function OnceServerStarted(): MethodDecorator;
+declare function OnConnectionQueueAdd(): MethodDecorator;
+declare function OnceConnectionQueueAdd(): MethodDecorator;
+declare function OnConnectionQueueRemove(): MethodDecorator;
+declare function OnceConnectionQueueRemove(): MethodDecorator;
+declare function OnPlayerConnect(): MethodDecorator;
+declare function OncePlayerConnect(): MethodDecorator;
+declare function OnPlayerConnectDenied(): MethodDecorator;
+declare function OncePlayerConnectDenied(): MethodDecorator;
+declare function OnPlayerDisconnect(): MethodDecorator;
+declare function OncePlayerDisconnect(): MethodDecorator;
+declare function OnPlayerDamage(): MethodDecorator;
+declare function OncePlayerDamage(): MethodDecorator;
+declare function OnPlayerDeath(): MethodDecorator;
+declare function OncePlayerDeath(): MethodDecorator;
+declare function OnPlayerHeal(): MethodDecorator;
+declare function OncePlayerHeal(): MethodDecorator;
+declare function OnPlayerControlRequest(): MethodDecorator;
+declare function OncePlayerControlRequest(): MethodDecorator;
+declare function OnPlayerInteriorChange(): MethodDecorator;
+declare function OncePlayerInteriorChange(): MethodDecorator;
+declare function OnPlayerDimensionChange(): MethodDecorator;
+declare function OncePlayerDimensionChange(): MethodDecorator;
+declare function OnPlayerWeaponChange(): MethodDecorator;
+declare function OncePlayerWeaponChange(): MethodDecorator;
+declare function OnPlayerSyncedSceneRequest(): MethodDecorator;
+declare function OncePlayerSyncedSceneRequest(): MethodDecorator;
+declare function OnPlayerSyncedSceneStart(): MethodDecorator;
+declare function OncePlayerSyncedSceneStart(): MethodDecorator;
+declare function OnPlayerSyncedSceneStop(): MethodDecorator;
+declare function OncePlayerSyncedSceneStop(): MethodDecorator;
+declare function OnPlayerSyncedSceneUpdate(): MethodDecorator;
+declare function OncePlayerSyncedSceneUpdate(): MethodDecorator;
+declare function OnPlayerSpawn(): MethodDecorator;
+declare function OncePlayerSpawn(): MethodDecorator;
+declare function OnPlayerAnimationChange(): MethodDecorator;
+declare function OncePlayerAnimationChange(): MethodDecorator;
+declare function OnPlayerVehicleEntered(): MethodDecorator;
+declare function OncePlayerVehicleEntered(): MethodDecorator;
+declare function OnPlayerStartVehicleEnter(): MethodDecorator;
+declare function OncePlayerStartVehicleEnter(): MethodDecorator;
+declare function OnPlayerVehicleLeft(): MethodDecorator;
+declare function OncePlayerVehicleLeft(): MethodDecorator;
+declare function OnPlayerVehicleSeatChange(): MethodDecorator;
+declare function OncePlayerVehicleSeatChange(): MethodDecorator;
+declare function OnPedHeal(): MethodDecorator;
+declare function OncePedHeal(): MethodDecorator;
+declare function OnPedDeath(): MethodDecorator;
+declare function OncePedDeath(): MethodDecorator;
+declare function OnPedDamage(): MethodDecorator;
+declare function OncePedDamage(): MethodDecorator;
+declare function OnVehicleDestroy(): MethodDecorator;
+declare function OnceVehicleDestroy(): MethodDecorator;
+declare function OnVehicleAttach(): MethodDecorator;
+declare function OnceVehicleAttach(): MethodDecorator;
+declare function OnVehicleDetach(): MethodDecorator;
+declare function OnceVehicleDetach(): MethodDecorator;
+declare function OnVehicleDamage(): MethodDecorator;
+declare function OnceVehicleDamage(): MethodDecorator;
+declare function OnVehicleSirenStateChange(): MethodDecorator;
+declare function OnceVehicleSirenStateChange(): MethodDecorator;
+declare function OnVehicleHornStateChange(): MethodDecorator;
+declare function OnceVehicleHornStateChange(): MethodDecorator;
+declare function OnVoiceConnection(): MethodDecorator;
+declare function OnceVoiceConnection(): MethodDecorator;
+declare function OnClientObjectDelete(): MethodDecorator;
+declare function OnceClientObjectDelete(): MethodDecorator;
+declare function OnClientObjectRequest(): MethodDecorator;
+declare function OnceClientObjectRequest(): MethodDecorator;
+declare function OnBaseObjectCreate(): MethodDecorator;
+declare function OnceBaseObjectCreate(): MethodDecorator;
+declare function OnBaseObjectRemove(): MethodDecorator;
+declare function OnceBaseObjectRemove(): MethodDecorator;
+declare function OnNetOwnerChange(): MethodDecorator;
+declare function OnceNetOwnerChange(): MethodDecorator;
+declare function OnWeaponDamage(): MethodDecorator;
+declare function OnceWeaponDamage(): MethodDecorator;
+declare function OnMetaChange(): MethodDecorator;
+declare function OnceMetaChange(): MethodDecorator;
+declare function OnLocalMetaChange(): MethodDecorator;
+declare function OnceLocalMetaChange(): MethodDecorator;
+declare function OnStreamSyncedMetaChange(): MethodDecorator;
+declare function OnceStreamSyncedMetaChange(): MethodDecorator;
+declare function OnGlobalMetaChange(): MethodDecorator;
+declare function OnceGlobalMetaChange(): MethodDecorator;
+declare function OnGlobalSyncedMetaChange(): MethodDecorator;
+declare function OnceGlobalSyncedMetaChange(): MethodDecorator;
+declare function OnConsoleCommand(): MethodDecorator;
+declare function OnceConsoleCommand(): MethodDecorator;
+declare function OnError(): MethodDecorator;
+declare function OnceError(): MethodDecorator;
+declare function OnColShapeEvent(): MethodDecorator;
+declare function OnceColShapeEvent(): MethodDecorator;
+declare function OnExplosion(): MethodDecorator;
+declare function OnceExplosion(): MethodDecorator;
+declare function OnFireStart(): MethodDecorator;
+declare function OnceFireStart(): MethodDecorator;
+declare function OnProjectileStart(): MethodDecorator;
+declare function OnceProjectileStart(): MethodDecorator;
+declare function OnEntityColShapeEnter(): MethodDecorator;
+declare function OnceEntityColShapeEnter(): MethodDecorator;
+declare function OnEntityColShapeLeave(): MethodDecorator;
+declare function OnceEntityColShapeLeave(): MethodDecorator;
+declare function OnEntityCheckpointEnter(): MethodDecorator;
+declare function OnceEntityCheckpointEnter(): MethodDecorator;
+declare function OnEntityCheckpointLeave(): MethodDecorator;
+declare function OnceEntityCheckpointLeave(): MethodDecorator;
+declare function OnGivePedScriptedTask(): MethodDecorator;
+declare function OnceGivePedScriptedTask(): MethodDecorator;
+declare function OnLocalScriptEvent(): MethodDecorator;
+declare function OnceLocalScriptEvent(): MethodDecorator;
+declare function OnRemoteScriptEvent(): MethodDecorator;
+declare function OnceRemoteScriptEvent(): MethodDecorator;
+declare function OnAnyResourceStart(): MethodDecorator;
+declare function OnceAnyResourceStart(): MethodDecorator;
+declare function OnAnyResourceStop(): MethodDecorator;
+declare function OnceAnyResourceStop(): MethodDecorator;
+declare function OnResourceStart(): MethodDecorator;
+declare function OnceResourceStart(): MethodDecorator;
+declare function OnResourceStop(): MethodDecorator;
+declare function OnceResourceStop(): MethodDecorator;
+declare function OnResourceError(): MethodDecorator;
+declare function OnceResourceError(): MethodDecorator;
+declare function OnEvent(): MethodDecorator;
+declare function OnceEvent(): MethodDecorator;
+
+declare function OnPlayer<E extends keyof MangoEvents.CustomPlayerToServerEvent>(eventName?: E): MethodDecorator;
+declare function OnPlayer<E extends string>(eventName?: Exclude<E, keyof MangoEvents.CustomPlayerToServerEvent>): MethodDecorator;
+
+declare function OnWebView<E extends keyof MangoEvents.CustomWebViewToServerEvent>(id: string | number, eventName?: E): MethodDecorator;
+declare function OnWebView<E extends string>(id: string | number, eventName?: Exclude<E, keyof MangoEvents.CustomWebViewToServerEvent>): MethodDecorator;
+
+declare function On<E extends keyof MangoEvents.CustomServerEvent>(eventName?: E): MethodDecorator;
+declare function On<E extends string>(eventName?: Exclude<E, keyof MangoEvents.CustomServerEvent>): MethodDecorator;
+
+declare function OncePlayer<E extends keyof MangoEvents.CustomPlayerToServerEvent>(eventName?: E): MethodDecorator;
+declare function OncePlayer<E extends string>(eventName?: Exclude<E, keyof MangoEvents.CustomPlayerToServerEvent>): MethodDecorator;
+
+declare function OnceWebView<E extends keyof MangoEvents.CustomWebViewToServerEvent>(id: string | number, eventName?: E): MethodDecorator;
+declare function OnceWebView<E extends string>(id: string | number, eventName?: Exclude<E, keyof MangoEvents.CustomWebViewToServerEvent>): MethodDecorator;
+
+declare function Once<E extends keyof MangoEvents.CustomServerEvent>(eventName?: E): MethodDecorator;
+declare function Once<E extends string>(eventName?: Exclude<E, keyof MangoEvents.CustomServerEvent>): MethodDecorator;
+
+declare function Player(key?: string, ...pipes: Newable<Pipe>[]): ParameterDecorator;
+
+declare function UseGuards(...guards: (Newable<Guard> | Guard)[]): ClassDecorator & MethodDecorator;
+
+declare function UseInterceptors(...interceptors: (Newable<Interceptor> | Interceptor)[]): ClassDecorator & MethodDecorator;
+
+declare function OnPlayerRequest<E extends keyof MangoRPC.CustomClientToServerRPC>(rpcName?: E): MethodDecorator;
+declare function OnPlayerRequest<E extends string>(rpcName?: Exclude<E, keyof MangoRPC.CustomClientToServerRPC>): MethodDecorator;
+
+declare function OnRequest<E extends keyof MangoRPC.CustomServerRPC>(rpcName?: E): MethodDecorator;
+declare function OnRequest<E extends string>(rpcName?: Exclude<E, keyof MangoRPC.CustomServerRPC>): MethodDecorator;
+
+declare function OnWebViewRequest<E extends keyof MangoRPC.CustomWebViewToServerRPC>(id: string | number, rpcName?: E): MethodDecorator;
+declare function OnWebViewRequest<E extends string>(id: string | number, rpcName?: Exclude<E, keyof MangoRPC.CustomWebViewToServerRPC>): MethodDecorator;
+
+declare function SkipThrottle(skip?: Record<string, boolean>): (target: any, _propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<any>) => any;
+
+type Resolvable<T extends number | string | boolean> = T | ((context: ExecutionContext) => T | Promise<T>);
+interface ThrottlerMethodOrControllerOptions {
+    limit?: Resolvable<number>;
+    ttl?: Resolvable<number>;
+}
+
+interface ThrottlerOptions {
+    name?: string;
+    limit: Resolvable<number>;
+    ttl: Resolvable<number>;
+    skipIf?: (context: ExecutionContext) => boolean | Promise<boolean>;
+}
+
+type ThrottlerModuleOptions = Array<ThrottlerOptions> | {
+    skipIf?: (context: ExecutionContext) => boolean | Promise<boolean>;
+    errorMessage?: string;
+    throttlers: Array<ThrottlerOptions>;
+};
+
+interface ThrottlerOptionsFactory {
+    createThrottlerOptions(): Promise<ThrottlerModuleOptions> | ThrottlerModuleOptions;
+}
+
+interface ThrottlerAsyncOptions extends Pick<ModuleOptions, 'imports'> {
+    useExisting?: Newable<ThrottlerOptionsFactory>;
+    useClass?: Newable<ThrottlerOptionsFactory>;
+    useFactory?: (...args: unknown[]) => Promise<ThrottlerModuleOptions> | ThrottlerModuleOptions;
+    inject?: InjectionToken[];
+}
+
+interface ThrottlerStorageRecord {
+    totalHits: number;
+    timeToExpire: number;
+}
+
+interface ThrottlerLimitDetail extends ThrottlerStorageRecord {
+    ttl: number;
+    limit: number;
+    key: string;
+    player: PlayerMp;
+}
+
+interface ThrottlerStorageOptions {
+    totalHits: number;
+    expiresAt: number;
+}
+
+declare function Throttle(options: Record<string, ThrottlerMethodOrControllerOptions>): (target: any, _propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<any>) => any;
+
+declare class ThrottlerStorageService implements OnAppShutdown {
+    readonly storage: WeakMap<PlayerMp, Map<string, ThrottlerStorageOptions>>;
+    private timeoutIds;
+    private getExpirationTime;
+    private setExpirationTime;
+    increment(player: PlayerMp, key: string, ttl: number): Promise<{
+        totalHits: number;
+        timeToExpire: number;
+    }>;
+    onAppShutdown(): void;
+}
+
+declare class ThrottlerGuard implements Guard, OnModuleInit {
+    protected readonly options: ThrottlerModuleOptions;
+    protected readonly storageService: ThrottlerStorageService;
+    protected readonly reflector: ReflectorService;
+    protected throttlers: Array<ThrottlerOptions>;
+    protected commonOptions: Pick<ThrottlerOptions, 'skipIf'>;
+    onModuleInit(): Promise<void>;
+    canActivate(context: ExecutionContext): Promise<boolean>;
+    protected handleRequest(context: ExecutionContext, limit: number, ttl: number, throttler: ThrottlerOptions): Promise<boolean>;
+    protected generateKey(context: ExecutionContext, name: string): string;
+    protected throwThrottlingException(context: ExecutionContext, _throttlerLimitDetail: ThrottlerLimitDetail): Promise<void>;
+    protected getErrorMessage(_context: ExecutionContext): Promise<string>;
+    private resolveValue;
+}
+
+declare class ThrottlerModule {
+    static forRoot(options?: ThrottlerModuleOptions): DynamicModule<ThrottlerModule>;
+    static forRootAsync(options: ThrottlerAsyncOptions): DynamicModule<ThrottlerModule>;
+    private static createAsyncProviders;
+    private static createAsyncOptionsProvider;
+}
+
+// RageMP Mango Framework server type declarations
+
+declare global {
+    interface PlayerMp {
+        emitWebView<E extends keyof MangoEvents.CustomServerToPlayerEvent>(eventName: E, body?: unknown): void;
+        emitWebView<E extends string>(
+            id: string | number,
+            eventName: Exclude<E, keyof MangoEvents.CustomServerToPlayerEvent>,
+            body?: unknown,
+        ): void;
+        callRpc<E extends keyof MangoRPC.CustomServerToPlayerRpcEvent>(eventName: E, body?: unknown): void;
+        callRpc<E extends string>(
+            rpcName: Exclude<E, keyof MangoRPC.CustomServerToPlayerRpcEvent>,
+            body?: unknown,
+            options?: RPCCallOptions,
+        ): Promise<RPCResult>;
+        callWebViewRpc<E extends keyof MangoRPC.CustomServerToWebViewRPC>(
+            id: string | number,
+            rpcName: E,
+            body?: unknown,
+            options?: RPCCallOptions,
+        ): Promise<RPCResult>;
+        callWebViewRpc<E extends string>(
+            id: string | number,
+            rpcName: Exclude<E, keyof MangoRPC.CustomServerToWebViewRPC>,
+            body?: unknown,
+            options?: RPCCallOptions,
+        ): Promise<RPCResult>;
+    }
+
+    namespace MangoRPC {
+        interface CustomServerToPlayerRpcEvent {}
+    }
+}
+
+declare class ServerAppBuilder extends AppBuilder<Guard, Interceptor, ErrorFilter> {
+    setBlipFactory(factory: unknown): void;
+    setMarkerFactory(factory: unknown): void;
+    setColShapeFactory(factory: unknown): void;
+    setCheckpointFactory(factory: unknown): void;
+    setObjectFactory(factory: unknown): void;
+    setPedFactory(factory: unknown): void;
+    setPlayerFactory(factory: unknown): void;
+    setVehicleFactory(factory: unknown): void;
+    setVirtualEntityGroupFactory(factory: unknown): void;
+    setVirtualEntityFactory(factory: unknown): void;
+    setVoiceChannelFactory(factory: unknown): void;
+}
+declare function createAppBuilder(): Promise<ServerAppBuilder>;
+
+export { type ErrorFilter, type EventService, type ExecutionContext, type Guard, type Interceptor, type MangoRequest, type MangoResponse, type MultiplayerPlayer, On, OnAnyResourceStart, OnAnyResourceStop, OnBaseObjectCreate, OnBaseObjectRemove, OnClientObjectDelete, OnClientObjectRequest, OnColShapeEvent, OnConnectionQueueAdd, OnConnectionQueueRemove, OnConsoleCommand, OnEntityCheckpointEnter, OnEntityCheckpointLeave, OnEntityColShapeEnter, OnEntityColShapeLeave, OnError, OnEvent, OnExplosion, OnFireStart, OnGivePedScriptedTask, OnGlobalMetaChange, OnGlobalSyncedMetaChange, OnLocalMetaChange, OnLocalScriptEvent, OnMetaChange, OnNetOwnerChange, OnPedDamage, OnPedDeath, OnPedHeal, OnPlayer, OnPlayerAnimationChange, OnPlayerConnect, OnPlayerConnectDenied, OnPlayerControlRequest, OnPlayerDamage, OnPlayerDeath, OnPlayerDimensionChange, OnPlayerDisconnect, OnPlayerHeal, OnPlayerInteriorChange, OnPlayerRequest, OnPlayerSpawn, OnPlayerStartVehicleEnter, OnPlayerSyncedSceneRequest, OnPlayerSyncedSceneStart, OnPlayerSyncedSceneStop, OnPlayerSyncedSceneUpdate, OnPlayerVehicleEntered, OnPlayerVehicleLeft, OnPlayerVehicleSeatChange, OnPlayerWeaponChange, OnProjectileStart, OnRemoteScriptEvent, OnRequest, OnResourceError, OnResourceStart, OnResourceStop, OnScriptRPC, OnScriptRPCAnswer, OnServerStarted, OnStreamSyncedMetaChange, OnVehicleAttach, OnVehicleDamage, OnVehicleDestroy, OnVehicleDetach, OnVehicleHornStateChange, OnVehicleSirenStateChange, OnVoiceConnection, OnWeaponDamage, OnWebView, OnWebViewRequest, Once, OnceAnyResourceStart, OnceAnyResourceStop, OnceBaseObjectCreate, OnceBaseObjectRemove, OnceClientObjectDelete, OnceClientObjectRequest, OnceColShapeEvent, OnceConnectionQueueAdd, OnceConnectionQueueRemove, OnceConsoleCommand, OnceEntityCheckpointEnter, OnceEntityCheckpointLeave, OnceEntityColShapeEnter, OnceEntityColShapeLeave, OnceError, OnceEvent, OnceExplosion, OnceFireStart, OnceGivePedScriptedTask, OnceGlobalMetaChange, OnceGlobalSyncedMetaChange, OnceLocalMetaChange, OnceLocalScriptEvent, OnceMetaChange, OnceNetOwnerChange, OncePedDamage, OncePedDeath, OncePedHeal, OncePlayer, OncePlayerAnimationChange, OncePlayerConnect, OncePlayerConnectDenied, OncePlayerControlRequest, OncePlayerDamage, OncePlayerDeath, OncePlayerDimensionChange, OncePlayerDisconnect, OncePlayerHeal, OncePlayerInteriorChange, OncePlayerSpawn, OncePlayerStartVehicleEnter, OncePlayerSyncedSceneRequest, OncePlayerSyncedSceneStart, OncePlayerSyncedSceneStop, OncePlayerSyncedSceneUpdate, OncePlayerVehicleEntered, OncePlayerVehicleLeft, OncePlayerVehicleSeatChange, OncePlayerWeaponChange, OnceProjectileStart, OnceRemoteScriptEvent, OnceResourceError, OnceResourceStart, OnceResourceStop, OnceScriptRPC, OnceScriptRPCAnswer, OnceServerStarted, OnceStreamSyncedMetaChange, OnceVehicleAttach, OnceVehicleDamage, OnceVehicleDestroy, OnceVehicleDetach, OnceVehicleHornStateChange, OnceVehicleSirenStateChange, OnceVoiceConnection, OnceWeaponDamage, OnceWebView, Player, type RPCService, type ServerEventEmmiter, type ServerMultiplayerService, SkipThrottle, Throttle, type ThrottlerAsyncOptions, ThrottlerGuard, ThrottlerModule, type ThrottlerModuleOptions, type ThrottlerOptions, type ThrottlerOptionsFactory, UseFilters, UseGuards, UseInterceptors, createAppBuilder };