feat: add support for BigInt callback arguments

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: passed
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: na
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: passed
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: passed
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: kgryte

lib/node_modules/@stdlib/napi/argv-uint32/README.md

@@ -137,7 +137,7 @@ The function accepts the following arguments:
 -   **value**: `[in] napi_value` Node-API value.
 -   **out**: `[out] uint32_t*` destination for storing output value.
 -   **message**: `[in] char*` error message.
--   **err**: `[out] napi_value*` pointer for storing a JavaScript error. If not provided a number, the function sets `err` with a JavaScript error; otherwise, `err` is set to `NULL`.
+-   **err**: `[out] napi_value*` pointer for storing a JavaScript error. If not provided a number or `BigInt`, the function sets `err` with a JavaScript error; otherwise, `err` is set to `NULL`.
 
 ```c
 napi_status stdlib_napi_argv_uint32( const napi_env env, const napi_value value, uint32_t *out, const char *message, napi_value *err );
@@ -189,6 +189,10 @@ The macro expects the following arguments:
 
 <section class="notes">
 
+## Notes
+
+-   The function supports the conversion of both `number` and `BigInt` add-on callback arguments.
+
 </section>
 
 <!-- /.notes -->

lib/node_modules/@stdlib/napi/argv-uint32/src/main.c

@@ -21,6 +21,7 @@
 #include "stdlib/assert/napi/is_type.h"
 #include <node_api.h>
 #include <stdint.h>
+#include <stdbool.h>
 
 /**
 * Converts a Node-API value to an unsigned 32-bit integer.
@@ -55,10 +56,20 @@
 * }
 */
 napi_status stdlib_napi_argv_uint32( const napi_env env, const napi_value value, uint32_t *out, const char *message, napi_value *err ) {
+	bool lossless = true;
+	uint64_t tmp = 0;
+
 	stdlib_assert_napi_value_is_type( env, value, napi_number, message, err );
-	if ( *err != NULL ) {
+	if ( *err == NULL ) {
+		STDLIB_ASSERT_NAPI_STATUS_OK_RET_VALUE( env, napi_get_value_uint32( env, value, out ), "", napi_ok )
+		return napi_ok;
+	}
+	*err = NULL;
+	stdlib_assert_napi_value_is_type( env, value, napi_bigint, message, err );
+	if ( *err == NULL ) {
+		STDLIB_ASSERT_NAPI_STATUS_OK_RET_VALUE( env, napi_get_value_bigint_uint64( env, value, &tmp, &lossless ), "", napi_ok )
+		*out = (uint32_t)(tmp);
 		return napi_ok;
 	}
-	STDLIB_ASSERT_NAPI_STATUS_OK_RET_VALUE( env, napi_get_value_uint32( env, value, out ), "", napi_ok )
 	return napi_ok;
 }

lib/node_modules/@stdlib/napi/argv-uint32/test/test.native.js

@@ -22,6 +22,9 @@
 
 var resolve = require( 'path' ).resolve;
 var tape = require( 'tape' );
+var Number = require( '@stdlib/number/ctor' );
+var BigInt = require( '@stdlib/bigint/ctor' );
+var hasBigIntSupport = require( '@stdlib/assert/has-bigint-support' );
 var tryRequire = require( '@stdlib/utils/try-require' );
 
 
@@ -82,3 +85,21 @@ tape( 'the function does not throw an error if provided a number', opts, functio
 	}
 	t.end();
 });
+
+opts.skip = opts.skip || !hasBigIntSupport();
+tape( 'the function does not throw an error if provided a BigInt', opts, function test( t ) {
+	var values;
+	var v;
+	var i;
+
+	values = [
+		BigInt( 5 ),
+		BigInt( 15 ),
+		BigInt( 0 )
+	];
+	for ( i = 0; i < values.length; i++ ) {
+		v = addon( values[ i ] );
+		t.strictEqual( v, Number( values[ i ] ), 'returns expected value when provided '+values[ i ] );
+	}
+	t.end();
+});