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

package/dist/server/system/processors/export.processor.d.ts

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

package/dist/server/system/processors/fivemEvent.processor.d.ts

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

package/dist/server/system/processors/netEvent.processor.d.ts

@@ -1,11 +0,0 @@
-import { DecoratorProcessor } from '../../../system/decorator-processor';
-import { PlayerService } from '../../services/player.service';
-import { NetEventOptions } from '../../decorators';
-import { SecurityHandlerContract } from '../../templates/security/security-handler.contract';
-export declare class NetEventProcessor implements DecoratorProcessor {
-    private playerService;
-    private securityHandler;
-    readonly metadataKey: string;
-    constructor(playerService: PlayerService, securityHandler: SecurityHandlerContract);
-    process(instance: any, methodName: string, metadata: NetEventOptions): void;
-}

package/dist/server/system/processors/netEvent.processor.js

@@ -1,103 +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;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NetEventProcessor = void 0;
-const tsyringe_1 = require("tsyringe");
-const player_service_1 = require("../../services/player.service");
-const metadata_server_keys_1 = require("../metadata-server.keys");
-const security_handler_contract_1 = require("../../templates/security/security-handler.contract");
-const utils_1 = require("../../../utils");
-const logger_1 = require("../../../shared/logger");
-const zod_1 = __importDefault(require("zod"));
-const schema_generator_1 = require("../schema-generator");
-const resolve_method_1 = require("../../helpers/resolve-method");
-let NetEventProcessor = class NetEventProcessor {
-    constructor(playerService, securityHandler) {
-        this.playerService = playerService;
-        this.securityHandler = securityHandler;
-        this.metadataKey = metadata_server_keys_1.METADATA_KEYS.NET_EVENT;
-    }
-    process(instance, methodName, metadata) {
-        const result = (0, resolve_method_1.resolveMethod)(instance, methodName, `[NetEventProcessor] Method "${methodName}" not found`);
-        if (!result)
-            return;
-        const { handler, handlerName, proto } = result;
-        const isPublic = Reflect.getMetadata(metadata_server_keys_1.METADATA_KEYS.PUBLIC, proto, methodName) === true;
-        onNet(metadata.eventName, async (...args) => {
-            const sourceId = Number(source);
-            const player = this.playerService.getByClient(sourceId);
-            if (!player) {
-                logger_1.loggers.netEvent.warn(`Event ignored: Player session not found`, {
-                    event: metadata.eventName,
-                    clientId: sourceId,
-                });
-                return;
-            }
-            // ═══════════════════════════════════════════════════════════════
-            // SECURE BY DEFAULT: Require authentication unless @Public()
-            // ═══════════════════════════════════════════════════════════════
-            if (!isPublic && !player.accountID) {
-                logger_1.loggers.security.warn(`Unauthenticated request blocked`, {
-                    event: metadata.eventName,
-                    clientId: sourceId,
-                });
-                player.emit('core:auth:required', { event: metadata.eventName });
-                return;
-            }
-            let validatedArgs = args;
-            const schema = (0, schema_generator_1.generateSchemaFromTypes)(metadata.paramTypes);
-            if (schema) {
-                try {
-                    const parsed = schema.parse(args);
-                    validatedArgs = Array.isArray(parsed) ? parsed : [parsed];
-                }
-                catch (error) {
-                    if (error instanceof zod_1.default.ZodError) {
-                        const violation = new utils_1.SecurityError('LOG', `Invalid data received in ${metadata.eventName}`, { issues: error.message });
-                        this.securityHandler.handleViolation(player, violation);
-                        return;
-                    }
-                    if (error instanceof utils_1.SecurityError) {
-                        this.securityHandler.handleViolation(player, error);
-                        return;
-                    }
-                    logger_1.loggers.netEvent.error(`Validation error in event`, {
-                        event: metadata.eventName,
-                        playerId: player.clientID,
-                    }, error);
-                }
-            }
-            try {
-                await handler(player, ...validatedArgs);
-            }
-            catch (error) {
-                if (error instanceof utils_1.SecurityError) {
-                    this.securityHandler.handleViolation(player, error);
-                }
-                logger_1.loggers.netEvent.error(`Handler error in event`, {
-                    event: metadata.eventName,
-                    handler: handlerName,
-                    playerId: player.clientID,
-                }, error);
-            }
-        });
-        logger_1.loggers.netEvent.debug(`Registered: ${metadata.eventName} -> ${handlerName}`);
-    }
-};
-exports.NetEventProcessor = NetEventProcessor;
-exports.NetEventProcessor = NetEventProcessor = __decorate([
-    (0, tsyringe_1.injectable)(),
-    __metadata("design:paramtypes", [player_service_1.PlayerService,
-        security_handler_contract_1.SecurityHandlerContract])
-], NetEventProcessor);

package/dist/server/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/server/system/processors.register.d.ts

@@ -1 +0,0 @@
-export declare function registerSystemServer(): void;

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

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerSystemServer = registerSystemServer;
-const container_1 = require("../container");
-const default_security_handler_1 = require("../services/default/default-security.handler");
-const security_handler_contract_1 = require("../templates/security/security-handler.contract");
-const command_processor_1 = require("./processors/command.processor");
-const coreEvent_processor_1 = require("./processors/coreEvent.processor");
-const export_processor_1 = require("./processors/export.processor");
-const fivemEvent_processor_1 = require("./processors/fivemEvent.processor");
-const netEvent_processor_1 = require("./processors/netEvent.processor");
-const tick_processor_1 = require("./processors/tick.processor");
-function registerSystemServer() {
-    container_1.di.register('DecoratorProcessor', { useClass: netEvent_processor_1.NetEventProcessor });
-    container_1.di.register('DecoratorProcessor', { useClass: tick_processor_1.TickProcessor });
-    container_1.di.register('DecoratorProcessor', { useClass: export_processor_1.ExportProcessor });
-    container_1.di.register('DecoratorProcessor', { useClass: coreEvent_processor_1.CoreEventProcessor });
-    container_1.di.register('DecoratorProcessor', { useClass: command_processor_1.CommandProcessor });
-    container_1.di.register('DecoratorProcessor', { useClass: fivemEvent_processor_1.FiveMEventProcessor });
-    if (!container_1.di.isRegistered(security_handler_contract_1.SecurityHandlerContract)) {
-        container_1.di.registerSingleton(security_handler_contract_1.SecurityHandlerContract, default_security_handler_1.DefaultSecurityHandler);
-    }
-}

package/dist/server/templates/index.d.ts

@@ -1,8 +0,0 @@
-export * from './security/principal-provider.contract';
-export * from './repository';
-export * from './persistence';
-export * from './auth/auth-provider.contract';
-export type * from './security/permission.types';
-export type * from './admin/admin.controller-template';
-export type * from './repository/repository.types';
-export type * from './persistence/player-persistence.contract';

package/dist/server/templates/persistence/index.d.ts

@@ -1,30 +0,0 @@
-/**
- * Player Persistence Module
- *
- * Provides contracts and types for implementing player data persistence.
- *
- * @example
- * ```typescript
- * import {
- *   PlayerPersistenceContract,
- *   PersistenceConfig,
- *   DEFAULT_PERSISTENCE_CONFIG
- * } from '@open-core/framework/server'
- *
- * class MyPersistenceProvider extends PlayerPersistenceContract {
- *   readonly config: PersistenceConfig = {
- *     ...DEFAULT_PERSISTENCE_CONFIG,
- *     autoSaveIntervalMs: 60000, // Override to 1 minute
- *   }
- *
- *   async onSessionLoad(player) { ... }
- *   async onSessionSave(player) { ... }
- *   async onAutoSave(player) { ... }
- * }
- *
- * // In your setup:
- * Server.setPersistenceProvider(MyPersistenceProvider)
- * ```
- */
-export { PlayerPersistenceContract, DEFAULT_PERSISTENCE_CONFIG, } from './player-persistence.contract';
-export type { PersistenceConfig } from './player-persistence.contract';

package/dist/server/templates/persistence/index.js

@@ -1,34 +0,0 @@
-"use strict";
-/**
- * Player Persistence Module
- *
- * Provides contracts and types for implementing player data persistence.
- *
- * @example
- * ```typescript
- * import {
- *   PlayerPersistenceContract,
- *   PersistenceConfig,
- *   DEFAULT_PERSISTENCE_CONFIG
- * } from '@open-core/framework/server'
- *
- * class MyPersistenceProvider extends PlayerPersistenceContract {
- *   readonly config: PersistenceConfig = {
- *     ...DEFAULT_PERSISTENCE_CONFIG,
- *     autoSaveIntervalMs: 60000, // Override to 1 minute
- *   }
- *
- *   async onSessionLoad(player) { ... }
- *   async onSessionSave(player) { ... }
- *   async onAutoSave(player) { ... }
- * }
- *
- * // In your setup:
- * Server.setPersistenceProvider(MyPersistenceProvider)
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_PERSISTENCE_CONFIG = exports.PlayerPersistenceContract = void 0;
-var player_persistence_contract_1 = require("./player-persistence.contract");
-Object.defineProperty(exports, "PlayerPersistenceContract", { enumerable: true, get: function () { return player_persistence_contract_1.PlayerPersistenceContract; } });
-Object.defineProperty(exports, "DEFAULT_PERSISTENCE_CONFIG", { enumerable: true, get: function () { return player_persistence_contract_1.DEFAULT_PERSISTENCE_CONFIG; } });

package/dist/shared/index.d.ts

@@ -1 +0,0 @@
-export * from './logger';

package/dist/shared/logger/transports/index.d.ts

@@ -1,3 +0,0 @@
-export * from './transport.interface';
-export * from './console.transport';
-export * from './buffered.transport';

package/dist/shared/logger/transports/index.js

@@ -1,19 +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("./transport.interface"), exports);
-__exportStar(require("./console.transport"), exports);
-__exportStar(require("./buffered.transport"), exports);

package/dist/utils/errors.d.ts

@@ -1,14 +0,0 @@
-import type { SecurityAction } from '../server/types/security.types';
-export type FrameworkErroCode = 'PLAYER_NOT_FOUND' | 'INSUFFICIENT_FUNDS' | 'VALIDATION_ERROR' | 'API_ERROR' | 'NETWORK_ERROR' | 'UNAUTHORIZED' | 'PERMISSION_DENIED' | 'NOT_IMPLEMENTED' | 'NO_RANK_IN_PRINCIPAL' | 'UNKNOWN' | 'GAME_STATE_ERROR';
-export type ErrorOrigin = 'client' | 'server' | 'core' | 'external';
-export declare class AppError extends Error {
-    readonly code: FrameworkErroCode;
-    readonly details?: unknown;
-    readonly origin: ErrorOrigin;
-    constructor(code: FrameworkErroCode, message: string, origin: ErrorOrigin, details?: unknown);
-}
-export declare function isAppError(error: unknown): error is AppError;
-export declare class SecurityError extends AppError {
-    readonly action: SecurityAction;
-    constructor(action: SecurityAction, message: string, details?: unknown);
-}

package/dist/{client → runtime/client}/decorators/index.d.ts

@@ -1,10 +1,10 @@
 export * from './controller';
+export * from './export';
+export * from './gameEvent';
+export * from './interval';
 export * from './key';
+export * from './localEvent';
 export * from './nui';
 export * from './onNet';
-export * from './tick';
-export * from './localEvent';
-export * from './interval';
-export * from './export';
 export * from './resourceLifecycle';
-export * from './gameEvent';
+export * from './tick';

package/dist/{client → runtime/client}/decorators/index.js

@@ -15,12 +15,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./controller"), exports);
+__exportStar(require("./export"), exports);
+__exportStar(require("./gameEvent"), exports);
+__exportStar(require("./interval"), exports);
 __exportStar(require("./key"), exports);
+__exportStar(require("./localEvent"), exports);
 __exportStar(require("./nui"), exports);
 __exportStar(require("./onNet"), exports);
-__exportStar(require("./tick"), exports);
-__exportStar(require("./localEvent"), exports);
-__exportStar(require("./interval"), exports);
-__exportStar(require("./export"), exports);
 __exportStar(require("./resourceLifecycle"), exports);
-__exportStar(require("./gameEvent"), exports);
+__exportStar(require("./tick"), exports);

package/dist/{client → runtime/client}/system/processors.register.js

@@ -2,15 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerSystemClient = registerSystemClient;
 const client_container_1 = require("../client-container");
+const export_processor_1 = require("./processors/export.processor");
+const gameEvent_processor_1 = require("./processors/gameEvent.processor");
+const interval_processor_1 = require("./processors/interval.processor");
 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 netEvent_processor_1 = require("./processors/netEvent.processor");
+const nui_processor_1 = require("./processors/nui.processor");
 const resourceLifecycle_processor_1 = require("./processors/resourceLifecycle.processor");
-const gameEvent_processor_1 = require("./processors/gameEvent.processor");
+const tick_processor_1 = require("./processors/tick.processor");
 function registerSystemClient() {
     // Core processors
     client_container_1.di.register('DecoratorProcessor', { useClass: key_processor_1.KeyMappingProcessor });