@open-core/framework 0.2.8 → 0.3.0

package/dist/runtime/server/devmode/hot-reload.server.js

@@ -1,261 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HotReloadServer = void 0;
-const logger_1 = require("../../../kernel/shared/logger");
-// Lazy-loaded http module (only loaded at runtime, not bundled)
-let httpModule = null;
-// Use variable to prevent esbuild from statically analyzing the require
-const HTTP_MODULE = 'http';
-function getHttpSync() {
-    if (!httpModule) {
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        httpModule = require(HTTP_MODULE);
-    }
-    return httpModule;
-}
-// Safe wrappers for FiveM globals (no-op in Node.js)
-function safeGetCurrentResourceName() {
-    if (typeof GetCurrentResourceName === 'function') {
-        return GetCurrentResourceName();
-    }
-    return 'unknown';
-}
-function safeExecuteCommand(command) {
-    if (typeof ExecuteCommand === 'function') {
-        ExecuteCommand(command);
-    }
-    else {
-        logger_1.loggers.bootstrap.warn('[DevMode] ExecuteCommand not available (not running in FiveM)');
-    }
-}
-/**
- * HTTP server for handling hot reload requests from the CLI.
- *
- * Provides an endpoint that the CLI can call to restart resources
- * after file changes are detected.
- *
- * @example
- * ```typescript
- * const server = new HotReloadServer({ enabled: true, port: 3847 })
- * server.start()
- * // CLI calls POST /restart?resource=my-resource
- * ```
- */
-class HotReloadServer {
-    constructor(options) {
-        this.server = null;
-        this.logBuffer = [];
-        this.maxLogBuffer = 1000;
-        this.logListeners = [];
-        this.options = options;
-    }
-    /**
-     * Adds logs to the buffer (called by HttpLogTransport).
-     */
-    addLogs(logs) {
-        this.logBuffer.push(...logs);
-        if (this.logBuffer.length > this.maxLogBuffer) {
-            this.logBuffer = this.logBuffer.slice(-this.maxLogBuffer);
-        }
-        // Notify listeners
-        for (const listener of this.logListeners) {
-            listener(logs);
-        }
-    }
-    /**
-     * Gets and clears buffered logs.
-     */
-    consumeLogs() {
-        const logs = this.logBuffer;
-        this.logBuffer = [];
-        return logs;
-    }
-    /**
-     * Adds a listener for new logs.
-     */
-    onLogs(listener) {
-        this.logListeners.push(listener);
-        return () => {
-            const idx = this.logListeners.indexOf(listener);
-            if (idx !== -1)
-                this.logListeners.splice(idx, 1);
-        };
-    }
-    /**
-     * Starts the hot reload HTTP server.
-     */
-    start() {
-        if (!this.options.enabled)
-            return;
-        if (this.server)
-            return;
-        const http = getHttpSync();
-        this.server = http.createServer((req, res) => {
-            this.handleRequest(req, res);
-        });
-        this.server.listen(this.options.port, '127.0.0.1', () => {
-            logger_1.loggers.bootstrap.info(`[DevMode] Hot reload server listening on port ${this.options.port}`);
-        });
-        this.server.on('error', (error) => {
-            logger_1.loggers.bootstrap.error(`[DevMode] Hot reload server error`, {}, error);
-        });
-    }
-    /**
-     * Stops the hot reload server.
-     */
-    stop() {
-        if (this.server) {
-            this.server.close();
-            this.server = null;
-            logger_1.loggers.bootstrap.info('[DevMode] Hot reload server stopped');
-        }
-    }
-    /**
-     * Checks if the server is running.
-     */
-    isRunning() {
-        return this.server !== null;
-    }
-    handleRequest(req, res) {
-        var _a, _b;
-        // CORS headers for CLI access
-        res.setHeader('Access-Control-Allow-Origin', '*');
-        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
-        res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
-        if (req.method === 'OPTIONS') {
-            res.writeHead(204);
-            res.end();
-            return;
-        }
-        if (req.method === 'POST' && ((_a = req.url) === null || _a === void 0 ? void 0 : _a.startsWith('/restart'))) {
-            this.handleRestart(req, res);
-            return;
-        }
-        if (req.method === 'POST' && ((_b = req.url) === null || _b === void 0 ? void 0 : _b.startsWith('/refresh'))) {
-            this.handleRefresh(res);
-            return;
-        }
-        if (req.method === 'GET' && req.url === '/health') {
-            this.handleHealth(res);
-            return;
-        }
-        // Log endpoints for CLI polling
-        if (req.method === 'GET' && req.url === '/logs') {
-            this.handleGetLogs(res);
-            return;
-        }
-        if (req.method === 'POST' && req.url === '/logs') {
-            this.handlePostLogs(req, res);
-            return;
-        }
-        res.writeHead(404, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({ error: 'Not found' }));
-    }
-    handleRestart(req, res) {
-        var _a;
-        try {
-            const url = new URL((_a = req.url) !== null && _a !== void 0 ? _a : '', `http://localhost:${this.options.port}`);
-            const resource = url.searchParams.get('resource');
-            if (!resource) {
-                res.writeHead(400, { 'Content-Type': 'application/json' });
-                res.end(JSON.stringify({ error: 'Missing resource parameter' }));
-                return;
-            }
-            if (!this.isResourceAllowed(resource)) {
-                res.writeHead(403, { 'Content-Type': 'application/json' });
-                res.end(JSON.stringify({ error: 'Resource not allowed for hot reload' }));
-                return;
-            }
-            // Don't restart ourselves
-            const currentResource = safeGetCurrentResourceName();
-            if (resource === currentResource) {
-                res.writeHead(400, { 'Content-Type': 'application/json' });
-                res.end(JSON.stringify({ error: 'Cannot restart the hot-reload resource itself' }));
-                return;
-            }
-            logger_1.loggers.bootstrap.info(`[DevMode] Hot reloading resource: ${resource}`);
-            // Execute the restart command
-            safeExecuteCommand(`restart ${resource}`);
-            res.writeHead(200, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ success: true, resource }));
-        }
-        catch (error) {
-            logger_1.loggers.bootstrap.error('[DevMode] Hot reload error', {}, error);
-            res.writeHead(500, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: 'Internal server error' }));
-        }
-    }
-    handleRefresh(res) {
-        try {
-            logger_1.loggers.bootstrap.info('[DevMode] Refreshing resources');
-            safeExecuteCommand('refresh');
-            res.writeHead(200, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ success: true }));
-        }
-        catch (error) {
-            logger_1.loggers.bootstrap.error('[DevMode] Refresh error', {}, error);
-            res.writeHead(500, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: 'Internal server error' }));
-        }
-    }
-    handleHealth(res) {
-        res.writeHead(200, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({
-            status: 'ok',
-            resource: safeGetCurrentResourceName(),
-            timestamp: Date.now(),
-        }));
-    }
-    isResourceAllowed(resource) {
-        if (!this.options.allowedResources || this.options.allowedResources.length === 0) {
-            return true;
-        }
-        return this.options.allowedResources.includes(resource);
-    }
-    /**
-     * Handles GET /logs - CLI polls for buffered logs.
-     */
-    handleGetLogs(res) {
-        const logs = this.consumeLogs();
-        res.writeHead(200, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({ logs, timestamp: Date.now() }));
-    }
-    /**
-     * Handles POST /logs - Framework pushes logs to buffer.
-     */
-    handlePostLogs(req, res) {
-        let body = '';
-        req.on('data', (chunk) => {
-            body += chunk.toString();
-            // Limit body size to 1MB
-            if (body.length > 1024 * 1024) {
-                res.writeHead(413, { 'Content-Type': 'application/json' });
-                res.end(JSON.stringify({ error: 'Payload too large' }));
-                req.destroy();
-            }
-        });
-        req.on('end', () => {
-            try {
-                const data = JSON.parse(body);
-                if (data.type === 'logs' && Array.isArray(data.payload)) {
-                    this.addLogs(data.payload);
-                    res.writeHead(200, { 'Content-Type': 'application/json' });
-                    res.end(JSON.stringify({ success: true, received: data.payload.length }));
-                }
-                else {
-                    res.writeHead(400, { 'Content-Type': 'application/json' });
-                    res.end(JSON.stringify({ error: 'Invalid payload format' }));
-                }
-            }
-            catch (_a) {
-                res.writeHead(400, { 'Content-Type': 'application/json' });
-                res.end(JSON.stringify({ error: 'Invalid JSON' }));
-            }
-        });
-        req.on('error', () => {
-            res.writeHead(500, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: 'Request error' }));
-        });
-    }
-}
-exports.HotReloadServer = HotReloadServer;

