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

package/dist/adapters/fivem/fivem-vehicle-server.js

@@ -0,0 +1,47 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FiveMVehicleServer = void 0;
+const tsyringe_1 = require("tsyringe");
+const IVehicleServer_1 = require("../contracts/IVehicleServer");
+/**
+ * FiveM implementation of server-side vehicle operations.
+ */
+let FiveMVehicleServer = class FiveMVehicleServer extends IVehicleServer_1.IVehicleServer {
+    createServerSetter(modelHash, vehicleType, x, y, z, heading) {
+        return CreateVehicleServerSetter(modelHash, vehicleType, x, y, z, heading);
+    }
+    getColours(handle) {
+        return GetVehicleColours(handle);
+    }
+    setColours(handle, primary, secondary) {
+        SetVehicleColours(handle, primary, secondary);
+    }
+    getNumberPlateText(handle) {
+        return GetVehicleNumberPlateText(handle);
+    }
+    setNumberPlateText(handle, text) {
+        SetVehicleNumberPlateText(handle, text);
+    }
+    setDoorsLocked(handle, state) {
+        SetVehicleDoorsLocked(handle, state);
+    }
+    getNetworkIdFromEntity(handle) {
+        return NetworkGetNetworkIdFromEntity(handle);
+    }
+    getEntityFromNetworkId(networkId) {
+        return NetworkGetEntityFromNetworkId(networkId);
+    }
+    networkIdExists(networkId) {
+        return NetworkDoesEntityExistWithNetworkId(networkId);
+    }
+};
+exports.FiveMVehicleServer = FiveMVehicleServer;
+exports.FiveMVehicleServer = FiveMVehicleServer = __decorate([
+    (0, tsyringe_1.injectable)()
+], FiveMVehicleServer);

package/dist/adapters/index.d.ts

@@ -0,0 +1,15 @@
+export * from './contracts/IEngineEvents';
+export * from './contracts/IEntityServer';
+export * from './contracts/IExports';
+export * from './contracts/IHasher';
+export * from './contracts/INetTransport';
+export * from './contracts/IPedAppearanceClient';
+export * from './contracts/IPedAppearanceServer';
+export * from './contracts/IPlayerInfo';
+export * from './contracts/IPlayerServer';
+export * from './contracts/IResourceInfo';
+export * from './contracts/ITick';
+export * from './contracts/IVehicleServer';
+export { OxMySQLAdapter } from './database/oxmysql.adapter';
+export { ResourceDatabaseAdapter } from './database/resource.adapter';
+export * from './register-capabilities';

package/dist/adapters/index.js

@@ -0,0 +1,40 @@
+"use strict";
+// Adapters - External world connections
+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 });
+exports.ResourceDatabaseAdapter = exports.OxMySQLAdapter = void 0;
+__exportStar(require("./contracts/IEngineEvents"), exports);
+__exportStar(require("./contracts/IEntityServer"), exports);
+__exportStar(require("./contracts/IExports"), exports);
+__exportStar(require("./contracts/IHasher"), exports);
+// Contracts (interfaces)
+__exportStar(require("./contracts/INetTransport"), exports);
+__exportStar(require("./contracts/IPedAppearanceClient"), exports);
+__exportStar(require("./contracts/IPedAppearanceServer"), exports);
+__exportStar(require("./contracts/IPlayerInfo"), exports);
+__exportStar(require("./contracts/IPlayerServer"), exports);
+__exportStar(require("./contracts/IResourceInfo"), exports);
+__exportStar(require("./contracts/ITick"), exports);
+__exportStar(require("./contracts/IVehicleServer"), exports);
+// Database adapters
+var oxmysql_adapter_1 = require("./database/oxmysql.adapter");
+Object.defineProperty(exports, "OxMySQLAdapter", { enumerable: true, get: function () { return oxmysql_adapter_1.OxMySQLAdapter; } });
+var resource_adapter_1 = require("./database/resource.adapter");
+Object.defineProperty(exports, "ResourceDatabaseAdapter", { enumerable: true, get: function () { return resource_adapter_1.ResourceDatabaseAdapter; } });
+// Capability registration
+__exportStar(require("./register-capabilities"), exports);
+// FiveM adapters (not exported by default - registered via registerServerCapabilities)
+// Node adapters (not exported by default - registered via registerServerCapabilities)

