@open-core/framework 0.2.9 → 0.3.0

package/dist/runtime/server/services/chat.service.js

@@ -8,9 +8,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 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); }
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChatService = void 0;
 const tsyringe_1 = require("tsyringe");
+const INetTransport_1 = require("../../../adapters/contracts/INetTransport");
 const player_directory_port_1 = require("./ports/player-directory.port");
 /**
  * Service for sending chat messages to players.
@@ -19,8 +23,9 @@ const player_directory_port_1 = require("./ports/player-directory.port");
  * This service emits framework chat events over the network.
  */
 let ChatService = class ChatService {
-    constructor(playerDirectory) {
+    constructor(playerDirectory, netTransport) {
         this.playerDirectory = playerDirectory;
+        this.netTransport = netTransport;
     }
     /**
      * Broadcast a chat message to all connected players.
@@ -30,7 +35,7 @@ let ChatService = class ChatService {
      * @param color - Message color (RGB). Defaults to white.
      */
     broadcast(message, author = 'SYSTEM', color = { r: 255, g: 255, b: 255 }) {
-        emitNet('core:chat:message', -1, {
+        this.netTransport.emitNet('core:chat:message', 'all', {
             args: [author, message],
             color: color,
         });
@@ -44,7 +49,7 @@ let ChatService = class ChatService {
      * @param color - Message color (RGB).
      */
     sendPrivate(player, message, author = 'Private', color = { r: 200, g: 200, b: 200 }) {
-        emitNet('core:chat:addMessage', player.clientID, {
+        this.netTransport.emitNet('core:chat:addMessage', player.clientID, {
             args: [author, message],
             color: color,
         });
@@ -55,7 +60,7 @@ let ChatService = class ChatService {
      * @param player - Target player.
      */
     clearChat(player) {
-        emitNet('core:chat:clear', player.clientID);
+        this.netTransport.emitNet('core:chat:clear', player.clientID);
     }
     /**
      * Send a chat message to multiple players.
@@ -66,12 +71,10 @@ let ChatService = class ChatService {
      * @param color - Message color (RGB).
      */
     sendMany(players, message, author = 'SYSTEM', color = { r: 255, g: 255, b: 255 }) {
-        players.forEach((p) => {
-            const targetId = typeof p === 'number' ? p : p.clientID;
-            emitNet('core:chat:addMessage', targetId, {
-                args: [author, message],
-                color: color,
-            });
+        const targetIds = players.map((p) => (typeof p === 'number' ? p : p.clientID));
+        this.netTransport.emitNet('core:chat:addMessage', targetIds, {
+            args: [author, message],
+            color: color,
         });
     }
     /**
@@ -113,11 +116,13 @@ let ChatService = class ChatService {
      * Clear chat for all connected players.
      */
     clearChatAll() {
-        emitNet('core:chat:clear', -1);
+        this.netTransport.emitNet('core:chat:clear', 'all');
     }
 };
 exports.ChatService = ChatService;
 exports.ChatService = ChatService = __decorate([
     (0, tsyringe_1.injectable)(),
-    __metadata("design:paramtypes", [player_directory_port_1.PlayerDirectoryPort])
+    __param(1, (0, tsyringe_1.inject)(INetTransport_1.INetTransport)),
+    __metadata("design:paramtypes", [player_directory_port_1.PlayerDirectoryPort,
+        INetTransport_1.INetTransport])
 ], ChatService);

package/dist/runtime/server/services/core/command.service.d.ts

@@ -16,6 +16,13 @@ import { CommandExecutionPort, type CommandInfo } from '../ports/command-executi
  */
 export declare class CommandService extends CommandExecutionPort {
     private commands;
+    /**
+     * Returns decorator metadata for a registered command.
+     *
+     * @remarks
+     * Mainly used by controllers to enrich error observation (usage/description/etc.).
+     */
+    getCommandMeta(commandName: string): CommandMetadata | undefined;
     /**
      * Registers a command handler.
      *
@@ -28,7 +35,8 @@ export declare class CommandService extends CommandExecutionPort {
      *
      * @remarks
      * **Security**: Commands require authentication by default unless marked with @Public().
-     * Unauthenticated attempts are blocked gracefully with player notification.
+     * Unauthenticated attempts are blocked by throwing an {@link AppError}.
+     * Higher-level controllers can observe the failure and decide how to notify the player.
      *
      * Argument parsing behavior depends on the schema:
      * - Zod object schema: maps raw args to parameter names.

package/dist/runtime/server/services/core/command.service.js

@@ -8,8 +8,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CommandService = void 0;
 const tsyringe_1 = require("tsyringe");
-const logger_1 = require("../../../../kernel/shared/logger");
-const utils_1 = require("../../../../kernel/utils");
+const app_error_1 = require("../../../../kernel/error/app.error");
+const logger_1 = require("../../../../kernel/logger");
 const command_validation_helper_1 = require("../../helpers/command-validation.helper");
 const command_execution_port_1 = require("../ports/command-execution.port");
 /**
@@ -30,6 +30,16 @@ let CommandService = class CommandService extends command_execution_port_1.Comma
         super(...arguments);
         this.commands = new Map();
     }
+    /**
+     * Returns decorator metadata for a registered command.
+     *
+     * @remarks
+     * Mainly used by controllers to enrich error observation (usage/description/etc.).
+     */
+    getCommandMeta(commandName) {
+        var _a;
+        return (_a = this.commands.get(commandName.toLowerCase())) === null || _a === void 0 ? void 0 : _a.meta;
+    }
     /**
      * Registers a command handler.
      *
@@ -57,7 +67,8 @@ let CommandService = class CommandService extends command_execution_port_1.Comma
      *
      * @remarks
      * **Security**: Commands require authentication by default unless marked with @Public().
-     * Unauthenticated attempts are blocked gracefully with player notification.
+     * Unauthenticated attempts are blocked by throwing an {@link AppError}.
+     * Higher-level controllers can observe the failure and decide how to notify the player.
      *
      * Argument parsing behavior depends on the schema:
      * - Zod object schema: maps raw args to parameter names.
@@ -73,7 +84,7 @@ let CommandService = class CommandService extends command_execution_port_1.Comma
     async execute(player, commandName, args) {
         const entry = this.commands.get(commandName.toLowerCase());
         if (!entry)
-            throw new utils_1.AppError('COMMAND:NOT_FOUND', `Command not found: ${commandName}`, 'client');
+            throw new app_error_1.AppError('COMMAND:NOT_FOUND', `Command not found: ${commandName}`, 'client');
         const { meta, handler, isPublic } = entry;
         // ═══════════════════════════════════════════════════════════════
         // SECURE BY DEFAULT: Require authentication unless @Public()
@@ -84,9 +95,7 @@ let CommandService = class CommandService extends command_execution_port_1.Comma
                     command: commandName,
                     clientId: player.clientID,
                 });
-                player.emit('core:auth:required', { command: commandName });
-                player.send('You must be authenticated to use this command', 'error');
-                return;
+                throw new app_error_1.AppError('AUTH:UNAUTHORIZED', 'You must be authenticated to use this command', 'client');
             }
         }
         return await (0, command_validation_helper_1.validateAndExecuteCommand)(meta, player, args, handler);

package/dist/runtime/server/services/core/player.service.d.ts

@@ -1,7 +1,8 @@
 import { IPlayerInfo } from '../../../../adapters';
-import { IEntityServer } from '../../../../adapters/contracts/IEntityServer';
 import { INetTransport } from '../../../../adapters/contracts/INetTransport';
-import { IPlayerServer } from '../../../../adapters/contracts/IPlayerServer';
+import { IEntityServer } from '../../../../adapters/contracts/server/IEntityServer';
+import { IPlayerServer } from '../../../../adapters/contracts/server/IPlayerServer';
+import { WorldContext } from '../../../core/world';
 import { Player } from '../../entities';
 import { PlayerDirectoryPort } from '../ports/player-directory.port';
 import { PlayerSessionLifecyclePort } from '../ports/player-session-lifecycle.port';
@@ -16,19 +17,14 @@ import { PlayerSession } from '../types/player-session.object';
  * It exposes the operations defined by {@link PlayerDirectoryPort} and {@link PlayerSessionLifecyclePort}.
  */
 export declare class PlayerService implements PlayerDirectoryPort, PlayerSessionLifecyclePort {
+    private readonly world;
     private readonly playerInfo;
     private readonly playerServer;
     private readonly entityServer;
     private readonly netTransport;
-    /**
-     * Internal map storing active player sessions indexed by their FiveM client ID (source).
-     */
-    private playersByClient;
-    /**
-     * Cached adapters bundle for Player instances
-     */
     private readonly playerAdapters;
-    constructor(playerInfo: IPlayerInfo, playerServer: IPlayerServer, entityServer: IEntityServer, netTransport: INetTransport);
+    constructor(world: WorldContext, playerInfo: IPlayerInfo, playerServer: IPlayerServer, entityServer: IEntityServer, netTransport: INetTransport);
+    private isPlayer;
     /**
      * Initializes a new player session for a connecting client.
      *
@@ -57,6 +53,12 @@ export declare class PlayerService implements PlayerDirectoryPort, PlayerSession
      */
     getByClient(clientID: number): Player | undefined;
     getMany(clientIds: number[]): Player[];
+    /**
+     * Returns a list of all currently active `Player` entities.
+     *
+     * @returns An array containing all connected players managed by this service.
+     */
+    getAll(): Player[];
     /**
      * Helper to retrieve the authenticated Account ID for a given client.
      *
@@ -82,12 +84,6 @@ export declare class PlayerService implements PlayerDirectoryPort, PlayerSession
      * @returns The value cast to type `T`, or `undefined` if the key or player doesn't exist.
      */
     getMeta<T = unknown>(clientID: number, key: string): Promise<T | undefined>;
-    /**
-     * Returns a list of all currently active `Player` entities.
-     *
-     * @returns An array containing all connected players managed by this service.
-     */
-    getAll(): Player[];
     /**
      * Retrieves a Player by their persistent account ID.
      *

package/dist/runtime/server/services/core/player.service.js

@@ -15,10 +15,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PlayerService = void 0;
 const tsyringe_1 = require("tsyringe");
 const adapters_1 = require("../../../../adapters");
-const IEntityServer_1 = require("../../../../adapters/contracts/IEntityServer");
 const INetTransport_1 = require("../../../../adapters/contracts/INetTransport");
-const IPlayerServer_1 = require("../../../../adapters/contracts/IPlayerServer");
-const logger_1 = require("../../../../kernel/shared/logger");
+const IEntityServer_1 = require("../../../../adapters/contracts/server/IEntityServer");
+const IPlayerServer_1 = require("../../../../adapters/contracts/server/IPlayerServer");
+const logger_1 = require("../../../../kernel/logger");
+const world_1 = require("../../../core/world");
 const entities_1 = require("../../entities");
 /**
  * Service responsible for managing the lifecycle of player sessions.
@@ -30,15 +31,12 @@ const entities_1 = require("../../entities");
  * It exposes the operations defined by {@link PlayerDirectoryPort} and {@link PlayerSessionLifecyclePort}.
  */
 let PlayerService = class PlayerService {
-    constructor(playerInfo, playerServer, entityServer, netTransport) {
+    constructor(world, playerInfo, playerServer, entityServer, netTransport) {
+        this.world = world;
         this.playerInfo = playerInfo;
         this.playerServer = playerServer;
         this.entityServer = entityServer;
         this.netTransport = netTransport;
-        /**
-         * Internal map storing active player sessions indexed by their FiveM client ID (source).
-         */
-        this.playersByClient = new Map();
         this.playerAdapters = {
             playerInfo: this.playerInfo,
             playerServer: this.playerServer,
@@ -46,6 +44,9 @@ let PlayerService = class PlayerService {
             netTransport: this.netTransport,
         };
     }
+    isPlayer(e) {
+        return e.id.startsWith('player:');
+    }
     /**
      * Initializes a new player session for a connecting client.
      *
@@ -63,10 +64,10 @@ let PlayerService = class PlayerService {
             meta: {},
         };
         const player = new entities_1.Player(session, this.playerAdapters);
-        this.playersByClient.set(clientID, player);
+        this.world.add(player);
         logger_1.loggers.session.debug('Player session bound', {
             clientID,
-            totalPlayers: this.playersByClient.size,
+            totalPlayers: this.world.sizeBy('player'),
         });
         return player;
     }
@@ -79,10 +80,12 @@ let PlayerService = class PlayerService {
      * @param clientID - The FiveM server ID of the player disconnecting.
      */
     unbind(clientID) {
-        this.playersByClient.delete(clientID);
+        const player = this.getByClient(clientID);
+        if (player)
+            this.world.remove(player.id);
         logger_1.loggers.session.debug('Player session unbound', {
             clientID,
-            totalPlayers: this.playersByClient.size,
+            totalPlayers: this.world.sizeBy('player'),
         });
     }
     /**
@@ -92,17 +95,25 @@ let PlayerService = class PlayerService {
      * @returns The `Player` instance if found, or `null` if the session does not exist.
      */
     getByClient(clientID) {
-        return this.playersByClient.get(clientID);
+        return this.world.get(`player:${clientID}`);
     }
     getMany(clientIds) {
         const result = [];
         for (const id of clientIds) {
-            const player = this.playersByClient.get(id);
-            if (player)
-                result.push(player);
+            const p = this.getByClient(id);
+            if (p)
+                result.push(p);
         }
         return result;
     }
+    /**
+     * Returns a list of all currently active `Player` entities.
+     *
+     * @returns An array containing all connected players managed by this service.
+     */
+    getAll() {
+        return this.world.find(this.isPlayer);
+    }
     /**
      * Helper to retrieve the authenticated Account ID for a given client.
      *
@@ -110,8 +121,8 @@ let PlayerService = class PlayerService {
      * @returns The bound Account ID (string/UUID) if the player is logged in, or `null` otherwise.
      */
     getPlayerId(clientID) {
-        const player = this.playersByClient.get(clientID);
-        return player === null || player === void 0 ? void 0 : player.accountID;
+        var _a;
+        return (_a = this.getByClient(clientID)) === null || _a === void 0 ? void 0 : _a.accountID;
     }
     /**
      * Stores arbitrary metadata in the player's session.
@@ -122,7 +133,7 @@ let PlayerService = class PlayerService {
      * @param value - The value to store.
      */
     setMeta(clientID, key, value) {
-        const player = this.playersByClient.get(clientID);
+        const player = this.getByClient(clientID);
         if (!player)
             return;
         player.setMeta(key, value);
@@ -136,16 +147,8 @@ let PlayerService = class PlayerService {
      * @returns The value cast to type `T`, or `undefined` if the key or player doesn't exist.
      */
     async getMeta(clientID, key) {
-        const player = this.playersByClient.get(clientID);
-        return await (player === null || player === void 0 ? void 0 : player.getMeta(key));
-    }
-    /**
-     * Returns a list of all currently active `Player` entities.
-     *
-     * @returns An array containing all connected players managed by this service.
-     */
-    getAll() {
-        return Array.from(this.playersByClient.values());
+        var _a;
+        return (_a = this.getByClient(clientID)) === null || _a === void 0 ? void 0 : _a.getMeta(key);
     }
     // ═══════════════════════════════════════════════════════════════
     // Extended Query Methods
@@ -157,12 +160,7 @@ let PlayerService = class PlayerService {
      * @returns The Player if found, or `undefined` if not online.
      */
     getByAccountId(accountId) {
-        for (const player of this.playersByClient.values()) {
-            if (player.accountID === accountId) {
-                return player;
-            }
-        }
-        return undefined;
+        return this.world.find(this.isPlayer).find((p) => p.accountID === accountId);
     }
     /**
      * Returns the current number of connected players.
@@ -170,7 +168,7 @@ let PlayerService = class PlayerService {
      * @returns Player count.
      */
     getPlayerCount() {
-        return this.playersByClient.size;
+        return this.world.sizeBy('player');
     }
     /**
      * Checks if a player with the given account ID is currently online.
@@ -179,22 +177,19 @@ let PlayerService = class PlayerService {
      * @returns `true` if online, `false` otherwise.
      */
     isOnline(accountId) {
-        for (const player of this.playersByClient.values()) {
-            if (player.accountID === accountId) {
-                return true;
-            }
-        }
-        return false;
+        return !!this.getByAccountId(accountId);
     }
 };
 exports.PlayerService = PlayerService;
 exports.PlayerService = PlayerService = __decorate([
     (0, tsyringe_1.injectable)(),
-    __param(0, (0, tsyringe_1.inject)(adapters_1.IPlayerInfo)),
-    __param(1, (0, tsyringe_1.inject)(IPlayerServer_1.IPlayerServer)),
-    __param(2, (0, tsyringe_1.inject)(IEntityServer_1.IEntityServer)),
-    __param(3, (0, tsyringe_1.inject)(INetTransport_1.INetTransport)),
-    __metadata("design:paramtypes", [adapters_1.IPlayerInfo,
+    __param(0, (0, tsyringe_1.inject)(world_1.WorldContext)),
+    __param(1, (0, tsyringe_1.inject)(adapters_1.IPlayerInfo)),
+    __param(2, (0, tsyringe_1.inject)(IPlayerServer_1.IPlayerServer)),
+    __param(3, (0, tsyringe_1.inject)(IEntityServer_1.IEntityServer)),
+    __param(4, (0, tsyringe_1.inject)(INetTransport_1.INetTransport)),
+    __metadata("design:paramtypes", [world_1.WorldContext,
+        adapters_1.IPlayerInfo,
         IPlayerServer_1.IPlayerServer,
         IEntityServer_1.IEntityServer,
         INetTransport_1.INetTransport])

package/dist/runtime/server/services/core/principal.service.js

@@ -11,7 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LocalPrincipalService = void 0;
 const tsyringe_1 = require("tsyringe");
-const utils_1 = require("../../../../kernel/utils");
+const app_error_1 = require("../../../../kernel/error/app.error");
 const contracts_1 = require("../../contracts");
 const principal_port_1 = require("../ports/principal.port");
 /**
@@ -102,19 +102,19 @@ let LocalPrincipalService = class LocalPrincipalService extends principal_port_1
         if (requirements.rank !== undefined) {
             const principal = await this.provider.getPrincipal(player);
             if (!principal) {
-                throw new utils_1.AppError('AUTH:UNAUTHORIZED', 'No principal found', 'core');
+                throw new app_error_1.AppError('AUTH:UNAUTHORIZED', 'No principal found', 'core');
             }
             if (principal.rank === undefined) {
-                throw new utils_1.AppError('GAME:NO_RANK_IN_PRINCIPAL', "You're trying to compare a Principal rank, but there's no defined rank!", 'core');
+                throw new app_error_1.AppError('GAME:NO_RANK_IN_PRINCIPAL', "You're trying to compare a Principal rank, but there's no defined rank!", 'core');
             }
             if (principal.rank < requirements.rank) {
-                throw new utils_1.AppError('AUTH:PERMISSION_DENIED', `Access Denied: Requires minimum rank level ${requirements.rank}`, 'core');
+                throw new app_error_1.AppError('AUTH:PERMISSION_DENIED', `Access Denied: Requires minimum rank level ${requirements.rank}`, 'core');
             }
         }
         if (requirements.permission) {
             const hasPerm = await this.hasPermission(player, requirements.permission);
             if (!hasPerm) {
-                throw new utils_1.AppError('AUTH:PERMISSION_DENIED', `Access Denied: Missing required permission '${requirements.permission}'`, 'core');
+                throw new app_error_1.AppError('AUTH:PERMISSION_DENIED', `Access Denied: Missing required permission '${requirements.permission}'`, 'core');
             }
         }
     }

package/dist/runtime/server/services/core/session-recovery.service.d.ts

@@ -1,4 +1,4 @@
-import { IPlayerServer } from '../../../../adapters/contracts/IPlayerServer';
+import { IPlayerServer } from '../../../../adapters/contracts/server/IPlayerServer';
 import { PlayerDirectoryPort } from '../ports/player-directory.port';
 import { PlayerSessionLifecyclePort } from '../ports/player-session-lifecycle.port';
 /**

package/dist/runtime/server/services/core/session-recovery.service.js

@@ -11,8 +11,8 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SessionRecoveryService = void 0;
 const tsyringe_1 = require("tsyringe");
-const IPlayerServer_1 = require("../../../../adapters/contracts/IPlayerServer");
-const logger_1 = require("../../../../kernel/shared/logger");
+const IPlayerServer_1 = require("../../../../adapters/contracts/server/IPlayerServer");
+const logger_1 = require("../../../../kernel/logger");
 const internal_event_bus_1 = require("../../bus/internal-event.bus");
 const player_directory_port_1 = require("../ports/player-directory.port");
 const player_session_lifecycle_port_1 = require("../ports/player-session-lifecycle.port");

package/dist/runtime/server/services/default/default-command-error-observer.d.ts

@@ -0,0 +1,14 @@
+import { type CommandErrorContext, CommandErrorObserverContract } from '../../contracts/security/command-error-observer.contract';
+/**
+ * Default implementation for {@link CommandErrorObserverContract}.
+ *
+ * @remarks
+ * The framework ships with a safe default that only logs.
+ * Projects can override this by registering their own observer in the DI container.
+ */
+export declare class DefaultCommandErrorObserver extends CommandErrorObserverContract {
+    /**
+     * Logs the error context using the command logger.
+     */
+    onError(ctx: CommandErrorContext): Promise<void>;
+}

package/dist/runtime/server/services/default/default-command-error-observer.js

@@ -0,0 +1,43 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultCommandErrorObserver = void 0;
+const tsyringe_1 = require("tsyringe");
+const logger_1 = require("../../../../kernel/logger");
+const command_error_observer_contract_1 = require("../../contracts/security/command-error-observer.contract");
+/**
+ * Default implementation for {@link CommandErrorObserverContract}.
+ *
+ * @remarks
+ * The framework ships with a safe default that only logs.
+ * Projects can override this by registering their own observer in the DI container.
+ */
+let DefaultCommandErrorObserver = class DefaultCommandErrorObserver extends command_error_observer_contract_1.CommandErrorObserverContract {
+    /**
+     * Logs the error context using the command logger.
+     */
+    async onError(ctx) {
+        logger_1.loggers.command.error(`Command error`, {
+            mode: ctx.mode,
+            scope: ctx.scope,
+            stage: ctx.stage,
+            command: ctx.commandName,
+            ownerResourceName: ctx.ownerResourceName,
+            playerId: ctx.player.clientId,
+            accountId: ctx.player.accountId,
+            code: ctx.error.code,
+            origin: ctx.error.origin,
+            message: ctx.error.message,
+            details: ctx.error.details,
+        });
+    }
+};
+exports.DefaultCommandErrorObserver = DefaultCommandErrorObserver;
+exports.DefaultCommandErrorObserver = DefaultCommandErrorObserver = __decorate([
+    (0, tsyringe_1.injectable)()
+], DefaultCommandErrorObserver);

package/dist/runtime/server/services/default/default-principal.provider.d.ts

@@ -0,0 +1,13 @@
+import { Server } from '../..';
+import { Principal } from '../../contracts/security/permission.types';
+import { PrincipalProviderContract } from '../../contracts/security/principal-provider.contract';
+import { LinkedID } from '../types/linked-id';
+/**
+ * Default principal provider that grants no permissions.
+ * Used when no custom principal provider is configured.
+ */
+export declare class DefaultPrincipalProvider extends PrincipalProviderContract {
+    getPrincipal(player: Server.Player): Promise<Principal | null>;
+    refreshPrincipal(_player: Server.Player): Promise<void>;
+    getPrincipalByLinkedID(linkedID: LinkedID): Promise<Principal | null>;
+}

package/dist/runtime/server/services/default/default-principal.provider.js

@@ -0,0 +1,38 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultPrincipalProvider = void 0;
+const tsyringe_1 = require("tsyringe");
+const principal_provider_contract_1 = require("../../contracts/security/principal-provider.contract");
+/**
+ * Default principal provider that grants no permissions.
+ * Used when no custom principal provider is configured.
+ */
+let DefaultPrincipalProvider = class DefaultPrincipalProvider extends principal_provider_contract_1.PrincipalProviderContract {
+    async getPrincipal(player) {
+        return {
+            id: player.accountID || player.clientID.toString(),
+            permissions: [],
+            rank: 0,
+        };
+    }
+    async refreshPrincipal(_player) {
+        // No-op
+    }
+    async getPrincipalByLinkedID(linkedID) {
+        return {
+            id: String(linkedID),
+            permissions: [],
+            rank: 0,
+        };
+    }
+};
+exports.DefaultPrincipalProvider = DefaultPrincipalProvider;
+exports.DefaultPrincipalProvider = DefaultPrincipalProvider = __decorate([
+    (0, tsyringe_1.injectable)()
+], DefaultPrincipalProvider);

package/dist/runtime/server/services/default/default-security.handler.d.ts

@@ -1,4 +1,4 @@
-import { SecurityError } from '../../../../kernel/utils/error/security.error';
+import { SecurityError } from '../../../../kernel/error/security.error';
 import { SecurityHandlerContract } from '../../contracts/security/security-handler.contract';
 import { Player } from '../../entities';
 /**

package/dist/runtime/server/services/default/default-security.handler.js

@@ -8,7 +8,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DefaultSecurityHandler = void 0;
 const tsyringe_1 = require("tsyringe");
-const logger_1 = require("../../../../kernel/shared/logger");
+const logger_1 = require("../../../../kernel/logger");
 const security_handler_contract_1 = require("../../contracts/security/security-handler.contract");
 /**
  * Default implementation of the security handler.

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

@@ -1,9 +1,6 @@
-export * from '../database';
 export * from './appearance.service';
 export { ChatService } from './chat.service';
-export { ConfigService } from './config.service';
 export { SessionRecoveryService } from './core/session-recovery.service';
-export { type HttpOptions, HttpService } from './http/http.service';
 export * from './parallel';
 export { PlayerPersistenceService } from './persistence.service';
 export * from './ports/command-execution.port';

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

@@ -15,17 +15,12 @@ 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.RateLimiterService = exports.PlayerPersistenceService = exports.HttpService = exports.SessionRecoveryService = exports.ConfigService = exports.ChatService = void 0;
-__exportStar(require("../database"), exports);
+exports.RateLimiterService = exports.PlayerPersistenceService = exports.SessionRecoveryService = exports.ChatService = void 0;
 __exportStar(require("./appearance.service"), exports);
 var chat_service_1 = require("./chat.service");
 Object.defineProperty(exports, "ChatService", { enumerable: true, get: function () { return chat_service_1.ChatService; } });
-var config_service_1 = require("./config.service");
-Object.defineProperty(exports, "ConfigService", { enumerable: true, get: function () { return config_service_1.ConfigService; } });
 var session_recovery_service_1 = require("./core/session-recovery.service");
 Object.defineProperty(exports, "SessionRecoveryService", { enumerable: true, get: function () { return session_recovery_service_1.SessionRecoveryService; } });
-var http_service_1 = require("./http/http.service");
-Object.defineProperty(exports, "HttpService", { enumerable: true, get: function () { return http_service_1.HttpService; } });
 __exportStar(require("./parallel"), exports);
 var persistence_service_1 = require("./persistence.service");
 Object.defineProperty(exports, "PlayerPersistenceService", { enumerable: true, get: function () { return persistence_service_1.PlayerPersistenceService; } });