package/dist/runtime/server/services/config.service.d.ts

@@ -1,75 +0,0 @@
-/**
- * Generic configuration service for accessing FiveM Convars.
- *
- * Provides type-safe access to configuration values with automatic
- * prefix handling and type conversion.
- *
- * All keys are automatically prefixed with `opencore_`.
- *
- * @example
- * ```ts
- * const config = di.resolve(ConfigService)
- *
- * // Get string value
- * const apiUrl = config.get('api_url', 'http://localhost:3000')
- *
- * // Get number value
- * const timeout = config.getNumber('timeout', 5000)
- *
- * // Get boolean value
- * const debug = config.getBoolean('debug', false)
- *
- * // Get required value (throws if not set)
- * const secretKey = config.getRequired('secret_key')
- *
- * // Get JSON value
- * const settings = config.getJson('settings', { enabled: true })
- * ```
- *
- * @scope Singleton
- */
-export declare class ConfigService {
-    private readonly PREFIX;
-    /**
-     * Gets a string configuration value.
-     *
-     * @param key - The configuration key (without prefix)
-     * @param defaultValue - Default value if not set
-     * @returns The configuration value or default
-     */
-    get(key: string, defaultValue: string): string;
-    /**
-     * Gets a numeric configuration value.
-     *
-     * @param key - The configuration key (without prefix)
-     * @param defaultValue - Default value if not set or invalid
-     * @returns The configuration value as number
-     */
-    getNumber(key: string, defaultValue: number): number;
-    /**
-     * Gets a boolean configuration value.
-     *
-     * Recognizes 'true', '1' as true, everything else as false.
-     *
-     * @param key - The configuration key (without prefix)
-     * @param defaultValue - Default value if not set
-     * @returns The configuration value as boolean
-     */
-    getBoolean(key: string, defaultValue: boolean): boolean;
-    /**
-     * Gets a required configuration value.
-     *
-     * @param key - The configuration key (without prefix)
-     * @returns The configuration value
-     * @throws Error if the value is not set
-     */
-    getRequired(key: string): string;
-    /**
-     * Gets a JSON configuration value.
-     *
-     * @param key - The configuration key (without prefix)
-     * @param defaultValue - Default value if not set or invalid JSON
-     * @returns The parsed JSON value or default
-     */
-    getJson<T>(key: string, defaultValue: T): T;
-}

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

