@open-core/framework 1.0.2-beta.1 → 1.0.5-beta.1

package/dist/client/system/processors/nui.processor.js

@@ -1,40 +0,0 @@
-"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.NuiProcessor = void 0;
-const tsyringe_1 = require("tsyringe");
-const metadata_client_keys_1 = require("../metadata-client.keys");
-const logger_1 = require("../../../shared/logger");
-let NuiProcessor = class NuiProcessor {
-    constructor() {
-        this.metadataKey = metadata_client_keys_1.METADATA_KEYS.NUI;
-    }
-    process(target, methodName, metadata) {
-        const handler = target[methodName].bind(target);
-        const handlerName = `${target.constructor.name}.${methodName}`;
-        RegisterNuiCallbackType(metadata.eventName);
-        on(`__cfx_nui:${metadata.eventName}`, async (data, cb) => {
-            try {
-                await handler(data);
-                cb({ ok: true });
-            }
-            catch (error) {
-                logger_1.loggers.nui.error(`NUI callback error`, {
-                    event: metadata.eventName,
-                    handler: handlerName,
-                }, error);
-                cb({ ok: false, error: String(error) });
-            }
-        });
-        logger_1.loggers.nui.debug(`Registered: ${metadata.eventName} -> ${handlerName}`);
-    }
-};
-exports.NuiProcessor = NuiProcessor;
-exports.NuiProcessor = NuiProcessor = __decorate([
-    (0, tsyringe_1.injectable)()
-], NuiProcessor);

package/dist/client/system/processors/resourceLifecycle.processor.d.ts

@@ -1,9 +0,0 @@
-import { DecoratorProcessor } from '../../../system/decorator-processor';
-export declare class ResourceStartProcessor implements DecoratorProcessor {
-    readonly metadataKey: string;
-    process(target: any, methodName: string): void;
-}
-export declare class ResourceStopProcessor implements DecoratorProcessor {
-    readonly metadataKey: string;
-    process(target: any, methodName: string): void;
-}

package/dist/client/system/processors/resourceLifecycle.processor.js

@@ -1,69 +0,0 @@
-"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.ResourceStopProcessor = exports.ResourceStartProcessor = void 0;
-const tsyringe_1 = require("tsyringe");
-const metadata_client_keys_1 = require("../metadata-client.keys");
-const logger_1 = require("../../../shared/logger");
-const clientLifecycle = logger_1.coreLogger.child('Lifecycle', logger_1.LogDomain.CLIENT);
-let ResourceStartProcessor = class ResourceStartProcessor {
-    constructor() {
-        this.metadataKey = metadata_client_keys_1.METADATA_KEYS.RESOURCE_START;
-    }
-    process(target, methodName) {
-        const handler = target[methodName].bind(target);
-        const handlerName = `${target.constructor.name}.${methodName}`;
-        const currentResource = GetCurrentResourceName();
-        on('onClientResourceStart', async (resourceName) => {
-            if (resourceName !== currentResource)
-                return;
-            try {
-                await handler(resourceName);
-            }
-            catch (error) {
-                clientLifecycle.error(`Resource start handler error`, {
-                    handler: handlerName,
-                    resource: resourceName,
-                }, error);
-            }
-        });
-        clientLifecycle.debug(`Registered resource start handler: ${handlerName}`);
-    }
-};
-exports.ResourceStartProcessor = ResourceStartProcessor;
-exports.ResourceStartProcessor = ResourceStartProcessor = __decorate([
-    (0, tsyringe_1.injectable)()
-], ResourceStartProcessor);
-let ResourceStopProcessor = class ResourceStopProcessor {
-    constructor() {
-        this.metadataKey = metadata_client_keys_1.METADATA_KEYS.RESOURCE_STOP;
-    }
-    process(target, methodName) {
-        const handler = target[methodName].bind(target);
-        const handlerName = `${target.constructor.name}.${methodName}`;
-        const currentResource = GetCurrentResourceName();
-        on('onClientResourceStop', async (resourceName) => {
-            if (resourceName !== currentResource)
-                return;
-            try {
-                await handler(resourceName);
-            }
-            catch (error) {
-                clientLifecycle.error(`Resource stop handler error`, {
-                    handler: handlerName,
-                    resource: resourceName,
-                }, error);
-            }
-        });
-        clientLifecycle.debug(`Registered resource stop handler: ${handlerName}`);
-    }
-};
-exports.ResourceStopProcessor = ResourceStopProcessor;
-exports.ResourceStopProcessor = ResourceStopProcessor = __decorate([
-    (0, tsyringe_1.injectable)()
-], ResourceStopProcessor);

