refactor: migrate from types to dto

.adonisjs/api.ts

@@ -0,0 +1,743 @@
+// @ts-nocheck
+/* eslint-disable */
+// --------------------------------------------------
+// This file is auto-generated by Tuyau. Do not edit manually !
+// --------------------------------------------------
+
+import type { MakeTuyauRequest, MakeTuyauResponse } from '@tuyau/utils/types';
+import type { InferInput } from '@vinejs/vine/types';
+
+type AdminGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/admin/admin_controller.ts').default['index'],
+		false
+	>;
+};
+type ApiV1CollectionsPost = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/collections/create_collection_validator.ts'))['createCollectionValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/api/collections/create_collection_controller.ts').default['execute'],
+		true
+	>;
+};
+type ApiV1CollectionsIdDelete = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/collections/delete_collection_validator.ts'))['deleteCollectionValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/api/collections/delete_collection_controller.ts').default['execute'],
+		true
+	>;
+};
+type ApiV1CollectionsGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/api/collections/get_collections_controller.ts').default['show'],
+		false
+	>;
+};
+type ApiV1CollectionsIdPut = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/collections/update_collection_validator.ts'))['updateCollectionValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/api/collections/update_collection_controller.ts').default['execute'],
+		true
+	>;
+};
+type ApiV1LinksPost = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/links/create_link_validator.ts'))['createLinkValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/api/links/create_link_controller.ts').default['execute'],
+		true
+	>;
+};
+type ApiV1LinksIdDelete = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/links/delete_link_validator.ts'))['deleteLinkValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/api/links/delete_link_controller.ts').default['execute'],
+		true
+	>;
+};
+type ApiV1LinksFavoritesGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/api/links/get_favorite_links_controller.ts').default['execute'],
+		false
+	>;
+};
+type ApiV1LinksIdPut = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/links/update_link_validator.ts'))['updateLinkValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/api/links/update_link_controller.ts').default['execute'],
+		true
+	>;
+};
+type ApiV1TokensCheckGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/api/tokens/api_token_controller.ts').default['index'],
+		false
+	>;
+};
+type AuthCallbackGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/auth/auth_controller.ts').default['callbackAuth'],
+		false
+	>;
+};
+type AuthLogoutGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/auth/auth_controller.ts').default['logout'],
+		false
+	>;
+};
+type DashboardGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/collections/show_collections_controller.ts').default['render'],
+		false
+	>;
+};
+type CollectionsCreateGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/collections/create_collection_controller.ts').default['render'],
+		false
+	>;
+};
+type CollectionsPost = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/collections/create_collection_validator.ts'))['createCollectionValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/collections/create_collection_controller.ts').default['execute'],
+		true
+	>;
+};
+type CollectionsEditGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/collections/update_collection_controller.ts').default['render'],
+		false
+	>;
+};
+type CollectionsIdPut = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/collections/update_collection_validator.ts'))['updateCollectionValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/collections/update_collection_controller.ts').default['execute'],
+		true
+	>;
+};
+type CollectionsDeleteGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/collections/delete_collection_controller.ts').default['render'],
+		false
+	>;
+};
+type CollectionsIdDelete = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/collections/delete_collection_validator.ts'))['deleteCollectionValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/collections/delete_collection_controller.ts').default['execute'],
+		true
+	>;
+};
+type FaviconGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/favicons/favicons_controller.ts').default['index'],
+		false
+	>;
+};
+type LinksCreateGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/links/create_link_controller.ts').default['render'],
+		false
+	>;
+};
+type LinksPost = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/links/create_link_validator.ts'))['createLinkValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/links/create_link_controller.ts').default['execute'],
+		true
+	>;
+};
+type LinksEditGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/links/update_link_controller.ts').default['render'],
+		false
+	>;
+};
+type LinksIdPut = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/links/update_link_validator.ts'))['updateLinkValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/links/update_link_controller.ts').default['execute'],
+		true
+	>;
+};
+type LinksIdFavoritePut = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/links/update_favorite_link_validator.ts'))['updateLinkFavoriteStatusValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/links/toggle_favorite_controller.ts').default['toggleFavorite'],
+		true
+	>;
+};
+type LinksDeleteGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/links/delete_link_controller.ts').default['render'],
+		false
+	>;
+};
+type LinksIdDelete = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/links/delete_link_validator.ts'))['deleteLinkValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/links/delete_link_controller.ts').default['execute'],
+		true
+	>;
+};
+type SearchGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/search/search_controller.ts').default['search'],
+		false
+	>;
+};
+type SharedIdGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/shared_collections/shared_collections_controller.ts').default['index'],
+		false
+	>;
+};
+type UserApitokensPost = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/user/token/create_api_token.ts'))['createApiTokenValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/user/api_token_controller.ts').default['store'],
+		true
+	>;
+};
+type UserApitokensIdDelete = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/user/token/delete_api_token.ts'))['deleteApiTokenValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/user/api_token_controller.ts').default['destroy'],
+		true
+	>;
+};
+type UserDisplaypreferencesPost = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/user/update_display_preferences.ts'))['updateDisplayPreferencesValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/user/display_preferences_controller.ts').default['update'],
+		true
+	>;
+};
+type UserThemePost = {
+	request: MakeTuyauRequest<
+		InferInput<
+			(typeof import('../app/validators/user/update_theme_validator.ts'))['updateThemeValidator']
+		>
+	>;
+	response: MakeTuyauResponse<
+		import('../app/controllers/user/theme_controller.ts').default['index'],
+		true
+	>;
+};
+type UserSettingsGetHead = {
+	request: unknown;
+	response: MakeTuyauResponse<
+		import('../app/controllers/user_settings/show_user_settings_controller.ts').default['render'],
+		false
+	>;
+};
+export interface ApiDefinition {
+	admin: {
+		$url: {};
+		$get: AdminGetHead;
+		$head: AdminGetHead;
+	};
+	api: {
+		v1: {
+			collections: {
+				$url: {};
+				$post: ApiV1CollectionsPost;
+				':id': {
+					$url: {};
+					$delete: ApiV1CollectionsIdDelete;
+					$put: ApiV1CollectionsIdPut;
+				};
+				$get: ApiV1CollectionsGetHead;
+				$head: ApiV1CollectionsGetHead;
+			};
+			links: {
+				$url: {};
+				$post: ApiV1LinksPost;
+				':id': {
+					$url: {};
+					$delete: ApiV1LinksIdDelete;
+					$put: ApiV1LinksIdPut;
+				};
+				favorites: {
+					$url: {};
+					$get: ApiV1LinksFavoritesGetHead;
+					$head: ApiV1LinksFavoritesGetHead;
+				};
+			};
+			tokens: {
+				check: {
+					$url: {};
+					$get: ApiV1TokensCheckGetHead;
+					$head: ApiV1TokensCheckGetHead;
+				};
+			};
+		};
+	};
+	auth: {
+		callback: {
+			$url: {};
+			$get: AuthCallbackGetHead;
+			$head: AuthCallbackGetHead;
+		};
+		logout: {
+			$url: {};
+			$get: AuthLogoutGetHead;
+			$head: AuthLogoutGetHead;
+		};
+	};
+	dashboard: {
+		$url: {};
+		$get: DashboardGetHead;
+		$head: DashboardGetHead;
+	};
+	collections: {
+		create: {
+			$url: {};
+			$get: CollectionsCreateGetHead;
+			$head: CollectionsCreateGetHead;
+		};
+		$url: {};
+		$post: CollectionsPost;
+		edit: {
+			$url: {};
+			$get: CollectionsEditGetHead;
+			$head: CollectionsEditGetHead;
+		};
+		':id': {
+			$url: {};
+			$put: CollectionsIdPut;
+			$delete: CollectionsIdDelete;
+		};
+		delete: {
+			$url: {};
+			$get: CollectionsDeleteGetHead;
+			$head: CollectionsDeleteGetHead;
+		};
+	};
+	favicon: {
+		$url: {};
+		$get: FaviconGetHead;
+		$head: FaviconGetHead;
+	};
+	links: {
+		create: {
+			$url: {};
+			$get: LinksCreateGetHead;
+			$head: LinksCreateGetHead;
+		};
+		$url: {};
+		$post: LinksPost;
+		edit: {
+			$url: {};
+			$get: LinksEditGetHead;
+			$head: LinksEditGetHead;
+		};
+		':id': {
+			$url: {};
+			$put: LinksIdPut;
+			favorite: {
+				$url: {};
+				$put: LinksIdFavoritePut;
+			};
+			$delete: LinksIdDelete;
+		};
+		delete: {
+			$url: {};
+			$get: LinksDeleteGetHead;
+			$head: LinksDeleteGetHead;
+		};
+	};
+	search: {
+		$url: {};
+		$get: SearchGetHead;
+		$head: SearchGetHead;
+	};
+	shared: {
+		':id': {
+			$url: {};
+			$get: SharedIdGetHead;
+			$head: SharedIdGetHead;
+		};
+	};
+	user: {
+		'api-tokens': {
+			$url: {};
+			$post: UserApitokensPost;
+			':tokenId': {
+				$url: {};
+				$delete: UserApitokensIdDelete;
+			};
+		};
+		'display-preferences': {
+			$url: {};
+			$post: UserDisplaypreferencesPost;
+		};
+		theme: {
+			$url: {};
+			$post: UserThemePost;
+		};
+		settings: {
+			$url: {};
+			$get: UserSettingsGetHead;
+			$head: UserSettingsGetHead;
+		};
+	};
+}
+const routes = [
+	{
+		params: [],
+		name: 'admin.dashboard',
+		path: '/admin',
+		method: ['GET', 'HEAD'],
+		types: {} as AdminGetHead,
+	},
+	{
+		params: [],
+		name: 'api-collections.create',
+		path: '/api/v1/collections',
+		method: ['POST'],
+		types: {} as ApiV1CollectionsPost,
+	},
+	{
+		params: ['id'],
+		name: 'api-collections.delete',
+		path: '/api/v1/collections/:id',
+		method: ['DELETE'],
+		types: {} as ApiV1CollectionsIdDelete,
+	},
+	{
+		params: [],
+		name: 'api-collections.index',
+		path: '/api/v1/collections',
+		method: ['GET', 'HEAD'],
+		types: {} as ApiV1CollectionsGetHead,
+	},
+	{
+		params: ['id'],
+		name: 'api-collections.update',
+		path: '/api/v1/collections/:id',
+		method: ['PUT'],
+		types: {} as ApiV1CollectionsIdPut,
+	},
+	{
+		params: [],
+		name: 'api-links.create',
+		path: '/api/v1/links',
+		method: ['POST'],
+		types: {} as ApiV1LinksPost,
+	},
+	{
+		params: ['id'],
+		name: 'api-links.delete',
+		path: '/api/v1/links/:id',
+		method: ['DELETE'],
+		types: {} as ApiV1LinksIdDelete,
+	},
+	{
+		params: [],
+		name: 'api-links.get-favorite-links',
+		path: '/api/v1/links/favorites',
+		method: ['GET', 'HEAD'],
+		types: {} as ApiV1LinksFavoritesGetHead,
+	},
+	{
+		params: ['id'],
+		name: 'api-links.update',
+		path: '/api/v1/links/:id',
+		method: ['PUT'],
+		types: {} as ApiV1LinksIdPut,
+	},
+	{
+		params: [],
+		name: 'api-tokens.index',
+		path: '/api/v1/tokens/check',
+		method: ['GET', 'HEAD'],
+		types: {} as ApiV1TokensCheckGetHead,
+	},
+	{
+		params: [],
+		name: 'auth',
+		path: '/auth/google',
+		method: ['GET', 'HEAD'],
+		types: {} as unknown,
+	},
+	{
+		params: [],
+		name: 'auth.callback',
+		path: '/auth/callback',
+		method: ['GET', 'HEAD'],
+		types: {} as AuthCallbackGetHead,
+	},
+	{
+		params: [],
+		name: 'auth.logout',
+		path: '/auth/logout',
+		method: ['GET', 'HEAD'],
+		types: {} as AuthLogoutGetHead,
+	},
+	{
+		params: [],
+		name: 'dashboard',
+		path: '/dashboard',
+		method: ['GET', 'HEAD'],
+		types: {} as DashboardGetHead,
+	},
+	{
+		params: [],
+		name: 'collection.create-form',
+		path: '/collections/create',
+		method: ['GET', 'HEAD'],
+		types: {} as CollectionsCreateGetHead,
+	},
+	{
+		params: [],
+		name: 'collection.create',
+		path: '/collections',
+		method: ['POST'],
+		types: {} as CollectionsPost,
+	},
+	{
+		params: [],
+		name: 'collection.edit-form',
+		path: '/collections/edit',
+		method: ['GET', 'HEAD'],
+		types: {} as CollectionsEditGetHead,
+	},
+	{
+		params: ['id'],
+		name: 'collection.edit',
+		path: '/collections/:id',
+		method: ['PUT'],
+		types: {} as CollectionsIdPut,
+	},
+	{
+		params: [],
+		name: 'collection.delete-form',
+		path: '/collections/delete',
+		method: ['GET', 'HEAD'],
+		types: {} as CollectionsDeleteGetHead,
+	},
+	{
+		params: ['id'],
+		name: 'collection.delete',
+		path: '/collections/:id',
+		method: ['DELETE'],
+		types: {} as CollectionsIdDelete,
+	},
+	{
+		params: [],
+		name: 'favicon',
+		path: '/favicon',
+		method: ['GET', 'HEAD'],
+		types: {} as FaviconGetHead,
+	},
+	{
+		params: [],
+		name: 'home',
+		path: '/',
+		method: ['GET', 'HEAD'],
+		types: {} as unknown,
+	},
+	{
+		params: [],
+		name: 'terms',
+		path: '/terms',
+		method: ['GET', 'HEAD'],
+		types: {} as unknown,
+	},
+	{
+		params: [],
+		name: 'privacy',
+		path: '/privacy',
+		method: ['GET', 'HEAD'],
+		types: {} as unknown,
+	},
+	{
+		params: [],
+		name: 'link.create-form',
+		path: '/links/create',
+		method: ['GET', 'HEAD'],
+		types: {} as LinksCreateGetHead,
+	},
+	{
+		params: [],
+		name: 'link.create',
+		path: '/links',
+		method: ['POST'],
+		types: {} as LinksPost,
+	},
+	{
+		params: [],
+		name: 'link.edit-form',
+		path: '/links/edit',
+		method: ['GET', 'HEAD'],
+		types: {} as LinksEditGetHead,
+	},
+	{
+		params: ['id'],
+		name: 'link.edit',
+		path: '/links/:id',
+		method: ['PUT'],
+		types: {} as LinksIdPut,
+	},
+	{
+		params: ['id'],
+		name: 'link.toggle-favorite',
+		path: '/links/:id/favorite',
+		method: ['PUT'],
+		types: {} as LinksIdFavoritePut,
+	},
+	{
+		params: [],
+		name: 'link.delete-form',
+		path: '/links/delete',
+		method: ['GET', 'HEAD'],
+		types: {} as LinksDeleteGetHead,
+	},
+	{
+		params: ['id'],
+		name: 'link.delete',
+		path: '/links/:id',
+		method: ['DELETE'],
+		types: {} as LinksIdDelete,
+	},
+	{
+		params: [],
+		name: 'search',
+		path: '/search',
+		method: ['GET', 'HEAD'],
+		types: {} as SearchGetHead,
+	},
+	{
+		params: ['id'],
+		name: 'shared',
+		path: '/shared/:id',
+		method: ['GET', 'HEAD'],
+		types: {} as SharedIdGetHead,
+	},
+	{
+		params: [],
+		name: 'user.api-tokens.store',
+		path: '/user/api-tokens',
+		method: ['POST'],
+		types: {} as UserApitokensPost,
+	},
+	{
+		params: ['tokenId'],
+		name: 'user.api-tokens.destroy',
+		path: '/user/api-tokens/:tokenId',
+		method: ['DELETE'],
+		types: {} as UserApitokensIdDelete,
+	},
+	{
+		params: [],
+		name: 'user.update-display-preferences',
+		path: '/user/display-preferences',
+		method: ['POST'],
+		types: {} as UserDisplaypreferencesPost,
+	},
+	{
+		params: [],
+		name: 'user.theme',
+		path: '/user/theme',
+		method: ['POST'],
+		types: {} as UserThemePost,
+	},
+	{
+		params: [],
+		name: 'user.settings',
+		path: '/user/settings',
+		method: ['GET', 'HEAD'],
+		types: {} as UserSettingsGetHead,
+	},
+] as const;
+export const api = {
+	routes,
+	definition: {} as ApiDefinition,
+};
+declare module '@tuyau/inertia/types' {
+	type InertiaApi = typeof api;
+	export interface Api extends InertiaApi {}
+}

