chore: add swagger image in readme and add env example file

Author: frckbrice

.env.example

@@ -1,3 +1,17 @@
-DATABASE_URL=""
-SESSION_SECRET=""
-REPL_ID=""
+# databases
+DATABASE_URL=
+
+# URIs
+SESSION_SECRET=
+API_PROD_API_URL=
+
+
+# email
+GMAIL_USER=
+GMAIL_APP_PASSWORD=
+GMAIL_APP_SUPPORT=
+
+# cloudinary bucket
+CLOUDINARY_CLOUD_NAME=
+CLOUDINARY_API_KEY=
+CLOUDINARY_API_SECRET=

README.md

@@ -5,6 +5,8 @@
 [![Node.js](https://img.shields.io/badge/Node.js-20%2B%20%7C%2022-green.svg)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+![Library Management REST API](public/images/lib_management_rest_api.png)
+
 A production-ready RESTful API for library content management—collections, stories, media, events, and user operations. Built with modern TypeScript, Express.js, and PostgreSQL. Designed for scalability, maintainability, and secure multi-tenant operations.
 
 **Repository:** [github.com/frckbrice/library-management-REST-API](https://github.com/frckbrice/library-management-REST-API)

config/database/storage.ts

@@ -53,6 +53,7 @@ export interface IStorage {
   getTotalLibraries(options?: { approved?: boolean; featured?: boolean; type?: string }): Promise<number>;
   createLibrary(library: InsertLibrary): Promise<Library>;
   updateLibrary(id: string, data: Partial<Library>): Promise<Library | undefined>;
+  deleteLibrary(id: string): Promise<boolean>;
 
   // Stories
   getStory(id: string): Promise<Story | undefined>;
@@ -1042,6 +1043,16 @@ export class MemStorage implements IStorage {
     return updatedLibrary;
   }
 
+  async deleteLibrary(id: string): Promise<boolean> {
+    const library = await this.getLibrary(id);
+    if (!library) return false;
+    for (const [, user] of this.users) {
+      if (user.libraryId === id) (user as any).libraryId = null;
+    }
+    this.librarys.delete(id);
+    return true;
+  }
+
   // Story methods
   async getStory(id: string): Promise<Story | undefined> {
     return this.stories.get(id);

config/swagger.ts

@@ -223,6 +223,20 @@ export const openApiDocument = {
           '500': errorResponse('Failed to upload image'),
         },
       },
+      delete: {
+        tags: ['Libraries'],
+        summary: 'Delete library',
+        description: 'Superadmin only. Permanently deletes a library. Unassigns linked users; stories, events, media, and contact messages for this library are removed (cascade).',
+        security: [{ cookieAuth: [] }],
+        parameters: [{ name: 'id', in: 'path', required: true, schema: { type: 'string', format: 'uuid' } }],
+        responses: {
+          '204': { description: 'Library deleted successfully' },
+          '401': errorResponse('Authentication required', 'AUTHENTICATION_ERROR', 'Authentication required'),
+          '403': errorResponse('Insufficient permissions', 'AUTHORIZATION_ERROR', 'Insufficient permissions'),
+          '404': errorResponse('Library not found', 'NOT_FOUND', 'Library not found'),
+          '500': errorResponse('Internal server error', 'INTERNAL_ERROR', 'Internal server error'),
+        },
+      },
     },
     [`${apiPath}/stories`]: {
       get: {

public/images/lib_management_rest_api.png

@@ -114,6 +114,16 @@ export function registerLibrariesRoutes(app: Express, global_path: string) {
         });
     }));
 
+    // Delete library (superadmin only)
+    app.delete(`${global_path}/libraries/:id`, requireSuperAdmin, apiHandler(async (req, res) => {
+        const libraryId = req.params.id;
+        const existing = await drizzleService.getLibrary(libraryId);
+        if (!existing) throw new NotFoundError('Library');
+        const deleted = await drizzleService.deleteLibrary(libraryId);
+        if (!deleted) return res.status(500).json({ error: 'Failed to delete library' });
+        return res.status(204).send();
+    }));
+
     // Librarys endpoints
     app.get(`${global_path}/libraries`, async (req, res) => {
         try {

src/routes/libraries.routes.ts

@@ -237,6 +237,20 @@ export class DatabaseStorage implements IStorage {
         }
     }
 
+    /** Deletes a library by ID. Unassigns users linked to this library, then deletes (cascade removes stories, events, media, contact messages). */
+    async deleteLibrary(id: string): Promise<boolean> {
+        try {
+            const [existing] = await db.select().from(libraries).where(eq(libraries.id, id)).limit(1);
+            if (!existing) return false;
+            await db.update(users).set({ libraryId: null }).where(eq(users.libraryId, id));
+            const result = await db.delete(libraries).where(eq(libraries.id, id)).returning();
+            return result.length > 0;
+        } catch (error) {
+            console.error('Error in deleteLibrary:', error);
+            return false;
+        }
+    }
+
     // Stories
     /** Fetches a story by ID. */
     async getStory(id: string): Promise<Story | undefined> {