@open-core/framework 0.1.0-alpha.1 → 0.2.0-beta.1

package/dist/adapters/node/node-ped-appearance-server.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodePedAppearanceServer = void 0;
+const IPedAppearanceServer_1 = require("../contracts/IPedAppearanceServer");
+/**
+ * Node.js stub implementation of server-side ped appearance adapter.
+ *
+ * @remarks
+ * This is a no-op implementation for testing in Node.js environment.
+ * All methods do nothing.
+ */
+class NodePedAppearanceServer extends IPedAppearanceServer_1.IPedAppearanceServer {
+    setComponentVariation() { }
+    setPropIndex() { }
+    clearProp() { }
+    setDefaultComponentVariation() { }
+}
+exports.NodePedAppearanceServer = NodePedAppearanceServer;

package/dist/adapters/node/node-player-server.d.ts

@@ -0,0 +1,27 @@
+import { IPlayerServer } from '../contracts/IPlayerServer';
+/**
+ * Node.js mock implementation of server-side player operations.
+ * Used for testing and standalone mode.
+ */
+export declare class NodePlayerServer extends IPlayerServer {
+    private players;
+    private droppedPlayers;
+    getPed(playerSrc: string): number;
+    drop(playerSrc: string, _reason: string): void;
+    getIdentifier(playerSrc: string, identifierType: string): string | undefined;
+    getIdentifiers(playerSrc: string): string[];
+    getNumIdentifiers(playerSrc: string): number;
+    getName(playerSrc: string): string;
+    getPing(playerSrc: string): number;
+    getEndpoint(playerSrc: string): string;
+    _addMockPlayer(playerSrc: string, data: {
+        ped?: number;
+        name?: string;
+        identifiers?: string[];
+        ping?: number;
+        endpoint?: string;
+    }): void;
+    _wasDropped(playerSrc: string): boolean;
+    setRoutingBucket(_playerSrc: string, _bucket: number): void;
+    _clear(): void;
+}

package/dist/adapters/node/node-player-server.js