package/dist/client/system/processors/tick.processor.d.ts

@@ -1,5 +0,0 @@
-import { DecoratorProcessor } from '../../../system/decorator-processor';
-export declare class TickProcessor implements DecoratorProcessor {
-    readonly metadataKey: string;
-    process(target: any, methodName: string): void;
-}

package/dist/client/system/processors/tick.processor.js

@@ -1,37 +0,0 @@
-"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.TickProcessor = void 0;
-const tsyringe_1 = require("tsyringe");
-const metadata_client_keys_1 = require("../metadata-client.keys");
-const logger_1 = require("../../../shared/logger");
-const clientTick = logger_1.coreLogger.child('Tick', logger_1.LogDomain.CLIENT);
-let TickProcessor = class TickProcessor {
-    constructor() {
-        this.metadataKey = metadata_client_keys_1.METADATA_KEYS.TICK;
-    }
-    process(target, methodName) {
-        const handler = target[methodName].bind(target);
-        const handlerName = `${target.constructor.name}.${methodName}`;
-        setTick(async () => {
-            try {
-                await handler();
-            }
-            catch (error) {
-                clientTick.error(`Tick handler error`, {
-                    handler: handlerName,
-                }, error);
-            }
-        });
-        clientTick.debug(`Registered: ${handlerName}`);
-    }
-};
-exports.TickProcessor = TickProcessor;
-exports.TickProcessor = TickProcessor = __decorate([
-    (0, tsyringe_1.injectable)()
-], TickProcessor);

package/dist/client/system/processors.register.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerSystemClient = registerSystemClient;
-const client_container_1 = require("../client-container");
-const key_processor_1 = require("./processors/key.processor");
-const tick_processor_1 = require("./processors/tick.processor");
-const nui_processor_1 = require("./processors/nui.processor");
-const netEvent_processor_1 = require("./processors/netEvent.processor");
-const localEvent_processor_1 = require("./processors/localEvent.processor");
-const interval_processor_1 = require("./processors/interval.processor");
-const export_processor_1 = require("./processors/export.processor");
-const resourceLifecycle_processor_1 = require("./processors/resourceLifecycle.processor");
-const gameEvent_processor_1 = require("./processors/gameEvent.processor");
-function registerSystemClient() {
-    // Core processors
-    client_container_1.di.register('DecoratorProcessor', { useClass: key_processor_1.KeyMappingProcessor });
-    client_container_1.di.register('DecoratorProcessor', { useClass: tick_processor_1.TickProcessor });
-    client_container_1.di.register('DecoratorProcessor', { useClass: nui_processor_1.NuiProcessor });
-    client_container_1.di.register('DecoratorProcessor', { useClass: netEvent_processor_1.ClientNetEventProcessor });
-    // New processors
-    client_container_1.di.register('DecoratorProcessor', { useClass: localEvent_processor_1.LocalEventProcessor });
-    client_container_1.di.register('DecoratorProcessor', { useClass: interval_processor_1.IntervalProcessor });
-    client_container_1.di.register('DecoratorProcessor', { useClass: export_processor_1.ClientExportProcessor });
-    client_container_1.di.register('DecoratorProcessor', { useClass: resourceLifecycle_processor_1.ResourceStartProcessor });
-    client_container_1.di.register('DecoratorProcessor', { useClass: resourceLifecycle_processor_1.ResourceStopProcessor });
-    client_container_1.di.register('DecoratorProcessor', { useClass: gameEvent_processor_1.GameEventProcessor });
-}

package/dist/client/types/game-events.d.ts

@@ -1,126 +0,0 @@
-/**
- * Game Events - Native GTA V internal events captured by FiveM
- *
- * Documentation: https://docs.fivem.net/docs/game-references/game-events/
- *
- * These are low-level events from the RAGE engine. The arguments are
- * passed as arrays from the native layer.
- */
-export type GameEventName = 'CEventNetworkEntityDamage' | 'CEventNetworkPlayerEnteredVehicle' | 'CEventNetworkPlayerLeftVehicle' | 'CEventNetworkVehicleUndrivable' | 'CEventNetworkPlayerSpawn' | 'CEventNetworkPlayerCollectedPickup' | 'CEventNetworkPlayerCollectedAmbientPickup' | 'CEventShockingSeenPedKilled' | 'CEventShockingWeaponThreat' | 'CEventShockingGunshotFired' | 'CEventShockingExplosion' | 'CEventGunShot' | 'CEventGunShotWhizzedBy' | 'CEventExplosionHeard' | 'CEventShockingCarCrash' | 'CEventShockingBicycleCrash' | 'CEventShockingSeenCarStolen' | (string & {});
-/**
- * CEventNetworkEntityDamage
- * Fired when any networked entity takes damage
- */
-export interface EntityDamageEvent {
-    /** Entity that was damaged */
-    victim: number;
-    /** Entity that caused the damage (0 if none) */
-    attacker: number;
-    /** Unknown parameter */
-    arg2: number;
-    /** Unknown parameter */
-    arg3: number;
-    /** Unknown parameter */
-    arg4: number;
-    /** Whether the victim died from this damage */
-    victimDied: boolean;
-    /** Weapon hash used */
-    weaponHash: number;
-    /** Unknown parameter */
-    arg7: number;
-    /** Unknown parameter */
-    arg8: number;
-    /** Unknown parameter - possibly damage amount related */
-    arg9: number;
-}
-/**
- * CEventNetworkPlayerEnteredVehicle
- * Fired when a player enters a vehicle
- */
-export interface PlayerEnteredVehicleEvent {
-    /** Player that entered */
-    player: number;
-    /** Vehicle entered */
-    vehicle: number;
-}
-/**
- * CEventNetworkPlayerLeftVehicle
- * Fired when a player leaves a vehicle
- */
-export interface PlayerLeftVehicleEvent {
-    /** Player that left */
-    player: number;
-    /** Vehicle left */
-    vehicle: number;
-}
-/**
- * CEventShockingSeenPedKilled
- * Fired when a ped witnesses another ped being killed
- */
-export interface SeenPedKilledEvent {
-    /** Ped that witnessed the death */
-    witness: number;
-    /** Ped that was killed */
-    victim: number;
-}
-/**
- * CEventGunShot
- * Fired when a weapon is fired
- */
-export interface GunShotEvent {
-    /** Entity that fired */
-    shooter: number;
-    /** Target coordinates */
-    coords: {
-        x: number;
-        y: number;
-        z: number;
-    };
-}
-/**
- * CEventNetworkVehicleUndrivable
- * Fired when a vehicle becomes undrivable (destroyed)
- */
-export interface VehicleUndrivableEvent {
-    /** Vehicle that became undrivable */
-    vehicle: number;
-    /** Entity responsible (if any) */
-    attacker: number;
-    /** Weapon hash that caused it */
-    weaponHash: number;
-}
-export declare const GameEventParsers: {
-    /**
-     * Parse CEventNetworkEntityDamage arguments
-     */
-    parseEntityDamage(args: number[]): EntityDamageEvent;
-    /**
-     * Parse CEventNetworkPlayerEnteredVehicle arguments
-     */
-    parsePlayerEnteredVehicle(args: number[]): PlayerEnteredVehicleEvent;
-    /**
-     * Parse CEventNetworkPlayerLeftVehicle arguments
-     */
-    parsePlayerLeftVehicle(args: number[]): PlayerLeftVehicleEvent;
-    /**
-     * Parse CEventShockingSeenPedKilled arguments
-     */
-    parseSeenPedKilled(args: number[]): SeenPedKilledEvent;
-    /**
-     * Parse CEventNetworkVehicleUndrivable arguments
-     */
-    parseVehicleUndrivable(args: number[]): VehicleUndrivableEvent;
-    /**
-     * Parse CEventGunShot arguments
-     */
-    parseGunShot(args: number[]): GunShotEvent;
-};
-export interface GameEventMap {
-    CEventNetworkEntityDamage: EntityDamageEvent;
-    CEventNetworkPlayerEnteredVehicle: PlayerEnteredVehicleEvent;
-    CEventNetworkPlayerLeftVehicle: PlayerLeftVehicleEvent;
-    CEventShockingSeenPedKilled: SeenPedKilledEvent;
-    CEventNetworkVehicleUndrivable: VehicleUndrivableEvent;
-    CEventGunShot: GunShotEvent;
-    [key: string]: unknown;
-}

package/dist/client/types/game-events.js