package/dist/adapters/node/index.d.ts

@@ -0,0 +1,8 @@
+export { NodeEngineEvents } from './node-engine-events';
+export { NodeEntityServer } from './node-entity-server';
+export { NodeExports } from './node-exports';
+export { NodeHasher } from './node-hasher';
+export { NodeNetTransport } from './node-net-transport';
+export { NodePlayerServer } from './node-player-server';
+export { NodeResourceInfo } from './node-resourceinfo';
+export { NodeVehicleServer } from './node-vehicle-server';

package/dist/adapters/node/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeVehicleServer = exports.NodeResourceInfo = exports.NodePlayerServer = exports.NodeNetTransport = exports.NodeHasher = exports.NodeExports = exports.NodeEntityServer = exports.NodeEngineEvents = void 0;
+var node_engine_events_1 = require("./node-engine-events");
+Object.defineProperty(exports, "NodeEngineEvents", { enumerable: true, get: function () { return node_engine_events_1.NodeEngineEvents; } });
+var node_entity_server_1 = require("./node-entity-server");
+Object.defineProperty(exports, "NodeEntityServer", { enumerable: true, get: function () { return node_entity_server_1.NodeEntityServer; } });
+var node_exports_1 = require("./node-exports");
+Object.defineProperty(exports, "NodeExports", { enumerable: true, get: function () { return node_exports_1.NodeExports; } });
+var node_hasher_1 = require("./node-hasher");
+Object.defineProperty(exports, "NodeHasher", { enumerable: true, get: function () { return node_hasher_1.NodeHasher; } });
+var node_net_transport_1 = require("./node-net-transport");
+Object.defineProperty(exports, "NodeNetTransport", { enumerable: true, get: function () { return node_net_transport_1.NodeNetTransport; } });
+var node_player_server_1 = require("./node-player-server");
+Object.defineProperty(exports, "NodePlayerServer", { enumerable: true, get: function () { return node_player_server_1.NodePlayerServer; } });
+var node_resourceinfo_1 = require("./node-resourceinfo");
+Object.defineProperty(exports, "NodeResourceInfo", { enumerable: true, get: function () { return node_resourceinfo_1.NodeResourceInfo; } });
+var node_vehicle_server_1 = require("./node-vehicle-server");
+Object.defineProperty(exports, "NodeVehicleServer", { enumerable: true, get: function () { return node_vehicle_server_1.NodeVehicleServer; } });

package/dist/adapters/node/node-engine-events.d.ts

@@ -0,0 +1,20 @@
+import { IEngineEvents } from '../contracts/IEngineEvents';
+/**
+ * Node.js implementation of IEngineEvents using EventEmitter.
+ * Suitable for testing and non-FiveM runtime environments.
+ *
+ * Note: In Node.js, there are no native engine events like FiveM's lifecycle events.
+ * This implementation provides a mock event system for testing purposes.
+ */
+export declare class NodeEngineEvents implements IEngineEvents {
+    private eventEmitter;
+    on(eventName: string, handler: (...args: any[]) => void): void;
+    /**
+     * Utility method for testing: emit an engine event
+     */
+    emit(eventName: string, ...args: any[]): void;
+    /**
+     * Utility method for testing: clear all event listeners
+     */
+    clearListeners(): void;
+}

package/dist/adapters/node/node-engine-events.js

@@ -0,0 +1,42 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeEngineEvents = void 0;
+const node_events_1 = require("node:events");
+const tsyringe_1 = require("tsyringe");
+/**
+ * Node.js implementation of IEngineEvents using EventEmitter.
+ * Suitable for testing and non-FiveM runtime environments.
+ *
+ * Note: In Node.js, there are no native engine events like FiveM's lifecycle events.
+ * This implementation provides a mock event system for testing purposes.
+ */
+let NodeEngineEvents = class NodeEngineEvents {
+    constructor() {
+        this.eventEmitter = new node_events_1.EventEmitter();
+    }
+    on(eventName, handler) {
+        this.eventEmitter.on(eventName, handler);
+    }
+    /**
+     * Utility method for testing: emit an engine event
+     */
+    emit(eventName, ...args) {
+        this.eventEmitter.emit(eventName, ...args);
+    }
+    /**
+     * Utility method for testing: clear all event listeners
+     */
+    clearListeners() {
+        this.eventEmitter.removeAllListeners();
+    }
+};
+exports.NodeEngineEvents = NodeEngineEvents;
+exports.NodeEngineEvents = NodeEngineEvents = __decorate([
+    (0, tsyringe_1.injectable)()
+], NodeEngineEvents);

package/dist/adapters/node/node-entity-server.d.ts

@@ -0,0 +1,26 @@
+import { Vector3 } from '../../kernel/utils';
+import { type EntityStateBag, IEntityServer } from '../contracts/IEntityServer';
+/**
+ * Node.js mock implementation of server-side entity operations.
+ * Used for testing and standalone mode.
+ */
+export declare class NodeEntityServer extends IEntityServer {
+    private entities;
+    private stateBags;
+    doesExist(handle: number): boolean;
+    getCoords(handle: number): Vector3;
+    setCoords(handle: number, x: number, y: number, z: number): void;
+    getHeading(handle: number): number;
+    setHeading(handle: number, heading: number): void;
+    getModel(handle: number): number;
+    delete(handle: number): void;
+    setOrphanMode(_handle: number, _mode: number): void;
+    setRoutingBucket(handle: number, bucket: number): void;
+    getRoutingBucket(handle: number): number;
+    getStateBag(handle: number): EntityStateBag;
+    getHealth(_handle: number): number;
+    setHealth(_handle: number, _health: number): void;
+    getArmor(_handle: number): number;
+    setArmor(_handle: number, _armor: number): void;
+    _createMockEntity(handle: number, model: number, coords: Vector3, heading?: number): void;
+}

package/dist/adapters/node/node-entity-server.js

@@ -0,0 +1,101 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeEntityServer = void 0;
+const tsyringe_1 = require("tsyringe");
+const IEntityServer_1 = require("../contracts/IEntityServer");
+/**
+ * Node.js mock implementation of server-side entity operations.
+ * Used for testing and standalone mode.
+ */
+let NodeEntityServer = class NodeEntityServer extends IEntityServer_1.IEntityServer {
+    constructor() {
+        super(...arguments);
+        this.entities = new Map();
+        this.stateBags = new Map();
+    }
+    doesExist(handle) {
+        return this.entities.has(handle);
+    }
+    getCoords(handle) {
+        var _a, _b;
+        return (_b = (_a = this.entities.get(handle)) === null || _a === void 0 ? void 0 : _a.coords) !== null && _b !== void 0 ? _b : { x: 0, y: 0, z: 0 };
+    }
+    setCoords(handle, x, y, z) {
+        const entity = this.entities.get(handle);
+        if (entity) {
+            entity.coords = { x, y, z };
+        }
+    }
+    getHeading(handle) {
+        var _a, _b;
+        return (_b = (_a = this.entities.get(handle)) === null || _a === void 0 ? void 0 : _a.heading) !== null && _b !== void 0 ? _b : 0;
+    }
+    setHeading(handle, heading) {
+        const entity = this.entities.get(handle);
+        if (entity) {
+            entity.heading = heading;
+        }
+    }
+    getModel(handle) {
+        var _a, _b;
+        return (_b = (_a = this.entities.get(handle)) === null || _a === void 0 ? void 0 : _a.model) !== null && _b !== void 0 ? _b : 0;
+    }
+    delete(handle) {
+        this.entities.delete(handle);
+        this.stateBags.delete(handle);
+    }
+    setOrphanMode(_handle, _mode) {
+        // No-op in Node
+    }
+    setRoutingBucket(handle, bucket) {
+        const entity = this.entities.get(handle);
+        if (entity) {
+            entity.bucket = bucket;
+        }
+    }
+    getRoutingBucket(handle) {
+        var _a, _b;
+        return (_b = (_a = this.entities.get(handle)) === null || _a === void 0 ? void 0 : _a.bucket) !== null && _b !== void 0 ? _b : 0;
+    }
+    getStateBag(handle) {
+        if (!this.stateBags.has(handle)) {
+            this.stateBags.set(handle, new Map());
+        }
+        const bag = this.stateBags.get(handle);
+        return {
+            set: (key, value) => {
+                bag.set(key, value);
+            },
+            get: (key) => {
+                return bag.get(key);
+            },
+        };
+    }
+    // TODO
+    getHealth(_handle) {
+        throw new Error('Method not implemented.');
+    }
+    setHealth(_handle, _health) {
+        throw new Error('Method not implemented.');
+    }
+    getArmor(_handle) {
+        throw new Error('Method not implemented.');
+    }
+    setArmor(_handle, _armor) {
+        throw new Error('Method not implemented.');
+    }
+    // Test helper: Create a mock entity
+    _createMockEntity(handle, model, coords, heading = 0) {
+        this.entities.set(handle, { coords, heading, model, bucket: 0 });
+    }
+};
+exports.NodeEntityServer = NodeEntityServer;
+exports.NodeEntityServer = NodeEntityServer = __decorate([
+    (0, tsyringe_1.injectable)()
+], NodeEntityServer);

