patleeman / patleeman/bb-plugins
typecheck fails in 5 packages — SDK bundled types import better-sqlite3 and hono, which those packages don't declare
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 5
- Forks
- 3
- PR merge metrics
- No merged PRs in 30d
Description
Problem
tsc --noEmit fails in five packages that depend on @get-bb/plugin-sdk but don't declare the two packages its bundled types import.
@get-bb/plugin-sdk/bundled-types/bb-plugin-sdk.d.ts opens with:
import Database from 'better-sqlite3';
import { Context } from 'hono';
TypeScript needs both resolvable to load the SDK's declarations at all, so a package missing either one fails before it reaches its own source:
node_modules/@get-bb/plugin-sdk/bundled-types/bb-plugin-sdk.d.ts(12,22): error TS2307: Cannot find module 'better-sqlite3' or its corresponding type declarations.
node_modules/@get-bb/plugin-sdk/bundled-types/bb-plugin-sdk.d.ts(13,25): error TS2307: Cannot find module 'hono' or its corresponding type declarations.
Affected packages
Every package below has "typecheck": "tsc --noEmit" and depends on the SDK:
| package | better-sqlite3 |
hono |
|---|---|---|
| bb-plugin-agent-checklists | declared | missing |
| bb-plugin-comprehension | declared | missing |
| bb-plugin-traces | declared | missing |
| bb-plugin-copy-session-id | missing | missing |
| bb-plugin-plannotator | missing | missing |
agent-plugins, council, ds4, gtd-sidebar, and ua-fetch declare both and typecheck clean. pnpm-lock.yaml matches — hono appears under the working importers and not under these five. Nothing is hoisted from the root, whose only devDependency is typescript.
Reproduction
git clone --depth 1 https://github.com/patleeman/bb-plugins.git
cd bb-plugins/packages/bb-plugin-copy-session-id
npm install
npx tsc --noEmit # both TS2307 errors
Same in bb-plugin-comprehension for the hono error alone. Adding "hono": "^4.11.9" to devDependencies (matching the pin the working packages use) clears it.
bb plugin build . succeeds regardless — esbuild doesn't resolve type-only imports — so this only shows up on typecheck, and pnpm -r --if-present typecheck at the root would surface it for all five.
Environment
bb 0.40.0, @get-bb/plugin-sdk 0.4.21, node 24.15.0, npm 11.12.1, macOS 26.6.1. Repo at 107e2b1.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the package manifests for bb-plugin-agent-checklists, bb-plugin-comprehension, bb-plugin-traces, bb-plugin-copy-session-id, and bb-plugin-plannotator, then compare their dependency declarations with the working packages. Update the missing declarations and pnpm-lock.yaml, and run pnpm -r --if-present typecheck to confirm all five packages pass.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- build-system, developer-experience
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Clearly specified
- Newbie friendliness
- 78/100