Implement Process module and Node API enhancements

- Added Process.h to define the Process class with methods for CWD, CHDIR, UPTIME, and HRTIME.
- Created a CJS module for testing with a simple export.
- Introduced .gitignore for ignoring dynamic libraries in node_api tests.
- Developed addon.cpp to implement various Node API functionalities including callbacks, threadsafe functions, and error handling.
- Added build script for compiling the addon into a dynamic library.
- Created cleanup_teardown.js to register teardown hooks and validate cleanup operations.
- Implemented reentry_tsfn.js to test callback reentry and threadsafe function behavior.
- Added run_teardown_test.sh to automate the testing of cleanup hooks.
- Introduced SignatureDispatchEmitter for generating signature dispatch bindings in metadata generation.

Author: DjDeveloperr

NativeScript/CMakeLists.txt

@@ -154,7 +154,9 @@ if(ENABLE_JS_RUNTIME)
     runtime/modules/node/Node.cpp
     runtime/modules/node/FS.cpp
     runtime/modules/node/Path.cpp
+    runtime/modules/node/Process.cpp
     runtime/modules/performance/Performance.cpp
+    runtime/ThreadSafeFunction.mm
     runtime/Bundle.mm
     runtime/modules/timers/Timers.mm
     runtime/modules/app/App.mm

NativeScript/cli/main.cpp

