test: run bun handwritten tests in bun runtime for firestore through pubsub plus spanner-driver

core/packages/tools/bin/run-test.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+const path = require('path');
+const fs = require('fs');
+
+// Resolve bin/run-test.cjs from the monorepo root
+let current = __dirname;
+let runTestPath;
+while (current !== path.dirname(current)) {
+  const candidate = path.join(current, 'bin', 'run-test.cjs');
+  if (fs.existsSync(candidate)) {
+    runTestPath = candidate;
+    break;
+  }
+  current = path.dirname(current);
+}
+
+if (!runTestPath) {
+  runTestPath = path.resolve(__dirname, '../../../../bin/run-test.cjs');
+}
+
+require(runTestPath);

core/packages/tools/package.json

@@ -25,7 +25,8 @@
     "compileProtos": "./bin/compileProtos.js",
     "minifyProtoJson": "./bin/minifyProtoJson.js",
     "prepublishProtos": "./bin/prepublishProtos.js",
-    "listProtos": "./bin/listProtos.js"
+    "listProtos": "./bin/listProtos.js",
+    "run-test": "./bin/run-test.js"
   },
   "author": "Google API Authors",
   "license": "Apache-2.0",

handwritten/bigquery-storage/package.json

@@ -21,8 +21,8 @@
     "prelint": "cd samples; npm link ../; npm install",
     "lint": "gts check",
     "prepare": "npm run compile",
-    "system-test": "node ../../bin/run-test.cjs --config ../../.mocharc.cjs --no-parallel build/system-test --timeout 600000",
-    "test": "node ../../bin/run-test.cjs --config ../../.mocharc.cjs build/test",
+    "system-test": "run-test build/system-test --timeout 600000",
+    "test": "run-test build/test",
     "samples-test": "cd samples/ && npm link ../ && npm test && cd ../",
     "precompile": "gts clean"
   },

handwritten/bigquery/package.json

@@ -36,8 +36,8 @@
     "docs": "jsdoc -c .jsdoc.js",
     "lint": "gts check",
     "samples-test": "cd samples/ && pnpm link ../ && pnpm test && cd ../",
-    "test": "node ../../bin/run-test.cjs --config ../../.mocharc.cjs build/test",
-    "system-test": "node ../../bin/run-test.cjs --config ../../.mocharc.cjs --no-parallel build/system-test --timeout 600000",
+    "test": "run-test build/test",
+    "system-test": "run-test build/system-test --timeout 600000",
     "presystem-test": "pnpm run compile",
     "clean": "gts clean",
     "compile": "tsc -p . && cp src/types.d.ts build/src/",

handwritten/cloud-profiler/package.json

