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

package/dist/runtime/server/devmode/dev-mode.service.js

@@ -0,0 +1,324 @@
+"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.DevModeService = void 0;
+const tsyringe_1 = require("tsyringe");
+const container_1 = require("../../../kernel/di/container");
+const logger_1 = require("../../../kernel/shared/logger");
+const dev_transport_factory_1 = require("../../../kernel/shared/logger/transports/dev-transport.factory");
+const event_interceptor_service_1 = require("./event-interceptor.service");
+const hot_reload_server_1 = require("./hot-reload.server");
+const player_simulator_service_1 = require("./player-simulator.service");
+const state_inspector_service_1 = require("./state-inspector.service");
+// Safe wrapper for FiveM ExecuteCommand (no-op in Node.js)
+function safeExecuteCommand(command) {
+    if (typeof ExecuteCommand === 'function') {
+        ExecuteCommand(command);
+    }
+    else {
+        logger_1.loggers.bootstrap.warn('[DevMode] ExecuteCommand not available (not running in FiveM)');
+    }
+}
+/**
+ * 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
+ */
+let DevModeService = class DevModeService {
+    constructor() {
+        this.enabled = false;
+        this.options = null;
+        this.hotReloadServer = null;
+        this.logTransport = null;
+    }
+    get interceptor() {
+        return container_1.di.resolve(event_interceptor_service_1.EventInterceptorService);
+    }
+    get inspector() {
+        return container_1.di.resolve(state_inspector_service_1.StateInspectorService);
+    }
+    get simulator() {
+        return container_1.di.resolve(player_simulator_service_1.PlayerSimulatorService);
+    }
+    /**
+     * Enables DevMode with the specified options.
+     * @param options - DevMode configuration
+     */
+    async enable(options) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        if (this.enabled) {
+            logger_1.loggers.bootstrap.warn('[DevMode] Already enabled, skipping');
+            return;
+        }
+        this.options = options;
+        this.enabled = true;
+        logger_1.loggers.bootstrap.info('[DevMode] Enabling development mode...', {
+            hotReload: (_a = options.hotReload) === null || _a === void 0 ? void 0 : _a.enabled,
+            bridge: (_b = options.bridge) === null || _b === void 0 ? void 0 : _b.autoConnect,
+            interceptor: (_c = options.interceptor) === null || _c === void 0 ? void 0 : _c.enabled,
+            simulator: (_d = options.simulator) === null || _d === void 0 ? void 0 : _d.enabled,
+        });
+        // Start hot reload server
+        if ((_e = options.hotReload) === null || _e === void 0 ? void 0 : _e.enabled) {
+            this.hotReloadServer = new hot_reload_server_1.HotReloadServer(options.hotReload);
+            this.hotReloadServer.start();
+        }
+        // Configure event interceptor
+        if (options.interceptor) {
+            this.interceptor.configure(options.interceptor);
+        }
+        // Connect to CLI bridge
+        if ((_f = options.bridge) === null || _f === void 0 ? void 0 : _f.autoConnect) {
+            await this.connectToBridge(options.bridge.url);
+        }
+        // Auto-connect simulated players
+        if (((_g = options.simulator) === null || _g === void 0 ? void 0 : _g.enabled) && options.simulator.autoConnectPlayers > 0) {
+            this.simulator.connectMany(options.simulator.autoConnectPlayers);
+        }
+        logger_1.loggers.bootstrap.info('[DevMode] Development mode enabled successfully');
+    }
+    /**
+     * Disables DevMode and cleans up resources.
+     */
+    disable() {
+        if (!this.enabled)
+            return;
+        logger_1.loggers.bootstrap.info('[DevMode] Disabling development mode...');
+        // Stop hot reload server
+        if (this.hotReloadServer) {
+            this.hotReloadServer.stop();
+            this.hotReloadServer = null;
+        }
+        // Disconnect log transport
+        if (this.logTransport) {
+            void (0, dev_transport_factory_1.stopDevTransport)(this.logTransport);
+            this.logTransport = null;
+        }
+        // Disconnect all simulated players
+        this.simulator.disconnectAll();
+        // Clear event history
+        this.interceptor.clearHistory();
+        this.enabled = false;
+        this.options = null;
+        logger_1.loggers.bootstrap.info('[DevMode] Development mode disabled');
+    }
+    /**
+     * Checks if DevMode is enabled.
+     */
+    isEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Gets the current DevMode options.
+     */
+    getOptions() {
+        return this.options;
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Bridge Connection
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Connects to the CLI bridge for log streaming.
+     * Uses HTTP transport in FiveM, WebSocket in Node.js.
+     * @param url - Base URL (will be adapted based on environment)
+     */
+    async connectToBridge(url) {
+        if (this.logTransport) {
+            await (0, dev_transport_factory_1.stopDevTransport)(this.logTransport);
+        }
+        const env = (0, dev_transport_factory_1.detectEnvironment)();
+        const httpUrl = `${url.replace('ws://', 'http://').replace('wss://', 'https://')}/logs`;
+        const wsUrl = url.startsWith('http')
+            ? url.replace('http://', 'ws://').replace('https://', 'wss://')
+            : url;
+        this.logTransport = (0, dev_transport_factory_1.createDevTransport)({
+            httpUrl,
+            wsUrl,
+        });
+        try {
+            await (0, dev_transport_factory_1.startDevTransport)(this.logTransport);
+            // Setup message handler for WebSocket transport only
+            if ((0, dev_transport_factory_1.isWebSocketTransport)(this.logTransport)) {
+                this.logTransport.onMessage((data) => {
+                    this.handleBridgeMessage(data);
+                });
+            }
+            logger_1.loggers.bootstrap.info(`[DevMode] Connected to CLI bridge (${env} mode)`, { url });
+        }
+        catch (error) {
+            logger_1.loggers.bootstrap.warn('[DevMode] Could not connect to CLI bridge', {
+                url,
+                error: error.message,
+            });
+        }
+    }
+    /**
+     * Disconnects from the CLI bridge.
+     */
+    async disconnectFromBridge() {
+        if (this.logTransport) {
+            await (0, dev_transport_factory_1.stopDevTransport)(this.logTransport);
+            this.logTransport = null;
+            logger_1.loggers.bootstrap.info('[DevMode] Disconnected from CLI bridge');
+        }
+    }
+    /**
+     * Sends a message to the CLI bridge (WebSocket only).
+     * In HTTP mode, messages are sent via log transport automatically.
+     * @param message - Message to send
+     */
+    sendToBridge(message) {
+        if (this.logTransport &&
+            (0, dev_transport_factory_1.isWebSocketTransport)(this.logTransport) &&
+            this.logTransport.isConnected()) {
+            this.logTransport.send(message);
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // State Inspection
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Captures a snapshot of the current runtime state.
+     */
+    captureSnapshot() {
+        return this.inspector.captureSnapshot();
+    }
+    /**
+     * Gets a summary of the current runtime state.
+     */
+    getSummary() {
+        return this.inspector.getSummary();
+    }
+    /**
+     * Gets detailed information about a specific player.
+     * @param clientId - Client ID
+     */
+    getPlayerDetails(clientId) {
+        return this.inspector.getPlayerDetails(clientId);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Event Interception
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Gets the recorded event history.
+     */
+    getEventHistory() {
+        return this.interceptor.getEventHistory();
+    }
+    /**
+     * Clears the event history.
+     */
+    clearEventHistory() {
+        this.interceptor.clearHistory();
+    }
+    /**
+     * Gets event statistics.
+     */
+    getEventStatistics() {
+        return this.interceptor.getStatistics();
+    }
+    /**
+     * Adds a listener for events.
+     * @param listener - Event listener function
+     * @returns Unsubscribe function
+     */
+    onEvent(listener) {
+        return this.interceptor.addListener(listener);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Player Simulation
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Connects a simulated player.
+     * @param options - Player options
+     */
+    connectPlayer(options) {
+        return this.simulator.connect(options);
+    }
+    /**
+     * Disconnects a simulated player.
+     * @param clientId - Client ID
+     */
+    disconnectPlayer(clientId) {
+        this.simulator.disconnect(clientId);
+    }
+    /**
+     * Connects multiple simulated players.
+     * @param count - Number of players
+     * @param options - Base options
+     */
+    connectPlayers(count, options) {
+        return this.simulator.connectMany(count, options);
+    }
+    /**
+     * Gets simulated player statistics.
+     */
+    getSimulatorStatistics() {
+        return this.simulator.getStatistics();
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Internal
+    // ─────────────────────────────────────────────────────────────────────────────
+    handleBridgeMessage(message) {
+        switch (message.type) {
+            case 'ping':
+                this.sendToBridge({ type: 'pong', payload: Date.now() });
+                break;
+            case 'command':
+                this.handleRemoteCommand(message.payload);
+                break;
+            case 'reload':
+                this.handleRemoteReload(message.payload);
+                break;
+            default:
+                logger_1.loggers.bootstrap.debug('[DevMode] Unknown bridge message type', { type: message.type });
+        }
+    }
+    handleRemoteCommand(command) {
+        logger_1.loggers.bootstrap.debug('[DevMode] Remote command received', command);
+        switch (command.name) {
+            case 'snapshot':
+                this.sendToBridge({ type: 'state', payload: this.captureSnapshot() });
+                break;
+            case 'events':
+                this.sendToBridge({ type: 'event', payload: this.getEventHistory() });
+                break;
+            case 'clear-events':
+                this.clearEventHistory();
+                this.sendToBridge({ type: 'command', payload: { success: true } });
+                break;
+            case 'connect-player': {
+                const player = this.connectPlayer(command.args[0]);
+                this.sendToBridge({
+                    type: 'command',
+                    payload: { success: true, clientId: player.clientId },
+                });
+                break;
+            }
+            case 'disconnect-player':
+                this.disconnectPlayer(command.args[0]);
+                this.sendToBridge({ type: 'command', payload: { success: true } });
+                break;
+            default:
+                logger_1.loggers.bootstrap.warn('[DevMode] Unknown remote command', { name: command.name });
+        }
+    }
+    handleRemoteReload(payload) {
+        logger_1.loggers.bootstrap.info(`[DevMode] Remote reload requested for: ${payload.resource}`);
+        safeExecuteCommand(`restart ${payload.resource}`);
+    }
+};
+exports.DevModeService = DevModeService;
+exports.DevModeService = DevModeService = __decorate([
+    (0, tsyringe_1.injectable)()
+], DevModeService);

package/dist/runtime/server/devmode/event-interceptor.service.d.ts

@@ -0,0 +1,80 @@
+import { IDevModeInterceptor } from './contracts/IDevModeInterceptor';
+import { DevEvent, InterceptorOptions } from './types';
+/**
+ * Implementation of the DevMode event interceptor.
+ *
+ * Captures and records all framework events for debugging and analysis.
+ * Events are stored in a circular buffer with configurable size.
+ */
+export declare class EventInterceptorService extends IDevModeInterceptor {
+    private enabled;
+    private history;
+    private pendingEvents;
+    private options;
+    private eventCounter;
+    private listeners;
+    constructor();
+    /**
+     * Configures the interceptor options.
+     */
+    configure(options: Partial<InterceptorOptions>): void;
+    onEventBefore(event: Omit<DevEvent, 'result' | 'duration'>): void;
+    onEventAfter(event: DevEvent): void;
+    onEventError(event: DevEvent): void;
+    getEventHistory(): DevEvent[];
+    clearHistory(): void;
+    setEnabled(enabled: boolean): void;
+    isEnabled(): boolean;
+    /**
+     * Creates an event ID for tracking.
+     */
+    createEventId(): string;
+    /**
+     * Records a net event.
+     */
+    recordNetEvent(name: string, direction: 'in' | 'out', args: unknown[], source?: {
+        clientId?: number;
+    }): string;
+    /**
+     * Records a command execution.
+     */
+    recordCommand(name: string, args: string[], source?: {
+        clientId?: number;
+    }): string;
+    /**
+     * Records an export call.
+     */
+    recordExport(name: string, args: unknown[]): string;
+    /**
+     * Completes an event with result.
+     */
+    completeEvent(id: string, result: unknown, startTime: number): void;
+    /**
+     * Fails an event with error.
+     */
+    failEvent(id: string, error: string, startTime: number): void;
+    /**
+     * Adds a listener for events.
+     */
+    addListener(listener: (event: DevEvent) => void): () => void;
+    /**
+     * Gets events filtered by type.
+     */
+    getEventsByType(type: DevEvent['type']): DevEvent[];
+    /**
+     * Gets events within a time range.
+     */
+    getEventsByTimeRange(startTime: number, endTime: number): DevEvent[];
+    /**
+     * Gets statistics about recorded events.
+     */
+    getStatistics(): {
+        total: number;
+        byType: Record<string, number>;
+        avgDuration: number;
+        errors: number;
+    };
+    private generateEventId;
+    private addToHistory;
+    private notifyListeners;
+}

package/dist/runtime/server/devmode/event-interceptor.service.js

@@ -0,0 +1,232 @@
+"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;
+};
+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.EventInterceptorService = void 0;
+const tsyringe_1 = require("tsyringe");
+const IDevModeInterceptor_1 = require("./contracts/IDevModeInterceptor");
+/**
+ * Implementation of the DevMode event interceptor.
+ *
+ * Captures and records all framework events for debugging and analysis.
+ * Events are stored in a circular buffer with configurable size.
+ */
+let EventInterceptorService = class EventInterceptorService extends IDevModeInterceptor_1.IDevModeInterceptor {
+    constructor() {
+        super();
+        this.enabled = false;
+        this.history = [];
+        this.pendingEvents = new Map();
+        this.eventCounter = 0;
+        this.listeners = [];
+        this.options = {
+            enabled: true,
+            recordHistory: true,
+            maxHistorySize: 1000,
+        };
+    }
+    /**
+     * Configures the interceptor options.
+     */
+    configure(options) {
+        this.options = Object.assign(Object.assign({}, this.options), options);
+        this.enabled = this.options.enabled;
+    }
+    onEventBefore(event) {
+        if (!this.enabled)
+            return;
+        const fullEvent = Object.assign(Object.assign({}, event), { id: this.generateEventId() });
+        this.notifyListeners(fullEvent);
+    }
+    onEventAfter(event) {
+        if (!this.enabled)
+            return;
+        if (this.options.recordHistory) {
+            this.addToHistory(event);
+        }
+        this.notifyListeners(event);
+    }
+    onEventError(event) {
+        if (!this.enabled)
+            return;
+        if (this.options.recordHistory) {
+            this.addToHistory(event);
+        }
+        this.notifyListeners(event);
+    }
+    getEventHistory() {
+        return [...this.history];
+    }
+    clearHistory() {
+        this.history = [];
+    }
+    setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Creates an event ID for tracking.
+     */
+    createEventId() {
+        return this.generateEventId();
+    }
+    /**
+     * Records a net event.
+     */
+    recordNetEvent(name, direction, args, source) {
+        const id = this.generateEventId();
+        const event = {
+            id,
+            timestamp: Date.now(),
+            type: 'net',
+            name,
+            direction,
+            args,
+            source,
+        };
+        this.pendingEvents.set(id, event);
+        this.onEventBefore(event);
+        return id;
+    }
+    /**
+     * Records a command execution.
+     */
+    recordCommand(name, args, source) {
+        const id = this.generateEventId();
+        const event = {
+            id,
+            timestamp: Date.now(),
+            type: 'command',
+            name,
+            direction: 'in',
+            args,
+            source,
+        };
+        this.pendingEvents.set(id, event);
+        this.onEventBefore(event);
+        return id;
+    }
+    /**
+     * Records an export call.
+     */
+    recordExport(name, args) {
+        const id = this.generateEventId();
+        const event = {
+            id,
+            timestamp: Date.now(),
+            type: 'export',
+            name,
+            direction: 'in',
+            args,
+        };
+        this.pendingEvents.set(id, event);
+        this.onEventBefore(event);
+        return id;
+    }
+    /**
+     * Completes an event with result.
+     */
+    completeEvent(id, result, startTime) {
+        const event = this.pendingEvents.get(id);
+        if (event) {
+            event.result = result;
+            event.duration = Date.now() - startTime;
+            this.pendingEvents.delete(id);
+            this.onEventAfter(event);
+        }
+    }
+    /**
+     * Fails an event with error.
+     */
+    failEvent(id, error, startTime) {
+        const event = this.pendingEvents.get(id);
+        if (event) {
+            event.error = error;
+            event.duration = Date.now() - startTime;
+            this.pendingEvents.delete(id);
+            this.onEventError(event);
+        }
+    }
+    /**
+     * Adds a listener for events.
+     */
+    addListener(listener) {
+        this.listeners.push(listener);
+        return () => {
+            const index = this.listeners.indexOf(listener);
+            if (index !== -1) {
+                this.listeners.splice(index, 1);
+            }
+        };
+    }
+    /**
+     * Gets events filtered by type.
+     */
+    getEventsByType(type) {
+        return this.history.filter((e) => e.type === type);
+    }
+    /**
+     * Gets events within a time range.
+     */
+    getEventsByTimeRange(startTime, endTime) {
+        return this.history.filter((e) => e.timestamp >= startTime && e.timestamp <= endTime);
+    }
+    /**
+     * Gets statistics about recorded events.
+     */
+    getStatistics() {
+        const byType = {};
+        let totalDuration = 0;
+        let durationCount = 0;
+        let errors = 0;
+        for (const event of this.history) {
+            byType[event.type] = (byType[event.type] || 0) + 1;
+            if (event.duration !== undefined) {
+                totalDuration += event.duration;
+                durationCount++;
+            }
+            if (event.error) {
+                errors++;
+            }
+        }
+        return {
+            total: this.history.length,
+            byType,
+            avgDuration: durationCount > 0 ? totalDuration / durationCount : 0,
+            errors,
+        };
+    }
+    generateEventId() {
+        return `evt_${Date.now()}_${++this.eventCounter}`;
+    }
+    addToHistory(event) {
+        this.history.push(event);
+        if (this.history.length > this.options.maxHistorySize) {
+            this.history.shift();
+        }
+    }
+    notifyListeners(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (_a) {
+                // Ignore listener errors
+            }
+        }
+    }
+};
+exports.EventInterceptorService = EventInterceptorService;
+exports.EventInterceptorService = EventInterceptorService = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [])
+], EventInterceptorService);