patleeman / patleeman/bb-plugins

typecheck fails in 5 packages — SDK bundled types import better-sqlite3 and hono, which those packages don't declare

Open
#5 0 comments 0 reactions 0 assignees View on GitHub

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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.