@@ -10,7 +10,7 @@
   "main": "build/src/index.js",
   "types": "build/src/index.d.ts",
   "scripts": {
-    "test": "node ../../bin/run-test.cjs --config ../../.mocharc.cjs 'build/test/test-*.js'",
+    "test": "run-test 'build/test/test-*.js'",
     "system-test": "echo 'skipping tests for time being'",
     "samples-test": "echo 'no sample tests'",
     "clean": "gts clean",

handwritten/datastore/package.json

@@ -36,9 +36,9 @@
     "prepare": "npm run compile",
     "samples-test": "cd samples/ && npm link ../ && npm install && npm test && cd ../",
     "presystem-test": "npm run compile",
-    "system-test": "node ../../bin/run-test.cjs --config ../../.mocharc.cjs --no-parallel build/system-test --timeout 600000",
+    "system-test": "run-test build/system-test --timeout 600000",
     "pretest": "npm run compile",
-    "test": "node ../../bin/run-test.cjs --config ../../.mocharc.cjs build/test",
+    "test": "run-test build/test",
     "precompile": "gts clean"
   },
   "dependencies": {

handwritten/error-reporting/package.json

@@ -22,8 +22,8 @@
     "docs": "compodoc src/",
     "lint": "gts check",
     "presystem-test": "pnpm run compile",
-    "system-test": "MOCHA_THROW_DEPRECATION=false node ../../bin/run-test.cjs --config ../../.mocharc.cjs --no-parallel build/system-test",
-    "test": "node ../../bin/run-test.cjs --config ../../.mocharc.cjs build/test/unit",
+    "system-test": "MOCHA_THROW_DEPRECATION=false run-test build/system-test",
+    "test": "run-test build/test/unit",
     "clean": "gts clean",
     "compile": "tsc -p .",
     "fix": "gts fix",

handwritten/firestore/package.json

@@ -39,20 +39,20 @@
     "api-report": "node scripts/api-report.mjs",
     "predocs": "pnpm run compile",
     "docs": "jsdoc -c .jsdoc.js",
-    "system-test:rest": "FIRESTORE_DATABASE_ID=firestore-standard FIRESTORE_PREFER_REST=true mocha build/system-test --timeout 1200000",
-    "system-test:enterprise:rest": "RUN_ENTERPRISE_TESTS=yes FIRESTORE_DATABASE_ID=firestore-enterprise FIRESTORE_PREFER_REST=true mocha build/system-test --timeout 1200000",
-    "system-test:grpc": "FIRESTORE_DATABASE_ID=firestore-standard mocha build/system-test --timeout 1200000",
-    "system-test:enterprise:grpc": "RUN_ENTERPRISE_TESTS=yes FIRESTORE_DATABASE_ID=firestore-enterprise mocha build/system-test --timeout 1200000",
-    "system-test:emulator:rest": "FIRESTORE_EMULATOR_HOST=localhost:8080 FIRESTORE_PREFER_REST=true mocha build/system-test --timeout 1200000",
-    "system-test:enterprise:emulator:rest": "RUN_ENTERPRISE_TESTS=yes FIRESTORE_DATABASE_ID=firestore-enterprise FIRESTORE_EMULATOR_HOST=localhost:8080 FIRESTORE_PREFER_REST=true mocha build/system-test --timeout 1200000",
-    "system-test:emulator:grpc": "FIRESTORE_EMULATOR_HOST=localhost:8080 mocha build/system-test --timeout 1200000",
-    "system-test:enterprise:emulator:grpc": "RUN_ENTERPRISE_TESTS=yes FIRESTORE_DATABASE_ID=firestore-enterprise FIRESTORE_EMULATOR_HOST=localhost:8080 mocha build/system-test --timeout 1200000",
+    "system-test:rest": "FIRESTORE_DATABASE_ID=firestore-standard FIRESTORE_PREFER_REST=true run-test build/system-test --timeout 1200000",
+    "system-test:enterprise:rest": "RUN_ENTERPRISE_TESTS=yes FIRESTORE_DATABASE_ID=firestore-enterprise FIRESTORE_PREFER_REST=true run-test build/system-test --timeout 1200000",
+    "system-test:grpc": "FIRESTORE_DATABASE_ID=firestore-standard run-test build/system-test --timeout 1200000",
+    "system-test:enterprise:grpc": "RUN_ENTERPRISE_TESTS=yes FIRESTORE_DATABASE_ID=firestore-enterprise run-test build/system-test --timeout 1200000",
+    "system-test:emulator:rest": "FIRESTORE_EMULATOR_HOST=localhost:8080 FIRESTORE_PREFER_REST=true run-test build/system-test --timeout 1200000",
+    "system-test:enterprise:emulator:rest": "RUN_ENTERPRISE_TESTS=yes FIRESTORE_DATABASE_ID=firestore-enterprise FIRESTORE_EMULATOR_HOST=localhost:8080 FIRESTORE_PREFER_REST=true run-test build/system-test --timeout 1200000",
+    "system-test:emulator:grpc": "FIRESTORE_EMULATOR_HOST=localhost:8080 run-test build/system-test --timeout 1200000",
+    "system-test:enterprise:emulator:grpc": "RUN_ENTERPRISE_TESTS=yes FIRESTORE_DATABASE_ID=firestore-enterprise FIRESTORE_EMULATOR_HOST=localhost:8080 run-test build/system-test --timeout 1200000",
     "system-test": "concurrently -p \"[{name}]\" -n \"grpc,rest,enterprise-grpc,enterprise-rest\" -c \"cyan,magenta,blue,yellow\" \"pnpm:system-test:grpc\" \"pnpm:system-test:rest\" \"pnpm:system-test:enterprise:grpc\" \"pnpm:system-test:enterprise:rest\"",
-    "system-test:nightly": "FIRESTORE_TARGET_BACKEND=nightly FIRESTORE_DATABASE_ID=enterprise RUN_ENTERPRISE_TESTS=yes GCLOUD_PROJECT=firestore-sdk-nightly mocha build/system-test --timeout 1200000",
+    "system-test:nightly": "FIRESTORE_TARGET_BACKEND=nightly FIRESTORE_DATABASE_ID=enterprise RUN_ENTERPRISE_TESTS=yes GCLOUD_PROJECT=firestore-sdk-nightly run-test build/system-test --timeout 1200000",
     "system-test:emulator": "concurrently -p \"[{name}]\" -n \"grpc,rest,enterprise-grpc,enterprise-rest\" -c \"cyan,magenta,blue,yellow\" \"pnpm:system-test:emulator:grpc\" \"pnpm:system-test:emulator:rest\" \"pnpm:system-test:enterprise:emulator:grpc\" \"pnpm:system-test:enterprise:emulator:rest\"",
     "presystem-test": "pnpm run compile",
-    "conformance": "mocha build/conformance",
-    "test-only": "c8 mocha build/test",
+    "conformance": "run-test build/conformance",
+    "test-only": "run-test build/test",
     "pretest": "pnpm run compile",
     "test": "pnpm run test-only && pnpm run conformance",
     "lint": "gts check",

handwritten/google-cloud-dns/package.json

@@ -33,10 +33,10 @@
   "scripts": {
     "docs": "jsdoc -c .jsdoc.js",
     "lint": "gts check",
-    "test": "c8 mocha build/test",
+    "test": "run-test build/test",
     "samples-test": "pnpm run compile && cd samples/ && pnpm link ../ && pnpm i && pnpm test",
     "presystem-test": "pnpm run compile",
-    "system-test": "pnpm run compile && c8 mocha build/system-test",
+    "system-test": "pnpm run compile && run-test build/system-test",
     "clean": "gts clean",
     "compile": "tsc -p .",
     "fix": "gts fix",

handwritten/logging-bunyan/package.json

@@ -41,8 +41,8 @@
     "presamples-test": "pnpm run compile",
     "presystem-test": "pnpm run compile",
     "samples-test": "cd samples/ && npm link ../ && npm test && cd ../",
-    "system-test": "mocha build/system-test --timeout 600000",
-    "test": "cross-env NODE_OPTIONS='--no-deprecation' c8 mocha --recursive build/test",
+    "system-test": "run-test build/system-test --timeout 600000",
+    "test": "cross-env NODE_OPTIONS='--no-deprecation' run-test build/test",
     "clean": "gts clean",
     "compile": "tsc -p .",
     "postcompile": "cpy \"src/types/*\" build/src/types",

handwritten/logging-winston/package.json

@@ -41,8 +41,8 @@
     "presamples-test": "pnpm run compile",
     "samples-test": "cd samples/ && npm link ../ && npm test && cd ../",
     "presystem-test": "pnpm run pretest",
-    "system-test": "mocha build/system-test --timeout 600000",
-    "test": "cross-env NODE_OPTIONS='--no-deprecation' c8 mocha --recursive build/test",
+    "system-test": "run-test build/system-test --timeout 600000",
+    "test": "cross-env NODE_OPTIONS='--no-deprecation' run-test build/test",
     "clean": "gts clean",
     "compile": "tsc -p .",
     "fix": "gts fix",

handwritten/logging/package.json

@@ -38,9 +38,9 @@
     "prepare": "npm run compile",
     "samples-test": "cd samples/ && npm link ../ && npm test && cd ../",
     "presystem-test": "pnpm run compile",
-    "system-test": "mocha build/system-test --timeout 600000",
+    "system-test": "run-test build/system-test --timeout 600000",
     "pretest": "pnpm run compile",
-    "test": "cross-env NODE_OPTIONS='--no-deprecation' c8 mocha build/test",
+    "test": "cross-env NODE_OPTIONS='--no-deprecation' run-test build/test",
     "precompile": "gts clean",
     "postpublish": "./.kokoro/publish-min.sh"
   },

handwritten/logging/test/log-sync.ts

@@ -23,6 +23,7 @@ import * as logCommon from '../src/utils/log-common';
 import * as stream from 'stream';
 import * as extend from 'extend';
 import * as fs from 'fs';
+import * as instrumentation from '../src/utils/instrumentation';
 
 describe('LogSync', () => {
   const PROJECT_ID = 'project-id';
@@ -95,14 +96,21 @@ describe('LogSync', () => {
     let buffer: stream.Writable;
 
     beforeEach(() => {
+      // Prevent automatic diagnostic instrumentation from writing an extra log
+      // entry to the transport stream during tests.
+      instrumentation.setInstrumentationStatus(true);
       ENTRY = new Entry(undefined, 'testlog');
       ENTRIES = [ENTRY] as Entry[];
       OPTIONS = {} as WriteOptions;
       log = createLogger();
     });
 
     afterEach(() => {
-      fs.rmSync(TEST_FILE, {force: true});
+      try {
+        fs.rmSync(TEST_FILE, {force: true});
+      } finally {
+        instrumentation.setInstrumentationStatus(false);
+      }
     });
 
     function createLogger() {

handwritten/pubsub/package.json

@@ -32,10 +32,10 @@
   ],
   "scripts": {
     "presystem-test": "pnpm run compile",
-    "system-test": "mocha build/system-test --timeout 600000",
+    "system-test": "run-test build/system-test --timeout 600000",
     "samples-test": "pnpm run link-samples && pnpm test && cd ../",
     "link-samples": "cd samples/ && pnpm link ../ && pnpm install",
-    "test": "c8 mocha build/test --recursive",
+    "test": "run-test build/test",
     "lint": "gts check",
     "predocs": "pnpm run compile",
     "docs": "jsdoc -c .jsdoc.js",

handwritten/pubsub/test/message-queues.ts

@@ -733,8 +733,12 @@ describe('MessageQueues', () => {
         .resolves();
 
       modAckQueue.setOptions({callOptions: fakeCallOptions});
-      await modAckQueue.add(new FakeMessage() as Message, 10);
-      await modAckQueue.flush('test');
+      // add() returns a promise that only resolves when the batch is flushed.
+      // We must flush before awaiting completion; awaiting add() directly causes
+      // a deadlock that timed out under Bun where background fallback timers
+      // are not scheduled while blocked on unresolved promises.
+      const completion = modAckQueue.add(new FakeMessage() as Message, 10);
+      await Promise.all([completion, modAckQueue.flush('test')]);
 
       const [, callOptions] = stub.lastCall.args;
       assert.strictEqual(callOptions, fakeCallOptions);

handwritten/spanner-driver/package.json

@@ -39,10 +39,10 @@
     "lint": "gts check",
     "prepare": "npm run compile",
     "pretest": "pnpm run compile",
-    "test:esm": "c8 mocha build/esm/test/unit/**/*.js",
-    "test:cjs": "c8 mocha build/cjs/test/unit/**/*.js",
+    "test:esm": "run-test build/esm/test/unit/**/*.js",
+    "test:cjs": "run-test build/cjs/test/unit/**/*.js",
     "test": "pnpm run test:esm && pnpm run test:cjs",
-    "system-test": "mocha build/esm/system-test/**/*.js --timeout 60000",
+    "system-test": "run-test build/esm/system-test/**/*.js --timeout 60000",
     "test:pg-suite": "node test/pg-suite/run_pg_suite.cjs"
   },
   "dependencies": {

package.json

@@ -51,6 +51,7 @@
     "eslint-plugin-n": "^15.7.0",
     "eslint-plugin-prettier": "^5.2.1",
     "eslint-plugin-promise": "^6.1.1",
+    "gapic-tools": "workspace:*",
     "gts": "^6.0.2",
     "prettier": "^3.3.3",
     "turbo": "^2.0.14",