[CI] Add node.js integration tests

Author: ohaibbq

.github/workflows/test.yml

@@ -140,3 +140,43 @@ jobs:
       env:
         BIGQUERY_EMULATOR_REPOSITORY: bigquery-emulator
         BIGQUERY_EMULATOR_VERSION: test
+
+  node-integration-test:
+    needs: build
+    name: Node.js Integration Test
+    runs-on: ubuntu-latest
+    steps:
+    - name: checkout
+      uses: actions/checkout@v4
+    - name: setup docker buildx
+      uses: docker/setup-buildx-action@v3
+    - name: build docker image
+      uses: docker/build-push-action@v6
+      with:
+        context: .
+        load: true
+        tags: bigquery-emulator:test
+        platforms: linux/amd64
+        push: false
+    - name: setup node
+      uses: actions/setup-node@v4
+      with:
+        node-version: '24'
+    - name: enable corepack
+      run: corepack enable
+    - name: cache yarn dependencies
+      uses: actions/cache@v4
+      with:
+        path: test/node/.yarn/cache
+        key: ${{ runner.os }}-yarn-${{ hashFiles('test/node/yarn.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-yarn-
+    - name: install dependencies
+      run: yarn install --immutable
+      working-directory: test/node
+    - name: run integration tests
+      run: yarn test
+      working-directory: test/node
+      env:
+        BIGQUERY_EMULATOR_REPOSITORY: bigquery-emulator
+        BIGQUERY_EMULATOR_VERSION: test

test/node/.gitignore

@@ -0,0 +1,36 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+*.tsbuildinfo
+
+# Test coverage
+coverage/
+.nyc_output/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Temporary files
+*.tmp
+.cache/

test/node/README.md

@@ -0,0 +1,73 @@
+# BigQuery Emulator - Node.js/TypeScript Tests
+
+This directory contains Node.js/TypeScript tests for the BigQuery emulator using Vitest and Testcontainers.
+
+## Overview
+
+These tests verify that the BigQuery emulator works correctly with the official `@google-cloud/bigquery` Node.js client library.
+
+## Prerequisites
+
+- Node.js 24+
+- Yarn package manager
+- Docker (for Testcontainers to launch the emulator)
+
+## Installation
+
+Install dependencies using Yarn:
+
+```bash
+cd test/node
+yarn install
+```
+
+## Running Tests
+
+### Run all tests
+
+```bash
+yarn test
+```
+
+### Run tests in watch mode
+
+```bash
+yarn test:watch
+```
+
+### Run tests with coverage
+
+```bash
+yarn test:coverage
+```
+
+### Type checking only
+
+```bash
+yarn typecheck
+```
+
+## Environment Variables
+
+- `BIGQUERY_EMULATOR_REPOSITORY` - Docker repository for the emulator image (default: `ghcr.io/recidiviz/bigquery-emulator`)
+- `BIGQUERY_EMULATOR_VERSION` - Docker image tag (default: `latest`)
+- `VITEST_POOL_ID` - Worker ID for parallel test execution (automatically set by Vitest)
+
+
+## Contributing
+
+When adding new tests:
+
+1. Follow the existing test structure and naming conventions
+2. Use the `BigQueryTestHelper` class for common operations
+3. Clean up test data in `afterEach` hooks
+4. Add comprehensive assertions to verify behavior
+5. Include links to Google documentation and filed issues alongside the testcase
+
+## Related Documentation
+
+- [BigQuery Emulator Main README](../../README.md)
+- [Python Testing Guide](../python/README.md)
+- [Google Cloud BigQuery Node.js Client](https://github.com/googleapis/nodejs-bigquery)
+- [Vitest Documentation](https://vitest.dev/)
+- [Testcontainers Node.js](https://node.testcontainers.org/)

test/node/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "bigquery-emulator-node-tests",
+  "version": "1.0.0",
+  "description": "Node.js/TypeScript tests for BigQuery Emulator",
+  "type": "module",
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "bigquery",
+    "emulator",
+    "testing"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@google-cloud/bigquery": "^8.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.1",
+    "@vitest/coverage-v8": "^4.0.18",
+    "testcontainers": "^11.11.0",
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.18"
+  },
+  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
+}