good progress on exercise 1

Author: kentcdodds

exercises/01.advanced-tools/01.problem.annotations/README.mdx

@@ -0,0 +1 @@
+# Annotations

…em.simple/other/caveat-variable-font.ttf …notations/other/caveat-variable-font.ttfexercises/01.sampling/01.problem.simple/other/caveat-variable-font.ttf renamed to exercises/01.advanced-tools/01.problem.annotations/other/caveat-variable-font.ttf exercises/01.sampling/01.problem.simple/other/caveat-variable-font.ttf renamed to exercises/01.advanced-tools/01.problem.annotations/other/caveat-variable-font.ttf

@@ -0,0 +1,28 @@
+{
+  "name": "exercises_01.advanced-tools_01.problem.annotations",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "mcp-dev",
+    "dev:mcp": "tsx src/index.ts",
+    "test": "vitest",
+    "typecheck": "tsc",
+    "inspect": "mcp-inspector"
+  },
+  "dependencies": {
+    "@epic-web/invariant": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.15.0",
+    "zod": "^3.25.67"
+  },
+  "devDependencies": {
+    "@epic-web/config": "^1.21.0",
+    "@epic-web/mcp-dev": "*",
+    "@faker-js/faker": "^9.8.0",
+    "@modelcontextprotocol/inspector": "^0.15.0",
+    "@types/node": "^24.0.3",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  },
+  "license": "GPL-3.0-only"
+}

exercises/01.advanced-tools/01.problem.annotations/package.json

