Add wrangler version components to metrics properties

[MattieTK]

As discussed this adds new telemetry options for better sorting in analytics tooling by version number by splitting the version.

---

• Tests
  • Tests included/updated
  • Tests not necessary because:
• Public documentation
  • Cloudflare docs PR(s):
  • Documentation not necessary because: Internal only feature
• Wrangler V3 Backport
  • Wrangler PR:
  • Not necessary because: Not a patch change

A picture of a cute animal (not mandatory, but encouraged)

(\(\
   ( -.-)
   o_(")(")

[changeset-bot]

🦋 Changeset detected

Latest commit: 5e96c0a

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[pkg-pr-new]

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@11673

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@11673

miniflare

npm i https://pkg.pr.new/miniflare@11673

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@11673

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@11673

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@11673

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@11673

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@11673

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@11673

wrangler

npm i https://pkg.pr.new/wrangler@11673

commit: 5e96c0a

[MattieTK]

Re: copilot, I am assuming here we do not break semver and this this is fine. If we do we might want to tackle NaN responses (though also I'm not too worried about these edge cases in analytics).

[claude]

Claude finished @MattieTK's task —— View job

---

Changeset Review

⚠️ Issues found

Version Type Issue (Blocking)

The changeset in .changeset/young-crews-learn.md:2 specifies "wrangler": minor, but this should be "wrangler": patch.

Reasoning:

• According to .changeset/README.md:22-23, minor versions are for "New features, new CLI commands, new configuration options, deprecations"
• Patch versions are for "Bug fixes, small improvements, documentation fixes"
• This change adds internal telemetry properties (wranglerMajorVersion, wranglerMinorVersion, wranglerPatchVersion) that have no user-facing impact
• Users don't interact with these properties - they're purely for internal analytics sorting
• This qualifies as a "small improvement" to internal infrastructure, not a new feature

Additional Notes (Non-blocking)

The version parsing logic at packages/wrangler/src/metrics/metrics-dispatcher.ts:62-63 doesn't handle pre-release versions (e.g., 1.2.3-beta.1) or build metadata (e.g., 1.2.3+build.123). This will result in NaN values being sent to analytics for these edge cases. Based on the PR discussion, the team seems accepting of this limitation for analytics purposes, but it's worth documenting.

---

[edmundhung]

Just rebased it to fix the changeset review ci job error.

[MattieTK]

@edmundhung I got confused by the changeset docs and chatting to Samuel yesterday. It may be that this doesn't need a changeset at all if Claude is correct. lmk if you need that removed.

[edmundhung]

In general we expect a changeset whenever we make any changes that needs to be released. This is also not internal facing as we document what we are collecting from the telemetry in https://github.com/cloudflare/workers-sdk/blob/c0e249e3d662444720548acee70ac33a078c408f/packages/wrangler/telemetry.md