@@ -1,83 +0,0 @@
-"use strict";
-/**
- * Game Events - Native GTA V internal events captured by FiveM
- *
- * Documentation: https://docs.fivem.net/docs/game-references/game-events/
- *
- * These are low-level events from the RAGE engine. The arguments are
- * passed as arrays from the native layer.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GameEventParsers = void 0;
-// ─────────────────────────────────────────────────────────────────────────────
-// Event Parsers - Convert raw args to typed objects
-// ─────────────────────────────────────────────────────────────────────────────
-exports.GameEventParsers = {
-    /**
-     * Parse CEventNetworkEntityDamage arguments
-     */
-    parseEntityDamage(args) {
-        return {
-            victim: args[0],
-            attacker: args[1],
-            arg2: args[2],
-            arg3: args[3],
-            arg4: args[4],
-            victimDied: args[5] === 1,
-            weaponHash: args[6],
-            arg7: args[7],
-            arg8: args[8],
-            arg9: args[9],
-        };
-    },
-    /**
-     * Parse CEventNetworkPlayerEnteredVehicle arguments
-     */
-    parsePlayerEnteredVehicle(args) {
-        return {
-            player: args[0],
-            vehicle: args[1],
-        };
-    },
-    /**
-     * Parse CEventNetworkPlayerLeftVehicle arguments
-     */
-    parsePlayerLeftVehicle(args) {
-        return {
-            player: args[0],
-            vehicle: args[1],
-        };
-    },
-    /**
-     * Parse CEventShockingSeenPedKilled arguments
-     */
-    parseSeenPedKilled(args) {
-        return {
-            witness: args[0],
-            victim: args[1],
-        };
-    },
-    /**
-     * Parse CEventNetworkVehicleUndrivable arguments
-     */
-    parseVehicleUndrivable(args) {
-        return {
-            vehicle: args[0],
-            attacker: args[1],
-            weaponHash: args[2],
-        };
-    },
-    /**
-     * Parse CEventGunShot arguments
-     */
-    parseGunShot(args) {
-        return {
-            shooter: args[0],
-            coords: {
-                x: args[1],
-                y: args[2],
-                z: args[3],
-            },
-        };
-    },
-};

package/dist/client/types/index.js

@@ -1,17 +0,0 @@
-"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("./game-events"), exports);

package/dist/client/ui-bridge.js

