chore: migrate to node test runner

Author: brianleroux

.github/contributing.md

@@ -6,3 +6,47 @@
 By participating in and contributing to the Architect community — including, but not limited to its open source projects, any related online venues such as GitHub, Slack, and in-person events, etc. — you agree to the [Architect Code of Conduct](/.github/code_of_conduct.md).
 
 Lack of familiarity with this Code of Conduct is not an excuse for not adhering to it.
+
+## Development Setup
+
+### Prerequisites
+- Node.js 20+ (required for native test runner)
+- npm
+
+### Testing
+
+This project uses Node.js native test runner for all testing. The test suite is organized into unit and integration tests.
+
+**Running Tests:**
+```bash
+# Run the full test suite (includes linting, tests, and type checking)
+npm test
+
+# Run tests without linting
+npm run test:nolint
+
+# Run specific test types
+npm run test:unit        # Unit tests only
+npm run test:integration # Integration tests only  
+npm run test:types       # TypeScript type tests
+
+# Generate coverage reports
+npm run coverage         # Unit test coverage with lcov output
+npm run coverage:text    # Text-only coverage report
+npm run coverage:all     # Coverage for all tests
+```
+
+**Test Structure:**
+- `test/unit/` - Unit tests for individual modules
+- `test/integration/` - Integration tests that may require external services
+- Tests use Node.js built-in `node:test` module and `node:assert` for assertions
+- Coverage is generated using Node.js native coverage collection
+
+**Writing Tests:**
+When contributing new features or fixing bugs, please include appropriate tests:
+- Unit tests for new functions or modules
+- Integration tests for features that interact with external services
+- Use Node.js native test patterns (see existing tests for examples)
+
+**Test Migration:**
+This project was recently migrated from Tape to Node.js native test runner. See `test/MIGRATION_GUIDE.md` for details about the migration utilities and patterns used.

.github/workflows/build.yml

@@ -41,7 +41,7 @@ jobs:
       run: npm install
 
     - name: Test
-      run: npm test
+      run: npm test  # Uses Node.js native test runner (Node 20+)
       env:
         CI: true
 

contributing.md

@@ -1,5 +1,52 @@
 # Contributing
-## First: go read the [Begin Code of Conduct](https://github.com/smallwins/policy/blob/main/begin-community-code-of-conduct.md)
 