package/dist/adapters/node/node-exports.d.ts

@@ -0,0 +1,26 @@
+import { IExports } from '../contracts/IExports';
+/**
+ * Node.js implementation of IExports using in-memory registry.
+ * Suitable for testing and non-FiveM runtime environments.
+ */
+export declare class NodeExports implements IExports {
+    private exports;
+    register(exportName: string, handler: Function): void;
+    getResource(resourceName: string): any;
+    /**
+     * Get all registered exports as an object
+     */
+    private getExportsObject;
+    /**
+     * Get the current resource name (stub for Node environment)
+     */
+    private getCurrentResourceName;
+    /**
+     * Utility method for testing: get a specific export
+     */
+    getExport(exportName: string): Function | undefined;
+    /**
+     * Utility method for testing: clear all exports
+     */
+    clearExports(): void;
+}

package/dist/adapters/node/node-exports.js

@@ -0,0 +1,63 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeExports = void 0;
+const tsyringe_1 = require("tsyringe");
+/**
+ * Node.js implementation of IExports using in-memory registry.
+ * Suitable for testing and non-FiveM runtime environments.
+ */
+let NodeExports = class NodeExports {
+    constructor() {
+        this.exports = new Map();
+    }
+    register(exportName, handler) {
+        this.exports.set(exportName, handler);
+    }
+    getResource(resourceName) {
+        // In Node.js environment, cross-resource access is not supported
+        // This is a stub that returns an object with the current resource's exports
+        if (resourceName === this.getCurrentResourceName()) {
+            return this.getExportsObject();
+        }
+        throw new Error(`Cross-resource exports not supported in Node.js runtime. ` +
+            `Attempted to access resource: ${resourceName}`);
+    }
+    /**
+     * Get all registered exports as an object
+     */
+    getExportsObject() {
+        const obj = {};
+        this.exports.forEach((handler, name) => {
+            obj[name] = handler;
+        });
+        return obj;
+    }
+    /**
+     * Get the current resource name (stub for Node environment)
+     */
+    getCurrentResourceName() {
+        return process.env.RESOURCE_NAME || 'default';
+    }
+    /**
+     * Utility method for testing: get a specific export
+     */
+    getExport(exportName) {
+        return this.exports.get(exportName);
+    }
+    /**
+     * Utility method for testing: clear all exports
+     */
+    clearExports() {
+        this.exports.clear();
+    }
+};
+exports.NodeExports = NodeExports;
+exports.NodeExports = NodeExports = __decorate([
+    (0, tsyringe_1.injectable)()
+], NodeExports);

package/dist/adapters/node/node-hasher.d.ts

