@open-core/framework 0.2.8 → 0.3.0

package/dist/runtime/server/controllers/vehicle.controller.d.ts

@@ -1,7 +1,5 @@
 import { Player } from '../entities/player';
 import { VehicleService } from '../services/vehicle.service';
-import { VehicleModificationService } from '../services/vehicle-modification.service';
-import { VehicleCreateOptions, VehicleModificationOptions } from '../types/vehicle.types';
 /**
  * Controller for handling vehicle-related network events.
  *
@@ -10,46 +8,13 @@ import { VehicleCreateOptions, VehicleModificationOptions } from '../types/vehic
  */
 export declare class VehicleController {
     private readonly vehicleService;
-    private readonly modificationService;
-    constructor(vehicleService: VehicleService, modificationService: VehicleModificationService);
-    /**
-     * Handles client request to create a vehicle.
-     */
-    handleCreateVehicle(player: Player, options: VehicleCreateOptions): Promise<import("../types/vehicle.types").VehicleSpawnResult>;
-    /**
-     * Handles client request to delete a vehicle.
-     */
-    handleDeleteVehicle(player: Player, networkId: number): boolean;
-    /**
-     * Handles client request to modify a vehicle.
-     */
-    handleModifyVehicle(player: Player, options: VehicleModificationOptions): boolean;
-    /**
-     * Handles client request to repair a vehicle.
-     */
-    handleRepairVehicle(player: Player, networkId: number): boolean;
-    /**
-     * Handles client request to set vehicle fuel.
-     */
-    handleSetFuel(player: Player, networkId: number, level: number): boolean;
-    /**
-     * Handles client request to lock/unlock vehicle doors.
-     */
-    handleSetLocked(player: Player, networkId: number, locked: boolean): boolean;
+    constructor(vehicleService: VehicleService);
     /**
      * Handles client request to get vehicle data.
      */
-    handleGetData(player: Player, networkId: number): import("../types/vehicle.types").SerializedVehicleData | null;
+    handleGetData(player: Player, networkId: number): import("../types").SerializedVehicleData | null;
     /**
      * Handles client request to get all player vehicles.
      */
-    handleGetPlayerVehicles(player: Player): import("../types/vehicle.types").SerializedVehicleData[];
-    /**
-     * Handles client request to teleport a vehicle.
-     */
-    handleTeleport(player: Player, networkId: number, position: {
-        x: number;
-        y: number;
-        z: number;
-    }, heading?: number): boolean;
+    handleGetPlayerVehicles(player: Player): import("../types").SerializedVehicleData[];
 }

package/dist/runtime/server/controllers/vehicle.controller.js

@@ -14,11 +14,9 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VehicleController = void 0;
 const tsyringe_1 = require("tsyringe");
-const logger_1 = require("../../../kernel/shared/logger");
 const decorators_1 = require("../decorators");
 const player_1 = require("../entities/player");
 const vehicle_service_1 = require("../services/vehicle.service");
-const vehicle_modification_service_1 = require("../services/vehicle-modification.service");
 /**
  * Controller for handling vehicle-related network events.
  *
@@ -26,168 +24,33 @@ const vehicle_modification_service_1 = require("../services/vehicle-modification
  * for validation and security checks.
  */
 let VehicleController = class VehicleController {
-    constructor(vehicleService, modificationService) {
+    constructor(vehicleService) {
         this.vehicleService = vehicleService;
-        this.modificationService = modificationService;
-    }
-    /**
-     * Handles client request to create a vehicle.
-     */
-    async handleCreateVehicle(player, options) {
-        const source = player.clientID;
-        logger_1.coreLogger.debug('Vehicle creation requested', { clientID: source, options });
-        const result = await this.vehicleService.createForPlayer(source, options);
-        emitNet('opencore:vehicle:createResult', source, result);
-        return result;
-    }
-    /**
-     * Handles client request to delete a vehicle.
-     */
-    handleDeleteVehicle(player, networkId) {
-        const source = player.clientID;
-        logger_1.coreLogger.debug('Vehicle deletion requested', { clientID: source, networkId });
-        const success = this.vehicleService.delete(networkId, source);
-        emitNet('opencore:vehicle:deleteResult', source, { networkId, success });
-        return success;
-    }
-    /**
-     * Handles client request to modify a vehicle.
-     */
-    handleModifyVehicle(player, options) {
-        const source = player.clientID;
-        logger_1.coreLogger.debug('Vehicle modification requested', { clientID: source, options });
-        const success = this.modificationService.applyModifications(Object.assign(Object.assign({}, options), { requestedBy: source }));
-        emitNet('opencore:vehicle:modifyResult', source, { networkId: options.networkId, success });
-        return success;
-    }
-    /**
-     * Handles client request to repair a vehicle.
-     */
-    handleRepairVehicle(player, networkId) {
-        const source = player.clientID;
-        logger_1.coreLogger.debug('Vehicle repair requested', { clientID: source, networkId });
-        if (!this.vehicleService.validateOwnership(networkId, source)) {
-            emitNet('opencore:vehicle:repairResult', source, { networkId, success: false });
-            return false;
-        }
-        const vehicle = this.vehicleService.getByNetworkId(networkId);
-        if (!vehicle) {
-            emitNet('opencore:vehicle:repairResult', source, { networkId, success: false });
-            return false;
-        }
-        emitNet('opencore:vehicle:repairResult', source, { networkId, success: true });
-        emitNet('opencore:vehicle:repaired', -1, networkId);
-        return true;
-    }
-    /**
-     * Handles client request to set vehicle fuel.
-     */
-    handleSetFuel(player, networkId, level) {
-        const source = player.clientID;
-        if (!this.vehicleService.validateOwnership(networkId, source)) {
-            return false;
-        }
-        const vehicle = this.vehicleService.getByNetworkId(networkId);
-        if (!vehicle)
-            return false;
-        vehicle.setFuel(level);
-        return true;
-    }
-    /**
-     * Handles client request to lock/unlock vehicle doors.
-     */
-    handleSetLocked(player, networkId, locked) {
-        const source = player.clientID;
-        if (!this.vehicleService.validateOwnership(networkId, source)) {
-            return false;
-        }
-        if (!this.vehicleService.validateProximity(networkId, source, 10.0)) {
-            return false;
-        }
-        const vehicle = this.vehicleService.getByNetworkId(networkId);
-        if (!vehicle)
-            return false;
-        vehicle.setDoorsLocked(locked);
-        emitNet('opencore:vehicle:lockedChanged', -1, { networkId, locked });
-        return true;
     }
     /**
      * Handles client request to get vehicle data.
      */
     handleGetData(player, networkId) {
-        const source = player.clientID;
         const vehicle = this.vehicleService.getByNetworkId(networkId);
         if (!vehicle) {
-            emitNet('opencore:vehicle:dataResult', source, null);
+            emitNet('opencore:vehicle:dataResult', player.clientID, null);
             return null;
         }
         const data = vehicle.serialize();
-        emitNet('opencore:vehicle:dataResult', source, data);
+        emitNet('opencore:vehicle:dataResult', player.clientID, data);
         return data;
     }
     /**
      * Handles client request to get all player vehicles.
      */
     handleGetPlayerVehicles(player) {
-        const source = player.clientID;
-        const vehicles = this.vehicleService.getPlayerVehicles(source);
+        const vehicles = this.vehicleService.getPlayerVehicles(player.clientID);
         const serialized = vehicles.map((v) => v.serialize());
-        emitNet('opencore:vehicle:playerVehiclesResult', source, serialized);
+        emitNet('opencore:vehicle:playerVehiclesResult', player.clientID, serialized);
         return serialized;
     }
-    /**
-     * Handles client request to teleport a vehicle.
-     */
-    handleTeleport(player, networkId, position, heading) {
-        const source = player.clientID;
-        if (!this.vehicleService.validateOwnership(networkId, source)) {
-            return false;
-        }
-        const vehicle = this.vehicleService.getByNetworkId(networkId);
-        if (!vehicle)
-            return false;
-        vehicle.teleport(position, heading);
-        emitNet('opencore:vehicle:teleported', -1, { networkId, position, heading });
-        return true;
-    }
 };
 exports.VehicleController = VehicleController;
-__decorate([
-    (0, decorators_1.OnNet)('opencore:vehicle:create'),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [player_1.Player, Object]),
-    __metadata("design:returntype", Promise)
-], VehicleController.prototype, "handleCreateVehicle", null);
-__decorate([
-    (0, decorators_1.OnNet)('opencore:vehicle:delete'),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [player_1.Player, Number]),
-    __metadata("design:returntype", void 0)
-], VehicleController.prototype, "handleDeleteVehicle", null);
-__decorate([
-    (0, decorators_1.OnNet)('opencore:vehicle:modify'),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [player_1.Player, Object]),
-    __metadata("design:returntype", void 0)
-], VehicleController.prototype, "handleModifyVehicle", null);
-__decorate([
-    (0, decorators_1.OnNet)('opencore:vehicle:repair'),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [player_1.Player, Number]),
-    __metadata("design:returntype", void 0)
-], VehicleController.prototype, "handleRepairVehicle", null);
-__decorate([
-    (0, decorators_1.OnNet)('opencore:vehicle:setFuel'),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [player_1.Player, Number, Number]),
-    __metadata("design:returntype", void 0)
-], VehicleController.prototype, "handleSetFuel", null);
-__decorate([
-    (0, decorators_1.OnNet)('opencore:vehicle:setLocked'),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [player_1.Player, Number, Boolean]),
-    __metadata("design:returntype", void 0)
-], VehicleController.prototype, "handleSetLocked", null);
 __decorate([
     (0, decorators_1.OnNet)('opencore:vehicle:getData'),
     __metadata("design:type", Function),
@@ -200,17 +63,8 @@ __decorate([
     __metadata("design:paramtypes", [player_1.Player]),
     __metadata("design:returntype", void 0)
 ], VehicleController.prototype, "handleGetPlayerVehicles", null);
-__decorate([
-    (0, decorators_1.OnNet)('opencore:vehicle:teleport'),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [player_1.Player, Number, Object, Number]),
-    __metadata("design:returntype", void 0)
-], VehicleController.prototype, "handleTeleport", null);
 exports.VehicleController = VehicleController = __decorate([
     (0, decorators_1.Controller)(),
-    (0, tsyringe_1.injectable)(),
     __param(0, (0, tsyringe_1.inject)(vehicle_service_1.VehicleService)),
-    __param(1, (0, tsyringe_1.inject)(vehicle_modification_service_1.VehicleModificationService)),
-    __metadata("design:paramtypes", [vehicle_service_1.VehicleService,
-        vehicle_modification_service_1.VehicleModificationService])
+    __metadata("design:paramtypes", [vehicle_service_1.VehicleService])
 ], VehicleController);

package/dist/runtime/server/decorators/guard.d.ts

@@ -30,20 +30,22 @@ export interface GuardOptions {
  *
  * @throws Error - If the method is invoked without a valid `Player` as the first argument.
  *
- * @example
  * ```ts
  * @Server.Controller()
- * export class FactionController {
+ * export class AdminController {
+ *
  *   @Server.Guard({ permission: 'factions.manage' })
- *   async createFaction(player: Server.Player, dto: CreateFactionDTO) {
+ *   @Server.Command('newfaction', schema)
+ *   async createFaction(player: Server.Player, dto: Infer<typeof schema>) {
  *     return this.service.create(dto)
  *   }
  *
  *   @Server.Guard({ rank: 3 })
- *   async promoteMember(player: Server.Player, memberID: string) {
- *     return this.service.promote(player, memberID)
+ *   @Server.Command('ban')
+ *   async ban(player: Server.Player, targetID: string) {
+ *     return this.service.ban(player, memberID)
  *   }
- * }
+}
  * ```
  */
 export declare function Guard(options: GuardOptions): (target: any, propertyKey: string, descriptor?: PropertyDescriptor) => PropertyDescriptor | undefined;

package/dist/runtime/server/decorators/guard.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Guard = Guard;
 const kernel_1 = require("../../../kernel");
 const container_1 = require("../../../kernel/di/container");
-const logger_1 = require("../../../kernel/shared/logger");
+const logger_1 = require("../../../kernel/logger");
 const principal_port_1 = require("../services/ports/principal.port");
 /**
  * Declarative access-control decorator for controller methods.
@@ -25,20 +25,22 @@ const principal_port_1 = require("../services/ports/principal.port");
  *
  * @throws Error - If the method is invoked without a valid `Player` as the first argument.
  *
- * @example
  * ```ts
  * @Server.Controller()
- * export class FactionController {
+ * export class AdminController {
+ *
  *   @Server.Guard({ permission: 'factions.manage' })
- *   async createFaction(player: Server.Player, dto: CreateFactionDTO) {
+ *   @Server.Command('newfaction', schema)
+ *   async createFaction(player: Server.Player, dto: Infer<typeof schema>) {
  *     return this.service.create(dto)
  *   }
  *
  *   @Server.Guard({ rank: 3 })
- *   async promoteMember(player: Server.Player, memberID: string) {
- *     return this.service.promote(player, memberID)
+ *   @Server.Command('ban')
+ *   async ban(player: Server.Player, targetID: string) {
+ *     return this.service.ban(player, memberID)
  *   }
- * }
+}
  * ```
  */
 function Guard(options) {
@@ -62,7 +64,7 @@ function Guard(options) {
                 });
                 throw new Error('Guard Security Error: Context is not a player');
             }
-            const principal = container_1.di.resolve(principal_port_1.PrincipalPort);
+            const principal = container_1.GLOBAL_CONTAINER.resolve(principal_port_1.PrincipalPort);
             try {
                 await principal.enforce(player, options);
             }

package/dist/runtime/server/decorators/index.d.ts

@@ -3,9 +3,9 @@ export { Command, CommandConfig } from './command';
 export { Controller } from './controller';
 export * from './export';
 export * from './guard';
-export * from './onFiveMEvent';
 export * from './onFrameworkEvent';
 export * from './onNet';
+export * from './onRuntimeEvent';
 export * from './onTick';
 export * from './public';
 export * from './requiresState';

package/dist/runtime/server/decorators/index.js

@@ -22,9 +22,9 @@ var controller_1 = require("./controller");
 Object.defineProperty(exports, "Controller", { enumerable: true, get: function () { return controller_1.Controller; } });
 __exportStar(require("./export"), exports);
 __exportStar(require("./guard"), exports);
-__exportStar(require("./onFiveMEvent"), exports);
 __exportStar(require("./onFrameworkEvent"), exports);
 __exportStar(require("./onNet"), exports);
+__exportStar(require("./onRuntimeEvent"), exports);
 __exportStar(require("./onTick"), exports);
 __exportStar(require("./public"), exports);
 __exportStar(require("./requiresState"), exports);

package/dist/runtime/server/decorators/onNet.d.ts

@@ -48,15 +48,15 @@ type ServerNetHandler<TArgs extends any[] = any[]> = (player: Player, ...args: T
  * export class ExampleController {
  *   // Simple handler (no schema)
  *   @Server.OnNet('example:ping')
- *   ping(player: Player, message: string) { }
+ *   ping(player: Server.Player, message: string) { }
  *
  *   // With schema directly (recommended)
  *   @Server.OnNet('example:data', PayloadSchema)
- *   handleData(player: Player, data: Infer<typeof PayloadSchema>) { }
+ *   handleData(player: Server.Player, data: Infer<typeof PayloadSchema>) { }
  *
  *   // With options object (legacy)
  *   @Server.OnNet('example:legacy', { schema: PayloadSchema })
- *   handleLegacy(player: Player, data: Infer<typeof PayloadSchema>) { }
+ *   handleLegacy(player: Server.Player, data: Infer<typeof PayloadSchema>) { }
  * }
  * ```
  */

package/dist/runtime/server/decorators/{onFiveMEvent.d.ts → onRuntimeEvent.d.ts}

@@ -1,5 +1,6 @@
 /**
- * Registers a method as a server-side listener for a native FiveM event.
+ * Registers a method as a server-side listener for a native Runtime event.
+ * Runtime === FiveM
  *
  * @remarks
  * This decorator only stores metadata. During bootstrap, the framework scans controller
@@ -8,17 +9,17 @@
  * FiveM server event reference:
  * https://docs.fivem.net/docs/scripting-reference/events/server-events/
  *
- * @param event - FiveM event name (e.g. `"playerJoining"`).
+ * @param event - event name (e.g. `"playerJoining"`). FiveM Events
  *
  * @example
  * ```ts
  * @Server.Controller()
  * export class SessionController {
- *   @Server.OnFiveMEvent('playerJoining')
+ *   @Server.OnRuntimeEvent('playerJoining')
  *   onPlayerJoining() {
  *     // ...
  *   }
  * }
  * ```
  */
-export declare function OnFiveMEvent(event: string): (target: any, propertyKey: string) => void;
+export declare function OnRuntimeEvent(event: string): (target: any, propertyKey: string) => void;

package/dist/runtime/server/decorators/{onFiveMEvent.js → onRuntimeEvent.js}

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OnFiveMEvent = OnFiveMEvent;
+exports.OnRuntimeEvent = OnRuntimeEvent;
 const metadata_server_keys_1 = require("../system/metadata-server.keys");
 /**
- * Registers a method as a server-side listener for a native FiveM event.
+ * Registers a method as a server-side listener for a native Runtime event.
+ * Runtime === FiveM
  *
  * @remarks
  * This decorator only stores metadata. During bootstrap, the framework scans controller
@@ -12,21 +13,21 @@ const metadata_server_keys_1 = require("../system/metadata-server.keys");
  * FiveM server event reference:
  * https://docs.fivem.net/docs/scripting-reference/events/server-events/
  *
- * @param event - FiveM event name (e.g. `"playerJoining"`).
+ * @param event - event name (e.g. `"playerJoining"`). FiveM Events
  *
  * @example
  * ```ts
  * @Server.Controller()
  * export class SessionController {
- *   @Server.OnFiveMEvent('playerJoining')
+ *   @Server.OnRuntimeEvent('playerJoining')
  *   onPlayerJoining() {
  *     // ...
  *   }
  * }
  * ```
  */
-function OnFiveMEvent(event) {
+function OnRuntimeEvent(event) {
     return (target, propertyKey) => {
-        Reflect.defineMetadata(metadata_server_keys_1.METADATA_KEYS.FIVEM_EVENT, { event }, target, propertyKey);
+        Reflect.defineMetadata(metadata_server_keys_1.METADATA_KEYS.RUNTIME_EVENT, { event }, target, propertyKey);
     };
 }

package/dist/runtime/server/decorators/requiresState.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RequiresState = RequiresState;
-const utils_1 = require("../../../kernel/utils");
+const app_error_1 = require("../../../kernel/error/app.error");
 const metadata_server_keys_1 = require("../system/metadata-server.keys");
 /**
  * Enforces gameplay state requirements before executing a method.
@@ -55,14 +55,14 @@ function RequiresState(req) {
             if (req.has) {
                 for (const state of req.has) {
                     if (!player.hasState(state)) {
-                        throw new utils_1.AppError('GAME:INVALID_STATE', req.errorMessage || `You must be [${state}] to do this.`, 'client');
+                        throw new app_error_1.AppError('GAME:INVALID_STATE', req.errorMessage || `You must be [${state}] to do this.`, 'client');
                     }
                 }
             }
             if (req.missing) {
                 for (const state of req.missing) {
                     if (player.hasState(state)) {
-                        throw new utils_1.AppError('GAME:INVALID_STATE', req.errorMessage || `You can't do this while you're [${state}].`, 'client');
+                        throw new app_error_1.AppError('GAME:INVALID_STATE', req.errorMessage || `You can't do this while you're [${state}].`, 'client');
                     }
                 }
             }

package/dist/runtime/server/decorators/throttle.d.ts

@@ -1,4 +1,4 @@
-import { SecurityAction } from '../types/security.types';
+import { SecurityAction } from '../../../kernel/error/security.types';
 export interface ThrottleOptions {
     /**
      * limit of calls per windowMs

package/dist/runtime/server/decorators/throttle.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Throttle = Throttle;
 const tsyringe_1 = require("tsyringe");
-const security_error_1 = require("../../../kernel/utils/error/security.error");
+const security_error_1 = require("../../../kernel/error/security.error");
 const rate_limiter_service_1 = require("../services/rate-limiter.service");
 const metadata_server_keys_1 = require("../system/metadata-server.keys");
 /**

package/dist/runtime/server/decorators/utils.d.ts

@@ -30,7 +30,7 @@ export declare function Service(options?: {
  *
  *
  * @remarks
- * A repository abstracts persistence operations (database, API, in-memory, or hybrid storage).
+ * A repository abstracts persistence operations (API, in-memory, or hybrid storage).
  * It is registered in the dependency injection container using the provided scope
  * (default: `singleton`).
  *

package/dist/runtime/server/decorators/utils.js

@@ -35,7 +35,7 @@ function Service(options) {
  *
  *
  * @remarks
- * A repository abstracts persistence operations (database, API, in-memory, or hybrid storage).
+ * A repository abstracts persistence operations (API, in-memory, or hybrid storage).
  * It is registered in the dependency injection container using the provided scope
  * (default: `singleton`).
  *

package/dist/runtime/server/devmode/dev-mode.service.d.ts

@@ -5,17 +5,17 @@ import { BridgeMessage, DevEvent, DevModeOptions, RuntimeSnapshot } from './type
 /**
  * Main DevMode service that orchestrates all development tools.
  *
- * Provides a unified interface for:
- * - Hot reload server for automatic resource restarting
- * - Event interception and recording
- * - Runtime state inspection
- * - Player simulation
- * - Log streaming to external tools
+ * @remarks
+ * Provides a unified interface for internal framework debugging and telemetry.
+ * It coordinates:
+ * - Event interception and recording (Net, Commands, etc)
+ * - Runtime state inspection (DI, Players, Services)
+ * - Player simulation for offline logic testing
+ * - Telemetry bridge for external CLI integration
  */
 export declare class DevModeService {
     private enabled;
     private options;
-    private hotReloadServer;
     private logTransport;
     private get interceptor();
     private get inspector();
@@ -106,5 +106,4 @@ export declare class DevModeService {
     getSimulatorStatistics(): ReturnType<PlayerSimulatorService['getStatistics']>;
     private handleBridgeMessage;
     private handleRemoteCommand;
-    private handleRemoteReload;
 }