Skip to content

docs(readme): add Supported runtimes section + JSR config helper for bun/node (Group 8)#19

Merged
mahmoudsalmi merged 1 commit into
mainfrom
docs/cross-runtime-readme
May 3, 2026
Merged

docs(readme): add Supported runtimes section + JSR config helper for bun/node (Group 8)#19
mahmoudsalmi merged 1 commit into
mainfrom
docs/cross-runtime-readme

Conversation

@mahmoudsalmi
Copy link
Copy Markdown
Contributor

Group 8 partial β€” closes 8.2 + 8.3. Sets up the JSR flip for the user to execute.

README β€” new "Supported runtimes" section

Runtime Status SQLite driver
Deno β‰₯ 2.0 βœ… first-class (CLI + library) jsr:@db/sqlite (FFI)
Bun β‰₯ 1.1 βœ… library built-in bun:sqlite
Node.js β‰₯ 22 βœ… library built-in node:sqlite (Node β‰₯ 22.5) or better-sqlite3 fallback
Browsers / Cloudflare Workers ❌ n/a

Plus a same-import example showing the library API is identical on every runtime, and a link into openspec/changes/.../specs/runtime-compat/spec.md for the formal contract (with a note that it moves to openspec/specs/ on archive).

Drive-by fix

Two stale @ssal/dev-coach references in README β†’ @salmidev/dev-coach (the actual JSR scope).

JSR config helper

scripts/configure-jsr-package.sh updated:

-d '{"runtimeCompat":{"deno":true,"browser":false,"workerd":false}}'
+d '{"runtimeCompat":{"deno":true,"bun":true,"node":true,"browser":false,"workerd":false}}'

Same script you ran for Track A β€” you re-run after this PR merges (needs JSR_TOKEN).

Verification

  • deno task verify β€” 266 / 266 tests, 84.7% coverage βœ“
  • fmt + lint clean βœ“

Next (your hands)

After this merges:

  1. export JSR_TOKEN=… && scripts/configure-jsr-package.sh β€” flips the JSR-side flag.
  2. Trigger Release workflow with a MINOR bump (cross-runtime support is a feature). The default-patch rule in CI doesn't apply for releases triggered manually with a chosen bump level.
  3. Verify on https://jsr.io/@salmidev/dev-coach β€” score still 100%, "Works with" shows Deno + Bun + Node, browser/Workers shown as incompatible.

I'll handle Group 9 (JSDoc polish + archive) once the release is live.

Tasks: 38 / 49 after merge (8.2 + 8.3 add to the 36 from Group 6).

…bun/node

Group 8 partial β€” 8.2 + 8.3.

README now documents the cross-runtime story:
  - per-runtime SQLite driver matrix (Deno @db/sqlite, Bun bun:sqlite,
    Node 22+ node:sqlite + better-sqlite3 fallback)
  - explicit non-support for browsers + Cloudflare Workers
  - same-import example showing the runtime-agnostic library API
  - link into openspec/changes/.../specs/runtime-compat/spec.md for the
    formal contract (with note that it moves to openspec/specs/ on archive)

Also fixes two stale @ssal/dev-coach references in README β†’ @salmidev/dev-coach.

scripts/configure-jsr-package.sh updated to PATCH runtimeCompat with
deno:true + bun:true + node:true (was deno-only). User runs it after
this PR merges; needs JSR_TOKEN.

Verification: deno fmt + lint + 266/266 tests + 84.7% coverage.
Copy link
Copy Markdown
Contributor Author

@mahmoudsalmi mahmoudsalmi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

βœ…

@mahmoudsalmi mahmoudsalmi merged commit 697dfd4 into main May 3, 2026
7 checks passed
@mahmoudsalmi mahmoudsalmi deleted the docs/cross-runtime-readme branch May 3, 2026 19:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant