@panda0day/fivex 0.2.1

package/README.md

@@ -0,0 +1,294 @@
+# fivex
+
+A TypeScript framework for FiveM. You install it into a resource project like any npm package and get a consistent, object-oriented API over the natives instead of calling them raw in every script.
+
+`fx.events.add`, `fx.events.addCommand`, a player pool, entity objects, and a real `Vector3` class with math on it. The difference is that everything is typed.
+
+> Package name is `@panda0day/fivex` and the global export is `fx`. Rename to taste before publishing.
+
+## How it works
+
+FiveM never loads `node_modules` at runtime. The client runtime is a V8 isolate with no module resolution, and server scripts run as a single bundled file. So this framework isn't loaded by FiveM directly — it's a normal library that your resource's bundler (esbuild) inlines into your `client.js` / `server.js` at build time.
+
+That's the whole reason it "works the same in every project": FiveM only ever sees the final bundle, and your framework code is baked into it.
+
+Because client and server expose different natives, the package has three entry points:
+
+```
+@panda0day/fivex/client   // client-only API + shared
+@panda0day/fivex/server   // server-only API + shared
+@panda0day/fivex/shared   // Vector3, math, event names — no natives
+```
+
+Importing `/client` can never pull server natives onto the client, and vice versa.
+
+## Install
+
+```bash
+npm install @panda0day/fivex
+```
+
+You also need the CitizenFX typings in your project (they're peer dependencies):
+
+```bash
+npm install -D @citizenfx/client @citizenfx/server
+```
+
+## Quick start
+
+Client:
+
+```ts
+import { fx, Vector3 } from '@panda0day/fivex/client';
+
+fx.events.addCommand('up', () => {
+  fx.player.position = fx.player.position.add(new Vector3(0, 0, 5));
+});
+
+fx.events.addNet('fivex:notify', (message: string) => {
+  console.log(message);
+});
+```
+
+Server:
+
+```ts
+import { fx } from '@panda0day/fivex/server';
+
+fx.events.addCommand('kickall', () => {
+  fx.players.forEach((p) => p.drop('server reset'));
+});
+
+fx.events.addNet('fivex:ready', (player) => {
+  player.outputChatBox(`Welcome, ${player.name}`);
+  fx.players.broadcast(`${player.name} joined`);
+});
+```
+
+Natives are still global functions, so anything the framework doesn't wrap you just call directly:
+
+```ts
+const ped = PlayerPedId();
+SetPedArmour(ped, 100);
+```
+
+## Events
+
+Local events stay on one side. Networked events cross the wire.
+
+```ts
+// client
+fx.events.add('someLocalEvent', handler);      // same-side (on)
+fx.events.addNet('fromServer', handler);        // from server (onNet)
+fx.events.call('someLocalEvent', ...args);      // emit locally
+fx.events.callRemote('toServer', ...args);      // client -> server (emitNet)
+
+// server
+fx.events.add('someLocalEvent', handler);
+fx.events.addNet('fromClient', (player, ...args) => {}); // note: player is first arg
+```
+
+On the server, `addNet` hands you a `Player` as the first argument. See "The source footgun" below for why that matters.
+
+## Commands
+
+```ts
+// client
+fx.events.addCommand('heal', (args, raw) => { /* ... */ });
+
+// server — caller is a Player, or null for console
+fx.events.addCommand('setjob', (player, args) => {
+  if (!player) return; // ran from server console
+  // ...
+});
+```
+
+## Players
+
+Server side, `fx.players` is a pool:
+
+```ts
+fx.players.at(source);        // Player for a specific server id
+fx.players.toArray();         // Player[]
+fx.players.forEach(fn);
+fx.players.call('event', ...args);   // emit to all clients
+fx.players.broadcast('message');     // chat to all
+```
+
+A `Player` wraps a server id and gives you the common operations:
+
+```ts
+player.name;
+player.ped;                   // the ped entity handle
+player.position;              // Vector3 (read)
+player.getIdentifier('license:');
+player.call('event', ...args);
+player.outputChatBox('text');
+player.drop('reason');
+```
+
+Client side, `fx.player` is the local player. It's a `LocalPlayer`, which extends `Ped`, which extends `Entity`, so it has position, health, armour and so on directly:
+
+```ts
+fx.player.position;
+fx.player.health = 200;
+fx.player.currentVehicle;     // Vehicle | null
+fx.player.serverId;
+```
+
+## Entities
+
+Everything physical in the game is an entity handle. The client classes mirror that with inheritance:
+
+```
+Entity            position, health, model, heading, distanceTo, delete
+ ├─ Ped           armour, isInVehicle, isDead
+ │   └─ LocalPlayer
+ └─ Vehicle       speed, engineOn, repair
+```
+
+```ts
+import { Vehicle } from '@panda0day/fivex/client';
+
+const veh = fx.player.currentVehicle;
+if (veh) {
+  veh.engineOn = true;
+  veh.repair();
+}
+```
+
+The server has a lighter `Entity` (reads work; most writes to player peds don't — see below), and `Player` is composition rather than inheritance: a player *has* a ped, it isn't one.
+
+## Vector3 and math
+
+`Vector3` is a real class, not a plain `{x, y, z}`. It's structurally compatible with what natives expect, so you can pass it straight into `SetEntityCoords` and friends.
+
+```ts
+import { Vector3, clamp, lerp } from '@panda0day/fivex/shared';
+
+const a = new Vector3(0, 0, 0);
+const b = new Vector3(10, 0, 0);
+
+a.add(b);
+a.distanceTo(b);
+a.normalize();
+a.lerp(b, 0.5);
+
+Vector3.from(GetEntityCoords(ped, true)); // wrap a native result
+```
+
+`shared` also has the usual helpers: `clamp`, `lerp`, `remap`, `toRadians`, `toDegrees`, `randomInt`, `randomFloat`.
+
+## Two things this handles for you
+
+These are the parts worth having a framework for. Both are FiveM footguns that are easy to get wrong.
+
+### The source footgun
+
+Inside a server networked event, FiveM exposes the calling player as a global `source` that's only valid synchronously — the first `await` invalidates it, and you silently get the wrong player. `addNet` captures it immediately and passes you a `Player`, so you never touch the global and never race it:
+
+```ts
+fx.events.addNet('buyItem', async (player, itemId) => {
+  // player is already resolved and safe to use after awaits
+  await db.charge(player.getIdentifier('license:'), itemId);
+  player.outputChatBox('Purchased.');
+});
+```
+
+### Server writes to a player go through the client
+
+Under OneSync the owning client is authoritative over its own ped. A server-side `SetEntityHealth` on a player gets reverted on the next sync tick, so it looks like it works and then snaps back. Setting health, armour or position on a `Player` therefore routes an internal event to that client, which applies the change locally where it actually sticks:
+
+```ts
+player.setHealth(200);        // not player.health = 200
+player.setPosition(coords);
+```
+
+The framework registers the client-side handlers for these automatically, so you only call the server method. Reads (`player.health`, `player.position`) are direct because reading the synced value server-side is fine.
+
+Note that this is inherent to the game's trust model: the client can ignore or fake anything you tell it to set on itself. Keep anything security-sensitive (money, permissions) in server state, never in ped state.
+
+## Setting up a consumer project
+
+A resource that uses the framework needs a bundler step. Minimum setup:
+
+`package.json`
+
+```json
+{
+  "scripts": { "build": "node build.js" },
+  "devDependencies": {
+    "@citizenfx/client": "latest",
+    "@citizenfx/server": "latest",
+    "@panda0day/fivex": "latest",
+    "esbuild": "^0.20.0",
+    "typescript": "^5.4.0"
+  }
+}
+```
+
+`tsconfig.json` — use `moduleResolution: "bundler"` (or `node16`) or TypeScript won't read the package's subpath exports and the `/client` and `/server` types won't resolve:
+
+```json
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*.ts"]
+}
+```
+
+`build.js`
+
+```js
+const esbuild = require('esbuild');
+
+const base = { bundle: true, platform: 'node', target: 'node16', format: 'cjs' };
+
+Promise.all([
+  esbuild.build({ ...base, entryPoints: ['src/client/index.ts'], outfile: 'dist/client.js' }),
+  esbuild.build({ ...base, entryPoints: ['src/server/index.ts'], outfile: 'dist/server.js' }),
+]).then(() => console.log('built'));
+```
+
+`fxmanifest.lua`
+
+```lua
+fx_version 'cerulean'
+game 'gta5'
+
+client_script 'dist/client.js'
+server_script 'dist/server.js'
+```
+
+Then `npm run build`, drop the resource in your server, and `ensure` it.
+
+## Working on the framework itself
+
+The framework builds with `tsc` (not esbuild) because it needs to emit `.d.ts` files for consumers:
+
+```bash
+npm run build     # tsc -p tsconfig.client.json && tsc -p tsconfig.server.json
+```
+
+Client and server compile against separate tsconfigs so each side only sees its own natives. `shared` is included in both.
+
+For live development against a real resource, use `npm link`:
+
+```bash
+# in the framework
+npm link
+# in your resource project
+npm link @panda0day/fivex
+```
+
+Run `tsc -w` on the framework and your resource re-bundles against the changes.
+
+## Notes
+
+- `instanceof` doesn't work across resources. Each resource bundles its own copy of the framework, so an `Entity` from one resource isn't `instanceof` the `Entity` in another. This never matters inside a single resource; just don't rely on it across resource boundaries.
+- Entity wrappers aren't cached. `fx.player.currentVehicle` returns a fresh object each call, so `===` won't hold for "the same" vehicle. Add a pool keyed by handle if you need identity.

package/dist/client/blips-internal.d.ts

@@ -0,0 +1,2 @@
+export declare function registerBlipHandlers(): void;
+//# sourceMappingURL=blips-internal.d.ts.map

package/dist/client/blips-internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blips-internal.d.ts","sourceRoot":"","sources":["../../src/client/blips-internal.ts"],"names":[],"mappings":"AAmBA,wBAAgB,oBAAoB,IAAI,IAAI,CAU3C"}

package/dist/client/blips-internal.js

@@ -0,0 +1,32 @@
+/// <reference types="@citizenfx/client" />
+import { BlipNet } from "../shared/blips";
+const handles = new Map();
+function draw(d) {
+    const blip = AddBlipForCoord(d.coords.x, d.coords.y, d.coords.z);
+    if (d.sprite !== undefined)
+        SetBlipSprite(blip, d.sprite);
+    if (d.color !== undefined)
+        SetBlipColour(blip, d.color);
+    if (d.scale !== undefined)
+        SetBlipScale(blip, d.scale);
+    if (d.shortRange)
+        SetBlipAsShortRange(blip, true);
+    if (d.label) {
+        BeginTextCommandSetBlipName("STRING");
+        AddTextComponentSubstringPlayerName(d.label);
+        EndTextCommandSetBlipName(blip);
+    }
+    handles.set(d.id, blip);
+}
+export function registerBlipHandlers() {
+    onNet(BlipNet.add, (d) => draw(d));
+    onNet(BlipNet.sync, (list) => list.forEach(draw));
+    onNet(BlipNet.remove, (id) => {
+        const h = handles.get(id);
+        if (h !== undefined) {
+            RemoveBlip(h);
+            handles.delete(id);
+        }
+    });
+}
+//# sourceMappingURL=blips-internal.js.map

package/dist/client/blips-internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blips-internal.js","sourceRoot":"","sources":["../../src/client/blips-internal.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,OAAO,EAAiB,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE1C,SAAS,IAAI,CAAC,CAAW;IACxB,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QAAE,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1D,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;QAAE,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;QAAE,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,CAAC,CAAC,UAAU;QAAE,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACb,2BAA2B,CAAC,QAAQ,CAAC,CAAC;QACtC,mCAAmC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC7C,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,oBAAoB;IACnC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAW,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAU,EAAE,EAAE;QACpC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACrB,UAAU,CAAC,CAAC,CAAC,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/client/core.d.ts

@@ -0,0 +1,18 @@
+import { Vector3 } from "../shared";
+import { LocalPlayer } from "./entities/local-player";
+import { EventManager } from "./managers/event-manager";
+import { GameObjectPool } from "./managers/object-pool";
+import { PedPool } from "./managers/ped-pool";
+import { ClientPlayerPool } from "./managers/player-pool";
+import { VehiclePool } from "./managers/vehicle-pool";
+export declare class Core {
+    readonly events: EventManager;
+    readonly player: LocalPlayer;
+    readonly Vector3: typeof Vector3;
+    readonly players: ClientPlayerPool;
+    readonly vehicles: VehiclePool;
+    readonly peds: PedPool;
+    readonly objects: GameObjectPool;
+    constructor();
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/client/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/client/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,qBAAa,IAAI;IAChB,QAAQ,CAAC,MAAM,eAAsB;IACrC,QAAQ,CAAC,MAAM,cAAqB;IACpC,QAAQ,CAAC,OAAO,iBAAW;IAG3B,QAAQ,CAAC,OAAO,mBAA0B;IAC1C,QAAQ,CAAC,QAAQ,cAAqB;IACtC,QAAQ,CAAC,IAAI,UAAiB;IAC9B,QAAQ,CAAC,OAAO,iBAAwB;;CAMxC"}

package/dist/client/core.js

@@ -0,0 +1,24 @@
+import { Vector3 } from "../shared";
+import { registerBlipHandlers } from "./blips-internal";
+import { LocalPlayer } from "./entities/local-player";
+import { registerInternalHandlers } from "./internal";
+import { EventManager } from "./managers/event-manager";
+import { GameObjectPool } from "./managers/object-pool";
+import { PedPool } from "./managers/ped-pool";
+import { ClientPlayerPool } from "./managers/player-pool";
+import { VehiclePool } from "./managers/vehicle-pool";
+export class Core {
+    events = new EventManager();
+    player = new LocalPlayer();
+    Vector3 = Vector3;
+    // Pools
+    players = new ClientPlayerPool();
+    vehicles = new VehiclePool();
+    peds = new PedPool();
+    objects = new GameObjectPool();
+    constructor() {
+        registerInternalHandlers();
+        registerBlipHandlers();
+    }
+}
+//# sourceMappingURL=core.js.map

package/dist/client/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/client/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,OAAO,IAAI;IACP,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAC5B,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;IAC3B,OAAO,GAAG,OAAO,CAAC;IAE3B,QAAQ;IACC,OAAO,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACjC,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;IACrB,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;IAExC;QACC,wBAAwB,EAAE,CAAC;QAC3B,oBAAoB,EAAE,CAAC;IACxB,CAAC;CACD"}

package/dist/client/entities/entity.d.ts

@@ -0,0 +1,24 @@
+import { type IVector3, Vector3 } from "../../shared";
+export declare class Entity {
+    readonly handle: number;
+    constructor(handle: number);
+    get exists(): boolean;
+    get model(): number;
+    get isNetworked(): boolean;
+    get netId(): number;
+    get position(): Vector3;
+    set position(v: IVector3);
+    get rotation(): Vector3;
+    set rotation(v: IVector3);
+    get heading(): number;
+    set heading(v: number);
+    get health(): number;
+    set health(v: number);
+    freeze(toggle: boolean): void;
+    setCollision(toggle: boolean): void;
+    setAlpha(alpha: number): void;
+    resetAlpha(): void;
+    distanceTo(other: Entity | IVector3): number;
+    delete(): void;
+}
+//# sourceMappingURL=entity.d.ts.map

package/dist/client/entities/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../src/client/entities/entity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEtD,qBAAa,MAAM;aACU,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;IAE1C,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAEvB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAEvB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,OAAO,CAAC,CAAC,EAAE,MAAM,EAEpB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM,EAEnB;IAED,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAI7B,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAInC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B,UAAU,IAAI,IAAI;IAIlB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM;IAK5C,MAAM,IAAI,IAAI;CAGd"}

package/dist/client/entities/entity.js

@@ -0,0 +1,64 @@
+/// <reference types="@citizenfx/client" />
+import { Vector3 } from "../../shared";
+export class Entity {
+    handle;
+    constructor(handle) {
+        this.handle = handle;
+    }
+    get exists() {
+        return DoesEntityExist(this.handle);
+    }
+    get model() {
+        return GetEntityModel(this.handle);
+    }
+    get isNetworked() {
+        return NetworkGetEntityIsNetworked(this.handle);
+    }
+    get netId() {
+        return NetworkGetNetworkIdFromEntity(this.handle);
+    }
+    get position() {
+        return Vector3.from(GetEntityCoords(this.handle, false));
+    }
+    set position(v) {
+        SetEntityCoords(this.handle, v.x, v.y, v.z, false, false, false, false);
+    }
+    get rotation() {
+        return Vector3.from(GetEntityRotation(this.handle, 2));
+    }
+    set rotation(v) {
+        SetEntityRotation(this.handle, v.x, v.y, v.z, 2, true);
+    }
+    get heading() {
+        return GetEntityHeading(this.handle);
+    }
+    set heading(v) {
+        SetEntityHeading(this.handle, v);
+    }
+    get health() {
+        return GetEntityHealth(this.handle);
+    }
+    set health(v) {
+        SetEntityHealth(this.handle, v);
+    }
+    freeze(toggle) {
+        FreezeEntityPosition(this.handle, toggle);
+    }
+    setCollision(toggle) {
+        SetEntityCollision(this.handle, toggle, true);
+    }
+    setAlpha(alpha) {
+        SetEntityAlpha(this.handle, alpha, false);
+    }
+    resetAlpha() {
+        ResetEntityAlpha(this.handle);
+    }
+    distanceTo(other) {
+        const p = other instanceof Entity ? other.position : other;
+        return this.position.distanceTo(Vector3.from(p));
+    }
+    delete() {
+        DeleteEntity(this.handle);
+    }
+}
+//# sourceMappingURL=entity.js.map

package/dist/client/entities/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../src/client/entities/entity.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,EAAiB,OAAO,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,OAAO,MAAM;IACU;IAA5B,YAA4B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE9C,IAAI,MAAM;QACT,OAAO,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,KAAK;QACR,OAAO,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,WAAW;QACd,OAAO,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,KAAK;QACR,OAAO,6BAA6B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,QAAQ;QACX,OAAO,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,QAAQ,CAAC,CAAW;QACvB,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,QAAQ;QACX,OAAO,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,QAAQ,CAAC,CAAW;QACvB,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,OAAO;QACV,OAAO,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,OAAO,CAAC,CAAS;QACpB,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,MAAM;QACT,OAAO,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,MAAM,CAAC,CAAS;QACnB,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,MAAe;QACrB,oBAAoB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,YAAY,CAAC,MAAe;QAC3B,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,QAAQ,CAAC,KAAa;QACrB,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,UAAU;QACT,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,UAAU,CAAC,KAAwB;QAClC,MAAM,CAAC,GAAG,KAAK,YAAY,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;QAC3D,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,MAAM;QACL,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;CACD"}

package/dist/client/entities/local-player.d.ts

@@ -0,0 +1,8 @@
+import { Ped } from "./ped";
+import { Vehicle } from "./vehicle";
+export declare class LocalPlayer extends Ped {
+    constructor();
+    get serverId(): number;
+    get currentVehicle(): Vehicle | null;
+}
+//# sourceMappingURL=local-player.d.ts.map

package/dist/client/entities/local-player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-player.d.ts","sourceRoot":"","sources":["../../../src/client/entities/local-player.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,qBAAa,WAAY,SAAQ,GAAG;;IAKnC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,cAAc,IAAI,OAAO,GAAG,IAAI,CAGnC;CACD"}

package/dist/client/entities/local-player.js

@@ -0,0 +1,15 @@
+import { Ped } from "./ped";
+import { Vehicle } from "./vehicle";
+export class LocalPlayer extends Ped {
+    constructor() {
+        super(PlayerPedId());
+    }
+    get serverId() {
+        return GetPlayerServerId(PlayerId());
+    }
+    get currentVehicle() {
+        const veh = GetVehiclePedIsIn(this.handle, false);
+        return veh !== 0 ? new Vehicle(veh) : null;
+    }
+}
+//# sourceMappingURL=local-player.js.map

package/dist/client/entities/local-player.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-player.js","sourceRoot":"","sources":["../../../src/client/entities/local-player.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,OAAO,WAAY,SAAQ,GAAG;IACnC;QACC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,QAAQ;QACX,OAAO,iBAAiB,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,cAAc;QACjB,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAClD,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC;CACD"}

package/dist/client/entities/object.d.ts

@@ -0,0 +1,14 @@
+import type { IVector3 } from "../../shared";
+import { Entity } from "./entity";
+export declare class GameObject extends Entity {
+    get hasBeenBroken(): boolean;
+    get isVisible(): boolean;
+    markForDeletion(): void;
+    placeOnGroundProperly(): void;
+    placeOnGroundOrObjectProperly(): void;
+    setActivatePhysicsAsSoonAsItIsUnfrozen(toggle: boolean): void;
+    setPhysicsParams(mass: number, gravityFactor: number, linearC: number, linearV: number, linearV2: number, angularC: number, angularV: number, angularV2: number, p9: number, maxAngSpeed: number, buoyancyFactor: number): void;
+    setTargetable(toggle: boolean): void;
+    slide(to: IVector3, speed: IVector3, collision: boolean): boolean;
+}
+//# sourceMappingURL=object.d.ts.map

package/dist/client/entities/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../../src/client/entities/object.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,qBAAa,UAAW,SAAQ,MAAM;IACrC,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,eAAe,IAAI,IAAI;IAIvB,qBAAqB,IAAI,IAAI;IAI7B,6BAA6B,IAAI,IAAI;IAIrC,sCAAsC,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAI7D,gBAAgB,CACf,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACpB,IAAI;IAiBP,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIpC,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO;CAYjE"}

package/dist/client/entities/object.js

@@ -0,0 +1,32 @@
+/// <reference types="@citizenfx/client" />
+import { Entity } from "./entity";
+export class GameObject extends Entity {
+    get hasBeenBroken() {
+        return HasObjectBeenBroken(this.handle);
+    }
+    get isVisible() {
+        return IsObjectVisible(this.handle);
+    }
+    markForDeletion() {
+        MarkObjectForDeletion(this.handle);
+    }
+    placeOnGroundProperly() {
+        PlaceObjectOnGroundProperly(this.handle);
+    }
+    placeOnGroundOrObjectProperly() {
+        PlaceObjectOnGroundOrObjectProperly(this.handle);
+    }
+    setActivatePhysicsAsSoonAsItIsUnfrozen(toggle) {
+        SetActivateObjectPhysicsAsSoonAsItIsUnfrozen(this.handle, toggle);
+    }
+    setPhysicsParams(mass, gravityFactor, linearC, linearV, linearV2, angularC, angularV, angularV2, p9, maxAngSpeed, buoyancyFactor) {
+        SetObjectPhysicsParams(this.handle, mass, gravityFactor, linearC, linearV, linearV2, angularC, angularV, angularV2, p9, maxAngSpeed, buoyancyFactor);
+    }
+    setTargetable(toggle) {
+        SetObjectTargettable(this.handle, toggle);
+    }
+    slide(to, speed, collision) {
+        return SlideObject(this.handle, to.x, to.y, to.z, speed.x, speed.y, speed.z, collision);
+    }
+}
+//# sourceMappingURL=object.js.map

package/dist/client/entities/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../src/client/entities/object.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAG3C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,OAAO,UAAW,SAAQ,MAAM;IACrC,IAAI,aAAa;QAChB,OAAO,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,SAAS;QACZ,OAAO,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,eAAe;QACd,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,qBAAqB;QACpB,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,6BAA6B;QAC5B,mCAAmC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,sCAAsC,CAAC,MAAe;QACrD,4CAA4C,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,gBAAgB,CACf,IAAY,EACZ,aAAqB,EACrB,OAAe,EACf,OAAe,EACf,QAAgB,EAChB,QAAgB,EAChB,QAAgB,EAChB,SAAiB,EACjB,EAAU,EACV,WAAmB,EACnB,cAAsB;QAEtB,sBAAsB,CACrB,IAAI,CAAC,MAAM,EACX,IAAI,EACJ,aAAa,EACb,OAAO,EACP,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,EAAE,EACF,WAAW,EACX,cAAc,CACd,CAAC;IACH,CAAC;IAED,aAAa,CAAC,MAAe;QAC5B,oBAAoB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,EAAY,EAAE,KAAe,EAAE,SAAkB;QACtD,OAAO,WAAW,CACjB,IAAI,CAAC,MAAM,EACX,EAAE,CAAC,CAAC,EACJ,EAAE,CAAC,CAAC,EACJ,EAAE,CAAC,CAAC,EACJ,KAAK,CAAC,CAAC,EACP,KAAK,CAAC,CAAC,EACP,KAAK,CAAC,CAAC,EACP,SAAS,CACT,CAAC;IACH,CAAC;CACD"}

package/dist/client/entities/ped.d.ts

@@ -0,0 +1,8 @@
+import { Entity } from "./entity";
+export declare class Ped extends Entity {
+    get isInVehicle(): boolean;
+    get armour(): number;
+    set armour(v: number);
+    get isDead(): boolean;
+}
+//# sourceMappingURL=ped.d.ts.map

package/dist/client/entities/ped.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ped.d.ts","sourceRoot":"","sources":["../../../src/client/entities/ped.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,qBAAa,GAAI,SAAQ,MAAM;IAC9B,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM,EAEnB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;CACD"}

package/dist/client/entities/ped.js

@@ -0,0 +1,16 @@
+import { Entity } from "./entity";
+export class Ped extends Entity {
+    get isInVehicle() {
+        return IsPedInAnyVehicle(this.handle, false);
+    }
+    get armour() {
+        return GetPedArmour(this.handle);
+    }
+    set armour(v) {
+        SetPedArmour(this.handle, v);
+    }
+    get isDead() {
+        return IsPedDeadOrDying(this.handle, true);
+    }
+}
+//# sourceMappingURL=ped.js.map

package/dist/client/entities/ped.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ped.js","sourceRoot":"","sources":["../../../src/client/entities/ped.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,OAAO,GAAI,SAAQ,MAAM;IAC9B,IAAI,WAAW;QACd,OAAO,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,MAAM;QACT,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,MAAM,CAAC,CAAS;QACnB,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,MAAM;QACT,OAAO,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;CACD"}

package/dist/client/entities/remote-player.d.ts

@@ -0,0 +1,9 @@
+export declare class RemotePlayer {
+    readonly id: number;
+    constructor(id: number);
+    get serverId(): number;
+    get name(): string;
+    get pedHandle(): number;
+    get isLocal(): boolean;
+}
+//# sourceMappingURL=remote-player.d.ts.map

package/dist/client/entities/remote-player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-player.d.ts","sourceRoot":"","sources":["../../../src/client/entities/remote-player.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;aACI,EAAE,EAAE,MAAM;gBAAV,EAAE,EAAE,MAAM;IAEtC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;CACD"}

package/dist/client/entities/remote-player.js

@@ -0,0 +1,20 @@
+/// <reference types="@citizenfx/client" />
+export class RemotePlayer {
+    id;
+    constructor(id) {
+        this.id = id;
+    }
+    get serverId() {
+        return GetPlayerServerId(this.id);
+    }
+    get name() {
+        return GetPlayerName(this.id);
+    }
+    get pedHandle() {
+        return GetPlayerPed(this.id);
+    }
+    get isLocal() {
+        return this.id === PlayerId();
+    }
+}
+//# sourceMappingURL=remote-player.js.map

package/dist/client/entities/remote-player.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-player.js","sourceRoot":"","sources":["../../../src/client/entities/remote-player.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,MAAM,OAAO,YAAY;IACI;IAA5B,YAA4B,EAAU;QAAV,OAAE,GAAF,EAAE,CAAQ;IAAG,CAAC;IAE1C,IAAI,QAAQ;QACX,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,IAAI;QACP,OAAO,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,SAAS;QACZ,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;IAC/B,CAAC;CACD"}