@pma-network/fivem-server 0.0.11

package/PMA.d.ts

@@ -0,0 +1,42 @@
+import type { ItemName } from "@pma-network/fivem-types/Inventory";
+import type { PlayerUID } from "./shared-server/types/SharedTypes";
+import { PMAPlayerWrapper } from "./class/PMAPlayer";
+import type { UsableItemCall } from "./types/Inventory";
+/**
+ * A static class that's used for invoking framework types
+ */
+export declare class PMA {
+    /**
+     * @returns the item data for {@param item_name}, or `null` if the item doesn't exist
+     */
+    static get_item(item_name: ItemName): Readonly<unknown | null>;
+    /**
+     * Registers the {@param item_name} to be used as a usable item
+     * @throws this will throw an error if {@param item_name} isn't usable
+     */
+    static register_usable_item(item_name: ItemName, fn: UsableItemCall, consume_amount: number): void;
+    /**
+     * Gets the player from the specified source
+     * @note the PMAPlayer is lazy initialized so we don't do un-needed scrt
+     * calls, this means that we *can* possibly end up in a state where the player
+     * isn't initialized, this won't break anything though.
+     * @returns the PMAPlayer wrapper, or `null` if the player doesn't exist
+     */
+    static from_source(source: number): PMAPlayerWrapper | null;
+    /**
+     * Gets the player from the specified UID
+     * @returns the PMAPlayer wrapper, or `null` if there wasn't a player
+     */
+    static from_uid(uid: PlayerUID): PMAPlayerWrapper | null;
+    /**
+     * Gets all of the players that habe the specified job(s), and the specified {@param job_rank} if specified.
+     */
+    static get_players_with_job(job_names: string | string[], job_rank?: number): PMAPlayerWrapper[];
+    /**
+     * Generic logging
+     * TODO: Setup a clickhouse wrapper
+     */
+    static log(log_message: string, additional_data?: {
+        [key: string]: any;
+    }): void;
+}

package/PMA.js

@@ -0,0 +1,61 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { Ped, randomInt } from "@nativewrappers/server";
+import { PMAPlayerWrapper } from "./class/PMAPlayer";
+class PMA {
+  static {
+    __name(this, "PMA");
+  }
+  /**
+   * @returns the item data for {@param item_name}, or `null` if the item doesn't exist
+   */
+  static get_item(item_name) {
+    return exports["pma-framework"].get_item(item_name);
+  }
+  /**
+   * Registers the {@param item_name} to be used as a usable item
+   * @throws this will throw an error if {@param item_name} isn't usable
+   */
+  static register_usable_item(item_name, fn, consume_amount) {
+    const usable_item_wrapper = /* @__PURE__ */ __name((abstract_ply, item_name2, item, item_index) => {
+      const ply = PMAPlayerWrapper.from_raw(abstract_ply);
+      fn(ply, item_name2, item);
+    }, "usable_item_wrapper");
+    exports["pma-framework"].register_usable_item(item_name, usable_item_wrapper);
+  }
+  /**
+   * Gets the player from the specified source
+   * @note the PMAPlayer is lazy initialized so we don't do un-needed scrt
+   * calls, this means that we *can* possibly end up in a state where the player
+   * isn't initialized, this won't break anything though.
+   * @returns the PMAPlayer wrapper, or `null` if the player doesn't exist
+   */
+  static from_source(source) {
+    return PMAPlayerWrapper.from_source(source);
+  }
+  /**
+   * Gets the player from the specified UID
+   * @returns the PMAPlayer wrapper, or `null` if there wasn't a player
+   */
+  static from_uid(uid) {
+    const data = exports["pma-framework"].from_uid(uid);
+    return data ? PMAPlayerWrapper.from_raw(data) : null;
+  }
+  /**
+   * Gets all of the players that habe the specified job(s), and the specified {@param job_rank} if specified.
+   */
+  static get_players_with_job(job_names, job_rank) {
+    const players = exports["pma-framework"].get_players_with_job(job_names, job_rank);
+    return players.map((v) => PMAPlayerWrapper.from_raw(v));
+  }
+  /**
+   * Generic logging
+   * TODO: Setup a clickhouse wrapper
+   */
+  static log(log_message, additional_data) {
+    console.log(log_message, additional_data);
+  }
+}
+export {
+  PMA
+};