@@ -0,0 +1,12 @@
+import { IHasher } from '../contracts/IHasher';
+/**
+ * Node.js implementation of hash utilities.
+ * Implements joaat hash algorithm.
+ */
+export declare class NodeHasher extends IHasher {
+    /**
+     * Gets the hash key for a string using joaat algorithm.
+     * This is the same algorithm FiveM uses for GetHashKey.
+     */
+    getHashKey(str: string): number;
+}

package/dist/adapters/node/node-hasher.js

@@ -0,0 +1,39 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeHasher = void 0;
+const tsyringe_1 = require("tsyringe");
+const IHasher_1 = require("../contracts/IHasher");
+/**
+ * Node.js implementation of hash utilities.
+ * Implements joaat hash algorithm.
+ */
+let NodeHasher = class NodeHasher extends IHasher_1.IHasher {
+    /**
+     * Gets the hash key for a string using joaat algorithm.
+     * This is the same algorithm FiveM uses for GetHashKey.
+     */
+    getHashKey(str) {
+        const key = str.toLowerCase();
+        let hash = 0;
+        for (let i = 0; i < key.length; i++) {
+            hash += key.charCodeAt(i);
+            hash += hash << 10;
+            hash ^= hash >>> 6;
+        }
+        hash += hash << 3;
+        hash ^= hash >>> 11;
+        hash += hash << 15;
+        // Convert to unsigned 32-bit integer
+        return hash >>> 0;
+    }
+};
+exports.NodeHasher = NodeHasher;
+exports.NodeHasher = NodeHasher = __decorate([
+    (0, tsyringe_1.injectable)()
+], NodeHasher);

package/dist/adapters/node/node-net-transport.d.ts

@@ -0,0 +1,18 @@
+import { INetTransport, NetEventContext, NetTarget } from '../contracts/INetTransport';
+/**
+ * Node.js implementation of INetTransport using EventEmitter.
+ * Suitable for testing and non-FiveM runtime environments.
+ */
+export declare class NodeNetTransport implements INetTransport {
+    private eventEmitter;
+    onNet(eventName: string, handler: (context: NetEventContext, ...args: any[]) => void | Promise<void>): void;
+    emitNet(eventName: string, target: NetTarget, ...args: any[]): void;
+    /**
+     * Utility method for testing: trigger a net event as if it came from a client
+     */
+    simulateClientEvent(eventName: string, clientId: number, ...args: any[]): void;
+    /**
+     * Utility method for testing: clear all registered handlers
+     */
+    clearHandlers(): void;
+}

package/dist/adapters/node/node-net-transport.js

@@ -0,0 +1,57 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeNetTransport = void 0;
+const node_events_1 = require("node:events");
+const tsyringe_1 = require("tsyringe");
+const shared_1 = require("../../kernel/shared");
+/**
+ * Node.js implementation of INetTransport using EventEmitter.
+ * Suitable for testing and non-FiveM runtime environments.
+ */
+let NodeNetTransport = class NodeNetTransport {
+    constructor() {
+        this.eventEmitter = new node_events_1.EventEmitter();
+    }
+    onNet(eventName, handler) {
+        this.eventEmitter.on(eventName, (ctx, ...args) => {
+            void Promise.resolve(handler(ctx, ...args)).catch((err) => {
+                shared_1.loggers.netEvent.error(`handler error for '${eventName}'`, {}, err);
+            });
+        });
+    }
+    emitNet(eventName, target, ...args) {
+        if (Array.isArray(target)) {
+            for (let index = 0; index < target.length; index++) {
+                const clientId = target[index];
+                const ctx = { clientId };
+                this.eventEmitter.emit(eventName, ctx, ...args);
+            }
+            return;
+        }
+        const ctx = { clientId: target === 'all' ? -1 : target };
+        this.eventEmitter.emit(eventName, ctx, ...args);
+    }
+    /**
+     * Utility method for testing: trigger a net event as if it came from a client
+     */
+    simulateClientEvent(eventName, clientId, ...args) {
+        const ctx = { clientId };
+        this.eventEmitter.emit(eventName, ctx, ...args);
+    }
+    /**
+     * Utility method for testing: clear all registered handlers
+     */
+    clearHandlers() {
+        this.eventEmitter.removeAllListeners();
+    }
+};
+exports.NodeNetTransport = NodeNetTransport;
+exports.NodeNetTransport = NodeNetTransport = __decorate([
+    (0, tsyringe_1.injectable)()
+], NodeNetTransport);

