# EMI Backend service

This is the code for the backend of the EMI website.

## Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

### Prerequisites

What things you need to install the software and how to install them:

```
node.js
npm
mongodb
```

### Installing

A step by step series of examples that tell you how to get a development env running:

1.  Clone the repo
2.  Install NPM packages
    ```
    npm install
    ```
3.  Create a `.env` file with the necessary environment variables (`PORT`, `MONGO_URL`, `STRIPE`, etc.)
4.  Run the server
    ```
    npm start
    ```

### API Documentation

Once the server is running, you can access the interactive API documentation powered by Swagger UI at:

`http://localhost:3000/api-docs`

This page allows you to view all available endpoints, their parameters, and test them directly from your browser.

## API Endpoints

The API is divided into several sections based on functionality. Most routes under `/user`, `/post`, `/bible`, and `/songs` require authentication via a session cookie.

### Authentication

-   `POST /signup`: Creates a new user account.
-   `POST /login`: Logs in a user and creates a session.
-   `GET /logout`: Logs out the current user.
-   `POST /resetPassword`: Sends a password reset link to the user's email.

### General

-   `GET /`: Returns basic information about the logged-in user.
-   `GET /invite/:email`: Checks if an invitation exists for a given email.
-   `POST /changeProfile`: Changes the active profile for the logged-in user.
-   `POST /token`: Refreshes the push notification token for a profile.
-   `POST /subscribe`: Subscribes a profile to web push notifications.

### Profiles (`/user`)

-   `GET /mine`: Get all profiles for the logged-in user.
-   `POST /`: Creates a new profile.
-   `POST /invite`: Invites a new user by email.
-   `GET /invite/:email`: Get invitation details for an email.
-   `GET /groups`: Get a list of all groups.
-   `GET /groups/following`: Get a list of groups the current profile is following.
-   `POST /groups`: Create a new group.
-   `GET /courses`: Get a list of all courses.
-   `POST /groups/accept`: Accept a request to join a private group.
-   `POST /groups/reject`: Reject a request to join a private group.
-   `GET /groups/search`: Search for groups.
-   `GET /groups/:id`: Get details for a specific group.
-   `GET /groups/:id/subscribe`: Subscribe to a group.
-   `GET /groups/:id/unsubscribe`: Unsubscribe from a group.
-   `GET /search`: Search for profiles.
-   `POST /setData`: Set custom data for a profile.
-   `POST /myProfile`: Update the current user's profile.
-   `GET /:id`: Get a specific profile by ID.
-   `DELETE /:id`: Delete a profile.
-   `GET /:id/follow`: Follow a profile.
-   `GET /:id/unfollow`: Unfollow a profile.

### Posts (`/post`)

-   `GET /organic`: Get the organic feed for the current user.
-   `GET /`: Get the feed with promotional content.
-   `GET /tag/:tag`: Get posts with a specific tag.
-   `GET /usr/:id`: Get posts from a specific user.
-   `GET /usr/:id/images`: Get all image posts from a user.
-   `GET /usr/:id/embedded`: Get all embedded posts from a user.
-   `GET /usr/:id/media`: Get all media posts from a user.
-   `POST /`: Create a new post.
-   `POST /react`: React to a post.
-   `POST /unreact`: Remove a reaction from a post.
-   `POST /bookmark`: Bookmark a post.
-   `POST /unbookmark`: Remove a bookmark from a post.
-   `POST /comment`: Add a comment to a post.
-   `POST /comment/react`: React to a comment.
-   `POST /comment/unreact`: Remove a reaction from a comment.
-   `GET /images`: Get all image posts for the current user.
-   `GET /embedded`: Get all embedded posts for the current user.
-   `GET /media`: Get all media posts for the current user.
-   `GET /course/recent`: Get recently watched media from courses.
-   `GET /:id`: Get a specific post by ID.
-   `DELETE /:id`: Delete a post.
-   `POST /:id`: Update a post.

### Payments (`/payments`)

-   `POST /create-payment-intent`: Creates a Stripe Payment Intent.
-   `POST /intent`: (Alias for /create-payment-intent)
-   `POST /register`: Registers a payment after a successful Stripe transaction.

### Songs (`/songs`)

-   `GET /`: Get all songs.
-   `POST /`: Create a new song.
-   `GET /:id`: Get a specific song by ID.
-   `DELETE /:id`: Delete a song.
-   `POST /:id`: Update a song.

### Bible (`/bible`)

-   `GET /`: Get a list of available Bibles.
-   `GET /books`: Get the books of a Bible.
-   `GET /books/:bookId`: Get details for a specific book.
-   `GET /books/:bookId/chapters`: Get the chapters of a book.
-   `GET /chapters/:chapterId`: Get the content of a chapter.
-   `GET /chapters/:chapterId/verses`: Get the verses of a chapter.
-   `GET /search`: Search the Bible.

### Subsplash (`/subsplash`)

-   `GET /events/:calendarId`: Get events from a Subsplash calendar.
-   `GET /media/:seriesId`: Get media from a Subsplash media series.

### TODO

-   [ ] Define nodes schema
-   [ ] Implement basic login/registration