Prosjekt-2

backend/.env.example

@@ -1,2 +1,9 @@
-DATABASE_URL=postgresql://gameapp:<FYLL-INN-PASSORD>@localhost:5432/gamesdb
+# tunnel script env vars
+VM_USER=<ntnu-brukernavn>
+VM_HOST=it2810-02.idi.ntnu.no
+TUNNEL_PORT=5433
+
+# backend server env vars
+DATABASE_URL=postgresql://webapp:<PASSORD>@localhost:5433/gamesdb
 PORT=3001
+JWT_TOKEN=<server-rand-token>

backend/backend-api.md

@@ -0,0 +1,293 @@
+# Backend-API
+## Queries
+### game
+
+Henter informasjon om ett enkelt spill ved ID.
+
+```graphql
+game(id: ID!): Game
+```
+
+#### Argumenter
+
+| Navn | Type  | Default | Beskrivelse     |
+| ---- | ----- | ------- | --------------- |
+| `id` | `ID!` | —       | ID til spillet. |
+
+#### Returnerer
+
+[`Game`](#game-1). Returnerer `null` hvis spillet ikke finnes eller id-en er ugyldig.
+
+#### Eksempel
+
+```graphql
+{
+  game(id: "3498") {
+    name
+    esrbRating
+    genres { name }
+  }
+}
+```
+
+```json
+{
+  "data": {
+    "game": {
+      "name": "Grand Theft Auto V",
+      "esrbRating": "Mature",
+      "genres": [{ "name": "Action" }]
+    }
+  }
+}
+```
+
+---
+
+### games
+
+Henter en side med spill, med valgfritt søk og filtre. Resultatet er sortert etter popularitet.
+
+```graphql
+games(search: String, filter: GameFilter, first: Int = 20): GameConnection!
+```
+
+#### Argumenter
+
+| Navn     | Type                        | Default | Beskrivelse                                                                                   |
+| -------- | --------------------------- | ------- | --------------------------------------------------------------------------------------------- |
+| `search` | `String`                    | —       | Søk i tittel og alternative navn. Skiller ikke mellom store og små bokstaver, og matcher deler av navnet. |
+| `filter` | [`GameFilter`](#gamefilter) | —       | Filtrering på sjanger, plattform og utgivelsesår.                                             |
+| `first`  | `Int`                       | `20`    | Antall spill på siden. Begrenset til 1–50.                                                    |
+
+Alle argumenter er valgfrie og kan kombineres.
+
+#### Returnerer
+
+[`GameConnection`](#gameconnection) med spillene på siden og totalt antall treff.
+
+#### Eksempel: søk
+
+```graphql
+{
+  games(search: "zelda", first: 3) {
+    totalCount
+    edges { node { name } }
+  }
+}
+```
+
+```json
+{
+  "data": {
+    "games": {
+      "totalCount": 55,
+      "edges": [
+        { "node": { "name": "The Legend of Zelda: Breath of the Wild" } },
+        { "node": { "name": "The Legend of Zelda: Ocarina of Time" } },
+        { "node": { "name": "The Legend of Zelda: Tears of the Kingdom" } }
+      ]
+    }
+  }
+}
+```
+
+#### Eksempel: filtre
+
+Action- og RPG-spill på PC, utgitt 2015–2020:
+
+```graphql
+{
+  games(
+    filter: { genreIds: ["1", "14"], platformIds: ["9"], releasedFrom: 2015, releasedTo: 2020 }
+    first: 3
+  ) {
+    totalCount
+    edges { node { name released } }
+  }
+}
+```
+
+```json
+{
+  "data": {
+    "games": {
+      "totalCount": 2006,
+      "edges": [
+        { "node": { "name": "The Witcher 3: Wild Hunt", "released": "2015-05-18" } },
+        { "node": { "name": "Fallout 4", "released": "2015-11-09" } },
+        { "node": { "name": "Cyberpunk 2077", "released": "2020-12-10" } }
+      ]
+    }
+  }
+}
+```
+
+---
+
+### genres
+
+Henter alle sjangre, sortert alfabetisk.
+
+```graphql
+genres: [Facet!]!
+```
+
+#### Argumenter
+
+Ingen.
+
+#### Returnerer
+
+Liste med [`Facet`](#facet).
+
+#### Eksempel
+
+```graphql
+{
+  genres { id name }
+}
+```
+
+```json
+{
+  "data": {
+    "genres": [
+      { "id": "1", "name": "Action" },
+      { "id": "2", "name": "Adventure" },
+      { "id": "3", "name": "Arcade" }
+    ]
+  }
+}
+```
+
+---
+
+### platforms
+
+Henter alle plattformfamilier (PC, PlayStation, Xbox, …), sortert alfabetisk.
+
+```graphql
+platforms: [Facet!]!
+```
+
+#### Argumenter
+
+Ingen.
+
+#### Returnerer
+
+Liste med [`Facet`](#facet).
+
+Merk: ID-ene her er plattformfamilier og er ikke de samme som ID-ene i `Game.platforms`, som er enkeltkonsoller.
+
+#### Eksempel
+
+```graphql
+{
+  platforms { id name }
+}
+```
+
+```json
+{
+  "data": {
+    "platforms": [
+      { "id": "9", "name": "PC" },
+      { "id": "10", "name": "PlayStation" },
+      { "id": "13", "name": "Xbox" }
+    ]
+  }
+}
+```
+
+## Mutations
+> Dette skal legges til når funksjonalitet for brukere blir lagt til
+
+## Types
+### Game
+
+Et spill med detaljer og relasjoner.
+
+| Felt                        | Type                | Beskrivelse                                                       |
+| --------------------------- | ------------------- | ----------------------------------------------------------------- |
+| `id`                        | `ID!`               | ID til spillet.                                                   |
+| `name`                      | `String!`           | Tittel.                                                           |
+| `description`               | `String`            | Beskrivelse i ren tekst.                                          |
+| `released`                  | `String`            | Utgivelsesdato, `YYYY-MM-DD`.                                     |
+| `website`                   | `String`            | Offisiell nettside.                                               |
+| `added`                     | `Int!`              | Antall RAWG-brukere som har lagt spillet til i en liste. Brukes som mål på popularitet. |
+| `metacritic`                | `Int`               | Metacritic-score, 0–100.                                          |
+| `esrbRating`                | `String`            | Amerikansk aldersgrense, f.eks. `Mature`.                         |
+| `dominantColor`             | `String`            | Hovedfargen i forsidebildet som hex, f.eks. `0f0f0f`.             |
+| `backgroundImage`           | `String`            | URL til forsidebildet.                                            |
+| `backgroundImageAdditional` | `String`            | URL til et ekstra bilde.                                          |
+| `screenshots`               | `[String!]!`        | URL-er til skjermbilder. Tom liste hvis ingen.                    |
+| `genres`                    | [`[Facet!]!`](#facet) | Sjangre.                                                        |
+| `platforms`                 | [`[Facet!]!`](#facet) | Enkeltkonsoller, f.eks. PlayStation 4.                          |
+| `stores`                    | [`[Facet!]!`](#facet) | Butikker spillet selges i.                                      |
+| `developers`                | [`[Facet!]!`](#facet) | Utviklere.                                                      |
+| `publishers`                | [`[Facet!]!`](#facet) | Utgivere.                                                       |
+| `tags`                      | [`[Facet!]!`](#facet) | Tagger fra RAWG, f.eks. Open World.                             |
+
+Relasjonene returnerer en tom liste hvis spillet ikke har noen.
+
+---
+
+### Facet
+
+Felles type for sjangre, plattformer, butikker, utviklere, utgivere og tagger.
+
+| Felt   | Type      | Beskrivelse |
+| ------ | --------- | ----------- |
+| `id`   | `ID!`     | ID.         |
+| `name` | `String!` | Navn.       |
+
+---
+
+### GameConnection
+
+Resultatet av [`games`](#games). Følger Relay-mønsteret for paginering (se [dokumentasjon](https://graphql.org/learn/pagination/)).
+
+| Felt         | Type                        | Beskrivelse                                         |
+| ------------ | --------------------------- | --------------------------------------------------- |
+| `edges`      | [`[GameEdge!]!`](#gameedge) | Spillene på denne siden.                            |
+| `pageInfo`   | [`PageInfo!`](#pageinfo)    | Informasjon for å hente neste side.                 |
+| `totalCount` | `Int!`                      | Totalt antall spill som matcher søk og filtre.      |
+
+---
+
+### GameEdge
+
+Ett spill i en [`GameConnection`](#gameconnection).
+
+| Felt     | Type                 | Beskrivelse                          |
+| -------- | -------------------- | ------------------------------------ |
+| `node`   | [`Game!`](#game-1)   | Spillet.                             |
+| `cursor` | `String!`            | Posisjonen til spillet i listen.     |
+
+---
+
+### PageInfo
+
+| Felt          | Type       | Beskrivelse                                                   |
+| ------------- | ---------- | ------------------------------------------------------------- |
+| `hasNextPage` | `Boolean!` | `true` hvis det finnes flere spill etter denne siden.         |
+| `endCursor`   | `String`   | Cursor til siste spill på siden. Sendes som `after` for neste side. |
+
+---
+
+### GameFilter
+
+Input-type for filtrering i [`games`](#games). Alle felt er valgfrie.
+
+| Felt           | Type     | Beskrivelse                                                                    |
+| -------------- | -------- | ------------------------------------------------------------------------------ |
+| `genreIds`     | `[ID!]`  | Spill som har **alle** de valgte sjangrene. ID-er fra [`genres`](#genres).     |
+| `platformIds`  | `[ID!]`  | Spill på **minst én** av de valgte plattformfamiliene. ID-er fra [`platforms`](#platforms). |
+| `releasedFrom` | `Int`    | Utgitt dette året eller senere, f.eks. `2015`.                                 |
+| `releasedTo`   | `Int`    | Utgitt dette året eller tidligere, f.eks. `2020`.                              |
+
+Merk: Spill uten utgivelsesdato utelates når `releasedFrom` eller `releasedTo` er satt. ID-er som ikke er tall ignoreres.
+
+

backend/package.json

@@ -3,16 +3,17 @@
   "version": "1.0.0",
   "description": "",
   "main": "index.js",
+  "type": "module",
   "scripts": {
-    "dev": "tsx watch src/index.ts",
+    "dev": "tsx watch --env-file=.env src/index.ts",
+    "compile": "tsc",
     "build": "tsc",
-    "start": "node dist/index.js",
+    "start": "pnpm run build && node dist/index.js",
     "lint": "eslint ."
   },
   "keywords": [],
   "author": "",
   "license": "ISC",
-  "type": "module",
   "dependencies": {
     "@apollo/server": "^5.5.1",
     "dotenv": "^18.0.5",

backend/src/auth.ts

@@ -0,0 +1,3 @@
+
+// server jwt secret
+// const secret = process.env.JWT_SECRET;

backend/src/db.ts

@@ -0,0 +1,7 @@
+import pg from 'pg';
+
+const url = process.env.DATABASE_URL;
+if (!url) throw new Error("DATABASE_URL not set in .env ...")
+
+//pg pool
+export const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL})

backend/src/index.ts

@@ -1,2 +1,21 @@
-// placeholder, erstattes av apollo server senere
-console.log('backend');
+import { ApolloServer } from "@apollo/server";
+import { startStandaloneServer } from "@apollo/server/standalone";
+import { pool } from './db.js';
+import { typeDefs } from './schema.js';
+import { resolvers } from './resolvers.js';
+
+// apollo-server port number [default port 3001] 
+const port = Number(process.env.PORT ?? 3001)
+
+// tester db tilkobling med en query
+await pool.query('SELECT 1');
+
+// apollo server instance
+const server = new ApolloServer({ typeDefs, resolvers });
+
+// pass apolloserver to standaloneserver
+const { url } = await startStandaloneServer(server, {
+    listen: { port },
+});
+
+console.log(`Server ready at: ${url}`);