nacos-sdk-rust-binding-node 0.0.1-BETA → 0.0.1-PRE

package/Cargo.toml

@@ -15,7 +15,7 @@ crate-type = ["cdylib"]
 
 [dependencies]
 # Default enable napi4 feature, see https://nodejs.org/api/n-api.html#node-api-version-matrix
-napi = { version = "2", default-features = false, features = ["napi4"] }
+napi = { version = "2", default-features = false, features = ["napi4", "async"] }
 napi-derive = "2"
 
 # version = ^0.2

package/README.md

@@ -3,8 +3,16 @@ nacos-sdk-rust binding for NodeJs with napi.
 
 Tip: nacos-sdk-nodejs 仓库暂未提供 2.x gRPC 交互模式，为了能升级它，故而通过 node addon 方式调用 nacos-sdk-rust 
 
+# Usage
+**使用样例请看仓库内的 example 目录**
+
+npm 包 -> https://www.npmjs.com/package/nacos-sdk-rust-binding-node
+
+目前 GitHub Actions CI 仅能打出部分包，若未支持而需要的场景，请提 issue 看怎样提供。
+
 # License
 [Apache License Version 2.0](LICENSE)
 
 # Acknowledgement
 - binding for NodeJs with napi by [napi-rs](https://github.com/napi-rs/napi-rs.git)
+- binding the [nacos-sdk-rust](https://github.com/nacos-group/nacos-sdk-rust.git)

package/example/config.js

@@ -11,11 +11,13 @@ const nacos_config_client = new NacosConfigClient({
 
 try {
     // If it fails, pay attention to err
-    var conf_content = nacos_config_client.getConfig('hongwen.properties', 'LOVE');
-    console.log(conf_content);
+    nacos_config_client.getConfig('hongwen.properties', 'LOVE').then(data => {
+        console.log('getConfig => ' + data);
+    });
 
-    var config_resp = nacos_config_client.getConfigResp('hongwen.properties', 'LOVE');
-    console.log(config_resp.content);
+    nacos_config_client.getConfigResp('hongwen.properties', 'LOVE').then(data => {
+        console.log('getConfigResp => ' + JSON.stringify(data));
+    });
 } catch(e) {
     console.log(e);
 }

package/example/config_decrypt.js

@@ -0,0 +1,34 @@
+'use strict';
+
+const { NacosConfigClient, NacosConfigResponse } = require('../index')
+
+// If it fails, pay attention to err
+const nacos_config_client = new NacosConfigClient(
+{
+    serverAddr: '127.0.0.1:8848',
+    namespace: "hongwen",
+    appName: "binding-node-example-app"
+},
+(err, config_req, config_resp) => {
+    // config_req or config_resp only one not null. e.g. you can do encrypt for config_req, decrypt for config_resp.
+    if (config_resp != null) {
+        config_resp.content = "func config_decrypt change it." // TODO by customize
+    }
+    return [config_req, config_resp];
+}
+);
+
+try {
+    // If it fails, pay attention to err
+    nacos_config_client.getConfig('hongwen.properties', 'LOVE').then(data => {
+        console.log('getConfig => ' + data);
+    });
+   
+    nacos_config_client.getConfigResp('hongwen.properties', 'LOVE').then((data) => {
+        console.log('getConfigResp => ' + JSON.stringify(data));
+    });
+} catch(e) {
+    console.log(e);
+}
+
+nacos_config_client.addListener('hongwen.properties', 'LOVE', (err, config_resp) => { console.log(config_resp) });

package/example/naming.js

@@ -12,10 +12,6 @@ const nacos_naming_client = new NacosNamingClient({
 const instance1 = {
   ip: '127.0.0.1',
   port: 9090,
-  weight: 1.0,
-  healthy: true,
-  enabled: true,
-  ephemeral: true,
   metadata: { 'application' : 'example-naming' },
 }
 
@@ -51,8 +47,9 @@ function sleep(time){
   await sleep(1000);
 
   console.log('--------- get all instances 1 ------------');
-  var instance_arr = nacos_naming_client.getAllInstances(serviceName, group); // If it fails, pay attention to err
-  console.log(instance_arr);
+  nacos_naming_client.getAllInstances(serviceName, group).then(instance_arr => {
+    console.log(instance_arr);
+  });
   await sleep(1000);
 
   console.log('--------- batchRegisterInstance instance2 ------------');
@@ -60,8 +57,9 @@ function sleep(time){
   await sleep(1000);
 
   console.log('--------- get all instances 2 ------------');
-  var instance_arr = nacos_naming_client.getAllInstances(serviceName, group); // If it fails, pay attention to err
-  console.log(instance_arr);
+  nacos_naming_client.getAllInstances(serviceName, group).then(instance_arr => {
+    console.log(instance_arr);
+  });
 
   await sleep(300000);
   process.exit(0);

package/index.d.ts

@@ -37,50 +37,76 @@ export interface NacosServiceInstance {
   ip: string
   /** Port */
   port: number
-  /** Weight */
-  weight: number
-  /** Healthy or not */
-  healthy: boolean
-  /** Enabled ot not */
-  enabled: boolean
-  /** Ephemeral or not */
-  ephemeral: boolean
-  /** Cluster Name */
+  /** Weight, default 1.0 */
+  weight?: number
+  /** Healthy or not, default true */
+  healthy?: boolean
+  /** Enabled ot not, default true */
+  enabled?: boolean
+  /** Ephemeral or not, default true */
+  ephemeral?: boolean
+  /** Cluster Name, default 'DEFAULT' */
   clusterName?: string
   /** Service Name */
   serviceName?: string
-  /** Metadata */
-  metadata: Record<string, string>
+  /** Metadata, default '{}' */
+  metadata?: Record<string, string>
+}
+/** ConfigReq for [`ConfigFilter`] */
+export interface NacosConfigReq {
+  /** DataId */
+  dataId: string
+  /** Group */
+  group: string
+  /** Namespace/Tenant */
+  namespace: string
+  /** Content */
+  content: string
+  /** Content's Encrypted Data Key. */
+  encryptedDataKey: string
+}
+/** ConfigResp for [`ConfigFilter`] */
+export interface NacosConfigResp {
+  /** DataId */
+  dataId: string
+  /** Group */
+  group: string
+  /** Namespace/Tenant */
+  namespace: string
+  /** Content */
+  content: string
+  /** Content's Encrypted Data Key. */
+  encryptedDataKey: string
 }
 /** Client api of Nacos Config. */
 export class NacosConfigClient {
   /** Build a Config Client. */
-  constructor(clientOptions: ClientOptions)
+  constructor(clientOptions: ClientOptions, configFilter?: (err: Error | null, arg0?: NacosConfigReq | undefined | null, arg1?: NacosConfigResp | undefined | null) => any | undefined | null)
   /**
    * Get config's content.
    * If it fails, pay attention to err
    */
-  getConfig(dataId: string, group: string): string
+  getConfig(dataId: string, group: string): Promise<string>
   /**
    * Get NacosConfigResponse.
    * If it fails, pay attention to err
    */
-  getConfigResp(dataId: string, group: string): NacosConfigResponse
+  getConfigResp(dataId: string, group: string): Promise<NacosConfigResponse>
   /**
    * Publish config.
    * If it fails, pay attention to err
    */
-  publishConfig(dataId: string, group: string, content: string): boolean
+  publishConfig(dataId: string, group: string, content: string): Promise<boolean>
   /**
    * Remove config.
    * If it fails, pay attention to err
    */
-  removeConfig(dataId: string, group: string): boolean
+  removeConfig(dataId: string, group: string): Promise<boolean>
   /**
    * Add NacosConfigChangeListener callback func, which listen the config change.
    * If it fails, pay attention to err
    */
-  addListener(dataId: string, group: string, listener: (err: Error | null, value: NacosConfigResponse) => any): void
+  addListener(dataId: string, group: string, listener: (err: Error | null, value: NacosConfigResponse) => any): Promise<void>
 }
 /** Client api of Nacos Naming. */
 export class NacosNamingClient {
@@ -90,35 +116,35 @@ export class NacosNamingClient {
    * Register instance.
    * If it fails, pay attention to err
    */
-  registerInstance(serviceName: string, group: string, serviceInstance: NacosServiceInstance): void
+  registerInstance(serviceName: string, group: string, serviceInstance: NacosServiceInstance): Promise<void>
   /**
    * Deregister instance.
    * If it fails, pay attention to err
    */
-  deregisterInstance(serviceName: string, group: string, serviceInstance: NacosServiceInstance): void
+  deregisterInstance(serviceName: string, group: string, serviceInstance: NacosServiceInstance): Promise<void>
   /**
    * Batch register instance, improve interaction efficiency.
    * If it fails, pay attention to err
    */
-  batchRegisterInstance(serviceName: string, group: string, serviceInstances: Array<NacosServiceInstance>): void
+  batchRegisterInstance(serviceName: string, group: string, serviceInstances: Array<NacosServiceInstance>): Promise<void>
   /**
    * Get all instances by service and group. default cluster=[], subscribe=true.
    * If it fails, pay attention to err
    */
-  getAllInstances(serviceName: string, group: string, clusters?: Array<string> | undefined | null, subscribe?: boolean = true): Array<NacosServiceInstance>
+  getAllInstances(serviceName: string, group: string, clusters?: Array<string> | undefined | null, subscribe?: boolean = true): Promise<Array<NacosServiceInstance>>
   /**
    * Select instances whether healthy or not. default cluster=[], subscribe=true, healthy=true.
    * If it fails, pay attention to err
    */
-  selectInstances(serviceName: string, group: string, clusters?: Array<string> | undefined | null, subscribe?: boolean = true, healthy?: boolean = true): Array<NacosServiceInstance>
+  selectInstances(serviceName: string, group: string, clusters?: Array<string> | undefined | null, subscribe?: boolean = true, healthy?: boolean = true): Promise<Array<NacosServiceInstance>>
   /**
    * Select one healthy instance. default cluster=[], subscribe=true.
    * If it fails, pay attention to err
    */
-  selectOneHealthyInstance(serviceName: string, group: string, clusters?: Array<string> | undefined | null, subscribe?: boolean = true): NacosServiceInstance
+  selectOneHealthyInstance(serviceName: string, group: string, clusters?: Array<string> | undefined | null, subscribe?: boolean = true): Promise<NacosServiceInstance>
   /**
    * Add NacosNamingEventListener callback func, which listen the instance change.
    * If it fails, pay attention to err
    */
-  subscribe(serviceName: string, group: string, clusters: Array<string> | undefined | null, listener: (err: Error | null, value: Array<NacosServiceInstance>) => any): void
+  subscribe(serviceName: string, group: string, clusters: Array<string> | undefined | null, listener: (err: Error | null, value: Array<NacosServiceInstance>) => any): Promise<void>
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nacos-sdk-rust-binding-node",
-  "version": "0.0.1-BETA",
+  "version": "0.0.1-PRE",
   "main": "index.js",
   "types": "index.d.ts",
   "napi": {
@@ -43,19 +43,19 @@
   },
   "packageManager": "yarn@3.4.1",
   "optionalDependencies": {
-    "nacos-sdk-rust-binding-node-win32-x64-msvc": "0.0.1-BETA",
-    "nacos-sdk-rust-binding-node-darwin-x64": "0.0.1-BETA",
-    "nacos-sdk-rust-binding-node-linux-x64-gnu": "0.0.1-BETA",
-    "nacos-sdk-rust-binding-node-darwin-arm64": "0.0.1-BETA",
-    "nacos-sdk-rust-binding-node-android-arm64": "0.0.1-BETA",
-    "nacos-sdk-rust-binding-node-linux-arm64-gnu": "0.0.1-BETA",
-    "nacos-sdk-rust-binding-node-linux-arm64-musl": "0.0.1-BETA",
-    "nacos-sdk-rust-binding-node-win32-arm64-msvc": "0.0.1-BETA",
-    "nacos-sdk-rust-binding-node-linux-arm-gnueabihf": "0.0.1-BETA",
-    "nacos-sdk-rust-binding-node-linux-x64-musl": "0.0.1-BETA",
-    "nacos-sdk-rust-binding-node-freebsd-x64": "0.0.1-BETA",
-    "nacos-sdk-rust-binding-node-win32-ia32-msvc": "0.0.1-BETA",
-    "nacos-sdk-rust-binding-node-android-arm-eabi": "0.0.1-BETA",
-    "nacos-sdk-rust-binding-node-darwin-universal": "0.0.1-BETA"
+    "nacos-sdk-rust-binding-node-win32-x64-msvc": "0.0.1-PRE",
+    "nacos-sdk-rust-binding-node-darwin-x64": "0.0.1-PRE",
+    "nacos-sdk-rust-binding-node-linux-x64-gnu": "0.0.1-PRE",
+    "nacos-sdk-rust-binding-node-darwin-arm64": "0.0.1-PRE",
+    "nacos-sdk-rust-binding-node-android-arm64": "0.0.1-PRE",
+    "nacos-sdk-rust-binding-node-linux-arm64-gnu": "0.0.1-PRE",
+    "nacos-sdk-rust-binding-node-linux-arm64-musl": "0.0.1-PRE",
+    "nacos-sdk-rust-binding-node-win32-arm64-msvc": "0.0.1-PRE",
+    "nacos-sdk-rust-binding-node-linux-arm-gnueabihf": "0.0.1-PRE",
+    "nacos-sdk-rust-binding-node-linux-x64-musl": "0.0.1-PRE",
+    "nacos-sdk-rust-binding-node-freebsd-x64": "0.0.1-PRE",
+    "nacos-sdk-rust-binding-node-win32-ia32-msvc": "0.0.1-PRE",
+    "nacos-sdk-rust-binding-node-android-arm-eabi": "0.0.1-PRE",
+    "nacos-sdk-rust-binding-node-darwin-universal": "0.0.1-PRE"
   }
 }

package/src/config.rs

@@ -1,19 +1,27 @@
 #![deny(clippy::all)]
 
-use napi::{bindgen_prelude::*, threadsafe_function::*};
+use napi::{bindgen_prelude::*, threadsafe_function::*, tokio::sync::Mutex};
 use std::sync::Arc;
 
 /// Client api of Nacos Config.
 #[napi]
 pub struct NacosConfigClient {
-  inner: Box<dyn nacos_sdk::api::config::ConfigService>,
+  inner: Arc<Mutex<dyn nacos_sdk::api::config::ConfigService + Send + Sync + 'static>>,
 }
 
 #[napi]
 impl NacosConfigClient {
   /// Build a Config Client.
   #[napi(constructor)]
-  pub fn new(client_options: crate::ClientOptions) -> Result<NacosConfigClient> {
+  pub fn new(
+    client_options: crate::ClientOptions,
+    config_filter: Option<
+      ThreadsafeFunction<(
+        Option<crate::NacosConfigReq>,
+        Option<crate::NacosConfigResp>,
+      )>,
+    >,
+  ) -> Result<NacosConfigClient> {
     // print to console or file
     crate::log_print_to_console_or_file();
 
@@ -43,45 +51,57 @@ impl NacosConfigClient {
       nacos_sdk::api::config::ConfigServiceBuilder::new(props)
     };
 
+    let config_service_builder = if config_filter.is_some() {
+      config_service_builder.add_config_filter(Box::new(crate::NacosConfigFilter {
+        func: Arc::new(config_filter.unwrap()),
+      }))
+    } else {
+      config_service_builder
+    };
+
     let config_service = config_service_builder
       .build()
       .map_err(|nacos_err| Error::from_reason(nacos_err.to_string()))?;
 
     Ok(NacosConfigClient {
-      inner: Box::new(config_service),
+      inner: Arc::new(Mutex::new(config_service)),
     })
   }
 
   /// Get config's content.
   /// If it fails, pay attention to err
   #[napi]
-  pub fn get_config(&mut self, data_id: String, group: String) -> Result<String> {
-    Ok(self.get_config_resp(data_id, group)?.content)
+  pub async fn get_config(&self, data_id: String, group: String) -> Result<String> {
+    let resp = self.get_config_resp(data_id, group).await?;
+    Ok(resp.content)
   }
 
   /// Get NacosConfigResponse.
   /// If it fails, pay attention to err
   #[napi]
-  pub fn get_config_resp(&mut self, data_id: String, group: String) -> Result<NacosConfigResponse> {
-    let config_resp = self
-      .inner
+  pub async fn get_config_resp(
+    &self,
+    data_id: String,
+    group: String,
+  ) -> Result<NacosConfigResponse> {
+    let mut inner = self.inner.lock().await;
+    let config_resp = inner
       .get_config(data_id, group)
       .map_err(|nacos_err| Error::from_reason(nacos_err.to_string()))?;
-
     Ok(transfer_conf_resp(config_resp))
   }
 
   /// Publish config.
   /// If it fails, pay attention to err
   #[napi]
-  pub fn publish_config(
-    &mut self,
+  pub async fn publish_config(
+    &self,
     data_id: String,
     group: String,
     content: String,
   ) -> Result<bool> {
-    self
-      .inner
+    let mut inner = self.inner.lock().await;
+    inner
       .publish_config(data_id, group, content, None)
       .map_err(|nacos_err| Error::from_reason(nacos_err.to_string()))
   }
@@ -89,9 +109,9 @@ impl NacosConfigClient {
   /// Remove config.
   /// If it fails, pay attention to err
   #[napi]
-  pub fn remove_config(&mut self, data_id: String, group: String) -> Result<bool> {
-    self
-      .inner
+  pub async fn remove_config(&self, data_id: String, group: String) -> Result<bool> {
+    let mut inner = self.inner.lock().await;
+    inner
       .remove_config(data_id, group)
       .map_err(|nacos_err| Error::from_reason(nacos_err.to_string()))
   }
@@ -99,14 +119,14 @@ impl NacosConfigClient {
   /// Add NacosConfigChangeListener callback func, which listen the config change.
   /// If it fails, pay attention to err
   #[napi]
-  pub fn add_listener(
-    &mut self,
+  pub async fn add_listener(
+    &self,
     data_id: String,
     group: String,
     listener: ThreadsafeFunction<NacosConfigResponse>,
   ) -> Result<()> {
-    self
-      .inner
+    let mut inner = self.inner.lock().await;
+    inner
       .add_listener(
         data_id,
         group,

package/src/lib.rs

@@ -17,6 +17,7 @@ fn log_print_to_console_or_file() {
       Ok(dir) => dir,
       Err(_) => "/tmp".to_string(),
     };
+    // FIXME log to file, now there are files but no content.
     let file_appender = tracing_appender::rolling::daily(home_dir + "/logs/nacos", "nacos.log");
     let (non_blocking, _guard) = tracing_appender::non_blocking(file_appender);
 
@@ -51,3 +52,6 @@ pub use config::*;
 
 mod naming;
 pub use naming::*;
+
+mod plugin;
+pub use plugin::*;

package/src/naming.rs

@@ -1,12 +1,12 @@
 #![deny(clippy::all)]
 
-use napi::{bindgen_prelude::*, threadsafe_function::*};
+use napi::{bindgen_prelude::*, threadsafe_function::*, tokio::sync::Mutex};
 use std::sync::Arc;
 
 /// Client api of Nacos Naming.
 #[napi]
 pub struct NacosNamingClient {
-  inner: Box<dyn nacos_sdk::api::naming::NamingService>,
+  inner: Arc<Mutex<dyn nacos_sdk::api::naming::NamingService + Send + Sync + 'static>>,
 }
 
 #[napi]
@@ -48,21 +48,21 @@ impl NacosNamingClient {
       .map_err(|nacos_err| Error::from_reason(nacos_err.to_string()))?;
 
     Ok(NacosNamingClient {
-      inner: Box::new(naming_service),
+      inner: Arc::new(Mutex::new(naming_service)),
     })
   }
 
   /// Register instance.
   /// If it fails, pay attention to err
   #[napi]
-  pub fn register_instance(
+  pub async fn register_instance(
     &self,
     service_name: String,
     group: String,
     service_instance: NacosServiceInstance,
   ) -> Result<()> {
-    self
-      .inner
+    let inner = self.inner.lock().await;
+    inner
       .register_service(
         service_name,
         Some(group),
@@ -74,14 +74,14 @@ impl NacosNamingClient {
   /// Deregister instance.
   /// If it fails, pay attention to err
   #[napi]
-  pub fn deregister_instance(
+  pub async fn deregister_instance(
     &self,
     service_name: String,
     group: String,
     service_instance: NacosServiceInstance,
   ) -> Result<()> {
-    self
-      .inner
+    let inner = self.inner.lock().await;
+    inner
       .deregister_instance(
         service_name,
         Some(group),
@@ -93,7 +93,7 @@ impl NacosNamingClient {
   /// Batch register instance, improve interaction efficiency.
   /// If it fails, pay attention to err
   #[napi]
-  pub fn batch_register_instance(
+  pub async fn batch_register_instance(
     &self,
     service_name: String,
     group: String,
@@ -104,8 +104,8 @@ impl NacosNamingClient {
       .map(transfer_js_instance_to_rust)
       .collect();
 
-    self
-      .inner
+    let inner = self.inner.lock().await;
+    inner
       .batch_register_instance(service_name, Some(group), rust_instances)
       .map_err(|nacos_err| Error::from_reason(nacos_err.to_string()))
   }
@@ -113,16 +113,15 @@ impl NacosNamingClient {
   /// Get all instances by service and group. default cluster=[], subscribe=true.
   /// If it fails, pay attention to err
   #[napi]
-  pub fn get_all_instances(
+  pub async fn get_all_instances(
     &self,
     service_name: String,
     group: String,
     clusters: Option<Vec<String>>,
-    #[napi(ts_arg_type = "boolean = true")]
-    subscribe: Option<bool>,
+    #[napi(ts_arg_type = "boolean = true")] subscribe: Option<bool>,
   ) -> Result<Vec<NacosServiceInstance>> {
-    let rust_instances = self
-      .inner
+    let inner = self.inner.lock().await;
+    let rust_instances = inner
       .get_all_instances(
         service_name,
         Some(group),
@@ -142,18 +141,16 @@ impl NacosNamingClient {
   /// Select instances whether healthy or not. default cluster=[], subscribe=true, healthy=true.
   /// If it fails, pay attention to err
   #[napi]
-  pub fn select_instances(
+  pub async fn select_instances(
     &self,
     service_name: String,
     group: String,
     clusters: Option<Vec<String>>,
-    #[napi(ts_arg_type = "boolean = true")]
-    subscribe: Option<bool>,
-    #[napi(ts_arg_type = "boolean = true")]
-    healthy: Option<bool>,
+    #[napi(ts_arg_type = "boolean = true")] subscribe: Option<bool>,
+    #[napi(ts_arg_type = "boolean = true")] healthy: Option<bool>,
   ) -> Result<Vec<NacosServiceInstance>> {
-    let rust_instances = self
-      .inner
+    let inner = self.inner.lock().await;
+    let rust_instances = inner
       .select_instance(
         service_name,
         Some(group),
@@ -174,16 +171,15 @@ impl NacosNamingClient {
   /// Select one healthy instance. default cluster=[], subscribe=true.
   /// If it fails, pay attention to err
   #[napi]
-  pub fn select_one_healthy_instance(
+  pub async fn select_one_healthy_instance(
     &self,
     service_name: String,
     group: String,
     clusters: Option<Vec<String>>,
-    #[napi(ts_arg_type = "boolean = true")]
-    subscribe: Option<bool>,
+    #[napi(ts_arg_type = "boolean = true")] subscribe: Option<bool>,
   ) -> Result<NacosServiceInstance> {
-    let rust_instance = self
-      .inner
+    let inner = self.inner.lock().await;
+    let rust_instance = inner
       .select_one_healthy_instance(
         service_name,
         Some(group),
@@ -198,15 +194,15 @@ impl NacosNamingClient {
   /// Add NacosNamingEventListener callback func, which listen the instance change.
   /// If it fails, pay attention to err
   #[napi]
-  pub fn subscribe(
+  pub async fn subscribe(
     &self,
     service_name: String,
     group: String,
     clusters: Option<Vec<String>>,
     listener: ThreadsafeFunction<Vec<NacosServiceInstance>>,
   ) -> Result<()> {
-    self
-      .inner
+    let inner = self.inner.lock().await;
+    inner
       .subscribe(
         service_name,
         Some(group),
@@ -253,20 +249,20 @@ pub struct NacosServiceInstance {
   pub ip: String,
   /// Port
   pub port: i32,
-  /// Weight
-  pub weight: f64,
-  /// Healthy or not
-  pub healthy: bool,
-  /// Enabled ot not
-  pub enabled: bool,
-  /// Ephemeral or not
-  pub ephemeral: bool,
-  /// Cluster Name
+  /// Weight, default 1.0
+  pub weight: Option<f64>,
+  /// Healthy or not, default true
+  pub healthy: Option<bool>,
+  /// Enabled ot not, default true
+  pub enabled: Option<bool>,
+  /// Ephemeral or not, default true
+  pub ephemeral: Option<bool>,
+  /// Cluster Name, default 'DEFAULT'
   pub cluster_name: Option<String>,
   /// Service Name
   pub service_name: Option<String>,
-  /// Metadata
-  pub metadata: std::collections::HashMap<String, String>,
+  /// Metadata, default '{}'
+  pub metadata: Option<std::collections::HashMap<String, String>>,
 }
 
 fn transfer_js_instance_to_rust(
@@ -276,13 +272,13 @@ fn transfer_js_instance_to_rust(
     instance_id: js_instance.instance_id.clone(),
     ip: js_instance.ip.clone(),
     port: js_instance.port,
-    weight: js_instance.weight,
-    healthy: js_instance.healthy,
-    enabled: js_instance.enabled,
-    ephemeral: js_instance.ephemeral,
+    weight: js_instance.weight.unwrap_or(1.0),
+    healthy: js_instance.healthy.unwrap_or(true),
+    enabled: js_instance.enabled.unwrap_or(true),
+    ephemeral: js_instance.ephemeral.unwrap_or(true),
     cluster_name: js_instance.cluster_name.clone(),
     service_name: js_instance.service_name.clone(),
-    metadata: js_instance.metadata.clone(),
+    metadata: js_instance.metadata.clone().unwrap_or_default(),
   }
 }
 
@@ -293,12 +289,12 @@ fn transfer_rust_instance_to_js(
     instance_id: rust_instance.instance_id.clone(),
     ip: rust_instance.ip.clone(),
     port: rust_instance.port,
-    weight: rust_instance.weight,
-    healthy: rust_instance.healthy,
-    enabled: rust_instance.enabled,
-    ephemeral: rust_instance.ephemeral,
+    weight: Some(rust_instance.weight),
+    healthy: Some(rust_instance.healthy),
+    enabled: Some(rust_instance.enabled),
+    ephemeral: Some(rust_instance.ephemeral),
     cluster_name: rust_instance.cluster_name.clone(),
     service_name: rust_instance.service_name.clone(),
-    metadata: rust_instance.metadata.clone(),
+    metadata: Some(rust_instance.metadata.clone()),
   }
 }

package/src/plugin.rs

@@ -0,0 +1,108 @@
+use napi::threadsafe_function::*;
+use std::sync::Arc;
+
+/// [`config_filter`] It is an advanced feature that does not need to be used by default;
+/// For example: 1. Encrypt ConfigReq.content value and then request; 2. Decrypt ConfigResp.content to get the value.
+pub struct NacosConfigFilter {
+  pub(crate) func: Arc<ThreadsafeFunction<(Option<NacosConfigReq>, Option<NacosConfigResp>)>>,
+}
+
+impl nacos_sdk::api::plugin::ConfigFilter for NacosConfigFilter {
+  fn filter(
+    &self,
+    config_req: Option<&mut nacos_sdk::api::plugin::ConfigReq>,
+    config_resp: Option<&mut nacos_sdk::api::plugin::ConfigResp>,
+  ) {
+    if let Some(config_req) = config_req {
+      let js_config_req = NacosConfigReq {
+        data_id: config_req.data_id.clone(),
+        group: config_req.group.clone(),
+        namespace: config_req.namespace.clone(),
+        content: config_req.content.clone(),
+        encrypted_data_key: config_req.encrypted_data_key.clone(),
+      };
+
+      let (tx, rx) = std::sync::mpsc::channel();
+      self.func.clone().call_with_return_value(
+        Ok((Some(js_config_req), None)),
+        ThreadsafeFunctionCallMode::Blocking,
+        move |(after_js_config_req, _after_js_config_resp): (
+          Option<NacosConfigReq>,
+          Option<NacosConfigResp>,
+        )| {
+          let after_js_config_req = after_js_config_req.unwrap();
+          let _ = tx.send(after_js_config_req);
+          Ok(())
+        },
+      );
+
+      let ret = rx.recv().unwrap();
+      config_req.data_id = ret.data_id;
+      config_req.group = ret.group;
+      config_req.namespace = ret.namespace;
+      config_req.content = ret.content;
+      config_req.encrypted_data_key = ret.encrypted_data_key;
+    }
+
+    if let Some(config_resp) = config_resp {
+      let js_config_resp = NacosConfigResp {
+        data_id: config_resp.data_id.clone(),
+        group: config_resp.group.clone(),
+        namespace: config_resp.namespace.clone(),
+        content: config_resp.content.clone(),
+        encrypted_data_key: config_resp.encrypted_data_key.clone(),
+      };
+
+      let (tx, rx) = std::sync::mpsc::channel();
+      self.func.clone().call_with_return_value(
+        Ok((None, Some(js_config_resp))),
+        ThreadsafeFunctionCallMode::Blocking,
+        move |(_after_js_config_req, after_js_config_resp): (
+          Option<NacosConfigReq>,
+          Option<NacosConfigResp>,
+        )| {
+          let after_js_config_resp = after_js_config_resp.unwrap();
+          let _ = tx.send(after_js_config_resp);
+          Ok(())
+        },
+      );
+
+      let ret = rx.recv().unwrap();
+      config_resp.data_id = ret.data_id;
+      config_resp.group = ret.group;
+      config_resp.namespace = ret.namespace;
+      config_resp.content = ret.content;
+      config_resp.encrypted_data_key = ret.encrypted_data_key;
+    }
+  }
+}
+
+/// ConfigReq for [`ConfigFilter`]
+#[napi(object)]
+pub struct NacosConfigReq {
+  /// DataId
+  pub data_id: String,
+  /// Group
+  pub group: String,
+  /// Namespace/Tenant
+  pub namespace: String,
+  /// Content
+  pub content: String,
+  /// Content's Encrypted Data Key.
+  pub encrypted_data_key: String,
+}
+
+/// ConfigResp for [`ConfigFilter`]
+#[napi(object)]
+pub struct NacosConfigResp {
+  /// DataId
+  pub data_id: String,
+  /// Group
+  pub group: String,
+  /// Namespace/Tenant
+  pub namespace: String,
+  /// Content
+  pub content: String,
+  /// Content's Encrypted Data Key.
+  pub encrypted_data_key: String,
+}