Release 2.10.0: configurable automatic daily YNAB sync via cron

Author: rollecode

CHANGELOG.md

@@ -1,3 +1,7 @@
+### 2.10.0: 2026-05-29
+
+* Add automatic daily YNAB sync via cron with a configurable hour setting, default 6
+
 ### 2.9.0: 2026-05-27
 
 * Add hide button on AI summary cards to mark individual summaries hidden in the shared database

src/app/(app)/settings/page.tsx

@@ -58,6 +58,8 @@ export default function SettingsPage() {
   const [budgetBillsMode, setBudgetBillsMode] = useState("auto");
   const [reserveNextMonthSaving, setReserveNextMonthSaving] = useState(false);
   const [reserveSaved, setReserveSaved] = useState(false);
+  const [ynabSyncHour, setYnabSyncHour] = useState("6");
+  const [syncHourSaved, setSyncHourSaved] = useState(false);
   const [billsModeSaved, setBillsModeSaved] = useState(false);
   const [thresholds, setThresholds] = useState({ tight: "20", normal: "30", good: "50" });
   const [thresholdsSaved, setThresholdsSaved] = useState(false);
@@ -128,6 +130,9 @@ export default function SettingsPage() {
           if (householdData.settings?.reserve_next_month_saving !== undefined) {
             setReserveNextMonthSaving(householdData.settings.reserve_next_month_saving === "1");
           }
+          if (householdData.settings?.ynab_sync_hour !== undefined) {
+            setYnabSyncHour(String(householdData.settings.ynab_sync_hour));
+          }
           if (householdData.settings?.budget_threshold_tight) setThresholds((p) => ({ ...p, tight: householdData.settings.budget_threshold_tight }));
           if (householdData.settings?.budget_threshold_normal) setThresholds((p) => ({ ...p, normal: householdData.settings.budget_threshold_normal }));
           if (householdData.settings?.budget_threshold_good) setThresholds((p) => ({ ...p, good: householdData.settings.budget_threshold_good }));
@@ -777,6 +782,36 @@ export default function SettingsPage() {
                   : "Use if your largest paycheck arrives in the last days of the month. Reserves next month's full saving goal on payday so the daily budget doesn't look overly generous. Next month skips the proportional saving deduction since it's already reserved."}
               </p>
             </div>
+            <div className="form-field">
+              <Label>{locale === "fi" ? "YNAB-synkronoinnin tunti" : "YNAB sync hour"}</Label>
+              <div className="settings-row">
+                <Input
+                  type="number"
+                  min="0"
+                  max="23"
+                  value={ynabSyncHour}
+                  onChange={(e) => setYnabSyncHour(e.target.value)}
+                  className="settings-input"
+                />
+                <Button size="sm" variant="outline" onClick={async () => {
+                  const h = String(Math.min(23, Math.max(0, parseInt(ynabSyncHour, 10) || 6)));
+                  setYnabSyncHour(h);
+                  await fetch("/api/household", {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify({ ynab_sync_hour: h }),
+                  });
+                  setSyncHourSaved(true);
+                  setTimeout(() => setSyncHourSaved(false), 2000);
+                }}>{t.common.save}</Button>
+                {syncHourSaved && <span className="settings-saved">{t.common.saved}</span>}
+              </div>
+              <p className="settings-help">
+                {locale === "fi"
+                  ? "Tunti (0–23, Helsingin aika), jolloin YNAB synkronoidaan automaattisesti kerran päivässä."
+                  : "Hour (0–23, Helsinki time) when YNAB is synced automatically once a day."}
+              </p>
+            </div>
             <div className="form-field">
               <Label>{locale === "fi" ? "Budjettirajat (€)" : "Budget thresholds (€)"}</Label>
               <div className="list-edit-row">

src/app/api/household/route.ts

@@ -28,6 +28,7 @@ export async function GET() {
         budget_include_bills: settings.budget_include_bills || "1",
         reserve_next_month_saving: settings.reserve_next_month_saving || "0",
         last_reservation_month: settings.last_reservation_month || "",
+        ynab_sync_hour: settings.ynab_sync_hour || "6",
         budget_threshold_tight: settings.budget_threshold_tight || "20",
         budget_threshold_normal: settings.budget_threshold_normal || "30",
         budget_threshold_good: settings.budget_threshold_good || "50",

src/app/api/ynab/sync/route.ts

@@ -62,15 +62,43 @@ export async function GET() {
   }
 }
 
-export async function POST() {
+export async function POST(request: Request) {
   try {
-    const user = await getSession();
+    const { getHouseholdSetting } = await import("@/lib/household");
+    // Allow cron calls with X-Cron-Secret header matching household setting
+    const cronSecret = request.headers.get("x-cron-secret");
+    const expectedSecret = getHouseholdSetting("cron_secret");
+    const isCron = !!(cronSecret && expectedSecret && cronSecret === expectedSecret);
+
+    let user = await getSession();
+    if (!user && isCron) {
+      const { getDb } = await import("@/lib/db");
+      const firstUser = getDb().prepare("SELECT id FROM users ORDER BY id LIMIT 1").get() as { id: number } | undefined;
+      if (firstUser) user = { id: firstUser.id } as Awaited<ReturnType<typeof getSession>>;
+    }
     if (!user) {
       console.warn("[api/ynab/sync] Unauthorized sync attempt");
       return NextResponse.json({ success: false, error: "Not authenticated" }, { status: 401 });
     }
 
-    console.info("[api/ynab/sync] Starting sync for user", user.id);
+    // Cron runs hourly; only perform the full sync at the configured hour (default 6),
+    // and at most once per day. Manual (session) syncs are never gated.
+    if (isCron) {
+      const syncHour = parseInt(getHouseholdSetting("ynab_sync_hour") || "6", 10);
+      const nowH = new Date();
+      const todayStr = `${nowH.getFullYear()}-${String(nowH.getMonth() + 1).padStart(2, "0")}-${String(nowH.getDate()).padStart(2, "0")}`;
+      if (nowH.getHours() !== syncHour) {
+        console.debug("[api/ynab/sync] Cron skip: hour", nowH.getHours(), "!= scheduled", syncHour);
+        return NextResponse.json({ success: true, skipped: "not scheduled hour" });
+      }
+      if (getHouseholdSetting("last_ynab_cron_date") === todayStr) {
+        console.debug("[api/ynab/sync] Cron skip: already synced today", todayStr);
+        return NextResponse.json({ success: true, skipped: "already synced today" });
+      }
+      setHouseholdSetting("last_ynab_cron_date", todayStr);
+    }
+
+    console.info("[api/ynab/sync] Starting sync for user", user.id, isCron ? "(cron)" : "");
 
     const token = getYnabToken();
     const budgetId = getYnabBudgetId();