package/class/PMAPlayer.d.ts

@@ -0,0 +1,26 @@
+import type { InventoryItem } from "@pma-network/fivem-types/Inventory";
+import type { NotificationVariant, PMAPartialNotification } from "@pma-network/fivem-types/Notifications";
+import { CommonPMAPlayer } from "../shared-server/class/CommonPMAPlayer";
+import type { CommonAbstractPMAPlayer } from "../shared-server/types/CommonAbstractPMAPlayer";
+import type { ItemName } from "../shared-server/types/SharedTypes";
+export declare class PMAPlayerWrapper extends CommonPMAPlayer {
+    #private;
+    /**
+     * Creates the player from the ScRT msgpack'd class
+     */
+    static from_raw(ply: CommonAbstractPMAPlayer): PMAPlayerWrapper;
+    /**
+     * Does basic checks that the player exists before lazy initializing the player
+     */
+    static from_source(source: number): PMAPlayerWrapper | null;
+    /**
+     * Creates the player from the source without doing any validity checks
+     */
+    static from_source_unchecked(source: number): CommonPMAPlayer;
+    constructor(source: number);
+    constructor(pma_player: CommonAbstractPMAPlayer);
+    send_notification(title?: string, description?: string, variant?: NotificationVariant, duration?: number): void;
+    send_notification_object(partial: PMAPartialNotification): void;
+    get_item(item_name: ItemName): InventoryItem | null;
+    add_item(item_name: ItemName, quantity: number): void;
+}

package/class/PMAPlayer.js

@@ -0,0 +1,64 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { CommonPMAPlayer } from "../shared-server/class/CommonPMAPlayer";
+class PMAPlayerWrapper extends CommonPMAPlayer {
+  static {
+    __name(this, "PMAPlayerWrapper");
+  }
+  // This will get lazy-initialized whenever we actually call a function that needs it,
+  // this will make sure we don't pay the un-needed serialize cost if we're only using this for
+  // basic nativewrappers types
+  #pma_player;
+  /**
+   * Creates the player from the ScRT msgpack'd class
+   */
+  static from_raw(ply) {
+    return new PMAPlayerWrapper(ply);
+  }
+  /**
+   * Does basic checks that the player exists before lazy initializing the player
+   */
+  static from_source(source) {
+    if (!DoesPlayerExist(source)) {
+      return null;
+    }
+    return new PMAPlayerWrapper(source);
+  }
+  /**
+   * Creates the player from the source without doing any validity checks
+   */
+  static from_source_unchecked(source) {
+    return new CommonPMAPlayer(source);
+  }
+  constructor(source) {
+    if (typeof source !== "number") {
+      const ply = source;
+      super(ply.source);
+      this.#pma_player = ply;
+    } else {
+      super(source);
+    }
+  }
+  send_notification(title, description, variant = "default", duration = 5e3) {
+    const noti = {
+      body: description,
+      duration,
+      variant
+    };
+    this.emit("pma:add_notifications", noti);
+  }
+  send_notification_object(partial) {
+    this.emit("pma:add_notification", partial);
+  }
+  get_item(item_name) {
+    this.ensure_init();
+    return this.#pma_player.get_item(item_name);
+  }
+  add_item(item_name, quantity) {
+    this.ensure_init();
+    return this.#pma_player.add_item(item_name, quantity);
+  }
+}
+export {
+  PMAPlayerWrapper
+};

package/decors/PMANetEvent.d.ts

@@ -0,0 +1,10 @@
+import { PMAPlayerWrapper } from "../class/PMAPlayer";
+type PMAServerEventType = (player: PMAPlayerWrapper, ...args: any[]) => Promise<void> | void;
+/**
+ * Registers the Net Event call for {@link eventName} to this method
+ *
+ * @param eventName the event to bind this net event to
+ * @param remoteOnly if the event should only accept remote calls, if set to true it will ignore any local call via `emit`, defaults to true
+ */
+export declare function OnPMANetEvent(eventName: string): (originalMethod: PMAServerEventType, context: ClassMethodDecoratorContext) => void;
+export {};

package/decors/PMANetEvent.js

@@ -0,0 +1,46 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { PMAPlayerWrapper } from "../class/PMAPlayer";
+function OnPMANetEvent(eventName) {
+  return /* @__PURE__ */ __name(function actualDecorator(originalMethod, context) {
+    if (context.private) {
+      throw new Error("NetEvent does not work on private methods, please mark the method as public");
+    }
+    context.addInitializer(function() {
+      const _t = this;
+      onNet(eventName, async (...args) => {
+        const ply = new PMAPlayerWrapper(source);
+        if (_t.__permissionMap) {
+          const permissions = _t.__permissionMap.get(context.name);
+          if (permissions) {
+            let hasPermission = false;
+            for (const perm of permissions) {
+              if (ply.isAceAllowed(perm)) {
+                hasPermission = true;
+                break;
+              }
+            }
+            if (!hasPermission) {
+              emit("@nativewrappers:no_permission", { eventName, method: context.name, source: ply.Source });
+              return;
+            }
+          }
+        }
+        try {
+          return await originalMethod.call(this, ply, ...args);
+        } catch (e) {
+          console.error("------- NET EVENT ERROR --------");
+          console.error(`Call to ${eventName} errored`);
+          console.error(`Caller: ${ply.Source}`);
+          console.error(`Data: ${JSON.stringify(args)}`);
+          console.error(`Error: ${e}`);
+          console.error("------- END NET EVENT ERROR --------");
+        }
+      });
+    });
+  }, "actualDecorator");
+}
+__name(OnPMANetEvent, "OnPMANetEvent");
+export {
+  OnPMANetEvent
+};

package/decors/RegisterUsableItems.d.ts

@@ -0,0 +1,10 @@
+import type { UsableItemCall } from "../types/Inventory";
+import type { ItemName } from "../shared-server/types/SharedTypes";
+/**
+ * Registers the {@link item_name} to be usable
+ *
+ * NOTE: On RedM the item needs to have its usable flag for this to work.
+ *
+ * @param item_name The item to make usable
+ */
+export declare function RegisterUsableItem(item_name: ItemName, consume_amount?: number): (originalMethod: UsableItemCall, context: ClassMethodDecoratorContext) => void;

package/decors/RegisterUsableItems.js

@@ -0,0 +1,33 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { PMA } from "../PMA";
+function RegisterUsableItem(item_name, consume_amount = 0) {
+  return /* @__PURE__ */ __name(function actualDecorator(originalMethod, context) {
+    if (context.private) {
+      throw new Error("RegisterUsableItem does not work on private methods, please mark the method as public");
+    }
+    context.addInitializer(function() {
+      const t = this;
+      PMA.register_usable_item(
+        item_name,
+        (ply, ...args) => {
+          try {
+            originalMethod.call(t, ply, ...args);
+          } catch (e) {
+            console.error("------- USABLE ITEM ERROR --------");
+            console.error(`Call for ${item_name} errored`);
+            console.error(`Caller: ${ply.Source}`);
+            console.error(`Data: ${JSON.stringify(args)}`);
+            console.error(`Error: ${e}`);
+            console.error("------- END USABLE ITEM ERROR --------");
+          }
+        },
+        consume_amount
+      );
+    });
+  }, "actualDecorator");
+}
+__name(RegisterUsableItem, "RegisterUsableItem");
+export {
+  RegisterUsableItem
+};

package/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./PMA";
+export * from "./types/Inventory";
+export * from "./shared-server/CommonPMA";
+export * from "./shared-server/utils/CooldownTracker";
+export * from "./shared-server/utils/FrameworkName";
+export * from "./shared-server/utils/GlobalOverrides";
+export * from "./shared-server/utils/InfractionsWrapper";
+export * from "./shared-server/types/CommonAbstractPMAPlayer";
+export * from "./shared-server/types/CommonNotifications";
+export * from "./shared-server/types/SharedTypes";
+export * from "./shared-server/class/CommonPMAPlayer";
+export * from "./decors/PMANetEvent";
+export * from "./decors/RegisterUsableItems";
+export * from "./class/PMAPlayer";

package/index.js

