feat(tasks): add user preferences migration

Accept both old { notifications } and new { notifyOn* } preference
shapes in schema via v.union. Add one-off migration mutation to
convert existing users. Handles both shapes in notification logic
and settings UI during transition.

Run: bunx convex run migrations:migrateUserPreferences

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: giacomoguidotto

convex/_generated/api.d.ts

@@ -9,7 +9,13 @@
  */
 
 import type * as auth from "../auth.js";
+import type * as crons from "../crons.js";
+import type * as email from "../email.js";
 import type * as http from "../http.js";
+import type * as migrations from "../migrations.js";
+import type * as model_activity from "../model/activity.js";
+import type * as model_tasks from "../model/tasks.js";
+import type * as notifications from "../notifications.js";
 import type * as tasks from "../tasks.js";
 import type * as users from "../users.js";
 
@@ -21,7 +27,13 @@ import type {
 
 declare const fullApi: ApiFromModules<{
   auth: typeof auth;
+  crons: typeof crons;
+  email: typeof email;
   http: typeof http;
+  migrations: typeof migrations;
+  "model/activity": typeof model_activity;
+  "model/tasks": typeof model_tasks;
+  notifications: typeof notifications;
   tasks: typeof tasks;
   users: typeof users;
 }>;
@@ -54,4 +66,5 @@ export declare const internal: FilterApi<
 
 export declare const components: {
   workOSAuthKit: import("@convex-dev/workos-authkit/_generated/component.js").ComponentApi<"workOSAuthKit">;
+  resend: import("@convex-dev/resend/_generated/component.js").ComponentApi<"resend">;
 };

convex/migrations.ts

@@ -0,0 +1,36 @@
+import { internalMutation } from "./_generated/server";
+
+/**
+ * One-off migration: convert user preferences from old shape
+ * { notifications: boolean } to new shape { notifyOnShare, notifyOnComment, notifyOnDueDate }.
+ *
+ * Run with: bunx convex run migrations:migrateUserPreferences
+ */
+export const migrateUserPreferences = internalMutation({
+  args: {},
+  handler: async (ctx) => {
+    const users = await ctx.db.query("users").collect();
+    let migrated = 0;
+
+    for (const user of users) {
+      if (
+        user.preferences &&
+        "notifications" in user.preferences &&
+        !("notifyOnShare" in user.preferences)
+      ) {
+        const enabled = (user.preferences as { notifications: boolean })
+          .notifications;
+        await ctx.db.patch(user._id, {
+          preferences: {
+            notifyOnShare: enabled,
+            notifyOnComment: enabled,
+            notifyOnDueDate: enabled,
+          },
+        });
+        migrated++;
+      }
+    }
+
+    return { migrated, total: users.length };
+  },
+});

convex/notifications.ts

@@ -8,14 +8,24 @@ const DEFAULT_PREFS = {
   notifyOnDueDate: true,
 };
 
+type NewPrefs = typeof DEFAULT_PREFS;
+
 function getUserPrefs(user: {
-  preferences?: {
-    notifyOnShare: boolean;
-    notifyOnComment: boolean;
-    notifyOnDueDate: boolean;
-  } | null;
-}) {
-  return user.preferences ?? DEFAULT_PREFS;
+  preferences?: NewPrefs | { notifications: boolean } | null;
+}): NewPrefs {
+  const p = user.preferences;
+  if (!p) {
+    return DEFAULT_PREFS;
+  }
+  // Old shape: map single boolean to all three
+  if ("notifications" in p) {
+    return {
+      notifyOnShare: p.notifications,
+      notifyOnComment: p.notifications,
+      notifyOnDueDate: p.notifications,
+    };
+  }
+  return p;
 }
 
 /**

convex/schema.ts

@@ -42,12 +42,18 @@ export default defineSchema({
     // Optional avatar image (Convex file storage)
     avatarId: v.optional(v.id("_storage")),
     // User notification preferences (per event type)
+    // Accepts both old shape { notifications } and new shape for migration
     preferences: v.optional(
-      v.object({
-        notifyOnShare: v.boolean(),
-        notifyOnComment: v.boolean(),
-        notifyOnDueDate: v.boolean(),
-      })
+      v.union(
+        v.object({
+          notifyOnShare: v.boolean(),
+          notifyOnComment: v.boolean(),
+          notifyOnDueDate: v.boolean(),
+        }),
+        v.object({
+          notifications: v.boolean(),
+        })
+      )
     ),
   })
     .index("by_auth_id", ["authId"])

src/app/[locale]/(authenticated)/settings/settings-client.tsx

@@ -36,11 +36,14 @@ export function SettingsClient() {
     api.users.updateNotificationPreferences
   );
 
-  const prefs = user?.preferences ?? {
+  const defaults = {
     notifyOnShare: true,
     notifyOnComment: true,
     notifyOnDueDate: true,
   };
+  const rawPrefs = user?.preferences;
+  // Handle both old { notifications } and new { notifyOn* } shapes
+  const prefs = rawPrefs && "notifyOnShare" in rawPrefs ? rawPrefs : defaults;
 
   const handleAvatarUpload = useCallback(
     async (storageId: Id<"_storage">) => {