Skip to content

Release 4.1.0, and lead the web section with what works - #249

Merged
vicajilau merged 2 commits into
mainfrom
docs/web-support-readme
Sep 4, 2026
Merged

Release 4.1.0, and lead the web section with what works#249
vicajilau merged 2 commits into
mainfrom
docs/web-support-readme

Conversation

@vicajilau

@vicajilau vicajilau commented Sep 4, 2026

Copy link
Copy Markdown
Owner

Two things, both wanted before tagging.

The README

The Web support section still read as a warning: sockets are unavailable, bring your own transport, and by the way here is what used to be broken before 4.0.0.

That framing was right when web support was a caveat. It is not any more, now that pub.dev lists the platform and a browser completes a handshake, runs a command, holds an aes256-gcm session and round-trips a file over SFTP against a real OpenSSH server on every pull request.

So it now says what works first, then the one thing a caller actually has to supply, then the two things a browser genuinely cannot do. The paragraph about getUint64 throwing under dart2js is gone: it is changelog material and the changelog has it, and someone reading how to use the library on the web does not need the archaeology of a version that already shipped. It also points at tool/ws_bridge.dart and the socket in the interop test as a worked example, since writing that transport is the only real work left for a web user.

The release

Dates the 4.1.0 heading and bumps pubspec.yaml from 4.0.1.

Worth doing now rather than accumulating: nothing is open, and the web platform work is invisible to anyone until it is published. pub.dev still serves 4.0.1 without platform:web, so a search filtered to web still does not find the package.

4.1.0 rather than 4.0.2 because #246 added public API, SSHClient.pipelineChannelRequests.

Verified

dart format and dart analyze --fatal-infos clean, 703 tests passing, dart pub publish --dry-run with 0 warnings.

The section still read as a warning: sockets are unavailable, bring your
own transport, and by the way here is what used to be broken before
4.0.0. That framing was right when web support was a caveat. It is not
any more, now that pub.dev lists the platform and a browser runs a
handshake, a command, an aes256-gcm session and an SFTP round trip
against a real OpenSSH server on every pull request.

So it now says what works first, then the one thing a caller has to
supply, then the two things a browser genuinely cannot do. The
archaeology about getUint64 moves out: that belongs in the changelog,
which has it.

Also points at tool/ws_bridge.dart and the test socket as a worked
example of the transport, since writing one is the only real work left
for a web user, and mentions the platform in the features list.
Dates the section and bumps pubspec from 4.0.1.

Nothing is left open, and the web platform work is invisible to anyone
until this is published: pub.dev still serves 4.0.1 without
platform:web, so a search filtered to web still does not find the
package.
@vicajilau vicajilau changed the title Lead the web section with what works Release 4.1.0, and lead the web section with what works Sep 4, 2026
@vicajilau
vicajilau enabled auto-merge September 4, 2026 06:43
@vicajilau
vicajilau merged commit 20b39cc into main Sep 4, 2026
4 of 5 checks passed
@vicajilau
vicajilau deleted the docs/web-support-readme branch September 4, 2026 06:45
@codecov

codecov Bot commented Sep 4, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 77.84%. Comparing base (982a793) to head (3500b8b).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff           @@
##             main     #249   +/-   ##
=======================================
  Coverage   77.84%   77.84%           
=======================================
  Files          82       82           
  Lines        6395     6395           
=======================================
  Hits         4978     4978           
  Misses       1417     1417           
Flag Coverage Δ
unittests 77.84% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

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