@@ -7,6 +7,7 @@ import {
 	type Tag,
 	type NewTag,
 	type EntryTag,
+	type EntryWithTags,
 	entrySchema,
 	newEntrySchema,
 	tagSchema,
@@ -19,6 +20,25 @@ export type { Entry, NewEntry, Tag, NewTag, EntryTag }
 
 export class DB {
 	#db: DatabaseSync
+	#subscribers = new Set<
+		(changes: { tags?: number[]; entries?: number[] }) => void
+	>()
+
+	subscribe(
+		subscriber: (changes: { tags?: number[]; entries?: number[] }) => void,
+	) {
+		this.#subscribers.add(subscriber)
+		return () => {
+			this.#subscribers.delete(subscriber)
+		}
+	}
+
+	#notifySubscribers(changes: { tags?: number[]; entries?: number[] }) {
+		for (const subscriber of this.#subscribers) {
+			subscriber(changes)
+		}
+	}
+
 	constructor(db: DatabaseSync) {
 		this.#db = db
 	}
@@ -60,6 +80,7 @@ export class DB {
 		if (!createdEntry) {
 			throw new Error('Failed to query created entry')
 		}
+		this.#notifySubscribers({ entries: [id] })
 		return createdEntry
 	}
 
@@ -87,7 +108,7 @@ export class DB {
 		const tags = z
 			.array(z.object({ id: z.number(), name: z.string() }))
 			.parse(tagsResult)
-		return { ...entry, tags }
+		return { ...entry, tags } as EntryWithTags
 	}
 
 	// TODO: listEntries to actually filter by tagIds
@@ -109,25 +130,25 @@ export class DB {
 		}
 		const updates = Object.entries(entry)
 			.filter(([key, value]) => value !== undefined)
-			.map(([key], index) => `${key} = ?${index + 2}`)
+			.map(([key]) => `${key} = ?`)
 			.join(', ')
 		if (!updates) {
 			return existingEntry
 		}
-		const stmt = this.#db.prepare(sql`
-			UPDATE entries 
-			SET ${updates}, updated_at = CURRENT_TIMESTAMP 
-			WHERE id = ?1
-		`)
 		const updateValues = [
-			id,
 			...Object.entries(entry)
 				.filter(([, value]) => value !== undefined)
 				.map(([, value]) => value),
+			id,
 		]
 		if (updateValues.some((v) => v === undefined)) {
 			throw new Error('Undefined value in updateEntry parameters')
 		}
+		const stmt = this.#db.prepare(sql`
+			UPDATE entries 
+			SET ${updates}, updated_at = CURRENT_TIMESTAMP 
+			WHERE id = ?
+		`)
 		const result = stmt.run(...updateValues)
 		if (!result.changes) {
 			throw new Error('Failed to update entry')
@@ -136,6 +157,7 @@ export class DB {
 		if (!updatedEntry) {
 			throw new Error('Failed to query updated entry')
 		}
+		this.#notifySubscribers({ entries: [id] })
 		return updatedEntry
 	}
 
@@ -149,6 +171,7 @@ export class DB {
 		if (!result.changes) {
 			throw new Error('Failed to delete entry')
 		}
+		this.#notifySubscribers({ entries: [id] })
 		return true
 	}
 
@@ -171,6 +194,7 @@ export class DB {
 		if (!createdTag) {
 			throw new Error('Failed to query created tag')
 		}
+		this.#notifySubscribers({ tags: [id] })
 		return createdTag
 	}
 
@@ -202,25 +226,25 @@ export class DB {
 		}
 		const updates = Object.entries(tag)
 			.filter(([, value]) => value !== undefined)
-			.map(([key], index) => `${key} = ?${index + 2}`)
+			.map(([key]) => `${key} = ?`)
 			.join(', ')
 		if (!updates) {
 			return existingTag
 		}
-		const stmt = this.#db.prepare(sql`
-			UPDATE tags
-			SET ${updates}, updated_at = CURRENT_TIMESTAMP
-			WHERE id = ?1
-		`)
 		const updateValues = [
-			id,
 			...Object.entries(tag)
 				.filter(([, value]) => value !== undefined)
 				.map(([, value]) => value),
+			id,
 		]
 		if (updateValues.some((v) => v === undefined)) {
 			throw new Error('Undefined value in updateTag parameters')
 		}
+		const stmt = this.#db.prepare(sql`
+			UPDATE tags
+			SET ${updates}, updated_at = CURRENT_TIMESTAMP
+			WHERE id = ?
+		`)
 		const result = stmt.run(...updateValues)
 		if (!result.changes) {
 			throw new Error('Failed to update tag')
@@ -229,6 +253,7 @@ export class DB {
 		if (!updatedTag) {
 			throw new Error('Failed to query updated tag')
 		}
+		this.#notifySubscribers({ tags: [id] })
 		return updatedTag
 	}
 
@@ -242,6 +267,7 @@ export class DB {
 		if (!result.changes) {
 			throw new Error('Failed to delete tag')
 		}
+		this.#notifySubscribers({ tags: [id] })
 		return true
 	}
 
@@ -271,6 +297,7 @@ export class DB {
 		if (!created) {
 			throw new Error('Failed to query created entry tag')
 		}
+		this.#notifySubscribers({ entries: [entryId], tags: [tagId] })
 		return created
 	}
 

…pling/01.solution.simple/src/db/index.ts …s/01.problem.annotations/src/db/index.tsexercises/01.sampling/01.solution.simple/src/db/index.ts renamed to exercises/01.advanced-tools/01.problem.annotations/src/db/index.ts exercises/01.sampling/01.solution.simple/src/db/index.ts renamed to exercises/01.advanced-tools/01.problem.annotations/src/db/index.ts

@@ -25,6 +25,10 @@ export const entrySchema = z.object({
 	updatedAt: timestampSchema,
 })
 
+export const entryWithTagsSchema = entrySchema.extend({
+	tags: z.array(z.object({ id: z.number(), name: z.string() })),
+})
+
 export const newEntrySchema = z.object({
 	title: z.string(),
 	content: z.string(),
@@ -56,6 +60,13 @@ export const entryTagSchema = z.object({
 	updatedAt: timestampSchema,
 })
 
+export const entryIdSchema = { id: z.number().describe('The ID of the entry') }
+export const tagIdSchema = { id: z.number().describe('The ID of the tag') }
+export const entryTagIdSchema = {
+	entryId: z.number().describe('The ID of the entry'),
+	tagId: z.number().describe('The ID of the tag'),
+}
+
 export const createEntryInputSchema = {
 	title: z.string().describe('The title of the entry'),
 	content: z.string().describe('The content of the entry'),
@@ -95,13 +106,61 @@ export const createEntryInputSchema = {
 		.describe('The IDs of the tags to add to the entry'),
 }
 
+export const updateEntryInputSchema = {
+	id: z.number(),
+	title: z.string().optional().describe('The title of the entry'),
+	content: z.string().optional().describe('The content of the entry'),
+	mood: z
+		.string()
+		.nullable()
+		.optional()
+		.describe(
+			'The mood of the entry (for example: "happy", "sad", "anxious", "excited")',
+		),
+	location: z
+		.string()
+		.nullable()
+		.optional()
+		.describe(
+			'The location of the entry (for example: "home", "work", "school", "park")',
+		),
+	weather: z
+		.string()
+		.nullable()
+		.optional()
+		.describe(
+			'The weather of the entry (for example: "sunny", "cloudy", "rainy", "snowy")',
+		),
+	isPrivate: z
+		.number()
+		.optional()
+		.describe('Whether the entry is private (1 for private, 0 for public)'),
+	isFavorite: z
+		.number()
+		.optional()
+		.describe(
+			'Whether the entry is a favorite (1 for favorite, 0 for not favorite)',
+		),
+}
+
 export const createTagInputSchema = {
 	name: z.string().describe('The name of the tag'),
 	description: z.string().optional().describe('The description of the tag'),
 }
 
+export const updateTagInputSchema = {
+	id: z.number(),
+	...Object.fromEntries(
+		Object.entries(createTagInputSchema).map(([key, value]) => [
+			key,
+			value.nullable().optional(),
+		]),
+	),
+}
+
 export type Entry = z.infer<typeof entrySchema>
 export type NewEntry = z.infer<typeof newEntrySchema>
 export type Tag = z.infer<typeof tagSchema>
 export type NewTag = z.infer<typeof newTagSchema>
 export type EntryTag = z.infer<typeof entryTagSchema>
+export type EntryWithTags = z.infer<typeof entryWithTagsSchema>

…g/01.problem.simple/src/db/migrations.ts …problem.annotations/src/db/migrations.tsexercises/01.sampling/01.problem.simple/src/db/migrations.ts renamed to exercises/01.advanced-tools/01.problem.annotations/src/db/migrations.ts exercises/01.sampling/01.problem.simple/src/db/migrations.ts renamed to exercises/01.advanced-tools/01.problem.annotations/src/db/migrations.ts

@@ -4,12 +4,8 @@ import { DB } from './index.js'
 
 async function seed() {
 	const dbPath = path.join(process.cwd(), 'db.sqlite')
-	const dbExists = await fs.stat(dbPath).then(
-		() => true,
-		() => false,
-	)
 	// delete the db file if it exists
-	if (dbExists) await fs.unlink(dbPath)
+	await fs.unlink(dbPath).catch(() => {})
 
 	const db = DB.getInstance(dbPath)