.adonisjs/index.ts

@@ -0,0 +1,3 @@
+/// <reference path="../adonisrc.ts" />
+
+export * from './api.js';

.dockerignore

@@ -13,7 +13,7 @@ storage
 
 # Additional good to have ignores for dockerignore
 Dockerfile*
-docker-compose*
+compose*
 .dockerignore
 *.md
 .git

.editorconfig

@@ -10,12 +10,5 @@ charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = true
 
-[*.json]
-insert_final_newline = unset
-
 [**.min.js]
 indent_style = unset
-insert_final_newline = unset
-
-[*.md]
-trim_trailing_whitespace = false

.env.example

@@ -1,16 +1,22 @@
-# node ace generate:key
+# App
-APP_KEY=soY8ZAtItT_fCkNUADfgffZUUo675lOj
 TZ=UTC
 PORT=3333
 HOST=localhost
-LOG_LEVEL=info
+LOG_LEVEL=debug
+APP_KEY=soY8ZAtItT_fCkNUADfgffZUUo675lOj # node ace generate:key
 NODE_ENV=development
 SESSION_DRIVER=cookie
+
+# App url
+APP_URL=http://localhost:3333
+
+# Database
 DB_HOST=127.0.0.1
 DB_PORT=5432
-DB_USER=postgres
+DB_USER=root
-DB_PASSWORD=my-links-pwd
+DB_PASSWORD=root
-DB_DATABASE=my-links
+DB_DATABASE=app
+
+# Google
 GOOGLE_CLIENT_ID=
 GOOGLE_CLIENT_SECRET=
-GOOGLE_CLIENT_CALLBACK_URL=http://localhost:3333/auth/callback

.release-it.json

@@ -1,9 +1,6 @@
 {
   "hooks": {
-    "before:init": [
+    "before:init": ["pnpm lint", "pnpm run typecheck"]
-      "pnpm format",
-      "pnpm lint"
-    ]
   },
   "git": {
     "commitMessage": "chore: release v${version}",
@@ -17,4 +14,4 @@
   "npm": {
     "publish": false
   }
-}
+}

.vscode/extensions.json

@@ -1,3 +0,0 @@
-{
-	"recommendations": ["vunguyentuan.vscode-css-variables"]
-}

.vscode/settings.json

@@ -7,7 +7,7 @@
 	"explorer.fileNesting.enabled": true,
 	"explorer.fileNesting.patterns": {
 		"*.js": "${capture}.js.map, ${capture}.min.js, ${capture}.d.ts",
-		"package.json": "pnpm-lock.yaml, tsconfig.json, eslint.config.js, .babelrc, vite.config.ts, .editorconfig",
+		"package.json": "pnpm-lock.yaml, pnpm-workspace.yaml, tsconfig.json, eslint.config.js, .babelrc, vite.config.ts, .editorconfig",
 		"Makefile": "*compose.yml, Dockerfile, servers_pgadmin.json, .dockerignore"
 	},
 	"cssVariables.lookupFiles": [
@@ -17,4 +17,4 @@
 		"**/*.less",
 		"node_modules/@mantine/core/styles.css"
 	]
-}
+}

Dockerfile

@@ -1,6 +1,6 @@
 # Source : https://github.com/adonisjs-community/adonis-packages/blob/main/Dockerfile
 
-FROM node:22.11-alpine3.20 AS base
+FROM node:24.11-alpine3.22 AS base
 
 RUN apk --no-cache add curl
 RUN corepack enable
@@ -34,9 +34,9 @@ ENV DB_PORT=5432
 ENV DB_USER=db_user
 ENV DB_PASSWORD=db_password
 ENV DB_DATABASE=db_db
+ENV APP_URL=http://localhost:3333
 ENV GOOGLE_CLIENT_ID=client_id
 ENV GOOGLE_CLIENT_SECRET=client_secret
-ENV GOOGLE_CLIENT_CALLBACK_URL=http://localhost:3333/auth/callback
 
 RUN node ace izzy:routes
 RUN node ace build

Makefile

@@ -1,21 +1,32 @@
+tuyau:
+	@node ace tuyau:generate
+	@pnpm run format
+
 dev:
 	@docker compose down
 	@docker compose -f dev.compose.yml pull
-	@docker compose -f dev.compose.yml up -d --wait
+	@docker compose -f dev.compose.yml up -d --wait --remove-orphans
 	@node ace migration:fresh
 	@pnpm run dev
 
 prod:
 	@docker compose -f dev.compose.yml down
 	@docker compose pull
-	@docker compose up -d --build --wait
+	@docker compose up -d --build --wait --remove-orphans
 
 seed:
 	@node ace db:seed
 
+fresh:
+	@node ace migration:fresh
+
 down:
 	@-docker compose down
 	@-docker compose -f dev.compose.yml down
 
 release:
 	@pnpm run release
+
+docker-weight:
+	@DOCKER_IMAGE_WEIGHT=$$(docker save axekin-axekin:latest | wc -c | awk '{printf "%.3f", $$1/1024/1024}'); \
+	echo "Docker image weight: $${DOCKER_IMAGE_WEIGHT} Mo"

README.md

@@ -11,6 +11,7 @@
 </div>
 
 ## Table of Contents
