@armoury/fivem-framework-common 0.0.0-stage → 1.0.8

package/dist/cjs/common/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/// <reference path = "../ambient.declarations.d.ts" />
+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 });
+exports.DecorationType = exports.Decorate = void 0;
+require("reflect-metadata");
+__exportStar(require("../shared"), exports);
+__exportStar(require("../decorators"), exports);
+var decorator_utils_1 = require("../decorators/decorator.utils");
+Object.defineProperty(exports, "Decorate", { enumerable: true, get: function () { return decorator_utils_1.Decorate; } });
+Object.defineProperty(exports, "DecorationType", { enumerable: true, get: function () { return decorator_utils_1.DecorationType; } });
+__exportStar(require("../utils"), exports);
+__exportStar(require("../utils/utils"), exports);

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

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Command = Command;
+exports.Commands = Commands;
+const decorator_utils_1 = require("./decorator.utils");
+// TODO: adminLevelRequired is not supposed to be here. Move it to @armoury/fivem-gamemode
+function Command(data) {
+    return function (target, propertyKey) {
+        Reflect.defineMetadata(`arm_command_${propertyKey}`, data, target);
+    };
+}
+function Commands(target, _prototype, providers) {
+    decorator_utils_1.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/cjs/decorators/controller.decorator.js

@@ -0,0 +1,9 @@
+"use strict";
+// TODO: Re-add translation logic
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Controller = Controller;
+function Controller(data) {
+    return function (target) {
+        // Reflect.defineMetadata(`arm_export_${propertyKey}`, propertyKey, target);
+    };
+}

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

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecorationType = exports.DecoratorUtils = void 0;
+exports.Decorate = Decorate;
+const command_decorator_1 = require("./command.decorator");
+const event_listener_decorator_1 = require("./event-listener.decorator");
+const export_decorator_1 = require("./export.decorator");
+const key_binding_decorator_1 = require("./key-binding.decorator");
+const ui_listener_decorator_1 = require("./ui-listener.decorator");
+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()
+                : []
+        ];
+    }
+}
+exports.DecoratorUtils = DecoratorUtils;
+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_')));
+    (0, command_decorator_1.Commands)(instance, _prototype, relevantProvidersForClass);
+    (0, event_listener_decorator_1.EventListeners)(instance, _prototype, relevantProvidersForClass);
+    (0, export_decorator_1.Exports)(instance, _prototype, relevantProvidersForClass);
+    (0, key_binding_decorator_1.KeyBindings)(instance, _prototype, relevantProvidersForClass);
+    if (decorationType === DecorationType.CLIENT) {
+        (0, ui_listener_decorator_1.UIListeners)(instance, _prototype, relevantProvidersForClass);
+    }
+}
+var DecorationType;
+(function (DecorationType) {
+    DecorationType[DecorationType["SERVER"] = 0] = "SERVER";
+    DecorationType[DecorationType["CLIENT"] = 1] = "CLIENT";
+})(DecorationType || (exports.DecorationType = DecorationType = {}));

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

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_EVENTS = exports.EVENT_DIRECTIONS = void 0;
+exports.EventListener = EventListener;
+exports.EventListeners = EventListeners;
+const decorator_utils_1 = require("./decorator.utils");
+function EventListener(data) {
+    return function (target, propertyKey) {
+        const eventName = (exports.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);
+    };
+}
+function EventListeners(target, _prototype, providers) {
+    decorator_utils_1.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;
+                }
+            }
+        }
+    });
+}
+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 || (exports.EVENT_DIRECTIONS = EVENT_DIRECTIONS = {}));
+// TODO: Refactor this, so resources can add to it
+exports.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/cjs/decorators/export.decorator.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Export = Export;
+exports.Exports = Exports;
+const decorator_utils_1 = require("./decorator.utils");
+function Export() {
+    return function (target, propertyKey) {
+        Reflect.defineMetadata(`arm_export_${propertyKey}`, propertyKey, target);
+    };
+}
+function Exports(target, _prototype, providers) {
+    decorator_utils_1.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/cjs/decorators/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UIListener = exports.KeyBinding = exports.Export = exports.EVENT_DIRECTIONS = exports.EventListener = exports.Controller = exports.Command = void 0;
+var command_decorator_1 = require("./command.decorator");
+Object.defineProperty(exports, "Command", { enumerable: true, get: function () { return command_decorator_1.Command; } });
+var controller_decorator_1 = require("./controller.decorator");
+Object.defineProperty(exports, "Controller", { enumerable: true, get: function () { return controller_decorator_1.Controller; } });
+var event_listener_decorator_1 = require("./event-listener.decorator");
+Object.defineProperty(exports, "EventListener", { enumerable: true, get: function () { return event_listener_decorator_1.EventListener; } });
+Object.defineProperty(exports, "EVENT_DIRECTIONS", { enumerable: true, get: function () { return event_listener_decorator_1.EVENT_DIRECTIONS; } });
+var export_decorator_1 = require("./export.decorator");
+Object.defineProperty(exports, "Export", { enumerable: true, get: function () { return export_decorator_1.Export; } });
+var key_binding_decorator_1 = require("./key-binding.decorator");
+Object.defineProperty(exports, "KeyBinding", { enumerable: true, get: function () { return key_binding_decorator_1.KeyBinding; } });
+var ui_listener_decorator_1 = require("./ui-listener.decorator");
+Object.defineProperty(exports, "UIListener", { enumerable: true, get: function () { return ui_listener_decorator_1.UIListener; } });

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

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyBinding = KeyBinding;
+exports.KeyBindings = KeyBindings;
+const decorator_utils_1 = require("./decorator.utils");
+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);
+    };
+}
+function KeyBindings(target, _prototype, providers) {
+    decorator_utils_1.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/cjs/decorators/ui-listener.decorator.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UIListener = UIListener;
+exports.UIListeners = UIListeners;
+const decorator_utils_1 = require("./decorator.utils");
+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);
+    };
+}
+function UIListeners(target, _prototype, providers) {
+    decorator_utils_1.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');
+        });
+    });
+}

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/index.js

@@ -0,0 +1,21 @@
+"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 });
+exports.Delay = void 0;
+__exportStar(require("./string-formatter"), exports);
+__exportStar(require("./location-utils"), exports);
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "Delay", { enumerable: true, get: function () { return utils_1.Delay; } });

package/dist/cjs/utils/location-utils.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocationUtils = void 0;
+class LocationUtils {
+    static distance(fromX, fromY, fromZ, toX, toY, toZ) {
+        return Math.hypot(toX - fromX, toY - fromY, toZ - fromZ);
+    }
+}
+exports.LocationUtils = LocationUtils;

package/dist/cjs/utils/string-formatter.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StringFormatter = void 0;
+const suffixes = ['k', 'M', 'G', 'T', 'P', 'E'];
+class StringFormatter {
+    static numberWithCommas(num) {
+        return num.toString().replace(new RegExp('\\B(?=(\\d{3})+(?!\\d))', 'g'), ",");
+    }
+    static phone(phone) {
+        const filteredValue = phone.toString().replace('-', '');
+        if (filteredValue.length > 3) {
+            return `${filteredValue.substring(0, 3)}-${filteredValue.substring(3)}`;
+        }
+        return phone.toString();
+    }
+    static thousands(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.StringFormatter = StringFormatter;

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/common/index.js

@@ -0,0 +1,7 @@
+/// <reference path = "../ambient.declarations.d.ts" />
+import 'reflect-metadata';
+export * from '../shared';
+export * from '../decorators';
+export { Decorate, DecorationType } from '../decorators/decorator.utils';
+export * from '../utils';
+export * from '../utils/utils';

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');
+        });
+    });
+}

package/dist/esm/shared/index.js

@@ -0,0 +1 @@
+export * from './models';

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,2 @@
+export * from './account';
+export * from './character';

package/dist/esm/utils/index.js

@@ -0,0 +1,3 @@
+export * from './string-formatter';
+export * from './location-utils';
+export { Delay } from './utils';

package/dist/esm/utils/location-utils.js

@@ -0,0 +1,5 @@
+export class LocationUtils {
+    static distance(fromX, fromY, fromZ, toX, toY, toZ) {
+        return Math.hypot(toX - fromX, toY - fromY, toZ - fromZ);
+    }
+}

package/dist/esm/utils/string-formatter.js

@@ -0,0 +1,25 @@
+const suffixes = ['k', 'M', 'G', 'T', 'P', 'E'];
+export class StringFormatter {
+    static numberWithCommas(num) {
+        return num.toString().replace(new RegExp('\\B(?=(\\d{3})+(?!\\d))', 'g'), ",");
+    }
+    static phone(phone) {
+        const filteredValue = phone.toString().replace('-', '');
+        if (filteredValue.length > 3) {
+            return `${filteredValue.substring(0, 3)}-${filteredValue.substring(3)}`;
+        }
+        return phone.toString();
+    }
+    static thousands(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]);
+    }
+}

package/dist/esm/utils/utils.js

