Skip to main content

napi_derive_backend/codegen/
struct.rs

1use std::collections::HashMap;
2use std::sync::atomic::{AtomicU32, Ordering};
3
4use proc_macro2::{Ident, Literal, Span, TokenStream};
5use quote::ToTokens;
6
7use crate::util::to_case;
8
9use crate::{
10  codegen::{get_intermediate_ident, js_mod_to_token_stream},
11  BindgenResult, FnKind, NapiImpl, NapiStruct, NapiStructKind, TryToTokens,
12};
13use crate::{NapiArray, NapiClass, NapiObject, NapiStructuredEnum, NapiTransparent};
14
15static NAPI_IMPL_ID: AtomicU32 = AtomicU32::new(0);
16
17const STRUCT_FIELD_SPECIAL_CASE: &[&str] = &["Option", "Result"];
18
19#[cfg(feature = "tracing")]
20fn gen_tracing_debug(class_name: &str, method_name: &str) -> TokenStream {
21  let full_name = format!("{}::{}", class_name, method_name);
22  quote! {
23    napi::bindgen_prelude::tracing::debug!(target: "napi", "{}", #full_name);
24  }
25}
26
27#[cfg(not(feature = "tracing"))]
28fn gen_tracing_debug(_class_name: &str, _method_name: &str) -> TokenStream {
29  quote! {}
30}
31
32// Generate trait implementations for given Struct.
33fn gen_napi_value_map_impl(
34  name: &Ident,
35  to_napi_val_impl: TokenStream,
36  has_lifetime: bool,
37) -> TokenStream {
38  let name_str = name.to_string();
39  let name = if has_lifetime {
40    quote! { #name<'_> }
41  } else {
42    quote! { #name }
43  };
44  let js_name_str = format!("{name_str}\0");
45  let validate = quote! {
46    unsafe fn validate(env: napi::sys::napi_env, napi_val: napi::sys::napi_value) -> napi::Result<napi::sys::napi_value> {
47      if let Some(ctor_ref) = napi::bindgen_prelude::get_class_constructor(#js_name_str) {
48        let mut ctor = std::ptr::null_mut();
49        napi::check_status!(
50          napi::sys::napi_get_reference_value(env, ctor_ref, &mut ctor),
51          "Failed to get constructor reference of class `{}`",
52          #name_str
53        )?;
54        let mut is_instance_of = false;
55        napi::check_status!(
56          napi::sys::napi_instanceof(env, napi_val, ctor, &mut is_instance_of),
57          "Failed to get external value of class `{}`",
58          #name_str
59        )?;
60        if is_instance_of {
61          Ok(std::ptr::null_mut())
62        } else {
63          Err(napi::Error::new(
64            napi::Status::InvalidArg,
65            format!("Value is not instanceof class `{}`", #name_str)
66          ))
67        }
68      } else {
69        Err(napi::Error::new(
70          napi::Status::InvalidArg,
71          format!("Failed to get constructor of class `{}`", #name_str)
72        ))
73      }
74    }
75  };
76  quote! {
77    #[automatically_derived]
78    impl napi::bindgen_prelude::TypeName for #name {
79      fn type_name() -> &'static str {
80        #name_str
81      }
82
83      fn value_type() -> napi::ValueType {
84        napi::ValueType::Function
85      }
86    }
87
88    #[automatically_derived]
89    impl napi::bindgen_prelude::TypeName for &#name {
90      fn type_name() -> &'static str {
91        #name_str
92      }
93
94      fn value_type() -> napi::ValueType {
95        napi::ValueType::Object
96      }
97    }
98
99    #[automatically_derived]
100    impl napi::bindgen_prelude::TypeName for &mut #name {
101      fn type_name() -> &'static str {
102        #name_str
103      }
104
105      fn value_type() -> napi::ValueType {
106        napi::ValueType::Object
107      }
108    }
109
110    #to_napi_val_impl
111
112    #[automatically_derived]
113    impl napi::bindgen_prelude::FromNapiRef for #name {
114      unsafe fn from_napi_ref(
115        env: napi::bindgen_prelude::sys::napi_env,
116        napi_val: napi::bindgen_prelude::sys::napi_value
117      ) -> napi::bindgen_prelude::Result<&'static Self> {
118        let mut wrapped_val: *mut std::ffi::c_void = std::ptr::null_mut();
119
120        napi::bindgen_prelude::check_status!(
121          napi::bindgen_prelude::sys::napi_unwrap(env, napi_val, &mut wrapped_val),
122          "Failed to recover `{}` type from napi value",
123          #name_str,
124        )?;
125
126        Ok(&*(wrapped_val as *const #name))
127      }
128    }
129
130    #[automatically_derived]
131    impl napi::bindgen_prelude::FromNapiMutRef for #name {
132      unsafe fn from_napi_mut_ref(
133        env: napi::bindgen_prelude::sys::napi_env,
134        napi_val: napi::bindgen_prelude::sys::napi_value
135      ) -> napi::bindgen_prelude::Result<&'static mut Self> {
136        let mut wrapped_val: *mut std::ffi::c_void = std::ptr::null_mut();
137
138        napi::bindgen_prelude::check_status!(
139          napi::bindgen_prelude::sys::napi_unwrap(env, napi_val, &mut wrapped_val),
140          "Failed to recover `{}` type from napi value",
141          #name_str,
142        )?;
143
144        Ok(&mut *(wrapped_val as *mut #name))
145      }
146    }
147
148    #[automatically_derived]
149    impl napi::bindgen_prelude::ValidateNapiValue for &#name {
150      #validate
151    }
152
153    #[automatically_derived]
154    impl napi::bindgen_prelude::ValidateNapiValue for &mut #name {
155      #validate
156    }
157  }
158}
159
160impl TryToTokens for NapiStruct {
161  fn try_to_tokens(&self, tokens: &mut TokenStream) -> BindgenResult<()> {
162    let napi_value_map_impl = self.gen_napi_value_map_impl();
163
164    let class_helper_mod = match &self.kind {
165      NapiStructKind::Class(class) => self.gen_helper_mod(class),
166      _ => quote! {},
167    };
168
169    (quote! {
170      #napi_value_map_impl
171      #class_helper_mod
172    })
173    .to_tokens(tokens);
174
175    Ok(())
176  }
177}
178
179impl NapiStruct {
180  fn gen_helper_mod(&self, class: &NapiClass) -> TokenStream {
181    let mod_name = Ident::new(&format!("__napi_helper__{}", self.name), Span::call_site());
182
183    let ctor = if class.ctor {
184      self.gen_default_ctor(class)
185    } else {
186      quote! {}
187    };
188
189    let mut getters_setters = self.gen_default_getters_setters(class);
190    getters_setters.sort_by(|a, b| a.0.cmp(&b.0));
191    let register = self.gen_register(class);
192
193    let getters_setters_token = getters_setters.into_iter().map(|(_, token)| token);
194
195    quote! {
196      #[allow(clippy::all)]
197      #[allow(non_snake_case)]
198      mod #mod_name {
199        use std::ptr;
200        use super::*;
201
202        #ctor
203        #(#getters_setters_token)*
204        #register
205      }
206    }
207  }
208
209  fn gen_default_ctor(&self, class: &NapiClass) -> TokenStream {
210    let name = &self.name;
211    let js_name_str = &self.js_name;
212    let fields_len = class.fields.len();
213    let mut fields = vec![];
214
215    for (i, field) in class.fields.iter().enumerate() {
216      let ty = &field.ty;
217      match &field.name {
218        syn::Member::Named(ident) => fields
219          .push(quote! { #ident: <#ty as napi::bindgen_prelude::FromNapiValue>::from_napi_value(env, cb.get_arg(#i))? }),
220        syn::Member::Unnamed(_) => {
221          fields.push(quote! { <#ty as napi::bindgen_prelude::FromNapiValue>::from_napi_value(env, cb.get_arg(#i))? });
222        }
223      }
224    }
225
226    let construct = if class.is_tuple {
227      quote! { #name (#(#fields),*) }
228    } else {
229      quote! { #name {#(#fields),*} }
230    };
231
232    let is_empty_struct_hint = fields_len == 0;
233
234    let constructor = if class.implement_iterator {
235      quote! { unsafe { cb.construct_generator::<#is_empty_struct_hint, #name>(#js_name_str, #construct) } }
236    } else {
237      quote! { unsafe { cb.construct::<#is_empty_struct_hint, #name>(#js_name_str, #construct) } }
238    };
239
240    let tracing_debug = gen_tracing_debug(js_name_str, "constructor");
241
242    quote! {
243      extern "C" fn constructor(
244        env: napi::bindgen_prelude::sys::napi_env,
245        cb: napi::bindgen_prelude::sys::napi_callback_info
246      ) -> napi::bindgen_prelude::sys::napi_value {
247        #tracing_debug
248        napi::bindgen_prelude::CallbackInfo::<#fields_len>::new(env, cb, None, false)
249          .and_then(|cb| #constructor)
250          .unwrap_or_else(|e| {
251            unsafe { napi::bindgen_prelude::JsError::from(e).throw_into(env) };
252            std::ptr::null_mut::<napi::bindgen_prelude::sys::napi_value__>()
253          })
254      }
255    }
256  }
257
258  fn gen_napi_value_map_impl(&self) -> TokenStream {
259    match &self.kind {
260      NapiStructKind::Array(array) => self.gen_napi_value_array_impl(array),
261      NapiStructKind::Transparent(transparent) => self.gen_napi_value_transparent_impl(transparent),
262      NapiStructKind::Class(class) if !class.ctor => gen_napi_value_map_impl(
263        &self.name,
264        self.gen_to_napi_value_ctor_impl_for_non_default_constructor_struct(class),
265        self.has_lifetime,
266      ),
267      NapiStructKind::Class(class) => gen_napi_value_map_impl(
268        &self.name,
269        self.gen_to_napi_value_ctor_impl(class),
270        self.has_lifetime,
271      ),
272      NapiStructKind::Object(obj) => self.gen_to_napi_value_obj_impl(obj),
273      NapiStructKind::StructuredEnum(structured_enum) => {
274        self.gen_to_napi_value_structured_enum_impl(structured_enum)
275      }
276    }
277  }
278
279  fn gen_to_napi_value_ctor_impl_for_non_default_constructor_struct(
280    &self,
281    class: &NapiClass,
282  ) -> TokenStream {
283    let name = &self.name;
284    let js_name_raw = &self.js_name;
285    let js_name_str = format!("{js_name_raw}\0");
286    let iterator_implementation = self.gen_iterator_property(class, name);
287    let async_iterator_implementation = self.gen_async_iterator_property(class, name);
288    let (object_finalize_impl, to_napi_value_impl, javascript_class_ext_impl) = if self.has_lifetime
289    {
290      let name = quote! { #name<'_javascript_function_scope> };
291      (
292        quote! { impl <'_javascript_function_scope> napi::bindgen_prelude::ObjectFinalize for #name {} },
293        quote! { impl <'_javascript_function_scope> napi::bindgen_prelude::ToNapiValue for #name },
294        quote! { impl <'_javascript_function_scope> napi::bindgen_prelude::JavaScriptClassExt for #name },
295      )
296    } else {
297      (
298        quote! { impl napi::bindgen_prelude::ObjectFinalize for #name {} },
299        quote! { impl napi::bindgen_prelude::ToNapiValue for #name },
300        quote! { impl napi::bindgen_prelude::JavaScriptClassExt for #name },
301      )
302    };
303    let finalize_trait = if class.use_custom_finalize {
304      quote! {}
305    } else {
306      quote! {
307        #[automatically_derived]
308        #object_finalize_impl
309      }
310    };
311    quote! {
312      #[automatically_derived]
313      #to_napi_value_impl {
314        unsafe fn to_napi_value(
315          env: napi::sys::napi_env,
316          val: #name
317        ) -> napi::Result<napi::bindgen_prelude::sys::napi_value> {
318          if let Some(ctor_ref) = napi::__private::get_class_constructor(#js_name_str) {
319            let mut wrapped_value = Box::into_raw(Box::new(val));
320            if wrapped_value as usize == 0x1 {
321              wrapped_value = Box::into_raw(Box::new(0u8)).cast();
322            }
323            let instance_value = napi::bindgen_prelude::new_instance::<#name>(env, wrapped_value.cast(), ctor_ref)?;
324            #iterator_implementation
325            #async_iterator_implementation
326            Ok(instance_value)
327          } else {
328            Err(napi::bindgen_prelude::Error::new(
329              napi::bindgen_prelude::Status::InvalidArg, format!("Failed to get constructor of class `{}` in `ToNapiValue`", #js_name_raw))
330            )
331          }
332        }
333      }
334
335      #finalize_trait
336
337      #[automatically_derived]
338      #javascript_class_ext_impl {
339        fn into_instance<'scope>(self, env: &'scope napi::Env) -> napi::Result<napi::bindgen_prelude::ClassInstance<'scope, Self>>
340         {
341          if let Some(ctor_ref) = napi::bindgen_prelude::get_class_constructor(#js_name_str) {
342            unsafe {
343              let wrapped_value = Box::into_raw(Box::new(self));
344              let instance_value = napi::bindgen_prelude::new_instance::<#name>(env.raw(), wrapped_value as *mut _ as *mut std::ffi::c_void, ctor_ref)?;
345              Ok(napi::bindgen_prelude::ClassInstance::new(instance_value, env.raw(), wrapped_value))
346            }
347          } else {
348            Err(napi::bindgen_prelude::Error::new(
349              napi::bindgen_prelude::Status::InvalidArg, format!("Failed to get constructor of class `{}`", #js_name_raw))
350            )
351          }
352        }
353
354        fn into_reference(self, env: napi::Env) -> napi::Result<napi::bindgen_prelude::Reference<Self>> {
355          if let Some(ctor_ref) = napi::bindgen_prelude::get_class_constructor(#js_name_str) {
356            unsafe {
357              let mut wrapped_value = Box::into_raw(Box::new(self));
358              if wrapped_value as usize == 0x1 {
359                wrapped_value = Box::into_raw(Box::new(0u8)).cast();
360              }
361              let instance_value = napi::bindgen_prelude::new_instance::<#name>(env.raw(), wrapped_value.cast(), ctor_ref)?;
362              {
363                let env = env.raw();
364                #iterator_implementation
365                #async_iterator_implementation
366              }
367              napi::bindgen_prelude::Reference::<#name>::from_value_ptr(wrapped_value.cast(), env.raw())
368            }
369          } else {
370            Err(napi::bindgen_prelude::Error::new(
371              napi::bindgen_prelude::Status::InvalidArg, format!("Failed to get constructor of class `{}`", #js_name_raw))
372            )
373          }
374        }
375
376        fn instance_of<'env, V: napi::JsValue<'env>>(env: &napi::bindgen_prelude::Env, value: &V) -> napi::bindgen_prelude::Result<bool> {
377          if let Some(ctor_ref) = napi::bindgen_prelude::get_class_constructor(#js_name_str) {
378            let mut ctor = std::ptr::null_mut();
379            napi::check_status!(
380              unsafe { napi::sys::napi_get_reference_value(env.raw(), ctor_ref, &mut ctor) },
381              "Failed to get constructor reference of class `{}`",
382              #js_name_str
383            )?;
384            let mut is_instance_of = false;
385            napi::check_status!(
386              unsafe { napi::sys::napi_instanceof(env.raw(), value.value().value, ctor, &mut is_instance_of) },
387              "Failed to run instanceof for class `{}`",
388              #js_name_str
389            )?;
390            Ok(is_instance_of)
391          } else {
392            Err(napi::Error::new(napi::Status::GenericFailure, format!("Failed to get constructor of class `{}`", #js_name_str)))
393          }
394        }
395      }
396    }
397  }
398
399  fn gen_iterator_property(&self, class: &NapiClass, name: &Ident) -> TokenStream {
400    if !class.implement_iterator {
401      return quote! {};
402    }
403    quote! {
404      unsafe { napi::__private::create_iterator::<#name>(env, instance_value, wrapped_value); }
405    }
406  }
407
408  fn gen_async_iterator_property(&self, class: &NapiClass, name: &Ident) -> TokenStream {
409    if !class.implement_async_iterator {
410      return quote! {};
411    }
412    // Note: `create_async_iterator` is NOT unsafe, unlike `create_iterator`.
413    // `create_iterator` is unsafe because `ScopedGenerator<'a>` has a lifetime parameter,
414    // requiring the caller to uphold lifetime invariants. `create_async_iterator` uses
415    // `AsyncGenerator` whose Future must be `Send + 'static`, so all data is owned and
416    // no lifetime invariants need to be upheld by the caller.
417    quote! {
418      napi::__private::create_async_iterator::<#name>(env, instance_value, wrapped_value);
419    }
420  }
421
422  fn gen_to_napi_value_ctor_impl(&self, class: &NapiClass) -> TokenStream {
423    let name = &self.name;
424    let js_name_without_null = &self.js_name;
425    let js_name_str = format!("{}\0", &self.js_name);
426
427    let mut field_conversions = vec![];
428    let mut field_destructions = vec![];
429
430    for field in class.fields.iter() {
431      let ty = &field.ty;
432
433      match &field.name {
434        syn::Member::Named(ident) => {
435          // alias here prevents field name shadowing
436          let alias_ident = format_ident!("{}_", ident);
437          field_destructions.push(quote! { #ident: #alias_ident });
438          field_conversions.push(
439            quote! { <#ty as napi::bindgen_prelude::ToNapiValue>::to_napi_value(env, #alias_ident)? },
440          );
441        }
442        syn::Member::Unnamed(i) => {
443          let arg_name = format_ident!("arg{}", i);
444          field_destructions.push(quote! { #arg_name });
445          field_conversions.push(
446            quote! { <#ty as napi::bindgen_prelude::ToNapiValue>::to_napi_value(env, #arg_name)? },
447          );
448        }
449      }
450    }
451
452    let destructed_fields = if class.is_tuple {
453      quote! {
454        Self (#(#field_destructions),*)
455      }
456    } else {
457      quote! {
458        Self {#(#field_destructions),*}
459      }
460    };
461
462    let finalize_trait = if class.use_custom_finalize {
463      quote! {}
464    } else if self.has_lifetime {
465      quote! { impl <'_javascript_function_scope> napi::bindgen_prelude::ObjectFinalize for #name<'_javascript_function_scope> {} }
466    } else {
467      quote! { impl napi::bindgen_prelude::ObjectFinalize for #name {} }
468    };
469
470    let to_napi_value_impl = if self.has_lifetime {
471      quote! { impl <'_javascript_function_scope> napi::bindgen_prelude::ToNapiValue for #name<'_javascript_function_scope> }
472    } else {
473      quote! { impl napi::bindgen_prelude::ToNapiValue for #name }
474    };
475
476    quote! {
477      #[automatically_derived]
478      #to_napi_value_impl {
479        unsafe fn to_napi_value(
480          env: napi::bindgen_prelude::sys::napi_env,
481          val: #name,
482        ) -> napi::bindgen_prelude::Result<napi::bindgen_prelude::sys::napi_value> {
483          if let Some(ctor_ref) = napi::bindgen_prelude::get_class_constructor(#js_name_str) {
484            let mut ctor = std::ptr::null_mut();
485
486            napi::bindgen_prelude::check_status!(
487              napi::bindgen_prelude::sys::napi_get_reference_value(env, ctor_ref, &mut ctor),
488              "Failed to get constructor reference of class `{}`",
489              #js_name_without_null
490            )?;
491
492            let mut instance_value = std::ptr::null_mut();
493            let #destructed_fields = val;
494            let args = vec![#(#field_conversions),*];
495
496            napi::bindgen_prelude::check_status!(
497              napi::bindgen_prelude::sys::napi_new_instance(env, ctor, args.len(), args.as_ptr(), &mut instance_value),
498              "Failed to construct class `{}`",
499              #js_name_without_null
500            )?;
501
502            Ok(instance_value)
503          } else {
504            Err(napi::bindgen_prelude::Error::new(
505              napi::bindgen_prelude::Status::InvalidArg, format!("Failed to get constructor of class `{}`", #js_name_str))
506            )
507          }
508        }
509      }
510      #finalize_trait
511    }
512  }
513
514  fn gen_to_napi_value_obj_impl(&self, obj: &NapiObject) -> TokenStream {
515    let name = &self.name;
516    let name_str = self.name.to_string();
517
518    let mut obj_field_getters = vec![];
519    let mut field_destructions = vec![];
520
521    // For optimized object creation: separate always-set fields from conditionally-set fields
522    let mut value_conversions = vec![];
523    let mut property_descriptors = vec![];
524    let mut conditional_setters = vec![];
525    let mut value_names = vec![];
526
527    for (idx, field) in obj.fields.iter().enumerate() {
528      let field_js_name = &field.js_name;
529      let field_js_name_lit = Literal::string(&format!("{}\0", field.js_name));
530      let mut ty = field.ty.clone();
531      remove_lifetime_in_type(&mut ty);
532      let is_optional_field = if let syn::Type::Path(syn::TypePath {
533        path: syn::Path { segments, .. },
534        ..
535      }) = &ty
536      {
537        if let Some(last_path) = segments.last() {
538          last_path.ident == "Option"
539        } else {
540          false
541        }
542      } else {
543        false
544      };
545
546      // Determine if this field is always set or conditionally set
547      let is_always_set = !is_optional_field || self.use_nullable;
548
549      match &field.name {
550        syn::Member::Named(ident) => {
551          let alias_ident = format_ident!("{}_", ident);
552          field_destructions.push(quote! { #ident: #alias_ident });
553
554          if is_always_set {
555            // This field is always set - use batched approach
556            let value_var = Ident::new(&format!("__obj_value_{}", idx), Span::call_site());
557            value_names.push(value_var.clone());
558
559            if is_optional_field {
560              // Optional with use_nullable=true: set to value or null
561              value_conversions.push(quote! {
562                let #value_var = if let Some(inner) = #alias_ident {
563                  napi::bindgen_prelude::ToNapiValue::to_napi_value(env, inner)?
564                } else {
565                  napi::bindgen_prelude::ToNapiValue::to_napi_value(env, napi::bindgen_prelude::Null)?
566                };
567              });
568            } else {
569              // Non-optional: always set
570              value_conversions.push(quote! {
571                let #value_var = napi::bindgen_prelude::ToNapiValue::to_napi_value(env, #alias_ident)?;
572              });
573            }
574
575            property_descriptors.push(quote! {
576              napi::bindgen_prelude::sys::napi_property_descriptor {
577                utf8name: std::ffi::CStr::from_bytes_with_nul_unchecked(#field_js_name_lit.as_bytes()).as_ptr(),
578                name: std::ptr::null_mut(),
579                method: None,
580                getter: None,
581                setter: None,
582                value: #value_var,
583                attributes: napi::bindgen_prelude::sys::PropertyAttributes::writable
584                  | napi::bindgen_prelude::sys::PropertyAttributes::enumerable
585                  | napi::bindgen_prelude::sys::PropertyAttributes::configurable,
586                data: std::ptr::null_mut(),
587              }
588            });
589          } else {
590            // Optional with use_nullable=false: conditionally set
591            conditional_setters.push(quote! {
592              if #alias_ident.is_some() {
593                obj.set(#field_js_name, #alias_ident)?;
594              }
595            });
596          }
597
598          // Getters remain the same
599          if is_optional_field && !self.use_nullable {
600            obj_field_getters.push(quote! {
601              let #alias_ident: #ty = obj.get(#field_js_name).map_err(|mut err| {
602                err.reason = format!("{} on {}.{}", err.reason, #name_str, #field_js_name);
603                err
604              })?;
605            });
606          } else {
607            obj_field_getters.push(quote! {
608              let #alias_ident: #ty = obj.get(#field_js_name).map_err(|mut err| {
609                err.reason = format!("{} on {}.{}", err.reason, #name_str, #field_js_name);
610                err
611              })?.ok_or_else(|| napi::bindgen_prelude::Error::new(
612                napi::bindgen_prelude::Status::InvalidArg,
613                format!("Missing field `{}`", #field_js_name),
614              ))?;
615            });
616          }
617        }
618        syn::Member::Unnamed(i) => {
619          let arg_name = format_ident!("arg{}", i);
620          field_destructions.push(quote! { #arg_name });
621
622          if is_always_set {
623            // This field is always set - use batched approach
624            let value_var = Ident::new(&format!("__obj_value_{}", idx), Span::call_site());
625            value_names.push(value_var.clone());
626
627            if is_optional_field {
628              // Optional with use_nullable=true: set to value or null
629              value_conversions.push(quote! {
630                let #value_var = if let Some(inner) = #arg_name {
631                  napi::bindgen_prelude::ToNapiValue::to_napi_value(env, inner)?
632                } else {
633                  napi::bindgen_prelude::ToNapiValue::to_napi_value(env, napi::bindgen_prelude::Null)?
634                };
635              });
636            } else {
637              // Non-optional: always set
638              value_conversions.push(quote! {
639                let #value_var = napi::bindgen_prelude::ToNapiValue::to_napi_value(env, #arg_name)?;
640              });
641            }
642
643            property_descriptors.push(quote! {
644              napi::bindgen_prelude::sys::napi_property_descriptor {
645                utf8name: std::ffi::CStr::from_bytes_with_nul_unchecked(#field_js_name_lit.as_bytes()).as_ptr(),
646                name: std::ptr::null_mut(),
647                method: None,
648                getter: None,
649                setter: None,
650                value: #value_var,
651                attributes: napi::bindgen_prelude::sys::PropertyAttributes::writable
652                  | napi::bindgen_prelude::sys::PropertyAttributes::enumerable
653                  | napi::bindgen_prelude::sys::PropertyAttributes::configurable,
654                data: std::ptr::null_mut(),
655              }
656            });
657          } else {
658            // Optional with use_nullable=false: conditionally set
659            conditional_setters.push(quote! {
660              if #arg_name.is_some() {
661                obj.set(#field_js_name, #arg_name)?;
662              }
663            });
664          }
665
666          // Getters remain the same
667          if is_optional_field && !self.use_nullable {
668            obj_field_getters.push(quote! { let #arg_name: #ty = obj.get(#field_js_name)?; });
669          } else {
670            obj_field_getters.push(quote! {
671              let #arg_name: #ty = obj.get(#field_js_name)?.ok_or_else(|| napi::bindgen_prelude::Error::new(
672                napi::bindgen_prelude::Status::InvalidArg,
673                format!("Missing field `{}`", #field_js_name),
674              ))?;
675            });
676          }
677        }
678      }
679    }
680
681    let destructed_fields = if obj.is_tuple {
682      quote! {
683        Self (#(#field_destructions),*)
684      }
685    } else {
686      quote! {
687        Self {#(#field_destructions),*}
688      }
689    };
690
691    let name_with_lifetime = if self.has_lifetime {
692      quote! { #name<'_javascript_function_scope> }
693    } else {
694      quote! { #name }
695    };
696    let (from_napi_value_impl, to_napi_value_impl, validate_napi_value_impl, type_name_impl) =
697      if self.has_lifetime {
698        (
699          quote! { impl <'_javascript_function_scope> napi::bindgen_prelude::FromNapiValue for #name<'_javascript_function_scope> },
700          quote! { impl <'_javascript_function_scope> napi::bindgen_prelude::ToNapiValue for #name<'_javascript_function_scope> },
701          quote! { impl <'_javascript_function_scope> napi::bindgen_prelude::ValidateNapiValue for #name<'_javascript_function_scope> },
702          quote! { impl <'_javascript_function_scope> napi::bindgen_prelude::TypeName for #name<'_javascript_function_scope> },
703        )
704      } else {
705        (
706          quote! { impl napi::bindgen_prelude::FromNapiValue for #name },
707          quote! { impl napi::bindgen_prelude::ToNapiValue for #name },
708          quote! { impl napi::bindgen_prelude::ValidateNapiValue for #name },
709          quote! { impl napi::bindgen_prelude::TypeName for #name },
710        )
711      };
712
713    // Generate object creation code
714    let object_creation = if conditional_setters.is_empty() {
715      // All fields are always set - use fully batched approach
716      quote! {
717        // Convert all values first, so error handling works correctly
718        #(#value_conversions)*
719
720        let properties = [
721          #(#property_descriptors),*
722        ];
723
724        let obj_ptr = napi::bindgen_prelude::create_object_with_properties(env, &properties)?;
725        Ok(obj_ptr)
726      }
727    } else {
728      // Some fields are conditionally set - use batched for always-set, then add conditionals
729      quote! {
730        // Convert all always-set values first
731        #(#value_conversions)*
732
733        let properties = [
734          #(#property_descriptors),*
735        ];
736
737        let obj_ptr = napi::bindgen_prelude::create_object_with_properties(env, &properties)?;
738
739        // Wrap in Object for conditional field setters
740        let mut obj = napi::bindgen_prelude::Object::from_raw(env, obj_ptr);
741
742        #(#conditional_setters)*
743
744        Ok(obj_ptr)
745      }
746    };
747
748    let to_napi_value = if obj.object_to_js {
749      quote! {
750        #[automatically_derived]
751        #to_napi_value_impl {
752          unsafe fn to_napi_value(env: napi::bindgen_prelude::sys::napi_env, val: #name_with_lifetime) -> napi::bindgen_prelude::Result<napi::bindgen_prelude::sys::napi_value> {
753            let #destructed_fields = val;
754            #object_creation
755          }
756        }
757      }
758    } else {
759      quote! {}
760    };
761
762    let from_napi_value = if obj.object_from_js {
763      let return_type = if self.has_lifetime {
764        quote! { #name<'_javascript_function_scope> }
765      } else {
766        quote! { #name }
767      };
768      quote! {
769        #[automatically_derived]
770        #from_napi_value_impl {
771          unsafe fn from_napi_value(
772            env: napi::bindgen_prelude::sys::napi_env,
773            napi_val: napi::bindgen_prelude::sys::napi_value
774          ) -> napi::bindgen_prelude::Result<#return_type> {
775            #[allow(unused_variables)]
776            let env_wrapper = napi::bindgen_prelude::Env::from(env);
777            #[allow(unused_mut)]
778            let mut obj = napi::bindgen_prelude::Object::from_napi_value(env, napi_val)?;
779
780            #(#obj_field_getters)*
781
782            let val = #destructed_fields;
783
784            Ok(val)
785          }
786        }
787
788        #[automatically_derived]
789        #validate_napi_value_impl {}
790      }
791    } else {
792      quote! {}
793    };
794
795    quote! {
796      #[automatically_derived]
797      #type_name_impl {
798        fn type_name() -> &'static str {
799          #name_str
800        }
801
802        fn value_type() -> napi::ValueType {
803          napi::ValueType::Object
804        }
805      }
806
807      #to_napi_value
808
809      #from_napi_value
810    }
811  }
812
813  fn gen_default_getters_setters(&self, class: &NapiClass) -> Vec<(String, TokenStream)> {
814    let mut getters_setters = vec![];
815    let struct_name = &self.name;
816    let js_name_str = &self.js_name;
817
818    for field in class.fields.iter() {
819      let field_ident = &field.name;
820      let field_name = match &field.name {
821        syn::Member::Named(ident) => ident.to_string(),
822        syn::Member::Unnamed(i) => format!("field{}", i.index),
823      };
824      let ty = &field.ty;
825
826      let getter_name = Ident::new(
827        &format!("get_{}", rm_raw_prefix(&field_name)),
828        Span::call_site(),
829      );
830      let setter_name = Ident::new(
831        &format!("set_{}", rm_raw_prefix(&field_name)),
832        Span::call_site(),
833      );
834
835      if field.getter {
836        let default_to_napi_value_convert = quote! {
837          let val = &mut obj.#field_ident;
838          unsafe { <&mut #ty as napi::bindgen_prelude::ToNapiValue>::to_napi_value(env, val) }
839        };
840        let to_napi_value_convert = if let syn::Type::Path(syn::TypePath {
841          path: syn::Path { segments, .. },
842          ..
843        }) = ty
844        {
845          if let Some(syn::PathSegment { ident, .. }) = segments.last() {
846            if STRUCT_FIELD_SPECIAL_CASE.iter().any(|name| ident == name) {
847              quote! {
848                let val = obj.#field_ident.as_mut();
849                unsafe { napi::bindgen_prelude::ToNapiValue::to_napi_value(env, val) }
850              }
851            } else {
852              default_to_napi_value_convert
853            }
854          } else {
855            default_to_napi_value_convert
856          }
857        } else {
858          default_to_napi_value_convert
859        };
860        let tracing_debug = gen_tracing_debug(js_name_str, &field.js_name);
861        getters_setters.push((
862          field.js_name.clone(),
863          quote! {
864            extern "C" fn #getter_name(
865              env: napi::bindgen_prelude::sys::napi_env,
866              cb: napi::bindgen_prelude::sys::napi_callback_info
867            ) -> napi::bindgen_prelude::sys::napi_value {
868              #tracing_debug
869              napi::bindgen_prelude::CallbackInfo::<0>::new(env, cb, Some(0), false)
870                .and_then(|mut cb| cb.unwrap_borrow_mut::<#struct_name>())
871                .and_then(|obj| {
872                  #to_napi_value_convert
873                })
874                .unwrap_or_else(|e| {
875                  unsafe { napi::bindgen_prelude::JsError::from(e).throw_into(env) };
876                  std::ptr::null_mut::<napi::bindgen_prelude::sys::napi_value__>()
877                })
878            }
879          },
880        ));
881      }
882
883      if field.setter {
884        let setter_tracing_debug =
885          gen_tracing_debug(js_name_str, &format!("set_{}", field.js_name));
886        getters_setters.push((
887          field.js_name.clone(),
888          quote! {
889            extern "C" fn #setter_name(
890              env: napi::bindgen_prelude::sys::napi_env,
891              cb: napi::bindgen_prelude::sys::napi_callback_info
892            ) -> napi::bindgen_prelude::sys::napi_value {
893              #setter_tracing_debug
894              napi::bindgen_prelude::CallbackInfo::<1>::new(env, cb, Some(1), false)
895                .and_then(|mut cb_info| unsafe {
896                  cb_info.unwrap_borrow_mut::<#struct_name>()
897                    .and_then(|obj| {
898                      <#ty as napi::bindgen_prelude::FromNapiValue>::from_napi_value(env, cb_info.get_arg(0))
899                        .and_then(move |val| {
900                          obj.#field_ident = val;
901                          <() as napi::bindgen_prelude::ToNapiValue>::to_napi_value(env, ())
902                        })
903                    })
904                })
905                .unwrap_or_else(|e| {
906                  unsafe { napi::bindgen_prelude::JsError::from(e).throw_into(env) };
907                  std::ptr::null_mut::<napi::bindgen_prelude::sys::napi_value__>()
908                })
909            }
910          },
911        ));
912      }
913    }
914
915    getters_setters
916  }
917
918  fn gen_register(&self, class: &NapiClass) -> TokenStream {
919    let name = &self.name;
920    let struct_register_name = &self.register_name;
921    let js_name = format!("{}\0", self.js_name);
922    let mut props = vec![];
923
924    if class.ctor {
925      props.push(quote! { napi::bindgen_prelude::Property::new().with_utf8_name("constructor").unwrap().with_ctor(constructor) });
926    }
927
928    for field in class.fields.iter() {
929      let field_name = match &field.name {
930        syn::Member::Named(ident) => ident.to_string(),
931        syn::Member::Unnamed(i) => format!("field{}", i.index),
932      };
933
934      if !field.getter {
935        continue;
936      }
937
938      let js_name = &field.js_name;
939      let mut attribute = super::PROPERTY_ATTRIBUTE_DEFAULT;
940      if field.writable {
941        attribute |= super::PROPERTY_ATTRIBUTE_WRITABLE;
942      }
943      if field.enumerable {
944        attribute |= super::PROPERTY_ATTRIBUTE_ENUMERABLE;
945      }
946      if field.configurable {
947        attribute |= super::PROPERTY_ATTRIBUTE_CONFIGURABLE;
948      }
949
950      let mut prop = quote! {
951        napi::bindgen_prelude::Property::new().with_utf8_name(#js_name)
952          .unwrap()
953          .with_property_attributes(napi::bindgen_prelude::PropertyAttributes::from_bits(#attribute).unwrap())
954      };
955
956      if field.getter {
957        let getter_name = Ident::new(
958          &format!("get_{}", rm_raw_prefix(&field_name)),
959          Span::call_site(),
960        );
961        (quote! { .with_getter(#getter_name) }).to_tokens(&mut prop);
962      }
963
964      if field.writable && field.setter {
965        let setter_name = Ident::new(
966          &format!("set_{}", rm_raw_prefix(&field_name)),
967          Span::call_site(),
968        );
969        (quote! { .with_setter(#setter_name) }).to_tokens(&mut prop);
970      }
971
972      props.push(prop);
973    }
974    let js_mod_ident = js_mod_to_token_stream(self.js_mod.as_ref());
975    quote! {
976      #[allow(non_snake_case)]
977      #[allow(clippy::all)]
978      #[cfg(all(not(test), not(target_family = "wasm")))]
979      #[napi::ctor::ctor(crate_path=napi::ctor)]
980      fn #struct_register_name() {
981        napi::__private::register_class(std::any::TypeId::of::<#name>(), #js_mod_ident, #js_name, vec![#(#props),*]);
982      }
983
984      #[allow(non_snake_case)]
985      #[allow(clippy::all)]
986      #[cfg(all(not(test), target_family = "wasm"))]
987      #[no_mangle]
988      extern "C" fn #struct_register_name() {
989        napi::__private::register_class(std::any::TypeId::of::<#name>(), #js_mod_ident, #js_name, vec![#(#props),*]);
990      }
991    }
992  }
993
994  fn gen_to_napi_value_structured_enum_impl(
995    &self,
996    structured_enum: &NapiStructuredEnum,
997  ) -> TokenStream {
998    let name = &self.name;
999    let name_str = self.name.to_string();
1000    let discriminant = structured_enum.discriminant.as_str();
1001    let discriminant_null_terminated = format!("{}\0", discriminant);
1002
1003    let mut variant_arm_setters = vec![];
1004    let mut variant_arm_getters = vec![];
1005
1006    for variant in structured_enum.variants.iter() {
1007      let variant_name = &variant.name;
1008      let mut variant_name_str = variant_name.to_string();
1009      if let Some(case) = structured_enum.discriminant_case {
1010        variant_name_str = to_case(variant_name_str, case);
1011      }
1012
1013      let mut obj_field_getters = vec![];
1014      let mut field_destructions = vec![];
1015
1016      // For optimized object creation
1017      let mut value_conversions = vec![];
1018      let mut property_descriptors = vec![];
1019      let mut conditional_setters = vec![];
1020
1021      // First property is always the discriminant
1022      let discriminant_value_var = Ident::new("__discriminant_value", Span::call_site());
1023      value_conversions.push(quote! {
1024        let #discriminant_value_var = napi::bindgen_prelude::ToNapiValue::to_napi_value(env, #variant_name_str)?;
1025      });
1026      property_descriptors.push(quote! {
1027        napi::bindgen_prelude::sys::napi_property_descriptor {
1028          utf8name: std::ffi::CStr::from_bytes_with_nul_unchecked(#discriminant_null_terminated.as_bytes()).as_ptr(),
1029          name: std::ptr::null_mut(),
1030          method: None,
1031          getter: None,
1032          setter: None,
1033          value: #discriminant_value_var,
1034          attributes: napi::bindgen_prelude::sys::PropertyAttributes::writable
1035                  | napi::bindgen_prelude::sys::PropertyAttributes::enumerable
1036                  | napi::bindgen_prelude::sys::PropertyAttributes::configurable,
1037          data: std::ptr::null_mut(),
1038        }
1039      });
1040
1041      for (idx, field) in variant.fields.iter().enumerate() {
1042        let field_js_name = &field.js_name;
1043        let field_js_name_lit = Literal::string(&format!("{}\0", field.js_name));
1044        let mut ty = field.ty.clone();
1045        remove_lifetime_in_type(&mut ty);
1046        let is_optional_field = if let syn::Type::Path(syn::TypePath {
1047          path: syn::Path { segments, .. },
1048          ..
1049        }) = &ty
1050        {
1051          if let Some(last_path) = segments.last() {
1052            last_path.ident == "Option"
1053          } else {
1054            false
1055          }
1056        } else {
1057          false
1058        };
1059
1060        // Determine if this field is always set or conditionally set
1061        let is_always_set = !is_optional_field || self.use_nullable;
1062
1063        match &field.name {
1064          syn::Member::Named(ident) => {
1065            let alias_ident = format_ident!("{}_", ident);
1066            field_destructions.push(quote! { #ident: #alias_ident });
1067
1068            if is_always_set {
1069              // This field is always set - use batched approach
1070              let value_var = Ident::new(&format!("__variant_value_{}", idx), Span::call_site());
1071
1072              if is_optional_field {
1073                // Optional with use_nullable=true: set to value or null
1074                value_conversions.push(quote! {
1075                  let #value_var = if let Some(inner) = #alias_ident {
1076                    napi::bindgen_prelude::ToNapiValue::to_napi_value(env, inner)?
1077                  } else {
1078                    napi::bindgen_prelude::ToNapiValue::to_napi_value(env, napi::bindgen_prelude::Null)?
1079                  };
1080                });
1081              } else {
1082                // Non-optional: always set
1083                value_conversions.push(quote! {
1084                  let #value_var = napi::bindgen_prelude::ToNapiValue::to_napi_value(env, #alias_ident)?;
1085                });
1086              }
1087
1088              property_descriptors.push(quote! {
1089                napi::bindgen_prelude::sys::napi_property_descriptor {
1090                  utf8name: std::ffi::CStr::from_bytes_with_nul_unchecked(#field_js_name_lit.as_bytes()).as_ptr(),
1091                  name: std::ptr::null_mut(),
1092                  method: None,
1093                  getter: None,
1094                  setter: None,
1095                  value: #value_var,
1096                  attributes: napi::bindgen_prelude::sys::PropertyAttributes::writable
1097                  | napi::bindgen_prelude::sys::PropertyAttributes::enumerable
1098                  | napi::bindgen_prelude::sys::PropertyAttributes::configurable,
1099                  data: std::ptr::null_mut(),
1100                }
1101              });
1102            } else {
1103              // Optional with use_nullable=false: conditionally set
1104              conditional_setters.push(quote! {
1105                if #alias_ident.is_some() {
1106                  obj.set(#field_js_name, #alias_ident)?;
1107                }
1108              });
1109            }
1110
1111            // Getters remain the same
1112            if is_optional_field && !self.use_nullable {
1113              obj_field_getters.push(quote! {
1114                let #alias_ident: #ty = obj.get(#field_js_name).map_err(|mut err| {
1115                  err.reason = format!("{} on {}.{}", err.reason, #name_str, #field_js_name);
1116                  err
1117                })?;
1118              });
1119            } else {
1120              obj_field_getters.push(quote! {
1121                let #alias_ident: #ty = obj.get(#field_js_name).map_err(|mut err| {
1122                  err.reason = format!("{} on {}.{}", err.reason, #name_str, #field_js_name);
1123                  err
1124                })?.ok_or_else(|| napi::bindgen_prelude::Error::new(
1125                  napi::bindgen_prelude::Status::InvalidArg,
1126                  format!("Missing field `{}`", #field_js_name),
1127                ))?;
1128              });
1129            }
1130          }
1131          syn::Member::Unnamed(i) => {
1132            let arg_name = format_ident!("arg{}", i);
1133            field_destructions.push(quote! { #arg_name });
1134
1135            if is_always_set {
1136              // This field is always set - use batched approach
1137              let value_var = Ident::new(&format!("__variant_value_{}", idx), Span::call_site());
1138
1139              if is_optional_field {
1140                // Optional with use_nullable=true: set to value or null
1141                value_conversions.push(quote! {
1142                  let #value_var = if let Some(inner) = #arg_name {
1143                    napi::bindgen_prelude::ToNapiValue::to_napi_value(env, inner)?
1144                  } else {
1145                    napi::bindgen_prelude::ToNapiValue::to_napi_value(env, napi::bindgen_prelude::Null)?
1146                  };
1147                });
1148              } else {
1149                // Non-optional: always set
1150                value_conversions.push(quote! {
1151                  let #value_var = napi::bindgen_prelude::ToNapiValue::to_napi_value(env, #arg_name)?;
1152                });
1153              }
1154
1155              property_descriptors.push(quote! {
1156                napi::bindgen_prelude::sys::napi_property_descriptor {
1157                  utf8name: std::ffi::CStr::from_bytes_with_nul_unchecked(#field_js_name_lit.as_bytes()).as_ptr(),
1158                  name: std::ptr::null_mut(),
1159                  method: None,
1160                  getter: None,
1161                  setter: None,
1162                  value: #value_var,
1163                  attributes: napi::bindgen_prelude::sys::PropertyAttributes::writable
1164                  | napi::bindgen_prelude::sys::PropertyAttributes::enumerable
1165                  | napi::bindgen_prelude::sys::PropertyAttributes::configurable,
1166                  data: std::ptr::null_mut(),
1167                }
1168              });
1169            } else {
1170              // Optional with use_nullable=false: conditionally set
1171              conditional_setters.push(quote! {
1172                if #arg_name.is_some() {
1173                  obj.set(#field_js_name, #arg_name)?;
1174                }
1175              });
1176            }
1177
1178            // Getters remain the same
1179            if is_optional_field && !self.use_nullable {
1180              obj_field_getters.push(quote! { let #arg_name: #ty = obj.get(#field_js_name)?; });
1181            } else {
1182              obj_field_getters.push(quote! {
1183                let #arg_name: #ty = obj.get(#field_js_name)?.ok_or_else(|| napi::bindgen_prelude::Error::new(
1184                  napi::bindgen_prelude::Status::InvalidArg,
1185                  format!("Missing field `{}`", #field_js_name),
1186                ))?;
1187              });
1188            }
1189          }
1190        }
1191      }
1192
1193      let destructed_fields = if variant.is_tuple {
1194        quote! {
1195          Self::#variant_name (#(#field_destructions),*)
1196        }
1197      } else {
1198        quote! {
1199          Self::#variant_name {#(#field_destructions),*}
1200        }
1201      };
1202
1203      // Generate object creation for this variant
1204      let variant_object_creation = if conditional_setters.is_empty() {
1205        // All fields are always set - use fully batched approach
1206        quote! {
1207          #(#value_conversions)*
1208
1209          let properties = [
1210            #(#property_descriptors),*
1211          ];
1212
1213          napi::bindgen_prelude::create_object_with_properties(env, &properties)
1214        }
1215      } else {
1216        // Some fields are conditionally set
1217        quote! {
1218          #(#value_conversions)*
1219
1220          let properties = [
1221            #(#property_descriptors),*
1222          ];
1223
1224          let obj_ptr = napi::bindgen_prelude::create_object_with_properties(env, &properties)?;
1225          let mut obj = napi::bindgen_prelude::Object::from_raw(env, obj_ptr);
1226
1227          #(#conditional_setters)*
1228
1229          Ok(obj_ptr)
1230        }
1231      };
1232
1233      variant_arm_setters.push(quote! {
1234        #destructed_fields => {
1235          #variant_object_creation
1236        },
1237      });
1238
1239      variant_arm_getters.push(quote! {
1240        #variant_name_str => {
1241          #(#obj_field_getters)*
1242          #destructed_fields
1243        },
1244      })
1245    }
1246
1247    let to_napi_value = if structured_enum.object_to_js {
1248      quote! {
1249        impl napi::bindgen_prelude::ToNapiValue for #name {
1250          unsafe fn to_napi_value(env: napi::bindgen_prelude::sys::napi_env, val: #name) -> napi::bindgen_prelude::Result<napi::bindgen_prelude::sys::napi_value> {
1251            match val {
1252              #(#variant_arm_setters)*
1253            }
1254          }
1255        }
1256      }
1257    } else {
1258      quote! {}
1259    };
1260
1261    let from_napi_value = if structured_enum.object_from_js {
1262      quote! {
1263        impl napi::bindgen_prelude::FromNapiValue for #name {
1264          unsafe fn from_napi_value(
1265            env: napi::bindgen_prelude::sys::napi_env,
1266            napi_val: napi::bindgen_prelude::sys::napi_value
1267          ) -> napi::bindgen_prelude::Result<Self> {
1268            #[allow(unused_variables)]
1269            let env_wrapper = napi::bindgen_prelude::Env::from(env);
1270            #[allow(unused_mut)]
1271            let mut obj = napi::bindgen_prelude::Object::from_napi_value(env, napi_val)?;
1272            let type_: String = obj.get(#discriminant).map_err(|mut err| {
1273              err.reason = format!("{} on {}.{}", err.reason, #name_str, #discriminant);
1274              err
1275            })?.ok_or_else(|| napi::bindgen_prelude::Error::new(
1276              napi::bindgen_prelude::Status::InvalidArg,
1277              format!("Missing field `{}`", #discriminant),
1278            ))?;
1279            let val = match type_.as_str() {
1280              #(#variant_arm_getters)*
1281              _ => return Err(napi::bindgen_prelude::Error::new(
1282                napi::bindgen_prelude::Status::InvalidArg,
1283                format!("Unknown variant `{}`", type_),
1284              )),
1285            };
1286
1287            Ok(val)
1288          }
1289        }
1290
1291        impl napi::bindgen_prelude::ValidateNapiValue for #name {}
1292      }
1293    } else {
1294      quote! {}
1295    };
1296
1297    quote! {
1298      impl napi::bindgen_prelude::TypeName for #name {
1299        fn type_name() -> &'static str {
1300          #name_str
1301        }
1302
1303        fn value_type() -> napi::ValueType {
1304          napi::ValueType::Object
1305        }
1306      }
1307
1308      #to_napi_value
1309
1310      #from_napi_value
1311    }
1312  }
1313
1314  fn gen_napi_value_transparent_impl(&self, transparent: &NapiTransparent) -> TokenStream {
1315    let name = &self.name;
1316    let name = if self.has_lifetime {
1317      quote! { #name<'_> }
1318    } else {
1319      quote! { #name }
1320    };
1321    let inner_type = transparent.ty.clone().into_token_stream();
1322
1323    let to_napi_value = if transparent.object_to_js {
1324      quote! {
1325        #[automatically_derived]
1326        impl napi::bindgen_prelude::ToNapiValue for #name {
1327          unsafe fn to_napi_value(
1328            env: napi::bindgen_prelude::sys::napi_env,
1329            val: Self
1330          ) -> napi::bindgen_prelude::Result<napi::bindgen_prelude::sys::napi_value> {
1331            <#inner_type>::to_napi_value(env, val.0)
1332          }
1333        }
1334      }
1335    } else {
1336      quote! {}
1337    };
1338
1339    let from_napi_value = if transparent.object_from_js {
1340      quote! {
1341        #[automatically_derived]
1342        impl napi::bindgen_prelude::FromNapiValue for #name {
1343          unsafe fn from_napi_value(
1344            env: napi::bindgen_prelude::sys::napi_env,
1345            napi_val: napi::bindgen_prelude::sys::napi_value
1346          ) -> napi::bindgen_prelude::Result<Self> {
1347            Ok(Self(<#inner_type>::from_napi_value(env, napi_val)?))
1348          }
1349        }
1350      }
1351    } else {
1352      quote! {}
1353    };
1354
1355    quote! {
1356      #[automatically_derived]
1357      impl napi::bindgen_prelude::TypeName for #name {
1358        fn type_name() -> &'static str {
1359          <#inner_type>::type_name()
1360        }
1361
1362        fn value_type() -> napi::ValueType {
1363          <#inner_type>::value_type()
1364        }
1365      }
1366
1367      #[automatically_derived]
1368      impl napi::bindgen_prelude::ValidateNapiValue for #name {
1369        unsafe fn validate(
1370          env: napi::bindgen_prelude::sys::napi_env,
1371          napi_val: napi::bindgen_prelude::sys::napi_value
1372        ) -> napi::bindgen_prelude::Result<napi::sys::napi_value> {
1373          <#inner_type>::validate(env, napi_val)
1374        }
1375      }
1376
1377      #to_napi_value
1378
1379      #from_napi_value
1380    }
1381  }
1382
1383  fn gen_napi_value_array_impl(&self, array: &NapiArray) -> TokenStream {
1384    let name = &self.name;
1385    let name_str = self.name.to_string();
1386
1387    let mut obj_field_setters = vec![];
1388    let mut obj_field_getters = vec![];
1389    let mut field_destructions = vec![];
1390
1391    for field in array.fields.iter() {
1392      let mut ty = field.ty.clone();
1393      remove_lifetime_in_type(&mut ty);
1394      let is_optional_field = if let syn::Type::Path(syn::TypePath {
1395        path: syn::Path { segments, .. },
1396        ..
1397      }) = &ty
1398      {
1399        if let Some(last_path) = segments.last() {
1400          last_path.ident == "Option"
1401        } else {
1402          false
1403        }
1404      } else {
1405        false
1406      };
1407
1408      if let syn::Member::Unnamed(i) = &field.name {
1409        let arg_name = format_ident!("arg{}", i);
1410        let field_index = i.index;
1411        field_destructions.push(quote! { #arg_name });
1412        if is_optional_field {
1413          obj_field_setters.push(match self.use_nullable {
1414            false => quote! {
1415              if #arg_name.is_some() {
1416                array.set(#field_index, #arg_name)?;
1417              }
1418            },
1419            true => quote! {
1420              if let Some(#arg_name) = #arg_name {
1421                array.set(#field_index, #arg_name)?;
1422              } else {
1423                array.set(#field_index, napi::bindgen_prelude::Null)?;
1424              }
1425            },
1426          });
1427        } else {
1428          obj_field_setters.push(quote! { array.set(#field_index, #arg_name)?; });
1429        }
1430        if is_optional_field && !self.use_nullable {
1431          obj_field_getters.push(quote! { let #arg_name: #ty = array.get(#field_index)?; });
1432        } else {
1433          obj_field_getters.push(quote! {
1434            let #arg_name: #ty = array.get(#field_index)?.ok_or_else(|| napi::bindgen_prelude::Error::new(
1435              napi::bindgen_prelude::Status::InvalidArg,
1436              format!("Failed to get element with index `{}`", #field_index),
1437            ))?;
1438          });
1439        }
1440      }
1441    }
1442
1443    let destructed_fields = quote! {
1444      Self (#(#field_destructions),*)
1445    };
1446
1447    let name_with_lifetime = if self.has_lifetime {
1448      quote! { #name<'_javascript_function_scope> }
1449    } else {
1450      quote! { #name }
1451    };
1452    let (from_napi_value_impl, to_napi_value_impl, validate_napi_value_impl, type_name_impl) =
1453      if self.has_lifetime {
1454        (
1455          quote! { impl <'_javascript_function_scope> napi::bindgen_prelude::FromNapiValue for #name<'_javascript_function_scope> },
1456          quote! { impl <'_javascript_function_scope> napi::bindgen_prelude::ToNapiValue for #name<'_javascript_function_scope> },
1457          quote! { impl <'_javascript_function_scope> napi::bindgen_prelude::ValidateNapiValue for #name<'_javascript_function_scope> },
1458          quote! { impl <'_javascript_function_scope> napi::bindgen_prelude::TypeName for #name<'_javascript_function_scope> },
1459        )
1460      } else {
1461        (
1462          quote! { impl napi::bindgen_prelude::FromNapiValue for #name },
1463          quote! { impl napi::bindgen_prelude::ToNapiValue for #name },
1464          quote! { impl napi::bindgen_prelude::ValidateNapiValue for #name },
1465          quote! { impl napi::bindgen_prelude::TypeName for #name },
1466        )
1467      };
1468
1469    let array_len = array.fields.len() as u32;
1470
1471    let to_napi_value = if array.object_to_js {
1472      quote! {
1473        #[automatically_derived]
1474        #to_napi_value_impl {
1475          unsafe fn to_napi_value(env: napi::bindgen_prelude::sys::napi_env, val: #name_with_lifetime) -> napi::bindgen_prelude::Result<napi::bindgen_prelude::sys::napi_value> {
1476            #[allow(unused_variables)]
1477            let env_wrapper = napi::bindgen_prelude::Env::from(env);
1478            #[allow(unused_mut)]
1479            let mut array = env_wrapper.create_array(#array_len)?;
1480
1481            let #destructed_fields = val;
1482            #(#obj_field_setters)*
1483
1484            napi::bindgen_prelude::Array::to_napi_value(env, array)
1485          }
1486        }
1487      }
1488    } else {
1489      quote! {}
1490    };
1491
1492    let from_napi_value = if array.object_from_js {
1493      let return_type = if self.has_lifetime {
1494        quote! { #name<'_javascript_function_scope> }
1495      } else {
1496        quote! { #name }
1497      };
1498      quote! {
1499        #[automatically_derived]
1500        #from_napi_value_impl {
1501          unsafe fn from_napi_value(
1502            env: napi::bindgen_prelude::sys::napi_env,
1503            napi_val: napi::bindgen_prelude::sys::napi_value
1504          ) -> napi::bindgen_prelude::Result<#return_type> {
1505            #[allow(unused_variables)]
1506            let env_wrapper = napi::bindgen_prelude::Env::from(env);
1507            #[allow(unused_mut)]
1508            let mut array = napi::bindgen_prelude::Array::from_napi_value(env, napi_val)?;
1509
1510            #(#obj_field_getters)*
1511
1512            let val = #destructed_fields;
1513
1514            Ok(val)
1515          }
1516        }
1517
1518        #[automatically_derived]
1519        #validate_napi_value_impl {}
1520      }
1521    } else {
1522      quote! {}
1523    };
1524
1525    quote! {
1526      #[automatically_derived]
1527      #type_name_impl {
1528        fn type_name() -> &'static str {
1529          #name_str
1530        }
1531
1532        fn value_type() -> napi::ValueType {
1533          napi::ValueType::Object
1534        }
1535      }
1536
1537      #to_napi_value
1538
1539      #from_napi_value
1540    }
1541  }
1542}
1543
1544impl TryToTokens for NapiImpl {
1545  fn try_to_tokens(&self, tokens: &mut TokenStream) -> BindgenResult<()> {
1546    self.gen_helper_mod()?.to_tokens(tokens);
1547
1548    Ok(())
1549  }
1550}
1551
1552impl NapiImpl {
1553  fn gen_helper_mod(&self) -> BindgenResult<TokenStream> {
1554    if cfg!(test) {
1555      return Ok(quote! {});
1556    }
1557
1558    let name = &self.name;
1559    let name_str = self.name.to_string();
1560    let js_name = format!("{}\0", self.js_name);
1561    let mod_name = Ident::new(
1562      &format!(
1563        "__napi_impl_helper_{}_{}",
1564        name_str,
1565        NAPI_IMPL_ID.fetch_add(1, Ordering::SeqCst)
1566      ),
1567      Span::call_site(),
1568    );
1569
1570    let register_name = &self.register_name;
1571
1572    let mut methods = vec![];
1573    let mut props = HashMap::new();
1574
1575    for item in self.items.iter() {
1576      let js_name = Literal::string(&item.js_name);
1577      let item_str = item.name.to_string();
1578      let intermediate_name = get_intermediate_ident(&item_str);
1579      methods.push(item.try_to_token_stream()?);
1580
1581      let mut attribute = super::PROPERTY_ATTRIBUTE_DEFAULT;
1582      if item.writable {
1583        attribute |= super::PROPERTY_ATTRIBUTE_WRITABLE;
1584      }
1585      if item.enumerable {
1586        attribute |= super::PROPERTY_ATTRIBUTE_ENUMERABLE;
1587      }
1588      if item.configurable {
1589        attribute |= super::PROPERTY_ATTRIBUTE_CONFIGURABLE;
1590      }
1591
1592      let prop = props.entry(&item.js_name).or_insert_with(|| {
1593        quote! {
1594          napi::bindgen_prelude::Property::new().with_utf8_name(#js_name).unwrap().with_property_attributes(napi::bindgen_prelude::PropertyAttributes::from_bits(#attribute).unwrap())
1595        }
1596      });
1597
1598      let appendix = match item.kind {
1599        FnKind::Constructor => quote! { .with_ctor(#intermediate_name) },
1600        FnKind::Getter => quote! { .with_getter(#intermediate_name) },
1601        FnKind::Setter => quote! { .with_setter(#intermediate_name) },
1602        _ => {
1603          if item.fn_self.is_some() {
1604            quote! { .with_method(#intermediate_name) }
1605          } else {
1606            quote! { .with_method(#intermediate_name).with_property_attributes(napi::bindgen_prelude::PropertyAttributes::Static) }
1607          }
1608        }
1609      };
1610
1611      appendix.to_tokens(prop);
1612    }
1613
1614    let mut props: Vec<_> = props.into_iter().collect();
1615    props.sort_by_key(|(_, prop)| prop.to_string());
1616    let props = props.into_iter().map(|(_, prop)| prop);
1617    let props_wasm = props.clone();
1618    let js_mod_ident = js_mod_to_token_stream(self.js_mod.as_ref());
1619    Ok(quote! {
1620      #[allow(non_snake_case)]
1621      #[allow(clippy::all)]
1622      mod #mod_name {
1623        use super::*;
1624        #(#methods)*
1625
1626        #[cfg(all(not(test), not(target_family = "wasm")))]
1627        #[napi::ctor::ctor(crate_path=napi::ctor)]
1628        fn #register_name() {
1629          napi::__private::register_class(std::any::TypeId::of::<#name>(), #js_mod_ident, #js_name, vec![#(#props),*]);
1630        }
1631
1632        #[cfg(all(not(test), target_family = "wasm"))]
1633        #[no_mangle]
1634        extern "C" fn #register_name() {
1635          napi::__private::register_class(std::any::TypeId::of::<#name>(), #js_mod_ident, #js_name, vec![#(#props_wasm),*]);
1636        }
1637      }
1638    })
1639  }
1640}
1641
1642pub fn rm_raw_prefix(s: &str) -> &str {
1643  if let Some(stripped) = s.strip_prefix("r#") {
1644    stripped
1645  } else {
1646    s
1647  }
1648}
1649
1650fn remove_lifetime_in_type(ty: &mut syn::Type) {
1651  if let syn::Type::Path(syn::TypePath { path, .. }) = ty {
1652    path.segments.iter_mut().for_each(|segment| {
1653      if let syn::PathArguments::AngleBracketed(ref mut args) = segment.arguments {
1654        args.args.iter_mut().for_each(|arg| match arg {
1655          syn::GenericArgument::Type(ref mut ty) => {
1656            remove_lifetime_in_type(ty);
1657          }
1658          syn::GenericArgument::Lifetime(lifetime) => {
1659            lifetime.ident = Ident::new("_", lifetime.ident.span());
1660          }
1661          _ => {}
1662        });
1663      }
1664    });
1665  }
1666}