Develop

.env.example

@@ -1,4 +1,8 @@
 DATABASE_URL=
 CORS_ORIGIN=
 BETTER_AUTH_SECRET=
-BETTER_AUTH_URL=
+BETTER_AUTH_URL=
+NODE_ENV=
+JWT_ACCESS_SECRET=
+JWT_REFRESH_SECRET=
+GITHUB_TOKEN=

.github/workflows/test.yml

@@ -0,0 +1,32 @@
+# https://docs.github.com/en/actions/tutorials/build-and-test-code/nodejs
+# SAMIP REGMI
+# SEP 17 2025
+
+# SURUMA CHAI GITHUB DOCS BATA LEKHEKO THEYE
+# LOCALLY DOCKER RA ACT SANGA CHALO TARA GITHUB MA CHAI PROBLEM AAYO
+# SO I REMOVED SOME THINGS LIKE CACHING AND STUFF
+name: Tests for endpoints using vitest
+
+# CURRENTLY IT RUNS ON EVERY PUSH ON ANY BRANCH
+# HAMILE **develop** KO LAGI MATRA BANAUDA PANI HUNXA
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v5 # CHECKOUT THE REPO -> FROM DOCS
+    - uses: actions/setup-node@v4 # SETUP NODE -> FROM DOCS
+      with:
+        node-version: '22.17.0' #MY NODE VERSION
+    - name: Install pnpm # INSTALL PNPM 
+      run: npm install -g pnpm@10.16.1 #YO CHAI MERO MA VAKO VERSION HO HAI LOL
+    - run: pnpm install
+    - name: prisma ko client generate # GENERATE PRISMA CLIENT
+      run: pnpm prisma generate
+    # PACKAGE JSON MA VAKO SCRIPT RUN GARNE 
+    # BECAUSE IT IS RUNNING A SINGLE TEST FILE WITH ORDER 
+    - run: pnpm run test 
+    env:
+      DATABASE_URL: ${{ secrets.DATABASE_URL }} # DATABASE URL FROM GITHUB SECRETS
+      CI: true # THE CI ENV VARIABLE IS NEEDED FOR VITEST TO RUN IN GITHUB ACTIONS

README.md

