@open-core/framework 0.2.1-beta.1 → 0.2.2-beta.1

package/README.md

@@ -1,4 +1,4 @@
-# OpenCore Framework (v0.2.1-beta.1)
+# OpenCore Framework (v0.2.2-beta.1)
 
 OpenCore is a TypeScript multiplayer runtime framework targeting FiveM via an adapter.
 

package/dist/runtime/server/decorators/command.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { ClassConstructor } from '../../../kernel/di/class-constructor';
+import { Player } from '../entities/player';
 import { SecurityMetadata } from '../types/core-exports';
 export interface CommandConfig {
     /**
@@ -34,6 +35,7 @@ export interface CommandMetadata extends CommandConfig {
     /** Security metadata for remote validation */
     security?: SecurityMetadata;
 }
+type ServerCommandHandler = (() => any) | ((player: Player, ...args: any[]) => any);
 /**
  * Registers a method as a chat command.
  *
@@ -76,6 +78,7 @@ export interface CommandMetadata extends CommandConfig {
  * }
  * ```
  */
-export declare function Command(name: string, schema: z.ZodType): MethodDecorator;
-export declare function Command(name: string): MethodDecorator;
-export declare function Command(config: CommandConfig): MethodDecorator;
+export declare function Command(name: string, schema: z.ZodType): <T extends ServerCommandHandler>(target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => void;
+export declare function Command(name: string): <T extends ServerCommandHandler>(target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => void;
+export declare function Command(config: CommandConfig): <T extends ServerCommandHandler>(target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => void;
+export {};

package/dist/runtime/server/decorators/onNet.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { Player } from '../entities/player';
 export interface NetEventOptions {
     /**
      * The network event name to register.
@@ -15,6 +16,7 @@ export interface NetEventOptions {
      */
     paramTypes: any;
 }
+type ServerNetHandler<TArgs extends any[] = any[]> = (player: Player, ...args: TArgs) => any;
 /**
  * Registers a method as a server-side network event handler.
  *
@@ -58,5 +60,6 @@ export interface NetEventOptions {
  * }
  * ```
  */
-export declare function OnNet<_TArgs extends any[]>(eventName: string, schema: z.ZodType): MethodDecorator;
-export declare function OnNet<_TArgs extends any[]>(eventName: string, options?: Pick<NetEventOptions, 'schema'>): MethodDecorator;
+export declare function OnNet<TArgs extends any[]>(eventName: string, schema: z.ZodType): <H extends ServerNetHandler<TArgs>>(target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<H>) => void;
+export declare function OnNet<TArgs extends any[]>(eventName: string, options?: Pick<NetEventOptions, 'schema'>): <H extends ServerNetHandler<TArgs>>(target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<H>) => void;
+export {};

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

@@ -1,5 +1,6 @@
 import { Server } from '../../..';
 import { RGB } from '../../../kernel/utils';
+import { PlayerDirectoryPort } from './ports/player-directory.port';
 /**
  * Service for sending chat messages to players.
  *
@@ -7,6 +8,8 @@ import { RGB } from '../../../kernel/utils';
  * This service emits framework chat events over the network.
  */
 export declare class ChatService {
+    private readonly playerDirectory;
+    constructor(playerDirectory: PlayerDirectoryPort);
     /**
      * Broadcast a chat message to all connected players.
      *
@@ -30,4 +33,34 @@ export declare class ChatService {
      * @param player - Target player.
      */
     clearChat(player: Server.Player): void;
+    /**
+     * Send a chat message to multiple players.
+     *
+     * @param players - Array of target players or their client IDs.
+     * @param message - Message body.
+     * @param author - Author label.
+     * @param color - Message color (RGB).
+     */
+    sendMany(players: (Server.Player | number)[], message: string, author?: string, color?: RGB): void;
+    /**
+     * Send a chat message to players within a certain radius of a specific player.
+     *
+     * @param playerFrom - Origin player.
+     * @param message - Message body.
+     * @param radius - Distance radius in game units.
+     * @param author - Author label.
+     * @param color - Message color (RGB).
+     */
+    sendNearby(playerFrom: Server.Player, message: string, radius: number, author?: string, color?: RGB): void;
+    /**
+     * Broadcast a system message to all players.
+     *
+     * @param message - Message body.
+     * @param color - Message color (RGB). Defaults to a light blue/cyan.
+     */
+    broadcastSystem(message: string, color?: RGB): void;
+    /**
+     * Clear chat for all connected players.
+     */
+    clearChatAll(): void;
 }

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

@@ -5,9 +5,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     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.ChatService = void 0;
 const tsyringe_1 = require("tsyringe");
+const player_directory_port_1 = require("./ports/player-directory.port");
 /**
  * Service for sending chat messages to players.
  *
@@ -15,6 +19,9 @@ const tsyringe_1 = require("tsyringe");
  * This service emits framework chat events over the network.
  */
 let ChatService = class ChatService {
+    constructor(playerDirectory) {
+        this.playerDirectory = playerDirectory;
+    }
     /**
      * Broadcast a chat message to all connected players.
      *
@@ -50,8 +57,67 @@ let ChatService = class ChatService {
     clearChat(player) {
         emitNet('core:chat:clear', player.clientID);
     }
+    /**
+     * Send a chat message to multiple players.
+     *
+     * @param players - Array of target players or their client IDs.
+     * @param message - Message body.
+     * @param author - Author label.
+     * @param color - Message color (RGB).
+     */
+    sendMany(players, message, author = 'SYSTEM', color = { r: 255, g: 255, b: 255 }) {
+        players.forEach((p) => {
+            const targetId = typeof p === 'number' ? p : p.clientID;
+            emitNet('core:chat:addMessage', targetId, {
+                args: [author, message],
+                color: color,
+            });
+        });
+    }
+    /**
+     * Send a chat message to players within a certain radius of a specific player.
+     *
+     * @param playerFrom - Origin player.
+     * @param message - Message body.
+     * @param radius - Distance radius in game units.
+     * @param author - Author label.
+     * @param color - Message color (RGB).
+     */
+    sendNearby(playerFrom, message, radius, author = playerFrom.name, color = { r: 255, g: 255, b: 255 }) {
+        const originPos = playerFrom.getPosition();
+        if (!originPos)
+            return;
+        const allPlayers = this.playerDirectory.getAll();
+        const nearbyPlayers = allPlayers.filter((p) => {
+            const pos = p.getPosition();
+            if (!pos)
+                return false;
+            const dx = originPos.x - pos.x;
+            const dy = originPos.y - pos.y;
+            const dz = originPos.z - pos.z;
+            const distance = Math.sqrt(dx * dx + dy * dy + dz * dz);
+            return distance <= radius;
+        });
+        this.sendMany(nearbyPlayers, message, author, color);
+    }
+    /**
+     * Broadcast a system message to all players.
+     *
+     * @param message - Message body.
+     * @param color - Message color (RGB). Defaults to a light blue/cyan.
+     */
+    broadcastSystem(message, color = { r: 0, g: 191, b: 255 }) {
+        this.broadcast(message, 'SYSTEM', color);
+    }
+    /**
+     * Clear chat for all connected players.
+     */
+    clearChatAll() {
+        emitNet('core:chat:clear', -1);
+    }
 };
 exports.ChatService = ChatService;
 exports.ChatService = ChatService = __decorate([
-    (0, tsyringe_1.injectable)()
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [player_directory_port_1.PlayerDirectoryPort])
 ], ChatService);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-core/framework",
-  "version": "0.2.1-beta.1",
+  "version": "0.2.2-beta.1",
   "description": "Secure, Event-Driven, OOP Engine for FiveM. Stop scripting, start engineering.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -47,6 +47,7 @@
     "./package.json": "./package.json"
   },
   "scripts": {
+    "publish": "pnpm build && npm publish",
     "build": "tsc -p tsconfig.build.json",
     "watch": "tsc -p tsconfig.build.json --watch",
     "check": "biome check .",