@@ -0,0 +1,82 @@
+"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.NodePlayerServer = void 0;
+const tsyringe_1 = require("tsyringe");
+const IPlayerServer_1 = require("../contracts/IPlayerServer");
+/**
+ * Node.js mock implementation of server-side player operations.
+ * Used for testing and standalone mode.
+ */
+let NodePlayerServer = class NodePlayerServer extends IPlayerServer_1.IPlayerServer {
+    constructor() {
+        super(...arguments);
+        this.players = new Map();
+        this.droppedPlayers = [];
+    }
+    getPed(playerSrc) {
+        var _a, _b;
+        return (_b = (_a = this.players.get(playerSrc)) === null || _a === void 0 ? void 0 : _a.ped) !== null && _b !== void 0 ? _b : 0;
+    }
+    drop(playerSrc, _reason) {
+        this.droppedPlayers.push(playerSrc);
+        this.players.delete(playerSrc);
+    }
+    getIdentifier(playerSrc, identifierType) {
+        const player = this.players.get(playerSrc);
+        if (!player)
+            return undefined;
+        const prefix = `${identifierType}:`;
+        return player.identifiers.find((id) => id.startsWith(prefix));
+    }
+    getIdentifiers(playerSrc) {
+        var _a, _b;
+        return (_b = (_a = this.players.get(playerSrc)) === null || _a === void 0 ? void 0 : _a.identifiers) !== null && _b !== void 0 ? _b : [];
+    }
+    getNumIdentifiers(playerSrc) {
+        var _a, _b;
+        return (_b = (_a = this.players.get(playerSrc)) === null || _a === void 0 ? void 0 : _a.identifiers.length) !== null && _b !== void 0 ? _b : 0;
+    }
+    getName(playerSrc) {
+        var _a, _b;
+        return (_b = (_a = this.players.get(playerSrc)) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : 'Unknown';
+    }
+    getPing(playerSrc) {
+        var _a, _b;
+        return (_b = (_a = this.players.get(playerSrc)) === null || _a === void 0 ? void 0 : _a.ping) !== null && _b !== void 0 ? _b : 0;
+    }
+    getEndpoint(playerSrc) {
+        var _a, _b;
+        return (_b = (_a = this.players.get(playerSrc)) === null || _a === void 0 ? void 0 : _a.endpoint) !== null && _b !== void 0 ? _b : '';
+    }
+    // Test helpers
+    _addMockPlayer(playerSrc, data) {
+        var _a, _b, _c, _d, _e;
+        this.players.set(playerSrc, {
+            ped: (_a = data.ped) !== null && _a !== void 0 ? _a : 0,
+            name: (_b = data.name) !== null && _b !== void 0 ? _b : 'TestPlayer',
+            identifiers: (_c = data.identifiers) !== null && _c !== void 0 ? _c : [],
+            ping: (_d = data.ping) !== null && _d !== void 0 ? _d : 50,
+            endpoint: (_e = data.endpoint) !== null && _e !== void 0 ? _e : '127.0.0.1:30120',
+        });
+    }
+    _wasDropped(playerSrc) {
+        return this.droppedPlayers.includes(playerSrc);
+    }
+    setRoutingBucket(_playerSrc, _bucket) {
+        // Mock: no-op in Node.js
+    }
+    _clear() {
+        this.players.clear();
+        this.droppedPlayers = [];
+    }
+};
+exports.NodePlayerServer = NodePlayerServer;
+exports.NodePlayerServer = NodePlayerServer = __decorate([
+    (0, tsyringe_1.injectable)()
+], NodePlayerServer);

package/dist/adapters/node/node-playerinfo.d.ts

@@ -0,0 +1,6 @@
+import { Vector3 } from '../../kernel';
+import { IPlayerInfo } from '../contracts/IPlayerInfo';
+export declare class NodePlayerInfo implements IPlayerInfo {
+    getPlayerName(clientId: number): string | null;
+    getPlayerPosition(_clientId: number): Vector3 | undefined;
+}

package/dist/adapters/node/node-playerinfo.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodePlayerInfo = void 0;
+class NodePlayerInfo {
+    getPlayerName(clientId) {
+        return `Player${clientId.toString()}`;
+    }
+    getPlayerPosition(_clientId) {
+        return { x: 6, y: 7, z: 6 };
+    }
+}
+exports.NodePlayerInfo = NodePlayerInfo;

package/dist/adapters/node/node-resourceinfo.d.ts

@@ -0,0 +1,12 @@
+import { IResourceInfo } from '../contracts/IResourceInfo';
+/**
+ * Node.js implementation of IResourceInfo.
+ * Suitable for testing and non-FiveM runtime environments.
+ *
+ * Resource name is determined by:
+ * 1. RESOURCE_NAME environment variable
+ * 2. Fallback to 'default'
+ */
+export declare class NodeResourceInfo implements IResourceInfo {
+    getCurrentResourceName(): string;
+}

package/dist/adapters/node/node-resourceinfo.js

@@ -0,0 +1,27 @@
+"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.NodeResourceInfo = void 0;
+const tsyringe_1 = require("tsyringe");
+/**
+ * Node.js implementation of IResourceInfo.
+ * Suitable for testing and non-FiveM runtime environments.
+ *
+ * Resource name is determined by:
+ * 1. RESOURCE_NAME environment variable
+ * 2. Fallback to 'default'
+ */
+let NodeResourceInfo = class NodeResourceInfo {
+    getCurrentResourceName() {
+        return process.env.RESOURCE_NAME || 'default';
+    }
+};
+exports.NodeResourceInfo = NodeResourceInfo;
+exports.NodeResourceInfo = NodeResourceInfo = __decorate([
+    (0, tsyringe_1.injectable)()
+], NodeResourceInfo);

package/dist/adapters/node/node-tick.d.ts

@@ -0,0 +1,10 @@
+import { ITick } from '../contracts/ITick';
+/**
+ * Node.js implementation of ITick using setInterval.
+ * Default tick interval: 0ms (next tick via setImmediate for high frequency)
+ */
+export declare class NodeTick implements ITick {
+    private tickInterval;
+    constructor(tickInterval?: number);
+    setTick(handler: () => void | Promise<void>): void;
+}

package/dist/{server/system/processors/command.processor.js → adapters/node/node-tick.js}

@@ -9,22 +9,35 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommandProcessor = void 0;
+exports.NodeTick = void 0;
 const tsyringe_1 = require("tsyringe");
-const metadata_server_keys_1 = require("../metadata-server.keys");
-const services_1 = require("../../services");
-let CommandProcessor = class CommandProcessor {
-    constructor(commandService) {
-        this.commandService = commandService;
-        this.metadataKey = metadata_server_keys_1.METADATA_KEYS.COMMAND;
+/**
+ * Node.js implementation of ITick using setInterval.
+ * Default tick interval: 0ms (next tick via setImmediate for high frequency)
+ */
+let NodeTick = class NodeTick {
+    constructor(tickInterval = 0) {
+        this.tickInterval = tickInterval;
     }
-    process(target, methodName, metadata) {
-        const handler = target[methodName].bind(target);
-        this.commandService.register(metadata, handler);
+    setTick(handler) {
+        if (this.tickInterval === 0) {
+            // High-frequency tick using setImmediate (similar to FiveM's every-frame tick)
+            const tick = async () => {
+                await handler();
+                setImmediate(tick);
+            };
+            setImmediate(tick);
+        }
+        else {
+            // Interval-based tick
+            setInterval(async () => {
+                await handler();
+            }, this.tickInterval);
+        }
     }
 };
-exports.CommandProcessor = CommandProcessor;
-exports.CommandProcessor = CommandProcessor = __decorate([
+exports.NodeTick = NodeTick;
+exports.NodeTick = NodeTick = __decorate([
     (0, tsyringe_1.injectable)(),
-    __metadata("design:paramtypes", [services_1.CommandService])
-], CommandProcessor);
+    __metadata("design:paramtypes", [Number])
+], NodeTick);

package/dist/adapters/node/node-vehicle-server.d.ts

@@ -0,0 +1,21 @@
+import { IVehicleServer } from '../contracts/IVehicleServer';
+/**
+ * Node.js mock implementation of server-side vehicle operations.
+ * Used for testing and standalone mode.
+ */
+export declare class NodeVehicleServer extends IVehicleServer {
+    private vehicles;
+    private nextHandle;
+    private nextNetworkId;
+    createServerSetter(modelHash: number, _vehicleType: string, _x: number, _y: number, _z: number, _heading: number): number;
+    getColours(handle: number): [number, number];
+    setColours(handle: number, primary: number, secondary: number): void;
+    getNumberPlateText(handle: number): string;
+    setNumberPlateText(handle: number, text: string): void;
+    setDoorsLocked(handle: number, state: number): void;
+    getNetworkIdFromEntity(handle: number): number;
+    getEntityFromNetworkId(networkId: number): number;
+    networkIdExists(networkId: number): boolean;
+    _deleteVehicle(handle: number): void;
+    _vehicleExists(handle: number): boolean;
+}

package/dist/adapters/node/node-vehicle-server.js

@@ -0,0 +1,93 @@
+"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.NodeVehicleServer = void 0;
+const tsyringe_1 = require("tsyringe");
+const IVehicleServer_1 = require("../contracts/IVehicleServer");
+/**
+ * Node.js mock implementation of server-side vehicle operations.
+ * Used for testing and standalone mode.
+ */
+let NodeVehicleServer = class NodeVehicleServer extends IVehicleServer_1.IVehicleServer {
+    constructor() {
+        super(...arguments);
+        this.vehicles = new Map();
+        this.nextHandle = 1000;
+        this.nextNetworkId = 1;
+    }
+    createServerSetter(modelHash, _vehicleType, _x, _y, _z, _heading) {
+        const handle = this.nextHandle++;
+        const networkId = this.nextNetworkId++;
+        this.vehicles.set(handle, {
+            model: modelHash,
+            colors: [0, 0],
+            plate: '',
+            doorsLocked: 1,
+            networkId,
+        });
+        return handle;
+    }
+    getColours(handle) {
+        var _a, _b;
+        return (_b = (_a = this.vehicles.get(handle)) === null || _a === void 0 ? void 0 : _a.colors) !== null && _b !== void 0 ? _b : [0, 0];
+    }
+    setColours(handle, primary, secondary) {
+        const vehicle = this.vehicles.get(handle);
+        if (vehicle) {
+            vehicle.colors = [primary, secondary];
+        }
+    }
+    getNumberPlateText(handle) {
+        var _a, _b;
+        return (_b = (_a = this.vehicles.get(handle)) === null || _a === void 0 ? void 0 : _a.plate) !== null && _b !== void 0 ? _b : '';
+    }
+    setNumberPlateText(handle, text) {
+        const vehicle = this.vehicles.get(handle);
+        if (vehicle) {
+            vehicle.plate = text.substring(0, 8);
+        }
+    }
+    setDoorsLocked(handle, state) {
+        const vehicle = this.vehicles.get(handle);
+        if (vehicle) {
+            vehicle.doorsLocked = state;
+        }
+    }
+    getNetworkIdFromEntity(handle) {
+        var _a, _b;
+        return (_b = (_a = this.vehicles.get(handle)) === null || _a === void 0 ? void 0 : _a.networkId) !== null && _b !== void 0 ? _b : 0;
+    }
+    getEntityFromNetworkId(networkId) {
+        for (const [handle, vehicle] of this.vehicles) {
+            if (vehicle.networkId === networkId) {
+                return handle;
+            }
+        }
+        return 0;
+    }
+    networkIdExists(networkId) {
+        for (const vehicle of this.vehicles.values()) {
+            if (vehicle.networkId === networkId) {
+                return true;
+            }
+        }
+        return false;
+    }
+    // Test helper: delete vehicle
+    _deleteVehicle(handle) {
+        this.vehicles.delete(handle);
+    }
+    // Test helper: check if vehicle exists
+    _vehicleExists(handle) {
+        return this.vehicles.has(handle);
+    }
+};
+exports.NodeVehicleServer = NodeVehicleServer;
+exports.NodeVehicleServer = NodeVehicleServer = __decorate([
+    (0, tsyringe_1.injectable)()
+], NodeVehicleServer);

package/dist/adapters/register-capabilities.d.ts

@@ -0,0 +1,11 @@
+export type Platform = 'fivem' | 'node';
+/**
+ * Registers server-side platform-specific capability implementations.
+ *
+ * @remarks
+ * This function registers adapters needed by the SERVER runtime only.
+ * Client-side adapters are registered separately via `registerClientCapabilities`.
+ *
+ * @param platform - Optional platform override. If not provided, platform is auto-detected.
+ */
+export declare function registerServerCapabilities(platform?: Platform): Promise<void>;

package/dist/adapters/register-capabilities.js

@@ -0,0 +1,148 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerServerCapabilities = registerServerCapabilities;
+const container_1 = require("../kernel/di/container");
+const IEngineEvents_1 = require("./contracts/IEngineEvents");
+const IEntityServer_1 = require("./contracts/IEntityServer");
+const IExports_1 = require("./contracts/IExports");
+const IHasher_1 = require("./contracts/IHasher");
+const INetTransport_1 = require("./contracts/INetTransport");
+const IPedAppearanceServer_1 = require("./contracts/IPedAppearanceServer");
+const IPlayerInfo_1 = require("./contracts/IPlayerInfo");
+const IPlayerServer_1 = require("./contracts/IPlayerServer");
+const IResourceInfo_1 = require("./contracts/IResourceInfo");
+const ITick_1 = require("./contracts/ITick");
+const IVehicleServer_1 = require("./contracts/IVehicleServer");
+/**
+ * Detects the current runtime platform
+ */
+function detectPlatform() {
+    // Check for FiveM-specific globals
+    if (typeof globalThis.GetCurrentResourceName === 'function') {
+        return 'fivem';
+    }
+    return 'node';
+}
+/**
+ * Registers server-side platform-specific capability implementations.
+ *
+ * @remarks
+ * This function registers adapters needed by the SERVER runtime only.
+ * Client-side adapters are registered separately via `registerClientCapabilities`.
+ *
+ * @param platform - Optional platform override. If not provided, platform is auto-detected.
+ */
+async function registerServerCapabilities(platform) {
+    const targetPlatform = platform !== null && platform !== void 0 ? platform : detectPlatform();
+    if (targetPlatform === 'node') {
+        // Dynamically import Node.js implementations only when needed
+        const [{ NodeNetTransport }, { NodeEngineEvents }, { NodeExports }, { NodeResourceInfo }, { NodeTick }, { NodePlayerInfo }, { NodeEntityServer }, { NodeVehicleServer }, { NodePlayerServer }, { NodeHasher }, { NodePedAppearanceServer },] = await Promise.all([
+            Promise.resolve().then(() => __importStar(require('./node/node-net-transport'))),
+            Promise.resolve().then(() => __importStar(require('./node/node-engine-events'))),
+            Promise.resolve().then(() => __importStar(require('./node/node-exports'))),
+            Promise.resolve().then(() => __importStar(require('./node/node-resourceinfo'))),
+            Promise.resolve().then(() => __importStar(require('./node/node-tick'))),
+            Promise.resolve().then(() => __importStar(require('./node/node-playerinfo'))),
+            Promise.resolve().then(() => __importStar(require('./node/node-entity-server'))),
+            Promise.resolve().then(() => __importStar(require('./node/node-vehicle-server'))),
+            Promise.resolve().then(() => __importStar(require('./node/node-player-server'))),
+            Promise.resolve().then(() => __importStar(require('./node/node-hasher'))),
+            Promise.resolve().then(() => __importStar(require('./node/node-ped-appearance-server'))),
+        ]);
+        // Register Node.js implementations (server-side only)
+        if (!container_1.di.isRegistered(INetTransport_1.INetTransport))
+            container_1.di.registerSingleton(INetTransport_1.INetTransport, NodeNetTransport);
+        if (!container_1.di.isRegistered(IEngineEvents_1.IEngineEvents))
+            container_1.di.registerSingleton(IEngineEvents_1.IEngineEvents, NodeEngineEvents);
+        if (!container_1.di.isRegistered(IExports_1.IExports))
+            container_1.di.registerSingleton(IExports_1.IExports, NodeExports);
+        if (!container_1.di.isRegistered(IResourceInfo_1.IResourceInfo))
+            container_1.di.registerSingleton(IResourceInfo_1.IResourceInfo, NodeResourceInfo);
+        if (!container_1.di.isRegistered(ITick_1.ITick))
+            container_1.di.registerSingleton(ITick_1.ITick, NodeTick);
+        if (!container_1.di.isRegistered(IPlayerInfo_1.IPlayerInfo))
+            container_1.di.registerSingleton(IPlayerInfo_1.IPlayerInfo, NodePlayerInfo);
+        if (!container_1.di.isRegistered(IEntityServer_1.IEntityServer))
+            container_1.di.registerSingleton(IEntityServer_1.IEntityServer, NodeEntityServer);
+        if (!container_1.di.isRegistered(IVehicleServer_1.IVehicleServer))
+            container_1.di.registerSingleton(IVehicleServer_1.IVehicleServer, NodeVehicleServer);
+        if (!container_1.di.isRegistered(IPlayerServer_1.IPlayerServer))
+            container_1.di.registerSingleton(IPlayerServer_1.IPlayerServer, NodePlayerServer);
+        if (!container_1.di.isRegistered(IHasher_1.IHasher))
+            container_1.di.registerSingleton(IHasher_1.IHasher, NodeHasher);
+        if (!container_1.di.isRegistered(IPedAppearanceServer_1.IPedAppearanceServer))
+            container_1.di.registerSingleton(IPedAppearanceServer_1.IPedAppearanceServer, NodePedAppearanceServer);
+    }
+    else {
+        // Dynamically import FiveM implementations only when needed
+        const [{ FiveMNetTransport }, { FiveMEngineEvents }, { FiveMExports }, { FiveMResourceInfo }, { FiveMTick }, { FiveMPlayerInfo }, { FiveMEntityServer }, { FiveMVehicleServer }, { FiveMPlayerServer }, { FiveMHasher }, { FiveMPedAppearanceServerAdapter },] = await Promise.all([
+            Promise.resolve().then(() => __importStar(require('./fivem/fivem-net-transport'))),
+            Promise.resolve().then(() => __importStar(require('./fivem/fivem-engine-events'))),
+            Promise.resolve().then(() => __importStar(require('./fivem/fivem-exports'))),
+            Promise.resolve().then(() => __importStar(require('./fivem/fivem-resourceinfo'))),
+            Promise.resolve().then(() => __importStar(require('./fivem/fivem-tick'))),
+            Promise.resolve().then(() => __importStar(require('./fivem/fivem-playerinfo'))),
+            Promise.resolve().then(() => __importStar(require('./fivem/fivem-entity-server'))),
+            Promise.resolve().then(() => __importStar(require('./fivem/fivem-vehicle-server'))),
+            Promise.resolve().then(() => __importStar(require('./fivem/fivem-player-server'))),
+            Promise.resolve().then(() => __importStar(require('./fivem/fivem-hasher'))),
+            Promise.resolve().then(() => __importStar(require('./fivem/fivem-ped-appearance-server'))),
+        ]);
+        // Register FiveM implementations (server-side only)
+        if (!container_1.di.isRegistered(INetTransport_1.INetTransport))
+            container_1.di.registerSingleton(INetTransport_1.INetTransport, FiveMNetTransport);
+        if (!container_1.di.isRegistered(IEngineEvents_1.IEngineEvents))
+            container_1.di.registerSingleton(IEngineEvents_1.IEngineEvents, FiveMEngineEvents);
+        if (!container_1.di.isRegistered(IExports_1.IExports))
+            container_1.di.registerSingleton(IExports_1.IExports, FiveMExports);
+        if (!container_1.di.isRegistered(IResourceInfo_1.IResourceInfo))
+            container_1.di.registerSingleton(IResourceInfo_1.IResourceInfo, FiveMResourceInfo);
+        if (!container_1.di.isRegistered(ITick_1.ITick))
+            container_1.di.registerSingleton(ITick_1.ITick, FiveMTick);
+        if (!container_1.di.isRegistered(IPlayerInfo_1.IPlayerInfo))
+            container_1.di.registerSingleton(IPlayerInfo_1.IPlayerInfo, FiveMPlayerInfo);
+        if (!container_1.di.isRegistered(IEntityServer_1.IEntityServer))
+            container_1.di.registerSingleton(IEntityServer_1.IEntityServer, FiveMEntityServer);
+        if (!container_1.di.isRegistered(IVehicleServer_1.IVehicleServer))
+            container_1.di.registerSingleton(IVehicleServer_1.IVehicleServer, FiveMVehicleServer);
+        if (!container_1.di.isRegistered(IPlayerServer_1.IPlayerServer))
+            container_1.di.registerSingleton(IPlayerServer_1.IPlayerServer, FiveMPlayerServer);
+        if (!container_1.di.isRegistered(IHasher_1.IHasher))
+            container_1.di.registerSingleton(IHasher_1.IHasher, FiveMHasher);
+        if (!container_1.di.isRegistered(IPedAppearanceServer_1.IPedAppearanceServer))
+            container_1.di.registerSingleton(IPedAppearanceServer_1.IPedAppearanceServer, FiveMPedAppearanceServerAdapter);
+    }
+}

package/dist/adapters/register-client-capabilities.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Registers client-side platform-specific capability implementations.
+ *
+ * @remarks
+ * This function registers adapters needed by the CLIENT runtime only.
+ * Should be called during client bootstrap before services that depend on these adapters.
+ */
+export declare function registerClientCapabilities(): Promise<void>;

package/dist/adapters/register-client-capabilities.js

@@ -0,0 +1,56 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerClientCapabilities = registerClientCapabilities;
+const client_container_1 = require("../runtime/client/client-container");
+const IHasher_1 = require("./contracts/IHasher");
+const IPedAppearanceClient_1 = require("./contracts/IPedAppearanceClient");
+/**
+ * Registers client-side platform-specific capability implementations.
+ *
+ * @remarks
+ * This function registers adapters needed by the CLIENT runtime only.
+ * Should be called during client bootstrap before services that depend on these adapters.
+ */
+async function registerClientCapabilities() {
+    const [{ FiveMPedAppearanceClientAdapter }, { FiveMHasher }] = await Promise.all([
+        Promise.resolve().then(() => __importStar(require('./fivem/fivem-ped-appearance-client'))),
+        Promise.resolve().then(() => __importStar(require('./fivem/fivem-hasher'))),
+    ]);
+    if (!client_container_1.di.isRegistered(IPedAppearanceClient_1.IPedAppearanceClient))
+        client_container_1.di.registerSingleton(IPedAppearanceClient_1.IPedAppearanceClient, FiveMPedAppearanceClientAdapter);
+    if (!client_container_1.di.isRegistered(IHasher_1.IHasher))
+        client_container_1.di.registerSingleton(IHasher_1.IHasher, FiveMHasher);
+}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import 'reflect-metadata';
-export * as Utils from './utils';
-export * as Shared from './shared';
-export * as Server from './server';
-export * as Client from './client';
+export { type Infer, type Input, type Output, z } from './kernel/schema';
+export * as Shared from './kernel/shared';
+export * as Utils from './kernel/utils';
+export * as Client from './runtime/client';
+export * as Server from './runtime/server';

package/dist/index.js

@@ -33,9 +33,13 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Client = exports.Server = exports.Shared = exports.Utils = void 0;
+exports.Server = exports.Client = exports.Utils = exports.Shared = exports.z = void 0;
 require("reflect-metadata");
-exports.Utils = __importStar(require("./utils"));
-exports.Shared = __importStar(require("./shared"));
-exports.Server = __importStar(require("./server"));
-exports.Client = __importStar(require("./client"));
+// Schema utilities at root level for convenient imports
+// Usage: import { z, Infer } from '@open-core/framework'
+var schema_1 = require("./kernel/schema");
+Object.defineProperty(exports, "z", { enumerable: true, get: function () { return schema_1.z; } });
+exports.Shared = __importStar(require("./kernel/shared"));
+exports.Utils = __importStar(require("./kernel/utils"));
+exports.Client = __importStar(require("./runtime/client"));
+exports.Server = __importStar(require("./runtime/server"));

package/dist/kernel/di/index.d.ts

@@ -0,0 +1,4 @@
+export * from './class-constructor';
+export * from './container';
+export * from './decorator-processor';
+export * from './metadata.scanner';