refactor(api): ✨ Centralize services, middleware, and schemas

- Restructure API services into domain-specific folders (auth, agencies, documents, requests, security, operations, templates).
- Centralize shared utilities (lib, utils, validators) and barrel export them using `@/` aliases.
- Migrate legacy `api/src/routes/` structure to use OpenAPI pattern exclusively, removing legacy route files.
- Introduce `middleware/shared.middleware.ts` for centralized cache control and error handling utilities.
- Update all imports across the API to use the new `@/` alias structure.
- Add `middleware.ts` to Astro app for setting standard security headers (CSP, X-Frame-Options, etc.).
- Add mock for `bun:sqlite` to enable Vitest (Node.js) testing environment.

Author: WomB0ComB0

README.md

@@ -1,3 +1,25 @@
+<!--
+  Copyright (c) 2025 Foia Stream
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+-->
+
 <!--
   Generated by AI-Powered README Generator
   Repository: https://github.com/WomB0ComB0/foia-stream

apps/api/data/foia-stream.db-shm

@@ -1,3 +1,23 @@
+-- Copyright (c) 2025 Foia Stream
+--
+-- Permission is hereby granted, free of charge, to any person obtaining a copy
+-- of this software and associated documentation files (the "Software"), to deal
+-- in the Software without restriction, including without limitation the rights
+-- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+-- copies of the Software, and to permit persons to whom the Software is
+-- furnished to do so, subject to the following conditions:
+--
+-- The above copyright notice and this permission notice shall be included in all
+-- copies or substantial portions of the Software.
+--
+-- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+-- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+-- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+-- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+-- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+-- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+-- SOFTWARE.
+
 CREATE TABLE `custom_redaction_templates` (
 	`id` text PRIMARY KEY NOT NULL,
 	`user_id` text NOT NULL,