chore: migrate package manager from Yarn to Bun (#638)

* chore: migrate package manager from Yarn to Bun

Swaps yarn.lock for bun.lock and updates package.json scripts to invoke
`bun run` / `bunx` instead of `yarn`. Doc comments in scripts/ and the
test setup error message are updated accordingly.

Three deps are pinned to exact versions to preserve the resolutions
yarn.lock had (Bun's stricter prerelease semver otherwise upgrades the
shared lint/format configs and breaks lint cleanliness):
- prettier 3.0.3
- @snapshot-labs/eslint-config 0.1.0-beta.18
- @snapshot-labs/prettier-config 0.1.0-beta.7

A single `overrides` entry pins @snapshot-labs/eslint-config-base to
0.1.0-beta.18 for the same reason.

CI workflows are pointed at snapshot-labs/actions@feat/bun-support with
`package_manager: bun`; will need to be repointed to @main once that PR
lands.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore: pin test deps to yarn-locked versions

ts-jest, jest, jest-environment-node-single-context, @types/jest, and
lodash drifted upward when Bun resolved fresh against the ^x.y.z
ranges. ts-jest 29.4 in particular was 35x slower at compiling the
test suite (~1s under 29.1.1, >30s under 29.4.9), which pushed the CI
test step past the 2-minute timeout.

Pins them to the exact versions yarn.lock had to keep test behavior
unchanged across the package-manager swap.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore: pin ajv to 8.11.0 to work around schema-compile bug

@snapshot-labs/snapshot.js requests ajv ^8.11.0; yarn happened to lock
this at 8.11.0, but Bun resolves fresh and gets 8.20.0, which generates
invalid JS in compiled validators ("SyntaxError: Unexpected token ':'")
for the snapshot.js space schema. This caused 19 test failures in CI.

Adding ajv@8.11.0 as a direct dependency hoists it to root, so
snapshot.js picks it up. eslint's transitive ajv (^6.x) lands nested
under node_modules/eslint/node_modules/ajv and stays untouched.

A scoped override would have been cleaner but Bun does not yet support
nested overrides (oven-sh/bun#6608).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore: pin ofetch to 1.3.3 to match yarn-locked version

@snapshot-labs/pineapple requests ofetch ^1.3.3; yarn locked 1.3.3 but
Bun resolves to 1.5.1 fresh, which breaks the integration tests in
test/integration/ingestor.test.ts (real pin calls return "pinning
failed" instead of succeeding).

Pineapple is the only consumer of ofetch in this project, so a global
override is safe.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore: point CI workflows back to actions@main

* chore(deps): bump @snapshot-labs/snapshot.js from 0.14.20 to 0.14.21

0.14.21 pins ajv at exact 8.11.0 (was ^8.11.0), which prevents bun from
resolving snapshot.js's transitive ajv to the broken 8.20.0 (codegen bug
in `ajv-errors@3.0.0` paired with ajv@8.20.0 — `SyntaxError: Unexpected
token ':'`).

The direct `ajv: 8.11.0` dep stays because bun's hoisting still installs
separate ajv copies under snapshot.js / ajv-formats / ajv-errors when
their peer ajv constraint is `^8.0.0` rather than `8.11.0` — different
copies break ajv-errors's vocabulary registration even when versions
match. Forcing a single ajv at root (via this direct dep) is still the
only way to deduplicate until bun supports nested overrides.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore(deps): document why ajv is a direct dep

Add a //ajv field explaining that the explicit ajv dependency exists
purely to force bun to hoist a single ajv 8.x copy at the root, since
bun won't dedupe ajv across snapshot.js / ajv-formats / ajv-errors when
eslint's transitive ajv@^6.x is also in the tree. Without it, each
8.x consumer gets its own nested copy (same version, different module
identities) and ajv-errors's vocabulary registration breaks.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: Wan <495709+wa0x6e@users.noreply.github.com>
Co-authored-by: Tony <tony@Tonys-Mac-mini.local>

Author: 4 people

.github/workflows/create-sentry-release.yml

@@ -10,5 +10,6 @@ jobs:
     uses: snapshot-labs/actions/.github/workflows/create-sentry-release.yml@main
     secrets: inherit
     with:
+      package_manager: bun
       project: snapshot-sequencer
       sourcemaps: './build'

.github/workflows/lint.yml

@@ -6,3 +6,5 @@ jobs:
   lint:
     uses: snapshot-labs/actions/.github/workflows/lint.yml@main
     secrets: inherit
+    with:
+      package_manager: bun

.github/workflows/test.yml

@@ -7,6 +7,7 @@ jobs:
     uses: snapshot-labs/actions/.github/workflows/test.yml@main
     secrets: inherit
     with:
+      package_manager: bun
       mysql_database_name: snapshot_sequencer_test
       mysql_schema_path: 'test/schema.sql'
       redis: true

bun.lock

@@ -2,19 +2,20 @@
   "name": "snapshot-sequencer",
   "version": "0.1.3",
   "license": "MIT",
+  "//ajv": "ajv 8.11.0 is a transitive dep of @snapshot-labs/snapshot.js (also used by ajv-formats and ajv-errors). Pinned at this level to force a single hoisted copy at node_modules/ajv. Without it, bun puts eslint's ajv@^6.x in the root slot and gives snapshot.js / ajv-formats / ajv-errors each their own nested 8.x copy — same version, different module identities, which breaks ajv-errors's vocabulary registration ('SyntaxError: Unexpected token :'). Drop this dep when bun supports nested overrides (oven-sh/bun#6608) or ajv-errors is replaced upstream.",
   "scripts": {
     "lint": "eslint src/ test/ --ext .ts",
-    "lint:fix": "yarn lint --fix",
+    "lint:fix": "bun run lint --fix",
     "typecheck": "tsc --noEmit",
     "build": "tsc",
     "dev": "nodemon src/index.ts",
     "start": "node build/src/index.js",
-    "start:test": "dotenv -e test/.env.test yarn dev",
-    "test:setup": "dotenv -e test/.env.test yarn ts-node ./test/setupDb.ts",
-    "test": "yarn test:setup; PORT=3003 start-server-and-test 'yarn start:test' http://localhost:3003 'dotenv -e test/.env.test jest --runInBand'",
+    "start:test": "dotenv -e test/.env.test bun run dev",
+    "test:setup": "dotenv -e test/.env.test bunx ts-node ./test/setupDb.ts",
+    "test": "bun run test:setup; PORT=3003 start-server-and-test 'bun run start:test' http://localhost:3003 'dotenv -e test/.env.test jest --runInBand'",
     "test:unit": "dotenv -e test/.env.test jest --runInBand --collectCoverage=false test/unit",
     "test:integration": "dotenv -e test/.env.test jest --runInBand --collectCoverage=false test/integration",
-    "test:e2e": "PORT=3003 start-server-and-test 'yarn start:test' http://localhost:3003 'dotenv -e test/.env.test jest --runInBand --collectCoverage=false test/e2e/'"
+    "test:e2e": "PORT=3003 start-server-and-test 'bun run start:test' http://localhost:3003 'dotenv -e test/.env.test jest --runInBand --collectCoverage=false test/e2e/'"
   },
   "eslintConfig": {
     "extends": "@snapshot-labs"
@@ -32,14 +33,15 @@
     "@snapshot-labs/pineapple": "^1.2.1",
     "@snapshot-labs/snapshot-metrics": "^1.4.1",
     "@snapshot-labs/snapshot-sentry": "^1.5.5",
-    "@snapshot-labs/snapshot.js": "^0.14.20",
+    "@snapshot-labs/snapshot.js": "^0.14.21",
+    "ajv": "8.11.0",
     "bluebird": "^3.7.2",
     "connection-string": "^1.0.1",
     "cors": "^2.8.5",
     "dotenv": "^16.0.2",
     "express": "^4.18.1",
     "express-rate-limit": "^6.9.0",
-    "lodash": "^4.17.21",
+    "lodash": "4.17.21",
     "mysql": "^2.18.1",
     "node-fetch": "^2.7.0",
     "rate-limit-redis": "^3.1.0",
@@ -50,19 +52,23 @@
     "winston": "^3.8.2",
     "zod": "3.23.8"
   },
+  "overrides": {
+    "@snapshot-labs/eslint-config-base": "0.1.0-beta.18",
+    "ofetch": "1.3.3"
+  },
   "devDependencies": {
-    "@snapshot-labs/eslint-config": "^0.1.0-beta.18",
-    "@snapshot-labs/prettier-config": "^0.1.0-beta.7",
-    "@types/jest": "^29.5.2",
+    "@snapshot-labs/eslint-config": "0.1.0-beta.18",
+    "@snapshot-labs/prettier-config": "0.1.0-beta.7",
+    "@types/jest": "29.5.2",
     "@types/node": "^16.0.0",
     "dotenv-cli": "^7.2.1",
     "eslint": "^8.28.0",
-    "jest": "^29.6.1",
-    "jest-environment-node-single-context": "^29.1.0",
+    "jest": "29.6.1",
+    "jest-environment-node-single-context": "29.1.0",
     "nodemon": "^2.0.19",
-    "prettier": "^3.0.3",
+    "prettier": "3.0.3",
     "start-server-and-test": "^2.0.0",
     "supertest": "^6.3.4",
-    "ts-jest": "^29.1.1"
+    "ts-jest": "29.1.1"
   }
 }

package.json

@@ -4,7 +4,7 @@ import networks from '@snapshot-labs/snapshot.js/src/networks.json';
 
 async function main() {
   if (process.argv.length < 2) {
-    console.error(`Usage: yarn ts-node scripts/hibernate.ts run|preview`);
+    console.error(`Usage: bunx ts-node scripts/hibernate.ts run|preview`);
     return process.exit(1);
   }
 

scripts/hibernate.ts

@@ -10,7 +10,7 @@
  * All imported colors will be in 6-character hex format, and will not support transparency.
  * All colors with transparency will be opacified, based on the background color
  *
- * To run this script: yarn ts-node scripts/import-skins.ts
+ * To run this script: bunx ts-node scripts/import-skins.ts
  */
 
 import 'dotenv/config';

scripts/import-skins.ts

@@ -1,7 +1,7 @@
 import 'dotenv/config';
 import run from '../src/lib/importer/statement';
 
-// Usage: yarn ts-node scripts/import-statements.ts --providers tally,agora --spaces s:hop.eth
+// Usage: bunx ts-node scripts/import-statements.ts --providers tally,agora --spaces s:hop.eth
 async function main() {
   let providers: string[] | undefined = undefined;
   let spaces: string[] | undefined = undefined;

scripts/import-statements.ts

@@ -1,7 +1,7 @@
 import 'dotenv/config';
 import db from '../src/helpers/mysql';
 
-// Usage: yarn ts-node scripts/init_leaderboard_counters.ts --pivot TIMESTAMP
+// Usage: bunx ts-node scripts/init_leaderboard_counters.ts --pivot TIMESTAMP
 async function main() {
   let pivot: number | null = null;
 

scripts/init_leaderboard_counters.ts

@@ -1,7 +1,7 @@
 import 'dotenv/config';
 import db from '../src/helpers/mysql';
 
-// Usage: yarn ts-node scripts/refresh-space-leaderboard.ts --space SPACE-ID
+// Usage: bunx ts-node scripts/refresh-space-leaderboard.ts --space SPACE-ID
 // This script assumes there are no active proposals in the space
 
 async function getFirstAndLastVote(space: string) {