feat(NODE-6539): add base napi C++ template with standard Node team tooling

.clang-format

@@ -0,0 +1,15 @@
+BasedOnStyle: Google
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+BinPackArguments: false
+BinPackParameters: false
+ColumnLimit: 100
+Cpp11BracedListStyle: true
+DerivePointerAlignment: false
+IndentWidth: 4
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: None
+SpaceBeforeAssignmentOperators: true
+Standard: Cpp11
+UseTab: Never

.eslintrc.json

@@ -0,0 +1,85 @@
+{
+	"root": true,
+	"extends": [
+	  "eslint:recommended",
+	  "plugin:prettier/recommended",
+	  "plugin:@typescript-eslint/eslint-recommended",
+	  "plugin:@typescript-eslint/recommended"
+	],
+	"ignorePatterns": "lib/**/*",
+	"env": {
+	  "node": true,
+	  "mocha": true,
+	  "es6": true
+	},
+	"parserOptions": {
+	  "ecmaVersion": 2019
+	},
+	"plugins": [
+	  "@typescript-eslint",
+	  "prettier"
+	],
+	"rules": {
+	  "no-restricted-properties": [
+		"error",
+		{
+		  "object": "describe",
+		  "property": "only"
+		},
+		{
+		  "object": "it",
+		  "property": "only"
+		},
+		{
+		  "object": "context",
+		  "property": "only"
+		}
+	  ],
+	  "prettier/prettier": "error",
+	  "no-console": "error",
+	  "valid-typeof": "error",
+	  "eqeqeq": [
+		"error",
+		"always",
+		{
+		  "null": "ignore"
+		}
+	  ],
+	  "strict": [
+		"error",
+		"global"
+	  ],
+	  "no-restricted-syntax": [
+		"error",
+		{
+		  "selector": "TSEnumDeclaration",
+		  "message": "Do not declare enums"
+		},
+		{
+		  "selector": "BinaryExpression[operator=/[=!]==/] Identifier[name='undefined']",
+		  "message": "Do not strictly check undefined"
+		},
+		{
+		  "selector": "BinaryExpression[operator=/[=!]==/] Literal[raw='null']",
+		  "message": "Do not strictly check null"
+		},
+		{
+		  "selector": "BinaryExpression[operator=/[=!]==?/] Literal[value='undefined']",
+		  "message": "Do not strictly check typeof undefined (NOTE: currently this rule only detects the usage of 'undefined' string literal so this could be a misfire)"
+		}
+	  ],
+	  "@typescript-eslint/no-require-imports": "off"
+	},
+	"overrides": [
+	  {
+		"files": [
+		  "test/**/*ts"
+		],
+		"rules": {
+		  // chat `expect(..)` style chaining is considered
+		  // an unused expression
+		  "@typescript-eslint/no-unused-expressions": "off"
+		}
+	  }
+	]
+  }

.github/workflows/test.yml

@@ -0,0 +1,72 @@
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch: {}
+
+name: Test
+
+jobs:
+  host_tests:
+    strategy:
+      matrix:
+        # os: [macos-latest, windows-2019]
+        os: ['ubuntu-latest']
+        node: [16.x, 18.x, 20.x, 22.x]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Build with Node.js ${{ matrix.node }} on ${{ matrix.os }}
+        run: npm install && npm run compile
+        shell: bash
+
+      - name: Test ${{ matrix.os }}
+        shell: bash
+        run: npm test
+
+  # container_tests:
+  #   runs-on: ubuntu-latest
+  #   strategy:
+  #     matrix:
+  #       linux_arch: [s390x, arm64, amd64]
+  #       node: [16.x, 18.x, 20.x, 22.x]
+  #   steps:
+  #     - uses: actions/checkout@v4
+
+  #     - uses: actions/setup-node@v4
+  #       with:
+  #         node-version: ${{ matrix.node }}
+
+  #     - name: Get Full Node.js Version
+  #       id: get_nodejs_version
+  #       shell: bash
+  #       run: |
+  #         echo "version=$(node --print 'process.version.slice(1)')" >> "$GITHUB_OUTPUT"
+  #         echo "ubuntu_version=$(node --print '(+process.version.slice(1).split(`.`).at(0)) > 16 ? `noble` : `bionic`')" >> "$GITHUB_OUTPUT"
+
+  #     - name: Set up QEMU
+  #       uses: docker/setup-qemu-action@v3
+
+  #     - name: Set up Docker Buildx
+  #       uses: docker/setup-buildx-action@v3
+
+  #     - name: Run Buildx
+  #       run: |
+  #         docker buildx create --name builder --bootstrap --use
+  #         docker buildx build \
+  #           --platform linux/${{ matrix.linux_arch }} \
+  #           --build-arg="NODE_ARCH=${{ matrix.linux_arch == 'amd64' && 'x64' || matrix.linux_arch }}" \
+  #           --build-arg="NODE_VERSION=${{ steps.get_nodejs_version.outputs.version }}" \
+  #           --build-arg="UBUNTU_VERSION=${{ steps.get_nodejs_version.outputs.ubuntu_version }}" \
+  #           --build-arg="RUN_TEST=true" \
+  #           --output type=local,dest=./prebuilds,platform-split=false \
+  #           -f ./.github/docker/Dockerfile.glibc \
+  #           .

.gitignore

@@ -10,7 +10,7 @@ lib-cov
 .DS_Store
 
 .vscode
-
+xunit.xml
 pids
 logs
 results

.mocharc.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://raw.githubusercontent.com/SchemaStore/schemastore/master/src/schemas/json/mocharc.json",
+  "require": [
+    "source-map-support/register",
+    "test/tools/chai-addons.js"
+  ],
+  "extension": [
+    "ts"
+  ],
+  "recursive": true,
+  "failZero": true,
+  "reporter": "test/tools/mongodb_reporter.js",
+  "color": true
+}

.prettierrc.json

@@ -0,0 +1,7 @@
+{
+  "singleQuote": true,
+  "tabWidth": 2,
+  "printWidth": 100,
+  "arrowParens": "avoid",
+  "trailingComma": "none"
+}

binding.gyp

@@ -0,0 +1,28 @@
+{
+  'targets': [{
+    'target_name': 'zstd',
+    'type': 'loadable_module',
+    'defines': ['ZSTD_STATIC_LINKING_ONLY'],
+    'include_dirs': [
+        "<!(node -p \"require('node-addon-api').include_dir\")"
+    ],
+    'variables': {
+      'ARCH': '<(host_arch)',
+      'built_with_electron%': 0
+    },
+    'sources': [
+      'src/addon.cpp'
+    ],
+    'xcode_settings': {
+      'GCC_ENABLE_CPP_EXCEPTIONS': 'YES',
+      'CLANG_CXX_LIBRARY': 'libc++',
+      'MACOSX_DEPLOYMENT_TARGET': '10.12',
+      'GCC_SYMBOLS_PRIVATE_EXTERN': 'YES', # -fvisibility=hidden
+    },
+    'cflags!': [ '-fno-exceptions' ],
+    'cflags_cc!': [ '-fno-exceptions' ],
+    'msvs_settings': {
+      'VCCLCompilerTool': { 'ExceptionHandling': 1 },
+    }
+  }]
+}

index.js

@@ -1,4 +1,4 @@
-const { compress: _compress, decompress: _decompress } = require('./bindings');
+const { compress: _compress, decompress: _decompress } = require('bindings')('zstd');
 
 // Error objects created via napi don't have JS stacks; wrap them so .stack is present
 // https://github.com/nodejs/node/issues/25318#issuecomment-451068073