Add Expenses app

A UI based on [Budget Zen](https://github.com/BrunoBernardino/budgetzen-web) but slightly updated and adjusted for bewCloud. It also features a chart with available money and spent by budgets.

This is useful for envelope-based budgeting.

routes/api/expenses/add-budget.tsx

@@ -0,0 +1,57 @@
+import { Handlers } from 'fresh/server.ts';
+
+import { Budget, FreshContextState } from '/lib/types.ts';
+import { createBudget, getBudgets } from '/lib/data/expenses.ts';
+
+interface Data {}
+
+export interface RequestBody {
+  name: string;
+  month: string;
+  value: number;
+  currentMonth: string;
+}
+
+export interface ResponseBody {
+  success: boolean;
+  newBudgets: Budget[];
+}
+
+export const handler: Handlers<Data, FreshContextState> = {
+  async POST(request, context) {
+    if (!context.state.user) {
+      return new Response('Unauthorized', { status: 401 });
+    }
+
+    const requestBody = await request.clone().json() as RequestBody;
+
+    if (
+      !requestBody.name || !requestBody.month || !requestBody.month.match(/^\d{4}-\d{2}$/) || !requestBody.value ||
+      Number.isNaN(requestBody.value) || !requestBody.currentMonth || !requestBody.currentMonth.match(/^\d{4}-\d{2}$/)
+    ) {
+      return new Response('Bad request', { status: 400 });
+    }
+
+    try {
+      const newBudget = await createBudget(
+        context.state.user.id,
+        requestBody.name,
+        requestBody.month,
+        requestBody.value,
+      );
+
+      if (!newBudget) {
+        throw new Error('Failed to add budget!');
+      }
+    } catch (error) {
+      console.error(error);
+      return new Response(`${error}`, { status: 500 });
+    }
+
+    const newBudgets = await getBudgets(context.state.user.id, requestBody.currentMonth);
+
+    const responseBody: ResponseBody = { success: true, newBudgets };
+
+    return new Response(JSON.stringify(responseBody));
+  },
+};

routes/api/expenses/add-expense.tsx

@@ -0,0 +1,80 @@
+import { Handlers } from 'fresh/server.ts';
+
+import { Budget, Expense, FreshContextState } from '/lib/types.ts';
+import { createExpense, getBudgets, getExpenses } from '/lib/data/expenses.ts';
+
+interface Data {}
+
+export interface RequestBody {
+  cost: number;
+  description: string;
+  budget: string;
+  date: string;
+  is_recurring: boolean;
+  month: string;
+}
+
+export interface ResponseBody {
+  success: boolean;
+  newExpenses: Expense[];
+  newBudgets: Budget[];
+}
+
+export const handler: Handlers<Data, FreshContextState> = {
+  async POST(request, context) {
+    if (!context.state.user) {
+      return new Response('Unauthorized', { status: 401 });
+    }
+
+    const requestBody = await request.clone().json() as RequestBody;
+
+    if (
+      !requestBody.cost || Number.isNaN(requestBody.cost) || !requestBody.description || !requestBody.month ||
+      !requestBody.month.match(/^\d{4}-\d{2}$/)
+    ) {
+      return new Response('Bad request', { status: 400 });
+    }
+
+    if (!requestBody.budget) {
+      requestBody.budget = 'Misc';
+    }
+
+    if (!requestBody.date) {
+      requestBody.date = new Date().toISOString().substring(0, 10);
+    }
+
+    if (!requestBody.date.match(/^\d{4}-\d{2}-\d{2}$/)) {
+      return new Response('Bad request', { status: 400 });
+    }
+
+    if (!requestBody.is_recurring) {
+      requestBody.is_recurring = false;
+    }
+
+    try {
+      const newExpense = await createExpense(
+        context.state.user.id,
+        requestBody.cost,
+        requestBody.description,
+        requestBody.budget,
+        requestBody.date,
+        requestBody.is_recurring,
+      );
+
+      if (!newExpense) {
+        throw new Error('Failed to add expense!');
+      }
+    } catch (error) {
+      console.error(error);
+      return new Response(`${error}`, { status: 500 });
+    }
+
+    const newExpenses = await getExpenses(context.state.user.id, requestBody.month);
+
+    const newBudgets = await getBudgets(context.state.user.id, requestBody.month);
+
+    const responseBody: ResponseBody = { success: true, newExpenses, newBudgets };
+
+    return new Response(JSON.stringify(responseBody));
+  },
+};

routes/api/expenses/auto-complete.tsx

@@ -0,0 +1,38 @@
+import { Handlers } from 'fresh/server.ts';
+
+import { FreshContextState } from '/lib/types.ts';
+import { getExpenseSuggestions } from '/lib/data/expenses.ts';
+
+interface Data {}
+
+export interface RequestBody {
+  name: string;
+}
+
+export interface ResponseBody {
+  success: boolean;
+  suggestions: string[];
+}
+
+export const handler: Handlers<Data, FreshContextState> = {
+  async POST(request, context) {
+    if (!context.state.user) {
+      return new Response('Unauthorized', { status: 401 });
+    }
+
+    const requestBody = await request.clone().json() as RequestBody;
+
+    if (!requestBody.name || requestBody.name.length < 2) {
+      return new Response('Bad request', { status: 400 });
+    }
+
+    const suggestions = await getExpenseSuggestions(
+      context.state.user.id,
+      requestBody.name,
+    );
+
+    const responseBody: ResponseBody = { success: true, suggestions };
+
+    return new Response(JSON.stringify(responseBody));
+  },
+};

routes/api/expenses/delete-budget.tsx

@@ -0,0 +1,51 @@
+import { Handlers } from 'fresh/server.ts';
+
+import { Budget, FreshContextState } from '/lib/types.ts';
+import { deleteBudget, getBudgetById, getBudgets } from '/lib/data/expenses.ts';
+
+interface Data {}
+
+export interface RequestBody {
+  id: string;
+  currentMonth: string;
+}
+
+export interface ResponseBody {
+  success: boolean;
+  newBudgets: Budget[];
+}
+
+export const handler: Handlers<Data, FreshContextState> = {
+  async POST(request, context) {
+    if (!context.state.user) {
+      return new Response('Unauthorized', { status: 401 });
+    }
+
+    const requestBody = await request.clone().json() as RequestBody;
+
+    if (
+      !requestBody.id || !requestBody.currentMonth || !requestBody.currentMonth.match(/^\d{4}-\d{2}$/)
+    ) {
+      return new Response('Bad request', { status: 400 });
+    }
+
+    const budget = await getBudgetById(context.state.user.id, requestBody.id);
+
+    if (!budget) {
+      return new Response('Not found', { status: 404 });
+    }
+
+    try {
+      await deleteBudget(context.state.user.id, requestBody.id);
+    } catch (error) {
+      console.error(error);
+      return new Response(`${error}`, { status: 500 });
+    }
+
+    const newBudgets = await getBudgets(context.state.user.id, requestBody.currentMonth);
+
+    const responseBody: ResponseBody = { success: true, newBudgets };
+
+    return new Response(JSON.stringify(responseBody));
+  },
+};

routes/api/expenses/delete-expense.tsx

@@ -0,0 +1,54 @@
+import { Handlers } from 'fresh/server.ts';
+
+import { Budget, Expense, FreshContextState } from '/lib/types.ts';
+import { deleteExpense, getBudgets, getExpenseById, getExpenses } from '/lib/data/expenses.ts';
+
+interface Data {}
+
+export interface RequestBody {
+  id: string;
+  month: string;
+}
+
+export interface ResponseBody {
+  success: boolean;
+  newExpenses: Expense[];
+  newBudgets: Budget[];
+}
+
+export const handler: Handlers<Data, FreshContextState> = {
+  async POST(request, context) {
+    if (!context.state.user) {
+      return new Response('Unauthorized', { status: 401 });
+    }
+
+    const requestBody = await request.clone().json() as RequestBody;
+
+    if (
+      !requestBody.id || !requestBody.month || !requestBody.month.match(/^\d{4}-\d{2}$/)
+    ) {
+      return new Response('Bad request', { status: 400 });
+    }
+
+    const expense = await getExpenseById(context.state.user.id, requestBody.id);
+
+    if (!expense) {
+      return new Response('Not found', { status: 404 });
+    }
+
+    try {
+      await deleteExpense(context.state.user.id, requestBody.id);
+    } catch (error) {
+      console.error(error);
+      return new Response(`${error}`, { status: 500 });
+    }
+
+    const newExpenses = await getExpenses(context.state.user.id, requestBody.month);
+
+    const newBudgets = await getBudgets(context.state.user.id, requestBody.month);
+
+    const responseBody: ResponseBody = { success: true, newExpenses, newBudgets };
+
+    return new Response(JSON.stringify(responseBody));
+  },
+};

routes/api/expenses/export-expenses.tsx

@@ -0,0 +1,32 @@
+import { Handlers } from 'fresh/server.ts';
+
+import { Budget, Expense, FreshContextState } from '/lib/types.ts';
+import { getAllBudgetsForExport, getAllExpensesForExport } from '/lib/data/expenses.ts';
+
+interface Data {}
+
+export interface RequestBody {}
+
+export interface ResponseBody {
+  success: boolean;
+  jsonContents: {
+    budgets: (Omit<Budget, 'id' | 'user_id' | 'created_at' | 'extra'> & { extra: Record<never, never> })[];
+    expenses: (Omit<Expense, 'id' | 'user_id' | 'created_at' | 'extra'> & { extra: Record<never, never> })[];
+  };
+}
+
+export const handler: Handlers<Data, FreshContextState> = {
+  async POST(request, context) {
+    if (!context.state.user) {
+      return new Response('Unauthorized', { status: 401 });
+    }
+
+    const newExpenses = await getAllExpensesForExport(context.state.user.id);
+
+    const newBudgets = await getAllBudgetsForExport(context.state.user.id);
+
+    const responseBody: ResponseBody = { success: true, jsonContents: { expenses: newExpenses, budgets: newBudgets } };
+
+    return new Response(JSON.stringify(responseBody));
+  },
+};

routes/api/expenses/import-expenses.tsx

@@ -0,0 +1,82 @@
+import { Handlers } from 'fresh/server.ts';
+
+import { Budget, Expense, FreshContextState } from '/lib/types.ts';
+import { concurrentPromises } from '/lib/utils/misc.ts';
+import {
+  createBudget,
+  createExpense,
+  deleteAllBudgetsAndExpenses,
+  getBudgets,
+  getExpenses,
+} from '/lib/data/expenses.ts';
+
+interface Data {}
+
+export interface RequestBody {
+  budgets: Pick<Budget, 'name' | 'month' | 'value'>[];
+  expenses: Pick<Expense, 'cost' | 'description' | 'budget' | 'date' | 'is_recurring'>[];
+  month: string;
+  replace: boolean;
+}
+
+export interface ResponseBody {
+  success: boolean;
+  newBudgets: Budget[];
+  newExpenses: Expense[];
+}
+
+export const handler: Handlers<Data, FreshContextState> = {
+  async POST(request, context) {
+    if (!context.state.user) {
+      return new Response('Unauthorized', { status: 401 });
+    }
+
+    const requestBody = await request.clone().json() as RequestBody;
+
+    if (
+      (requestBody.budgets.length === 0 && requestBody.expenses.length === 0) || !requestBody.month ||
+      !requestBody.month.match(/^\d{4}-\d{2}$/)
+    ) {
+      return new Response('Bad request', { status: 400 });
+    }
+
+    if (requestBody.replace) {
+      await deleteAllBudgetsAndExpenses(context.state.user.id);
+    }
+
+    try {
+      await concurrentPromises(
+        requestBody.budgets.map((budget) => () =>
+          createBudget(context.state.user!.id, budget.name, budget.month, budget.value)
+        ),
+        5,
+      );
+
+      await concurrentPromises(
+        requestBody.expenses.map((expense) => () =>
+          createExpense(
+            context.state.user!.id,
+            expense.cost,
+            expense.description,
+            expense.budget,
+            expense.date,
+            expense.is_recurring ?? false,
+            { skipRecalculation: true, skipBudgetMatching: true, skipBudgetCreation: true },
+          )
+        ),
+        5,
+      );
+    } catch (error) {
+      console.error(error);
+      return new Response(`${error}`, { status: 500 });
+    }
+
+    const newExpenses = await getExpenses(context.state.user.id, requestBody.month);
+
+    const newBudgets = await getBudgets(context.state.user.id, requestBody.month);
+
+    const responseBody: ResponseBody = { success: true, newExpenses, newBudgets };
+
+    return new Response(JSON.stringify(responseBody));
+  },
+};

routes/api/expenses/update-budget.tsx

@@ -0,0 +1,60 @@
+import { Handlers } from 'fresh/server.ts';
+
+import { Budget, FreshContextState } from '/lib/types.ts';
+import { getBudgetById, getBudgets, updateBudget } from '/lib/data/expenses.ts';
+
+interface Data {}
+
+export interface RequestBody {
+  id: string;
+  name: string;
+  month: string;
+  value: number;
+  currentMonth: string;
+}
+
+export interface ResponseBody {
+  success: boolean;
+  newBudgets: Budget[];
+}
+
+export const handler: Handlers<Data, FreshContextState> = {
+  async POST(request, context) {
+    if (!context.state.user) {
+      return new Response('Unauthorized', { status: 401 });
+    }
+
+    const requestBody = await request.clone().json() as RequestBody;
+
+    if (
+      !requestBody.id || !requestBody.name || !requestBody.month || !requestBody.month.match(/^\d{4}-\d{2}$/) ||
+      !requestBody.value || Number.isNaN(requestBody.value) || !requestBody.currentMonth ||
+      !requestBody.currentMonth.match(/^\d{4}-\d{2}$/)
+    ) {
+      return new Response('Bad request', { status: 400 });
+    }
+
+    const budget = await getBudgetById(context.state.user.id, requestBody.id);
+
+    if (!budget) {
+      return new Response('Not found', { status: 404 });
+    }
+
+    budget.name = requestBody.name;
+    budget.month = requestBody.month;
+    budget.value = requestBody.value;
+
+    try {
+      await updateBudget(budget);
+    } catch (error) {
+      console.error(error);
+      return new Response(`${error}`, { status: 500 });
+    }
+
+    const newBudgets = await getBudgets(context.state.user.id, requestBody.currentMonth);
+
+    const responseBody: ResponseBody = { success: true, newBudgets };
+
+    return new Response(JSON.stringify(responseBody));
+  },
+};

routes/api/expenses/update-expense.tsx

@@ -0,0 +1,82 @@
+import { Handlers } from 'fresh/server.ts';
+
+import { Budget, Expense, FreshContextState } from '/lib/types.ts';
+import { getBudgets, getExpenseById, getExpenses, updateExpense } from '/lib/data/expenses.ts';
+
+interface Data {}
+
+export interface RequestBody {
+  id: string;
+  cost: number;
+  description: string;
+  budget: string;
+  date: string;
+  is_recurring: boolean;
+  month: string;
+}
+
+export interface ResponseBody {
+  success: boolean;
+  newExpenses: Expense[];
+  newBudgets: Budget[];
+}
+
+export const handler: Handlers<Data, FreshContextState> = {
+  async POST(request, context) {
+    if (!context.state.user) {
+      return new Response('Unauthorized', { status: 401 });
+    }
+
+    const requestBody = await request.clone().json() as RequestBody;
+
+    if (
+      !requestBody.id || !requestBody.cost || Number.isNaN(requestBody.cost) || !requestBody.description ||
+      !requestBody.month || !requestBody.month.match(/^\d{4}-\d{2}$/)
+    ) {
+      return new Response('Bad request', { status: 400 });
+    }
+
+    const expense = await getExpenseById(context.state.user.id, requestBody.id);
+
+    if (!expense) {
+      return new Response('Not found', { status: 404 });
+    }
+
+    if (!requestBody.budget) {
+      requestBody.budget = 'Misc';
+    }
+
+    if (!requestBody.date) {
+      requestBody.date = new Date().toISOString().substring(0, 10);
+    }
+
+    if (!requestBody.date.match(/^\d{4}-\d{2}-\d{2}$/)) {
+      return new Response('Bad request', { status: 400 });
+    }
+
+    if (!requestBody.is_recurring) {
+      requestBody.is_recurring = false;
+    }
+
+    expense.cost = requestBody.cost;
+    expense.description = requestBody.description;
+    expense.budget = requestBody.budget;
+    expense.date = requestBody.date;
+    expense.is_recurring = requestBody.is_recurring;
+
+    try {
+      await updateExpense(expense);
+    } catch (error) {
+      console.error(error);
+      return new Response(`${error}`, { status: 500 });
+    }
+
+    const newExpenses = await getExpenses(context.state.user.id, requestBody.month);
+
+    const newBudgets = await getBudgets(context.state.user.id, requestBody.month);
+
+    const responseBody: ResponseBody = { success: true, newExpenses, newBudgets };
+
+    return new Response(JSON.stringify(responseBody));
+  },
+};