task(F2-backend): global block favorites - is_favorite column, adapter mapping, PATCH validation

backend/src/database/DatabaseInterface.ts

@@ -121,6 +121,7 @@ export interface DBGlobalBlock {
   name: string;
   block_data: string;
   svg_data: string | null;
+  is_favorite: boolean;
   created_at: string;
   updated_at: string;
 }

backend/src/database/SqliteAdapter.ts

@@ -35,6 +35,11 @@ export class SqliteAdapter implements DatabaseInterface {
     if (!columns.some(col => col.name === 'folder_id')) {
       this.db.exec('ALTER TABLE projects ADD COLUMN folder_id TEXT REFERENCES project_folders(id) ON DELETE SET NULL');
     }
+    // Add is_favorite column to global_blocks table for existing databases (Task F2)
+    const gbColumns = this.db.prepare("PRAGMA table_info('global_blocks')").all() as { name: string }[];
+    if (!gbColumns.some(col => col.name === 'is_favorite')) {
+      this.db.exec('ALTER TABLE global_blocks ADD COLUMN is_favorite INTEGER NOT NULL DEFAULT 0');
+    }
   }
 
   close(): void {
@@ -423,25 +428,31 @@ export class SqliteAdapter implements DatabaseInterface {
   }
 
   // ─── Global Blocks ─────────────────────────────────────
+  // Map DB row to DBGlobalBlock (is_favorite 0/1 → boolean, Task F2)
+  private mapGlobalBlockRow(row: Record<string, unknown>): DBGlobalBlock {
+    return { ...(row as unknown as DBGlobalBlock), is_favorite: Number(row.is_favorite ?? 0) === 1 };
+  }
+
   listGlobalBlocks(folderId?: string | null): DBGlobalBlock[] {
     if (folderId === undefined) {
-      return this.db.prepare('SELECT * FROM global_blocks ORDER BY updated_at DESC').all() as DBGlobalBlock[];
+      return (this.db.prepare('SELECT * FROM global_blocks ORDER BY updated_at DESC').all() as Record<string, unknown>[]).map(r => this.mapGlobalBlockRow(r));
     }
     if (folderId === null) {
-      return this.db.prepare('SELECT * FROM global_blocks WHERE folder_id IS NULL ORDER BY updated_at DESC').all() as DBGlobalBlock[];
+      return (this.db.prepare('SELECT * FROM global_blocks WHERE folder_id IS NULL ORDER BY updated_at DESC').all() as Record<string, unknown>[]).map(r => this.mapGlobalBlockRow(r));
     }
-    return this.db.prepare('SELECT * FROM global_blocks WHERE folder_id = ? ORDER BY updated_at DESC').all(folderId) as DBGlobalBlock[];
+    return (this.db.prepare('SELECT * FROM global_blocks WHERE folder_id = ? ORDER BY updated_at DESC').all(folderId) as Record<string, unknown>[]).map(r => this.mapGlobalBlockRow(r));
   }
 
   getGlobalBlock(id: string): DBGlobalBlock | null {
-    return (this.db.prepare('SELECT * FROM global_blocks WHERE id = ?').get(id) as DBGlobalBlock) ?? null;
+    const row = this.db.prepare('SELECT * FROM global_blocks WHERE id = ?').get(id) as Record<string, unknown> | undefined;
+    return row ? this.mapGlobalBlockRow(row) : null;
   }
 
   createGlobalBlock(data: Partial<DBGlobalBlock>): DBGlobalBlock {
     const id = data.id ?? `gblock-${randomUUID().slice(0, 8)}`;
     this.db.prepare(
-      'INSERT INTO global_blocks (id, folder_id, name, block_data, svg_data) VALUES (?, ?, ?, ?, ?)',
-    ).run(id, data.folder_id ?? null, data.name ?? 'Global Block', data.block_data ?? '{}', data.svg_data ?? null);
+      'INSERT INTO global_blocks (id, folder_id, name, block_data, svg_data, is_favorite) VALUES (?, ?, ?, ?, ?, ?)',
+    ).run(id, data.folder_id ?? null, data.name ?? 'Global Block', data.block_data ?? '{}', data.svg_data ?? null, data.is_favorite ? 1 : 0);
     return this.getGlobalBlock(id)!;
   }
 
@@ -452,6 +463,7 @@ export class SqliteAdapter implements DatabaseInterface {
     if (data.folder_id !== undefined) { sets.push('folder_id = ?'); vals.push(data.folder_id); }
     if (data.block_data !== undefined) { sets.push('block_data = ?'); vals.push(data.block_data); }
     if (data.svg_data !== undefined) { sets.push('svg_data = ?'); vals.push(data.svg_data); }
+    if (data.is_favorite !== undefined) { sets.push('is_favorite = ?'); vals.push(data.is_favorite ? 1 : 0); }
     sets.push("updated_at = datetime('now')");
     this.db.prepare(`UPDATE global_blocks SET ${sets.join(', ')} WHERE id = ?`).run(...vals, id);
     return this.getGlobalBlock(id);

backend/src/database/schema.sql

@@ -171,6 +171,7 @@ CREATE TABLE IF NOT EXISTS global_blocks (
   name TEXT NOT NULL,
   block_data TEXT NOT NULL DEFAULT '{}',
   svg_data TEXT,
+  is_favorite INTEGER NOT NULL DEFAULT 0,
   created_at TEXT NOT NULL DEFAULT (datetime('now')),
   updated_at TEXT NOT NULL DEFAULT (datetime('now')),
   FOREIGN KEY (folder_id) REFERENCES global_block_folders(id) ON DELETE SET NULL

backend/src/routes/globalBlocks.ts

@@ -134,11 +134,14 @@ export function registerGlobalBlockRoutes(fastify: FastifyInstance, db: Database
     const { id } = request.params as { id: string };
     const idErr = validateIdParam(id, 'id');
     if (idErr) return reply.code(400).send({ error: idErr });
-    const body = request.body as { name?: string; folder_id?: string | null; block_data?: string; svg_data?: string };
+    const body = request.body as { name?: string; folder_id?: string | null; block_data?: string; svg_data?: string; is_favorite?: boolean };
     if (body.name !== undefined) {
       const nameErr = validateName(body.name, 'name');
       if (nameErr) return reply.code(400).send({ error: nameErr });
     }
+    if (body.is_favorite !== undefined && typeof body.is_favorite !== 'boolean') {
+      return reply.code(400).send({ error: 'is_favorite must be a boolean' });
+    }
     if (body.folder_id !== undefined && body.folder_id !== null) {
       const fidErr = validateIdParam(body.folder_id, 'folder_id');
       if (fidErr) return reply.code(400).send({ error: fidErr });