+
 - [Main Features](#main-features)
 - [Getting Started](#getting-started)
   - [Setup](#setup)
@@ -24,7 +25,7 @@
 - [Contributing](#contributing)
 - [License](#license)
 
-## Main Features 
+## Main Features
 
 - **Organize bookmarks with collections**: Keep your links tidy and easily accessible by grouping them into customizable collections.
 - **Intuitive link management**: Add, edit, and manage your bookmarks effortlessly with a user-friendly interface.
@@ -91,6 +92,27 @@ pnpm run start
 openssl rand -base64 32
 ```
 
+### Google OAuth
+
+Pour obtenir le Client ID et Secret Google nécessaires à l'authentification :
+
+1. Accédez à la [Console Google Cloud](https://console.cloud.google.com/)
+2. Créez un nouveau projet ou sélectionnez un projet existant
+3. Activez l'API **Google+ API** (ou utilisez directement l'API OAuth 2.0)
+4. Allez dans **Identifiants** (Credentials) > **Créer des identifiants** > **ID client OAuth 2.0**
+5. Configurez l'écran de consentement OAuth si ce n'est pas déjà fait :
+   - Type d'application : **Interne** ou **Externe**
+   - Remplissez les informations requises (nom de l'application, email de support, etc.)
+6. Créez l'ID client OAuth 2.0 :
+   - Type d'application : **Application Web**
+   - Nom : choisissez un nom pour votre application
+   - URI de redirection autorisés : ajoutez `http://localhost:3333/auth/callback` pour le développement (ou votre URL de production + `/auth/callback`)
+7. Une fois créé, vous obtiendrez :
+   - **Client ID** : à définir dans `GOOGLE_CLIENT_ID`
+   - **Client Secret** : à définir dans `GOOGLE_CLIENT_SECRET`
+
+> **Note** : Pour la production, assurez-vous d'ajouter votre URL de production dans les URI de redirection autorisés (ex: `https://votre-domaine.com/auth/callback`)
+
 ### GitHub Actions
 
 Env var to define :
@@ -124,6 +146,7 @@ ssh-copy-id -i ./id_rsa.pub user@host
 > Source: https://github.com/appleboy/ssh-action#setting-up-a-ssh-key
 
 ## Contributing
+
 We welcome contributions! Please visit our Trello board for project management and roadmap details. You can contribute by:
 
 - Creating issues for bugs, features, or discussions.
@@ -133,4 +156,4 @@ For detailed contribution guidelines, refer to the CONTRIBUTING.md file.
 
 ## License
 
-This project is licensed under the [GPLv3 License](./LICENCE). 
+This project is licensed under the [GPLv3 License](./LICENCE).

adonisrc.ts

@@ -2,29 +2,30 @@ import { defineConfig } from '@adonisjs/core/app';
 
 export default defineConfig({
 	/*
-  |--------------------------------------------------------------------------
+|--------------------------------------------------------------------------
-  | Commands
+| Commands
-  |--------------------------------------------------------------------------
+|--------------------------------------------------------------------------
-  |
+|
-  | List of ace commands to register from packages. The application commands
+| List of ace commands to register from packages. The application commands
-  | will be scanned automatically from the "./commands" directory.
+| will be scanned automatically from the "./commands" directory.
-  |
+|
-  */
+*/
 	commands: [
 		() => import('@adonisjs/core/commands'),
 		() => import('@adonisjs/lucid/commands'),
 		() => import('@izzyjs/route/commands'),
+		() => import('@tuyau/core/commands'),
 	],
 
 	/*
-  |--------------------------------------------------------------------------
+|--------------------------------------------------------------------------
-  | Service providers
+| Service providers
-  |--------------------------------------------------------------------------
+|--------------------------------------------------------------------------
-  |
+|
-  | List of service providers to import and register when booting the
+| List of service providers to import and register when booting the
-  | application
+| application
-  |
+|
-  */
+*/
 	providers: [
 		() => import('@adonisjs/core/providers/app_provider'),
 		() => import('@adonisjs/core/providers/hash_provider'),
@@ -45,27 +46,32 @@ export default defineConfig({
 		() => import('@adonisjs/ally/ally_provider'),
 		() => import('@izzyjs/route/izzy_provider'),
 		() => import('#providers/route_provider'),
+		() => import('@tuyau/core/tuyau_provider'),
 	],
 
 	/*
-  |--------------------------------------------------------------------------
+|--------------------------------------------------------------------------
-  | Preloads
+| Preloads
-  |--------------------------------------------------------------------------
+|--------------------------------------------------------------------------
-  |
+|
-  | List of modules to import before starting the application.
+| List of modules to import before starting the application.
-  |
+|
-  */
+*/
-	preloads: [() => import('#start/routes'), () => import('#start/kernel')],
+	preloads: [
+		() => import('#start/routes'),
+		() => import('#start/kernel'),
+		() => import('#start/view'),
+	],
 
 	/*
-  |--------------------------------------------------------------------------
+|--------------------------------------------------------------------------
-  | Tests
+| Tests
-  |--------------------------------------------------------------------------
+|--------------------------------------------------------------------------
-  |
+|
-  | List of test suites to organize tests by their type. Feel free to remove
+| List of test suites to organize tests by their type. Feel free to remove
-  | and add additional suites.
+| and add additional suites.
-  |
+|
-  */
+*/
 	tests: {
 		suites: [
 			{
@@ -83,14 +89,14 @@ export default defineConfig({
 	},
 
 	/*
-  |--------------------------------------------------------------------------
+|--------------------------------------------------------------------------
-  | Metafiles
+| Metafiles
-  |--------------------------------------------------------------------------
+|--------------------------------------------------------------------------
-  |
+|
-  | A collection of files you want to copy to the build folder when creating
+| A collection of files you want to copy to the build folder when creating
-  | the production build.
+| the production build.
-  |
+|
-  */
+*/
 	metaFiles: [
 		{
 			pattern: 'resources/views/**/*.edge',
@@ -103,7 +109,7 @@ export default defineConfig({
 	],
 
 	assetsBundler: false,
-	unstable_assembler: {
+	hooks: {
 		onBuildStarting: [() => import('@adonisjs/vite/build_hook')],
 		onDevServerStarted: [() => import('@izzyjs/route/dev_hook')],
 	},

app/constants/paths.ts

@@ -1,6 +1,6 @@
 const PATHS = {
 	AUTHOR: 'https://www.sonny.dev/?utm_source=mylinks',
-	REPO_GITHUB: 'https://github.com/Sonny93/my-links',
+	REPO_GITHUB: 'https://github.com/my-links/my-links',
 	EXTENSION:
 		'https://chromewebstore.google.com/detail/mylinks/agkmlplihacolkakgeccnbhphnepphma',
 } as const;

app/constants/session.ts

@@ -1,2 +0,0 @@
-export const PREFER_DARK_THEME = 'prefer_dark_theme';
-export const DARK_THEME_DEFAULT_VALUE = true;

app/constants/user/theme.ts

@@ -0,0 +1,5 @@
+export const KEY_USER_THEME = 'user_theme';
+
+export const DEFAULT_USER_THEME = 'light';
+
+export const THEMES = ['light', 'dark'] as const;

app/controllers/admin/admin_controller.ts

@@ -0,0 +1,28 @@
+import AuthController from '#controllers/auth/auth_controller';
+import LinksController from '#controllers/links/delete_link_controller';
+import { UserWithCountersDto } from '#dtos/user_with_counters';
+import { CollectionService } from '#services/collections/collection_service';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class AdminController {
+	constructor(
+		protected usersController: AuthController,
+		protected linksController: LinksController,
+		protected collectionService: CollectionService
+	) {}
+
+	async render({ inertia }: HttpContext) {
+		const users = await this.usersController.getAllUsersWithTotalRelations();
+		const linksCount = await this.linksController.getTotalLinksCount();
+		const collectionsCount =
+			await this.collectionService.getTotalCollectionsCount();
+
+		return inertia.render('admin/dashboard', {
+			users: UserWithCountersDto.fromArray(users),
+			totalLinks: linksCount,
+			totalCollections: collectionsCount,
+		});
+	}
+}

app/controllers/admin_controller.ts

@@ -1,46 +0,0 @@
-import CollectionsController from '#controllers/collections_controller';
-import LinksController from '#controllers/links_controller';
-import UsersController from '#controllers/users_controller';
-import User from '#models/user';
-import { inject } from '@adonisjs/core';
-import type { HttpContext } from '@adonisjs/core/http';
-
-class UserWithRelationCountDto {
-	constructor(private user: User) {}
-
-	toJson = () => ({
-		id: this.user.id,
-		email: this.user.email,
-		fullname: this.user.name,
-		avatarUrl: this.user.avatarUrl,
-		isAdmin: this.user.isAdmin,
-		createdAt: this.user.createdAt.toString(),
-		updatedAt: this.user.updatedAt.toString(),
-		lastSeenAt:
-			this.user.lastSeenAt?.toString() ?? this.user.updatedAt.toString(),
-		linksCount: Number(this.user.$extras.totalLinks),
-		collectionsCount: Number(this.user.$extras.totalCollections),
-	});
-}
-
-@inject()
-export default class AdminController {
-	constructor(
-		protected usersController: UsersController,
-		protected linksController: LinksController,
-		protected collectionsController: CollectionsController
-	) {}
-
-	async index({ inertia }: HttpContext) {
-		const users = await this.usersController.getAllUsersWithTotalRelations();
-		const linksCount = await this.linksController.getTotalLinksCount();
-		const collectionsCount =
-			await this.collectionsController.getTotalCollectionsCount();
-
-		return inertia.render('admin/dashboard', {
-			users: users.map((user) => new UserWithRelationCountDto(user).toJson()),
-			totalLinks: linksCount,
-			totalCollections: collectionsCount,
-		});
-	}
-}

app/controllers/api/collections/create_collection_controller.ts

@@ -0,0 +1,23 @@
+import { CollectionWithLinksDto } from '#dtos/collection_with_links';
+import { CollectionService } from '#services/collections/collection_service';
+import { createCollectionValidator } from '#validators/collections/create_collection_validator';
+import { inject } from '@adonisjs/core';
+import { type HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class CreateCollectionController {
+	constructor(private collectionService: CollectionService) {}
+
+	async execute({ request, response }: HttpContext) {
+		const payload = await request.validateUsing(createCollectionValidator);
+		const collection = await this.collectionService.createCollection({
+			name: payload.name,
+			description: payload.description,
+			visibility: payload.visibility,
+		});
+		return response.json({
+			message: 'Collection created successfully',
+			collection: new CollectionWithLinksDto(collection).serialize(),
+		});
+	}
+}

app/controllers/api/collections/delete_collection_controller.ts

@@ -0,0 +1,17 @@
+import { CollectionService } from '#services/collections/collection_service';
+import { deleteCollectionValidator } from '#validators/collections/delete_collection_validator';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class DeleteCollectionController {
+	constructor(private collectionService: CollectionService) {}
+
+	async execute({ request, response }: HttpContext) {
+		const { params } = await request.validateUsing(deleteCollectionValidator);
+		await this.collectionService.deleteCollection(params.id);
+		return response.json({
+			message: 'Collection deleted successfully',
+		});
+	}
+}

app/controllers/api/collections/get_collections_controller.ts

@@ -0,0 +1,17 @@
+import { CollectionWithLinksDto } from '#dtos/collection_with_links';
+import { CollectionService } from '#services/collections/collection_service';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class GetCollectionsController {
+	constructor(private collectionService: CollectionService) {}
+
+	async render({ response }: HttpContext) {
+		const collections =
+			await this.collectionService.getCollectionsForAuthenticatedUser();
+		return response.json({
+			collections: CollectionWithLinksDto.fromArray(collections),
+		});
+	}
+}

app/controllers/api/collections/update_collection_controller.ts

@@ -0,0 +1,25 @@
+import { CollectionService } from '#services/collections/collection_service';
+import { updateCollectionValidator } from '#validators/collections/update_collection_validator';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class UpdateCollectionController {
+	constructor(private collectionService: CollectionService) {}
+
+	async execute({ request, response }: HttpContext) {
+		const {
+			params: { id: collectionId },
+			...payload
+		} = await request.validateUsing(updateCollectionValidator);
+
+		await this.collectionService.updateCollection(collectionId, {
+			name: payload.name,
+			description: payload.description,
+			visibility: payload.visibility,
+		});
+		return response.json({
+			message: 'Collection updated successfully',
+		});
+	}
+}

app/controllers/api/links/create_link_controller.ts

@@ -0,0 +1,24 @@
+import { LinkDto } from '#dtos/link';
+import { LinkService } from '#services/links/link_service';
+import { createLinkValidator } from '#validators/links/create_link_validator';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class CreateLinkController {
+	constructor(private linkService: LinkService) {}
+
+	async execute({ request, response }: HttpContext) {
+		const { collectionId, ...payload } =
+			await request.validateUsing(createLinkValidator);
+
+		const link = await this.linkService.createLink({
+			...payload,
+			collectionId,
+		});
+		return response.json({
+			message: 'Link created successfully',
+			link: new LinkDto(link).serialize(),
+		});
+	}
+}

app/controllers/api/links/delete_link_controller.ts

@@ -0,0 +1,42 @@
+import { LinkWithCollectionDto } from '#dtos/link_with_collection';
+import { CollectionService } from '#services/collections/collection_service';
+import { LinkService } from '#services/links/link_service';
+import { deleteLinkValidator } from '#validators/links/delete_link_validator';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+import db from '@adonisjs/lucid/services/db';
+
+@inject()
+export default class DeleteLinkController {
+	constructor(
+		protected collectionsService: CollectionService,
+		protected linkService: LinkService
+	) {}
+
+	async render({ auth, inertia, request }: HttpContext) {
+		const linkId = request.qs()?.linkId;
+		if (!linkId) {
+			return this.collectionsService.redirectToDashboard();
+		}
+
+		const link = await this.linkService.getLinkById(linkId, auth.user!.id);
+		await link.load('collection');
+		return inertia.render('links/delete', {
+			link: new LinkWithCollectionDto(link).serialize(),
+		});
+	}
+
+	async execute({ request, auth }: HttpContext) {
+		const { params } = await request.validateUsing(deleteLinkValidator);
+
+		const link = await this.linkService.getLinkById(params.id, auth.user!.id);
+		await this.linkService.deleteLink(params.id);
+
+		return this.collectionsService.redirectToCollectionId(link.collectionId);
+	}
+
+	async getTotalLinksCount() {
+		const totalCount = await db.from('links').count('* as total');
+		return Number(totalCount[0].total);
+	}
+}

app/controllers/api/links/get_favorite_links_controller.ts

@@ -0,0 +1,14 @@
+import { LinkDto } from '#dtos/link';
+import { LinkService } from '#services/links/link_service';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class GetFavoriteLinksController {
+	constructor(private linkService: LinkService) {}
+
+	public async execute({ response }: HttpContext) {
+		const links = await this.linkService.getFavoriteLinksForAuthenticatedUser();
+		return response.json(LinkDto.fromArray(links));
+	}
+}

app/controllers/api/links/update_link_controller.ts

@@ -0,0 +1,19 @@
+import { LinkService } from '#services/links/link_service';
+import { updateLinkValidator } from '#validators/links/update_link_validator';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class UpdateLinkController {
+	constructor(private linkService: LinkService) {}
+
+	async execute({ request, response }: HttpContext) {
+		const { params, ...payload } =
+			await request.validateUsing(updateLinkValidator);
+
+		await this.linkService.updateLink(params.id, payload);
+		return response.json({
+			message: 'Link updated successfully',
+		});
+	}
+}

app/controllers/api/tokens/api_token_controller.ts

@@ -0,0 +1,18 @@
+import UnAuthorizedException from '#exceptions/api/tokens/un_authorized_exception';
+import { getTokenFromHeader } from '#lib/api/tokens/index';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class ApiTokenController {
+	async render(ctx: HttpContext) {
+		const token = getTokenFromHeader(ctx);
+		if (!token) {
+			throw new UnAuthorizedException();
+		}
+
+		return ctx.response.json({
+			message: 'Token is valid',
+		});
+	}
+}

app/controllers/apps_controller.ts

@@ -1,13 +0,0 @@
-import { PREFER_DARK_THEME } from '#constants/session';
-import { updateUserThemeValidator } from '#validators/user';
-import type { HttpContext } from '@adonisjs/core/http';
-
-export default class AppsController {
-	async updateUserTheme({ request, session, response }: HttpContext) {
-		const { preferDarkTheme } = await request.validateUsing(
-			updateUserThemeValidator
-		);
-		session.put(PREFER_DARK_THEME, preferDarkTheme);
-		return response.ok({ message: 'ok' });
-	}
-}

app/controllers/auth/auth_controller.ts

@@ -4,7 +4,7 @@ import logger from '@adonisjs/core/services/logger';
 import db from '@adonisjs/lucid/services/db';
 import { RouteName } from '@izzyjs/route/types';
 
-export default class UsersController {
+export default class AuthController {
 	private redirectTo: RouteName = 'auth';
 
 	login({ inertia }: HttpContext) {

app/controllers/collections/create_collection_controller.ts

@@ -0,0 +1,27 @@
+import { CollectionService } from '#services/collections/collection_service';
+import { createCollectionValidator } from '#validators/collections/create_collection_validator';
+import { inject } from '@adonisjs/core';
+import { type HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class CreateCollectionController {
+	constructor(private collectionService: CollectionService) {}
+
+	async render({ inertia }: HttpContext) {
+		const collections =
+			await this.collectionService.getCollectionsForAuthenticatedUser();
+		return inertia.render('collections/create', {
+			disableHomeLink: collections.length === 0,
+		});
+	}
+
+	async execute({ request }: HttpContext) {
+		const payload = await request.validateUsing(createCollectionValidator);
+		const collection = await this.collectionService.createCollection({
+			name: payload.name,
+			description: payload.description,
+			visibility: payload.visibility,
+		});
+		return this.collectionService.redirectToCollectionId(collection.id);
+	}
+}

app/controllers/collections/delete_collection_controller.ts

@@ -0,0 +1,27 @@
+import { CollectionDto } from '#dtos/collection';
+import { CollectionService } from '#services/collections/collection_service';
+import { deleteCollectionValidator } from '#validators/collections/delete_collection_validator';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class DeleteCollectionController {
+	constructor(private collectionService: CollectionService) {}
+
+	async render({ inertia }: HttpContext) {
+		const collectionId = await this.collectionService.validateCollectionId();
+		if (!collectionId) return;
+
+		const collection =
+			await this.collectionService.getCollectionById(collectionId);
+		return inertia.render('collections/delete', {
+			collection: new CollectionDto(collection).serialize(),
+		});
+	}
+
+	async execute({ request, response }: HttpContext) {
+		const { params } = await request.validateUsing(deleteCollectionValidator);
+		await this.collectionService.deleteCollection(params.id);
+		return response.redirectToNamedRoute('dashboard');
+	}
+}

app/controllers/collections/show_collections_controller.ts

@@ -0,0 +1,40 @@
+import { CollectionDto } from '#dtos/collection';
+import { LinkDto } from '#dtos/link';
+import { CollectionService } from '#services/collections/collection_service';
+import { LinkService } from '#services/links/link_service';
+import { inject } from '@adonisjs/core';
+import type { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class ShowCollectionsController {
+	constructor(
+		private collectionService: CollectionService,
+		private linkService: LinkService
+	) {}
+
+	// Dashboard
+	async render({ inertia, response }: HttpContext) {
+		const activeCollectionId =
+			await this.collectionService.validateCollectionId(false);
+		const [collections, favoriteLinks] = await Promise.all([
+			this.collectionService.getCollectionsForAuthenticatedUser(),
+			this.linkService.getFavoriteLinksForAuthenticatedUser(),
+		]);
+
+		const activeCollection = collections.find(
+			(c) => c.id === activeCollectionId
+		);
+
+		if (!activeCollection && !!activeCollectionId) {
+			return response.redirectToNamedRoute('dashboard');
+		}
+
+		return inertia.render('dashboard', {
+			collections: CollectionDto.fromArray(collections),
+			favoriteLinks: LinkDto.fromArray(favoriteLinks),
+			activeCollection: activeCollection
+				? new CollectionDto(activeCollection).serialize()
+				: null,
+		});
+	}
+}

app/controllers/collections/update_collection_controller.ts

@@ -0,0 +1,35 @@
+import { CollectionDto } from '#dtos/collection';
+import { CollectionService } from '#services/collections/collection_service';
+import { updateCollectionValidator } from '#validators/collections/update_collection_validator';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class UpdateCollectionController {
+	constructor(private collectionService: CollectionService) {}
+
+	async render({ inertia }: HttpContext) {
+		const collectionId = await this.collectionService.validateCollectionId();
+		if (!collectionId) return;
+
+		const collection =
+			await this.collectionService.getCollectionById(collectionId);
+		return inertia.render('collections/edit', {
+			collection: new CollectionDto(collection).serialize(),
+		});
+	}
+
+	async execute({ request }: HttpContext) {
+		const {
+			params: { id: collectionId },
+			...payload
+		} = await request.validateUsing(updateCollectionValidator);
+
+		await this.collectionService.updateCollection(collectionId, {
+			name: payload.name,
+			description: payload.description,
+			visibility: payload.visibility,
+		});
+		return this.collectionService.redirectToCollectionId(collectionId);
+	}
+}

app/controllers/collections_controller.ts

@@ -1,143 +0,0 @@
-import Collection from '#models/collection';
-import User from '#models/user';
-import {
-	createCollectionValidator,
-	deleteCollectionValidator,
-	updateCollectionValidator,
-} from '#validators/collection';
-import type { HttpContext } from '@adonisjs/core/http';
-import db from '@adonisjs/lucid/services/db';
-
-export default class CollectionsController {
-	// Dashboard
-	async index({ auth, inertia, request, response }: HttpContext) {
-		const collections = await this.getCollectionsByAuthorId(auth.user!.id);
-		if (collections.length === 0) {
-			return response.redirectToNamedRoute('collection.create-form');
-		}
-
-		const activeCollectionId = Number(request.qs()?.collectionId ?? '');
-		const activeCollection = collections.find(
-			(c) => c.id === activeCollectionId
-		);
-
-		if (!activeCollection && !!activeCollectionId) {
-			return response.redirectToNamedRoute('dashboard');
-		}
-
-		// TODO: Create DTOs
-		return inertia.render('dashboard', {
-			collections: collections.map((collection) => collection.serialize()),
-			activeCollection:
-				activeCollection?.serialize() || collections[0].serialize(),
-		});
-	}
-
-	// Create collection form
-	async showCreatePage({ inertia, auth }: HttpContext) {
-		const collections = await this.getCollectionsByAuthorId(auth.user!.id);
-		return inertia.render('collections/create', {
-			disableHomeLink: collections.length === 0,
-		});
-	}
-
-	// Method called when creating a collection
-	async store({ request, response, auth }: HttpContext) {
-		const payload = await request.validateUsing(createCollectionValidator);
-		const collection = await Collection.create({
-			...payload,
-			authorId: auth.user?.id!,
-		});
-		return this.redirectToCollectionId(response, collection.id);
-	}
-
-	async showEditPage({ auth, request, inertia, response }: HttpContext) {
-		const collectionId = request.qs()?.collectionId;
-		if (!collectionId) {
-			return response.redirectToNamedRoute('dashboard');
-		}
-
-		const collection = await this.getCollectionById(
-			collectionId,
-			auth.user!.id
-		);
-		return inertia.render('collections/edit', {
-			collection,
-		});
-	}
-
-	async update({ request, auth, response }: HttpContext) {
-		const { params, ...payload } = await request.validateUsing(
-			updateCollectionValidator
-		);
-
-		// Cant use validator (vinejs) custom rule 'cause its too generic,
-		// because we have to find a collection by identifier and
-		// check whether the current user is the author.
-		// https://vinejs.dev/docs/extend/custom_rules
-		await this.getCollectionById(params.id, auth.user!.id);
-
-		await Collection.updateOrCreate(
-			{
-				id: params.id,
-			},
-			payload
-		);
-		return this.redirectToCollectionId(response, params.id);
-	}
-
-	async showDeletePage({ auth, request, inertia, response }: HttpContext) {
-		const collectionId = request.qs()?.collectionId;
-		if (!collectionId) {
-			return response.redirectToNamedRoute('dashboard');
-		}
-
-		const collection = await this.getCollectionById(
-			collectionId,
-			auth.user!.id
-		);
-		return inertia.render('collections/delete', {
-			collection,
-		});
-	}
-
-	async delete({ request, auth, response }: HttpContext) {
-		const { params } = await request.validateUsing(deleteCollectionValidator);
-		const collection = await this.getCollectionById(params.id, auth.user!.id);
-		await collection.delete();
-		return response.redirectToNamedRoute('dashboard');
-	}
-
-	async getTotalCollectionsCount() {
-		const totalCount = await db.from('collections').count('* as total');
-		return Number(totalCount[0].total);
-	}
-
-	/**
-	 * Get collection by id.
-	 *
-	 * /!\ Only return private collection (create by the current user)
-	 */
-	async getCollectionById(id: Collection['id'], userId: User['id']) {
-		return await Collection.query()
-			.where('id', id)
-			.andWhere('author_id', userId)
-			.firstOrFail();
-	}
-
-	async getCollectionsByAuthorId(authorId: User['id']) {
-		return await Collection.query()
-			.where('author_id', authorId)
-			.orderBy('created_at')
-			.preload('links');
-	}
-
-	redirectToCollectionId(
-		response: HttpContext['response'],
-		collectionId: Collection['id']
-	) {
-		return response.redirectToNamedRoute('dashboard', {
-			qs: { collectionId },
-		});
-	}
-}

app/controllers/favicons/favicons_controller.ts

@@ -0,0 +1,34 @@
+import { CacheService } from '#services/favicons/cache_service';
+import { FaviconService } from '#services/favicons/favicons_service';
+import { Favicon } from '#types/favicons/favicon_type';
+import { inject } from '@adonisjs/core';
+import type { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class FaviconsController {
+	private faviconService: FaviconService;
+	private cacheService: CacheService;
+
+	constructor(faviconService: FaviconService, cacheService: CacheService) {
+		this.faviconService = faviconService;
+		this.cacheService = cacheService;
+	}
+
+	async render(ctx: HttpContext) {
+		const url = ctx.request.qs()?.url;
+		if (!url) {
+			throw new Error('Missing URL');
+		}
+
+		const favicon = await this.cacheService.getOrSetFavicon(url, () =>
+			this.faviconService.getFavicon(url)
+		);
+		return this.sendImage(ctx, favicon);
+	}
+
+	private sendImage(ctx: HttpContext, { buffer, type, size }: Favicon) {
+		ctx.response.header('Content-Type', type);
+		ctx.response.header('Content-Length', size.toString());
+		ctx.response.send(buffer, true);
+	}
+}

app/controllers/links/create_link_controller.ts

@@ -0,0 +1,33 @@
+import { CollectionDto } from '#dtos/collection';
+import { CollectionService } from '#services/collections/collection_service';
+import { LinkService } from '#services/links/link_service';
+import { createLinkValidator } from '#validators/links/create_link_validator';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class CreateLinkController {
+	constructor(
+		private linkService: LinkService,
+		private collectionsService: CollectionService
+	) {}
+
+	async render({ inertia }: HttpContext) {
+		const collections =
+			await this.collectionsService.getCollectionsForAuthenticatedUser();
+		return inertia.render('links/create', {
+			collections: CollectionDto.fromArray(collections),
+		});
+	}
+
+	async execute({ request }: HttpContext) {
+		const { collectionId, ...payload } =
+			await request.validateUsing(createLinkValidator);
+
+		await this.linkService.createLink({
+			...payload,
+			collectionId,
+		});
+		return this.collectionsService.redirectToCollectionId(collectionId);
+	}
+}

app/controllers/links/delete_link_controller.ts

@@ -0,0 +1,42 @@
+import { LinkWithCollectionDto } from '#dtos/link_with_collection';
+import { CollectionService } from '#services/collections/collection_service';
+import { LinkService } from '#services/links/link_service';
+import { deleteLinkValidator } from '#validators/links/delete_link_validator';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+import db from '@adonisjs/lucid/services/db';
+
+@inject()
+export default class DeleteLinkController {
+	constructor(
+		protected collectionsService: CollectionService,
+		protected linkService: LinkService
+	) {}
+
+	async render({ auth, inertia, request }: HttpContext) {
+		const linkId = request.qs()?.linkId;
+		if (!linkId) {
+			return this.collectionsService.redirectToDashboard();
+		}
+
+		const link = await this.linkService.getLinkById(linkId, auth.user!.id);
+		await link.load('collection');
+		return inertia.render('links/delete', {
+			link: new LinkWithCollectionDto(link).serialize(),
+		});
+	}
+
+	async execute({ request, auth }: HttpContext) {
+		const { params } = await request.validateUsing(deleteLinkValidator);
+
+		const link = await this.linkService.getLinkById(params.id, auth.user!.id);
+		await this.linkService.deleteLink(params.id);
+
+		return this.collectionsService.redirectToCollectionId(link.collectionId);
+	}
+
+	async getTotalLinksCount() {
+		const totalCount = await db.from('links').count('* as total');
+		return Number(totalCount[0].total);
+	}
+}

app/controllers/links/toggle_favorite_controller.ts

@@ -0,0 +1,19 @@
+import { LinkService } from '#services/links/link_service';
+import { updateLinkFavoriteStatusValidator } from '#validators/links/update_favorite_link_validator';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class ToggleFavoriteController {
+	constructor(private linkService: LinkService) {}
+
+	async toggleFavorite({ request, response }: HttpContext) {
+		const { params, favorite } = await request.validateUsing(
+			updateLinkFavoriteStatusValidator
+		);
+
+		await this.linkService.updateFavorite(params.id, favorite);
+
+		return response.json({ status: 'ok' });
+	}
+}

app/controllers/links/update_link_controller.ts

@@ -0,0 +1,39 @@
+import { CollectionDto } from '#dtos/collection';
+import { LinkDto } from '#dtos/link';
+import { CollectionService } from '#services/collections/collection_service';
+import { LinkService } from '#services/links/link_service';
+import { updateLinkValidator } from '#validators/links/update_link_validator';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class UpdateLinkController {
+	constructor(
+		private linkService: LinkService,
+		private collectionsService: CollectionService
+	) {}
+
+	async render({ auth, inertia, request, response }: HttpContext) {
+		const linkId = request.qs()?.linkId;
+		if (!linkId) {
+			return response.redirectToNamedRoute('dashboard');
+		}
+
+		const collections =
+			await this.collectionsService.getCollectionsForAuthenticatedUser();
+		const link = await this.linkService.getLinkById(linkId, auth.user!.id);
+
+		return inertia.render('links/edit', {
+			collections: CollectionDto.fromArray(collections),
+			link: new LinkDto(link).serialize(),
+		});
+	}
+
+	async execute({ request }: HttpContext) {
+		const { params, ...payload } =
+			await request.validateUsing(updateLinkValidator);
+
+		await this.linkService.updateLink(params.id, payload);
+		return this.collectionsService.redirectToCollectionId(payload.collectionId);
+	}
+}

app/controllers/links_controller.ts

@@ -1,131 +0,0 @@
-import CollectionsController from '#controllers/collections_controller';
-import Link from '#models/link';
-import {
-	createLinkValidator,
-	deleteLinkValidator,
-	updateLinkFavoriteStatusValidator,
-	updateLinkValidator,
-} from '#validators/link';
-import { inject } from '@adonisjs/core';
-import type { HttpContext } from '@adonisjs/core/http';
-import db from '@adonisjs/lucid/services/db';
-
-@inject()
-export default class LinksController {
-	constructor(protected collectionsController: CollectionsController) {}
-
-	async showCreatePage({ auth, inertia }: HttpContext) {
-		const collections =
-			await this.collectionsController.getCollectionsByAuthorId(auth.user!.id);
-		return inertia.render('links/create', { collections });
-	}
-
-	async store({ auth, request, response }: HttpContext) {
-		const { collectionId, ...payload } =
-			await request.validateUsing(createLinkValidator);
-
-		await this.collectionsController.getCollectionById(
-			collectionId,
-			auth.user!.id
-		);
-		await Link.create({
-			...payload,
-			collectionId,
-			authorId: auth.user?.id!,
-		});
-		return this.collectionsController.redirectToCollectionId(
-			response,
-			collectionId
-		);
-	}
-
-	async showEditPage({ auth, inertia, request, response }: HttpContext) {
-		const linkId = request.qs()?.linkId;
-		if (!linkId) {
-			return response.redirectToNamedRoute('dashboard');
-		}
-
-		const userId = auth.user!.id;
-		const collections =
-			await this.collectionsController.getCollectionsByAuthorId(userId);
-		const link = await this.getLinkById(linkId, userId);
-
-		return inertia.render('links/edit', { collections, link });
-	}
-
-	async update({ request, auth, response }: HttpContext) {
-		const { params, ...payload } =
-			await request.validateUsing(updateLinkValidator);
-
-		// Throw if invalid link id provided
-		await this.getLinkById(params.id, auth.user!.id);
-
-		await Link.updateOrCreate(
-			{
-				id: params.id,
-			},
-			payload
-		);
-
-		return response.redirectToNamedRoute('dashboard', {
-			qs: { collectionId: payload.collectionId },
-		});
-	}
-
-	async toggleFavorite({ request, auth, response }: HttpContext) {
-		const { params, favorite } = await request.validateUsing(
-			updateLinkFavoriteStatusValidator
-		);
-
-		// Throw if invalid link id provided
-		await this.getLinkById(params.id, auth.user!.id);
-
-		await Link.updateOrCreate(
-			{
-				id: params.id,
-			},
-			{ favorite }
-		);
-
-		return response.json({ status: 'ok' });
-	}
-
-	async showDeletePage({ auth, inertia, request, response }: HttpContext) {
-		const linkId = request.qs()?.linkId;
-		if (!linkId) {
-			return response.redirectToNamedRoute('dashboard');
-		}
-
-		const link = await this.getLinkById(linkId, auth.user!.id);
-		await link.load('collection');
-		return inertia.render('links/delete', { link });
-	}
-
-	async delete({ request, auth, response }: HttpContext) {
-		const { params } = await request.validateUsing(deleteLinkValidator);
-
-		const link = await this.getLinkById(params.id, auth.user!.id);
-		await link.delete();
-
-		return response.redirectToNamedRoute('dashboard', {
-			qs: { collectionId: link.id },
-		});
-	}
-
-	async getTotalLinksCount() {
-		const totalCount = await db.from('links').count('* as total');
-		return Number(totalCount[0].total);
-	}
-
-	/**
-	 * Get link by id.
-	 *
-	 * /!\ Only return private link (create by the current user)
-	 */
-	private async getLinkById(id: Link['id'], userId: Link['id']) {
-		return await Link.query()
-			.where('id', id)
-			.andWhere('author_id', userId)
-			.firstOrFail();
-	}
-}

app/controllers/search/search_controller.ts

@@ -1,8 +1,8 @@
 import type { HttpContext } from '@adonisjs/core/http';
 import db from '@adonisjs/lucid/services/db';
 
-export default class SearchesController {
+export default class SearchController {
-	async search({ request, auth }: HttpContext) {
+	async render({ request, auth }: HttpContext) {
 		const term = request.qs()?.term;
 		if (!term) {
 			console.warn('qs term null');

app/controllers/shared_collections/shared_collections_controller.ts

@@ -0,0 +1,22 @@
+import { SharedCollectionDto } from '#dtos/shared_collection';
+import { CollectionService } from '#services/collections/collection_service';
+import { getSharedCollectionValidator } from '#validators/shared_collections/shared_collection';
+import { inject } from '@adonisjs/core';
+import type { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class SharedCollectionsController {
+	constructor(private collectionService: CollectionService) {}
+
+	async render({ request, inertia }: HttpContext) {
+		const { params } = await request.validateUsing(
+			getSharedCollectionValidator
+		);
+
+		const activeCollection =
+			await this.collectionService.getPublicCollectionById(params.id);
+		return inertia.render('shared', {
+			activeCollection: new SharedCollectionDto(activeCollection).serialize(),
+		});
+	}
+}

app/controllers/shared_collections_controller.ts

@@ -1,61 +0,0 @@
-import { Visibility } from '#enums/visibility';
-import Collection from '#models/collection';
-import Link from '#models/link';
-import User from '#models/user';
-import { getSharedCollectionValidator } from '#validators/shared_collection';
-import type { HttpContext } from '@adonisjs/core/http';
-
-class LinkWithoutFavoriteDto {
-	constructor(private link: Link) {}
-
-	toJson = () => ({
-		id: this.link.id,
-		name: this.link.name,
-		description: this.link.description,
-		url: this.link.url,
-		collectionId: this.link.collectionId,
-		createdAt: this.link.createdAt.toString(),
-		updatedAt: this.link.updatedAt.toString(),
-	});
-}
-
-class UserWithoutEmailDto {
-	constructor(private user: User) {}
-
-	toJson = () => ({
-		id: this.user.id,
-		fullname: this.user.name,
-		avatarUrl: this.user.avatarUrl,
-		isAdmin: this.user.isAdmin,
-		createdAt: this.user.createdAt.toString(),
-		updatedAt: this.user.updatedAt.toString(),
-	});
-}
-
-export default class SharedCollectionsController {
-	async index({ request, inertia }: HttpContext) {
-		const { params } = await request.validateUsing(
-			getSharedCollectionValidator
-		);
-
-		const collection = await this.getSharedCollectionById(params.id);
-		return inertia.render('shared', { collection });
-	}
-
-	private async getSharedCollectionById(id: Collection['id']) {
-		const collection = await Collection.query()
-			.where('id', id)
-			.andWhere('visibility', Visibility.PUBLIC)
-			.preload('links')
-			.preload('author')
-			.firstOrFail();
-
-		return {
-			...collection.serialize(),
-			links: collection.links.map((link) =>
-				new LinkWithoutFavoriteDto(link).toJson()
-			),
-			author: new UserWithoutEmailDto(collection.author).toJson(),
-		};
-	}
-}

app/controllers/user/api_token_controller.ts

@@ -0,0 +1,45 @@
+import { ApiTokenService } from '#services/user/api_token_service';
+import { createApiTokenValidator } from '#validators/user/token/create_api_token';
+import { deleteApiTokenValidator } from '#validators/user/token/delete_api_token';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class ApiTokenController {
+	constructor(private apiTokenService: ApiTokenService) {}
+
+	async store({ request, response, auth, session }: HttpContext) {
+		const { name, expiresAt } = await request.validateUsing(
+			createApiTokenValidator
+		);
+		const token = await this.apiTokenService.createToken(auth.user!, {
+			name,
+			expiresAt,
+		});
+		session.flash('token', {
+			...token.toJSON(),
+			token: token.value?.release(),
+			identifier: token.identifier,
+		});
+		return response.redirect().withQs().back();
+	}
+
+	async destroy({ request, response, auth }: HttpContext) {
+		const { params } = await request.validateUsing(deleteApiTokenValidator);
+		const tokenId = params.tokenId;
+
+		const token = await this.apiTokenService.getTokenByValue(
+			auth.user!,
+			tokenId
+		);
+		if (!token) {
+			return response.notFound();
+		}
+
+		await this.apiTokenService.revokeToken(
+			auth.user!,
+			Number(token.identifier)
+		);
+		return response.redirect().withQs().back();
+	}
+}

app/controllers/user/display_preferences_controller.ts

@@ -0,0 +1,25 @@
+import { getDisplayPreferences } from '#shared/lib/display_preferences';
+import { updateDisplayPreferencesValidator } from '#validators/user/update_display_preferences';
+import { HttpContext } from '@adonisjs/core/http';
+
+export default class DisplayPreferencesController {
+	async update({ request, response, auth }: HttpContext) {
+		const { displayPreferences } = await request.validateUsing(
+			updateDisplayPreferencesValidator
+		);
+		const userPrefs = auth.user!.displayPreferences ?? {};
+		const mergedPrefs = {
+			linkListDisplay:
+				displayPreferences.linkListDisplay ??
+				userPrefs.linkListDisplay ??
+				getDisplayPreferences().linkListDisplay,
+			collectionListDisplay:
+				displayPreferences.collectionListDisplay ??
+				userPrefs.collectionListDisplay ??
+				getDisplayPreferences().collectionListDisplay,
+		};
+		auth.user!.displayPreferences = mergedPrefs;
+		await auth.user!.save();
+		return response.redirect().withQs().back();
+	}
+}

app/controllers/user/theme_controller.ts

@@ -0,0 +1,11 @@
+import { KEY_USER_THEME } from '#constants/user/theme';
+import { updateThemeValidator } from '#validators/user/update_theme_validator';
+import type { HttpContext } from '@adonisjs/core/http';
+
+export default class ThemeController {
+	async render({ request, session, response }: HttpContext) {
+		const { theme } = await request.validateUsing(updateThemeValidator);
+		session.put(KEY_USER_THEME, theme);
+		return response.ok({ message: 'ok' });
+	}
+}

app/controllers/user_settings/show_user_settings_controller.ts

@@ -0,0 +1,22 @@
+import { ApiTokenService } from '#services/user/api_token_service';
+import { inject } from '@adonisjs/core';
+import { HttpContext } from '@adonisjs/core/http';
+
+@inject()
+export default class ShowUserSettingsController {
+	constructor(private apiTokenService: ApiTokenService) {}
+
+	public async render({ auth, inertia }: HttpContext) {
+		const user = await auth.authenticate();
+		const tokens = await this.apiTokenService.getTokens(user);
+		return inertia.render('user_settings/show', {
+			user,
+			tokens: tokens.map((token) => {
+				return {
+					...token.toJSON(),
+					identifier: token.identifier,
+				};
+			}),
+		});
+	}
+}

app/dtos/collection.ts

@@ -0,0 +1,47 @@
+import { CommonModelDto } from '#dtos/common_model';
+import { Visibility } from '#enums/collections/visibility';
+import Collection from '#models/collection';
+
+export class CollectionDto extends CommonModelDto<Collection> {
+	declare id: number;
+	declare name: string;
+	declare description: string | null;
+	declare visibility: Visibility;
+	declare authorId: number;
+	declare createdAt: string | null;
+	declare updatedAt: string | null;
+
+	constructor(collection?: Collection) {
+		if (!collection) return;
+		super(collection);
+
+		this.id = collection.id;
+		this.name = collection.name;
+		this.description = collection.description;
+		this.visibility = collection.visibility;
+		this.authorId = collection.authorId;
+		this.createdAt = collection.createdAt?.toISO();
+		this.updatedAt = collection.updatedAt?.toISO();
+	}
+
+	serialize(): {
+		id: number;
+		name: string;
+		description: string | null;
+		visibility: Visibility;
+		authorId: number;
+		createdAt: string | null;
+		updatedAt: string | null;
+	} {
+		return {
+			...super.serialize(),
+			id: this.id,
+			name: this.name,
+			description: this.description,
+			visibility: this.visibility,
+			authorId: this.authorId,
+			createdAt: this.createdAt,
+			updatedAt: this.updatedAt,
+		};
+	}
+}

app/dtos/collection_with_links.ts

@@ -0,0 +1,53 @@
+import { CommonModelDto } from '#dtos/common_model';
+import { LinkDto } from '#dtos/link';
+import { Visibility } from '#enums/collections/visibility';
+import Collection from '#models/collection';
+import { Link } from '#shared/types/dto';
+
+export class CollectionWithLinksDto extends CommonModelDto<Collection> {
+	declare id: number;
+	declare name: string;
+	declare description: string | null;
+	declare visibility: Visibility;
+	declare authorId: number;
+	declare links: LinkDto[];
+	declare createdAt: string | null;
+	declare updatedAt: string | null;
+
+	constructor(collection?: Collection) {
+		if (!collection) return;
+		super(collection);
+
+		this.id = collection.id;
+		this.name = collection.name;
+		this.description = collection.description;
+		this.visibility = collection.visibility;
+		this.authorId = collection.authorId;
+		this.links = LinkDto.fromArray(collection.links);
+		this.createdAt = collection.createdAt?.toISO();
+		this.updatedAt = collection.updatedAt?.toISO();
+	}
+
+	serialize(): {
+		id: number;
+		name: string;
+		description: string | null;
+		visibility: Visibility;
+		authorId: number;
+		links: Link[];
+		createdAt: string | null;
+		updatedAt: string | null;
+	} {
+		return {
+			...super.serialize(),
+			id: this.id,
+			name: this.name,
+			description: this.description,
+			visibility: this.visibility,
+			authorId: this.authorId,
+			links: this.links.map((link) => link.serialize()),
+			createdAt: this.createdAt,
+			updatedAt: this.updatedAt,
+		};
+	}
+}

app/dtos/common_model.ts

@@ -0,0 +1,57 @@
+import SimplePaginatorDto from '#dtos/simple_paginator';
+import AppBaseModel from '#models/app_base_model';
+import { SimplePaginatorDtoMetaRange, StaticDto } from '#types/dto';
+import { LucidRow, ModelPaginatorContract } from '@adonisjs/lucid/types/model';
+import { SimplePaginatorContract } from '@adonisjs/lucid/types/querybuilder';
+
+export abstract class CommonModelDto<T extends AppBaseModel> {
+	declare id: number;
+	declare createdAt: string | null;
+	declare updatedAt: string | null;
+
+	constructor(model?: T) {
+		if (!model) return;
+		this.id = model.id;
+		this.createdAt = model.createdAt?.toISO();
+		this.updatedAt = model.updatedAt?.toISO();
+	}
+
+	static fromArray<
+		T extends AppBaseModel,
+		TDto extends CommonModelDto<T>,
+		TModel = any,
+	>(
+		this: new (model: TModel, ...args: any[]) => TDto,
+		models: TModel[],
+		...args: any[]
+	): TDto[] {
+		if (!Array.isArray(models)) return [];
+		return models.map((model) => new this(model, ...args));
+	}
+
+	static fromPaginator<
+		T extends AppBaseModel,
+		TDto extends CommonModelDto<T>,
+		TModel = any,
+	>(
+		this: StaticDto<TModel, TDto>,
+		paginator: TModel extends LucidRow
+			? ModelPaginatorContract<TModel>
+			: SimplePaginatorContract<TModel>,
+		range?: SimplePaginatorDtoMetaRange
+	) {
+		return new SimplePaginatorDto(paginator, this, range);
+	}
+
+	serialize(): {
+		id: number;
+		createdAt: string | null;
+		updatedAt: string | null;
+	} {
+		return {
+			id: this.id,
+			createdAt: this.createdAt,
+			updatedAt: this.updatedAt,
+		};
+	}
+}

app/dtos/link.ts

@@ -0,0 +1,54 @@
+import { CommonModelDto } from '#dtos/common_model';
+import Link from '#models/link';
+
+export class LinkDto extends CommonModelDto<Link> {
+	declare id: number;
+	declare name: string;
+	declare description: string | null;
+	declare url: string;
+	declare favorite: boolean;
+	declare collectionId: number;
+	declare authorId: number;
+	declare createdAt: string | null;
+	declare updatedAt: string | null;
+
+	constructor(link?: Link) {
+		if (!link) return;
+		super(link);
+
+		this.id = link.id;
+		this.name = link.name;
+		this.description = link.description;
+		this.url = link.url;
+		this.favorite = link.favorite;
+		this.collectionId = link.collectionId;
+		this.authorId = link.authorId;
+		this.createdAt = link.createdAt?.toISO();
+		this.updatedAt = link.updatedAt?.toISO();
+	}
+
+	serialize(): {
+		id: number;
+		name: string;
+		description: string | null;
+		url: string;
+		favorite: boolean;
+		collectionId: number;
+		authorId: number;
+		createdAt: string | null;
+		updatedAt: string | null;
+	} {
+		return {
+			...super.serialize(),
+			id: this.id,
+			name: this.name,
+			description: this.description,
+			url: this.url,
+			favorite: this.favorite,
+			collectionId: this.collectionId,
+			authorId: this.authorId,
+			createdAt: this.createdAt,
+			updatedAt: this.updatedAt,
+		};
+	}
+}

app/dtos/link_with_collection.ts

@@ -0,0 +1,60 @@
+import { CollectionDto } from '#dtos/collection';
+import { CommonModelDto } from '#dtos/common_model';
+import Link from '#models/link';
+import { Collection } from '#shared/types/dto';
+
+export class LinkWithCollectionDto extends CommonModelDto<Link> {
+	declare id: number;
+	declare name: string;
+	declare description: string | null;
+	declare url: string;
+	declare favorite: boolean;
+	declare collectionId: number;
+	declare collection: CollectionDto;
+	declare authorId: number;
+	declare createdAt: string | null;
+	declare updatedAt: string | null;
+
+	constructor(link?: Link) {
+		if (!link) return;
+		super(link);
+
+		this.id = link.id;
+		this.name = link.name;
+		this.description = link.description;
+		this.url = link.url;
+		this.favorite = link.favorite;
+		this.collectionId = link.collectionId;
+		this.collection = new CollectionDto(link.collection);
+		this.authorId = link.authorId;
+		this.createdAt = link.createdAt?.toISO();
+		this.updatedAt = link.updatedAt?.toISO();
+	}
+
+	serialize(): {
+		id: number;
+		name: string;
+		description: string | null;
+		url: string;
+		favorite: boolean;
+		collectionId: number;
+		collection: Collection;
+		authorId: number;
+		createdAt: string | null;
+		updatedAt: string | null;
+	} {
+		return {
+			...super.serialize(),
+			id: this.id,
+			name: this.name,
+			description: this.description,
+			url: this.url,
+			favorite: this.favorite,
+			collectionId: this.collectionId,
+			collection: this.collection.serialize(),
+			authorId: this.authorId,
+			createdAt: this.createdAt,
+			updatedAt: this.updatedAt,
+		};
+	}
+}

app/dtos/shared_collection.ts

@@ -0,0 +1,58 @@
+import { CommonModelDto } from '#dtos/common_model';
+import { LinkDto } from '#dtos/link';
+import { UserDto } from '#dtos/user';
+import { Visibility } from '#enums/collections/visibility';
+import Collection from '#models/collection';
+import { Link, User } from '#shared/types/dto';
+
+export class SharedCollectionDto extends CommonModelDto<Collection> {
+	declare id: number;
+	declare name: string;
+	declare description: string | null;
+	declare visibility: Visibility;
+	declare links: LinkDto[];
+	declare authorId: number;
+	declare author: UserDto;
+	declare createdAt: string | null;
+	declare updatedAt: string | null;
+
+	constructor(collection?: Collection) {
+		if (!collection) return;
+		super(collection);
+
+		this.id = collection.id;
+		this.name = collection.name;
+		this.description = collection.description;
+		this.visibility = collection.visibility;
+		this.links = LinkDto.fromArray(collection.links);
+		this.authorId = collection.authorId;
+		this.author = new UserDto(collection.author);
+		this.createdAt = collection.createdAt?.toISO();
+		this.updatedAt = collection.updatedAt?.toISO();
+	}
+
+	serialize(): {
+		id: number;
+		name: string;
+		description: string | null;
+		visibility: Visibility;
+		links: Link[];
+		authorId: number;
+		author: User;
+		createdAt: string | null;
+		updatedAt: string | null;
+	} {
+		return {
+			...super.serialize(),
+			id: this.id,
+			name: this.name,
+			description: this.description,
+			visibility: this.visibility,
+			links: this.links.map((link) => link.serialize()),
+			authorId: this.authorId,
+			author: this.author.serialize(),
+			createdAt: this.createdAt,
+			updatedAt: this.updatedAt,
+		};
+	}
+}

app/dtos/simple_paginator.ts

@@ -0,0 +1,65 @@
+// Source : https://github.com/adocasts/package-dto/blob/main/src/paginator/simple_paginator_dto.ts
+
+import { CommonModelDto } from '#dtos/common_model';
+import AppBaseModel from '#models/app_base_model';
+import {
+	SimplePaginatorDtoContract,
+	SimplePaginatorDtoMetaContract,
+	SimplePaginatorDtoMetaRange,
+	StaticDto,
+} from '#types/dto';
+import { LucidRow, ModelPaginatorContract } from '@adonisjs/lucid/types/model';
+import { SimplePaginatorContract } from '@adonisjs/lucid/types/querybuilder';
+
+export default class SimplePaginatorDto<
+	T extends AppBaseModel,
+	TDto extends CommonModelDto<T>,
+	TModel = any,
+> implements SimplePaginatorDtoContract<TDto>
+{
+	declare data: TDto[];
+	declare meta: SimplePaginatorDtoMetaContract;
+
+	/**
+	 * Constructs a new instance of the SimplePaginatorDto class.
+	 *
+	 * @param {SimplePaginatorContract<Model>|ModelPaginatorContract<Model>} paginator - The paginator object containing the data.
+	 * @param {StaticDto<Model, Dto>} dto - The static DTO class used to map the data.
+	 * @param {SimplePaginatorDtoMetaRange} [range] - Optional range for the paginator.
+	 */
+	constructor(
+		paginator: TModel extends LucidRow
+			? ModelPaginatorContract<TModel>
+			: SimplePaginatorContract<TModel>,
+		dto: StaticDto<TModel, TDto>,
+		range?: SimplePaginatorDtoMetaRange
+	) {
+		this.data = paginator.all().map((row) => new dto(row));
+
+		this.meta = {
+			total: paginator.total,
+			perPage: paginator.perPage,
+			currentPage: paginator.currentPage,
+			lastPage: paginator.lastPage,
+			firstPage: paginator.firstPage,
+			firstPageUrl: paginator.getUrl(1),
+			lastPageUrl: paginator.getUrl(paginator.lastPage),
+			nextPageUrl: paginator.getNextPageUrl(),
+			previousPageUrl: paginator.getPreviousPageUrl(),
+		};
+
+		if (range?.start || range?.end) {
+			const start = range?.start || paginator.firstPage;
+			const end = range?.end || paginator.lastPage;
+
+			this.meta.pagesInRange = paginator.getUrlsForRange(start, end);
+		}
+	}
+
+	serialize() {
+		return {
+			data: this.data.map((item) => item.serialize()),
+			meta: this.meta,
+		};
+	}
+}

app/dtos/user.ts

@@ -0,0 +1,42 @@
+import { CommonModelDto } from '#dtos/common_model';
+import User from '#models/user';
+
+export class UserDto extends CommonModelDto<User> {
+	declare id: number;
+	declare fullname: string;
+	declare avatarUrl: string;
+	declare isAdmin: boolean;
+	declare createdAt: string | null;
+	declare updatedAt: string | null;
+
+	constructor(user?: User) {
+		if (!user) return;
+		super(user);
+
+		this.id = user.id;
+		this.fullname = user.fullname;
+		this.avatarUrl = user.avatarUrl;
+		this.isAdmin = user.isAdmin;
+		this.createdAt = user.createdAt.toISO();
+		this.updatedAt = user.updatedAt.toISO();
+	}
+
+	serialize(): {
+		id: number;
+		fullname: string;
+		avatarUrl: string;
+		isAdmin: boolean;
+		createdAt: string | null;
+		updatedAt: string | null;
+	} {
+		return {
+			...super.serialize(),
+			id: this.id,
+			fullname: this.fullname,
+			avatarUrl: this.avatarUrl,
+			isAdmin: this.isAdmin,
+			createdAt: this.createdAt,
+			updatedAt: this.updatedAt,
+		};
+	}
+}

app/dtos/user_auth.ts

@@ -0,0 +1,27 @@
+import { UserDto } from '#dtos/user';
+import User from '#models/user';
+
+export class UserAuthDto {
+	declare isAuthenticated: boolean;
+	declare isAdmin: boolean;
+	declare user?: UserDto;
+
+	constructor(user: User | undefined) {
+		if (!user) return;
+		this.isAuthenticated = !!user;
+		this.isAdmin = user?.isAdmin;
+		this.user = user && new UserDto(user);
+	}
+
+	serialize(): {
+		isAuthenticated: boolean;
+		isAdmin: boolean;
+		user: ReturnType<UserDto['serialize']> | undefined;
+	} {
+		return {
+			isAuthenticated: this.isAuthenticated,
+			isAdmin: this.isAdmin,
+			user: this.user?.serialize(),
+		};
+	}
+}

app/dtos/user_with_counters.ts

@@ -0,0 +1,58 @@
+import { CommonModelDto } from '#dtos/common_model';
+import User from '#models/user';
+
+export class UserWithCountersDto extends CommonModelDto<User> {
+	declare id: number;
+	declare email: string;
+	declare fullname: string;
+	declare avatarUrl: string;
+	declare isAdmin: boolean;
+	declare linksCount: number;
+	declare collectionsCount: number;
+	declare lastSeenAt: string | null;
+	declare createdAt: string | null;
+	declare updatedAt: string | null;
+
+	constructor(user?: User) {
+		if (!user) return;
+		super(user);
+
+		this.id = user.id;
+		this.email = user.email;
+		this.fullname = user.fullname;
+		this.avatarUrl = user.avatarUrl;
+		this.isAdmin = user.isAdmin;
+		this.linksCount = Number(user.$extras.totalLinks);
+		this.collectionsCount = Number(user.$extras.totalCollections);
+		this.lastSeenAt = user.lastSeenAt?.toString() ?? user.updatedAt.toString();
+		this.createdAt = user.createdAt?.toISO();
+		this.updatedAt = user.updatedAt?.toISO();
+	}
+
+	serialize(): {
+		id: number;
+		email: string;
+		fullname: string;
+		avatarUrl: string;
+		isAdmin: boolean;
+		linksCount: number;
+		collectionsCount: number;
+		lastSeenAt: string | null;
+		createdAt: string | null;
+		updatedAt: string | null;
+	} {
+		return {
+			...super.serialize(),
+			id: this.id,
+			email: this.email,
+			fullname: this.fullname,
+			avatarUrl: this.avatarUrl,
+			isAdmin: this.isAdmin,
+			linksCount: this.linksCount,
+			collectionsCount: this.collectionsCount,
+			lastSeenAt: this.lastSeenAt,
+			createdAt: this.createdAt,
+			updatedAt: this.updatedAt,
+		};
+	}
+}

app/exceptions/api/tokens/un_authorized_exception.ts

@@ -0,0 +1,10 @@
+import { Exception } from '@adonisjs/core/exceptions';
+
+export default class UnAuthorizedException extends Exception {
+	static status = 401;
+	static code = 'E_UNAUTHORIZED';
+
+	constructor() {
+		super('Unauthorized', { status: 401, code: 'E_UNAUTHORIZED' });
+	}
+}

app/exceptions/favicon_not_found_exception.ts

@@ -1,20 +0,0 @@
-import { Exception } from '@adonisjs/core/exceptions';
-import { HttpContext } from '@adonisjs/core/http';
-import logger from '@adonisjs/core/services/logger';
-import { createReadStream } from 'node:fs';
-import { resolve } from 'node:path';
-
-export default class FaviconNotFoundException extends Exception {
-	static status = 404;
-	static code = 'E_FAVICON_NOT_FOUND';
-
-	async handle(error: this, ctx: HttpContext) {
-		const readStream = createReadStream(
-			resolve(process.cwd(), './public/empty-image.png')
-		);
-
-		ctx.response.header('Content-Type', 'image/png');
-		ctx.response.stream(readStream);
-		logger.debug(error.message);
-	}
-}

app/exceptions/favicons/favicon_not_found_exception.ts

@@ -0,0 +1,10 @@
+import { Exception } from '@adonisjs/core/exceptions';
+
+export default class FaviconNotFoundException extends Exception {
+	static status = 404;
+	static code = 'E_FAVICON_NOT_FOUND';
+
+	constructor(message: string) {
+		super(message, { status: 404, code: 'E_FAVICON_NOT_FOUND' });
+	}
+}

app/exceptions/handler.ts

@@ -36,6 +36,13 @@ export default class HttpExceptionHandler extends ExceptionHandler {
 	 * response to the client
 	 */
 	async handle(error: unknown, ctx: HttpContext) {
+		if (ctx.request.url()?.startsWith('/api/v1')) {
+			return ctx.response.status(400).json({
+				message: 'Bad Request',
+				errors: [error],
+			});
+		}
+
 		if (error instanceof errors.E_ROW_NOT_FOUND) {
 			return ctx.response.redirectToNamedRoute('dashboard');
 		}

app/lib/api/tokens/index.ts

@@ -0,0 +1,15 @@
+import type { HttpContext } from '@adonisjs/core/http';
+
+export function getTokenFromHeader(ctx: HttpContext): string | null {
+	const authHeader = ctx.request.header('authorization');
+	if (!authHeader) {
+		return null;
+	}
+
+	const parts = authHeader.split(' ');
+	if (parts.length !== 2 || parts[0] !== 'Bearer') {
+		return null;
+	}
+
+	return parts[1];
+}

app/lib/user/index.ts

@@ -0,0 +1,8 @@
+import { getDisplayPreferences } from '#shared/lib/display_preferences';
+import type { DisplayPreferences } from '#shared/types/index';
+
+export function ensureDisplayPreferences(
+	value: Partial<DisplayPreferences> | DisplayPreferences | null | undefined
+): DisplayPreferences {
+	return getDisplayPreferences(value ?? undefined);
+}

app/middlewares/service_worker_scope_extender.ts

@@ -0,0 +1,18 @@
+import { HttpContext } from '@adonisjs/core/http';
+
+const HEADER_NAME = 'Service-Worker-Allowed';
+
+export default class ServiceWorkerScopeExtender {
+	async handle(
+		{ request, response, logger }: HttpContext,
+		next: () => Promise<void>
+	) {
+		if (request.url().startsWith('/assets/sw.js')) {
+			response.header(HEADER_NAME, '/');
+			logger.debug(
+				`Header ${HEADER_NAME} for ${request.url()} set to ${response.getHeader(HEADER_NAME)}`
+			);
+		}
+		await next();
+	}
+}

app/models/collection.ts

@@ -1,9 +1,9 @@
+import { Visibility } from '#enums/collections/visibility';
 import AppBaseModel from '#models/app_base_model';
 import Link from '#models/link';
 import User from '#models/user';
 import { belongsTo, column, hasMany } from '@adonisjs/lucid/orm';
 import type { BelongsTo, HasMany } from '@adonisjs/lucid/types/relations';
-import { Visibility } from '#enums/visibility';
 
 export default class Collection extends AppBaseModel {
 	@column()
@@ -15,9 +15,6 @@ export default class Collection extends AppBaseModel {
 	@column()
 	declare visibility: Visibility;
 
-	@column()
-	declare nextId: number;
-
 	@column()
 	declare authorId: number;
 

app/models/link.ts

@@ -1,5 +1,5 @@
-import AppBaseModel from '#models/app_base_model';
 import Collection from '#models/collection';
+import AppBaseModel from '#models/app_base_model';
 import User from '#models/user';
 import { belongsTo, column } from '@adonisjs/lucid/orm';
 import type { BelongsTo } from '@adonisjs/lucid/types/relations';

app/models/user.ts

@@ -1,9 +1,12 @@
 import Collection from '#models/collection';
+import AppBaseModel from '#models/app_base_model';
 import Link from '#models/link';
+import { type DisplayPreferences } from '#shared/types/index';
+import { ensureDisplayPreferences } from '#lib/user/index';
 import type { GoogleToken } from '@adonisjs/ally/types';
+import { DbAccessTokensProvider } from '@adonisjs/auth/access_tokens';
 import { column, computed, hasMany } from '@adonisjs/lucid/orm';
 import type { HasMany } from '@adonisjs/lucid/types/relations';
-import AppBaseModel from './app_base_model.js';
 import { DateTime } from 'luxon';
 
 export default class User extends AppBaseModel {
@@ -51,4 +54,17 @@ export default class User extends AppBaseModel {
 		autoUpdate: true,
 	})
 	declare lastSeenAt: DateTime;
+
+	@column({
+		serialize: (value) => {
+			if (typeof value === 'string') {
+				return ensureDisplayPreferences(JSON.parse(value));
+			}
+			return value;
+		},
+		prepare: (value) => JSON.stringify(value),
+	})
+	declare displayPreferences: DisplayPreferences;
+
+	static accessTokens = DbAccessTokensProvider.forModel(User);
 }

app/routes/admin.ts

@@ -1,14 +1,11 @@
 import { middleware } from '#start/kernel';
 import router from '@adonisjs/core/services/router';
 
-const AdminController = () => import('#controllers/admin_controller');
+const AdminController = () => import('#controllers/admin/admin_controller');
 
-/**
- * Routes for admin dashboard
- */
 router
 	.group(() => {
-		router.get('/', [AdminController, 'index']).as('admin.dashboard');
+		router.get('/', [AdminController, 'render']).as('admin.dashboard');
 	})
 	.middleware([middleware.auth(), middleware.admin()])
 	.prefix('/admin');

app/routes/api/collections/routes.ts

@@ -0,0 +1,29 @@
+import { middleware } from '#start/kernel';
+import router from '@adonisjs/core/services/router';
+
+const GetCollectionsController = () =>
+	import('#controllers/api/collections/get_collections_controller');
+const CreateCollectionsController = () =>
+	import('#controllers/api/collections/create_collection_controller');
+const UpdateCollectionsController = () =>
+	import('#controllers/api/collections/update_collection_controller');
+const DeleteCollectionsController = () =>
+	import('#controllers/api/collections/delete_collection_controller');
+
+router
+	.group(() => {
+		router
+			.get('', [GetCollectionsController, 'render'])
+			.as('api-collections.index');
+		router
+			.post('', [CreateCollectionsController, 'execute'])
+			.as('api-collections.create');
+		router
+			.put('/:id', [UpdateCollectionsController, 'execute'])
+			.as('api-collections.update');
+		router
+			.delete('/:id', [DeleteCollectionsController, 'execute'])
+			.as('api-collections.delete');
+	})
+	.prefix('/api/v1/collections')
+	.middleware([middleware.auth({ guards: ['api'] })]);

app/routes/api_collections.ts

@@ -0,0 +1,29 @@
+import { middleware } from '#start/kernel';
+import router from '@adonisjs/core/services/router';
+
+const GetCollectionsController = () =>
+	import('#controllers/api/collections/get_collections_controller');
+const CreateCollectionsController = () =>
+	import('#controllers/api/collections/create_collection_controller');
+const UpdateCollectionsController = () =>
+	import('#controllers/api/collections/update_collection_controller');
+const DeleteCollectionsController = () =>
+	import('#controllers/api/collections/delete_collection_controller');
+
+router
+	.group(() => {
+		router
+			.get('', [GetCollectionsController, 'render'])
+			.as('api-collections.index');
+		router
+			.post('', [CreateCollectionsController, 'execute'])
+			.as('api-collections.create');
+		router
+			.put('/:id', [UpdateCollectionsController, 'execute'])
+			.as('api-collections.update');
+		router
+			.delete('/:id', [DeleteCollectionsController, 'execute'])
+			.as('api-collections.delete');
+	})
+	.prefix('/api/v1/collections')
+	.middleware([middleware.auth({ guards: ['api'] })]);

app/routes/api_links.ts

@@ -0,0 +1,33 @@
+import { middleware } from '#start/kernel';
+import router from '@adonisjs/core/services/router';
+
+const CreateLinkController = () =>
+	import('#controllers/api/links/create_link_controller');
+const UpdateLinkController = () =>
+	import('#controllers/api/links/update_link_controller');
+const DeleteLinkController = () =>
+	import('#controllers/api/links/delete_link_controller');
+const GetFavoriteLinksController = () =>
+	import('#controllers/api/links/get_favorite_links_controller');
+
+router
+	.group(() => {
+		router.post('', [CreateLinkController, 'execute']).as('api-links.create');
+		router
+			.put('/:id', [UpdateLinkController, 'execute'])
+			.as('api-links.update');
+		router
+			.delete('/:id', [DeleteLinkController, 'execute'])
+			.as('api-links.delete');
+	})
+	.prefix('/api/v1/links')
+	.middleware([middleware.auth({ guards: ['api'] })]);
+
+router
+	.group(() => {
+		router
+			.get('', [GetFavoriteLinksController, 'execute'])
+			.as('api-links.get-favorite-links');
+	})
+	.prefix('/api/v1/links/favorites')
+	.middleware([middleware.auth({ guards: ['api'] })]);

app/routes/api_tokens.ts

@@ -0,0 +1,12 @@
+import { middleware } from '#start/kernel';
+import router from '@adonisjs/core/services/router';
+
+const ApiTokenController = () =>
+	import('#controllers/api/tokens/api_token_controller');
+
+router
+	.group(() => {
+		router.get('/check', [ApiTokenController, 'render']).as('api-tokens.index');
+	})
+	.prefix('/api/v1/tokens')
+	.middleware([middleware.auth({ guards: ['api'] })]);

app/routes/auth.ts

@@ -0,0 +1,22 @@
+import { middleware } from '#start/kernel';
+import router from '@adonisjs/core/services/router';
+
+const AuthController = () => import('#controllers/auth/auth_controller');
+
+const ROUTES_PREFIX = '/auth';
+
+router
+	.group(() => {
+		router.get('/google', [AuthController, 'google']).as('auth');
+		router
+			.get('/callback', [AuthController, 'callbackAuth'])
+			.as('auth.callback');
+	})
+	.prefix(ROUTES_PREFIX);
+
+router
+	.group(() => {
+		router.get('/logout', [AuthController, 'logout']).as('auth.logout');
+	})
+	.middleware([middleware.auth()])
+	.prefix(ROUTES_PREFIX);

app/routes/collections.ts

@@ -0,0 +1,44 @@
+import { middleware } from '#start/kernel';
+import router from '@adonisjs/core/services/router';
+
+const ShowCollectionsController = () =>
+	import('#controllers/collections/show_collections_controller');
+const CreateCollectionController = () =>
+	import('#controllers/collections/create_collection_controller');
+const UpdateCollectionController = () =>
+	import('#controllers/collections/update_collection_controller');
+const DeleteCollectionController = () =>
+	import('#controllers/collections/delete_collection_controller');
+
+router
+	.group(() => {
+		router
+			.get('/dashboard', [ShowCollectionsController, 'render'])
+			.as('dashboard');
+
+		router
+			.group(() => {
+				router
+					.get('/create', [CreateCollectionController, 'render'])
+					.as('collection.create-form');
+				router
+					.post('/', [CreateCollectionController, 'execute'])
+					.as('collection.create');
+
+				router
+					.get('/edit', [UpdateCollectionController, 'render'])
+					.as('collection.edit-form');
+				router
+					.put('/:id', [UpdateCollectionController, 'execute'])
+					.as('collection.edit');
+
+				router
+					.get('/delete', [DeleteCollectionController, 'render'])
+					.as('collection.delete-form');
+				router
+					.delete('/:id', [DeleteCollectionController, 'execute'])
+					.as('collection.delete');
+			})
+			.prefix('/collections');
+	})
+	.middleware([middleware.auth()]);

app/routes/favicons.ts

@@ -0,0 +1,8 @@
+import router from '@adonisjs/core/services/router';
+
+const FaviconsController = () =>
+	import('#controllers/favicons/favicons_controller');
+
+router.group(() => {
+	router.get('/favicon', [FaviconsController, 'render']).as('favicon');
+});

app/routes/home.ts

@@ -0,0 +1,3 @@
+import router from '@adonisjs/core/services/router';
+
+router.on('/').renderInertia('home').as('home');

app/routes/legal.ts

@@ -0,0 +1,4 @@
+import router from '@adonisjs/core/services/router';
+
+router.on('/terms').renderInertia('terms').as('terms');
+router.on('/privacy').renderInertia('privacy').as('privacy');

app/routes/links.ts

@@ -0,0 +1,33 @@
+import { middleware } from '#start/kernel';
+import router from '@adonisjs/core/services/router';
+
+const CreateLinkController = () =>
+	import('#controllers/links/create_link_controller');
+const DeleteLinkController = () =>
+	import('#controllers/links/delete_link_controller');
+const UpdateLinkController = () =>
+	import('#controllers/links/update_link_controller');
+const ToggleFavoriteController = () =>
+	import('#controllers/links/toggle_favorite_controller');
+
+router
+	.group(() => {
+		router
+			.get('/create', [CreateLinkController, 'render'])
+			.as('link.create-form');
+		router.post('/', [CreateLinkController, 'execute']).as('link.create');
+
+		router.get('/edit', [UpdateLinkController, 'render']).as('link.edit-form');
+		router.put('/:id', [UpdateLinkController, 'execute']).as('link.edit');
+
+		router
+			.put('/:id/favorite', [ToggleFavoriteController, 'toggleFavorite'])
+			.as('link.toggle-favorite');
+
+		router
+			.get('/delete', [DeleteLinkController, 'render'])
+			.as('link.delete-form');
+		router.delete('/:id', [DeleteLinkController, 'execute']).as('link.delete');
+	})
+	.middleware([middleware.auth()])
+	.prefix('/links');

app/routes/search.ts

@@ -0,0 +1,10 @@
+import { middleware } from '#start/kernel';
+import router from '@adonisjs/core/services/router';
+
+const SearchController = () => import('#controllers/search/search_controller');
+
+router
+	.group(() => {
+		router.get('/search', [SearchController, 'render']).as('search');
+	})
+	.middleware([middleware.auth()]);

app/routes/shared_collections.ts

@@ -0,0 +1,6 @@
+import router from '@adonisjs/core/services/router';
+
+const SharedCollectionsController = () =>
+	import('#controllers/shared_collections/shared_collections_controller');
+
+router.get('/shared/:id', [SharedCollectionsController, 'render']).as('shared');

app/routes/user.ts

@@ -0,0 +1,25 @@
+import { middleware } from '#start/kernel';
+import router from '@adonisjs/core/services/router';
+
+const ThemeController = () => import('#controllers/user/theme_controller');
+const DisplayPreferencesController = () =>
+	import('#controllers/user/display_preferences_controller');
+const ApiTokenController = () =>
+	import('#controllers/user/api_token_controller');
+
+router.post('/user/theme', [ThemeController, 'render']).as('user.theme');
+
+router
+	.post('/user/display-preferences', [DisplayPreferencesController, 'update'])
+	.as('user.update-display-preferences')
+	.middleware([middleware.auth()]);
+
+router
+	.group(() => {
+		router.post('/', [ApiTokenController, 'store']).as('user.api-tokens.store');
+		router
+			.delete('/:tokenId', [ApiTokenController, 'destroy'])
+			.as('user.api-tokens.destroy');
+	})
+	.prefix('/user/api-tokens')
+	.middleware([middleware.auth()]);

app/routes/user_settings.ts

@@ -0,0 +1,8 @@
+import router from '@adonisjs/core/services/router';
+
+const ShowUserSettingsController = () =>
+	import('#controllers/user_settings/show_user_settings_controller');
+
+router
+	.get('/user/settings', [ShowUserSettingsController, 'render'])
+	.as('user.settings');

app/services/collections/collection_service.ts

@@ -0,0 +1,104 @@
+import { Visibility } from '#enums/collections/visibility';
+import Collection from '#models/collection';
+import { collectionIdValidator } from '#validators/collections/collection_id_validator';
+import { HttpContext } from '@adonisjs/core/http';
+import db from '@adonisjs/lucid/services/db';
+
+type CreateCollectionPayload = {
+	name: string;
+	description: string | null;
+	visibility: Visibility;
+};
+
+type UpdateCollectionPayload = CreateCollectionPayload;
+
+export class CollectionService {
+	async getCollectionById(id: Collection['id']) {
+		const context = this.getAuthContext();
+		return await Collection.query()
+			.where('id', id)
+			.andWhere('author_id', context.auth.user!.id)
+			.firstOrFail();
+	}
+
+	async getCollectionsForAuthenticatedUser() {
+		const context = this.getAuthContext();
+		return await Collection.query()
+			.where('author_id', context.auth.user!.id)
+			.orderBy('created_at', 'desc')
+			.preload('links', (q) => q.orderBy('favorite', 'desc'));
+	}
+
+	async getTotalCollectionsCount() {
+		const totalCount = await db.from('collections').count('* as total');
+		return Number(totalCount[0].total);
+	}
+
+	createCollection(payload: CreateCollectionPayload) {
+		const context = this.getAuthContext();
+		return Collection.create({
+			...payload,
+			authorId: context.auth.user!.id,
+		});
+	}
+
+	async updateCollection(
+		id: Collection['id'],
+		payload: UpdateCollectionPayload
+	) {
+		const context = this.getAuthContext();
+		return await Collection.query()
+			.where('id', id)
+			.andWhere('author_id', context.auth.user!.id)
+			.update(payload);
+	}
+
+	deleteCollection(id: Collection['id']) {
+		const context = this.getAuthContext();
+		return Collection.query()
+			.where('id', id)
+			.andWhere('author_id', context.auth.user!.id)
+			.delete();
+	}
+
+	getPublicCollectionById(id: Collection['id']) {
+		return Collection.query()
+			.where('id', id)
+			.andWhere('visibility', Visibility.PUBLIC)
+			.preload('links')
+			.preload('author')
+			.firstOrFail();
+	}
+
+	private getAuthContext() {
+		const context = HttpContext.getOrFail();
+		if (!context.auth.user || !context.auth.user.id) {
+			throw new Error('User not authenticated');
+		}
+		return context;
+	}
+
+	async validateCollectionId(collectionIdRequired: boolean = true) {
+		const ctx = HttpContext.getOrFail();
+		const { collectionId } = await ctx.request.validateUsing(
+			collectionIdValidator
+		);
+		if (!collectionId && collectionIdRequired) {
+			this.redirectToDashboard();
+			return null;
+		}
+		return collectionId;
+	}
+
+	redirectToCollectionId(collectionId: Collection['id']) {
+		const ctx = HttpContext.getOrFail();
+		return ctx.response.redirectToNamedRoute('dashboard', {
+			qs: { collectionId },
+		});
+	}
+
+	redirectToDashboard() {
+		const ctx = HttpContext.getOrFail();
+		return ctx.response.redirectToNamedRoute('dashboard');
+	}
+}

app/services/favicons/cache_service.ts

@@ -0,0 +1,17 @@
+import { cache } from '#lib/cache';
+import { Favicon } from '#types/favicons/favicon_type';
+
+export class CacheService {
+	private cacheNs = cache.namespace('favicon');
+
+	async getOrSetFavicon(
+		url: string,
+		factory: () => Promise<Favicon>
+	): Promise<Favicon> {
+		return this.cacheNs.getOrSet({
+			key: url,
+			ttl: '1h',
+			factory,
+		});
+	}
+}

app/services/favicons/favicons_service.ts

@@ -1,17 +1,9 @@
-import FaviconNotFoundException from '#exceptions/favicon_not_found_exception';
+import FaviconNotFoundException from '#exceptions/favicons/favicon_not_found_exception';
-import { cache } from '#lib/cache';
+import { Favicon } from '#types/favicons/favicon_type';
-import type { HttpContext } from '@adonisjs/core/http';
 import logger from '@adonisjs/core/services/logger';
 import { parse } from 'node-html-parser';
 
-interface Favicon {
+export class FaviconService {
-	buffer: Buffer;
-	url: string;
-	type: string;
-	size: number;
-}
-
-export default class FaviconsController {
 	private userAgent =
 		'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36 Edg/119.0.0.0';
 	private relList = [
@@ -24,27 +16,11 @@ export default class FaviconsController {
 		'fluid-icon',
 	];
 
-	async index(ctx: HttpContext) {
+	async getFavicon(url: string): Promise<Favicon> {
-		const url = ctx.request.qs()?.url;
-		if (!url) {
-			throw new Error('Missing URL');
-		}
-
-		const cacheNs = cache.namespace('favicon');
-		const favicon = await cacheNs.getOrSet({
-			key: url,
-			ttl: '1h',
-			factory: () => this.tryGetFavicon(url),
-		});
-		return this.sendImage(ctx, favicon);
-	}
-
-	private async tryGetFavicon(url: string): Promise<Favicon> {
-		const faviconUrl = this.buildFaviconUrl(url, '/favicon.ico');
 		try {
-			return await this.fetchFavicon(faviconUrl);
+			return await this.fetchFavicon(this.buildFaviconUrl(url, '/favicon.ico'));
 		} catch {
-			logger.debug(`Unable to retrieve favicon from ${faviconUrl}`);
+			logger.debug(`Unable to retrieve favicon from ${url}/favicon.ico`);
 		}
 
 		const documentText = await this.fetchDocumentText(url);
@@ -54,15 +30,7 @@ export default class FaviconsController {
 			throw new FaviconNotFoundException(`No favicon path found in ${url}`);
 		}
 
-		if (faviconPath.startsWith('http')) {
+		return await this.fetchFaviconFromPath(url, faviconPath);
-			try {
-				return await this.fetchFavicon(faviconPath);
-			} catch {
-				logger.debug(`Unable to retrieve favicon from ${faviconPath}`);
-			}
-		}
-
-		return this.fetchFaviconFromPath(url, faviconPath);
 	}
 
 	private async fetchFavicon(url: string): Promise<Favicon> {
@@ -127,7 +95,9 @@ export default class FaviconsController {
 
 		const basePath = this.urlWithoutSearchParams(base);
 		const baseUrl = basePath.endsWith('/') ? basePath.slice(0, -1) : basePath;
-		return `${baseUrl}/${path}`;
+		const finalUrl = `${baseUrl}/${path}`;
+		logger.debug(`Built favicon URL: ${finalUrl}`);
+		return finalUrl;
 	}
 
 	private urlWithoutSearchParams(url: string): string {
@@ -151,10 +121,4 @@ export default class FaviconsController {
 		const headers = new Headers({ 'User-Agent': this.userAgent });
 		return fetch(url, { headers });
 	}
-
-	private sendImage(ctx: HttpContext, { buffer, type, size }: Favicon) {
-		ctx.response.header('Content-Type', type);
-		ctx.response.header('Content-Length', size.toString());
-		ctx.response.send(buffer, true);
-	}
 }

app/services/links/link_service.ts

@@ -0,0 +1,68 @@
+import Link from '#models/link';
+import { HttpContext } from '@adonisjs/core/http';
+
+type CreateLinkPayload = {
+	name: string;
+	description?: string;
+	url: string;
+	favorite: boolean;
+	collectionId: number;
+};
+
+type UpdateLinkPayload = CreateLinkPayload;
+
+export class LinkService {
+	createLink(payload: CreateLinkPayload) {
+		const context = this.getAuthContext();
+		return Link.create({
+			...payload,
+			authorId: context.auth.user!.id,
+		});
+	}
+
+	updateLink(id: number, payload: UpdateLinkPayload) {
+		const context = this.getAuthContext();
+		return Link.query()
+			.where('id', id)
+			.andWhere('author_id', context.auth.user!.id)
+			.update(payload);
+	}
+
+	deleteLink(id: number) {
+		const context = this.getAuthContext();
+		return Link.query()
+			.where('id', id)
+			.andWhere('author_id', context.auth.user!.id)
+			.delete();
+	}
+
+	async getLinkById(id: Link['id'], userId: Link['id']) {
+		return await Link.query()
+			.where('id', id)
+			.andWhere('author_id', userId)
+			.firstOrFail();
+	}
+
+	updateFavorite(id: number, favorite: boolean) {
+		return Link.query()
+			.where('id', id)
+			.andWhere('author_id', this.getAuthContext().auth.user!.id)
+			.update({ favorite });
+	}
+
+	async getFavoriteLinksForAuthenticatedUser() {
+		const context = this.getAuthContext();
+		return await Link.query()
+			.where('author_id', context.auth.user!.id)
+			.where('favorite', true)
+			.orderBy('created_at');
+	}
+
+	getAuthContext() {
+		const context = HttpContext.getOrFail();
+		if (!context.auth.user || !context.auth.user.id) {
+			throw new Error('User not authenticated');
+		}
+		return context;
+	}
+}

app/services/user/api_token_service.ts

@@ -0,0 +1,28 @@
+import User from '#models/user';
+
+type CreateTokenParams = {
+	name: string;
+	expiresAt?: Date;
+};
+
+export class ApiTokenService {
+	createToken(user: User, { name, expiresAt }: CreateTokenParams) {
+		const expiresIn = expiresAt ? expiresAt.getTime() - Date.now() : undefined;
+		return User.accessTokens.create(user, undefined, {
+			name,
+			expiresIn,
+		});
+	}
+
+	getTokens(user: User) {
+		return User.accessTokens.all(user);
+	}
+
+	revokeToken(user: User, identifier: number) {
+		return User.accessTokens.delete(user, identifier);
+	}
+
+	getTokenByValue(user: User, value: string) {
+		return User.accessTokens.find(user, value);
+	}
+}

app/types/dto.ts

@@ -0,0 +1,28 @@
+export type StaticDto<Model, Dto> = { new (model: Model): Dto };
+
+export interface SimplePaginatorDtoContract<Dto> {
+	data: Dto[];
+	meta: SimplePaginatorDtoMetaContract;
+}
+
+export interface SimplePaginatorDtoMetaContract {
+	total: number;
+	perPage: number;
+	currentPage: number;
+	lastPage: number;
+	firstPage: number;
+	firstPageUrl: string;
+	lastPageUrl: string;
+	nextPageUrl: string | null;
+	previousPageUrl: string | null;
+	pagesInRange?: {
+		url: string;
+		page: number;
+		isActive: boolean;
+	}[];
+}
+
+export type SimplePaginatorDtoMetaRange = {
+	start: number;
+	end: number;
+};

app/types/favicons/favicon_type.ts

@@ -0,0 +1,6 @@
+export type Favicon = {
+	buffer: Buffer;
+	url: string;
+	type: string;
+	size: number;
+};

app/validators/collection.ts

@@ -1,37 +0,0 @@
-import { Visibility } from '#enums/visibility';
-import vine, { SimpleMessagesProvider } from '@vinejs/vine';
-
-const params = vine.object({
-	id: vine.number(),
-});
-
-export const createCollectionValidator = vine.compile(
-	vine.object({
-		name: vine.string().trim().minLength(1).maxLength(254),
-		description: vine.string().trim().maxLength(254).nullable(),
-		visibility: vine.enum(Visibility),
-		nextId: vine.number().optional(),
-	})
-);
-
-export const updateCollectionValidator = vine.compile(
-	vine.object({
-		name: vine.string().trim().minLength(1).maxLength(254),
-		description: vine.string().trim().maxLength(254).nullable(),
-		visibility: vine.enum(Visibility),
-		nextId: vine.number().optional(),
-
-		params,
-	})
-);
-
-export const deleteCollectionValidator = vine.compile(
-	vine.object({
-		params,
-	})
-);
-
-createCollectionValidator.messagesProvider = new SimpleMessagesProvider({
-	name: 'Collection name is required',
-	'visibility.required': 'Collection visibiliy is required',
-});

app/validators/collections/collection_id_validator.ts

@@ -0,0 +1,7 @@
+import vine from '@vinejs/vine';
+
+export const collectionIdValidator = vine.compile(
+	vine.object({
+		collectionId: vine.number().positive().optional(),
+	})
+);

app/validators/collections/create_collection_validator.ts

@@ -0,0 +1,15 @@
+import { Visibility } from '#enums/collections/visibility';
+import vine, { SimpleMessagesProvider } from '@vinejs/vine';
+
+export const createCollectionValidator = vine.compile(
+	vine.object({
+		name: vine.string().trim().minLength(1).maxLength(254),
+		description: vine.string().trim().maxLength(254).nullable(),
+		visibility: vine.enum(Visibility),
+	})
+);
+
+createCollectionValidator.messagesProvider = new SimpleMessagesProvider({
+	name: 'Collection name is required',
+	'visibility.required': 'Collection visibiliy is required',
+});

app/validators/collections/delete_collection_validator.ts

@@ -0,0 +1,8 @@
+import { params } from '#validators/params_object';
+import vine from '@vinejs/vine';
+
+export const deleteCollectionValidator = vine.compile(
+	vine.object({
+		params,
+	})
+);