feat: demonstrate Node-API for native interop (#468)

* feat: demonstrate Node-API for native interop

* Apply suggestions from code review

Co-authored-by: aspect-workflows[bot] <143031405+aspect-workflows[bot]@users.noreply.github.com>

* fix gazelle

---------

Co-authored-by: aspect-workflows[bot] <143031405+aspect-workflows[bot]@users.noreply.github.com>

Author: alexeagle

MODULE.bazel

@@ -32,6 +32,7 @@ bazel_dep(name = "rules_nodejs", version = "6.3.5")
 bazel_dep(name = "rules_oci", version = "2.0.1")
 bazel_dep(name = "rules_proto", version = "7.1.0")
 bazel_dep(name = "rules_python", version = "0.40.0")
+bazel_dep(name = "rules_rust", version = "0.63.0")
 bazel_dep(name = "rules_mypy", version = "0.29.0")
 bazel_dep(name = "rules_python_gazelle_plugin", version = "0.35.0")
 bazel_dep(name = "rules_shell", version = "0.4.1")
@@ -179,7 +180,10 @@ use_repo(
 # https://github.com/aspect-build/rules_ts/tree/main/e2e/bzlmod
 
 node = use_extension("@rules_nodejs//nodejs:extensions.bzl", "node", dev_dependency = True)
-node.toolchain(node_version = "20.18.0")
+node.toolchain(
+    include_headers = True,
+    node_version = "20.18.0",
+)
 use_repo(node, "nodejs_toolchains")
 
 pnpm = use_extension("@aspect_rules_js//npm:extensions.bzl", "pnpm")
@@ -277,3 +281,20 @@ oci.pull(
     tag = "latest",
 )
 use_repo(oci, "distroless_base", "distroless_base_linux_amd64", "distroless_base_linux_arm64", "ubuntu", "ubuntu_linux_amd64", "ubuntu_linux_arm64_v8")
+
+#########################
+# Support for Rust, see https://github.com/bazelbuild/rules_rust
+rust = use_extension("@rules_rust//rust:extensions.bzl", "rust")
+rust.toolchain(
+    edition = "2024",
+    versions = ["1.89.0"],
+)
+
+crate = use_extension("@rules_rust//crate_universe:extension.bzl", "crate")
+crate.from_cargo(
+    name = "crate_index",
+    # TODO: we should have a Cargo.toml file in the repository root
+    cargo_lockfile = "//npm_packages/napi:Cargo.lock",
+    manifests = ["//npm_packages/napi:Cargo.toml"],
+)
+use_repo(crate, "crate_index")

nodejs_apps/typescript/BUILD.bazel

@@ -11,6 +11,7 @@ ts_project(
     declaration = True,
     tsconfig = {},
     deps = [
+        ":node_modules/@bazel-examples/napi",
         ":node_modules/@bazel-examples/one",
         ":node_modules/@bazel-examples/shared",
         ":node_modules/@types/node",

nodejs_apps/typescript/package.json

@@ -3,6 +3,7 @@
     "inspirational-quotes": "2.0.1",
     "@bazel-examples/one": "workspace:*",
     "@bazel-examples/shared": "workspace:*",
+    "@bazel-examples/napi": "workspace:*",
     "@types/node": "18.11.9",
     "star-wars-quotes": "1.0.2"
   }

nodejs_apps/typescript/src/main.ts

@@ -1,12 +1,15 @@
 import { platform, arch } from 'node:os';
 import { one } from '@bazel-examples/one';
 import { shared } from '@bazel-examples/shared';
+import { rust, c } from '@bazel-examples/napi';
 import { getRandomQuote } from 'inspirational-quotes';
 import * as quotes from 'star-wars-quotes';
 
 shared();
 one();
 console.log(getRandomQuote());
 console.log(quotes());
+console.log(rust.hello('NodeJS'));
+console.log('C code does math: 1 + 2 = ' + c.add(1, 2));
 console.log('Platform: ' + platform());
 console.log('Architecture: ' + arch());

npm_packages/napi/BUILD

@@ -0,0 +1,11 @@
+load("@aspect_rules_js//js:defs.bzl", "js_library")
+load("@npm//:defs.bzl", "npm_link_all_packages")
+
+npm_link_all_packages(name = "node_modules")
+
+js_library(
+    name = "pkg",
+    srcs = ["package.json"],
+    visibility = ["//visibility:public"],
+    deps = ["//npm_packages/napi/src:tsc"],
+)

npm_packages/napi/Cargo.lock

@@ -0,0 +1,18 @@
+[package]
+name = "bazel-examples-napi"
+version = "0.1.0"
+edition = "2021"
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+napi = "3.1.0"
+napi-derive = "3.1.0"
+
+[build-dependencies]
+napi-build = "2"
+
+[profile.release]
+lto   = true
+strip = "symbols"