@open-core/framework 1.0.5-beta.2 → 1.0.5

package/dist/adapters/contracts/transport/events.api.d.ts

@@ -1,6 +1,6 @@
 import { EventContext, RuntimeContext } from './context';
 import { Player } from '../../../runtime/server/entities/player';
-type EmitArgs<C extends RuntimeContext> = C extends 'server' ? [target: Player | number | number[] | 'all', ...args: any[]] : [...args: any[]];
+type EmitArgs<C extends RuntimeContext> = C extends 'server' ? [target: Player | number | number[] | 'all', ...args: unknown[]] : [...args: unknown[]];
 /**
  * broadcast and listen to events without relying on runtime. The adapter will be used.
  */
@@ -13,7 +13,7 @@ export declare abstract class EventsAPI<C extends RuntimeContext> {
      * Client:
      *   - triggered by server
      */
-    abstract on(event: string, handler: (ctx: EventContext, ...args: any[]) => void | Promise<void>): void;
+    abstract on<TArgs extends readonly unknown[]>(event: string, handler: (ctx: EventContext, ...args: TArgs) => void | Promise<void>): void;
     /**
      * Emit an event.
      *  SERVER → CLIENT
@@ -22,7 +22,7 @@ export declare abstract class EventsAPI<C extends RuntimeContext> {
      * Client:
      *   - sends to server, targetOrArg will be ignored
      */
-    abstract emit(event: string, target: Player | number | number[] | 'all', ...args: any[]): void;
+    abstract emit(event: string, target: Player | number | number[] | 'all', ...args: unknown[]): void;
     /**
      * Emit an event.
      *  CLIENT → SERVER

package/dist/adapters/contracts/transport/rpc.api.d.ts

@@ -14,8 +14,8 @@ export interface RpcContext extends EventContext {
  */
 export type RpcTarget = number | number[] | 'all';
 export type RpcCallTarget = number | number[];
-type RpcCallArgs<C extends RuntimeContext> = C extends 'server' ? [target: RpcCallTarget, ...args: any[]] : [...args: any[]];
-type RpcNotifyArgs<C extends RuntimeContext> = C extends 'server' ? [target: RpcTarget, ...args: any[]] : [...args: any[]];
+type RpcCallArgs<C extends RuntimeContext> = C extends 'server' ? [target: RpcCallTarget, ...args: unknown[]] : [...args: unknown[]];
+type RpcNotifyArgs<C extends RuntimeContext> = C extends 'server' ? [target: RpcTarget, ...args: unknown[]] : [...args: unknown[]];
 /**
  * Remote Procedure Call API.
  *
@@ -47,7 +47,7 @@ export declare abstract class RpcAPI<C extends RuntimeContext> {
      * The handler receives a {@link RpcContext}. In server environments this usually includes
      * the `clientId` of the caller (via {@link EventContext}).
      */
-    abstract on<TArgs extends any[], TResult>(name: string, handler: (ctx: RpcContext, ...args: TArgs) => TResult | Promise<TResult>): void;
+    abstract on<TArgs extends readonly unknown[], TResult>(name: string, handler: (ctx: RpcContext, ...args: TArgs) => TResult | Promise<TResult>): void;
     /**
      * Call an RPC and wait for the result.
      *

package/dist/adapters/node/transport/node.events.d.ts

@@ -3,12 +3,12 @@ import { RuntimeContext } from '../../contracts/transport/context';
 type NodeTarget = number | number[] | 'all';
 export declare class NodeEvents extends EventsAPI<RuntimeContext> {
     private readonly emitter;
-    on(event: string, handler: (ctx: {
+    on<TArgs extends readonly unknown[]>(event: string, handler: (ctx: {
         clientId?: number;
         raw?: unknown;
-    }, ...args: any[]) => any): void;
-    emit(event: string, targetOrArg?: NodeTarget | any, ...args: any[]): void;
-    simulateClientEvent(event: string, clientId: number, ...args: any[]): void;
+    }, ...args: TArgs) => unknown): void;
+    emit(event: string, targetOrArg?: NodeTarget | unknown, ...args: unknown[]): void;
+    simulateClientEvent(event: string, clientId: number, ...args: unknown[]): void;
     clearHandlers(): void;
 }
 export {};

package/dist/adapters/node/transport/node.rpc.d.ts

@@ -4,13 +4,13 @@ export declare class NodeRpc<C extends RuntimeContext = RuntimeContext> extends
     private readonly context;
     private readonly handlers;
     constructor(context: C);
-    on<TArgs extends any[], TResult>(name: string, handler: (ctx: {
+    on<TArgs extends readonly unknown[], TResult>(name: string, handler: (ctx: {
         requestId: string;
         clientId?: number;
         raw?: unknown;
     }, ...args: TArgs) => TResult | Promise<TResult>): void;
-    call<TResult = unknown>(name: string, ...args: any[]): Promise<TResult>;
-    notify(name: string, ...args: any[]): Promise<void>;
+    call<TResult = unknown>(name: string, ...args: unknown[]): Promise<TResult>;
+    notify(name: string, ...args: unknown[]): Promise<void>;
     private normalizeInvocation;
     private isValidTarget;
     private executeCall;

package/dist/adapters/node/transport/node.rpc.js

@@ -8,7 +8,7 @@ export class NodeRpc extends RpcAPI {
         this.context = context;
     }
     on(name, handler) {
-        this.handlers.set(name, handler);
+        this.handlers.set(name, (ctx, ...args) => handler(ctx, ...args));
     }
     call(name, ...args) {
         const { target, payload } = this.normalizeInvocation(name, 'call', args);

package/dist/contracts.d.ts

@@ -2,3 +2,4 @@ export * from './adapters/contracts/IHasher';
 export * from './adapters/contracts/transport';
 export * from './adapters/contracts/types';
 export * from './adapters/contracts/runtime';
+export * from './runtime/shared/types/system-types';

package/dist/contracts.js

@@ -2,3 +2,4 @@ export * from './adapters/contracts/IHasher';
 export * from './adapters/contracts/transport';
 export * from './adapters/contracts/types';
 export * from './adapters/contracts/runtime';
+export * from './runtime/shared/types/system-types';

package/dist/index.d.ts

@@ -2,3 +2,4 @@ import 'reflect-metadata';
 export * from './kernel';
 export * from './runtime/core';
 export * from './contracts';
+export * from './runtime/shared/types/system-types';

package/dist/index.js

@@ -2,3 +2,4 @@ import 'reflect-metadata';
 export * from './kernel';
 export * from './runtime/core';
 export * from './contracts';
+export * from './runtime/shared/types/system-types';

package/dist/kernel/logger/client-log-console.js

@@ -9,26 +9,26 @@ class DefaultClientLogConsole extends IClientLogConsole {
         return DEFAULT_CLIENT_LOG_CONSOLE_CAPABILITIES;
     }
     trace(message, details) {
-        this.write(console.debug, message, details);
+        this.write('debug', message, details);
     }
     debug(message, details) {
-        this.write(console.debug, message, details);
+        this.write('debug', message, details);
     }
     info(message, details) {
-        this.write(console.info, message, details);
+        this.write('info', message, details);
     }
     warn(message, details) {
-        this.write(console.warn, message, details);
+        this.write('warn', message, details);
     }
     error(message, details) {
-        this.write(console.error, message, details);
+        this.write('error', message, details);
     }
-    write(method, message, details) {
+    write(level, message, details) {
         if (details === undefined) {
-            method(message);
+            console[level](message);
             return;
         }
-        method(message, details);
+        console[level](message, details);
     }
 }
 let activeClientLogConsole = new DefaultClientLogConsole();

package/dist/kernel/logger/index.d.ts

@@ -6,7 +6,7 @@ export { getLogLevel, isClientEnvironment, isDebugMode, isFiveMEnvironment, isSe
 export { ChildLogger, LoggerService } from './logger.service';
 export type { ClientLogConsoleCapabilities } from '../../adapters/contracts/client/IClientLogConsole';
 export type { LogContext, LogEntry } from './logger.types';
-export { LogDomain, LogDomainLabels, LogLevel, LogLevelLabels, parseLogLevel } from './logger.types';
+export { getLogDomainLabel, LogDomain, LogDomainLabels, LogLevel, LogLevelLabels, parseLogLevel, } from './logger.types';
 export type { BufferedTransportOptions, LogOutputFormat } from './transports/buffered.transport';
 export { BufferedTransport } from './transports/buffered.transport';
 export type { ConsoleTransportOptions } from './transports/console.transport';

package/dist/kernel/logger/index.js

@@ -7,7 +7,7 @@ export { createLoggerConfig, DEFAULT_LOGGER_CONFIG } from './logger.config';
 export { getLogLevel, isClientEnvironment, isDebugMode, isFiveMEnvironment, isServerEnvironment, } from './logger.env';
 // Service
 export { ChildLogger, LoggerService } from './logger.service';
-export { LogDomain, LogDomainLabels, LogLevel, LogLevelLabels, parseLogLevel } from './logger.types';
+export { getLogDomainLabel, LogDomain, LogDomainLabels, LogLevel, LogLevelLabels, parseLogLevel, } from './logger.types';
 export { BufferedTransport } from './transports/buffered.transport';
 export { ConsoleTransport } from './transports/console.transport';
 export { SimpleConsoleTransport } from './transports/simple-console.transport';

package/dist/kernel/logger/logger.types.d.ts

@@ -45,6 +45,7 @@ export declare enum LogDomain {
  * Human-readable labels for each log domain.
  */
 export declare const LogDomainLabels: Record<LogDomain, string>;
+export declare function getLogDomainLabel(domain: LogDomain): string;
 /**
  * Additional contextual information that can be attached to any log entry.
  * Useful for tracing, debugging, and correlation.

package/dist/kernel/logger/logger.types.js

@@ -60,6 +60,41 @@ export const LogDomainLabels = {
     [LogDomain.CLIENT]: 'CLIENT',
     [LogDomain.EXTERNAL]: 'EXTERNAL',
 };
+function normalizeResourceName(resourceName) {
+    return resourceName.trim().replace(/^\[(.*)\]$/, '$1');
+}
+function getInjectedResourceName() {
+    if (typeof __OPENCORE_RESOURCE_NAME__ === 'string' &&
+        normalizeResourceName(__OPENCORE_RESOURCE_NAME__).length > 0) {
+        return normalizeResourceName(__OPENCORE_RESOURCE_NAME__);
+    }
+    const fn = globalThis.GetCurrentResourceName;
+    if (typeof fn === 'function') {
+        try {
+            const value = fn();
+            if (typeof value === 'string' && normalizeResourceName(value).length > 0) {
+                return normalizeResourceName(value);
+            }
+        }
+        catch {
+            // Ignore runtime lookup failures and fall back to default labels.
+        }
+    }
+    return undefined;
+}
+export function getLogDomainLabel(domain) {
+    if (domain !== LogDomain.FRAMEWORK) {
+        return LogDomainLabels[domain];
+    }
+    const resourceName = getInjectedResourceName();
+    if (!resourceName) {
+        return LogDomainLabels[domain];
+    }
+    if (resourceName.toLowerCase() === 'core') {
+        return 'CORE';
+    }
+    return resourceName.toUpperCase();
+}
 /**
  * Configuration for parsing log level from string (useful for env vars).
  */

package/dist/kernel/logger/transports/buffered.transport.js

@@ -1,4 +1,4 @@
-import { LogDomainLabels, LogLevel, LogLevelLabels } from '../logger.types';
+import { getLogDomainLabel, LogLevel, LogLevelLabels } from '../logger.types';
 /**
  * A transport that buffers log entries in memory for later export.
  *
@@ -95,7 +95,7 @@ export class BufferedTransport {
         const entries = this.buffer.map((entry) => ({
             timestamp: entry.timestamp,
             level: LogLevelLabels[entry.level],
-            domain: LogDomainLabels[entry.domain],
+            domain: getLogDomainLabel(entry.domain),
             source: entry.context?.source,
             message: entry.message,
             context: this.cleanContext(entry.context),
@@ -114,7 +114,7 @@ export class BufferedTransport {
             .map((entry) => {
             const time = entry.timestamp.replace('T', ' ').slice(0, 23);
             const level = LogLevelLabels[entry.level].padEnd(5);
-            const domain = LogDomainLabels[entry.domain].padEnd(8);
+            const domain = getLogDomainLabel(entry.domain).padEnd(8);
             const source = entry.context?.source ? `[${entry.context.source}]` : '';
             let line = `${time} | ${domain} | ${level} | ${source} ${entry.message}`;
             const ctx = this.cleanContext(entry.context);
@@ -133,7 +133,7 @@ export class BufferedTransport {
         const rows = this.buffer.map((entry) => [
             entry.timestamp,
             LogLevelLabels[entry.level],
-            LogDomainLabels[entry.domain],
+            getLogDomainLabel(entry.domain),
             entry.context?.source ?? '',
             `"${entry.message.replace(/"/g, '""')}"`,
             JSON.stringify(this.cleanContext(entry.context)),

package/dist/kernel/logger/transports/console.transport.js

@@ -1,4 +1,4 @@
-import { LogDomain, LogDomainLabels, LogLevel, LogLevelLabels, } from '../logger.types';
+import { getLogDomainLabel, LogDomain, LogLevel, LogLevelLabels, } from '../logger.types';
 /**
  * Color codes for console output.
  * Uses ANSI escape codes compatible with most terminals.
@@ -63,7 +63,7 @@ export class ConsoleTransport {
     write(entry) {
         const { level, domain, message, timestamp, context, error } = entry;
         const levelLabel = LogLevelLabels[level].padEnd(5);
-        const domainLabel = LogDomainLabels[domain];
+        const domainLabel = getLogDomainLabel(domain);
         const levelColor = this.colors ? LEVEL_COLORS[level] : '';
         const domainColor = this.colors ? DOMAIN_COLORS[domain] : '';
         const reset = this.colors ? COLORS.reset : '';

package/dist/kernel/logger/transports/simple-console.transport.js

@@ -1,4 +1,4 @@
-import { LogDomainLabels, LogLevel, LogLevelLabels } from '../logger.types';
+import { getLogDomainLabel, LogLevel, LogLevelLabels } from '../logger.types';
 import { getClientLogConsole } from '../client-log-console';
 /**
  * Simple console transport without ANSI color codes.
@@ -29,7 +29,7 @@ export class SimpleConsoleTransport {
         const output = getClientLogConsole();
         const capabilities = output.getCapabilities();
         const levelLabel = LogLevelLabels[level].padEnd(5);
-        const domainLabel = LogDomainLabels[domain];
+        const domainLabel = getLogDomainLabel(domain);
         // Build the log line without ANSI codes
         const parts = [];
         if (this.timestamps) {

package/dist/runtime/client/adapter/index.d.ts

@@ -1,6 +1,11 @@
 export * from './client-adapter';
+export * from '../../../adapters/contracts/client/camera/IClientCameraPort';
 export * from '../../../adapters/contracts/client/IClientLogConsole';
+export * from '../../../adapters/contracts/client/ped/IClientPedPort';
+export * from '../../../adapters/contracts/client/progress/IClientProgressPort';
+export * from '../../../adapters/contracts/client/spawn/IClientSpawnPort';
 export * from '../../../adapters/contracts/client/spawn/IClientSpawnBridge';
+export * from '../../../adapters/contracts/client/vehicle/IClientVehiclePort';
 export * from '../../../adapters/contracts/client/ui/IClientBlipBridge';
 export * from '../../../adapters/contracts/client/ui/IClientMarkerBridge';
 export * from '../../../adapters/contracts/client/ui/IClientNotificationBridge';

package/dist/runtime/client/adapter/index.js

@@ -1,6 +1,11 @@
 export * from './client-adapter';
+export * from '../../../adapters/contracts/client/camera/IClientCameraPort';
 export * from '../../../adapters/contracts/client/IClientLogConsole';
+export * from '../../../adapters/contracts/client/ped/IClientPedPort';
+export * from '../../../adapters/contracts/client/progress/IClientProgressPort';
+export * from '../../../adapters/contracts/client/spawn/IClientSpawnPort';
 export * from '../../../adapters/contracts/client/spawn/IClientSpawnBridge';
+export * from '../../../adapters/contracts/client/vehicle/IClientVehiclePort';
 export * from '../../../adapters/contracts/client/ui/IClientBlipBridge';
 export * from '../../../adapters/contracts/client/ui/IClientMarkerBridge';
 export * from '../../../adapters/contracts/client/ui/IClientNotificationBridge';

package/dist/runtime/client/adapter/node-camera-port.d.ts

@@ -0,0 +1,19 @@
+import { type ClientCameraCreateOptions, type ClientCameraRotation, type ClientCameraRenderOptions, type ClientCameraShakeOptions, type ClientCameraTransform, IClientCameraPort } from '../../../adapters/contracts/client/camera/IClientCameraPort';
+import type { Vector3 } from '../../../kernel/utils/vector3';
+export declare class NodeClientCameraPort extends IClientCameraPort {
+    create(_options?: ClientCameraCreateOptions): number;
+    setActive(_camera: number, _active: boolean): void;
+    render(_enable: boolean, _options?: ClientCameraRenderOptions): void;
+    destroy(_camera: number, _destroyActiveCamera?: boolean): void;
+    destroyAll(_destroyActiveCamera?: boolean): void;
+    setTransform(_camera: number, _transform: ClientCameraTransform): void;
+    setPosition(_camera: number, _position: Vector3): void;
+    setRotation(_camera: number, _rotation: ClientCameraRotation, _rotationOrder?: number): void;
+    setFov(_camera: number, _fov: number): void;
+    pointAtCoords(_camera: number, _position: Vector3): void;
+    pointAtEntity(_camera: number, _entity: number, _offset?: Vector3): void;
+    stopPointing(_camera: number): void;
+    interpolate(_fromCamera: number, _toCamera: number, _durationMs: number, _easeLocation?: boolean, _easeRotation?: boolean): void;
+    shake(_camera: number, _options: ClientCameraShakeOptions): void;
+    stopShaking(_camera: number, _stopImmediately?: boolean): void;
+}

package/dist/runtime/client/adapter/node-camera-port.js

@@ -0,0 +1,31 @@
+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;
+};
+import { injectable } from 'tsyringe';
+import { IClientCameraPort, } from '../../../adapters/contracts/client/camera/IClientCameraPort';
+let NodeClientCameraPort = class NodeClientCameraPort extends IClientCameraPort {
+    create(_options) {
+        return 0;
+    }
+    setActive(_camera, _active) { }
+    render(_enable, _options) { }
+    destroy(_camera, _destroyActiveCamera) { }
+    destroyAll(_destroyActiveCamera) { }
+    setTransform(_camera, _transform) { }
+    setPosition(_camera, _position) { }
+    setRotation(_camera, _rotation, _rotationOrder) { }
+    setFov(_camera, _fov) { }
+    pointAtCoords(_camera, _position) { }
+    pointAtEntity(_camera, _entity, _offset) { }
+    stopPointing(_camera) { }
+    interpolate(_fromCamera, _toCamera, _durationMs, _easeLocation, _easeRotation) { }
+    shake(_camera, _options) { }
+    stopShaking(_camera, _stopImmediately) { }
+};
+NodeClientCameraPort = __decorate([
+    injectable()
+], NodeClientCameraPort);
+export { NodeClientCameraPort };

package/dist/runtime/client/adapter/node-client-adapter.js

@@ -5,20 +5,29 @@ import { NodeClientLocalPlayerBridge } from './node-local-player-bridge';
 import { NodeClientNotificationBridge } from './node-notification-bridge';
 import { IClientLogConsole } from '../../../adapters/contracts/client/IClientLogConsole';
 import { IClientSpawnBridge } from '../../../adapters/contracts/client/spawn/IClientSpawnBridge';
+import { IClientSpawnPort } from '../../../adapters/contracts/client/spawn/IClientSpawnPort';
 import { IClientBlipBridge } from '../../../adapters/contracts/client/ui/IClientBlipBridge';
 import { IClientMarkerBridge } from '../../../adapters/contracts/client/ui/IClientMarkerBridge';
 import { IClientNotificationBridge } from '../../../adapters/contracts/client/ui/IClientNotificationBridge';
 import { IClientWebViewBridge } from '../../../adapters/contracts/client/ui/webview/IClientWebViewBridge';
 import { installNodeClientLogConsole, NodeClientLogConsole } from './node-log-console';
 import { NodeClientBlipBridge } from './node-blip-bridge';
+import { NodeClientCameraPort } from './node-camera-port';
 import { NodeClientMarkerBridge } from './node-marker-bridge';
+import { NodeClientPedPort } from './node-ped-port';
 import { NodeClientPlatformBridge } from './node-platform-bridge';
+import { NodeClientProgressPort } from './node-progress-port';
 import { NodeClientSpawnBridge } from './node-spawn-bridge';
+import { NodeClientVehiclePort } from './node-vehicle-port';
 import { NodeClientWebViewBridge } from './node-webview-bridge';
 import { IClientPlatformBridge } from './platform-bridge';
 import { NodeClientRuntimeBridge } from './node-runtime-bridge';
 import { defineClientAdapter } from './client-adapter';
 import { IClientRuntimeBridge } from './runtime-bridge';
+import { IClientCameraPort } from '../../../adapters/contracts/client/camera/IClientCameraPort';
+import { IClientPedPort } from '../../../adapters/contracts/client/ped/IClientPedPort';
+import { IClientProgressPort } from '../../../adapters/contracts/client/progress/IClientProgressPort';
+import { IClientVehiclePort } from '../../../adapters/contracts/client/vehicle/IClientVehiclePort';
 /**
  * Default client adapter used when no runtime adapter is provided.
  */
@@ -38,7 +47,12 @@ export function createNodeClientAdapter() {
             ctx.bindSingleton(IClientRuntimeBridge, NodeClientRuntimeBridge);
             ctx.bindSingleton(IClientLocalPlayerBridge, NodeClientLocalPlayerBridge);
             ctx.bindSingleton(IClientPlatformBridge, NodeClientPlatformBridge);
-            ctx.bindSingleton(IClientSpawnBridge, NodeClientSpawnBridge);
+            ctx.bindSingleton(IClientCameraPort, NodeClientCameraPort);
+            ctx.bindSingleton(IClientVehiclePort, NodeClientVehiclePort);
+            ctx.bindSingleton(IClientPedPort, NodeClientPedPort);
+            ctx.bindSingleton(IClientProgressPort, NodeClientProgressPort);
+            ctx.bindSingleton(IClientSpawnPort, NodeClientSpawnBridge);
+            ctx.bindFactory(IClientSpawnBridge, () => ctx.container.resolve(IClientSpawnPort));
             ctx.bindSingleton(IClientBlipBridge, NodeClientBlipBridge);
             ctx.bindSingleton(IClientMarkerBridge, NodeClientMarkerBridge);
             ctx.bindSingleton(IClientNotificationBridge, NodeClientNotificationBridge);

package/dist/runtime/client/adapter/node-local-player-bridge.d.ts

@@ -4,5 +4,8 @@ import { IClientLocalPlayerBridge } from './local-player-bridge';
  * Node fallback local player bridge.
  */
 export declare class NodeClientLocalPlayerBridge extends IClientLocalPlayerBridge {
+    getHandle(): number;
+    getPosition(): Vector3;
+    getHeading(): number;
     setPosition(_position: Vector3, _heading?: number): void;
 }

package/dist/runtime/client/adapter/node-local-player-bridge.js

@@ -10,6 +10,15 @@ import { IClientLocalPlayerBridge } from './local-player-bridge';
  * Node fallback local player bridge.
  */
 let NodeClientLocalPlayerBridge = class NodeClientLocalPlayerBridge extends IClientLocalPlayerBridge {
+    getHandle() {
+        return 0;
+    }
+    getPosition() {
+        return { x: 0, y: 0, z: 0 };
+    }
+    getHeading() {
+        return 0;
+    }
     setPosition(_position, _heading) { }
 };
 NodeClientLocalPlayerBridge = __decorate([

package/dist/runtime/client/adapter/node-log-console.js

@@ -17,26 +17,26 @@ let NodeClientLogConsole = class NodeClientLogConsole extends IClientLogConsole
         return NODE_CLIENT_LOG_CAPABILITIES;
     }
     trace(message, details) {
-        this.write(console.debug, message, details);
+        this.write('debug', message, details);
     }
     debug(message, details) {
-        this.write(console.debug, message, details);
+        this.write('debug', message, details);
     }
     info(message, details) {
-        this.write(console.info, message, details);
+        this.write('info', message, details);
     }
     warn(message, details) {
-        this.write(console.warn, message, details);
+        this.write('warn', message, details);
     }
     error(message, details) {
-        this.write(console.error, message, details);
+        this.write('error', message, details);
     }
-    write(method, message, details) {
+    write(level, message, details) {
         if (details === undefined) {
-            method(message);
+            console[level](message);
             return;
         }
-        method(message, details);
+        console[level](message, details);
     }
 };
 NodeClientLogConsole = __decorate([

package/dist/runtime/client/adapter/node-ped-port.d.ts

@@ -0,0 +1,20 @@
+import { type ClientPedAnimationOptions, type ClientPedSpawnOptions, IClientPedPort } from '../../../adapters/contracts/client/ped/IClientPedPort';
+import type { Vector3 } from '../../../kernel/utils/vector3';
+export declare class NodeClientPedPort extends IClientPedPort {
+    spawn(_options: ClientPedSpawnOptions): Promise<number>;
+    delete(_handle: number): void;
+    exists(_handle: number): boolean;
+    playAnimation(_handle: number, _options: ClientPedAnimationOptions): Promise<void>;
+    stopAnimation(_handle: number): void;
+    stopAnimationImmediately(_handle: number): void;
+    freeze(_handle: number, _freeze: boolean): void;
+    setInvincible(_handle: number, _invincible: boolean): void;
+    giveWeapon(_handle: number, _weapon: string, _ammo?: number, _hidden?: boolean, _forceInHand?: boolean): void;
+    removeAllWeapons(_handle: number): void;
+    getClosest(_radius?: number, _excludeLocalPlayer?: boolean): number | null;
+    getNearby(_position: Vector3, _radius: number, _excludeEntity?: number): number[];
+    lookAtEntity(_handle: number, _entity: number, _duration?: number): void;
+    lookAtCoords(_handle: number, _position: Vector3, _duration?: number): void;
+    walkTo(_handle: number, _position: Vector3, _speed?: number): void;
+    setCombatAttributes(_handle: number, _canFight: boolean, _canUseCover?: boolean): void;
+}

package/dist/runtime/client/adapter/node-ped-port.js

@@ -0,0 +1,38 @@
+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;
+};
+import { injectable } from 'tsyringe';
+import { IClientPedPort, } from '../../../adapters/contracts/client/ped/IClientPedPort';
+let NodeClientPedPort = class NodeClientPedPort extends IClientPedPort {
+    async spawn(_options) {
+        return 0;
+    }
+    delete(_handle) { }
+    exists(_handle) {
+        return false;
+    }
+    async playAnimation(_handle, _options) { }
+    stopAnimation(_handle) { }
+    stopAnimationImmediately(_handle) { }
+    freeze(_handle, _freeze) { }
+    setInvincible(_handle, _invincible) { }
+    giveWeapon(_handle, _weapon, _ammo = 100, _hidden = false, _forceInHand = true) { }
+    removeAllWeapons(_handle) { }
+    getClosest(_radius = 10, _excludeLocalPlayer = true) {
+        return null;
+    }
+    getNearby(_position, _radius, _excludeEntity) {
+        return [];
+    }
+    lookAtEntity(_handle, _entity, _duration = -1) { }
+    lookAtCoords(_handle, _position, _duration = -1) { }
+    walkTo(_handle, _position, _speed = 1) { }
+    setCombatAttributes(_handle, _canFight, _canUseCover = true) { }
+};
+NodeClientPedPort = __decorate([
+    injectable()
+], NodeClientPedPort);
+export { NodeClientPedPort };

package/dist/runtime/client/adapter/node-progress-port.d.ts

@@ -0,0 +1,8 @@
+import { type ClientProgressOptions, type ClientProgressState, IClientProgressPort } from '../../../adapters/contracts/client/progress/IClientProgressPort';
+export declare class NodeClientProgressPort extends IClientProgressPort {
+    start(_options: ClientProgressOptions): Promise<boolean>;
+    cancel(): void;
+    isActive(): boolean;
+    getProgress(): number;
+    getState(): ClientProgressState | null;
+}

package/dist/runtime/client/adapter/node-progress-port.js

@@ -0,0 +1,27 @@
+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;
+};
+import { injectable } from 'tsyringe';
+import { IClientProgressPort, } from '../../../adapters/contracts/client/progress/IClientProgressPort';
+let NodeClientProgressPort = class NodeClientProgressPort extends IClientProgressPort {
+    start(_options) {
+        return Promise.resolve(true);
+    }
+    cancel() { }
+    isActive() {
+        return false;
+    }
+    getProgress() {
+        return 0;
+    }
+    getState() {
+        return null;
+    }
+};
+NodeClientProgressPort = __decorate([
+    injectable()
+], NodeClientProgressPort);
+export { NodeClientProgressPort };

package/dist/runtime/client/adapter/node-runtime-bridge.d.ts

@@ -1,7 +1,5 @@
 import { IClientRuntimeBridge } from './runtime-bridge';
-type RuntimeHandler = (...args: readonly unknown[]) => void | Promise<void>;
 type WebViewCallback = (data: unknown, cb: (response: unknown) => void) => void | Promise<void>;
-type RuntimeExport = (...args: readonly unknown[]) => unknown;
 /**
  * Node fallback runtime bridge used in tests and standalone execution.
  */
@@ -9,7 +7,7 @@ export declare class NodeClientRuntimeBridge extends IClientRuntimeBridge {
     private readonly events;
     private readonly tickHandles;
     getCurrentResourceName(): string;
-    on(eventName: string, handler: RuntimeHandler): void;
+    on<TArgs extends readonly unknown[]>(eventName: string, handler: (...args: TArgs) => void | Promise<void>): void;
     registerCommand(_commandName: string, _handler: (...args: readonly unknown[]) => void, _restricted: boolean): void;
     registerKeyMapping(_commandName: string, _description: string, _inputMapper: string, _key: string): void;
     setTick(handler: () => void | Promise<void>): unknown;
@@ -19,6 +17,6 @@ export declare class NodeClientRuntimeBridge extends IClientRuntimeBridge {
     sendNuiMessage(_message: string): void;
     setNuiFocus(_hasFocus: boolean, _hasCursor: boolean): void;
     setNuiFocusKeepInput(_keepInput: boolean): void;
-    registerExport(exportName: string, handler: RuntimeExport): void;
+    registerExport<TArgs extends readonly unknown[], TResult = unknown>(exportName: string, handler: (...args: TArgs) => TResult): void;
 }
 export {};

package/dist/runtime/client/adapter/node-spawn-bridge.d.ts

@@ -1,8 +1,8 @@
-import { IClientSpawnBridge } from '../../../adapters/contracts/client/spawn/IClientSpawnBridge';
-import type { RespawnRequest, SpawnRequest, TeleportRequest } from '../../../adapters/contracts/client/spawn/types';
-export declare class NodeClientSpawnBridge extends IClientSpawnBridge {
+import { IClientSpawnPort } from '../../../adapters/contracts/client/spawn/IClientSpawnPort';
+import type { RespawnRequest, SpawnExecutionResult, SpawnRequest, TeleportRequest } from '../../../adapters/contracts/client/spawn/types';
+export declare class NodeClientSpawnBridge extends IClientSpawnPort {
     waitUntilReady(_timeoutMs?: number): Promise<void>;
-    spawn(_request: SpawnRequest): Promise<void>;
-    respawn(_request: RespawnRequest): Promise<void>;
+    spawn(_request: SpawnRequest): Promise<SpawnExecutionResult>;
+    respawn(_request: RespawnRequest): Promise<SpawnExecutionResult>;
     teleport(_request: TeleportRequest): Promise<void>;
 }