@cybermp-community/server-types 1.1.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cybermp-community/server-types",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "TypeScript type definitions for the CyberMP server-side environment.",
   "license": "CC BY-SA 4.0",
   "author": {

package/src/entities/entity.ts

@@ -4,16 +4,16 @@ import type { MpPickup } from '../pickups';
 import type { Rotation, Vector3 } from '../shared';
 import type { MpVehicle } from '../vehicles';
 import type { MpPlayer } from './player';
-
-export enum EntityType {
-  Player = 1,
-  Vehicle = 2,
-  Object = 3,
-  Ped = 4,
-  Pickup = 5,
-  GameObject = 6,
-}
-
+
+export enum EntityType {
+  Player = 1,
+  Vehicle = 2,
+  Object = 3,
+  Ped = 4,
+  Pickup = 5,
+  GameObject = 6,
+}
+
 export type MpAnyEntity =
   | MpPlayer
   | MpVehicle
@@ -24,23 +24,23 @@ export type MpAnyEntity =
 
 export interface MpEntity<TEntityType extends EntityType = EntityType> {
   readonly id: number;
-  readonly owner: MpPlayer;
   readonly firstOwner: MpPlayer;
   readonly position: Vector3;
   readonly rotation: Rotation;
   readonly yaw: number;
   readonly type: TEntityType;
   readonly exist: boolean;
-
+  
+  owner: MpPlayer;
   dimension: number;
-  streamingRadius: number;
-
-  getMeta<T = any>(key: string): T;
-  setMeta(key: string, value: any, sync?: boolean): void;
-}
-
-export interface MpEntities<T extends MpEntity = MpEntity> {
-  exists(entity: T | number): boolean;
-
-  at(entity: T | number): T;
+  streamingRadius: number;
+
+  getMeta<T = any>(key: string): T;
+  setMeta(key: string, value: any, sync?: boolean): void;
+}
+
+export interface MpEntities<T extends MpEntity = MpEntity> {
+  exists(entity: T | number): boolean;
+
+  at(entity: T | number): T;
 }

package/src/events/map.ts

@@ -1,6 +1,6 @@
-import type { VehicleSeat } from '../vehicles';
-import type { EntityType } from '../entities';
-import type { GameHash, Vector3Object } from '../shared';
+import type { VehicleSeat } from "../vehicles";
+import type { EntityType, MpAnyEntity, MpPlayer } from "../entities";
+import type { GameHash, Vector3Object } from "../shared";
 import type {
   DamageEventData,
   DoorStateChangeEventData,
@@ -19,7 +19,7 @@ import type {
   VehicleDestructionChangeEventData,
   VehicleHittedByPlayerEventData,
   VehicleWeaponShootEventData,
-} from './types';
+} from "./types";
 
 export interface MpEventsMap {
   anyResourceStart(resourceName: string): void;
@@ -44,11 +44,38 @@ export interface MpEventsMap {
   playerHealing(playerId: number): undefined | boolean;
   playerKnockdown(playerId: number): undefined | boolean;
 
+  globalMetaChange<T = any, K = T>(
+    key: string,
+    newValue: T,
+    oldValue: K,
+  ): undefined | boolean;
+  playerMetaChange<T = any, K = T>(
+    player: MpPlayer,
+    key: string,
+    newValue: T,
+    oldValue: K,
+  ): undefined | boolean;
+  entityMetaChange<T = any, K = T>(
+    entity: MpAnyEntity,
+    key: string,
+    newValue: T,
+    oldValue: K,
+  ): undefined | boolean;
+
   damage(playerId: number, data: DamageEventData): undefined | boolean;
-  meleeAction(playerId: number, data: MeleeActionEventData): undefined | boolean;
-  shootAction(playerId: number, data: ShootActionEventData): undefined | boolean;
+  meleeAction(
+    playerId: number,
+    data: MeleeActionEventData,
+  ): undefined | boolean;
+  shootAction(
+    playerId: number,
+    data: ShootActionEventData,
+  ): undefined | boolean;
   weaponReload(playerId: number, weaponHash: GameHash): undefined | boolean;
-  throwGrenade(playerId: number, data: ThrowGrenadeEventData): undefined | boolean;
+  throwGrenade(
+    playerId: number,
+    data: ThrowGrenadeEventData,
+  ): undefined | boolean;
 
   fire(playerId: number, data: FireEventData): undefined | boolean;
   explosion(playerId: number, data: ExplosionEventData): undefined | boolean;
@@ -92,11 +119,20 @@ export interface MpEventsMap {
   exitVehicle(id: number): void;
   enterVehicle(id: number, seat: VehicleSeat): void;
 
-  pickupChange(playerId: number, data: PickupChangeEventData): undefined | boolean;
-  pickupRaise(playerId: number, data: PickupDespawnEventData): undefined | boolean;
-  pickupDrop(playerId: number, data: PickupCreateEventData): undefined | boolean;
+  pickupChange(
+    playerId: number,
+    data: PickupChangeEventData,
+  ): undefined | boolean;
+  pickupRaise(
+    playerId: number,
+    data: PickupDespawnEventData,
+  ): undefined | boolean;
+  pickupDrop(
+    playerId: number,
+    data: PickupCreateEventData,
+  ): undefined | boolean;
   pickupSpawn(id: number): void;
   pickupDespawn(id: number): void;
 }
 
-export type { MeleeActionType } from './types';
+export type { MeleeActionType } from "./types";

package/src/exports.ts

@@ -1,5 +1,12 @@
-export interface MpExports {
-    [module: string]: {
-        [name: string]: (...args: unknown[]) => unknown;
-    };
-}
+export type MpExports = MpExternalExports & MpCreateExport;
+
+interface MpExternalExports {
+  [module: string]: {
+    [name: string]: <T extends unknown[] = unknown[], R = unknown>(...args: T) => R | Promise<R>;
+  };
+}
+
+type MpCreateExport = <T extends unknown[] = unknown[], R = unknown>(
+  name: string,
+  callback: (...args: T) => R | Promise<R>,
+) => void;