@@ -1,201 +0,0 @@
-"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.NUI = exports.NuiBridge = void 0;
-const tsyringe_1 = require("tsyringe");
-const logger_1 = require("../shared/logger");
-const nuiLogger = logger_1.coreLogger.child('NUI', logger_1.LogDomain.CLIENT);
-/**
- * Type-safe NUI (Native UI) Bridge for client-server communication.
- *
- * Generic types allow for full type safety when sending/receiving messages.
- * Define your event maps and pass them as type parameters.
- *
- * @example
- * ```typescript
- * interface ClientToUI {
- *   'showMenu': { items: string[] }
- *   'hideMenu': void
- * }
- *
- * interface UIToClient {
- *   'menuItemSelected': { index: number }
- *   'menuClosed': void
- * }
- *
- * const nui = new NuiBridge<ClientToUI, UIToClient>()
- * nui.send('showMenu', { items: ['Option 1', 'Option 2'] })
- * nui.on('menuItemSelected', async (data) => console.log(data.index))
- * ```
- */
-let NuiBridge = class NuiBridge {
-    constructor() {
-        this._isVisible = false;
-        this._hasFocus = false;
-        this._hasCursor = false;
-    }
-    /**
-     * Whether the NUI frame is currently visible
-     */
-    get isVisible() {
-        return this._isVisible;
-    }
-    /**
-     * Whether the NUI has input focus
-     */
-    get hasFocus() {
-        return this._hasFocus;
-    }
-    /**
-     * Whether the cursor is visible
-     */
-    get hasCursor() {
-        return this._hasCursor;
-    }
-    /**
-     * Send a message to the NUI (UI frame).
-     *
-     * @param action - The action/event name
-     * @param data - The data payload
-     */
-    send(action, data) {
-        SendNuiMessage(JSON.stringify({ action, data }));
-        nuiLogger.debug(`Sent message: ${action}`);
-    }
-    /**
-     * Send a raw message to the NUI without type checking.
-     *
-     * @param action - The action/event name
-     * @param data - The data payload
-     */
-    sendRaw(action, data) {
-        SendNuiMessage(JSON.stringify({ action, data }));
-        nuiLogger.debug(`Sent raw message: ${action}`);
-    }
-    /**
-     * Register a callback for NUI events from the UI.
-     *
-     * @param action - The action/event name to listen for
-     * @param handler - The callback handler
-     * @returns Cleanup function to unregister the callback
-     */
-    on(action, handler) {
-        RegisterNuiCallbackType(action);
-        on(`__cfx_nui:${action}`, async (data, cb) => {
-            try {
-                await handler(data);
-                cb({ ok: true });
-            }
-            catch (error) {
-                nuiLogger.error(`NUI callback error`, { action }, error);
-                cb({ ok: false, error: String(error) });
-            }
-        });
-        nuiLogger.debug(`Registered callback: ${action}`);
-    }
-    /**
-     * Register a callback that expects a return value.
-     *
-     * @param action - The action/event name to listen for
-     * @param handler - The callback handler that returns data
-     */
-    onWithResponse(action, handler) {
-        RegisterNuiCallbackType(action);
-        on(`__cfx_nui:${action}`, async (data, cb) => {
-            try {
-                const result = await handler(data);
-                cb({ ok: true, data: result });
-            }
-            catch (error) {
-                nuiLogger.error(`NUI callback error`, { action }, error);
-                cb({ ok: false, error: String(error) });
-            }
-        });
-        nuiLogger.debug(`Registered callback with response: ${action}`);
-    }
-    /**
-     * Set NUI focus state.
-     *
-     * @param hasFocus - Whether the NUI should have input focus
-     * @param hasCursor - Whether to show the cursor (defaults to hasFocus value)
-     */
-    focus(hasFocus, hasCursor) {
-        this._hasFocus = hasFocus;
-        this._hasCursor = hasCursor !== null && hasCursor !== void 0 ? hasCursor : hasFocus;
-        SetNuiFocus(this._hasFocus, this._hasCursor);
-        nuiLogger.debug(`Focus set: focus=${this._hasFocus}, cursor=${this._hasCursor}`);
-    }
-    /**
-     * Remove NUI focus (convenience method).
-     */
-    blur() {
-        this.focus(false, false);
-    }
-    /**
-     * Set NUI visibility state.
-     * Note: This only tracks state, you need to handle actual visibility in your UI.
-     *
-     * @param visible - Whether the NUI should be visible
-     */
-    setVisible(visible) {
-        this._isVisible = visible;
-        this.send('setVisible', { visible });
-        nuiLogger.debug(`Visibility set: ${visible}`);
-    }
-    /**
-     * Show the NUI and optionally set focus.
-     *
-     * @param withFocus - Whether to also set focus
-     * @param withCursor - Whether to show cursor (defaults to withFocus)
-     */
-    show(withFocus = true, withCursor) {
-        this.setVisible(true);
-        if (withFocus) {
-            this.focus(true, withCursor);
-        }
-    }
-    /**
-     * Hide the NUI and remove focus.
-     */
-    hide() {
-        this.setVisible(false);
-        this.blur();
-    }
-    /**
-     * Toggle NUI visibility.
-     *
-     * @param withFocus - Whether to set focus when showing
-     */
-    toggle(withFocus = true) {
-        if (this._isVisible) {
-            this.hide();
-        }
-        else {
-            this.show(withFocus);
-        }
-    }
-    /**
-     * Keep input focus but allow game input.
-     * Useful for HUDs that need to capture some keys but not all.
-     *
-     * @param keepInput - Whether to keep game input enabled
-     */
-    setKeepInput(keepInput) {
-        SetNuiFocusKeepInput(keepInput);
-        nuiLogger.debug(`Keep input set: ${keepInput}`);
-    }
-};
-exports.NuiBridge = NuiBridge;
-exports.NuiBridge = NuiBridge = __decorate([
-    (0, tsyringe_1.injectable)()
-], NuiBridge);
-/**
- * Default untyped NUI instance for quick usage.
- * For type-safe usage, create your own instance with proper generics.
- */
-exports.NUI = new NuiBridge();

package/dist/server/bootstrap.d.ts

@@ -1,16 +0,0 @@
-/**
- * Bootstraps the OpenCore Server Application Context.
- *
- * This is the primary entry point for the server-side framework. It orchestrates the
- * initialization of the Dependency Injection (DI) container and establishes the
- * bridge between the low-level FiveM runtime and the OpenCore architecture.
- *
- * **Initialization Lifecycle:**
- * 1. **Infrastructure Registration:** Registers core infrastructure services (`PlayerService`, `CommandService`, `HttpService`) as Singletons in the IoC container.
- * 2. **Reflection & Discovery:** Scans all decorated classes (Controllers, Services) to extract metadata defined by `@Command`, `@OnNet`, etc.
- * 3. **Runtime Binding:** Binds the discovered metadata to actual FiveM natives (e.g., `RegisterCommand`, `onNet`, `exports`).
- * 4. **Session Management:** Activates the player session tracking system.
- *
- * @returns A promise that resolves when the Core is fully initialized and ready to process events.
- */
-export declare function initServer(): Promise<void>;