@armoury/fivem-framework-server 0.0.0-stage → 1.0.7

package/dist/cjs/server/services/session/server-session.service.js

@@ -0,0 +1,271 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var ServerSessionService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerSessionService = void 0;
+const injection_js_1 = require("injection-js");
+const utils_1 = require("../../../utils/utils");
+const decorators_1 = require("../../../decorators");
+let ServerSessionService = ServerSessionService_1 = class ServerSessionService {
+    get players() {
+        return Array.from(this._sessions.keys());
+    }
+    get authenticatedPlayers() {
+        return Array.from(this._sessions.entries())
+            .filter(([, session]) => session.id)
+            .map(([playerId,]) => playerId);
+    }
+    constructor(_sessionItems) {
+        var _a;
+        this._sessionItems = _sessionItems;
+        this._sessions = new Map();
+        this._untrackedSessionItems = [];
+        this._sessionItems = (_a = _sessionItems === null || _sessionItems === void 0 ? void 0 : _sessionItems.filter((item) => !!item)) !== null && _a !== void 0 ? _a : [];
+        if (!Cfx.exports['oxmysql']) {
+            console.error(`[Armoury (${Cfx.Server.GetCurrentResourceName()}):] Could not find the 'oxmysql' resource. Armoury's session service can't work without it. Did you forget to load it?`);
+            return;
+        }
+    }
+    /**
+     * Registers an account.
+     * @param playerId The playerId (NOT from the database) of this player
+     * @param accountName The account name of this player
+     * @param hashedPassword The hashed password of this account
+     * @param email The email of this account
+     * @returns The SQL ID of the newly-created account
+     */
+    async register(playerId, accountName, hashedPassword, email) {
+        const accountId = await Cfx.exports['oxmysql'].insert_async('INSERT INTO `accounts`(`name`, `password`, `email`) VALUES (?, ?, ?)', [accountName, hashedPassword, email]);
+        this._sessions.set(playerId, { accountId });
+        return accountId;
+    }
+    /**
+     * Logs into an account
+     * @param playerId The playerId (NOT from the database) of this player
+     * @param email The email of the account
+     * @param hashedPassword The hashed password fo this account
+     * @returns Account data for this account
+     */
+    async login(playerId, email, hashedPassword) {
+        const result = await Cfx.exports['oxmysql'].single_async('SELECT * FROM `accounts` WHERE email=? AND password=?', [email, hashedPassword]);
+        this._sessions.set(playerId, { accountId: result.id });
+        return result;
+    }
+    /**
+     * Fetches all the characters related to the provided account
+     * @param playerId The playerId (NOT from the database) of this player
+     * @param accountId The accountId of the
+     * @returns Data for all characters on the given account
+     */
+    async fetch(playerId, accountId) {
+        var _a;
+        accountId = accountId !== null && accountId !== void 0 ? accountId : (_a = this._sessions.get(playerId)) === null || _a === void 0 ? void 0 : _a.accountId;
+        return await global.exports['oxmysql'].query_async(`SELECT * FROM players WHERE accountId = ?`, [accountId]);
+    }
+    /**
+     * Loads the entire character given a character ID
+     * @param playerId The playerId (NOT from the database) of this player
+     * @param characterId The character's SQL ID
+     * @returns Data for the given characterId
+     */
+    async load(playerId, characterId) {
+        var _a;
+        if (!this._sessions.has(playerId)) {
+            throw new Error('No session has been found for that user.');
+        }
+        const session = await global.exports['oxmysql'].single_async('SELECT * FROM `players` WHERE id=? AND accountId=?', [characterId, (_a = this._sessions.get(playerId)) === null || _a === void 0 ? void 0 : _a.accountId]);
+        Array.from(Object.entries(session))
+            .map(([key,]) => { var _a; return (_a = this._sessionItems) === null || _a === void 0 ? void 0 : _a.find((sessionItem) => sessionItem.name === key); })
+            .filter((sessionItem) => !!sessionItem)
+            .forEach(async (sessionItem) => {
+            var _a, _b, _c, _d;
+            console.log('for sessionItem', sessionItem.name, 'the value is', (_b = await (sessionItem === null || sessionItem === void 0 ? void 0 : sessionItem.load((_a = this._sessions.get(playerId)) === null || _a === void 0 ? void 0 : _a.accountId, characterId, session[sessionItem === null || sessionItem === void 0 ? void 0 : sessionItem.name]))) !== null && _b !== void 0 ? _b : session[sessionItem === null || sessionItem === void 0 ? void 0 : sessionItem.name].value);
+            this.setPlayerInfo(playerId, sessionItem.name, (_d = await (sessionItem === null || sessionItem === void 0 ? void 0 : sessionItem.load((_c = this._sessions.get(playerId)) === null || _c === void 0 ? void 0 : _c.accountId, characterId, session[sessionItem === null || sessionItem === void 0 ? void 0 : sessionItem.name]))) !== null && _d !== void 0 ? _d : session[sessionItem === null || sessionItem === void 0 ? void 0 : sessionItem.name].value);
+        });
+        this._sessions.set(playerId, Object.assign(Object.assign({}, this._sessions.get(playerId)), { id: characterId }));
+        return session;
+    }
+    /**
+     * Creates a character
+     * @param playerId
+     * @param accountName
+     * @param hashedPassword
+     * @param email
+     * @returns
+     */
+    async create(playerId, accountId) {
+        var _a;
+        accountId = accountId !== null && accountId !== void 0 ? accountId : (_a = this._sessions.get(playerId)) === null || _a === void 0 ? void 0 : _a.accountId;
+        const characterId = await Cfx.exports['oxmysql'].insert_async('INSERT INTO `players`(`accountId`) VALUES (?)', [accountId]);
+        this._sessions.set(playerId, { accountId });
+        return characterId;
+    }
+    setPlayerInfo(playerId, stat, value, ...args) {
+        const updater = new SessionUpdater(playerId).from(stat, value, ...args);
+        updater.execute(this.getPlayerInfo(playerId, 'accountId'), this.getPlayerInfo(playerId, 'id'), this._sessionItems);
+        const untrackedItems = updater.items
+            .filter((item) => {
+            var _a;
+            return !this._untrackedSessionItems.includes(item.stat)
+                && !((_a = this._sessionItems) === null || _a === void 0 ? void 0 : _a.some((sessionItem) => sessionItem.name === item.stat));
+        });
+        if (untrackedItems.length) {
+            this._untrackedSessionItems.push(...untrackedItems.map((item) => item.stat));
+        }
+    }
+    setPlayerCash(playerId, value, options) {
+        return this.setPlayerInfo(playerId, 'cash', value, options);
+    }
+    givePlayerCash(playerId, value, options) {
+        return this.setPlayerCash(playerId, this.getPlayerCash(playerId) + value, options);
+    }
+    getPlayerCash(playerId) {
+        return this.getPlayerInfo(playerId, 'cash');
+    }
+    saveCritical(playerId) {
+        var _a, _b;
+        const criticalStats = (_b = (_a = this._sessionItems) === null || _a === void 0 ? void 0 : _a.filter((sessionItem) => sessionItem.critical)) === null || _b === void 0 ? void 0 : _b.map((sessionItem) => sessionItem.name);
+        console.log(`${Cfx.Server.GetCurrentResourceName()}: Critical keys are`, criticalStats, 'playerId is', playerId);
+        this.setPlayerInfo(playerId, criticalStats[0], this.getPlayerInfo(playerId, criticalStats[0]), ...criticalStats.slice(1).reduce((prev, curr) => [
+            ...prev,
+            curr,
+            this.getPlayerInfo(playerId, curr)
+        ], []), {
+            executeSqlCommand: true
+        });
+    }
+    getPlayerInfo(playerId, stat) {
+        let value = Cfx.Server.GetConvar(`${playerId}_PI_${stat}`, '-1');
+        if ((0, utils_1.isJSON)(value.toString())) {
+            value = JSON.parse(value, function (_k, v) {
+                return typeof v === 'object' || isNaN(v) ? v : Number(v);
+            });
+        }
+        return value;
+    }
+    clearPlayerInfo(playerId) {
+        var _a;
+        [...(_a = this._sessionItems) === null || _a === void 0 ? void 0 : _a.map((sessionItem) => sessionItem.name), ...this._untrackedSessionItems]
+            .forEach((prop) => {
+            Cfx.Server.SetConvarReplicated(`${playerId}_PI_${prop}`, '-1');
+            Cfx.Server.SetConvarReplicated(`${playerId}_PI_${prop}_lastUpdate`, '-1');
+        });
+    }
+    onResourceStart(resource) {
+        var _a, _b;
+        if (resource !== Cfx.Server.GetCurrentResourceName()) {
+            if (Cfx.exports[resource].exchangeSessionItems) {
+                console.log(`[Armoury:] Resource (${resource}) has started. Attempting to exchange session items with it..`);
+                this.exchangeSessionItems((_b = Cfx.exports[resource].exchangeSessionItems((_a = this._sessionItems) !== null && _a !== void 0 ? _a : [])) !== null && _b !== void 0 ? _b : []);
+            }
+        }
+    }
+    exchangeSessionItems(items) {
+        var _a, _b;
+        items.forEach((item) => {
+            var _a, _b;
+            if (!((_a = this._sessionItems) === null || _a === void 0 ? void 0 : _a.some((sessionItem) => sessionItem.name === item.name))) {
+                (_b = this._sessionItems) === null || _b === void 0 ? void 0 : _b.push(item);
+            }
+        });
+        console.log(`[${Cfx.Server.GetCurrentResourceName()}:] My updated session items are now`, (_a = this._sessionItems) !== null && _a !== void 0 ? _a : []);
+        return (_b = this._sessionItems) !== null && _b !== void 0 ? _b : [];
+    }
+    static withDefaults() {
+        return ({
+            provide: ServerSessionService_1,
+            useFactory: (sessionItems) => new ServerSessionService_1(sessionItems || []),
+            deps: ['sessionItems'],
+        });
+    }
+    static withItems(...items) {
+        return [
+            ...items.map((sessionItem) => ({
+                provide: 'sessionItems',
+                useValue: new sessionItem(),
+                multi: true,
+            })),
+            ServerSessionService_1.withDefaults()
+        ];
+    }
+};
+exports.ServerSessionService = ServerSessionService;
+__decorate([
+    (0, decorators_1.EventListener)({ eventName: 'onResourceStart', direction: decorators_1.EVENT_DIRECTIONS.CLIENT_TO_CLIENT }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", void 0)
+], ServerSessionService.prototype, "onResourceStart", null);
+__decorate([
+    (0, decorators_1.Export)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Array]),
+    __metadata("design:returntype", Array)
+], ServerSessionService.prototype, "exchangeSessionItems", null);
+exports.ServerSessionService = ServerSessionService = ServerSessionService_1 = __decorate([
+    (0, injection_js_1.Injectable)(),
+    __param(0, (0, injection_js_1.Optional)()),
+    __param(0, (0, injection_js_1.Inject)('sessionItems')),
+    __metadata("design:paramtypes", [Array])
+], ServerSessionService);
+class SessionUpdater {
+    constructor(playerId) {
+        this.playerId = playerId;
+        this.items = [];
+        this.options = null;
+    }
+    from(...statsAndValues) {
+        if (statsAndValues.length % 2 !== 0 && typeof statsAndValues.slice(-1)[0] === 'object') {
+            this.options = statsAndValues.slice(-1)[0];
+        }
+        for (let i = 0; i < statsAndValues.length; i += 2) {
+            if (typeof statsAndValues[i] === 'string' && !!statsAndValues[i + 1]) {
+                this.add(statsAndValues[i], statsAndValues[i + 1]);
+            }
+        }
+        return this;
+    }
+    add(stat, value) {
+        this.items.push({ stat, value });
+        return this;
+    }
+    execute(accountId, characterId, sessionItems) {
+        var _a;
+        this.items.forEach((item) => {
+            let value = item.value;
+            const correspondingSessionItem = sessionItems.find((sessionItem) => sessionItem.name === item.stat);
+            if (correspondingSessionItem) {
+                value = correspondingSessionItem.compute(this.playerId, item.value);
+            }
+            Cfx.Server.SetConvarReplicated(`${this.playerId}_PI_${item.stat}`, Array.isArray(value) || typeof value === 'object'
+                ? JSON.stringify(value)
+                : value.toString());
+            Cfx.Server.SetConvarReplicated(`${this.playerId}_PI_${item.stat}_lastUpdate`, new Date().getTime().toString());
+        });
+        if ((_a = this.options) === null || _a === void 0 ? void 0 : _a.executeSqlCommand) {
+            const syncableItems = this.items.filter((item) => {
+                var _a, _b;
+                return sessionItems.some((sessionItem) => sessionItem.name === item.stat) && !((_b = (_a = this.options) === null || _a === void 0 ? void 0 : _a.ignoreSqlCommandFor) === null || _b === void 0 ? void 0 : _b.includes(item.stat));
+            });
+            if (syncableItems.length) {
+                const predicate = (item) => { var _a; return (_a = sessionItems.find((sessionItem) => sessionItem.name === item.stat)) === null || _a === void 0 ? void 0 : _a.save; };
+                const simpleSyncableItems = syncableItems.filter((item) => !predicate(item)).filter((item) => !!item && item.value != null);
+                console.log('simpleSyncableItems are', simpleSyncableItems);
+                Cfx.exports['oxmysql'].update_async(`UPDATE \`players\` SET ${simpleSyncableItems.map((item) => `${item.stat} = ?`).join(', ')} WHERE id = ?`, [...simpleSyncableItems.map((item) => JSON.stringify(item.value)), characterId]);
+                const nonSimpleSyncableItems = syncableItems.filter((item) => predicate(item));
+                nonSimpleSyncableItems.forEach((item) => sessionItems.find((sessionItem) => sessionItem.name === item.stat).save(accountId, characterId, item.value));
+            }
+        }
+    }
+}

package/dist/cjs/shared/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./models"), exports);

package/dist/cjs/shared/models/account.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/shared/models/character.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/shared/models/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./account"), exports);
+__exportStar(require("./character"), exports);

package/dist/cjs/utils/utils.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isJSON = exports.numberWithCommas = exports.waitUntilThenDo = exports.isPlayerInRangeOfPoint = exports.isPlayerInArea = exports.Delay = exports.toTitleCase = exports.fromThousandsString = exports.toThousandsString = exports.phoneFormatted = exports.isPositionIn2DArea = exports.getRandomPositionInsideArea = exports.calculateDistanceInKm = exports.calculateDistance = void 0;
+const Delay = (ms) => new Promise(res => setTimeout(res, ms));
+exports.Delay = Delay;
+const isPlayerInArea = (playerPosX, playerPosY, playerPosZ, areaMinX, areaMinY, areaMinZ, areaMaxX, areaMaxY, areaMaxZ) => {
+    return playerPosX >= areaMinX && playerPosX <= areaMaxX && playerPosY >= areaMinY && playerPosY <= areaMaxY && playerPosZ >= areaMinZ && playerPosZ <= areaMaxZ;
+};
+exports.isPlayerInArea = isPlayerInArea;
+const isPlayerInRangeOfPoint = (playerPosX, playerPosY, playerPosZ, pointX, pointY, pointZ, range) => {
+    return (0, exports.calculateDistance)([playerPosX, playerPosY, playerPosZ, pointX, pointY, pointZ]) <= range;
+};
+exports.isPlayerInRangeOfPoint = isPlayerInRangeOfPoint;
+const waitUntilThenDo = async (condition, func) => {
+    let attempts = 0;
+    while (!condition()) {
+        if (attempts > 50) {
+            return;
+        }
+        await Delay(10);
+    }
+    func();
+};
+exports.waitUntilThenDo = waitUntilThenDo;
+const calculateDistance = (pos) => {
+    var a = pos[3] - pos[0];
+    var b = pos[4] - pos[1];
+    var c = pos[5] - pos[2];
+    return Math.hypot(a, b, c);
+};
+exports.calculateDistance = calculateDistance;
+const calculateDistanceInKm = (pos) => {
+    var a = pos[3] - pos[0];
+    var b = pos[4] - pos[1];
+    var c = pos[5] - pos[2];
+    return Math.hypot(a, b, c) * 0.004;
+};
+exports.calculateDistanceInKm = calculateDistanceInKm;
+const getRandomPositionInsideArea = (x1, x2, y1, y2) => {
+    const sortedXs = [x1, x2].sort((current, previous) => current <= previous ? -1 : 1);
+    const sortedYs = [y1, y2].sort((current, previous) => current <= previous ? -1 : 1);
+    const [lowestX, highestX] = [sortedXs[0], sortedXs.slice(-1)[0]];
+    const [lowestY, highestY] = [sortedYs[0], sortedYs.slice(-1)[0]];
+    return [lowestX + (Math.random() * (highestX - lowestX)), lowestY + (Math.random() * (highestY - lowestY))];
+};
+exports.getRandomPositionInsideArea = getRandomPositionInsideArea;
+const isPositionIn2DArea = (x, y, x1, x2, y1, y2) => {
+    const sortedXs = [x1, x2].sort((current, previous) => current <= previous ? -1 : 1);
+    const sortedYs = [y1, y2].sort((current, previous) => current <= previous ? -1 : 1);
+    const [lowestX, highestX] = [sortedXs[0], sortedXs.slice(-1)[0]];
+    const [lowestY, highestY] = [sortedYs[0], sortedYs.slice(-1)[0]];
+    return x >= lowestX && x <= highestX && y >= lowestY && y <= highestY;
+};
+exports.isPositionIn2DArea = isPositionIn2DArea;
+const numberWithCommas = (x) => {
+    return x.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+};
+exports.numberWithCommas = numberWithCommas;
+const isJSON = (str) => {
+    if (/^\s*$/.test(str))
+        return false;
+    str = str.replace(/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g, '@');
+    str = str.replace(/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, ']');
+    str = str.replace(/(?:^|:|,)(?:\s*\[)+/g, '');
+    return (/^[\],:{}\s]*$/).test(str);
+};
+exports.isJSON = isJSON;
+const phoneFormatted = (phone) => {
+    const filteredValue = phone.toString().replace('-', '');
+    if (filteredValue.length > 3) {
+        return `${filteredValue.substring(0, 3)}-${filteredValue.substring(3)}`;
+    }
+    return phone.toString();
+};
+exports.phoneFormatted = phoneFormatted;
+const suffixes = ['k', 'M', 'G', 'T', 'P', 'E'];
+const toThousandsString = (input, args) => {
+    let isNegative = input < 0;
+    input = Math.abs(input);
+    if (Number.isNaN(input)) {
+        return null;
+    }
+    if (input < 1000) {
+        return input;
+    }
+    const exp = Math.floor(Math.log(input) / Math.log(1000));
+    return ((isNegative ? '-' : '') + (input / Math.pow(1000, exp)).toFixed(args) + suffixes[exp - 1]);
+};
+exports.toThousandsString = toThousandsString;
+const fromThousandsString = (input) => {
+    var _a;
+    const existingSuffix = (input.match(/[a-zA-Z]/) || []).pop() || '';
+    if (!existingSuffix) {
+        return Number(input);
+    }
+    const existingNumber = Number((_a = input.match(/\d+/)) === null || _a === void 0 ? void 0 : _a[0]);
+    return (existingNumber *
+        Math.pow(1000, 1 +
+            suffixes
+                .map((suffix) => suffix.toLowerCase())
+                .indexOf(existingSuffix.toLowerCase())));
+};
+exports.fromThousandsString = fromThousandsString;
+const toTitleCase = (str) => {
+    return str.replace(/\w\S*/g, function (txt) {
+        return txt.charAt(0).toUpperCase() + txt.substr(1).toLowerCase();
+    });
+};
+exports.toTitleCase = toTitleCase;

package/dist/esm/decorators/command.decorator.js

@@ -0,0 +1,33 @@
+import { DecoratorUtils } from "./decorator.utils";
+// TODO: adminLevelRequired is not supposed to be here. Move it to @armoury/fivem-gamemode
+export function Command(data) {
+    return function (target, propertyKey) {
+        Reflect.defineMetadata(`arm_command_${propertyKey}`, data, target);
+    };
+}
+export function Commands(target, _prototype, providers) {
+    DecoratorUtils.map(target, _prototype, providers !== null && providers !== void 0 ? providers : [])
+        .filter((mapping) => mapping.key.startsWith('arm_command_'))
+        .forEach((mapping) => {
+        var _a;
+        const rawCommandName = mapping.key.split('_').slice(2).join('_');
+        const keybinding = Reflect.getOwnMetadata('keybinding_' + rawCommandName, _prototype);
+        const commandName = `${keybinding ? '+' : ''}` + rawCommandName.toLowerCase() + (((_a = mapping.value) === null || _a === void 0 ? void 0 : _a.suffix) || '');
+        if (!Cfx.Client.IsDuplicityVersion()) {
+            Cfx.Client.RegisterCommand(commandName, (_source, args, _raw) => {
+                mapping.target[rawCommandName].apply(mapping.target, args);
+            }, false);
+        }
+        else {
+            Cfx.Server.RegisterCommand(commandName, (source, args, _raw) => {
+                var _a, _b;
+                // TODO: This conditional is not generic enough. This conditional should actually check a function given through an injection token.
+                if (((_a = mapping.value) === null || _a === void 0 ? void 0 : _a.adminLevelRequired) && Number(Cfx.exports['authentication'].getPlayerInfo(source, 'adminLevel')) < ((_b = mapping.value) === null || _b === void 0 ? void 0 : _b.adminLevelRequired)) {
+                    // TODO: Add error chat message OR some kind of visual notice here
+                    return;
+                }
+                mapping.target[rawCommandName].apply(mapping.target, [source, ...args]);
+            }, false);
+        }
+    });
+}