-### Agreement to the Begin Community Code of Conduct
-By participating and contributing to the Small Wins (aka Begin) community -- including, but not limited to its open source projects, any related online venues such as Github, Slack, and in-person events, etc. -- you agree to the [Begin Code of Conduct](https://github.com/smallwins/policy/blob/main/begin-community-code-of-conduct.md), found at the [Begin Policy archive](https://github.com/smallwins/policy). Lack of familiarity with this Code of Conduct is not an excuse for not adhering to it.
+## First: go read the [Architect Code of Conduct](.github/code_of_conduct.md)
+
+### Agreement to the Architect Code of Conduct
+By participating in and contributing to the Architect community — including, but not limited to its open source projects, any related online venues such as GitHub, Slack, and in-person events, etc. — you agree to the [Architect Code of Conduct](.github/code_of_conduct.md).
+
+Lack of familiarity with this Code of Conduct is not an excuse for not adhering to it.
+
+## Development Setup
+
+### Prerequisites
+- Node.js 20+ (required for native test runner)
+- npm
+
+### Testing
+
+This project uses Node.js native test runner for all testing. The test suite is organized into unit and integration tests.
+
+**Running Tests:**
+```bash
+# Run the full test suite (includes linting, tests, and type checking)
+npm test
+
+# Run tests without linting
+npm run test:nolint
+
+# Run specific test types
+npm run test:unit        # Unit tests only
+npm run test:integration # Integration tests only  
+npm run test:types       # TypeScript type tests
+
+# Generate coverage reports
+npm run coverage         # Unit test coverage with lcov output
+npm run coverage:text    # Text-only coverage report
+npm run coverage:all     # Coverage for all tests
+```
+
+**Test Structure:**
+- `test/unit/` - Unit tests for individual modules
+- `test/integration/` - Integration tests that may require external services
+- Tests use Node.js built-in `node:test` module and `node:assert` for assertions
+- Coverage is generated using Node.js native coverage collection
+
+**Writing Tests:**
+When contributing new features or fixing bugs, please include appropriate tests:
+- Unit tests for new functions or modules
+- Integration tests for features that interact with external services
+- Use Node.js native test patterns (see existing tests for examples)
+
+**Test Migration:**
+This project was recently migrated from Tape to Node.js native test runner. See `test/MIGRATION_GUIDE.md` for details about the migration utilities and patterns used.

package.json

@@ -14,10 +14,13 @@
     "lint": "eslint --fix .",
     "test": "npm run lint && npm run test:integration && npm run coverage && npm run test:types",
     "test:nolint": "npm run test:integration && npm run coverage && npm run test:types",
-    "test:unit": "cross-env tape 'test/unit/**/*-test.js'",
-    "test:integration": "cross-env tape 'test/integration/**/*-test.js'",
+    "test:unit": "node --test 'test/unit/**/*-test.js'",
+    "test:integration": "node --test --test-concurrency=1 'test/integration/**/*-test.js'",
     "test:types": "tsd --files types/*.test-d.ts",
-    "coverage": "nyc --reporter=lcov --reporter=text npm run test:unit",
+    "coverage": "node --test --experimental-test-coverage --test-reporter=spec --test-reporter=lcov --test-reporter-destination=stdout --test-reporter-destination=coverage/lcov.info 'test/unit/**/*-test.js'",
+    "coverage:text": "node --test --experimental-test-coverage --test-reporter=spec 'test/unit/**/*-test.js'",
+    "coverage:lcov": "node --test --experimental-test-coverage --test-reporter=lcov --test-reporter-destination=coverage/lcov.info 'test/unit/**/*-test.js'",
+    "coverage:all": "node --test --experimental-test-coverage --test-reporter=spec --test-reporter=lcov --test-reporter-destination=stdout --test-reporter-destination=coverage/lcov.info 'test/unit/**/*-test.js' 'test/integration/**/*-test.js'",
     "rc": "npm version prerelease --preid RC"
   },
   "engines": {
@@ -51,14 +54,9 @@
     "@aws-lite/sqs-types": "^0.2.6",
     "@types/aws-lambda": "^8.10.147",
     "@types/node": "^24.5.2",
-    "cross-env": "^10.0.0",
-    "eslint": "^9.19.0",
-    "nyc": "~17.1.0",
-    "proxyquire": "~2.1.3",
-    "sinon": "^21.0.0",
-    "tape": "^5.9.0",
-    "tiny-json-http": "^7.5.1",
-    "tsd": "^0.33.0"
+    "eslint": "9.19.0",
+    "tiny-json-http": "7.5.1",
+    "tsd": "0.33.0"
   },
   "files": [
     "types/*",

readme.md

@@ -12,6 +12,34 @@
 Check out the full docs for [this library](https://arc.codes/docs/en/reference/runtime-helpers/node.js) and [Architect](https://arc.codes)
 
 
+## Development
+
+### Testing
+
+This project uses Node.js native test runner (Node.js 20+) for testing. The test suite includes both unit and integration tests.
+
+**Run all tests:**
+```bash
+npm test
+```
+
+**Run specific test types:**
+```bash
+npm run test:unit        # Unit tests only
+npm run test:integration # Integration tests only
+npm run test:types       # TypeScript type tests
+```
+
+**Generate coverage reports:**
+```bash
+npm run coverage         # Coverage with lcov output
+npm run coverage:text    # Coverage with text output only
+npm run coverage:all     # Coverage for all tests (unit + integration)
+```
+
+The test suite uses Node.js built-in test runner and assert module. Coverage reporting is handled by Node.js native coverage collection (`--experimental-test-coverage`).
+
+
 ## Install
 
 Within your Architect project directory, add `@architect/function` to its root `package.json`: