super-time-tracker-ui 0.1.2

package/AGENTS.md

@@ -0,0 +1,5 @@
+<!-- BEGIN:nextjs-agent-rules -->
+# This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
+<!-- END:nextjs-agent-rules -->

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### [0.1.2](https://github.com/f3rnox/super-time-tracker-ui/compare/v0.1.1...v0.1.2) (2026-05-18)
+
+
+### Bug Fixes
+
+* rm private from manifest and add author email ([ec4d2ac](https://github.com/f3rnox/super-time-tracker-ui/commit/ec4d2ac8b340d8ccb1339aa785f78beae87d68ad))
+
+### 0.1.1 (2026-05-18)
+
+
+### Features
+
+* add move to sheet option to active entry ([ef1fe83](https://github.com/f3rnox/super-time-tracker-ui/commit/ef1fe8357b05a255e3e107ae67d6c75bd9845276))
+* initial commit ([15a8998](https://github.com/f3rnox/super-time-tracker-ui/commit/15a8998c1ac09fa5392635a92b93d0a9d8412f53))
+* minor updates, multi-select functionality ([69ccbd0](https://github.com/f3rnox/super-time-tracker-ui/commit/69ccbd01c8ac04dfebbdbad40bd648f95d5d55dc))
+* show sheet entry list, minor changes ([8d918f7](https://github.com/f3rnox/super-time-tracker-ui/commit/8d918f71070bf537daa203e4483525109f90b949))
+* update ([ed0d7e6](https://github.com/f3rnox/super-time-tracker-ui/commit/ed0d7e614ab7ee73ef1d5f7c8f5bf2ca8b7f66e0))
+* update ([b272c68](https://github.com/f3rnox/super-time-tracker-ui/commit/b272c68b16a1ee0b70384c328cbcbcc42a2b290d))
+* update ([c9a138d](https://github.com/f3rnox/super-time-tracker-ui/commit/c9a138d5019f6aa488acb74eb8fbf0eabe3ea8e8))
+* update ([f49cc33](https://github.com/f3rnox/super-time-tracker-ui/commit/f49cc33227666f59b8db55517d98352515a88dd1))
+* update ([4efa65f](https://github.com/f3rnox/super-time-tracker-ui/commit/4efa65f63cee5e0bf829b209170c8b8a383d749e))
+* update ([913173d](https://github.com/f3rnox/super-time-tracker-ui/commit/913173dc8dfec47e181c5e839fa6d6bfa0e0cd96))
+* update with many new settings and features ([198f093](https://github.com/f3rnox/super-time-tracker-ui/commit/198f093c1f515380a8885bdb5119efdc7aabb07f))
+* update, add entry editing and --at support ([bc51980](https://github.com/f3rnox/super-time-tracker-ui/commit/bc51980436e12f907fe13e810586ea7b7ff59e08))

package/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/README.md

@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

package/app/api/backup/route.ts

@@ -0,0 +1,39 @@
+import { NextResponse } from 'next/server'
+
+import { api_error_response } from '@/lib/api_error_response'
+import { DB_FILE_NAME } from '@/lib/config'
+import { read_db_backup_contents } from '@/lib/read_db_backup_contents'
+import { restore_db_from_uploaded_json } from '@/lib/restore_db_from_uploaded_json'
+
+/**
+ * Downloads the tracker database as JSON.
+ */
+export async function GET(): Promise<NextResponse> {
+  try {
+    const contents = await read_db_backup_contents()
+
+    return new NextResponse(contents, {
+      headers: {
+        'Content-Type': 'application/json; charset=utf-8',
+        'Content-Disposition': `attachment; filename="${DB_FILE_NAME}"`,
+      },
+    })
+  } catch (error: unknown) {
+    return api_error_response(error, 500)
+  }
+}
+
+/**
+ * Restores the tracker database from an uploaded backup.
+ */
+export async function POST(request: Request): Promise<NextResponse> {
+  try {
+    const uploaded: unknown = await request.json()
+
+    await restore_db_from_uploaded_json(uploaded)
+
+    return NextResponse.json({ ok: true })
+  } catch (error: unknown) {
+    return api_error_response(error, 400)
+  }
+}

package/app/api/entry/delete-bulk/route.ts

@@ -0,0 +1,53 @@
+import { NextResponse } from 'next/server'
+
+import { api_error_response } from '@/lib/api_error_response'
+import { delete_entries } from '@/lib/delete_entries'
+import { get_tracker_state } from '@/lib/get_tracker_state'
+
+interface DeleteEntryRefBody {
+  sheetName?: string
+  entryId?: number
+}
+
+interface DeleteEntriesBody {
+  entries?: DeleteEntryRefBody[]
+}
+
+/**
+ * Deletes multiple time sheet entries across sheets.
+ */
+export async function POST(request: Request): Promise<NextResponse> {
+  try {
+    const body = (await request.json()) as DeleteEntriesBody
+    const raw_entries = body.entries ?? []
+
+    if (raw_entries.length === 0) {
+      return api_error_response(new Error('No entries selected'))
+    }
+
+    const entries = raw_entries.map((entry, index) => {
+      const sheet_name = entry.sheetName?.trim() ?? ''
+      const entry_id = entry.entryId
+
+      if (sheet_name.length === 0) {
+        throw new Error(`Entry ${index + 1} is missing a sheet name`)
+      }
+
+      if (entry_id === undefined || !Number.isFinite(entry_id)) {
+        throw new Error(`Entry ${index + 1} is missing an entry id`)
+      }
+
+      return {
+        sheet_name,
+        entry_id,
+      }
+    })
+
+    await delete_entries({ entries })
+
+    const state = await get_tracker_state()
+    return NextResponse.json(state)
+  } catch (error: unknown) {
+    return api_error_response(error)
+  }
+}

package/app/api/entry/move/route.ts

@@ -0,0 +1,46 @@
+import { NextResponse } from "next/server";
+
+import { api_error_response } from "@/lib/api_error_response";
+import { get_tracker_state } from "@/lib/get_tracker_state";
+import { move_entry_to_sheet } from "@/lib/move_entry_to_sheet";
+
+interface MoveEntryBody {
+  sheetName?: string;
+  entryId?: number;
+  targetSheetName?: string;
+}
+
+/**
+ * Moves a time sheet entry to another sheet.
+ */
+export async function POST(request: Request): Promise<NextResponse> {
+  try {
+    const body = (await request.json()) as MoveEntryBody;
+    const sheet_name = body.sheetName?.trim() ?? "";
+    const entry_id = body.entryId;
+    const target_sheet_name = body.targetSheetName?.trim() ?? "";
+
+    if (sheet_name.length === 0) {
+      return api_error_response(new Error("Sheet name is required"));
+    }
+
+    if (entry_id === undefined || !Number.isFinite(entry_id)) {
+      return api_error_response(new Error("Entry id is required"));
+    }
+
+    if (target_sheet_name.length === 0) {
+      return api_error_response(new Error("Target sheet name is required"));
+    }
+
+    await move_entry_to_sheet({
+      sheet_name,
+      entry_id,
+      target_sheet_name,
+    });
+
+    const state = await get_tracker_state();
+    return NextResponse.json(state);
+  } catch (error: unknown) {
+    return api_error_response(error);
+  }
+}

package/app/api/entry/move-bulk/route.ts

@@ -0,0 +1,62 @@
+import { NextResponse } from "next/server";
+
+import { api_error_response } from "@/lib/api_error_response";
+import { get_tracker_state } from "@/lib/get_tracker_state";
+import { move_entries_to_sheet } from "@/lib/move_entries_to_sheet";
+
+interface MoveEntryRefBody {
+  sheetName?: string;
+  entryId?: number;
+}
+
+interface MoveEntriesBody {
+  entries?: MoveEntryRefBody[];
+  targetSheetName?: string;
+}
+
+/**
+ * Moves multiple time sheet entries to another sheet.
+ */
+export async function POST(request: Request): Promise<NextResponse> {
+  try {
+    const body = (await request.json()) as MoveEntriesBody;
+    const target_sheet_name = body.targetSheetName?.trim() ?? "";
+    const raw_entries = body.entries ?? [];
+
+    if (target_sheet_name.length === 0) {
+      return api_error_response(new Error("Target sheet name is required"));
+    }
+
+    if (raw_entries.length === 0) {
+      return api_error_response(new Error("No entries selected"));
+    }
+
+    const entries = raw_entries.map((entry, index) => {
+      const sheet_name = entry.sheetName?.trim() ?? "";
+      const entry_id = entry.entryId;
+
+      if (sheet_name.length === 0) {
+        throw new Error(`Entry ${index + 1} is missing a sheet name`);
+      }
+
+      if (entry_id === undefined || !Number.isFinite(entry_id)) {
+        throw new Error(`Entry ${index + 1} is missing an entry id`);
+      }
+
+      return {
+        sheet_name,
+        entry_id,
+      };
+    });
+
+    await move_entries_to_sheet({
+      entries,
+      target_sheet_name,
+    });
+
+    const state = await get_tracker_state();
+    return NextResponse.json(state);
+  } catch (error: unknown) {
+    return api_error_response(error);
+  }
+}

package/app/api/entry/route.ts

@@ -0,0 +1,75 @@
+import { NextResponse } from "next/server";
+
+import { api_error_response } from "@/lib/api_error_response";
+import { delete_entry } from "@/lib/delete_entry";
+import { edit_entry } from "@/lib/edit_entry";
+import { get_tracker_state } from "@/lib/get_tracker_state";
+
+interface EntryIdBody {
+  sheetName?: string;
+  entryId?: number;
+}
+
+interface EditEntryBody extends EntryIdBody {
+  start?: string;
+  end?: string;
+  description?: string;
+}
+
+/**
+ * Deletes a time sheet entry by id.
+ */
+export async function POST(request: Request): Promise<NextResponse> {
+  try {
+    const body = (await request.json()) as EntryIdBody;
+    const sheet_name = body.sheetName?.trim() ?? "";
+    const entry_id = body.entryId;
+
+    if (sheet_name.length === 0) {
+      return api_error_response(new Error("Sheet name is required"));
+    }
+
+    if (entry_id === undefined || !Number.isFinite(entry_id)) {
+      return api_error_response(new Error("Entry id is required"));
+    }
+
+    await delete_entry({ sheet_name, entry_id });
+
+    const state = await get_tracker_state();
+    return NextResponse.json(state);
+  } catch (error: unknown) {
+    return api_error_response(error);
+  }
+}
+
+/**
+ * Updates a time sheet entry's times or description.
+ */
+export async function PATCH(request: Request): Promise<NextResponse> {
+  try {
+    const body = (await request.json()) as EditEntryBody;
+    const sheet_name = body.sheetName?.trim() ?? "";
+    const entry_id = body.entryId;
+
+    if (sheet_name.length === 0) {
+      return api_error_response(new Error("Sheet name is required"));
+    }
+
+    if (entry_id === undefined || !Number.isFinite(entry_id)) {
+      return api_error_response(new Error("Entry id is required"));
+    }
+
+    await edit_entry({
+      sheet_name,
+      entry_id,
+      start: body.start,
+      end: body.end,
+      description: body.description,
+    });
+
+    const state = await get_tracker_state();
+    return NextResponse.json(state);
+  } catch (error: unknown) {
+    return api_error_response(error);
+  }
+}

package/app/api/in/route.ts

@@ -0,0 +1,38 @@
+import { NextResponse } from "next/server";
+
+import { api_error_response } from "@/lib/api_error_response";
+import { check_in_entry } from "@/lib/check_in_entry";
+import { get_tracker_state } from "@/lib/get_tracker_state";
+
+interface CheckInBody {
+  description?: string;
+  sheetName?: string;
+  note?: string;
+  at?: string;
+}
+
+/**
+ * Checks in to a time sheet entry.
+ */
+export async function POST(request: Request): Promise<NextResponse> {
+  try {
+    const body = (await request.json()) as CheckInBody;
+    const description = body.description?.trim() ?? "";
+
+    if (description.length === 0) {
+      return api_error_response(new Error("Description is required"));
+    }
+
+    await check_in_entry({
+      description,
+      sheet_name: body.sheetName,
+      note: body.note,
+      at: body.at,
+    });
+
+    const state = await get_tracker_state();
+    return NextResponse.json(state);
+  } catch (error: unknown) {
+    return api_error_response(error);
+  }
+}

package/app/api/note/route.ts

@@ -0,0 +1,120 @@
+import { NextResponse } from "next/server";
+
+import { add_note_to_entry } from "@/lib/add_note_to_entry";
+import { delete_note_on_entry } from "@/lib/delete_note_on_entry";
+import { edit_note_on_entry } from "@/lib/edit_note_on_entry";
+import { api_error_response } from "@/lib/api_error_response";
+import { get_tracker_state } from "@/lib/get_tracker_state";
+
+interface NoteBody {
+  text?: string;
+  at?: string;
+  sheetName?: string;
+  entryId?: number;
+}
+
+interface EditNoteBody extends NoteBody {
+  timestamp?: string;
+}
+
+/**
+ * Attaches a note to an entry.
+ */
+export async function POST(request: Request): Promise<NextResponse> {
+  try {
+    const body = (await request.json()) as NoteBody;
+    const text = body.text?.trim() ?? "";
+
+    if (text.length === 0) {
+      return api_error_response(new Error("Note text is required"));
+    }
+
+    await add_note_to_entry({
+      text,
+      at: body.at,
+      sheet_name: body.sheetName,
+      entry_id: body.entryId,
+    });
+
+    const state = await get_tracker_state();
+    return NextResponse.json(state);
+  } catch (error: unknown) {
+    return api_error_response(error);
+  }
+}
+
+/**
+ * Updates an existing note on an entry.
+ */
+export async function PATCH(request: Request): Promise<NextResponse> {
+  try {
+    const body = (await request.json()) as EditNoteBody;
+    const sheet_name = body.sheetName?.trim() ?? "";
+    const entry_id = body.entryId;
+    const timestamp = body.timestamp?.trim() ?? "";
+    const text = body.text?.trim() ?? "";
+
+    if (sheet_name.length === 0) {
+      return api_error_response(new Error("Sheet name is required"));
+    }
+
+    if (entry_id === undefined || !Number.isFinite(entry_id)) {
+      return api_error_response(new Error("Entry id is required"));
+    }
+
+    if (timestamp.length === 0) {
+      return api_error_response(new Error("Note timestamp is required"));
+    }
+
+    if (text.length === 0) {
+      return api_error_response(new Error("Note text is required"));
+    }
+
+    await edit_note_on_entry({
+      sheet_name,
+      entry_id,
+      note_timestamp: timestamp,
+      text,
+    });
+
+    const state = await get_tracker_state();
+    return NextResponse.json(state);
+  } catch (error: unknown) {
+    return api_error_response(error);
+  }
+}
+
+/**
+ * Removes a note from an entry.
+ */
+export async function DELETE(request: Request): Promise<NextResponse> {
+  try {
+    const body = (await request.json()) as EditNoteBody;
+    const sheet_name = body.sheetName?.trim() ?? "";
+    const entry_id = body.entryId;
+    const timestamp = body.timestamp?.trim() ?? "";
+
+    if (sheet_name.length === 0) {
+      return api_error_response(new Error("Sheet name is required"));
+    }
+
+    if (entry_id === undefined || !Number.isFinite(entry_id)) {
+      return api_error_response(new Error("Entry id is required"));
+    }
+
+    if (timestamp.length === 0) {
+      return api_error_response(new Error("Note timestamp is required"));
+    }
+
+    await delete_note_on_entry({
+      sheet_name,
+      entry_id,
+      note_timestamp: timestamp,
+    });
+
+    const state = await get_tracker_state();
+    return NextResponse.json(state);
+  } catch (error: unknown) {
+    return api_error_response(error);
+  }
+}

package/app/api/out/route.ts

@@ -0,0 +1,31 @@
+import { NextResponse } from "next/server";
+
+import { api_error_response } from "@/lib/api_error_response";
+import { check_out_entry } from "@/lib/check_out_entry";
+import { get_tracker_state } from "@/lib/get_tracker_state";
+
+interface CheckOutBody {
+  sheetName?: string;
+  note?: string;
+  at?: string;
+}
+
+/**
+ * Checks out of the active time sheet entry.
+ */
+export async function POST(request: Request): Promise<NextResponse> {
+  try {
+    const body = (await request.json()) as CheckOutBody;
+
+    await check_out_entry({
+      sheet_name: body.sheetName,
+      note: body.note,
+      at: body.at,
+    });
+
+    const state = await get_tracker_state();
+    return NextResponse.json(state);
+  } catch (error: unknown) {
+    return api_error_response(error);
+  }
+}

package/app/api/sheet/route.ts

@@ -0,0 +1,68 @@
+import { NextResponse } from "next/server";
+
+import { api_error_response } from "@/lib/api_error_response";
+import { delete_sheet } from "@/lib/delete_sheet";
+import { get_tracker_state } from "@/lib/get_tracker_state";
+import { rename_sheet } from "@/lib/rename_sheet";
+import { set_active_sheet } from "@/lib/set_active_sheet";
+
+interface SheetBody {
+  name?: string;
+  delete?: boolean;
+}
+
+interface RenameSheetBody {
+  name?: string;
+  newName?: string;
+}
+
+/**
+ * Switches the active sheet or deletes one by name.
+ */
+export async function POST(request: Request): Promise<NextResponse> {
+  try {
+    const body = (await request.json()) as SheetBody;
+    const name = body.name?.trim() ?? "";
+
+    if (name.length === 0) {
+      return api_error_response(new Error("Sheet name is required"));
+    }
+
+    if (body.delete === true) {
+      await delete_sheet(name);
+    } else {
+      await set_active_sheet(name);
+    }
+
+    const state = await get_tracker_state(body.delete === true ? undefined : name);
+    return NextResponse.json(state);
+  } catch (error: unknown) {
+    return api_error_response(error);
+  }
+}
+
+/**
+ * Renames an existing sheet.
+ */
+export async function PATCH(request: Request): Promise<NextResponse> {
+  try {
+    const body = (await request.json()) as RenameSheetBody;
+    const name = body.name?.trim() ?? "";
+    const new_name = body.newName?.trim() ?? "";
+
+    if (name.length === 0) {
+      return api_error_response(new Error("Sheet name is required"));
+    }
+
+    if (new_name.length === 0) {
+      return api_error_response(new Error("New sheet name is required"));
+    }
+
+    await rename_sheet({ sheet_name: name, new_name });
+
+    const state = await get_tracker_state();
+    return NextResponse.json(state);
+  } catch (error: unknown) {
+    return api_error_response(error);
+  }
+}

package/app/api/state/route.ts

@@ -0,0 +1,16 @@
+import { NextResponse } from "next/server";
+
+import { api_error_response } from "@/lib/api_error_response";
+import { get_tracker_state } from "@/lib/get_tracker_state";
+
+/**
+ * Returns the current tracker snapshot for the UI.
+ */
+export async function GET(): Promise<NextResponse> {
+  try {
+    const state = await get_tracker_state();
+    return NextResponse.json(state);
+  } catch (error: unknown) {
+    return api_error_response(error, 500);
+  }
+}