@@ -0,0 +1,14 @@
+export * from "./PMA";
+export * from "./types/Inventory";
+export * from "./shared-server/CommonPMA";
+export * from "./shared-server/utils/CooldownTracker";
+export * from "./shared-server/utils/FrameworkName";
+export * from "./shared-server/utils/GlobalOverrides";
+export * from "./shared-server/utils/InfractionsWrapper";
+export * from "./shared-server/types/CommonAbstractPMAPlayer";
+export * from "./shared-server/types/CommonNotifications";
+export * from "./shared-server/types/SharedTypes";
+export * from "./shared-server/class/CommonPMAPlayer";
+export * from "./decors/PMANetEvent";
+export * from "./decors/RegisterUsableItems";
+export * from "./class/PMAPlayer";

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@pma-network/fivem-server",
+  "description": "Native wrappers and utilities for use with PMA FiveM Server.",
+  "contributors": [
+    "Dillon Skaggs <AvarianKnight>"
+  ],
+  "type": "module",
+  "version": "0.0.11",
+  "files": [
+    "./**/*.js",
+    "./**/*.d.ts"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": "./index.js",
+    "./*": "./*"
+  }
+}

package/shared-server/CommonPMA.d.ts

@@ -0,0 +1,31 @@
+import { CommonPMAPlayer } from "./class/CommonPMAPlayer";
+import type { PlayerUID } from "./types/SharedTypes";
+/**
+ * A wraper around common functions that canbe used both in FiveM and RedM
+ */
+export declare class CommonPMA {
+    /**
+     * Gets the player from the specified source
+     * @note the PMAPlayer is lazy initialized so we don't do un-needed scrt
+     * calls, this means that we *can* possibly end up in a state where the player
+     * isn't initialized, this won't break anything though.
+     * @returns the PMAPlayer wrapper, or `null` if the player doesn't exist
+     */
+    static from_source(source: number): CommonPMAPlayer | null;
+    /**
+     * Gets the player from the specified UID
+     * @returns the PMAPlayer wrapper, or `null` if there wasn't a player
+     */
+    static from_uid(uid: PlayerUID): CommonPMAPlayer | null;
+    /**
+     * Gets all of the players that habe the specified job(s), and the specified {@param job_rank} if specified.
+     */
+    static get_players_with_job(job_names: string | string[], job_rank?: number): CommonPMAPlayer[];
+    /**
+     * Generic logging
+     * TODO: Setup a clickhouse wrapper
+     */
+    static log(log_message: string, additional_data?: {
+        [key: string]: any;
+    }): void;
+}

package/shared-server/CommonPMA.js

@@ -0,0 +1,44 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { CommonPMAPlayer } from "./class/CommonPMAPlayer";
+import { framework_name } from "./utils/FrameworkName";
+class CommonPMA {
+  static {
+    __name(this, "CommonPMA");
+  }
+  /**
+   * Gets the player from the specified source
+   * @note the PMAPlayer is lazy initialized so we don't do un-needed scrt
+   * calls, this means that we *can* possibly end up in a state where the player
+   * isn't initialized, this won't break anything though.
+   * @returns the PMAPlayer wrapper, or `null` if the player doesn't exist
+   */
+  static from_source(source) {
+    return CommonPMAPlayer.from_source(source);
+  }
+  /**
+   * Gets the player from the specified UID
+   * @returns the PMAPlayer wrapper, or `null` if there wasn't a player
+   */
+  static from_uid(uid) {
+    const data = exports[framework_name].from_uid(uid);
+    return data ? CommonPMAPlayer.from_raw(data) : null;
+  }
+  /**
+   * Gets all of the players that habe the specified job(s), and the specified {@param job_rank} if specified.
+   */
+  static get_players_with_job(job_names, job_rank) {
+    const players = exports[framework_name].get_players_with_job(job_names, job_rank);
+    return players.map((v) => CommonPMAPlayer.from_raw(v));
+  }
+  /**
+   * Generic logging
+   * TODO: Setup a clickhouse wrapper
+   */
+  static log(log_message, additional_data) {
+    console.log(log_message, additional_data);
+  }
+}
+export {
+  CommonPMA
+};

package/shared-server/class/CommonPMAPlayer.d.ts

