chore: migrate tooling to oxc, pnpm, and bazel (#58)

## Summary

- replace ESLint and Prettier with Oxlint 1.75 and Oxfmt 0.60
- switch Yarn to pnpm 11.17 and add Lefthook 2.1
- build CJS, ESM, declarations, tests, and publish package with native
Bazel rules
- generate IDE `tsconfig.json` from a Starlark source of truth
- upgrade Bazel to 9.2, Node to 26.5, and TypeScript to 7.0
- remove Jest, SWC, scripts, tool wrappers, and legacy build configs

## Test

- `lefthook run pre-commit --all-files`
- `bazel test //...`
- `pnpm build`
- `pnpm lint`
- `pnpm test`
- CJS and ESM package smoke tests

Author: longlho

.bazelrc

@@ -0,0 +1,4 @@
+common --enable_bzlmod
+common --enable_platform_specific_config
+
+test --test_output=errors

.bazelversion

@@ -0,0 +1 @@
+9.2.0

.devcontainer/devcontainer.json

@@ -6,7 +6,7 @@
   "features": {
     "ghcr.io/devcontainers/features/node:1": {}
   },
-  "postCreateCommand": "yarn install",
+  "postCreateCommand": "corepack enable pnpm && pnpm install",
   "customizations": {
     "vscode": {
       "extensions": ["esbenp.prettier-vscode"]

.github/workflows/ci.yml

@@ -23,16 +23,26 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
+      - name: Set up Bazel
+        uses: bazel-contrib/setup-bazel@c5acdfb288317d0b5c0bbd7a396a3dc868bb0f86
+        with:
+          bazelisk-cache: true
+          disk-cache: ${{ github.workflow }}-lint
+          repository-cache: true
+
       - name: Set up Node
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '24'
+          node-version: '26'
+
+      - name: Enable pnpm
+        run: corepack enable pnpm
 
-      - name: Bootstrap
-        run: ./scripts/bootstrap
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
 
-      - name: Check types
-        run: ./scripts/lint
+      - name: Lint
+        run: bazel test //:lint
 
   build:
     timeout-minutes: 5
@@ -45,16 +55,26 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
+      - name: Set up Bazel
+        uses: bazel-contrib/setup-bazel@c5acdfb288317d0b5c0bbd7a396a3dc868bb0f86
+        with:
+          bazelisk-cache: true
+          disk-cache: ${{ github.workflow }}-build
+          repository-cache: true
+
       - name: Set up Node
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '24'
+          node-version: '26'
 
-      - name: Bootstrap
-        run: ./scripts/bootstrap
+      - name: Enable pnpm
+        run: corepack enable pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
 
       - name: Check build
-        run: ./scripts/build
+        run: bazel build //:pkg
 
       - name: Get GitHub OIDC Token
         if: |-
@@ -73,7 +93,18 @@ jobs:
           URL: https://pkg.stainless.com/s
           AUTH: ${{ steps.github-oidc.outputs.github_token }}
           SHA: ${{ github.sha }}
-        run: ./scripts/utils/upload-artifact.sh
+        run: |
+          set -euo pipefail
+          package_path="$(bazel cquery --output=files //:pkg)"
+          response="$(curl -fsS -X POST "$URL" \
+            -H "Authorization: Bearer $AUTH" \
+            -H "Content-Type: application/json")"
+          signed_url="$(echo "$response" | jq -r -e '.url')"
+          tarball="$(npm pack --silent "$package_path")"
+          curl -fsS -X PUT \
+            -H "Content-Type: application/gzip" \
+            --data-binary "@$tarball" "$signed_url"
+          echo "Installation: npm install 'https://pkg.stainless.com/s/perplexity-typescript/$SHA'"
   test:
     timeout-minutes: 10
     name: test
@@ -82,13 +113,23 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
+      - name: Set up Bazel
+        uses: bazel-contrib/setup-bazel@c5acdfb288317d0b5c0bbd7a396a3dc868bb0f86
+        with:
+          bazelisk-cache: true
+          disk-cache: ${{ github.workflow }}-test
+          repository-cache: true
+
       - name: Set up Node
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '24'
+          node-version: '26'
+
+      - name: Enable pnpm
+        run: corepack enable pnpm
 
-      - name: Bootstrap
-        run: ./scripts/bootstrap
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
 
       - name: Run tests
-        run: ./scripts/test
+        run: bazel test //:test

.github/workflows/publish-npm.yml

@@ -19,15 +19,31 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
+      - name: Set up Bazel
+        uses: bazel-contrib/setup-bazel@c5acdfb288317d0b5c0bbd7a396a3dc868bb0f86
+        with:
+          bazelisk-cache: true
+          disk-cache: ${{ github.workflow }}-publish
+          repository-cache: true
+
       - name: Set up Node
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
-          node-version: '24'
+          node-version: '26'
 
-      - name: Install dependencies
-        run: |
-          yarn install
+      - name: Enable pnpm
+        run: corepack enable pnpm
 
       - name: Publish to NPM
         run: |
-          bash ./bin/publish-npm
+          set -euo pipefail
+          bazel build //:pkg
+          package_path="$(bazel cquery --output=files //:pkg)"
+          package_version="$(node -p "require('./$package_path/package.json').version")"
+          if [[ "$package_version" == *-* ]]; then
+            npm_dist_tag="${package_version#*-}"
+            npm_dist_tag="${npm_dist_tag%%.*}"
+          else
+            npm_dist_tag=latest
+          fi
+          npm publish "$package_path" --access public --tag "$npm_dist_tag" --provenance

.gitignore

@@ -1,11 +1,12 @@
 .prism.log
 .stdy.log
 node_modules
-yarn-error.log
+pnpm-debug.log*
 codegen.log
 Brewfile.lock.json
 dist
 dist-deno
+bazel-*
 /*.tgz
 .idea/
 .eslintcache

.oxfmtrc.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "arrowParens": "always",
+  "printWidth": 110,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "sortPackageJson": false,
+  "ignorePatterns": ["dist/**", "bazel-*/**"]
+}

.oxlintrc.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "ignorePatterns": ["dist/**", "bazel-*/**"],
+  "categories": {
+    "correctness": "off"
+  },
+  "plugins": ["typescript"],
+  "rules": {
+    "no-unused-vars": [
+      "error",
+      {
+        "varsIgnorePattern": "^_",
+        "args": "none",
+        "caughtErrors": "none"
+      }
+    ],
+    "no-restricted-imports": [
+      "error",
+      {
+        "patterns": [
+          {
+            "regex": "^@perplexity-ai/perplexity_ai(/.*)?",
+            "message": "Use a relative import, not a package import."
+          }
+        ]
+      }
+    ]
+  },
+  "overrides": [
+    {
+      "files": ["tests/**", "examples/**"],
+      "rules": {
+        "no-restricted-imports": "off"
+      }
+    }
+  ]
+}

.prettierignore

@@ -5,3 +5,4 @@ CHANGELOG.md
 
 # don't format tsc output, will break source maps
 /dist
+/tsconfig.json