@@ -0,0 +1,93 @@
+const Delay = (ms) => new Promise(res => setTimeout(res, ms));
+const isPlayerInArea = (playerPosX, playerPosY, playerPosZ, areaMinX, areaMinY, areaMinZ, areaMaxX, areaMaxY, areaMaxZ) => {
+    return playerPosX >= areaMinX && playerPosX <= areaMaxX && playerPosY >= areaMinY && playerPosY <= areaMaxY && playerPosZ >= areaMinZ && playerPosZ <= areaMaxZ;
+};
+const isPlayerInRangeOfPoint = (playerPosX, playerPosY, playerPosZ, pointX, pointY, pointZ, range) => {
+    return calculateDistance([playerPosX, playerPosY, playerPosZ, pointX, pointY, pointZ]) <= range;
+};
+const waitUntilThenDo = async (condition, func) => {
+    let attempts = 0;
+    while (!condition()) {
+        if (attempts > 50) {
+            return;
+        }
+        await Delay(10);
+    }
+    func();
+};
+export 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);
+};
+export 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;
+};
+export 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))];
+};
+export 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;
+};
+const numberWithCommas = (x) => {
+    return x.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+};
+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);
+};
+export const phoneFormatted = (phone) => {
+    const filteredValue = phone.toString().replace('-', '');
+    if (filteredValue.length > 3) {
+        return `${filteredValue.substring(0, 3)}-${filteredValue.substring(3)}`;
+    }
+    return phone.toString();
+};
+const suffixes = ['k', 'M', 'G', 'T', 'P', 'E'];
+export 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]);
+};
+export 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())));
+};
+export const toTitleCase = (str) => {
+    return str.replace(/\w\S*/g, function (txt) {
+        return txt.charAt(0).toUpperCase() + txt.substr(1).toLowerCase();
+    });
+};
+export { Delay, isPlayerInArea, isPlayerInRangeOfPoint, waitUntilThenDo, numberWithCommas, isJSON };

package/dist/types/common/index.d.ts

@@ -0,0 +1,6 @@
+import 'reflect-metadata';
+export * from '../shared';
+export * from '../decorators';
+export { Decorate, DecorationType } from '../decorators/decorator.utils';
+export * from '../utils';
+export * from '../utils/utils';

package/dist/types/decorators/command.decorator.d.ts

@@ -0,0 +1,5 @@
+export declare function Command(data?: {
+    adminLevelRequired?: number;
+    suffix?: string;
+}): (target: any, propertyKey: string) => void;
+export declare function Commands(target: any, _prototype: any, providers?: Object[]): void;

package/dist/types/decorators/controller.decorator.d.ts

@@ -0,0 +1 @@
+export declare function Controller(data?: any): (target: any) => void;

package/dist/types/decorators/decorator.utils.d.ts

@@ -0,0 +1,15 @@
+import { Provider } from "injection-js";
+export declare class DecoratorUtils {
+    static map(target: any, _prototype: any, providers: Object[]): {
+        key: any;
+        target: any;
+        value: any;
+    }[];
+}
+export declare function Decorate<T extends {
+    new (...args: any[]): any;
+} & Provider>(instance: T, _prototype: any, providers: Provider[], decorationType?: DecorationType): void;
+export declare enum DecorationType {
+    SERVER = 0,
+    CLIENT = 1
+}

package/dist/types/decorators/event-listener.decorator.d.ts

@@ -0,0 +1,15 @@
+export declare function EventListener(data?: {
+    eventName?: string;
+    direction?: EVENT_DIRECTIONS;
+    type?: 'ui' | 'default';
+}): (target: any, propertyKey: string) => void;
+export declare function EventListeners(target: any, _prototype: any, providers?: Object[]): void;
+export declare enum EVENT_DIRECTIONS {
+    SERVER_TO_SERVER = 0,
+    SERVER_TO_CLIENT = 1,
+    CLIENT_TO_SERVER = 2,
+    CLIENT_TO_CLIENT = 3
+}
+export declare const DEFAULT_EVENTS: {
+    [key: string]: string;
+};

package/dist/types/decorators/export.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare function Export(): (target: any, propertyKey: string) => void;
+export declare function Exports(target: any, _prototype: any, providers?: Object[]): void;

package/dist/types/decorators/index.d.ts

@@ -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/types/decorators/key-binding.decorator.d.ts