@@ -0,0 +1,41 @@
+import { Player } from "@nativewrappers/server";
+import type { CommonAbstractPMAPlayer } from "../types/CommonAbstractPMAPlayer";
+import type { CommonNotificationVariant, CommonPMAPartialNotification } from "../types/CommonNotifications";
+import type { CallSign, ItemName, PlayerJob, PlayerUID } from "../types/SharedTypes";
+export declare class CommonPMAPlayer extends Player implements CommonAbstractPMAPlayer {
+    #private;
+    /**
+     * Creates the player from the ScRT msgpack'd class
+     */
+    static from_raw(ply: CommonAbstractPMAPlayer): CommonPMAPlayer;
+    /**
+     * Does basic checks that the player exists before lazy initializing the player
+     */
+    static from_source(source: number): CommonPMAPlayer | null;
+    /**
+     * Creates the player from the source without doing any validity checks
+     */
+    static from_source_unchecked(source: number): CommonPMAPlayer;
+    constructor(source: number);
+    constructor(pma_player: CommonAbstractPMAPlayer);
+    ensure_init(): void;
+    send_notification(title?: string, description?: string, variant?: CommonNotificationVariant, duration?: number): void;
+    send_notification_object(partial: CommonPMAPartialNotification): void;
+    get_sex(): number;
+    get_height(): number;
+    get_dob(): string;
+    get_unique_id(): PlayerUID;
+    get_call_sign(): CallSign;
+    get_character_name(): string;
+    get_log_name(): string;
+    get_item(item_name: ItemName): unknown;
+    add_item(item_name: ItemName, quantity: number): unknown;
+    remove_item(item_name: ItemName, quantity: number): void;
+    has_enough_of_item(item_name: ItemName, quantity: number): boolean;
+    get_job(): PlayerJob;
+    set_job(job_name: string, rank: number): void;
+    get_bank(): number;
+    add_to_bank(positive_amount: number): void;
+    remove_from_bank(negative_amount: number): void;
+    save(): Promise<void>;
+}

package/shared-server/class/CommonPMAPlayer.js

@@ -0,0 +1,135 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { Player } from "@nativewrappers/server";
+import { framework_name } from "../utils/FrameworkName";
+import { pma_get_player_from_id } from "../utils/GlobalOverrides";
+class CommonPMAPlayer extends Player {
+  static {
+    __name(this, "CommonPMAPlayer");
+  }
+  // This will get lazy-initialized whenever we actually call a function that needs it,
+  // this will make sure we don't pay the un-needed serialize cost if we're only using this for
+  // basic nativewrappers types
+  #pma_player;
+  /**
+   * Creates the player from the ScRT msgpack'd class
+   */
+  static from_raw(ply) {
+    return new CommonPMAPlayer(ply);
+  }
+  /**
+   * Does basic checks that the player exists before lazy initializing the player
+   */
+  static from_source(source) {
+    if (!DoesPlayerExist(source)) {
+      return null;
+    }
+    return new CommonPMAPlayer(source);
+  }
+  /**
+   * Creates the player from the source without doing any validity checks
+   */
+  static from_source_unchecked(source) {
+    return new CommonPMAPlayer(source);
+  }
+  constructor(source) {
+    if (typeof source !== "number") {
+      const ply = source;
+      super(ply.source);
+      this.#pma_player = ply;
+    } else {
+      super(source);
+    }
+  }
+  // Ensure we initialize the player whenever we're doing something that needs it.
+  ensure_init() {
+    if (!this.#pma_player) {
+      this.#pma_player = globalThis.pma_get_player_from_id ? (
+        // @ts-ignore: we override this in GlobalOverrides
+        globalThis.pma_get_player_from_id(this.Source)
+      ) : pma_get_player_from_id(this.Source);
+    }
+  }
+  send_notification(title, description, variant = "default", duration = 5e3) {
+    const noti = {
+      body: description,
+      duration,
+      variant
+    };
+    this.emit("pma:add_notifications", noti);
+  }
+  send_notification_object(partial) {
+    this.emit("pma:add_notification", partial);
+  }
+  get_sex() {
+    this.ensure_init();
+    return this.#pma_player.get_sex();
+  }
+  get_height() {
+    this.ensure_init();
+    return this.#pma_player.get_height();
+  }
+  get_dob() {
+    this.ensure_init();
+    return this.#pma_player.get_dob();
+  }
+  get_unique_id() {
+    this.ensure_init();
+    return this.#pma_player.get_unique_id();
+  }
+  get_call_sign() {
+    this.ensure_init();
+    return this.#pma_player.get_call_sign();
+  }
+  get_character_name() {
+    this.ensure_init();
+    return this.#pma_player.get_character_name();
+  }
+  get_log_name() {
+    this.ensure_init();
+    return this.#pma_player.get_character_name();
+  }
+  get_item(item_name) {
+    this.ensure_init();
+    return this.#pma_player.get_item(item_name);
+  }
+  add_item(item_name, quantity) {
+    this.ensure_init();
+    return this.#pma_player.add_item(item_name, quantity);
+  }
+  remove_item(item_name, quantity) {
+    this.ensure_init();
+    return this.#pma_player.remove_item(item_name, quantity);
+  }
+  has_enough_of_item(item_name, quantity) {
+    this.ensure_init();
+    return this.#pma_player.has_enough_of_item(item_name, quantity);
+  }
+  get_job() {
+    this.ensure_init();
+    return this.#pma_player.get_job();
+  }
+  set_job(job_name, rank) {
+    this.ensure_init();
+    return this.#pma_player.set_job(job_name, rank);
+  }
+  get_bank() {
+    this.ensure_init();
+    return this.#pma_player.get_bank();
+  }
+  add_to_bank(positive_amount) {
+    this.ensure_init();
+    return this.#pma_player.add_to_bank(positive_amount);
+  }
+  remove_from_bank(negative_amount) {
+    this.ensure_init();
+    return this.#pma_player.remove_from_bank(negative_amount);
+  }
+  save() {
+    this.ensure_init();
+    return this.#pma_player.save();
+  }
+}
+export {
+  CommonPMAPlayer
+};

package/shared-server/types/CommonAbstractPMAPlayer.d.ts

@@ -0,0 +1,48 @@
+import type { CallSign, ItemName, PlayerJob, PlayerUID } from "./SharedTypes";
+export declare abstract class CommonAbstractPMAPlayer {
+    abstract get_sex(): number;
+    abstract get_height(): number;
+    abstract get_dob(): string;
+    abstract get_unique_id(): PlayerUID;
+    abstract get_call_sign(): CallSign;
+    abstract get_character_name(): string;
+    abstract get_log_name(): string;
+    abstract get_item(item_name: ItemName): unknown;
+    /**
+     * Adds the item with {@param item_name} to the players next free slot
+     *
+     * On RedM this will return `InventoryItem` on FiveM this will return `void`
+     *
+     * @throws This will throw an error if {@param item_name} is invalid, or if {@param quantity} is negative
+     * @returns the {@link InventoryItem} that was created, or undefined if there wasn't a free slot to put the item into.
+     */
+    abstract add_item(item_name: ItemName, quantity: number): unknown;
+    /**
+     * Removes the item with {@param item_name} from the players inventory
+     * @throws This will throw an error if there wasn't enough {@param quantity} in the players inventory, you should use use has_enough_of_item to check before calling
+     */
+    abstract remove_item(item_name: ItemName, quantity: number): void;
+    /**
+     * Checks if the player has enough of {@param item_name}
+     * @returns `true` if they had enough {@param quantity}, `false` otherwise
+     */
+    abstract has_enough_of_item(item_name: ItemName, quantity: number): boolean;
+    abstract get_job(): PlayerJob;
+    /**
+     * Sets the players job to the specified {@param job_name} and {@param rank}
+     * @throws This will throw if the players job is invalid
+     */
+    abstract set_job(job_name: string, rank: number): void;
+    abstract get_bank(): number;
+    /**
+     * Adds the {@param positive_amount} to the players bank.
+     * @throws if {@param positive_amount} is negative this will throw an error.
+     */
+    abstract add_to_bank(positive_amount: number): void;
+    /**
+     * Removes the {@param negative_amount} to the players bank.
+     * @throws if {@param negative_amount} is positive this will throw an error.
+     */
+    abstract remove_from_bank(negative_amount: number): void;
+    abstract save(): Promise<void>;
+}

package/shared-server/types/CommonAbstractPMAPlayer.js

