feat: add fromNetworkId classes

Author: AvarianKnight

src/NativeCodeGen.Core/Generation/ILanguageEmitter.cs

@@ -88,6 +88,11 @@ public interface ILanguageEmitter
     /// </summary>
     void EmitFromHandleMethod(CodeBuilder cb, string className);
 
+    /// <summary>
+    /// Emits a static fromNetworkId factory method for entity classes.
+    /// </summary>
+    void EmitFromNetworkIdMethod(CodeBuilder cb, string className);
+
     /// <summary>
     /// Emits a constructor for a task class (takes entity).
     /// </summary>

src/NativeCodeGen.Core/Generation/SharedClassGenerator.cs

@@ -136,6 +136,12 @@ private void GenerateStandardHandleClass(CodeBuilder cb, string className, strin
         _emitter.EmitHandleConstructor(cb, className, baseClass);
         _emitter.EmitFromHandleMethod(cb, className);
 
+        // Entity and its subclasses get fromNetworkId
+        if (className == "Entity" || NativeClassifier.EntitySubclasses.Contains(className))
+        {
+            _emitter.EmitFromNetworkIdMethod(cb, className);
+        }
+
         foreach (var native in natives)
         {
             GenerateInstanceMethod(cb, native, className);

src/NativeCodeGen.Lua/LuaEmitter.cs

@@ -191,6 +191,21 @@ public void EmitFromHandleMethod(CodeBuilder cb, string className)
         cb.AppendLine();
     }
 
+    public void EmitFromNetworkIdMethod(CodeBuilder cb, string className)
+    {
+        cb.AppendLine($"---@param netId number");
+        cb.AppendLine($"---@return {className}|nil");
+        cb.AppendLine($"function {className}.fromNetworkId(netId)");
+        cb.Indent();
+        // NETWORK_DOES_ENTITY_EXIST_WITH_NETWORK_ID = 0x38CE16C96BD11F2C
+        // NETWORK_GET_ENTITY_FROM_NETWORK_ID = 0x5B912C3F653822E6
+        cb.AppendLine("if not Citizen.InvokeNative(0x38CE16C96BD11F2C, netId) then return nil end");
+        cb.AppendLine($"return {className}.fromHandle(Citizen.InvokeNative(0x5B912C3F653822E6, netId))");
+        cb.Dedent();
+        cb.AppendLine("end");
+        cb.AppendLine();
+    }
+
     public void EmitTaskConstructor(CodeBuilder cb, string className, string entityType, string? baseClass)
     {
         cb.AppendLine($"---@param entity {entityType}");

src/NativeCodeGen.TypeScript/TypeScriptEmitter.cs

@@ -256,6 +256,19 @@ public void EmitFromHandleMethod(CodeBuilder cb, string className)
         cb.AppendLine();
     }
 
+    public void EmitFromNetworkIdMethod(CodeBuilder cb, string className)
+    {
+        cb.AppendLine($"static fromNetworkId(netId: number): {className} | null {{");
+        cb.Indent();
+        // NETWORK_DOES_ENTITY_EXIST_WITH_NETWORK_ID = 0x38CE16C96BD11F2C
+        // NETWORK_GET_ENTITY_FROM_NETWORK_ID = 0x5B912C3F653822E6
+        cb.AppendLine("if (!inv<number>('0x38CE16C96BD11F2C', netId, rai())) return null;");
+        cb.AppendLine($"return {className}.fromHandle(inv<number>('0x5B912C3F653822E6', netId, rai()));");
+        cb.Dedent();
+        cb.AppendLine("}");
+        cb.AppendLine();
+    }
+
     public void EmitTaskConstructor(CodeBuilder cb, string className, string entityType, string? baseClass)
     {
         if (baseClass == null)