package/dist/adapters/node/node-ped-appearance-client.d.ts

@@ -0,0 +1,34 @@
+import { HeadBlendData } from '../../kernel/shared';
+import { IPedAppearanceClient } from '../contracts/IPedAppearanceClient';
+/**
+ * Node.js stub implementation of client-side ped appearance adapter.
+ *
+ * @remarks
+ * This is a no-op implementation for testing in Node.js environment.
+ * All methods return default values or do nothing.
+ */
+export declare class NodePedAppearanceClient extends IPedAppearanceClient {
+    setComponentVariation(): void;
+    setPropIndex(): void;
+    clearProp(): void;
+    setDefaultComponentVariation(): void;
+    setHeadBlendData(_ped: number, _data: HeadBlendData): void;
+    setFaceFeature(): void;
+    setHeadOverlay(): void;
+    setHeadOverlayColor(): void;
+    setHairColor(): void;
+    setEyeColor(): void;
+    addDecoration(): void;
+    clearDecorations(): void;
+    getDrawableVariation(): number;
+    getTextureVariation(): number;
+    getPropIndex(): number;
+    getPropTextureIndex(): number;
+    getNumDrawableVariations(): number;
+    getNumTextureVariations(): number;
+    getNumPropDrawableVariations(): number;
+    getNumPropTextureVariations(): number;
+    getNumOverlayValues(): number;
+    getNumHairColors(): number;
+    getNumMakeupColors(): number;
+}

package/dist/adapters/node/node-ped-appearance-client.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodePedAppearanceClient = void 0;
+const IPedAppearanceClient_1 = require("../contracts/IPedAppearanceClient");
+/**
+ * Node.js stub implementation of client-side ped appearance adapter.
+ *
+ * @remarks
+ * This is a no-op implementation for testing in Node.js environment.
+ * All methods return default values or do nothing.
+ */
+class NodePedAppearanceClient extends IPedAppearanceClient_1.IPedAppearanceClient {
+    setComponentVariation() { }
+    setPropIndex() { }
+    clearProp() { }
+    setDefaultComponentVariation() { }
+    setHeadBlendData(_ped, _data) { }
+    setFaceFeature() { }
+    setHeadOverlay() { }
+    setHeadOverlayColor() { }
+    setHairColor() { }
+    setEyeColor() { }
+    addDecoration() { }
+    clearDecorations() { }
+    getDrawableVariation() {
+        return 0;
+    }
+    getTextureVariation() {
+        return 0;
+    }
+    getPropIndex() {
+        return -1;
+    }
+    getPropTextureIndex() {
+        return 0;
+    }
+    getNumDrawableVariations() {
+        return 0;
+    }
+    getNumTextureVariations() {
+        return 0;
+    }
+    getNumPropDrawableVariations() {
+        return 0;
+    }
+    getNumPropTextureVariations() {
+        return 0;
+    }
+    getNumOverlayValues() {
+        return 0;
+    }
+    getNumHairColors() {
+        return 0;
+    }
+    getNumMakeupColors() {
+        return 0;
+    }
+}
+exports.NodePedAppearanceClient = NodePedAppearanceClient;

package/dist/adapters/node/node-ped-appearance-server.d.ts

@@ -0,0 +1,14 @@
+import { IPedAppearanceServer } from '../contracts/IPedAppearanceServer';
+/**
+ * Node.js stub implementation of server-side ped appearance adapter.
+ *
+ * @remarks
+ * This is a no-op implementation for testing in Node.js environment.
+ * All methods do nothing.
+ */
+export declare class NodePedAppearanceServer extends IPedAppearanceServer {
+    setComponentVariation(): void;
+    setPropIndex(): void;
+    clearProp(): void;
+    setDefaultComponentVariation(): void;
+}