rspack_napi 0.100.0-rc.1

rspack napi
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

#![allow(clippy::not_unsafe_ptr_arg_deref)]

use std::{
  ops::{Deref, DerefMut},
  ptr,
};

use napi::{
  Env, Result,
  bindgen_prelude::{
    ClassInstance, JavaScriptClassExt, ToNapiValue, TypeName, ValidateNapiValue, check_status,
  },
  sys::{self, napi_env},
};

use crate::OneShotRef;

// A RAII (Resource Acquisition Is Initialization) style wrapper around `Ref` that ensures the
// reference is unreferenced when it goes out of scope. This struct maintains a single reference
// count and automatically cleans up when it is dropped.
pub struct OneShotInstanceRef<T: 'static> {
  one_shot_ref: OneShotRef,
  inner: *mut T,
}

impl<T: JavaScriptClassExt + 'static> OneShotInstanceRef<T> {
  pub fn new(env: napi_env, val: T) -> Result<Self> {
    let env_wrapper = Env::from_raw(env);
    let instance = val.into_instance(&env_wrapper)?;
    Self::from_instance(env, instance)
  }

  pub fn from_instance(env: napi_env, mut instance: ClassInstance<T>) -> Result<Self> {
    let mut napi_ref = ptr::null_mut();
    check_status!(unsafe { sys::napi_create_reference(env, instance.value, 1, &mut napi_ref) })?;

    Ok(Self {
      one_shot_ref: OneShotRef::from_napi_ref(env, napi_ref)?,
      inner: &mut *instance,
    })
  }
}

impl<T: TypeName> TypeName for OneShotInstanceRef<T> {
  fn type_name() -> &'static str {
    T::type_name()
  }
  fn value_type() -> napi::ValueType {
    T::value_type()
  }
}

impl<T: ValidateNapiValue> ValidateNapiValue for OneShotInstanceRef<T> {
  unsafe fn validate(env: sys::napi_env, napi_val: sys::napi_value) -> Result<sys::napi_value> {
    unsafe { T::validate(env, napi_val) }
  }
}

impl<T: ToNapiValue> ToNapiValue for OneShotInstanceRef<T> {
  unsafe fn to_napi_value(env: sys::napi_env, val: Self) -> Result<sys::napi_value> {
    unsafe { ToNapiValue::to_napi_value(env, &val.one_shot_ref) }
  }
}

impl<T: ToNapiValue> ToNapiValue for &OneShotInstanceRef<T> {
  unsafe fn to_napi_value(env: sys::napi_env, val: Self) -> Result<sys::napi_value> {
    unsafe { ToNapiValue::to_napi_value(env, &val.one_shot_ref) }
  }
}

impl<T: ToNapiValue> ToNapiValue for &mut OneShotInstanceRef<T> {
  unsafe fn to_napi_value(env: sys::napi_env, val: Self) -> Result<sys::napi_value> {
    unsafe { ToNapiValue::to_napi_value(env, &val.one_shot_ref) }
  }
}

impl<T> Deref for OneShotInstanceRef<T> {
  type Target = T;

  fn deref(&self) -> &Self::Target {
    unsafe { &*self.inner }
  }
}

impl<T> DerefMut for OneShotInstanceRef<T> {
  fn deref_mut(&mut self) -> &mut T {
    unsafe { &mut *self.inner }
  }
}

impl<T> AsRef<T> for OneShotInstanceRef<T> {
  fn as_ref(&self) -> &T {
    unsafe { &*self.inner }
  }
}