wip 11

AGENTS.md

@@ -12,14 +12,21 @@ Currently mid migration from go templates (`./templates`) to React App (`./front
 The frontend uses ESLint and Prettier for code quality and formatting.
 
 ### Running Linting
-- **Check linting**: `cd frontend && npm run lint`
+- **Check linting**: `cd frontend && bun run lint`
-- **Fix linting issues**: `cd frontend && npm run lint:fix`
+- **Fix linting issues**: `cd frontend && bun run lint:fix`
-- **Check formatting**: `cd frontend && npm run format`
+- **Check formatting**: `cd frontend && bun run format`
-- **Format files**: `cd frontend && npm run format:fix`
+- **Format files**: `cd frontend && bun run format:fix`
 
 ### When to Run Linting
 Run linting after making any changes to the frontend to ensure code quality and consistency. All new code should pass linting before committing.
 
+### Package Management
+The frontend uses **bun** for package management. Use:
+- `bun install` to install dependencies
+- `bun add <package>` to add a new package
+- `bun remove <package>` to remove a package
+- `bunx <command>` to run CLI binaries locally
+
 ## Data Flow (CRITICAL for migrations)
 1. Database schema → SQL queries (`database/query.sql`, `database/query.sql.go`)
 2. SQLC models → API handlers (`api/v1/*.go`)  

flake.nix

@@ -21,11 +21,12 @@
         devShells.default = pkgs.mkShell {
           packages = with pkgs; [
             go
-            gopls
             golangci-lint
+            gopls
+
+            bun
             nodejs
             tailwindcss
-            python311Packages.grip
           ];
           shellHook = ''
             export PATH=$PATH:~/go/bin

frontend/package.json

@@ -15,9 +15,11 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.62.16",
+    "ajv": "^8.18.0",
     "axios": "^1.13.6",
     "clsx": "^2.1.1",
     "lucide-react": "^0.577.0",
+    "orval": "8.5.3",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "react-router-dom": "^7.1.1",
@@ -37,7 +39,6 @@
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^5.0.0",
     "eslint-plugin-tailwindcss": "^3.18.2",
-    "orval": "^8.5.3",
     "postcss": "^8.4.49",
     "prettier": "^3.3.3",
     "tailwindcss": "^3.4.17",

frontend/src/generated/model/activity.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/activityResponse.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/backupType.ts

@@ -1,14 +1,14 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
  * OpenAPI spec version: 1.0.0
  */
 
-export type BackupType = (typeof BackupType)[keyof typeof BackupType];
+export type BackupType = typeof BackupType[keyof typeof BackupType];
+
 
-// eslint-disable-next-line @typescript-eslint/no-redeclare
 export const BackupType = {
   COVERS: 'COVERS',
   DOCUMENTS: 'DOCUMENTS',

frontend/src/generated/model/createDocumentBody.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/databaseInfo.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/device.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/directoryItem.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/directoryListResponse.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/document.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/documentResponse.ts

@@ -1,13 +1,13 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
  * OpenAPI spec version: 1.0.0
  */
 import type { Document } from './document';
-import type { UserData } from './userData';
 import type { Progress } from './progress';
+import type { UserData } from './userData';
 
 export interface DocumentResponse {
   document: Document;

frontend/src/generated/model/documentsResponse.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/errorResponse.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/getActivityParams.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
@@ -7,8 +7,8 @@
  */
 
 export type GetActivityParams = {
-  doc_filter?: boolean;
+doc_filter?: boolean;
-  document_id?: string;
+document_id?: string;
-  offset?: number;
+offset?: number;
-  limit?: number;
+limit?: number;
 };

frontend/src/generated/model/getAdmin200.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/getDocumentsParams.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
@@ -7,7 +7,7 @@
  */
 
 export type GetDocumentsParams = {
-  page?: number;
+page?: number;
-  limit?: number;
+limit?: number;
-  search?: string;
+search?: string;
 };

frontend/src/generated/model/getImportDirectoryParams.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
@@ -7,6 +7,6 @@
  */
 
 export type GetImportDirectoryParams = {
-  directory?: string;
+directory?: string;
-  select?: string;
+select?: string;
 };

frontend/src/generated/model/getLogsParams.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
@@ -7,5 +7,5 @@
  */
 
 export type GetLogsParams = {
-  filter?: string;
+filter?: string;
 };

frontend/src/generated/model/getProgressListParams.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
@@ -7,7 +7,7 @@
  */
 
 export type GetProgressListParams = {
-  page?: number;
+page?: number;
-  limit?: number;
+limit?: number;
-  document?: string;
+document?: string;
 };

frontend/src/generated/model/getSearchParams.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
@@ -8,6 +8,6 @@
 import type { GetSearchSource } from './getSearchSource';
 
 export type GetSearchParams = {
-  query: string;
+query: string;
-  source: GetSearchSource;
+source: GetSearchSource;
 };

frontend/src/generated/model/getSearchSource.ts

@@ -1,14 +1,14 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
  * OpenAPI spec version: 1.0.0
  */
 
-export type GetSearchSource = (typeof GetSearchSource)[keyof typeof GetSearchSource];
+export type GetSearchSource = typeof GetSearchSource[keyof typeof GetSearchSource];
+
 
-// eslint-disable-next-line @typescript-eslint/no-redeclare
 export const GetSearchSource = {
   LibGen: 'LibGen',
   Annas_Archive: 'Annas Archive',

frontend/src/generated/model/graphDataPoint.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/graphDataResponse.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/homeResponse.ts

@@ -1,15 +1,15 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
  * OpenAPI spec version: 1.0.0
  */
 import type { DatabaseInfo } from './databaseInfo';
-import type { StreaksResponse } from './streaksResponse';
 import type { GraphDataResponse } from './graphDataResponse';
-import type { UserStatisticsResponse } from './userStatisticsResponse';
+import type { StreaksResponse } from './streaksResponse';
 import type { UserData } from './userData';
+import type { UserStatisticsResponse } from './userStatisticsResponse';
 
 export interface HomeResponse {
   database_info: DatabaseInfo;

frontend/src/generated/model/importResult.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/importResultStatus.ts

@@ -1,14 +1,14 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
  * OpenAPI spec version: 1.0.0
  */
 
-export type ImportResultStatus = (typeof ImportResultStatus)[keyof typeof ImportResultStatus];
+export type ImportResultStatus = typeof ImportResultStatus[keyof typeof ImportResultStatus];
+
 
-// eslint-disable-next-line @typescript-eslint/no-redeclare
 export const ImportResultStatus = {
   FAILED: 'FAILED',
   SUCCESS: 'SUCCESS',

frontend/src/generated/model/importResultsResponse.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/importType.ts

@@ -1,14 +1,14 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
  * OpenAPI spec version: 1.0.0
  */
 
-export type ImportType = (typeof ImportType)[keyof typeof ImportType];
+export type ImportType = typeof ImportType[keyof typeof ImportType];
+
 
-// eslint-disable-next-line @typescript-eslint/no-redeclare
 export const ImportType = {
   DIRECT: 'DIRECT',
   COPY: 'COPY',

frontend/src/generated/model/index.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
@@ -30,8 +30,8 @@ export * from './graphDataPoint';
 export * from './graphDataResponse';
 export * from './homeResponse';
 export * from './importResult';
-export * from './importResultStatus';
 export * from './importResultsResponse';
+export * from './importResultStatus';
 export * from './importType';
 export * from './leaderboardData';
 export * from './leaderboardEntry';
@@ -56,7 +56,7 @@ export * from './updateSettingsRequest';
 export * from './updateUserBody';
 export * from './user';
 export * from './userData';
+export * from './usersResponse';
 export * from './userStatisticsResponse';
 export * from './userStreak';
-export * from './usersResponse';
 export * from './wordCount';

frontend/src/generated/model/leaderboardData.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/leaderboardEntry.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/logEntry.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/loginRequest.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/loginResponse.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/logsResponse.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/operationType.ts

@@ -1,14 +1,14 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
  * OpenAPI spec version: 1.0.0
  */
 
-export type OperationType = (typeof OperationType)[keyof typeof OperationType];
+export type OperationType = typeof OperationType[keyof typeof OperationType];
+
 
-// eslint-disable-next-line @typescript-eslint/no-redeclare
 export const OperationType = {
   CREATE: 'CREATE',
   UPDATE: 'UPDATE',

frontend/src/generated/model/postAdminActionBody.ts

@@ -1,12 +1,12 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
  * OpenAPI spec version: 1.0.0
  */
-import type { PostAdminActionBodyAction } from './postAdminActionBodyAction';
 import type { BackupType } from './backupType';
+import type { PostAdminActionBodyAction } from './postAdminActionBodyAction';
 
 export type PostAdminActionBody = {
   action: PostAdminActionBodyAction;

frontend/src/generated/model/postAdminActionBodyAction.ts

@@ -1,15 +1,14 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
  * OpenAPI spec version: 1.0.0
  */
 
-export type PostAdminActionBodyAction =
+export type PostAdminActionBodyAction = typeof PostAdminActionBodyAction[keyof typeof PostAdminActionBodyAction];
-  (typeof PostAdminActionBodyAction)[keyof typeof PostAdminActionBodyAction];
+
 
-// eslint-disable-next-line @typescript-eslint/no-redeclare
 export const PostAdminActionBodyAction = {
   BACKUP: 'BACKUP',
   RESTORE: 'RESTORE',

frontend/src/generated/model/postImportBody.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/postSearchBody.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/progress.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/progressListResponse.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/progressResponse.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/searchItem.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/searchResponse.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/setting.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/settingsResponse.ts

@@ -1,12 +1,12 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
  * OpenAPI spec version: 1.0.0
  */
-import type { UserData } from './userData';
 import type { Device } from './device';
+import type { UserData } from './userData';
 
 export interface SettingsResponse {
   user: UserData;

frontend/src/generated/model/streaksResponse.ts

@@ -1,12 +1,12 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system
  * OpenAPI spec version: 1.0.0
  */
-import type { UserStreak } from './userStreak';
 import type { UserData } from './userData';
+import type { UserStreak } from './userStreak';
 
 export interface StreaksResponse {
   streaks: UserStreak[];

frontend/src/generated/model/updateSettingsRequest.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/updateUserBody.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/user.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/userData.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/userStatisticsResponse.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/userStreak.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/usersResponse.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system

frontend/src/generated/model/wordCount.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.21.0 🍺
+ * Generated by orval v8.5.3 🍺
  * Do not edit manually.
  * AnthoLume API v1
  * REST API for AnthoLume document management system