@@ -0,0 +1,10 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class CommonAbstractPMAPlayer {
+  static {
+    __name(this, "CommonAbstractPMAPlayer");
+  }
+}
+export {
+  CommonAbstractPMAPlayer
+};

package/shared-server/types/CommonNotifications.d.ts

@@ -0,0 +1,12 @@
+export type Position = "top-left" | "top-center" | "top-right" | "middle-left" | "middle" | "middle-right" | "bottom-left" | "bottom-center" | "bottom-right";
+export type CommonNotificationVariant = "default" | "error" | "success";
+export type CommonPMAPartialNotification = Omit<CommonPMANotification, "id">;
+export type CommonPMANotification = {
+    id: number;
+    title?: string;
+    body?: string;
+    variant: CommonNotificationVariant;
+    duration?: number;
+    position?: Position;
+    timeout?: number;
+};

package/shared-server/types/SharedTypes.d.ts

@@ -0,0 +1,8 @@
+export type ItemName = string;
+export type Source = number;
+export type PlayerUID = number;
+export type CallSign = string | undefined;
+export type PlayerJob = {
+    name: string;
+    rank: number;
+};

package/shared-server/utils/CooldownTracker.d.ts

@@ -0,0 +1,8 @@
+type CooldownTrackerCallback = (src: number, details: string) => void;
+export declare class CooldownTracker {
+    #private;
+    constructor(cooldown: number, cb: CooldownTrackerCallback);
+    private player_dropped;
+    try_add_cooldown(src: number, additional_details: string): boolean;
+}
+export {};

package/shared-server/utils/CooldownTracker.js

@@ -0,0 +1,35 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { Event } from "@nativewrappers/server";
+class CooldownTracker {
+  static {
+    __name(this, "CooldownTracker");
+  }
+  #cooldown_map = /* @__PURE__ */ new Map();
+  #cooldown;
+  #cb;
+  constructor(cooldown, cb) {
+    this.#cooldown = cooldown;
+    this.#cb = cb;
+  }
+  @Event("playerDropped")
+  player_dropped() {
+    this.#cooldown_map.delete(source);
+  }
+  /*
+   * @returns This returns `true` if it was successful in adding the player, or `false` the user already existed on the list
+   */
+  try_add_cooldown(src, additional_details) {
+    const gt = GetGameTimer();
+    const time = this.#cooldown_map.get(src);
+    if (!time || time < gt) {
+      this.#cooldown_map.set(src, gt + this.#cooldown);
+      return true;
+    }
+    this.#cb(src, additional_details);
+    return false;
+  }
+}
+export {
+  CooldownTracker
+};

package/shared-server/utils/FrameworkName.d.ts

@@ -0,0 +1 @@
+export declare const framework_name: string;

package/shared-server/utils/FrameworkName.js

@@ -0,0 +1,4 @@
+const framework_name = GetGameName() === "fivem" ? "pma-framework" : "pma";
+export {
+  framework_name
+};

package/shared-server/utils/GlobalOverrides.d.ts

@@ -0,0 +1,3 @@
+import type { CommonPMAPlayer } from "../class/CommonPMAPlayer";
+import type { Source } from "../types/SharedTypes";
+export declare function pma_get_player_from_id(source: Source): CommonPMAPlayer;

package/shared-server/utils/GlobalOverrides.js

@@ -0,0 +1,11 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { framework_name } from "./FrameworkName";
+function pma_get_player_from_id(source) {
+  return exports[framework_name].from_source(source);
+}
+__name(pma_get_player_from_id, "pma_get_player_from_id");
+globalThis.pma_get_player_from_id = pma_get_player_from_id;
+export {
+  pma_get_player_from_id
+};

package/types/Inventory.d.ts

@@ -0,0 +1,12 @@
+import type { PMAPlayerWrapper } from "../class/PMAPlayer";
+import type { InventoryItem } from "@pma-network/fivem-types/Inventory";
+/**
+ * @param ply the player to call the callback for
+ * @param itemName the item name that the callback will be fore
+ * @param consume_item the amount of the item to consume on the callback
+ */
+export type UsableItemCall = (ply: PMAPlayerWrapper, itemName: string, item: InventoryItem) => void;
+export type UsableItems = {
+    fn: UsableItemCall;
+    resource: string;
+};