Bug report: Shopify CLI 4.4.0+ bumps Javy 7.0.1→9.0.0 (javyPlugin v3→v4), quadrupling compiled JS Function Wasm size past the 256KB limit
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 45/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Quiet
- Tech stack
- javascript, typescript, wasm
- Domain
- backend, build-system
Research direction
Start by reproducing the size difference with shopify app function build using CLI 4.3.0 and 4.4.0+, then compare dist/function.wasm sections and the published CLI bundle's toolchain version resolution table. Done means identifying a compatible toolchain change or mitigation so unchanged JavaScript Function extensions remain below the 256KB limit.
Written by the indexing model from the issue text.
Description
Summary
Upgrading Shopify CLI from 4.3.0 to 4.4.0 (and all subsequent 4.4.x/4.5.x releases) causes a previously passing JavaScript Function extension to fail shopify app function build / shopify app deploy with:
Wasm file size must be less than 256KB
The extension's source code is unchanged. The compiled .wasm grows from 138,762 bytes to 481,174 bytes (~3.5x) between CLI 4.3.0 and 4.4.0, with the entire size increase isolated to the module's data section, the section holding precompiled QuickJS bytecode under Javy's dynamic-linking model. Rust extensions do not face the same issue. JS seems to be extra vulnerable
Environment
- Extension type: JavaScript/TypeScript Shopify Function
@shopify/shopify_function: 2.0.0api_version: 2026-04- Extension build config:
[extensions.build] command = ""(build is fully managed by the CLI; no local build script) - Node: 26.3.1
- OS: Linux amd64
- Package manager: npm (global CLI install), autoupgrade disabled
Steps to reproduce
- With Shopify CLI 4.3.0 installed, run
shopify app function buildon a JS Function extension. Note the outputdist/function.wasmsize. - Upgrade to Shopify CLI 4.4.0 (or later) with no changes to the extension source,
package.json, orshopify.extension.toml. - Run
shopify app function buildagain. - Compare the two
.wasmfiles.
Expected behavior
Rebuilding identical source with a newer CLI patch/minor version should not meaningfully change the compiled Wasm size, and should not push a previously compliant module over the 256KB platform limit.
Actual behavior
=== function-4.3.0.wasm (CLI 4.3.0) ===
File size: 138,762 bytes (135.5 KB)
Imports: from 'shopify_functions_javy_v3': cabi_realloc, invoke, memory
=== function-4.4.0.wasm (CLI 4.4.0+) ===
File size: 481,174 bytes (469.9 KB) -- OVER 256KB LIMIT
Imports: from 'shopify_functions_javy_v4': cabi_realloc, invoke, memory
Section by section breakdown of the two builds (byte identical source):
| Section | CLI 4.3.0 | CLI 4.4.0+ | Δ |
|---|---|---|---|
data |
119,594 | 462,006 | +342,412 (3.9x) |
custom (incl. javy_source) |
18,724 | 18,724 | 0 |
code |
182 | 182 | 0 |
import |
113 | 113 | 0 |
export |
93 | 93 | 0 |
| all other sections | identical | identical | 0 |
The javy_source custom section which embeds the original JS source is byte for byte identical between the two builds, confirming the source input is unchanged. Only the data section (precompiled QuickJS bytecode, produced by the Javy provider toolchain) grew.
Root cause (identified from the published CLI bundles)
Downloading the @shopify/cli npm tarballs for each version between 4.2.0 and 4.5.2 and inspecting the bundled toolchain version resolution table shows the following defaults change in CLI 4.4.0:
| CLI version | Published | javyPlugin |
javy (engine) |
functionRunner |
|---|---|---|---|---|
| 4.2.0 | 2026-06-16 | 3 | 7.0.1 | 9.1.2 |
| 4.3.0 | 2026-06-23 | 3 | 7.0.1 | 9.1.2 |
| 4.4.0 | 2026-07-06 | 4 | 9.0.0 | 9.2.0 |
| 4.5.0 | 2026-07-13 | 4 | 9.0.0 | 9.2.0 |
| 4.5.1 | 2026-07-14 | 4 | 9.0.0 | 9.2.0 |
| 4.5.2 | 2026-07-17 | 4 | 9.0.0 | 9.2.0 |
CLI 4.4.0 is the first release where the default javyPlugin moves from 3 to 4, alongside a Javy engine bump from 7.0.1 to 9.0.0 (a two major version jump). This lines up exactly with the shopify_functions_javy_v3 → shopify_functions_javy_v4 import change observed in the compiled module, and is the most likely source of the ~4x bytecode size increase, since a Javy major version bump commonly brings a QuickJS engine update with a different bytecode format/compilation strategy.
Impact
Any JS/TS Shopify Function extension already close to the 256KB budget will fail to build/deploy after an unattended CLI auto upgrade to 4.4.0+, with no code change on the developer's part and no clear signal in the build output pointing at the toolchain bump as the cause. Given CLI 4.0+ auto upgrades by default, this can silently break CI/production deploys.
Workaround
Pin Shopify CLI to 4.3.0 (last version with javyPlugin: 3 / javy: 7.0.1) and disable autoupgrade (shopify config autoupgrade off) until this is addressed.
- Dominant language
- TypeScript
- Stars
- 35
- Forks
- 9
- PR merge metrics
- No merged PRs in 30d
Contributor guide
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.
More from Shopify/shopify-function-javascript
-
Difficulty 4/5 3-5 days Newbie friendliness 48/100
-
Difficulty 1/5 Under an hour Newbie friendliness 25/100
Shopify/shopify-function-javascript#98 · 1 comment ·
All issues in Shopify/shopify-function-javascript
Similar issues
-
clawsweeper:linked-pr-open clawsweeper:no-new-fix-pr clawsweeper:source-repro impact:message-loss issue-rating: 🦞 diamond lobster maturity:stable P2
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
Eynzof/Hermes-CN-Desktop#616 ·
-
ZCode 3.14.3 に対応する Open
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
supermomonga/zcode-acp#24 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
growthbook/growthbook#7100 ·
-
triage
Difficulty 1/5 1-3 hours Newbie friendliness 88/100