@nodemod/core 1.0.0

package/dist/core/msg.d.ts

@@ -0,0 +1,300 @@
+import { EventEmitter } from 'events';
+import type NodemodUtil from '../utils/util';
+/**
+ * Represents a single piece of message data with its type and value.
+ */
+export interface MessageData {
+    /** The data type for network serialization */
+    type: 'byte' | 'char' | 'short' | 'long' | 'angle' | 'coord' | 'string' | 'entity';
+    /** The actual value to be sent */
+    value: any;
+}
+/**
+ * Internal state tracking for message processing.
+ */
+export interface MessageState {
+    /** Message destination flags */
+    dest: number;
+    /** Message type ID */
+    type: number;
+    /** Message name/identifier */
+    name: string;
+    /** 3D origin coordinates */
+    origin: number[];
+    /** Target entity (if applicable) */
+    entity?: nodemod.Entity | null;
+    /** Processed data array */
+    data: any[];
+    /** Raw message data with type information */
+    rawData: MessageData[];
+    /** Flag indicating message processing is complete */
+    isMessageEnd?: boolean;
+}
+/**
+ * Options for sending a message to clients.
+ */
+export interface SendOptions {
+    /** Message type name or numeric ID */
+    type: string | number;
+    /** Message destination (defaults based on entity presence) */
+    dest?: number;
+    /** Target entity, entity index, or null for broadcasts */
+    entity?: nodemod.Entity | number | null;
+    /** 3D origin coordinates for positional messages */
+    origin?: number[];
+    /** Array of message data to send */
+    data: MessageData[];
+}
+/**
+ * Message destination constants for targeting different groups of clients.
+ */
+export declare const MsgDest: {
+    /** Message to all players without delivery guarantee */
+    broadcast: number;
+    /** Message to one player with delivery guarantee */
+    one: number;
+    /** Message with delivery guarantee to all players */
+    all: number;
+    /** Write to the init string */
+    init: number;
+    /** All players in potentially visible set of point */
+    pvs: number;
+    /** All players in potentially audible set */
+    pas: number;
+    /** All players in PVS with reliable delivery */
+    pvs_r: number;
+    /** All players in PAS with reliable delivery */
+    pas_r: number;
+    /** Message to one player without delivery guarantee */
+    one_unreliable: number;
+    /** Message to all HLTV proxy */
+    spec: number;
+};
+/**
+ * Engine message type constants for different types of network messages.
+ */
+export declare const MsgTypes: {
+    /** Invalid message type */
+    bad: number;
+    /** No operation */
+    nop: number;
+    /** Client disconnect message */
+    disconnect: number;
+    /** Event message */
+    event: number;
+    /** Version information */
+    version: number;
+    /** Set client view */
+    setview: number;
+    /** Sound message */
+    sound: number;
+    /** Time synchronization */
+    time: number;
+    /** Print message to console */
+    print: number;
+    /** Send command to client */
+    stufftext: number;
+    /** Set client view angle */
+    setangle: number;
+    /** Server information */
+    serverinfo: number;
+    /** Light style update */
+    lightstyle: number;
+    /** Update user information */
+    updateuserinfo: number;
+    /** Delta description */
+    deltadescription: number;
+    /** Client data update */
+    clientdata: number;
+    /** Stop sound */
+    stopsound: number;
+    /** Ping information */
+    pings: number;
+    /** Particle effect */
+    particle: number;
+    /** Damage indicator */
+    damage: number;
+    /** Spawn static entity */
+    spawnstatic: number;
+    /** Reliable event */
+    event_reliable: number;
+    /** Spawn baseline */
+    spawnbaseline: number;
+    /** Temporary entity */
+    tempentity: number;
+    /** Set game pause state */
+    setpause: number;
+    /** Sign-on number */
+    signonnum: number;
+    /** Center print message */
+    centerprint: number;
+    /** Monster killed notification */
+    killedmonster: number;
+    /** Secret found notification */
+    foundsecret: number;
+    /** Spawn static sound */
+    spawnstaticsound: number;
+    /** Intermission state */
+    intermission: number;
+    /** Finale message */
+    finale: number;
+    /** CD track change */
+    cdtrack: number;
+    /** Game state restore */
+    restore: number;
+    /** Cutscene message */
+    cutscene: number;
+    /** Weapon animation */
+    weaponanim: number;
+    /** Decal name */
+    decalname: number;
+    /** Room type for audio */
+    roomtype: number;
+    /** Add to view angle */
+    addangle: number;
+    /** New user message registration */
+    newusermsg: number;
+    /** Packet entities */
+    packetentities: number;
+    /** Delta packet entities */
+    deltapacketentities: number;
+    /** Network choke */
+    choke: number;
+    /** Resource list */
+    resourcelist: number;
+    /** New movement variables */
+    newmovevars: number;
+    /** Resource request */
+    resourcerequest: number;
+    /** Client customization */
+    customization: number;
+    /** Crosshair angle */
+    crosshairangle: number;
+    /** Sound fade */
+    soundfade: number;
+    /** File transfer failed */
+    filetxferfailed: number;
+    /** HLTV message */
+    hltv: number;
+    /** Director message */
+    director: number;
+    /** Voice initialization */
+    voiceinit: number;
+    /** Voice data */
+    voicedata: number;
+    /** Send extra info */
+    sendextrainfo: number;
+    /** Time scale */
+    timescale: number;
+    /** Resource location */
+    resourcelocation: number;
+    /** Send CVAR value */
+    sendcvarvalue: number;
+    /** Send CVAR value (v2) */
+    sendcvarvalue2: number;
+};
+/**
+ * Message system for handling network communication between server and clients.
+ * Provides an event-driven interface for intercepting and sending game messages.
+ *
+ * @example
+ * ```typescript
+ * // Listen for a specific message
+ * nodemodCore.msg.on('ShowMenu', (state) => {
+ *   console.log('Menu message intercepted:', state);
+ * });
+ *
+ * // Send a message to all clients
+ * nodemodCore.msg.send({
+ *   type: 'TextMsg',
+ *   data: [
+ *     { type: 'byte', value: 4 }, // HUD_PRINTCENTER
+ *     { type: 'string', value: 'Welcome to the server!' }
+ *   ]
+ * });
+ *
+ * // Send a message to specific player
+ * nodemodCore.msg.send({
+ *   type: 'ShowMenu',
+ *   entity: player,
+ *   data: [
+ *     { type: 'short', value: 1023 },
+ *     { type: 'char', value: 30 },
+ *     { type: 'byte', value: false },
+ *     { type: 'string', value: 'Menu text here' }
+ *   ]
+ * });
+ * ```
+ */
+export default class NodemodMsg extends EventEmitter {
+    /** Utility service for entity operations */
+    private util;
+    /** Current message processing state */
+    private state;
+    /** Map of registered user message types */
+    private registeredEventTypes;
+    /**
+     * Creates a new NodemodMsg instance.
+     *
+     * @param utilService - Optional utility service (can be injected later)
+     */
+    constructor(utilService?: NodemodUtil | null);
+    /**
+     * Sets the utility service after construction.
+     * Used for dependency injection when service isn't available during construction.
+     *
+     * @param utilService - The utility service instance
+     */
+    setUtilService(utilService: NodemodUtil): void;
+    private initializeEventHandlers;
+    private writers;
+    private writeValue;
+    /**
+     * Registers a new user message type with the engine.
+     *
+     * @param eventName - Name of the message type
+     * @param size - Maximum size of the message (-1 for variable size)
+     * @returns Message type ID, or MsgTypes.bad if registration failed
+     */
+    register(eventName: string, size?: number): number;
+    /**
+     * Gets the message ID for a user message, registering it if necessary.
+     *
+     * @param name - Message name
+     * @param size - Message size (-1 for variable)
+     * @returns Message ID
+     */
+    getUserMsgId(name: string, size?: number): number;
+    /**
+     * Sends a message to clients.
+     *
+     * @param options - Message sending options
+     *
+     * @example
+     * ```typescript
+     * // Send text message to all clients
+     * nodemodCore.msg.send({
+     *   type: 'TextMsg',
+     *   dest: MsgDest.all,
+     *   data: [
+     *     { type: 'byte', value: 4 }, // HUD_PRINTCENTER
+     *     { type: 'string', value: 'Server announcement!' }
+     *   ]
+     * });
+     *
+     * // Send menu to specific player
+     * nodemodCore.msg.send({
+     *   type: 'ShowMenu',
+     *   entity: player,
+     *   data: [
+     *     { type: 'short', value: 511 }, // key mask
+     *     { type: 'char', value: 30 },   // display time
+     *     { type: 'byte', value: false }, // multi-part
+     *     { type: 'string', value: '1. Option 1\n2. Option 2' }
+     *   ]
+     * });
+     * ```
+     */
+    send(options: SendOptions): void;
+}
+//# sourceMappingURL=msg.d.ts.map

