Clarify exercise requirements (#2)

Co-authored-by: Cursor Agent <cursoragent@cursor.com>

Author: kody-bot

exercises/01.promises/01.problem.creation/README.mdx

@@ -16,8 +16,14 @@ const fetchForecast = () =>
 
 🐨 Open <InlineFile file="index.ts" /> and:
 
-1. Create a `fetchUser` function that returns a `Promise<User>`
-2. The Promise should resolve after 1 second with a user object (you could do 10 milliseconds to make the tests faster if you want)
-3. The user object should have: `id: string`, `name: string`, `email: string`
+1. Create and export a `fetchUser` function that returns a `Promise<User>`
+2. Resolve after a short delay (about 1 second is fine; a few milliseconds is
+   fine for faster checks)
+3. Resolve with this user fixture:
+   - `id: '1'`
+   - `name: 'Alice'`
+   - `email: 'alice@example.com'`
+
+Completion check: calling `await fetchUser()` returns that exact user object.
 
 📜 [MDN - Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise)

exercises/01.promises/01.problem.creation/index.ts

@@ -7,10 +7,10 @@ type User = {
 }
 
 // 🐨 Create a function `fetchUser` that returns a Promise<User>
-//    The Promise should resolve after 1 second with a user object
+//    Resolve after a short delay with:
+//    { id: '1', name: 'Alice', email: 'alice@example.com' }
 
-// 🐨 Call fetchUser and log the result when it resolves
-
-// 🐨 Export your function so we can verify your work
+// 🐨 Call fetchUser and log the result when it resolves (optional)
 
+// 🐨 Export fetchUser so we can verify your work
 // export { fetchUser }

exercises/01.promises/01.solution.creation/index.test.ts

@@ -3,10 +3,7 @@ import { test } from 'node:test'
 import * as solution from './index.ts'
 
 await test('fetchUser is exported', () => {
-	assert.ok(
-		'fetchUser' in solution,
-		'🚨 Make sure you export "fetchUser" - add: export { fetchUser }',
-	)
+	assert.ok('fetchUser' in solution, '🚨 Make sure you export "fetchUser"')
 })
 
 await test(

exercises/01.promises/02.problem.chaining/README.mdx

@@ -24,7 +24,13 @@ fetchPlaylist()
 
 🐨 Open <InlineFile file="index.ts" /> and:
 
-1. Create `fetchUserAndOrders` to chain the promises and return `{ user, orders }`
-2. Export `fetchUserAndOrders`
+1. Create and export `fetchUserAndOrders` that:
+   - Calls the provided `fetchUser`
+   - Then calls `fetchOrders` with that user's `id`
+   - Returns `{ user, orders }`
+2. Keep using `.then()` chaining for this step (no `async`/`await` yet)
+
+Completion check: `await fetchUserAndOrders()` returns a user with `id: '1'`
+and an `orders` array whose first order has `userId` equal to that same id.
 
 📜 [MDN - Promise.prototype.then()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/then)

exercises/01.promises/02.problem.chaining/index.ts

@@ -40,8 +40,10 @@ function fetchOrders(userId: string): Promise<Array<Order>> {
 	})
 }
 
-// 🐨 Create fetchUserAndOrders() that chains the promises and returns:
-//    { user, orders }
+// 🐨 Create fetchUserAndOrders() that:
+//    1. Calls fetchUser()
+//    2. Passes user.id into fetchOrders(userId)
+//    3. Returns Promise<{ user: User; orders: Array<Order> }>
 
 // 🐨 verify your work with:
 // fetchUserAndOrders().then(({ user, orders }) => {
@@ -50,5 +52,4 @@ function fetchOrders(userId: string): Promise<Array<Order>> {
 // })
 
 // 🐨 Export fetchUserAndOrders so we can verify your work
-
 // export { fetchUserAndOrders }

exercises/01.promises/02.solution.chaining/index.test.ts

@@ -5,7 +5,7 @@ import * as solution from './index.ts'
 await test('fetchUserAndOrders is exported', () => {
 	assert.ok(
 		'fetchUserAndOrders' in solution,
-		'🚨 Make sure you export "fetchUserAndOrders" - add: export { fetchUserAndOrders }',
+		'🚨 Make sure you export "fetchUserAndOrders"',
 	)
 })
 
@@ -23,11 +23,11 @@ await test('promise chaining works correctly', { timeout: 5000 }, async () => {
 	assert.strictEqual(
 		result.user.id,
 		'1',
-		'🚨 user.id should be "1" - make sure you await fetchUser() first',
+		'🚨 user.id should be "1" - fetch the user before fetching orders',
 	)
 	assert.strictEqual(
 		result.orders[0].userId,
 		result.user.id,
-		'🚨 orders[0].userId should match user.id - chain promises correctly using .then() or await',
+		'🚨 orders[0].userId should match user.id - pass the user id into fetchOrders',
 	)
 })

exercises/01.promises/03.problem.rejection/README.mdx

@@ -7,12 +7,24 @@ Rejected Promises should be caught so we can return a friendly error state.
 
 🐨 Open <InlineFile file="index.ts" /> and:
 
-1. Update `getUserProfile` to handle rejections with `.catch()`
-2. Return an error result when the Promise rejects
-3. Keep the `id` parameter flowing through both functions
-4. Export `fetchUser` and `getUserProfile`
+1. Keep `fetchUser(id)` as provided:
+   - `id === '1'` resolves to Alice (`id: '1'`, `name: 'Alice'`,
+     `email: 'alice@example.com'`)
+   - any other id rejects with `Error('User not found')`
+2. Update `getUserProfile(id)` to handle rejections with `.catch()`
+3. Return shapes:
+   - success: `{ status: 'success', user }`
+   - error: `{ status: 'error', message }` where `message` is
+     `error.message` when the rejection is an `Error`, otherwise
+     `'Unknown error'`
+4. Export both `fetchUser` and `getUserProfile`
 
-💰 For the error result, return a `{ status: 'error', message: string }` object.
-If the value isn't an `Error`, use `'Unknown error'` as the message.
+Completion checks:
+
+- `await getUserProfile('1')` → `{ status: 'success', user: { id: '1', ... } }`
+- `await getUserProfile('missing')` →
+  `{ status: 'error', message: 'User not found' }`
+- `await fetchUser('missing')` still rejects (do not swallow that rejection
+  inside `fetchUser` itself)
 
 📜 [MDN - Promise.prototype.catch()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/catch)

exercises/01.promises/03.problem.rejection/index.ts

@@ -31,9 +31,10 @@ function getUserProfile(id: string): Promise<UserProfile> {
 	return fetchUser(id).then((user) => ({ status: 'success', user }) as const)
 }
 
-// 🐨 Update getUserProfile to handle rejections and return an error status
-// 💰 return { status: 'error', message: error.message }
-// 💰 if error isn't an Error, use 'Unknown error'
+// 🐨 Update getUserProfile to handle rejections with .catch()
+//    On rejection, return { status: 'error', message }
+//    💰 Prefer error.message when the rejection is an Error; otherwise
+//       use 'Unknown error'
 
 // 🐨 Export fetchUser and getUserProfile so we can verify your work
 // export { fetchUser, getUserProfile }

exercises/01.promises/03.solution.rejection/index.test.ts

@@ -3,13 +3,10 @@ import { test } from 'node:test'
 import * as solution from './index.ts'
 
 await test('fetchUser and getUserProfile are exported', () => {
-	assert.ok(
-		'fetchUser' in solution,
-		'🚨 Make sure you export "fetchUser" - add: export { fetchUser, getUserProfile }',
-	)
+	assert.ok('fetchUser' in solution, '🚨 Make sure you export "fetchUser"')
 	assert.ok(
 		'getUserProfile' in solution,
-		'🚨 Make sure you export "getUserProfile" - add: export { fetchUser, getUserProfile }',
+		'🚨 Make sure you export "getUserProfile"',
 	)
 })
 
@@ -60,7 +57,7 @@ await test(
 		assert.strictEqual(
 			result.status,
 			'success',
-			'🚨 getUserProfile() should return status "success" when fetchUser resolves',
+			'🚨 getUserProfile("1") should return status "success"',
 		)
 		if (result.status === 'success') {
 			assert.strictEqual(
@@ -81,7 +78,7 @@ await test(
 		assert.strictEqual(
 			result.status,
 			'error',
-			'🚨 getUserProfile("missing") should return status "error" when fetchUser rejects',
+			'🚨 getUserProfile("missing") should return status "error"',
 		)
 		if (result.status === 'error') {
 			assert.strictEqual(

exercises/02.async-await/01.problem.linear-flow/README.mdx

@@ -24,7 +24,14 @@ async function loadCookingData() {
 }
 ```
 
-🐨 Open <InlineFile file="index.ts" /> and refactor `loadUserData` so it
-uses `async`/`await` instead of `.then()` chains.
+🐨 Open <InlineFile file="index.ts" /> and:
+
+1. Refactor `loadUserData` to use `async`/`await` instead of nested `.then()`
+2. Keep the same return shape: `{ user, orders }`
+3. Await `fetchUser()`, then await `fetchOrders(user.id)`
+4. Export `loadUserData`
+
+Completion check: `await loadUserData()` returns Alice (`id: '1'`) and an
+orders array whose first order has `userId: '1'`.
 
 📜 [MDN - async function](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function)