@ragemp-mango/client 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/guard.interface-DzGLAoda.d.ts

@@ -0,0 +1,15 @@
+import { MangoRequest as MangoRequest$1, MangoResponse as MangoResponse$1, ExecutionContext as ExecutionContext$1, Guard as Guard$1 } from '@ragemp-mango/core/app';
+
+interface MangoRequest<TData = unknown> extends MangoRequest$1<TData> {
+}
+
+interface MangoResponse extends MangoResponse$1 {
+}
+
+interface ExecutionContext<TRequest extends MangoRequest = MangoRequest, TResponse extends MangoResponse = MangoResponse> extends ExecutionContext$1<TRequest, TResponse> {
+}
+
+interface Guard extends Guard$1<MangoRequest, MangoResponse> {
+}
+
+export type { ExecutionContext as E, Guard as G, MangoRequest as M, MangoResponse as a };

package/dist/index.d.ts

@@ -0,0 +1,327 @@
+import { ErrorFilter as ErrorFilter$1, Interceptor as Interceptor$1, ScriptEventHandler, EventEmmiter, MultiplayerService, AppBuilder } from '@ragemp-mango/core/app';
+import { M as MangoRequest, a as MangoResponse, G as Guard } from './guard.interface-DzGLAoda.js';
+export { E as ExecutionContext } from './guard.interface-DzGLAoda.js';
+import { RPCCallOptions, RPCResult, ScriptRPCHandler, Newable } 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 { GuardCancelError, GuardInvalidReturnError, MangoError, TooManyRequests, UnknownError } from '@ragemp-mango/core/errors';
+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 ErrorFilter<T = unknown> extends ErrorFilter$1<T, MangoRequest, MangoResponse> {
+}
+
+interface Interceptor<THandlerResult = unknown> extends Interceptor$1<THandlerResult, MangoRequest, MangoResponse> {
+}
+
+interface EventService {
+    on<E extends keyof MangoEvents.CustomClientEvent>(eventName: E, callback: (body: Parameters<MangoEvents.CustomClientEvent[E]>[0]) => void | Promise<void>): ScriptEventHandler;
+    on<E extends string>(eventName: Exclude<E, keyof MangoEvents.CustomClientEvent>, callback: (body: unknown) => void | Promise<void>): ScriptEventHandler;
+    once<E extends keyof MangoEvents.CustomClientEvent>(eventName: E, callback: (body: Parameters<MangoEvents.CustomClientEvent[E]>[0]) => void | Promise<void>): ScriptEventHandler;
+    once<E extends string>(eventName: Exclude<E, keyof MangoEvents.CustomClientEvent>, callback: (body: unknown) => void | Promise<void>): ScriptEventHandler;
+    emit<E extends keyof MangoEvents.CustomClientEvent>(eventName: E, body?: Parameters<MangoEvents.CustomClientEvent[E]>[0]): void;
+    emit<E extends string>(eventName: Exclude<E, keyof MangoEvents.CustomClientEvent>, body?: unknown): void;
+    onServer<E extends keyof MangoEvents.CustomServerToPlayerEvent>(eventName: E, callback: (body: Parameters<MangoEvents.CustomServerToPlayerEvent[E]>[0]) => void | Promise<void>): ScriptEventHandler;
+    onServer<E extends string>(eventName: Exclude<E, keyof MangoEvents.CustomServerToPlayerEvent>, callback: (body: unknown) => void | Promise<void>): ScriptEventHandler;
+    onceServer<E extends keyof MangoEvents.CustomServerToPlayerEvent>(eventName: E, callback: (body: Parameters<MangoEvents.CustomServerToPlayerEvent[E]>[0]) => void | Promise<void>): ScriptEventHandler;
+    onceServer<E extends string>(eventName: Exclude<E, keyof MangoEvents.CustomServerToPlayerEvent>, callback: (body: unknown) => void | Promise<void>): ScriptEventHandler;
+    emitServer<E extends keyof MangoEvents.CustomPlayerToServerEvent>(eventName: E, body?: Parameters<MangoEvents.CustomPlayerToServerEvent[E]>[0]): void;
+    emitServer<E extends string>(eventName: Exclude<E, keyof MangoEvents.CustomPlayerToServerEvent>, body?: unknown): void;
+    onWebView<E extends keyof MangoEvents.CustomWebViewToClientEvent>(id: string | number, eventName: E, callback: (body: Parameters<MangoEvents.CustomWebViewToClientEvent[E]>[0]) => void | Promise<void>): ScriptEventHandler;
+    onWebView<E extends string>(id: string | number, eventName: Exclude<E, keyof MangoEvents.CustomWebViewToClientEvent>, callback: (body: unknown) => void | Promise<void>): ScriptEventHandler;
+    onceWebView<E extends keyof MangoEvents.CustomWebViewToClientEvent>(id: string | number, eventName: E, callback: (body: Parameters<MangoEvents.CustomWebViewToClientEvent[E]>[0]) => void | Promise<void>): ScriptEventHandler;
+    onceWebView<E extends string>(id: string | number, eventName: Exclude<E, keyof MangoEvents.CustomWebViewToClientEvent>, callback: (body: unknown) => void | Promise<void>): ScriptEventHandler;
+    emitWebView<E extends keyof MangoEvents.CustomClientToWebViewEvent>(id: string | number, eventName: E, body?: Parameters<MangoEvents.CustomClientToWebViewEvent[E]>[0]): void;
+    emitWebView<E extends string>(id: string | number, eventName: Exclude<E, keyof MangoEvents.CustomClientToWebViewEvent>, body?: unknown): void;
+    onRender(callback: () => void): ScriptEventHandler;
+    onBrowserDomReady(callback: (browser: BrowserMp) => void): ScriptEventHandler;
+    onBrowserLoadingFailed(callback: (browser: BrowserMp) => void): ScriptEventHandler;
+    onPlayerChat(callback: (text: string) => void): ScriptEventHandler;
+    onPlayerCommand(callback: (command: string) => void): ScriptEventHandler;
+    onPlayerDeath(callback: (killer?: PlayerMp, reason?: number) => void): ScriptEventHandler;
+    onPlayerSpawn(callback: () => void): ScriptEventHandler;
+    onPlayerEnterVehicle(callback: (vehicle: VehicleMp, seat: number) => void): ScriptEventHandler;
+    onPlayerExitVehicle(callback: (vehicle: VehicleMp) => void): ScriptEventHandler;
+    onPlayerEnterColshape(callback: (colshape: ColshapeMp) => void): ScriptEventHandler;
+    onPlayerExitColshape(callback: (colshape: ColshapeMp) => void): ScriptEventHandler;
+    onPlayerEnterCheckpoint(callback: (checkpoint: CheckpointMp) => void): ScriptEventHandler;
+    onPlayerExitCheckpoint(callback: (checkpoint: CheckpointMp) => void): ScriptEventHandler;
+}
+
+interface RPCService {
+    call<E extends keyof MangoRPC.CustomClientRPC>(rpcName: E, body?: Parameters<MangoRPC.CustomClientRPC[E]>[0], options?: RPCCallOptions): Promise<RPCResult<ReturnType<MangoRPC.CustomClientRPC[E]>>>;
+    call<E extends string>(rpcName: Exclude<E, keyof MangoRPC.CustomClientRPC>, body?: unknown, options?: RPCCallOptions): Promise<RPCResult<unknown>>;
+    onRequest<E extends keyof MangoRPC.CustomClientRPC>(rpcName: E, handler: (body: Parameters<MangoRPC.CustomClientRPC[E]>[0]) => ReturnType<MangoRPC.CustomClientRPC[E]>): ScriptRPCHandler;
+    onRequest<E extends string>(rpcName: Exclude<E, keyof MangoRPC.CustomClientRPC>, handler: (body: unknown) => unknown | Promise<unknown>): ScriptRPCHandler;
+    callServer<E extends keyof MangoRPC.CustomClientToServerRPC>(rpcName: E, body?: Parameters<MangoRPC.CustomClientToServerRPC[E]>[0], options?: RPCCallOptions): Promise<RPCResult<ReturnType<MangoRPC.CustomClientToServerRPC[E]>>>;
+    callServer<E extends string>(rpcName: Exclude<E, keyof MangoRPC.CustomClientToServerRPC>, body?: unknown, options?: RPCCallOptions): Promise<RPCResult>;
+    onServerRequest<E extends keyof MangoRPC.CustomServerToClientRPC>(rpcName: E, handler: (body: Parameters<MangoRPC.CustomServerToClientRPC[E]>[0]) => ReturnType<MangoRPC.CustomServerToClientRPC[E]>): ScriptRPCHandler;
+    onServerRequest<E extends string>(rpcName: Exclude<E, keyof MangoRPC.CustomServerToClientRPC>, handler: (body: unknown) => unknown | Promise<unknown>): ScriptRPCHandler;
+    callWebView<E extends keyof MangoRPC.CustomClientToWebviewRPC>(id: string | number, rpcName: E, body?: Parameters<MangoRPC.CustomClientToWebviewRPC[E]>[0], options?: RPCCallOptions): Promise<RPCResult<ReturnType<MangoRPC.CustomClientToWebviewRPC[E]>>>;
+    callWebView<E extends string>(id: string | number, rpcName: Exclude<E, keyof MangoRPC.CustomClientToWebviewRPC>, body?: unknown, options?: RPCCallOptions): Promise<RPCResult>;
+    onWebViewRequest<E extends keyof MangoRPC.CustomWebViewToClientRPC>(id: string | number, rpcName: E, handler: (body: Parameters<MangoRPC.CustomWebViewToClientRPC[E]>[0]) => ReturnType<MangoRPC.CustomWebViewToClientRPC[E]>): ScriptRPCHandler;
+    onWebViewRequest<E extends string>(id: string | number, rpcName: Exclude<E, keyof MangoRPC.CustomWebViewToClientRPC>, handler: (body: unknown) => unknown | Promise<unknown>): ScriptRPCHandler;
+}
+
+interface ClientEventEmmiter extends EventEmmiter {
+    emitServer(eventName: string, ...args: any[]): void;
+    onServer(eventName: string, listener: (...args: any[]) => void): ScriptEventHandler;
+    onceServer(eventName: string, listener: (...args: any[]) => void): ScriptEventHandler;
+    offServer(eventName: string, listener: (...args: any[]) => void): void;
+}
+
+interface MultiplayerWebViewCreateOptionsOverlay {
+    url: string;
+    visible?: boolean;
+    overlay?: boolean;
+}
+interface MultiplayerWebViewCreateOptionsDrawable {
+    url: string;
+    drawable: number | string;
+    targetTexture: string;
+}
+interface MultiplayerWebView {
+    readonly valid: boolean;
+    url: string;
+    destroy(): void;
+    reload(ignoreCache: boolean): void;
+    emit(eventName: string, ...args: unknown[]): void;
+    on(eventName: string, listener: (...args: unknown[]) => void): void;
+    once(eventName: string, listener: (...args: unknown[]) => void): void;
+    off(eventName: string, listener: (...args: unknown[]) => void): void;
+}
+interface MultiplayerWebViewManager {
+    create(options: MultiplayerWebViewCreateOptionsDrawable): MultiplayerWebView;
+    create(options: MultiplayerWebViewCreateOptionsOverlay): MultiplayerWebView;
+    getByID(id: number): MultiplayerWebView | null;
+}
+
+interface ClientMultiplayerService extends MultiplayerService {
+    Events: ClientEventEmmiter;
+    WebView: MultiplayerWebViewManager;
+    setAudioFactory(factory: unknown): void;
+    setAudioFilterFactory(factory: unknown): void;
+    setAudioOutputAttachedFactory(factory: unknown): void;
+    setAudioOutputFrontendFactory(factory: unknown): void;
+    setAudioOutputWorldFactory(factory: unknown): void;
+    setBlipFactory(factory: unknown): void;
+    setMarkerFactory(factory: unknown): void;
+    setColshapeFactory(factory: unknown): void;
+    setCheckpointFactory(factory: unknown): void;
+    setObjectFactory(factory: unknown): void;
+    setLocalObjectFactory(factory: unknown): void;
+    setPedFactory(factory: unknown): void;
+    setLocalPedFactory(factory: unknown): void;
+    setLocalPlayerFactory(factory: unknown): void;
+    setLocalVehicleFactory(factory: unknown): void;
+    setPlayerFactory(factory: unknown): void;
+    setRmlDocumentFactory(factory: unknown): void;
+    setTextLabelFactory(factory: unknown): void;
+    setVehicleFactory(factory: unknown): void;
+    setVirtualEntityGroupFactory(factory: unknown): void;
+    setVirtualEntityFactory(factory: unknown): void;
+    setWebSocketClientFactory(factory: unknown): void;
+    setWebViewFactory(factory: unknown): void;
+}
+
+interface WebViewService {
+    create(id: string | number, options: MultiplayerWebViewCreateOptionsOverlay): MultiplayerWebView;
+    create(id: string | number, options: MultiplayerWebViewCreateOptionsDrawable): MultiplayerWebView;
+    get(id: string | number): MultiplayerWebView | undefined;
+    tryGet(id: string | number): MultiplayerWebView;
+    destroy(id: string | number): void;
+}
+
+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 OnKeyBoardEvent(): MethodDecorator;
+declare function OnceKeyBoardEvent(): MethodDecorator;
+declare function OnKeyUp(): MethodDecorator;
+declare function OnceKeyUp(): MethodDecorator;
+declare function OnKeyDown(): MethodDecorator;
+declare function OnceKeyDown(): MethodDecorator;
+declare function OnWebViewEvent(): MethodDecorator;
+declare function OnceWebViewEvent(): MethodDecorator;
+declare function OnWebSocketEvent(): MethodDecorator;
+declare function OnceWebSocketEvent(): MethodDecorator;
+declare function OnAudioEvent(): MethodDecorator;
+declare function OnceAudioEvent(): MethodDecorator;
+declare function OnRmluiEvent(): MethodDecorator;
+declare function OnceRmluiEvent(): MethodDecorator;
+declare function OnWindowFocusChange(): MethodDecorator;
+declare function OnceWindowFocusChange(): MethodDecorator;
+declare function OnWindowResolutionChange(): MethodDecorator;
+declare function OnceWindowResolutionChange(): MethodDecorator;
+declare function OnConnectionComplete(): MethodDecorator;
+declare function OnceConnectionComplete(): MethodDecorator;
+declare function OnDisconnect(): MethodDecorator;
+declare function OnceDisconnect(): MethodDecorator;
+declare function OnSpawned(): MethodDecorator;
+declare function OnceSpawned(): MethodDecorator;
+declare function OnGameEntityCreate(): MethodDecorator;
+declare function OnceGameEntityCreate(): MethodDecorator;
+declare function OnGameEntityDestroy(): MethodDecorator;
+declare function OnceGameEntityDestroy(): MethodDecorator;
+declare function OnEntityHitEntity(): MethodDecorator;
+declare function OnceEntityHitEntity(): MethodDecorator;
+declare function OnTaskChange(): MethodDecorator;
+declare function OnceTaskChange(): MethodDecorator;
+declare function OnPlayerWeaponShoot(): MethodDecorator;
+declare function OncePlayerWeaponShoot(): MethodDecorator;
+declare function OnPlayerBulletHit(): MethodDecorator;
+declare function OncePlayerBulletHit(): MethodDecorator;
+declare function OnPlayerWeaponChange(): MethodDecorator;
+declare function OncePlayerWeaponChange(): MethodDecorator;
+declare function OnPlayerStartVehicleEnter(): MethodDecorator;
+declare function OncePlayerStartVehicleEnter(): MethodDecorator;
+declare function OnPlayerStartVehicleLeave(): MethodDecorator;
+declare function OncePlayerStartVehicleLeave(): MethodDecorator;
+declare function OnPlayerVehicleEntered(): MethodDecorator;
+declare function OncePlayerVehicleEntered(): MethodDecorator;
+declare function OnPlayerVehicleLeft(): MethodDecorator;
+declare function OncePlayerVehicleLeft(): MethodDecorator;
+declare function OnPlayerVehicleSeatChange(): MethodDecorator;
+declare function OncePlayerVehicleSeatChange(): MethodDecorator;
+declare function OnVoiceConnection(): MethodDecorator;
+declare function OnceVoiceConnection(): MethodDecorator;
+declare function OnPlayerStartTalking(): MethodDecorator;
+declare function OncePlayerStartTalking(): MethodDecorator;
+declare function OnPlayerStopTalking(): MethodDecorator;
+declare function OncePlayerStopTalking(): MethodDecorator;
+declare function OnWorldObjectPositionChange(): MethodDecorator;
+declare function OnceWorldObjectPositionChange(): MethodDecorator;
+declare function OnWorldObjectStreamIn(): MethodDecorator;
+declare function OnceWorldObjectStreamIn(): MethodDecorator;
+declare function OnWorldObjectStreamOut(): MethodDecorator;
+declare function OnceWorldObjectStreamOut(): MethodDecorator;
+declare function OnEvent(): MethodDecorator;
+declare function OnceEvent(): 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 OnSyncedMetaChange(): MethodDecorator;
+declare function OnceSyncedMetaChange(): 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 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 OnColShapeEvent(): MethodDecorator;
+declare function OnceColShapeEvent(): MethodDecorator;
+declare function OnConsoleCommand(): MethodDecorator;
+declare function OnceConsoleCommand(): MethodDecorator;
+declare function OnError(): MethodDecorator;
+declare function OnceError(): MethodDecorator;
+declare function OnLocalScriptEvent(): MethodDecorator;
+declare function OnceLocalScriptEvent(): MethodDecorator;
+declare function OnRemoteScriptEvent(): MethodDecorator;
+declare function OnceRemoteScriptEvent(): 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 OnServer<E extends keyof MangoEvents.CustomServerToPlayerEvent>(eventName?: E): MethodDecorator;
+declare function OnServer<E extends string>(eventName?: Exclude<E, keyof MangoEvents.CustomServerToPlayerEvent>): MethodDecorator;
+
+declare function OnWebView<E extends keyof MangoEvents.CustomWebViewToClientEvent>(id: string | number, eventName?: E): MethodDecorator;
+declare function OnWebView<E extends string>(id: string | number, eventName?: Exclude<E, keyof MangoEvents.CustomWebViewToClientEvent>): MethodDecorator;
+
+declare function On<E extends keyof MangoEvents.CustomClientEvent>(eventName?: E): MethodDecorator;
+declare function On<E extends string>(eventName?: Exclude<E, keyof MangoEvents.CustomClientEvent>): MethodDecorator;
+
+declare function OnceServer<E extends keyof MangoEvents.CustomServerToPlayerEvent>(eventName?: E): MethodDecorator;
+declare function OnceServer<E extends string>(eventName?: Exclude<E, keyof MangoEvents.CustomServerToPlayerEvent>): MethodDecorator;
+
+declare function OnceWebView<E extends keyof MangoEvents.CustomWebViewToClientEvent>(id: string | number, eventName?: E): MethodDecorator;
+declare function OnceWebView<E extends string>(id: string | number, eventName?: Exclude<E, keyof MangoEvents.CustomWebViewToClientEvent>): MethodDecorator;
+
+declare function Once<E extends keyof MangoEvents.CustomClientEvent>(eventName?: E): MethodDecorator;
+declare function Once<E extends string>(eventName?: Exclude<E, keyof MangoEvents.CustomClientEvent>): MethodDecorator;
+
+declare function UseGuards(...guards: (Newable<Guard> | Guard)[]): ClassDecorator & MethodDecorator;
+
+declare function UseInterceptors(...interceptors: (Newable<Interceptor> | Interceptor)[]): ClassDecorator & MethodDecorator;
+
+declare function OnRequest<E extends keyof MangoRPC.CustomClientRPC>(rpcName?: E): MethodDecorator;
+declare function OnRequest<E extends string>(rpcName?: Exclude<E, keyof MangoRPC.CustomClientRPC>): MethodDecorator;
+
+declare function OnServerRequest<E extends keyof MangoRPC.CustomServerToClientRPC>(rpcName?: E): MethodDecorator;
+declare function OnServerRequest<E extends string>(rpcName?: Exclude<E, keyof MangoRPC.CustomServerToClientRPC>): MethodDecorator;
+
+declare function OnWebViewRequest<E extends keyof MangoRPC.CustomWebViewToClientRPC>(id: string | number, rpcName?: E): MethodDecorator;
+declare function OnWebViewRequest<E extends string>(id: string | number, rpcName?: Exclude<E, keyof MangoRPC.CustomWebViewToClientRPC>): MethodDecorator;
+
+declare const WEBVIEW_SERVICE = "WEBVIEW_SERVICE";
+
+// RageMP Client type extensions
+// These are empty placeholders - extend MangoEvents and MangoRPC namespaces in your project
+
+declare global {
+    namespace MangoEvents {
+        // Extend these in your project
+    }
+
+    namespace MangoRPC {
+        // Extend these in your project
+    }
+}
+
+declare class ClientAppBuilder extends AppBuilder<Guard, Interceptor, ErrorFilter> {
+    addWebView(id: string | number, options: MultiplayerWebViewCreateOptionsDrawable): ClientAppBuilder;
+    addWebView(id: string | number, options: MultiplayerWebViewCreateOptionsOverlay): ClientAppBuilder;
+    setAudioFactory(factory: unknown): void;
+    setAudioFilterFactory(factory: unknown): void;
+    setAudioOutputAttachedFactory(factory: unknown): void;
+    setAudioOutputFrontendFactory(factory: unknown): void;
+    setAudioOutputWorldFactory(factory: unknown): void;
+    setBlipFactory(factory: unknown): void;
+    setMarkerFactory(factory: unknown): void;
+    setColShapeFactory(factory: unknown): void;
+    setCheckpointFactory(factory: unknown): void;
+    setObjectFactory(factory: unknown): void;
+    setLocalObjectFactory(factory: unknown): void;
+    setPedFactory(factory: unknown): void;
+    setLocalPedFactory(factory: unknown): void;
+    setLocalPlayerFactory(factory: unknown): void;
+    setLocalVehicleFactory(factory: unknown): void;
+    setPlayerFactory(factory: unknown): void;
+    setRmlDocumentFactory(factory: unknown): void;
+    setTextLabelFactory(factory: unknown): void;
+    setVehicleFactory(factory: unknown): void;
+    setVirtualEntityGroupFactory(factory: unknown): void;
+    setVirtualEntityFactory(factory: unknown): void;
+    setWebSocketClientFactory(factory: unknown): void;
+    setWebViewFactory(factory: unknown): void;
+}
+declare function createAppBuilder(): Promise<ClientAppBuilder>;
+
+export { type ClientEventEmmiter, type ClientMultiplayerService, type ErrorFilter, type EventService, Guard, type Interceptor, MangoRequest, MangoResponse, type MultiplayerWebView, type MultiplayerWebViewCreateOptionsDrawable, type MultiplayerWebViewCreateOptionsOverlay, type MultiplayerWebViewManager, On, OnAudioEvent, OnBaseObjectCreate, OnBaseObjectRemove, OnColShapeEvent, OnConnectionComplete, OnConsoleCommand, OnDisconnect, OnEntityCheckpointEnter, OnEntityCheckpointLeave, OnEntityColShapeEnter, OnEntityColShapeLeave, OnEntityHitEntity, OnError, OnEvent, OnGameEntityCreate, OnGameEntityDestroy, OnGlobalMetaChange, OnGlobalSyncedMetaChange, OnKeyBoardEvent, OnKeyDown, OnKeyUp, OnLocalMetaChange, OnLocalScriptEvent, OnMetaChange, OnNetOwnerChange, OnPlayerBulletHit, OnPlayerStartTalking, OnPlayerStartVehicleEnter, OnPlayerStartVehicleLeave, OnPlayerStopTalking, OnPlayerVehicleEntered, OnPlayerVehicleLeft, OnPlayerVehicleSeatChange, OnPlayerWeaponChange, OnPlayerWeaponShoot, OnRemoteScriptEvent, OnRequest, OnResourceError, OnResourceStart, OnResourceStop, OnRmluiEvent, OnScriptRPC, OnScriptRPCAnswer, OnServer, OnServerRequest, OnSpawned, OnStreamSyncedMetaChange, OnSyncedMetaChange, OnTaskChange, OnVoiceConnection, OnWeaponDamage, OnWebSocketEvent, OnWebView, OnWebViewEvent, OnWebViewRequest, OnWindowFocusChange, OnWindowResolutionChange, OnWorldObjectPositionChange, OnWorldObjectStreamIn, OnWorldObjectStreamOut, Once, OnceAudioEvent, OnceBaseObjectCreate, OnceBaseObjectRemove, OnceColShapeEvent, OnceConnectionComplete, OnceConsoleCommand, OnceDisconnect, OnceEntityCheckpointEnter, OnceEntityCheckpointLeave, OnceEntityColShapeEnter, OnceEntityColShapeLeave, OnceEntityHitEntity, OnceError, OnceEvent, OnceGameEntityCreate, OnceGameEntityDestroy, OnceGlobalMetaChange, OnceGlobalSyncedMetaChange, OnceKeyBoardEvent, OnceKeyDown, OnceKeyUp, OnceLocalMetaChange, OnceLocalScriptEvent, OnceMetaChange, OnceNetOwnerChange, OncePlayerBulletHit, OncePlayerStartTalking, OncePlayerStartVehicleEnter, OncePlayerStartVehicleLeave, OncePlayerStopTalking, OncePlayerVehicleEntered, OncePlayerVehicleLeft, OncePlayerVehicleSeatChange, OncePlayerWeaponChange, OncePlayerWeaponShoot, OnceRemoteScriptEvent, OnceResourceError, OnceResourceStart, OnceResourceStop, OnceRmluiEvent, OnceScriptRPC, OnceScriptRPCAnswer, OnceServer, OnceSpawned, OnceStreamSyncedMetaChange, OnceSyncedMetaChange, OnceTaskChange, OnceVoiceConnection, OnceWeaponDamage, OnceWebSocketEvent, OnceWebView, OnceWebViewEvent, OnceWindowFocusChange, OnceWindowResolutionChange, OnceWorldObjectPositionChange, OnceWorldObjectStreamIn, OnceWorldObjectStreamOut, type RPCService, UseFilters, UseGuards, UseInterceptors, WEBVIEW_SERVICE, type WebViewService, createAppBuilder };