Skip to content

docs(quickstart): use 0.2.6 for the TypeScript wasi-http handler#1204

Open
ericgregory wants to merge 2 commits into
wasmCloud:mainfrom
ericgregory:docs/quickstart-typescript-wasi-http-version
Open

docs(quickstart): use 0.2.6 for the TypeScript wasi-http handler#1204
ericgregory wants to merge 2 commits into
wasmCloud:mainfrom
ericgregory:docs/quickstart-typescript-wasi-http-version

Conversation

@ericgregory

Copy link
Copy Markdown
Contributor

Reverts the TypeScript code block in the quickstart's persistent-storage step from wasi:http/incoming-handler@0.2.9 back to 0.2.6 — only Rust needs 0.2.9 today; TypeScript's jco-std 0.1.x ships only 0.2.6 adapters.

PR wasmCloud#1203 unified both the Rust and TypeScript code blocks at
`wasi:http/incoming-handler@0.2.9`, but only the Rust path matches —
the TypeScript template's `@bytecodealliance/jco-std` (currently 0.1.x)
ships only the `dist/0.2.6/http/adapters/` adapters. Following the
docs as written, a TypeScript user hits `componentize-js` failing to
resolve `wasi:http/types@0.2.6` because `world.wit` was declared at
0.2.9.

Revert the TypeScript code block to `0.2.6`. The Rust block stays at
0.2.9 to match the wstd/wasip2 versions the Rust template pins.

Signed-off-by: Eric Gregory <eric@cosmonic.com>
@ericgregory ericgregory requested a review from a team as a code owner June 19, 2026 17:07
@netlify

netlify Bot commented Jun 19, 2026

Copy link
Copy Markdown

Deploy Preview for dreamy-golick-5f201e ready!

Name Link
🔨 Latest commit 65761e7
🔍 Latest deploy log https://app.netlify.com/projects/dreamy-golick-5f201e/deploys/6a3a9147b2c499000812e312
😎 Deploy Preview https://deploy-preview-1204--dreamy-golick-5f201e.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@vados-cosmonic vados-cosmonic left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I'm not sure I understand this change -- if 0.2.9 was working in the quickstart before, 0.2.6 should be fine? Or was the JS quickstart just broken for a bit?

@ericgregory

Copy link
Copy Markdown
Contributor Author

@vados-cosmonic Yeah, the TS quickstart was broken after #1203 merged:

  • Rust uses wstd → wasip2 → wasi-http, all on the newer chain — 0.2.9 works.
  • TypeScript uses @bytecodealliance/jco-std@0.1.x, which only ships adapters for wasi:http/incoming-handler@0.2.6 (the adapter is bundled with the package, not a separate wasi:http dep we can bump independently). So declaring 0.2.9 in wit/world.wit for the TS path makes the encoder reject the import as a version mismatch.

#1203 bumped both code blocks to 0.2.9 in one pass, which was correct for Rust but broke TS. This reverts the TS half only.

(Following with an issue per your comment on wasmCloud/typescript#667)

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.

2 participants