@@ -61,6 +61,13 @@ void bootFromModuleSpec(std::string baseDir, std::string spec) {
 
 int main(int argc, char** argv) {
   RuntimeConfig.LogToSystemConsole = true;
+  RuntimeConfig.Arguments.clear();
+  if (argv != nullptr && argc > 0) {
+    RuntimeConfig.Arguments.reserve(static_cast<size_t>(argc));
+    for (int i = 0; i < argc; i++) {
+      RuntimeConfig.Arguments.emplace_back(argv[i] != nullptr ? argv[i] : "");
+    }
+  }
 
 #ifdef __APPLE__
   std::string bytecodePath = getBytecodePathFromBundle();

NativeScript/ffi/CFunction.h

@@ -1,6 +1,7 @@
 #ifndef C_FUNCTION_H
 #define C_FUNCTION_H
 
+#include <cstdint>
 #include "Cif.h"
 
 namespace nativescript {
@@ -14,6 +15,7 @@ class CFunction {
 
   void* fnptr;
   Cif* cif = nullptr;
+  uint8_t dispatchFlags = 0;
 };
 
 }  // namespace nativescript

NativeScript/ffi/CFunction.mm

@@ -1,6 +1,7 @@
 #include "CFunction.h"
 #include "ClassMember.h"
 #include "ObjCBridge.h"
+#include "SignatureDispatch.h"
 #include "ffi/NativeScriptException.h"
 #include "ffi/Tasks.h"
 #include <cstring>
@@ -41,9 +42,11 @@
 
   auto sigOffset =
       metadata->signaturesOffset + metadata->getOffset(offset + sizeof(MDSectionOffset));
+  MDFunctionFlag functionFlags = metadata->getFunctionFlag(offset + sizeof(MDSectionOffset) * 2);
 
   auto cFunction = new CFunction(dlsym(self_dl, metadata->getString(offset)));
   cFunction->cif = getCFunctionCif(env, sigOffset);
+  cFunction->dispatchFlags = (functionFlags & mdFunctionReturnOwned) != 0 ? 1 : 0;
   cFunctionCache[offset] = cFunction;
 
   return cFunction;
@@ -63,6 +66,16 @@
 
   auto cif = func->cif;
 
+  const uint64_t dispatchId =
+      cif != nullptr && cif->signatureHash != 0
+          ? composeSignatureDispatchId(cif->signatureHash, SignatureCallKind::CFunction,
+                                       func->dispatchFlags)
+          : 0;
+  auto invoker = dispatchId != 0 ? lookupCFunctionPreparedInvoker(dispatchId) : nullptr;
+
+  MDFunctionFlag functionFlags = bridgeState->metadata->getFunctionFlag(
+      offset + sizeof(MDSectionOffset) * 2);
+
   size_t argc = cif->argc;
   napi_get_cb_info(env, cbinfo, &argc, cif->argv, nullptr, nullptr);
 
@@ -85,13 +98,17 @@
     void** avaluesPtr = new void*[cif->argc];
     memcpy(avaluesPtr, avalues, cif->argc * sizeof(void*));
 
-    Tasks::Register([env, cif, func, rvalue, avaluesPtr]() {
+    Tasks::Register([env, cif, func, invoker, rvalue, avaluesPtr]() {
       void* avalues[cif->argc];
       memcpy(avalues, avaluesPtr, cif->argc * sizeof(void*));
       delete[] avaluesPtr;
 
       @try {
-        ffi_call(&cif->cif, FFI_FN(func->fnptr), rvalue, avalues);
+        if (invoker != nullptr) {
+          invoker(func->fnptr, avalues, rvalue);
+        } else {
+          ffi_call(&cif->cif, FFI_FN(func->fnptr), rvalue, avalues);
+        }
       } @catch (NSException* exception) {
         NapiScope scope(env);
         std::string message = exception.description.UTF8String;
@@ -106,7 +123,11 @@
 #endif
 
   @try {
-    ffi_call(&cif->cif, FFI_FN(func->fnptr), rvalue, avalues);
+    if (invoker != nullptr) {
+      invoker(func->fnptr, avalues, rvalue);
+    } else {
+      ffi_call(&cif->cif, FFI_FN(func->fnptr), rvalue, avalues);
+    }
   } @catch (NSException* exception) {
     std::string message = exception.description.UTF8String;
     NSLog(@"ObjC->JS: Exception in CFunction: %s", message.c_str());
@@ -135,8 +156,6 @@
     }
   }
 
-  MDFunctionFlag functionFlags = bridgeState->metadata->getFunctionFlag(
-      offset + sizeof(MDSectionOffset) * 2);
   uint32_t toJSFlags = kCStringAsReference;
   if ((functionFlags & mdFunctionReturnOwned) != 0) {
     toJSFlags |= kReturnOwned;

NativeScript/ffi/Cif.h

@@ -1,6 +1,7 @@
 #ifndef METHOD_CIF_H
 #define METHOD_CIF_H
 
+#include <cstdint>
 #include <string>
 
 #include "MetadataReader.h"
@@ -18,6 +19,7 @@ class Cif {
   size_t frameLength;
   size_t rvalueLength;
   bool isVariadic = false;
+  uint64_t signatureHash = 0;
 
   void* rvalue;
   void** avalues;

NativeScript/ffi/Cif.mm

@@ -11,6 +11,22 @@
 #include "Util.h"
 
 namespace nativescript {
+namespace {
+
+constexpr uint64_t kFNV64OffsetBasis = 14695981039346656037ull;
+constexpr uint64_t kFNV64Prime = 1099511628211ull;
+
+uint64_t hashBytesFnv1a(const void* data, size_t size) {
+  const auto* bytes = static_cast<const uint8_t*>(data);
+  uint64_t hash = kFNV64OffsetBasis;
+  for (size_t i = 0; i < size; i++) {
+    hash ^= static_cast<uint64_t>(bytes[i]);
+    hash *= kFNV64Prime;
+  }
+  return hash;
+}
+
+}  // namespace
 
 // Essentially, we cache libffi structures per unique method signature,
 // this helps us avoid the overhead of creating them on the fly for each
@@ -180,6 +196,7 @@
 
 Cif::Cif(napi_env env, MDMetadataReader* reader, MDSectionOffset offset, bool isMethod,
          bool isBlock) {
+  MDSectionOffset signatureStart = offset;
   auto returnTypeKind = reader->getTypeKind(offset);
   bool next = ((MDTypeFlag)returnTypeKind & mdTypeFlagNext) != 0;
   isVariadic = ((MDTypeFlag)returnTypeKind & mdTypeFlagVariadic) != 0;
@@ -249,6 +266,13 @@
 
   rvalue = malloc(cif.rtype->size);
   rvalueLength = cif.rtype->size;
+
+  const size_t signatureLength = static_cast<size_t>(offset - signatureStart);
+  if (signatureLength > 0) {
+    const auto* signatureBytes =
+        reinterpret_cast<const uint8_t*>(reader->data) + signatureStart;
+    signatureHash = hashBytesFnv1a(signatureBytes, signatureLength);
+  }
 }
 
 Cif::~Cif() {

NativeScript/ffi/ClassMember.h

@@ -1,6 +1,7 @@
 #ifndef BRIDGED_METHOD_H
 #define BRIDGED_METHOD_H
 
+#include <cstdint>
 #include <iostream>
 #include <vector>
 
@@ -23,6 +24,7 @@ class MethodDescriptor {
   MethodDescriptorKind kind;
 
   MDSectionOffset signatureOffset;
+  uint8_t dispatchFlags = 0;
   std::string encoding;
   bool isProperty = false;
 
@@ -54,8 +56,10 @@ struct ObjCClassMemberOverload {
   MethodDescriptor method;
   Cif* cif = nullptr;
 
-  ObjCClassMemberOverload(SEL selector, MDSectionOffset offset)
-      : method(selector, offset) {}
+  ObjCClassMemberOverload(SEL selector, MDSectionOffset offset, uint8_t dispatchFlags)
+      : method(selector, offset) {
+    method.dispatchFlags = dispatchFlags;
+  }
 };
 
 class ObjCClassMember {
@@ -69,15 +73,17 @@ class ObjCClassMember {
   static napi_value jsGetter(napi_env env, napi_callback_info cbinfo);
   static napi_value jsReadOnlySetter(napi_env env, napi_callback_info cbinfo);
   static napi_value jsSetter(napi_env env, napi_callback_info cbinfo);
-  void addOverload(SEL selector, MDSectionOffset offset);
+  void addOverload(SEL selector, MDSectionOffset offset, uint8_t dispatchFlags);
 
   ObjCClassMember(ObjCBridgeState* bridgeState, SEL selector,
                   MDSectionOffset offset, MDMemberFlag flags)
       : bridgeState(bridgeState),
         methodOrGetter(MethodDescriptor(selector, offset)),
         returnOwned((flags & metagen::mdMemberReturnOwned) != 0),
         classMethod((flags & metagen::mdMemberStatic) != 0),
-        cls(nullptr) {}
+        cls(nullptr) {
+    methodOrGetter.dispatchFlags = returnOwned ? 1 : 0;
+  }
 
   ObjCClassMember(ObjCBridgeState* bridgeState, SEL getterSelector,
                   SEL setterSelector, MDSectionOffset getterOffset,
@@ -90,6 +96,8 @@ class ObjCClassMember {
         cls(nullptr) {
     methodOrGetter.isProperty = true;
     setter.isProperty = true;
+    methodOrGetter.dispatchFlags = returnOwned ? 1 : 0;
+    setter.dispatchFlags = 0;
   }
 
   ObjCBridgeState* bridgeState;

NativeScript/ffi/ClassMember.mm

@@ -13,6 +13,7 @@
 #include "Closure.h"
 #include "MetadataReader.h"
 #include "ObjCBridge.h"
+#include "SignatureDispatch.h"
 #include "TypeConv.h"
 #include "Util.h"
 #include "ffi/Block.h"
@@ -207,7 +208,8 @@ napi_value JS_NSObject_alloc(napi_env env, napi_callback_info cbinfo) {
         if (memberIt->second.methodOrGetter.isProperty) {
           continue;
         }
-        memberIt->second.addOverload(methodSelector, signatureOffset);
+        memberIt->second.addOverload(methodSelector, signatureOffset,
+                                     (flags & metagen::mdMemberReturnOwned) != 0 ? 1 : 0);
         member = &memberIt->second;
       } else if (inheritedProperty && superMember != nullptr &&
                  !superMember->methodOrGetter.isProperty) {
@@ -216,9 +218,11 @@ napi_value JS_NSObject_alloc(napi_env env, napi_callback_info cbinfo) {
                                   superMember->methodOrGetter.signatureOffset, flags));
         member = &inserted.first->second;
         for (const auto& overload : superMember->overloads) {
-          member->addOverload(overload.method.selector, overload.method.signatureOffset);
+          member->addOverload(overload.method.selector, overload.method.signatureOffset,
+                              overload.method.dispatchFlags);
         }
-        member->addOverload(methodSelector, signatureOffset);
+        member->addOverload(methodSelector, signatureOffset,
+                            (flags & metagen::mdMemberReturnOwned) != 0 ? 1 : 0);
       } else {
         const auto& inserted = memberMap.emplace(
             name, ObjCClassMember(bridgeState, methodSelector, signatureOffset, flags));
@@ -269,7 +273,7 @@ napi_value JS_NSObject_alloc(napi_env env, napi_callback_info cbinfo) {
   }
 }
 
-void ObjCClassMember::addOverload(SEL selector, MDSectionOffset offset) {
+void ObjCClassMember::addOverload(SEL selector, MDSectionOffset offset, uint8_t dispatchFlags) {
   if (methodOrGetter.selector == selector) {
     return;
   }
@@ -280,11 +284,11 @@ napi_value JS_NSObject_alloc(napi_env env, napi_callback_info cbinfo) {
     }
   }
 
-  overloads.emplace_back(selector, offset);
+  overloads.emplace_back(selector, offset, dispatchFlags);
 }
 
-inline bool objcNativeCall(napi_env env, Cif* cif, id self, bool classMethod, void** avalues,
-                           void* rvalue) {
+inline bool objcNativeCall(napi_env env, Cif* cif, id self, bool classMethod, uint8_t dispatchFlags,
+                           void** avalues, void* rvalue) {
   SEL selector = avalues != nullptr && cif->cif.nargs >= 2 ? *((SEL*)avalues[1]) : nullptr;
 
   Class receiverClass = nil;
@@ -310,6 +314,16 @@ inline bool objcNativeCall(napi_env env, Cif* cif, id self, bool classMethod, vo
 
   @try {
     if (!supercall) {
+      if (cif != nullptr && cif->signatureHash != 0) {
+        const uint64_t dispatchId = composeSignatureDispatchId(
+            cif->signatureHash, SignatureCallKind::ObjCMethod, dispatchFlags);
+        auto invoker = lookupObjCPreparedInvoker(dispatchId);
+        if (invoker != nullptr) {
+          invoker((void*)objc_msgSend, avalues, rvalue);
+          return true;
+        }
+      }
+
 #if defined(__x86_64__)
       if (isStret) {
         ffi_call(&cif->cif, FFI_FN(objc_msgSend_stret), rvalue, avalues);
@@ -1109,7 +1123,8 @@ size_t getCifArgumentStorageSize(Cif* cif, unsigned int argumentIndex,
     retainedReceiver = true;
   }
 
-  if (!objcNativeCall(env, cif, self, receiverIsClass, avalues, &rvalue)) {
+  if (!objcNativeCall(env, cif, self, receiverIsClass, method->methodOrGetter.dispatchFlags,
+                      avalues, &rvalue)) {
     if (retainedReceiver) {
       [self release];
     }
@@ -1375,7 +1390,8 @@ size_t getCifArgumentStorageSize(Cif* cif, unsigned int argumentIndex,
 
   // NSLog(@"objcNativeCall: %p, %@", self, NSStringFromSelector(method->methodOrGetter.selector));
 
-  if (!objcNativeCall(env, cif, self, receiverIsClass, avalues, rvalue)) {
+  if (!objcNativeCall(env, cif, self, receiverIsClass, selectedMethod->dispatchFlags, avalues,
+                      rvalue)) {
     for (id block : fallbackBlocksToRelease) {
       [block release];
     }
@@ -1470,7 +1486,8 @@ NativeScriptException nativeScriptException(errorMessage != nullptr ? errorMessa
 
   // NSLog(@"objcNativeCall: %p, %@", self, NSStringFromSelector(method->methodOrGetter.selector));
 
-  if (!objcNativeCall(env, cif, self, receiverIsClass, avalues, rvalue)) {
+  if (!objcNativeCall(env, cif, self, receiverIsClass, method->methodOrGetter.dispatchFlags,
+                      avalues, rvalue)) {
     return nullptr;
   }
 
@@ -1534,7 +1551,8 @@ NativeScriptException nativeScriptException(errorMessage != nullptr ? errorMessa
   bool shouldFree = false;
   cif->argTypes[0]->toNative(env, argv, avalues[2], &shouldFree, &shouldFree);
 
-  if (!objcNativeCall(env, cif, self, receiverIsClass, avalues, rvalue)) {
+  if (!objcNativeCall(env, cif, self, receiverIsClass, method->setter.dispatchFlags, avalues,
+                      rvalue)) {
     return nullptr;
   }
 

NativeScript/ffi/GeneratedSignatureDispatch.inc

@@ -0,0 +1,15 @@
+#ifndef NS_GENERATED_SIGNATURE_DISPATCH_INC
+#define NS_GENERATED_SIGNATURE_DISPATCH_INC
+
+namespace nativescript {
+
+inline constexpr ObjCDispatchEntry kGeneratedObjCDispatchEntries[] = {
+    {0, nullptr},
+};
+inline constexpr CFunctionDispatchEntry kGeneratedCFunctionDispatchEntries[] = {
+    {0, nullptr},
+};
+
+}  // namespace nativescript
+
+#endif  // NS_GENERATED_SIGNATURE_DISPATCH_INC