package/dist/esm/decorators/controller.decorator.js

@@ -0,0 +1,6 @@
+// TODO: Re-add translation logic
+export function Controller(data) {
+    return function (target) {
+        // Reflect.defineMetadata(`arm_export_${propertyKey}`, propertyKey, target);
+    };
+}

package/dist/esm/decorators/decorator.utils.js

@@ -0,0 +1,38 @@
+import { Commands } from "./command.decorator";
+import { EventListeners } from "./event-listener.decorator";
+import { Exports } from "./export.decorator";
+import { KeyBindings } from "./key-binding.decorator";
+import { UIListeners } from "./ui-listener.decorator";
+export class DecoratorUtils {
+    static map(target, _prototype, providers) {
+        return [
+            ...Reflect.getOwnMetadataKeys(_prototype)
+                .map((key) => ({ key, target, value: Reflect.getOwnMetadata(key, _prototype) })),
+            ...providers
+                ? providers.map((provider) => Reflect.getMetadataKeys(provider)
+                    .map((key) => ({
+                    key,
+                    target: provider,
+                    value: Reflect.getMetadata(key, provider)
+                }))).flat()
+                : []
+        ];
+    }
+}
+export function Decorate(instance, _prototype, providers, decorationType = DecorationType.SERVER) {
+    const relevantProvidersForClass = Object.values(instance)
+        .filter((provider) => typeof provider === 'object'
+        && Reflect.getMetadataKeys(provider).some((key) => key.startsWith('arm_')));
+    Commands(instance, _prototype, relevantProvidersForClass);
+    EventListeners(instance, _prototype, relevantProvidersForClass);
+    Exports(instance, _prototype, relevantProvidersForClass);
+    KeyBindings(instance, _prototype, relevantProvidersForClass);
+    if (decorationType === DecorationType.CLIENT) {
+        UIListeners(instance, _prototype, relevantProvidersForClass);
+    }
+}
+export var DecorationType;
+(function (DecorationType) {
+    DecorationType[DecorationType["SERVER"] = 0] = "SERVER";
+    DecorationType[DecorationType["CLIENT"] = 1] = "CLIENT";
+})(DecorationType || (DecorationType = {}));

