Add clarifying comment to stepCompleted next field

noisysocks · claude · noisysocks · commit af1f651618f3 · 2026-03-12T20:21:31.000+11:00
Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/special-pages/pages/onboarding/app/messages.js b/special-pages/pages/onboarding/app/messages.js
@@ -2,7 +2,7 @@
  * @typedef {Object} StepCompleteParams
  * Sent when a user has transitioned from a step to the next one
  * @property {import('./types').Step['id']} id - a unique identifier for each step
- * @property {import('./types').Step['id'] | null} next - the step about to display, or null if this is the last step
+ * @property {import('./types').Step['id'] | null} next - the step about to display, or null if this is the last step. In practice, always present because stepCompleted is not sent on the last step.
  *
  * @typedef {Object} InitResponse
  * @property {Record<string, any>} stepDefinitions

Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,7 @@`
`2`	`2`	`* @typedef {Object} StepCompleteParams`
`3`	`3`	`* Sent when a user has transitioned from a step to the next one`
`4`	`4`	`* @property {import('./types').Step['id']} id - a unique identifier for each step`
`5`		`- * @property {import('./types').Step['id'] \| null} next - the step about to display, or null if this is the last step`
	`5`	`+ * @property {import('./types').Step['id'] \| null} next - the step about to display, or null if this is the last step. In practice, always present because stepCompleted is not sent on the last step.`
`6`	`6`	`*`
`7`	`7`	`* @typedef {Object} InitResponse`
`8`	`8`	`* @property {Record<string, any>} stepDefinitions`