@open-core/framework 0.2.5 → 0.2.7

package/dist/runtime/server/controllers/session.controller.js

@@ -38,7 +38,7 @@ let SessionController = class SessionController {
             const currentPlayer = this.playerDirectory.getByClient(clientId);
             if (!currentPlayer)
                 return;
-            (0, internal_event_bus_1.emitFrameworkEvent)('internal:playerFullyConnected', currentPlayer);
+            (0, internal_event_bus_1.emitFrameworkEvent)('internal:playerFullyConnected', { player: currentPlayer });
         });
     }
     async onPlayerDropped() {

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

@@ -1,9 +1,4 @@
 import { InternalEventMap } from '../types/internal-events';
-/**
- * Handler function type for framework events.
- * Accepts the event payload and returns void or Promise<void>.
- */
-type FrameworkEventHandler<K extends keyof InternalEventMap> = (payload: InternalEventMap[K]) => void | Promise<void>;
 /**
  * Registers a method as a listener for an internal OpenCore framework event.
  *
@@ -11,21 +6,19 @@ type FrameworkEventHandler<K extends keyof InternalEventMap> = (payload: Interna
  * This decorator only stores metadata. The framework binds listeners during bootstrap by scanning
  * controller methods.
  *
- * The method signature is type-checked against the event payload. TypeScript will error if
- * the handler parameter type doesn't match the expected payload for the specified event.
+ * The handler should accept the payload type corresponding to the event from {@link InternalEventMap}.
  *
- * @param event - Core event name, strongly typed to {@link InternalEventMap}.
+ * @param event - Internal event name, strongly typed to {@link InternalEventMap}.
  *
  * @example
  * ```ts
  * @Server.Controller()
  * export class SystemController {
- *   @Server.OnFrameworkEvent('core:playerSessionCreated')
- *   onPlayerSession(payload: PlayerSessionCreatedPayload) {
- *     console.log(`Player ${payload.clientId} connected`)
+ *   @Server.OnFrameworkEvent('internal:playerFullyConnected')
+ *   onPlayerConnected(payload: PlayerFullyConnectedPayload) {
+ *     console.log(`Player ${payload.player.session.clientId} connected`)
  *   }
  * }
  * ```
  */
-export declare function OnFrameworkEvent<K extends keyof InternalEventMap>(event: K): (target: object, propertyKey: string | symbol, _descriptor: TypedPropertyDescriptor<FrameworkEventHandler<K>>) => void;
-export {};
+export declare function OnFrameworkEvent<K extends keyof InternalEventMap>(event: K): (target: object, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;

package/dist/runtime/server/decorators/onFrameworkEvent.js

@@ -9,18 +9,17 @@ const metadata_server_keys_1 = require("../system/metadata-server.keys");
  * This decorator only stores metadata. The framework binds listeners during bootstrap by scanning
  * controller methods.
  *
- * The method signature is type-checked against the event payload. TypeScript will error if
- * the handler parameter type doesn't match the expected payload for the specified event.
+ * The handler should accept the payload type corresponding to the event from {@link InternalEventMap}.
  *
- * @param event - Core event name, strongly typed to {@link InternalEventMap}.
+ * @param event - Internal event name, strongly typed to {@link InternalEventMap}.
  *
  * @example
  * ```ts
  * @Server.Controller()
  * export class SystemController {
- *   @Server.OnFrameworkEvent('core:playerSessionCreated')
- *   onPlayerSession(payload: PlayerSessionCreatedPayload) {
- *     console.log(`Player ${payload.clientId} connected`)
+ *   @Server.OnFrameworkEvent('internal:playerFullyConnected')
+ *   onPlayerConnected(payload: PlayerFullyConnectedPayload) {
+ *     console.log(`Player ${payload.player.session.clientId} connected`)
  *   }
  * }
  * ```

package/dist/runtime/server/types/internal-events.d.ts

@@ -11,9 +11,12 @@ export interface TransferCompletedPayload {
     amount: number;
     targetId: number;
 }
+export interface PlayerFullyConnectedPayload {
+    player: Player;
+}
 export type InternalEventMap = {
     'internal:playerSessionCreated': PlayerSessionCreatedPayload;
     'internal:playerSessionDestroyed': PlayerSessionDestroyedPayload;
     'internal:transfer:completed': TransferCompletedPayload;
-    'internal:playerFullyConnected': Player;
+    'internal:playerFullyConnected': PlayerFullyConnectedPayload;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-core/framework",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Secure, Event-Driven, OOP Engine for FiveM. Stop scripting, start engineering.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -82,19 +82,19 @@
     "reflect-metadata": "^0.2.2",
     "tsyringe": "^4.10.0",
     "uuid": "^13.0.0",
-    "zod": "^4.1.13"
+    "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.10",
+    "@biomejs/biome": "^2.3.11",
     "@citizenfx/client": "2.0.22443-1",
     "@citizenfx/server": "2.0.22443-1",
-    "@types/node": "^24.10.1",
-    "@vitest/coverage-v8": "^4.0.15",
+    "@types/node": "^25.0.3",
+    "@vitest/coverage-v8": "^4.0.16",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.32.0",
-    "tinybench": "^2.7.0",
-    "tsx": "^4.19.2",
+    "tinybench": "^2.9.0",
+    "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.15"
+    "vitest": "^4.0.16"
   }
 }