@pma-network/redm 0.0.14

package/PMA.d.ts

@@ -0,0 +1,41 @@
+import type { PlayerJob } from "@pma-network/redm-types/PMAPlayer";
+export type OnJobChange = (pmaThis: PMAWrapper, job: PlayerJob) => void;
+export type OnPlayerLoaded = (pmaThis: PMAWrapper) => void;
+declare class PMAWrapper {
+    #private;
+    HasLoaded: Promise<boolean>;
+    constructor();
+    /**
+     * WARNING: this expects you to have waited for {@link HasLoaded} to be called before trying to call it!
+     */
+    get Job(): PlayerJob;
+    /**
+     * WARNING: this expects you to have waited for {@link HasLoaded} to be called before trying to call it!
+     * @returns 1 if the players character is male, or 0 if the players character is female
+     */
+    get Gender(): number;
+    /**
+     * WARNING: this expects you to have waited for {@link HasLoaded} to be called before trying to call it!
+     */
+    get UniqueId(): number;
+    /**
+     * WARNING: this expects you to have waited for {@link HasLoaded} to be called before trying to call it!
+     */
+    get CharacterName(): string;
+    /**
+     * WARNING: this expects you to have waited for {@link HasLoaded} to be called before trying to call it!
+     */
+    get Height(): number;
+    /**
+     * Adds the callback to be ran whenever the player is loaded, or instantly if
+     * the players already loaded (i.e. on server restart)
+     */
+    listen_for_player_loaded(cb: OnPlayerLoaded): void;
+    listen_for_player_unloaded(cb: OnPlayerLoaded): void;
+    listen_for_job_change(cb: OnJobChange): void;
+    private on_player_loaded;
+    private on_player_unloaded;
+    private on_set_job;
+}
+export declare const PMA: PMAWrapper;
+export {};

package/PMA.js

@@ -0,0 +1,110 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { OnEvent, OnNetEvent } from "@nativewrappers/common";
+class PMAWrapper {
+  static {
+    __name(this, "PMAWrapper");
+  }
+  #job;
+  #gender;
+  #uid;
+  #char_name;
+  #height;
+  HasLoaded;
+  #has_loaded_resolve;
+  #job_change_cb = [];
+  #player_loaded_cb = [];
+  #player_unloaded_cb = [];
+  #_resolve() {
+    this.#has_loaded_resolve(true);
+  }
+  #setup_has_loaded() {
+    this.HasLoaded = new Promise((res) => {
+      this.#has_loaded_resolve = res;
+    });
+  }
+  constructor() {
+    this.#setup_has_loaded();
+    if (LocalPlayer.state.has_loaded) {
+      this.on_player_loaded();
+    }
+  }
+  /**
+   * WARNING: this expects you to have waited for {@link HasLoaded} to be called before trying to call it!
+   */
+  get Job() {
+    return this.#job;
+  }
+  /**
+   * WARNING: this expects you to have waited for {@link HasLoaded} to be called before trying to call it!
+   * @returns 1 if the players character is male, or 0 if the players character is female
+   */
+  get Gender() {
+    return this.#gender;
+  }
+  /**
+   * WARNING: this expects you to have waited for {@link HasLoaded} to be called before trying to call it!
+   */
+  get UniqueId() {
+    return this.#uid;
+  }
+  /**
+   * WARNING: this expects you to have waited for {@link HasLoaded} to be called before trying to call it!
+   */
+  get CharacterName() {
+    return this.#char_name;
+  }
+  /**
+   * WARNING: this expects you to have waited for {@link HasLoaded} to be called before trying to call it!
+   */
+  get Height() {
+    return this.#height;
+  }
+  /**
+   * Adds the callback to be ran whenever the player is loaded, or instantly if
+   * the players already loaded (i.e. on server restart)
+   */
+  listen_for_player_loaded(cb) {
+    this.#player_loaded_cb.push(cb);
+  }
+  listen_for_player_unloaded(cb) {
+    this.#player_unloaded_cb.push(cb);
+  }
+  listen_for_job_change(cb) {
+    this.#job_change_cb.push(cb);
+  }
+  @OnEvent("pma:playerLoaded")
+  on_player_loaded() {
+    const state = LocalPlayer.state;
+    this.#gender = state.gender;
+    this.#height = state.height;
+    this.#uid = state.uid;
+    this.#char_name = state.char_name;
+    this.on_set_job({
+      name: state.job_name,
+      rank: state.job_grade
+    });
+    this.#_resolve();
+    for (const cb of this.#player_loaded_cb) {
+      cb(this);
+    }
+  }
+  @OnNetEvent("pma:playerUnloaded")
+  on_player_unloaded() {
+    for (const cb of this.#player_unloaded_cb) {
+      cb(this);
+    }
+    this.#setup_has_loaded();
+  }
+  @OnNetEvent("pma:setJob")
+  on_set_job(job) {
+    this.#job = job;
+    for (const cb of this.#job_change_cb) {
+      cb(this, job);
+    }
+  }
+}
+const PMA = new PMAWrapper();
+export {
+  PMA
+};

package/decors/PMADecors.d.ts

@@ -0,0 +1,4 @@
+import { type OnJobChange, type OnPlayerLoaded as OnPlayerLoadedFramework } from "../PMA";
+export declare function OnPlayerLoaded(): (originalMethod: OnPlayerLoadedFramework, context: ClassMethodDecoratorContext) => void;
+export declare function OnPlayerUnloaded(): (originalMethod: OnPlayerLoadedFramework, context: ClassMethodDecoratorContext) => void;
+export declare function OnPlayerJobChange(): (originalMethod: OnJobChange, context: ClassMethodDecoratorContext) => void;

package/decors/PMADecors.js

@@ -0,0 +1,41 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { PMA } from "../PMA";
+function OnPlayerLoaded() {
+  return /* @__PURE__ */ __name(function actualDecorator(originalMethod, context) {
+    if (context.private) {
+      throw new Error("OnPlayerLoaded does not work on private methods, please mark the method as public");
+    }
+    context.addInitializer(function() {
+      PMA.listen_for_player_loaded(originalMethod.bind(this));
+    });
+  }, "actualDecorator");
+}
+__name(OnPlayerLoaded, "OnPlayerLoaded");
+function OnPlayerUnloaded() {
+  return /* @__PURE__ */ __name(function actualDecorator(originalMethod, context) {
+    if (context.private) {
+      throw new Error("OnPlayerUnloaded does not work on private methods, please mark the method as public");
+    }
+    context.addInitializer(function() {
+      PMA.listen_for_player_unloaded(originalMethod.bind(this));
+    });
+  }, "actualDecorator");
+}
+__name(OnPlayerUnloaded, "OnPlayerUnloaded");
+function OnPlayerJobChange() {
+  return /* @__PURE__ */ __name(function actualDecorator(originalMethod, context) {
+    if (context.private) {
+      throw new Error("OnPlayerJobChange does not work on private methods, please mark the method as public");
+    }
+    context.addInitializer(function() {
+      PMA.listen_for_job_change(originalMethod.bind(this));
+    });
+  }, "actualDecorator");
+}
+__name(OnPlayerJobChange, "OnPlayerJobChange");
+export {
+  OnPlayerJobChange,
+  OnPlayerLoaded,
+  OnPlayerUnloaded
+};

package/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./PMA";
+export * from "./interactions";
+export * from "./decors/PMADecors";

package/index.js

@@ -0,0 +1,3 @@
+export * from "./PMA";
+export * from "./interactions";
+export * from "./decors/PMADecors";

package/interactions.d.ts

@@ -0,0 +1,43 @@
+export type Bitwise<_T> = number;
+export type InteractionVec3 = [number, number, number];
+export type InteractionType = "circle-interaction";
+export type InteractionColor = [number, number, number];
+export declare enum InteractionDisable {
+    None = 0,
+    InCombat = 1,
+    IsCuffed = 2,
+    IsInTrunk = 4,
+    IsInVehicle = 8,
+    IsOnPhone = 16
+}
+export interface Interaction {
+    hideInteraction?: boolean;
+    resource?: string;
+    interactionType: InteractionType;
+    preloadDistance?: number;
+    interactionDistance: number;
+    distance: number;
+    name?: string;
+    displayOffset?: InteractionVec3;
+    handle?: number;
+    model?: number;
+    position?: InteractionVec3[];
+    args?: any[];
+    showOffscreen: boolean;
+    disableOnNotInteractable?: boolean;
+    useHeavyLosCheck?: boolean;
+    nonInteractableColor?: InteractionColor;
+    interactionCooldownInMs?: number;
+    nextAllowedInteraction?: number;
+    colorOverride?: InteractionColor;
+    disableInteraction?: Bitwise<InteractionDisable>;
+    canInteract?: (ent?: number, ...args: any[]) => boolean;
+    onInteract?: (ent?: number, ...args: any[]) => void;
+}
+declare class InteractionManager {
+    addInteraction(interaction: Interaction): void;
+    removeInteraction(interactionName: string): void;
+    doesInteractionExist(interactionName: string): boolean;
+}
+export declare const INTERACTION_MANAGER: InteractionManager;
+export {};

package/interactions.js

@@ -0,0 +1,30 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var InteractionDisable = /* @__PURE__ */ ((InteractionDisable2) => {
+  InteractionDisable2[InteractionDisable2["None"] = 0] = "None";
+  InteractionDisable2[InteractionDisable2["InCombat"] = 1] = "InCombat";
+  InteractionDisable2[InteractionDisable2["IsCuffed"] = 2] = "IsCuffed";
+  InteractionDisable2[InteractionDisable2["IsInTrunk"] = 4] = "IsInTrunk";
+  InteractionDisable2[InteractionDisable2["IsInVehicle"] = 8] = "IsInVehicle";
+  InteractionDisable2[InteractionDisable2["IsOnPhone"] = 16] = "IsOnPhone";
+  return InteractionDisable2;
+})(InteractionDisable || {});
+class InteractionManager {
+  static {
+    __name(this, "InteractionManager");
+  }
+  addInteraction(interaction) {
+    exports["pma-interactions"].addInteraction(interaction);
+  }
+  removeInteraction(interactionName) {
+    exports["pma-interactions"].removeInteraction(interactionName);
+  }
+  doesInteractionExist(interactionName) {
+    return exports["pma-interactions"].doesInteractionExistForName(interactionName);
+  }
+}
+const INTERACTION_MANAGER = new InteractionManager();
+export {
+  INTERACTION_MANAGER,
+  InteractionDisable
+};

package/package.json

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