package/dist/esm/decorators/event-listener.decorator.js

@@ -0,0 +1,59 @@
+import { DecoratorUtils } from "./decorator.utils";
+export function EventListener(data) {
+    return function (target, propertyKey) {
+        const eventName = (DEFAULT_EVENTS[propertyKey] || (data === null || data === void 0 ? void 0 : data.eventName));
+        const direction = (data === null || data === void 0 ? void 0 : data.direction) || EVENT_DIRECTIONS.CLIENT_TO_SERVER;
+        const type = (data === null || data === void 0 ? void 0 : data.type) || 'default';
+        Reflect.defineMetadata(`arm_eventListener_${propertyKey}`, { eventName, direction, type }, target);
+    };
+}
+export function EventListeners(target, _prototype, providers) {
+    DecoratorUtils.map(target, _prototype, providers !== null && providers !== void 0 ? providers : [])
+        .filter((mapping) => mapping.key.startsWith('arm_eventListener_'))
+        .forEach((mapping) => {
+        const { eventName, direction, type } = mapping.value;
+        const func = mapping.key.split('_').slice(2).join('_');
+        if (type === 'ui') {
+            Cfx.Client.RegisterNuiCallbackType(eventName);
+            Cfx.Client.on('__cfx_nui:' + eventName, (data, cb) => {
+                mapping.target[func].call(mapping.target, data);
+                cb('ok');
+            });
+        }
+        else {
+            switch (direction) {
+                case EVENT_DIRECTIONS.CLIENT_TO_CLIENT: {
+                    Cfx.Client.on(eventName, mapping.target[func].bind(mapping.target));
+                    break;
+                }
+                default: {
+                    Cfx.Server.onNet(eventName, mapping.target[func].bind(mapping.target));
+                    break;
+                }
+            }
+        }
+    });
+}
+export var EVENT_DIRECTIONS;
+(function (EVENT_DIRECTIONS) {
+    EVENT_DIRECTIONS[EVENT_DIRECTIONS["SERVER_TO_SERVER"] = 0] = "SERVER_TO_SERVER";
+    EVENT_DIRECTIONS[EVENT_DIRECTIONS["SERVER_TO_CLIENT"] = 1] = "SERVER_TO_CLIENT";
+    EVENT_DIRECTIONS[EVENT_DIRECTIONS["CLIENT_TO_SERVER"] = 2] = "CLIENT_TO_SERVER";
+    EVENT_DIRECTIONS[EVENT_DIRECTIONS["CLIENT_TO_CLIENT"] = 3] = "CLIENT_TO_CLIENT";
+})(EVENT_DIRECTIONS || (EVENT_DIRECTIONS = {}));
+// TODO: Refactor this, so resources can add to it
+export const DEFAULT_EVENTS = {
+    onAccountAuthenticate: 'authentication:account-success',
+    onPlayerConnect: 'playerJoining',
+    onPlayerDeath: 'armoury:onPlayerDeath',
+    onPlayerAuthenticate: 'authentication:player-authenticated',
+    onPlayerLogout: 'armoury:player-logout',
+    onPlayerDisconnect: 'playerDropped',
+    onResourceStop: 'onResourceStop',
+    onContextMenuItemPressed: 'armoury-overlay:context-menu-item-pressed',
+    onPlayerEnterVehicle: 'armoury:onPlayerEnterVehicle',
+    onPlayerExitVehicle: 'armoury:onPlayerExitVehicle',
+    onPlayerClientsidedCacheLoaded: 'armoury:player-resource-cache-loaded',
+    onPlayerStartTowVehicle: 'armoury:onPlayerStartTowVehicle',
+    onPlayerStopTowVehicle: 'armoury:onPlayerStopTowVehicle',
+};