@@ -70,3 +70,26 @@ The API is running at [http://localhost:3000](http://localhost:3000).
 - `npm run db:studio`: Open database studio UI
  - `npm run db:generate`: Generate prisma client
 
+
+
+
+
+
+## Tests
+
+- `npx vitest src/tests/events/create.test.ts` : target a particular file
+- `npm run test` : test all
+
+
+
+
+
+
+## Workflow test
+
+**Make sure u have `docker` and `act` installed**
+
+- mock the push using `act push` **ONLY USE THIS COMMAND FOR FIRST TIME**
+- now check if the images are installed on docker `docker images`
+- now everytime u call use `act push --reuse` so instead of creating new image it uses the existing image
+

docs/CLOUDINARY_UPLOAD.md

@@ -0,0 +1,129 @@
+# CLOUDINARY IMAGE UPLOAD
+
+## Overview
+Upload images to Cloudinary cloud storage using controller-service pattern.
+
+## Setup Required
+Environment variables in `.env`:
+```
+CLOUDINARY_CLOUD_NAME=your_cloud_name
+CLOUDINARY_API_KEY=your_api_key
+CLOUDINARY_API_SECRET=your_api_secret
+```
+
+## Implementation Example: Update Profile with Image
+
+### 1. Router
+```typescript
+// user.router.ts
+import upload from '@/lib/multer';
+import { userController } from '@/controllers/user.controller';
+
+router.patch('/profile', upload.single('profileImage'), userController.updateProfile);
+```
+
+### 2. Controller
+```typescript
+// user.controller.ts
+import { userService } from '@/services/user.service';
+
+export const userController = {
+  updateProfile: async (req: Request, res: Response) => {
+    try {
+      const userId = req.user.id; // from auth middleware
+      const updateData = req.body;
+      const imageFile = req.file;
+
+      const result = await userService.updateProfile(userId, updateData, imageFile);
+
+      res.status(200).json({
+        success: true,
+        message: 'Profile updated successfully',
+        data: result
+      });
+    } catch (error) {
+      res.status(500).json({
+        success: false,
+        message: 'Failed to update profile'
+      });
+    }
+  }
+};
+```
+
+### 3. Service
+```typescript
+// user.service.ts
+import { uploadImageToCloudinary } from '@/utils/cloudinary.uploader';
+import prisma from '@/db/prisma';
+
+export const userService = {
+  updateProfile: async (userId: string, updateData: any, imageFile?: Express.Multer.File) => {
+    let profileImageUrl = undefined;
+
+    // Upload image if provided
+    if (imageFile) {
+      const uploadResult = await uploadImageToCloudinary(imageFile.path, {
+        folder: 'profile_images'
+      });
+
+      if (uploadResult.success) {
+        profileImageUrl = uploadResult.url;
+      } else {
+        throw new Error('Image upload failed');
+      }
+    }
+
+    // Update user in database
+    const updatedUser = await prisma.user.update({
+      where: { id: userId },
+      data: {
+        ...updateData,
+        ...(profileImageUrl && { profileImage: profileImageUrl })
+      }
+    });
+
+    return updatedUser;
+  }
+};
+```
+
+## Request Format
+```
+PATCH /api/user/profile
+Content-Type: multipart/form-data
+
+profileImage: [file]
+name: "John Doe"
+bio: "Software Developer"
+```
+
+## Response Format
+
+### Success (200)
+```json
+{
+  "success": true,
+  "message": "Profile updated successfully",
+  "data": {
+    "id": "user123",
+    "name": "John Doe",
+    "bio": "Software Developer",
+    "profileImage": "https://res.cloudinary.com/your-cloud/image/upload/v1234567890/profile_images/filename.jpg"
+  }
+}
+```
+
+### Error (500)
+```json
+{
+  "success": false,
+  "message": "Failed to update profile"
+}
+```
+
+## Notes
+- Uses multer for handling multipart form data
+- Images uploaded to `profile_images` folder in Cloudinary
+- Supports JPG, PNG, JPEG, WEBP formats
+- Image upload is optional in the example

docs/GETEVENT.md

@@ -0,0 +1,47 @@
+# GET EVENT(GET)
+
+```
+/api/event/id/<id>
+```
+
+## VALID GET (200)
+
+```json
+{
+	"success": true,
+	"message": "EVENT FETCHED SUCCESSFULLY",
+	"data": {
+		"name": "ABCD",
+		"description": "ALPHABET",
+		"status": "UPCOMING",
+		"eventSchedule": [
+			{
+				"id": "fcbe5081-3f6e-4696-bb2b-19f7758a6425",
+				"startDate": "2025-09-15T10:00:00.000Z",
+				"endDate": "2025-09-15T12:00:00.000Z",
+				"description": "TODAY IS FIRST DAY",
+				"eventId": "4786f250-3fda-48a5-80ea-de84fdf9076f"
+			},
+			{
+				"id": "aa11b7ed-a465-4098-897c-5ce847b71549",
+				"startDate": "2025-09-16T12:00:00.000Z",
+				"endDate": "2025-09-16T14:00:00.000Z",
+				"description": "TODAY IS SECOND DAY",
+				"eventId": "4786f250-3fda-48a5-80ea-de84fdf9076f"
+			}
+		]
+	},
+	"code": 200
+}
+```
+
+## INVALID GET (404)
+
+```json
+{
+	"success": false,
+	"error": "EVENT NOT FOUND",
+	"details": null,
+	"code": 404
+}
+```

docs/LISTEVENT.md

@@ -0,0 +1,105 @@
+# LIST EVENT(GET)
+
+```
+/api/event/list
+```
+
+## GET (200)
+
+```json
+{
+	"success": true,
+	"message": "EVENTS FETCHED SUCCESSFULLY",
+	"data": [
+		{
+			"id": "4786f250-3fda-48a5-80ea-de84fdf9076f",
+			"name": "ABCD",
+			"description": "ALPHABET",
+			"status": "UPCOMING",
+			"eventSchedule": [
+				{
+					"id": "fcbe5081-3f6e-4696-bb2b-19f7758a6425",
+					"startDate": "2025-09-15T10:00:00.000Z",
+					"endDate": "2025-09-15T12:00:00.000Z",
+					"description": "TODAY IS FIRST DAY",
+					"eventId": "4786f250-3fda-48a5-80ea-de84fdf9076f"
+				},
+				{
+					"id": "aa11b7ed-a465-4098-897c-5ce847b71549",
+					"startDate": "2025-09-16T12:00:00.000Z",
+					"endDate": "2025-09-16T14:00:00.000Z",
+					"description": "TODAY IS SECOND DAY",
+					"eventId": "4786f250-3fda-48a5-80ea-de84fdf9076f"
+				}
+			]
+		},
+		{
+			"id": "e5ae4620-b899-4486-83d9-a622074933f4",
+			"name": "NEW EVENT",
+			"description": "NEW EVENT",
+			"status": "UPCOMING",
+			"eventSchedule": [
+				{
+					"id": "95e60be8-4feb-47f1-b6fc-ae30ddc3f073",
+					"startDate": "2025-09-15T10:00:00.000Z",
+					"endDate": "2025-09-15T12:00:00.000Z",
+					"description": "TODAY IS FIRST DAY",
+					"eventId": "e5ae4620-b899-4486-83d9-a622074933f4"
+				},
+				{
+					"id": "b11fd7e1-7aae-49fd-9638-98fad118e3f3",
+					"startDate": "2025-09-16T12:00:00.000Z",
+					"endDate": "2025-09-16T14:00:00.000Z",
+					"description": "TODAY IS SECOND DAY",
+					"eventId": "e5ae4620-b899-4486-83d9-a622074933f4"
+				}
+			]
+		},
+		{
+			"id": "c4514d94-4b7a-4834-8e16-e3e42618244e",
+			"name": "COMPLETED EVENT",
+			"description": "NEW EVENT",
+			"status": "COMPLETED",
+			"eventSchedule": [
+				{
+					"id": "81c70f52-8386-4317-bd09-80247de1c289",
+					"startDate": "2025-09-15T10:00:00.000Z",
+					"endDate": "2025-09-15T12:00:00.000Z",
+					"description": "TODAY IS FIRST DAY",
+					"eventId": "c4514d94-4b7a-4834-8e16-e3e42618244e"
+				},
+				{
+					"id": "2ebff3bc-80b7-4507-8c5c-fda1ce92ea2f",
+					"startDate": "2025-09-16T12:00:00.000Z",
+					"endDate": "2025-09-16T14:00:00.000Z",
+					"description": "TODAY IS SECOND DAY",
+					"eventId": "c4514d94-4b7a-4834-8e16-e3e42618244e"
+				}
+			]
+		},
+		{
+			"id": "aeb58d3f-e5d1-4e3f-95d7-d447d858ffd4",
+			"name": "COMPLETED TEST",
+			"description": "NEW EVENT",
+			"status": "COMPLETED",
+			"eventSchedule": [
+				{
+					"id": "3d71c36a-119e-41d6-b3f8-bf354a27280b",
+					"startDate": "2025-09-15T10:00:00.000Z",
+					"endDate": "2025-09-15T12:00:00.000Z",
+					"description": "TODAY IS FIRST DAY",
+					"eventId": "aeb58d3f-e5d1-4e3f-95d7-d447d858ffd4"
+				},
+				{
+					"id": "7f6f780f-1845-4b04-92a6-6c6974ca6820",
+					"startDate": "2025-09-16T12:00:00.000Z",
+					"endDate": "2025-09-16T14:00:00.000Z",
+					"description": "TODAY IS SECOND DAY",
+					"eventId": "aeb58d3f-e5d1-4e3f-95d7-d447d858ffd4"
+				}
+			]
+		}
+	],
+	"code": 200
+}
+```