nj-core 6.1.0

high level wrapper for Node N-API
Documentation
use std::ptr;

use tracing::debug;
use tracing::instrument;

use crate::sys::napi_value;
use crate::sys::napi_env;
use crate::sys::napi_callback_info;
use crate::sys::napi_ref;
use crate::val::JsEnv;
use crate::val::JsExports;
use crate::val::JsCallback;
use crate::NjError;
use crate::IntoJs;
use crate::PropertiesBuilder;

pub struct JSObjectWrapper<T> {
    wrapper: napi_ref,
    inner: T,
}

impl<T> JSObjectWrapper<T> {
    pub fn mut_inner(&mut self) -> &mut T {
        &mut self.inner
    }

    pub fn inner(&self) -> &T {
        &self.inner
    }
}

impl<T> JSObjectWrapper<T>
where
    T: JSClass,
{
    /// wrap myself in the JS instance
    /// and saved the reference
    #[instrument(skip(self))]
    fn wrap(self, js_env: &JsEnv, js_cb: JsCallback) -> Result<napi_value, NjError> {
        let boxed_self = Box::new(self);
        let raw_ptr = Box::into_raw(boxed_self); // rust no longer manages this struct
        debug!(?raw_ptr, "box into raw");
        let wrap = js_env.wrap(js_cb.this(), raw_ptr as *mut u8, T::js_finalize)?;

        unsafe {
            // save the wrap reference in wrapper container
            let rust_ref: &mut Self = &mut *raw_ptr;
            rust_ref.wrapper = wrap;
        }

        Ok(js_cb.this_owned())
    }
}

pub trait JSClass: Sized {
    const CLASS_NAME: &'static str;

    // create rust object from argument
    fn create_from_js(
        js_env: &JsEnv,
        cb: napi_callback_info,
    ) -> Result<(Self, JsCallback), NjError>;

    fn set_constructor(constructor: napi_ref);

    fn get_constructor() -> napi_ref;

    /// new instance
    #[instrument]
    fn new_instance(js_env: &JsEnv, js_args: Vec<napi_value>) -> Result<napi_value, NjError> {
        debug!("new instance");
        let constructor = js_env.get_reference_value(Self::get_constructor())?;
        js_env.new_instance(constructor, js_args)
    }

    /// given instance, return my object
    #[instrument]
    fn unwrap_mut(js_env: &JsEnv, instance: napi_value) -> Result<&'static mut Self, NjError> {
        Ok(js_env
            .unwrap_mut::<JSObjectWrapper<Self>>(instance)?
            .mut_inner())
    }

    fn unwrap(js_env: &JsEnv, instance: napi_value) -> Result<&'static Self, NjError> {
        Ok(js_env.unwrap::<JSObjectWrapper<Self>>(instance)?.inner())
    }

    fn properties() -> PropertiesBuilder {
        vec![].into()
    }

    /// define class and properties under exports
    #[instrument]
    fn js_init(js_exports: &mut JsExports) -> Result<(), NjError> {
        let js_constructor =
            js_exports
                .env()
                .define_class(Self::CLASS_NAME, Self::js_new, Self::properties())?;

        debug!(?js_constructor, "class defined with constructor");

        // save the constructor reference, we need this later in order to instantiate
        let js_ref = js_exports.env().create_reference(js_constructor, 1)?;
        debug!(?js_constructor, "created reference to constructor");
        Self::set_constructor(js_ref);

        js_exports.set_name_property(Self::CLASS_NAME, js_constructor)?;
        Ok(())
    }

    /// call when Javascript class constructor is called
    /// For example:  new Car(...)
    #[instrument]
    extern "C" fn js_new(env: napi_env, info: napi_callback_info) -> napi_value {
        let js_env = JsEnv::new(env);

        let result: Result<napi_value, NjError> = (|| {
            debug!(clas = std::any::type_name::<Self>(), "getting new target");

            let target = js_env.get_new_target(info)?;

            if target.is_null() {
                debug!("no target");
                Err(NjError::NoPlainConstructor)
            } else {
                debug!(?target, "invoked as constructor");

                let (rust_obj, js_cb) = Self::create_from_js(&js_env, info)?;
                debug!(?js_cb, "created rust object");
                let my_obj = JSObjectWrapper {
                    inner: rust_obj,
                    wrapper: ptr::null_mut(),
                };

                my_obj.wrap(&js_env, js_cb)
            }
        })();

        result.into_js(&js_env)
    }

    extern "C" fn js_finalize(
        _env: napi_env,
        finalize_data: *mut ::std::os::raw::c_void,
        _finalize_hint: *mut ::std::os::raw::c_void,
    ) {
        debug!("my object finalize");
        unsafe {
            let ptr: *mut JSObjectWrapper<Self> = finalize_data as *mut JSObjectWrapper<Self>;
            let _ = Box::from_raw(ptr);
        }
    }
}