build: finish Bazel-native tooling cleanup (#64)

## Summary

- remove Stainless metadata, telemetry, generated comments, hosted
assets, and obsolete config
- remove package scripts and unused `iconv-lite`
- add `gazelle_ts` to own TypeScript source and dependency targets
- update contributing commands to use Bazel, Gazelle, and Lefthook
directly

## Test

- `bazel build //:pkg`
- `bazel test //...`
- `bazel run //:gazelle -- -mode=diff`
- Lefthook Oxfmt, Oxlint, and commitlint hooks

Author: longlho

.bazelrc

@@ -1,4 +1,11 @@
 common --enable_bzlmod
 common --enable_platform_specific_config
+common --repo_env=BAZEL_DO_NOT_DETECT_CPP_TOOLCHAIN=1
+common --repo_env=BAZEL_NO_APPLE_CPP_TOOLCHAIN=1
+common --@llvm//config:experimental_stub_libgcc_s=True
+common:linux --host_platform=@gazelle_ts//platforms:local_gnu
+common:windows --host_platform=@gazelle_ts//platforms:local_windows_msvc
+
+build:linux --linkopt=-no-pie
 
 test --test_output=errors

.devcontainer/devcontainer.json

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

.github/workflows/ci.yml

@@ -1,25 +1,15 @@
 name: CI
 on:
+  pull_request:
   push:
     branches:
-      - '**'
-      - '!integrated/**'
-      - '!stl-preview-head/**'
-      - '!stl-preview-base/**'
-      - '!generated'
-      - '!codegen/**'
-      - 'codegen/stl/**'
-  pull_request:
-    branches-ignore:
-      - 'stl-preview-head/**'
-      - 'stl-preview-base/**'
+      - main
 
 jobs:
   lint:
     timeout-minutes: 10
     name: lint
-    runs-on: ${{ github.repository == 'stainless-sdks/perplexity-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
@@ -72,11 +62,9 @@ jobs:
   build:
     timeout-minutes: 5
     name: build
-    runs-on: ${{ github.repository == 'stainless-sdks/perplexity-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
+    runs-on: ubuntu-24.04
     permissions:
       contents: read
-      id-token: write
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
@@ -101,40 +89,10 @@ jobs:
       - name: Check build
         run: bazel build //:pkg
 
-      - name: Get GitHub OIDC Token
-        if: |-
-          github.repository == 'stainless-sdks/perplexity-typescript' &&
-          !startsWith(github.ref, 'refs/heads/stl/')
-        id: github-oidc
-        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
-        with:
-          script: core.setOutput('github_token', await core.getIDToken());
-
-      - name: Upload tarball
-        if: |-
-          github.repository == 'stainless-sdks/perplexity-typescript' &&
-          !startsWith(github.ref, 'refs/heads/stl/')
-        env:
-          URL: https://pkg.stainless.com/s
-          AUTH: ${{ steps.github-oidc.outputs.github_token }}
-          SHA: ${{ github.sha }}
-        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
-    runs-on: ${{ github.repository == 'stainless-sdks/perplexity-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 

.gitignore

@@ -1,13 +1,7 @@
-.prism.log
-.stdy.log
 node_modules
 pnpm-debug.log*
-codegen.log
 Brewfile.lock.json
 dist
-dist-deno
 bazel-*
 /*.tgz
 .idea/
-.eslintcache
-oidc

.oxfmtrc.json

@@ -5,5 +5,5 @@
   "singleQuote": true,
   "trailingComma": "all",
   "sortPackageJson": false,
-  "ignorePatterns": ["dist/**", "bazel-*/**", "src/generated/**"]
+  "ignorePatterns": ["dist/**", "bazel-*/**", "src/generated/**", "CHANGELOG.md", "tsconfig.json"]
 }

.prettierignore

@@ -2,33 +2,72 @@ load("@aspect_bazel_lib//lib:write_source_files.bzl", "write_source_files")
 load("@aspect_rules_js//npm:defs.bzl", "npm_link_package", "npm_package")
 load("@aspect_rules_ts//ts:defs.bzl", "ts_project")
 load("@bazel_skylib//rules:write_file.bzl", "write_file")
+load("@gazelle//:def.bzl", "gazelle", "gazelle_binary")
 load("@npm//:@arethetypeswrong/cli/package_json.bzl", attw_bin = "bin")
+load("@npm//:defs.bzl", "npm_link_all_packages")
 load("@npm//:mocha/package_json.bzl", mocha_bin = "bin")
 load("@npm//:publint/package_json.bzl", publint_bin = "bin")
 load("@npm//:typescript/package_json.bzl", typescript_bin = "bin")
-load("@npm//:defs.bzl", "npm_link_all_packages")
 load("//:tsconfig.bzl", "BASE_COMPILER_OPTIONS", "TSCONFIG")
 
 package(default_visibility = ["//visibility:public"])
 
+# gazelle:exclude bazel-*
+# gazelle:exclude dist
+# gazelle:exclude node_modules
+# gazelle:exclude target
+# gazelle:exclude test-dist
+# gazelle:exclude tests
+# gazelle:map_kind ts_library ts_library //:ts.bzl
+# gazelle:map_kind ts_test ts_test //:ts.bzl
+# gazelle:ts_npm_link_pattern //:node_modules/{pkg}
+
 exports_files(["package.json"])
 
 npm_link_all_packages()
 
+gazelle_binary(
+    name = "gazelle_bin",
+    languages = ["@gazelle_ts//ts"],
+)
+
+gazelle(
+    name = "gazelle",
+    gazelle = ":gazelle_bin",
+)
+
 typescript_bin.tsc_binary(name = "tsc")
 
 write_file(
     name = "tsconfig_json",
     out = "_tsconfig.json",
-    content = [json.encode_indent(TSCONFIG, indent = "  ") + "\n"],
+    content = [json.encode_indent(
+        TSCONFIG,
+        indent = "  ",
+    ) + "\n"],
 )
 
 write_source_files(
     name = "tsconfig",
     files = {"tsconfig.json": ":tsconfig_json"},
 )
 
-TS_SOURCES = glob(["src/**/*.ts"])
+TS_SOURCES = [
+    "//src",
+    "//src/core",
+    "//src/generated",
+    "//src/internal",
+    "//src/internal/decoders",
+    "//src/internal/utils",
+    "//src/lib",
+    "//src/resources",
+    "//src/resources/async",
+    "//src/resources/async/chat",
+    "//src/resources/browser",
+    "//src/resources/chat",
+    "//src/resources/responses",
+]
+
 TEST_SOURCES = glob(["tests/**/*.ts"])
 
 ts_project(
@@ -82,10 +121,10 @@ npm_link_package(
 
 ts_project(
     name = "test_js",
+    testonly = True,
     srcs = TEST_SOURCES,
     out_dir = "test-dist",
     root_dir = "tests",
-    testonly = True,
     transpiler = "tsc",
     tsc = ":tsc",
     tsconfig = {
@@ -117,9 +156,9 @@ mocha_bin.mocha_test(
         "test-dist/**/*.test.js",
     ],
     data = [
+        "tests/uploads.test.ts",
         ":node_modules/@perplexity-ai/perplexity_ai",
         ":test_js",
-        "tests/uploads.test.ts",
     ],
 )
 

.stats.yml

@@ -184,7 +184,6 @@ Full Changelog: [v0.26.1...v0.26.2](https://github.com/perplexityai/perplexity-n
 
 ### Chores
 
-* **ci:** skip uploading artifacts on stainless-internal branches ([3d2b6b3](https://github.com/perplexityai/perplexity-node/commit/3d2b6b3abcc61ba4284b0c7382d8d53a5b0c167b))
 * **internal:** update dependencies to address dependabot vulnerabilities ([b494823](https://github.com/perplexityai/perplexity-node/commit/b494823152750452f7eaee967274904e30076615))
 
 ## 0.26.1 (2026-02-26)

BUILD.bazel

@@ -7,20 +7,26 @@ To set up the repository, run:
 ```sh
 $ corepack enable pnpm
 $ pnpm install
-$ pnpm build
+$ pnpm lefthook install
+$ bazel build //:pkg
 ```
 
 This installs dependencies and builds the publishable package at `bazel-bin/package/`.
 
 ## Modifying/Adding code
 
-Most of the SDK is generated code. Modifications to code will be persisted between generations, but may
-result in merge conflicts between manual patches and changes from the generator. The generator will never
-modify the contents of the `src/lib/` and `examples/` directories.
+API resources are generated from the OpenAPI specification. Keep manual helpers in `src/lib/`.
+
+Run Gazelle after adding, removing, or changing TypeScript imports. Gazelle owns
+TypeScript sources and dependencies in `BUILD.bazel` files.
+
+```sh
+$ bazel run //:gazelle
+```
 
 ## Adding and running examples
 
-All files in the `examples/` directory are not modified by the generator and can be freely edited or added to.
+Examples can be added under `examples/`.
 
 ```ts
 // add an example to examples/<your-example>.mts
@@ -40,7 +46,7 @@ $ node --experimental-transform-types examples/<your-example>.mts
 To link a local build:
 
 ```sh
-$ pnpm build
+$ bazel build //:pkg
 $ pnpm --dir bazel-bin/package link --global
 $ cd ../my-package
 $ pnpm link --global @perplexity-ai/perplexity_ai
@@ -49,7 +55,7 @@ $ pnpm link --global @perplexity-ai/perplexity_ai
 ## Running tests
 
 ```sh
-$ pnpm test
+$ bazel test //...
 ```
 
 ## Linting and formatting
@@ -60,13 +66,13 @@ This repository uses [Oxfmt](https://www.npmjs.com/package/oxfmt) and
 To lint:
 
 ```sh
-$ pnpm lint
+$ pnpm lefthook run pre-commit --all-files --force --fail-on-changes
 ```
 
 To format and fix all lint issues automatically:
 
 ```sh
-$ pnpm fix
+$ pnpm lefthook run pre-commit --all-files
 ```
 
 ## Publishing and releases
@@ -80,5 +86,4 @@ You can release to package managers by using [the `Publish NPM` GitHub action](h
 
 ### Publish manually
 
-If you need to manually release a package, you can run the `bin/publish-npm` script with an `NPM_TOKEN` set on
-the environment.
+If needed, build the package with `bazel build //:pkg` and publish `bazel-bin/package` with npm.