package/dist/core/msg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg.d.ts","sourceRoot":"","sources":["../../src/core/msg.ts"],"names":[],"mappings":"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"}

package/dist/core/msg.js

@@ -0,0 +1,374 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MsgTypes = exports.MsgDest = void 0;
+const events_1 = require("events");
+// Extend the nodemod namespace to include missing methods
+// Beautiful dependency injection for util service
+/**
+ * Message destination constants for targeting different groups of clients.
+ */
+exports.MsgDest = {
+    /** Message to all players without delivery guarantee */
+    broadcast: 0,
+    /** Message to one player with delivery guarantee */
+    one: 1,
+    /** Message with delivery guarantee to all players */
+    all: 2,
+    /** Write to the init string */
+    init: 3,
+    /** All players in potentially visible set of point */
+    pvs: 4,
+    /** All players in potentially audible set */
+    pas: 5,
+    /** All players in PVS with reliable delivery */
+    pvs_r: 6,
+    /** All players in PAS with reliable delivery */
+    pas_r: 7,
+    /** Message to one player without delivery guarantee */
+    one_unreliable: 8,
+    /** Message to all HLTV proxy */
+    spec: 9
+};
+/**
+ * Engine message type constants for different types of network messages.
+ */
+exports.MsgTypes = {
+    /** Invalid message type */
+    bad: 0,
+    /** No operation */
+    nop: 1,
+    /** Client disconnect message */
+    disconnect: 2,
+    /** Event message */
+    event: 3,
+    /** Version information */
+    version: 4,
+    /** Set client view */
+    setview: 5,
+    /** Sound message */
+    sound: 6,
+    /** Time synchronization */
+    time: 7,
+    /** Print message to console */
+    print: 8,
+    /** Send command to client */
+    stufftext: 9,
+    /** Set client view angle */
+    setangle: 10,
+    /** Server information */
+    serverinfo: 11,
+    /** Light style update */
+    lightstyle: 12,
+    /** Update user information */
+    updateuserinfo: 13,
+    /** Delta description */
+    deltadescription: 14,
+    /** Client data update */
+    clientdata: 15,
+    /** Stop sound */
+    stopsound: 16,
+    /** Ping information */
+    pings: 17,
+    /** Particle effect */
+    particle: 18,
+    /** Damage indicator */
+    damage: 19,
+    /** Spawn static entity */
+    spawnstatic: 20,
+    /** Reliable event */
+    event_reliable: 21,
+    /** Spawn baseline */
+    spawnbaseline: 22,
+    /** Temporary entity */
+    tempentity: 23,
+    /** Set game pause state */
+    setpause: 24,
+    /** Sign-on number */
+    signonnum: 25,
+    /** Center print message */
+    centerprint: 26,
+    /** Monster killed notification */
+    killedmonster: 27,
+    /** Secret found notification */
+    foundsecret: 28,
+    /** Spawn static sound */
+    spawnstaticsound: 29,
+    /** Intermission state */
+    intermission: 30,
+    /** Finale message */
+    finale: 31,
+    /** CD track change */
+    cdtrack: 32,
+    /** Game state restore */
+    restore: 33,
+    /** Cutscene message */
+    cutscene: 34,
+    /** Weapon animation */
+    weaponanim: 35,
+    /** Decal name */
+    decalname: 36,
+    /** Room type for audio */
+    roomtype: 37,
+    /** Add to view angle */
+    addangle: 38,
+    /** New user message registration */
+    newusermsg: 39,
+    /** Packet entities */
+    packetentities: 40,
+    /** Delta packet entities */
+    deltapacketentities: 41,
+    /** Network choke */
+    choke: 42,
+    /** Resource list */
+    resourcelist: 43,
+    /** New movement variables */
+    newmovevars: 44,
+    /** Resource request */
+    resourcerequest: 45,
+    /** Client customization */
+    customization: 46,
+    /** Crosshair angle */
+    crosshairangle: 47,
+    /** Sound fade */
+    soundfade: 48,
+    /** File transfer failed */
+    filetxferfailed: 49,
+    /** HLTV message */
+    hltv: 50,
+    /** Director message */
+    director: 51,
+    /** Voice initialization */
+    voiceinit: 52,
+    /** Voice data */
+    voicedata: 53,
+    /** Send extra info */
+    sendextrainfo: 54,
+    /** Time scale */
+    timescale: 55,
+    /** Resource location */
+    resourcelocation: 56,
+    /** Send CVAR value */
+    sendcvarvalue: 57,
+    /** Send CVAR value (v2) */
+    sendcvarvalue2: 58
+};
+/**
+ * Message system for handling network communication between server and clients.
+ * Provides an event-driven interface for intercepting and sending game messages.
+ *
+ * @example
+ * ```typescript
+ * // Listen for a specific message
+ * nodemodCore.msg.on('ShowMenu', (state) => {
+ *   console.log('Menu message intercepted:', state);
+ * });
+ *
+ * // Send a message to all clients
+ * nodemodCore.msg.send({
+ *   type: 'TextMsg',
+ *   data: [
+ *     { type: 'byte', value: 4 }, // HUD_PRINTCENTER
+ *     { type: 'string', value: 'Welcome to the server!' }
+ *   ]
+ * });
+ *
+ * // Send a message to specific player
+ * nodemodCore.msg.send({
+ *   type: 'ShowMenu',
+ *   entity: player,
+ *   data: [
+ *     { type: 'short', value: 1023 },
+ *     { type: 'char', value: 30 },
+ *     { type: 'byte', value: false },
+ *     { type: 'string', value: 'Menu text here' }
+ *   ]
+ * });
+ * ```
+ */
+class NodemodMsg extends events_1.EventEmitter {
+    /** Utility service for entity operations */
+    util;
+    /** Current message processing state */
+    state;
+    /** Map of registered user message types */
+    registeredEventTypes;
+    /**
+     * Creates a new NodemodMsg instance.
+     *
+     * @param utilService - Optional utility service (can be injected later)
+     */
+    constructor(utilService = null) {
+        super();
+        this.util = utilService; // Will be null initially, injected later
+        this.state = null;
+        this.registeredEventTypes = {};
+        try {
+            this.initializeEventHandlers();
+        }
+        catch (error) {
+            // Ignore errors if nodemod is not available (outside HLDS environment)
+        }
+    }
+    /**
+     * Sets the utility service after construction.
+     * Used for dependency injection when service isn't available during construction.
+     *
+     * @param utilService - The utility service instance
+     */
+    setUtilService(utilService) {
+        this.util = utilService;
+    }
+    initializeEventHandlers() {
+        this.on('newListener', (eventName) => this.getUserMsgId(eventName.replace(/^post:/, '')));
+        nodemod.on('engMessageBegin', (msg_dest, msg_type, origin, entity) => {
+            const name = nodemod.getUserMsgName(msg_type);
+            if (!this.listeners(name).length && !this.listeners(`post:${name}`).length) {
+                return;
+            }
+            this.state = { dest: msg_dest, type: msg_type, name, origin, entity, data: [], rawData: [] };
+        });
+        // POST because programmer might want to send a new message immediately from notification
+        nodemod.on('engMessageEnd', () => {
+            if (!this.state) {
+                return;
+            }
+            const state = this.state;
+            this.emit(state.name, state);
+            this.state.isMessageEnd = true; // so that write methods are not called repeatedly
+            this.state.rawData.map(v => this.writers[v.type](v.value));
+            this.state.data = this.state.rawData.map(v => v.value);
+        });
+        nodemod.on('postEngMessageEnd', () => {
+            if (!this.state) {
+                return;
+            }
+            const state = this.state;
+            this.state = null;
+            this.emit(`post:${state.name}`, state);
+        });
+        nodemod.on('engWriteByte', (v) => this.writeValue(v || 0, 'byte'));
+        nodemod.on('engWriteChar', (v) => this.writeValue(v || 0, 'char'));
+        nodemod.on('engWriteShort', (v) => this.writeValue(v || 0, 'short'));
+        nodemod.on('engWriteLong', (v) => this.writeValue(v || 0, 'long'));
+        nodemod.on('engWriteAngle', (v) => this.writeValue(v || 0, 'angle'));
+        nodemod.on('engWriteCoord', (v) => this.writeValue(v || 0, 'coord'));
+        nodemod.on('engWriteString', (v) => this.writeValue(v || '', 'string'));
+        nodemod.on('engWriteEntity', (v) => this.writeValue(v, 'entity'));
+    }
+    writers = {
+        byte: (v) => nodemod.eng.writeByte(v),
+        char: (v) => nodemod.eng.writeChar(v),
+        short: (v) => nodemod.eng.writeShort(v),
+        long: (v) => nodemod.eng.writeLong(v),
+        angle: (v) => nodemod.eng.writeAngle(v),
+        coord: (v) => nodemod.eng.writeCoord(v),
+        string: (v) => nodemod.eng.writeString(v || ''),
+        entity: (v) => nodemod.eng.writeEntity(typeof v === 'number' ? v : nodemod.eng.indexOfEdict(v)),
+    };
+    writeValue(value, type) {
+        if (!this.state || this.state.isMessageEnd) {
+            nodemod.setMetaResult(0 /* nodemod.META_RES.UNSET */);
+            return;
+        }
+        this.state.data.push(value);
+        this.state.rawData.push({ type, value });
+        nodemod.setMetaResult(4 /* nodemod.META_RES.SUPERCEDE */);
+    }
+    /**
+     * Registers a new user message type with the engine.
+     *
+     * @param eventName - Name of the message type
+     * @param size - Maximum size of the message (-1 for variable size)
+     * @returns Message type ID, or MsgTypes.bad if registration failed
+     */
+    register(eventName, size = -1) {
+        const eventId = nodemod.getUserMsgId(eventName) ?? nodemod.eng.regUserMsg(eventName, size);
+        if (eventId === exports.MsgTypes.bad) {
+            // Doesn't seem to be registered still.
+            return eventId;
+        }
+        this.registeredEventTypes[eventId.toString()] = eventName;
+        return eventId;
+    }
+    /**
+     * Gets the message ID for a user message, registering it if necessary.
+     *
+     * @param name - Message name
+     * @param size - Message size (-1 for variable)
+     * @returns Message ID
+     */
+    getUserMsgId(name, size = -1) {
+        const entry = Object.entries(this.registeredEventTypes).find(v => v[1] === name);
+        return entry ? parseInt(entry[0]) : this.register(name, size);
+    }
+    /**
+     * Sends a message to clients.
+     *
+     * @param options - Message sending options
+     *
+     * @example
+     * ```typescript
+     * // Send text message to all clients
+     * nodemodCore.msg.send({
+     *   type: 'TextMsg',
+     *   dest: MsgDest.all,
+     *   data: [
+     *     { type: 'byte', value: 4 }, // HUD_PRINTCENTER
+     *     { type: 'string', value: 'Server announcement!' }
+     *   ]
+     * });
+     *
+     * // Send menu to specific player
+     * nodemodCore.msg.send({
+     *   type: 'ShowMenu',
+     *   entity: player,
+     *   data: [
+     *     { type: 'short', value: 511 }, // key mask
+     *     { type: 'char', value: 30 },   // display time
+     *     { type: 'byte', value: false }, // multi-part
+     *     { type: 'string', value: '1. Option 1\n2. Option 2' }
+     *   ]
+     * });
+     * ```
+     */
+    send(options) {
+        if (options.type === exports.MsgTypes.bad) {
+            console.error(`[NodemodMsg] Invalid message type 'bad' specified`);
+            return;
+        }
+        const dest = options.dest ?? (options.entity ? exports.MsgDest.one : exports.MsgDest.all);
+        let finalEntity = null;
+        // For broadcast destinations, always use null
+        const broadcastDestinations = [exports.MsgDest.broadcast, exports.MsgDest.all, exports.MsgDest.init, exports.MsgDest.pvs, exports.MsgDest.pas, exports.MsgDest.pvs_r, exports.MsgDest.pas_r, exports.MsgDest.spec];
+        if (broadcastDestinations.includes(dest)) {
+            finalEntity = null;
+        }
+        else {
+            // For targeted messages, convert entity properly
+            if (options.entity) {
+                if (this.util) {
+                    finalEntity = this.util.forceEntityObject(options.entity) || nodemod.eng.pEntityOfEntIndex(0);
+                }
+                else if (typeof options.entity === 'number') {
+                    finalEntity = nodemod.eng.pEntityOfEntIndex(options.entity);
+                }
+                else {
+                    finalEntity = options.entity;
+                }
+            }
+            else {
+                finalEntity = nodemod.eng.pEntityOfEntIndex(0);
+            }
+        }
+        let type = typeof options.type === 'string' ? this.getUserMsgId(options.type) : options.type;
+        if (type === exports.MsgTypes.bad) {
+            console.error(`[NodemodMsg] Failed to send message, unknown type '${options.type}'`);
+            return;
+        }
+        nodemod.eng.messageBegin(dest, type, options.origin || [0, 0, 0], finalEntity);
+        options.data.map(v => this.writers[v.type](v.value));
+        nodemod.eng.messageEnd();
+    }
+}
+exports.default = NodemodMsg;
+//# sourceMappingURL=msg.js.map

package/dist/core/msg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg.js","sourceRoot":"","sources":["../../src/core/msg.ts"],"names":[],"mappings":"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"}