package/dist/esm/decorators/export.decorator.js

@@ -0,0 +1,14 @@
+import { DecoratorUtils } from "./decorator.utils";
+export function Export() {
+    return function (target, propertyKey) {
+        Reflect.defineMetadata(`arm_export_${propertyKey}`, propertyKey, target);
+    };
+}
+export function Exports(target, _prototype, providers) {
+    DecoratorUtils.map(target, _prototype, providers !== null && providers !== void 0 ? providers : [])
+        .filter((mapping) => mapping.key.startsWith('arm_export_'))
+        .forEach((mapping) => {
+        const exportName = mapping.key.split('_').slice(2).join('_');
+        Cfx.exports(exportName, mapping.target[exportName].bind(mapping.target));
+    });
+}

package/dist/esm/decorators/index.js

@@ -0,0 +1,6 @@
+export { Command } from './command.decorator';
+export { Controller } from './controller.decorator';
+export { EventListener, EVENT_DIRECTIONS } from './event-listener.decorator';
+export { Export } from './export.decorator';
+export { KeyBinding } from './key-binding.decorator';
+export { UIListener } from './ui-listener.decorator';

package/dist/esm/decorators/key-binding.decorator.js

@@ -0,0 +1,25 @@
+import { DecoratorUtils } from "./decorator.utils";
+export function KeyBinding(data) {
+    return function (target, propertyKey) {
+        Reflect.defineMetadata(`arm_keybinding_${propertyKey}`, {
+            command: data.command,
+            description: data.description,
+            defaultMapper: data.defaultMapper,
+            key: data.key
+        }, target);
+    };
+}
+export function KeyBindings(target, _prototype, providers) {
+    DecoratorUtils.map(target, _prototype, providers !== null && providers !== void 0 ? providers : [])
+        .filter((mapping) => mapping.key.startsWith('arm_keybinding_'))
+        .forEach((mapping) => {
+        var _a, _b, _c, _d;
+        const keybindingName = mapping.key.split('_').slice(2).join('_');
+        const command = ((_a = mapping.value) === null || _a === void 0 ? void 0 : _a.command) || keybindingName;
+        if (!command) {
+            console.error(`Could not find any relevant command for key binding ${keybindingName}`);
+            return;
+        }
+        Cfx.Client.RegisterKeyMapping(`+${command.toLowerCase()}`, (_b = mapping.value) === null || _b === void 0 ? void 0 : _b.description, (_c = mapping.value) === null || _c === void 0 ? void 0 : _c.defaultMapper, (_d = mapping.value) === null || _d === void 0 ? void 0 : _d.key);
+    });
+}

package/dist/esm/decorators/ui-listener.decorator.js

@@ -0,0 +1,20 @@
+import { DecoratorUtils } from "./decorator.utils";
+export function UIListener(data) {
+    return function (target, propertyKey) {
+        const eventName = (data === null || data === void 0 ? void 0 : data.eventName) || propertyKey;
+        Reflect.defineMetadata(`arm_uiListener_${propertyKey}`, { eventName }, target);
+    };
+}
+export function UIListeners(target, _prototype, providers) {
+    DecoratorUtils.map(target, _prototype, providers !== null && providers !== void 0 ? providers : [])
+        .filter((mapping) => mapping.key.startsWith('arm_uiListener_'))
+        .forEach((mapping) => {
+        const { eventName } = mapping.value;
+        const func = mapping.key.split('_').slice(2).join('_');
+        Cfx.Client.RegisterNuiCallbackType(eventName);
+        Cfx.Client.on('__cfx_nui:' + eventName, (data, cb) => {
+            mapping.target[func].call(mapping.target, data);
+            cb('ok');
+        });
+    });
+}