@@ -0,0 +1,8 @@
+export declare function KeyBinding(data: {
+    command?: string;
+    description: string;
+    defaultMapper: KeyBindingType;
+    key: string;
+}): (target: any, propertyKey: string) => void;
+export declare function KeyBindings(target: any, _prototype: any, providers?: Object[]): void;
+export type KeyBindingType = 'digitalbutton_axis' | 'game_controlled' | 'joystick_axis' | 'joystick_axis_negative' | 'joystick_axis_positive' | 'joystick_button' | 'joystick_iaxis' | 'joystick_pov' | 'joystick_pov_axis' | 'keyboard' | 'mkb_axis' | 'mouse_absoluteaxis' | 'mouse_button' | 'mouse_buttonany' | 'mouse_centeredaxis' | 'mouse_relativeaxis' | 'mouse_scaledaxis' | 'mouse_normalized' | 'mouse_wheel' | 'pad_analogbutton' | 'pad_axis' | 'pad_debugbutton' | 'pad_digitalbutton' | 'pad_digitalbuttonany' | 'touchpad_absolute_axis' | 'touchpad_centered_axis';

package/dist/types/decorators/ui-listener.decorator.d.ts

@@ -0,0 +1,4 @@
+export declare function UIListener(data?: {
+    eventName?: string;
+}): (target: any, propertyKey: string) => void;
+export declare function UIListeners(target: any, _prototype: any, providers?: Object[]): void;

package/dist/types/shared/index.d.ts

@@ -0,0 +1 @@
+export * from './models';

package/dist/types/shared/models/account.d.ts

@@ -0,0 +1,5 @@
+export interface IAccount {
+    id: number;
+    name: string;
+    email: string;
+}

package/dist/types/shared/models/character.d.ts

@@ -0,0 +1,4 @@
+export interface ICharacter {
+    id: number;
+    accountId: number;
+}

package/dist/types/shared/models/index.d.ts

@@ -0,0 +1,2 @@
+export * from './account';
+export * from './character';

package/dist/types/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './string-formatter';
+export * from './location-utils';
+export { Delay } from './utils';

package/dist/types/utils/location-utils.d.ts

@@ -0,0 +1,3 @@
+export declare class LocationUtils {
+    static distance(fromX: number, fromY: number, fromZ: number, toX: number, toY: number, toZ: number): number;
+}

package/dist/types/utils/string-formatter.d.ts

@@ -0,0 +1,5 @@
+export declare class StringFormatter {
+    static numberWithCommas(num: number): string;
+    static phone(phone: number): string;
+    static thousands(input: number, args?: number): string | number | null;
+}

package/dist/types/utils/utils.d.ts

@@ -0,0 +1,15 @@
+declare const Delay: (ms: number) => Promise<unknown>;
+declare const isPlayerInArea: (playerPosX: number, playerPosY: number, playerPosZ: number, areaMinX: number, areaMinY: number, areaMinZ: number, areaMaxX: number, areaMaxY: number, areaMaxZ: number) => boolean;
+declare const isPlayerInRangeOfPoint: (playerPosX: number, playerPosY: number, playerPosZ: number, pointX: number, pointY: number, pointZ: number, range: number) => boolean;
+declare const waitUntilThenDo: (condition: Function, func: Function) => Promise<void>;
+export declare const calculateDistance: (pos: number[]) => number;
+export declare const calculateDistanceInKm: (pos: number[]) => number;
+export declare const getRandomPositionInsideArea: (x1: number, x2: number, y1: number, y2: number) => [number, number];
+export declare const isPositionIn2DArea: (x: number, y: number, x1: number, x2: number, y1: number, y2: number) => boolean;
+declare const numberWithCommas: (x: number) => string;
+declare const isJSON: (str: string) => boolean;
+export declare const phoneFormatted: (phone: number) => string;
+export declare const toThousandsString: (input: number, args?: number) => string | number | null;
+export declare const fromThousandsString: (input: string) => number;
+export declare const toTitleCase: (str: string) => string;
+export { Delay, isPlayerInArea, isPlayerInRangeOfPoint, waitUntilThenDo, numberWithCommas, isJSON };

package/package.json

@@ -1,6 +1,29 @@
-{
-  "name": "@armoury/fivem-framework-common",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+{
+  "name": "@armoury/fivem-framework-common",
+  "version": "1.0.8",
+  "description": "Shared APIs for the Armoury FiveM framework",
+  "main": "dist/cjs/common/index.js",
+  "module": "dist/esm/common/index.js",
+  "types": "dist/types/common/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/common/index.d.ts",
+      "import": "./dist/esm/common/index.js",
+      "require": "./dist/cjs/common/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "npm run build:cjs && npm run build:esm && npm run build:types",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:types": "tsc -p tsconfig.types.json"
+  },
+  "dependencies": {
+    "injection-js": "^2.4.0",
+    "reflect-metadata": "^0.2.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.