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

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

@@ -0,0 +1,43 @@
+import { IClientLogConsole, } from '../../adapters/contracts/client/IClientLogConsole';
+const DEFAULT_CLIENT_LOG_CONSOLE_CAPABILITIES = {
+    supportsColors: false,
+    supportsStructuredData: true,
+    supportsRichFormatting: false,
+};
+class DefaultClientLogConsole extends IClientLogConsole {
+    getCapabilities() {
+        return DEFAULT_CLIENT_LOG_CONSOLE_CAPABILITIES;
+    }
+    trace(message, details) {
+        this.write('debug', message, details);
+    }
+    debug(message, details) {
+        this.write('debug', message, details);
+    }
+    info(message, details) {
+        this.write('info', message, details);
+    }
+    warn(message, details) {
+        this.write('warn', message, details);
+    }
+    error(message, details) {
+        this.write('error', message, details);
+    }
+    write(level, message, details) {
+        if (details === undefined) {
+            console[level](message);
+            return;
+        }
+        console[level](message, details);
+    }
+}
+let activeClientLogConsole = new DefaultClientLogConsole();
+export function getClientLogConsole() {
+    return activeClientLogConsole;
+}
+export function setClientLogConsole(logConsole) {
+    activeClientLogConsole = logConsole;
+}
+export function resetClientLogConsoleForTests() {
+    activeClientLogConsole = new DefaultClientLogConsole();
+}

package/dist/kernel/logger/core-logger.d.ts

@@ -22,7 +22,9 @@ export declare const loggers: {
     exports: import("./logger.service").ChildLogger;
     /** Tick handlers (server) */
     tick: import("./logger.service").ChildLogger;
-    /** NUI callbacks (client) */
+    /** Embedded WebView callbacks (client) */
+    webView: import("./logger.service").ChildLogger;
+    /** @deprecated Use webView instead. */
     nui: import("./logger.service").ChildLogger;
     /** Spawn service (client) */
     spawn: import("./logger.service").ChildLogger;

package/dist/kernel/logger/core-logger.js

@@ -57,8 +57,10 @@ export const loggers = {
     exports: coreLogger.framework('Exports'),
     /** Tick handlers (server) */
     tick: coreLogger.framework('Tick'),
-    /** NUI callbacks (client) */
-    nui: coreLogger.client('NUI'),
+    /** Embedded WebView callbacks (client) */
+    webView: coreLogger.client('WebView'),
+    /** @deprecated Use webView instead. */
+    nui: coreLogger.client('WebView'),
     /** Spawn service (client) */
     spawn: coreLogger.client('Spawn'),
     /** */

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

@@ -1,10 +1,12 @@
 export { coreLogger, loggers } from './core-logger';
+export { getClientLogConsole, resetClientLogConsoleForTests, setClientLogConsole, } from './client-log-console';
 export type { LoggerConfig } from './logger.config';
 export { createLoggerConfig, DEFAULT_LOGGER_CONFIG } from './logger.config';
 export { getLogLevel, isClientEnvironment, isDebugMode, isFiveMEnvironment, isServerEnvironment, } from './logger.env';
 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

@@ -1,12 +1,13 @@
 // Core Logger (internal framework use)
 export { coreLogger, loggers } from './core-logger';
+export { getClientLogConsole, resetClientLogConsoleForTests, setClientLogConsole, } from './client-log-console';
 // Config
 export { createLoggerConfig, DEFAULT_LOGGER_CONFIG } from './logger.config';
 // Environment utilities
 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/dev-transport.factory.js

@@ -8,7 +8,7 @@ import { WebSocketLogTransport } from './websocket.transport';
  */
 export function detectEnvironment() {
     // Check for CitizenFX globals
-    if (typeof GetCurrentResourceName === 'function') {
+    if (typeof globalThis.GetCurrentResourceName === 'function') {
         return 'cfx';
     }
     return 'node';

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

@@ -1,4 +1,5 @@
-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.
  * Designed for FiveM client console which doesn't support ANSI formatting.
@@ -25,8 +26,10 @@ export class SimpleConsoleTransport {
     }
     write(entry) {
         const { level, domain, message, timestamp, context, error } = entry;
+        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) {
@@ -44,36 +47,38 @@ export class SimpleConsoleTransport {
         parts.push(message);
         // Output the main log line
         const logLine = parts.join(' ');
-        // Choose the appropriate console method
+        // Choose the appropriate client log sink
         switch (level) {
             case LogLevel.TRACE:
+                output.trace(logLine);
+                break;
             case LogLevel.DEBUG:
-                console.debug(logLine);
+                output.debug(logLine);
                 break;
             case LogLevel.INFO:
-                console.info(logLine);
+                output.info(logLine);
                 break;
             case LogLevel.WARN:
-                console.warn(logLine);
+                output.warn(logLine);
                 break;
             case LogLevel.ERROR:
             case LogLevel.FATAL:
-                console.error(logLine);
+                output.error(logLine);
                 break;
             default:
-                console.log(logLine);
+                output.info(logLine);
         }
         // Output context only if enabled and present
         if (this.showContext && context) {
             // eslint-disable-next-line @typescript-eslint/no-unused-vars
             const { source, domain: _, ...rest } = context;
             if (Object.keys(rest).length > 0) {
-                console.debug('  context:', JSON.stringify(rest));
+                output.debug('  context:', capabilities.supportsStructuredData ? rest : JSON.stringify(rest));
             }
         }
         // Output error stack if present
         if (error?.stack) {
-            console.error('  stack:', error.stack);
+            output.error('  stack:', error.stack);
         }
     }
 }

package/dist/kernel-public.d.ts

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

package/dist/kernel-public.js

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

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

@@ -0,0 +1,25 @@
+import type { DependencyContainer, InjectionToken } from 'tsyringe';
+import { MessagingTransport } from '../../../adapters/contracts/transport/messaging.transport';
+import { IClientRuntimeBridge } from './runtime-bridge';
+/**
+ * Public contract implemented by external client adapters.
+ */
+export interface OpenCoreClientAdapter {
+    readonly name: string;
+    register(context: ClientAdapterContext): void | Promise<void>;
+}
+/**
+ * Registration helpers exposed to client adapters.
+ */
+export interface ClientAdapterContext {
+    readonly adapterName: string;
+    readonly container: DependencyContainer;
+    isRegistered<T>(token: InjectionToken<T>): boolean;
+    bindSingleton<T>(token: InjectionToken<T>, implementation: InjectionToken<T>): void;
+    bindInstance<T>(token: InjectionToken<T>, value: T): void;
+    bindFactory<T>(token: InjectionToken<T>, factory: () => T): void;
+    bindMessagingTransport(transport: MessagingTransport): void;
+    useRuntimeBridge(runtime: IClientRuntimeBridge): void;
+}
+export declare function defineClientAdapter(adapter: OpenCoreClientAdapter): OpenCoreClientAdapter;
+export declare function bindClientTransportInstances(context: Pick<ClientAdapterContext, 'bindInstance'>, transport: MessagingTransport): void;

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

@@ -0,0 +1,11 @@
+import { EventsAPI } from '../../../adapters/contracts/transport/events.api';
+import { MessagingTransport } from '../../../adapters/contracts/transport/messaging.transport';
+import { RpcAPI } from '../../../adapters/contracts/transport/rpc.api';
+export function defineClientAdapter(adapter) {
+    return adapter;
+}
+export function bindClientTransportInstances(context, transport) {
+    context.bindInstance(MessagingTransport, transport);
+    context.bindInstance(EventsAPI, transport.events);
+    context.bindInstance(RpcAPI, transport.rpc);
+}

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

@@ -0,0 +1,20 @@
+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';
+export * from '../../../adapters/contracts/client/ui/webview/IClientWebViewBridge';
+export * from './local-player-bridge';
+export * from './node-blip-bridge';
+export * from './node-marker-bridge';
+export * from './node-notification-bridge';
+export * from './node-spawn-bridge';
+export * from './node-webview-bridge';
+export * from './platform-bridge';
+export * from './runtime-bridge';

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

@@ -0,0 +1,20 @@
+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';
+export * from '../../../adapters/contracts/client/ui/webview/IClientWebViewBridge';
+export * from './local-player-bridge';
+export * from './node-blip-bridge';
+export * from './node-marker-bridge';
+export * from './node-notification-bridge';
+export * from './node-spawn-bridge';
+export * from './node-webview-bridge';
+export * from './platform-bridge';
+export * from './runtime-bridge';

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

@@ -0,0 +1 @@
+export { IClientLocalPlayerBridge } from '../../../adapters/contracts/client/IClientLocalPlayerBridge';

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

@@ -0,0 +1 @@
+export { IClientLocalPlayerBridge } from '../../../adapters/contracts/client/IClientLocalPlayerBridge';

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

@@ -0,0 +1,9 @@
+import { IClientBlipBridge, type ClientBlipDefinition } from '../../../adapters/contracts/client/ui/IClientBlipBridge';
+export declare class NodeClientBlipBridge extends IClientBlipBridge {
+    private readonly blips;
+    create(id: string, definition: ClientBlipDefinition): void;
+    update(id: string, patch: Partial<ClientBlipDefinition>): boolean;
+    exists(id: string): boolean;
+    remove(id: string): boolean;
+    clear(): void;
+}

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

@@ -0,0 +1,34 @@
+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 { IClientBlipBridge, } from '../../../adapters/contracts/client/ui/IClientBlipBridge';
+let NodeClientBlipBridge = class NodeClientBlipBridge extends IClientBlipBridge {
+    blips = new Map();
+    create(id, definition) {
+        this.blips.set(id, { ...definition });
+    }
+    update(id, patch) {
+        const existing = this.blips.get(id);
+        if (!existing)
+            return false;
+        this.blips.set(id, { ...existing, ...patch });
+        return true;
+    }
+    exists(id) {
+        return this.blips.has(id);
+    }
+    remove(id) {
+        return this.blips.delete(id);
+    }
+    clear() {
+        this.blips.clear();
+    }
+};
+NodeClientBlipBridge = __decorate([
+    injectable()
+], NodeClientBlipBridge);
+export { NodeClientBlipBridge };

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.d.ts

@@ -0,0 +1,5 @@
+import { type OpenCoreClientAdapter } from './client-adapter';
+/**
+ * Default client adapter used when no runtime adapter is provided.
+ */
+export declare function createNodeClientAdapter(): OpenCoreClientAdapter;

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

@@ -0,0 +1,64 @@
+import { IGtaPedAppearanceBridge } from '../../../adapters/contracts/client/IGtaPedAppearanceBridge';
+import { IHasher } from '../../../adapters/contracts/IHasher';
+import { IClientLocalPlayerBridge } from './local-player-bridge';
+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.
+ */
+export function createNodeClientAdapter() {
+    return defineClientAdapter({
+        name: 'node',
+        async register(ctx) {
+            const [{ NodeMessagingTransport }, { NodePedAppearanceClient }, { NodeHasher }] = await Promise.all([
+                import('../../../adapters/node/transport/adapter'),
+                import('../../../adapters/node/node-ped-appearance-client'),
+                import('../../../adapters/node/node-hasher'),
+            ]);
+            const transport = new NodeMessagingTransport('client');
+            ctx.bindMessagingTransport(transport);
+            ctx.bindSingleton(IGtaPedAppearanceBridge, NodePedAppearanceClient);
+            ctx.bindSingleton(IHasher, NodeHasher);
+            ctx.bindSingleton(IClientRuntimeBridge, NodeClientRuntimeBridge);
+            ctx.bindSingleton(IClientLocalPlayerBridge, NodeClientLocalPlayerBridge);
+            ctx.bindSingleton(IClientPlatformBridge, NodeClientPlatformBridge);
+            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);
+            ctx.bindSingleton(IClientWebViewBridge, NodeClientWebViewBridge);
+            ctx.bindSingleton(IClientLogConsole, NodeClientLogConsole);
+            installNodeClientLogConsole(new NodeClientLogConsole());
+        },
+    });
+}

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

@@ -0,0 +1,11 @@
+import { Vector3 } from '../../../kernel/utils/vector3';
+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

@@ -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 { 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([
+    injectable()
+], NodeClientLocalPlayerBridge);
+export { NodeClientLocalPlayerBridge };

package/dist/runtime/client/adapter/node-log-console.d.ts

@@ -0,0 +1,11 @@
+import { IClientLogConsole, type ClientLogConsoleCapabilities } from '../../../adapters/contracts/client/IClientLogConsole';
+export declare class NodeClientLogConsole extends IClientLogConsole {
+    getCapabilities(): ClientLogConsoleCapabilities;
+    trace(message: string, details?: unknown): void;
+    debug(message: string, details?: unknown): void;
+    info(message: string, details?: unknown): void;
+    warn(message: string, details?: unknown): void;
+    error(message: string, details?: unknown): void;
+    private write;
+}
+export declare function installNodeClientLogConsole(logConsole: IClientLogConsole): void;