@@ -1,116 +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.ConfigService = void 0;
-const decorators_1 = require("../decorators");
-/**
- * Generic configuration service for accessing FiveM Convars.
- *
- * Provides type-safe access to configuration values with automatic
- * prefix handling and type conversion.
- *
- * All keys are automatically prefixed with `opencore_`.
- *
- * @example
- * ```ts
- * const config = di.resolve(ConfigService)
- *
- * // Get string value
- * const apiUrl = config.get('api_url', 'http://localhost:3000')
- *
- * // Get number value
- * const timeout = config.getNumber('timeout', 5000)
- *
- * // Get boolean value
- * const debug = config.getBoolean('debug', false)
- *
- * // Get required value (throws if not set)
- * const secretKey = config.getRequired('secret_key')
- *
- * // Get JSON value
- * const settings = config.getJson('settings', { enabled: true })
- * ```
- *
- * @scope Singleton
- */
-let ConfigService = class ConfigService {
-    constructor() {
-        this.PREFIX = 'opencore_';
-    }
-    /**
-     * Gets a string configuration value.
-     *
-     * @param key - The configuration key (without prefix)
-     * @param defaultValue - Default value if not set
-     * @returns The configuration value or default
-     */
-    get(key, defaultValue) {
-        return GetConvar(this.PREFIX + key, defaultValue);
-    }
-    /**
-     * Gets a numeric configuration value.
-     *
-     * @param key - The configuration key (without prefix)
-     * @param defaultValue - Default value if not set or invalid
-     * @returns The configuration value as number
-     */
-    getNumber(key, defaultValue) {
-        const value = GetConvar(this.PREFIX + key, String(defaultValue));
-        const parsed = Number(value);
-        return Number.isNaN(parsed) ? defaultValue : parsed;
-    }
-    /**
-     * Gets a boolean configuration value.
-     *
-     * Recognizes 'true', '1' as true, everything else as false.
-     *
-     * @param key - The configuration key (without prefix)
-     * @param defaultValue - Default value if not set
-     * @returns The configuration value as boolean
-     */
-    getBoolean(key, defaultValue) {
-        const value = GetConvar(this.PREFIX + key, String(defaultValue));
-        return value === 'true' || value === '1';
-    }
-    /**
-     * Gets a required configuration value.
-     *
-     * @param key - The configuration key (without prefix)
-     * @returns The configuration value
-     * @throws Error if the value is not set
-     */
-    getRequired(key) {
-        const value = GetConvar(this.PREFIX + key, '');
-        if (!value) {
-            throw new Error(`[OpenCore] Configuration '${this.PREFIX}${key}' is required but not set`);
-        }
-        return value;
-    }
-    /**
-     * Gets a JSON configuration value.
-     *
-     * @param key - The configuration key (without prefix)
-     * @param defaultValue - Default value if not set or invalid JSON
-     * @returns The parsed JSON value or default
-     */
-    getJson(key, defaultValue) {
-        const value = GetConvar(this.PREFIX + key, '');
-        if (!value)
-            return defaultValue;
-        try {
-            return JSON.parse(value);
-        }
-        catch (_a) {
-            return defaultValue;
-        }
-    }
-};
-exports.ConfigService = ConfigService;
-exports.ConfigService = ConfigService = __decorate([
-    (0, decorators_1.Bind)('singleton')
-], ConfigService);

package/dist/runtime/server/services/http/http.service.d.ts

@@ -1,50 +0,0 @@
-export interface HttpOptions {
-    headers?: Record<string, string>;
-    timeoutMs?: number;
-}
-export declare class HttpService {
-    /**
-     * Performs an HTTP GET request to the specified URL.
-     *
-     * @template T - The expected return type of the response data.
-     * @param url - The endpoint URL to fetch data from.
-     * @param options - Optional configuration for the request (headers, timeout).
-     * @returns A Promise that resolves to the response data of type T.
-     * @throws {AppError} If the request fails, times out, or returns a non-2xx status code.
-     */
-    get<T = any>(url: string, options?: HttpOptions): Promise<T>;
-    /**
-     * Performs an HTTP POST request to the specified URL with a JSON payload.
-     *
-     * @template T - The expected return type of the response data.
-     * @param url - The endpoint URL to send data to.
-     * @param body - The data payload to be sent as the request body (will be stringified to JSON).
-     * @param options - Optional configuration for the request (headers, timeout).
-     * @returns A Promise that resolves to the response data of type T.
-     * @throws {AppError} If the request fails, times out, or returns a non-2xx status code.
-     */
-    post<T = any>(url: string, body: any, options?: HttpOptions): Promise<T>;
-    /**
-     * Performs an HTTP PUT request to the specified URL to update a resource.
-     *
-     * @template T - The expected return type of the response data.
-     * @param url - The endpoint URL to update.
-     * @param body - The data payload to be sent as the request body (will be stringified to JSON).
-     * @param options - Optional configuration for the request (headers, timeout).
-     * @returns A Promise that resolves to the response data of type T.
-     * @throws {AppError} If the request fails, times out, or returns a non-2xx status code.
-     */
-    put<T = any>(url: string, body: any, options?: HttpOptions): Promise<T>;
-    /**
-     * Performs an HTTP DELETE request to the specified URL.
-     *
-     * @template T - The expected return type of the response data (often void or the deleted entity).
-     * @param url - The endpoint URL to delete the resource from.
-     * @param options - Optional configuration for the request (headers, timeout).
-     * @returns A Promise that resolves to the response data of type T.
-     * @throws {AppError} If the request fails, times out, or returns a non-2xx status code.
-     */
-    delete<T = any>(url: string, options?: HttpOptions): Promise<T>;
-    private request;
-    private handleResponse;
-}

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

@@ -1,126 +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.HttpService = void 0;
-const tsyringe_1 = require("tsyringe");
-const utils_1 = require("../../../../kernel/utils");
-let HttpService = class HttpService {
-    /**
-     * Performs an HTTP GET request to the specified URL.
-     *
-     * @template T - The expected return type of the response data.
-     * @param url - The endpoint URL to fetch data from.
-     * @param options - Optional configuration for the request (headers, timeout).
-     * @returns A Promise that resolves to the response data of type T.
-     * @throws {AppError} If the request fails, times out, or returns a non-2xx status code.
-     */
-    async get(url, options = {}) {
-        return this.request(url, 'GET', undefined, options);
-    }
-    /**
-     * Performs an HTTP POST request to the specified URL with a JSON payload.
-     *
-     * @template T - The expected return type of the response data.
-     * @param url - The endpoint URL to send data to.
-     * @param body - The data payload to be sent as the request body (will be stringified to JSON).
-     * @param options - Optional configuration for the request (headers, timeout).
-     * @returns A Promise that resolves to the response data of type T.
-     * @throws {AppError} If the request fails, times out, or returns a non-2xx status code.
-     */
-    async post(url, body, options = {}) {
-        return this.request(url, 'POST', body, options);
-    }
-    /**
-     * Performs an HTTP PUT request to the specified URL to update a resource.
-     *
-     * @template T - The expected return type of the response data.
-     * @param url - The endpoint URL to update.
-     * @param body - The data payload to be sent as the request body (will be stringified to JSON).
-     * @param options - Optional configuration for the request (headers, timeout).
-     * @returns A Promise that resolves to the response data of type T.
-     * @throws {AppError} If the request fails, times out, or returns a non-2xx status code.
-     */
-    async put(url, body, options = {}) {
-        return this.request(url, 'PUT', body, options);
-    }
-    /**
-     * Performs an HTTP DELETE request to the specified URL.
-     *
-     * @template T - The expected return type of the response data (often void or the deleted entity).
-     * @param url - The endpoint URL to delete the resource from.
-     * @param options - Optional configuration for the request (headers, timeout).
-     * @returns A Promise that resolves to the response data of type T.
-     * @throws {AppError} If the request fails, times out, or returns a non-2xx status code.
-     */
-    async delete(url, options = {}) {
-        return this.request(url, 'DELETE', undefined, options);
-    }
-    async request(url, method, body, options) {
-        const { headers = {}, timeoutMs = 5000 } = options;
-        const finalHeaders = Object.assign({ 'Content-Type': 'application/json' }, headers);
-        const controller = new AbortController();
-        const id = setTimeout(() => controller.abort(), timeoutMs);
-        try {
-            const response = await fetch(url, {
-                method,
-                headers: finalHeaders,
-                body: body ? JSON.stringify(body) : undefined,
-                signal: controller.signal,
-            });
-            return await this.handleResponse(response, method, url);
-        }
-        catch (err) {
-            if (err instanceof utils_1.AppError)
-                throw err;
-            if (err instanceof DOMException && err.name === 'AbortError') {
-                throw new utils_1.AppError('NETWORK:ERROR', `${method} ${url} timed out after ${timeoutMs}ms`, 'external', { timeout: timeoutMs });
-            }
-            throw new utils_1.AppError('NETWORK:ERROR', `Network error calling ${method} ${url}`, 'external', {
-                endpoint: url,
-                method,
-                cause: err instanceof Error ? err.message : String(err),
-            });
-        }
-        finally {
-            clearTimeout(id);
-        }
-    }
-    async handleResponse(response, method, url) {
-        if (!response.ok) {
-            let code = 'API:ERROR';
-            let errorBody = null;
-            if (response.status === 401 || response.status === 403) {
-                code = 'AUTH:UNAUTHORIZED';
-            }
-            try {
-                errorBody = await response.json();
-            }
-            catch (_) { }
-            throw new utils_1.AppError(code, `${method} ${url} failed with status ${response.status}`, 'external', {
-                status: response.status,
-                endpoint: url,
-                method,
-                body: errorBody,
-            });
-        }
-        if (response.status === 204) {
-            return undefined;
-        }
-        try {
-            return (await response.json());
-        }
-        catch (_) {
-            // TODO: define better behavior for non-JSON responses
-            return undefined;
-        }
-    }
-};
-exports.HttpService = HttpService;
-exports.HttpService = HttpService = __decorate([
-    (0, tsyringe_1.injectable)()
-], HttpService);