Merge branch 'cursor/verhalenboek-app-f4e7' into 'master'
Verhalenboek: dagen met drie verhalen, leesvoortgang en schrijf-API See merge request Timfa/Verhalenboek!1
@@ -0,0 +1,10 @@
1
# Serverconfiguratie, database, sessies en runtimebestanden.
2
/web/data/*
3
!/web/data/.htaccess
4
!/web/data/.gitkeep
5
/web/tests/artifacts/
6
__pycache__/
7
*.py[cod]
8
9
# Geschreven bij deploy vanuit CI_COMMIT_SHA, voor cache-busting.
10
/web/asset-version.txt
@@ -0,0 +1,10 @@1
# Serverconfiguratie, database, sessies en runtimebestanden.2
/web/data/*3
!/web/data/.htaccess4
!/web/data/.gitkeep5
/web/tests/artifacts/6
__pycache__/7
*.py[cod]8
9
# Geschreven bij deploy vanuit CI_COMMIT_SHA, voor cache-busting.10
/web/asset-version.txt@@ -0,0 +1,47 @@
1
stages:
2
- test
3
- deploy
4
5
php_tests:
6
stage: test
7
image: php:8.3-cli-bookworm
8
before_script:
9
- apt-get update -qq
10
- apt-get install -y --no-install-recommends python3 libonig-dev
11
- docker-php-ext-install mbstring
12
script:
13
- find web -name '*.php' -not -path '*/artifacts/*' -print0 | xargs -0 -n1 php -l
14
- php -r 'foreach (["pdo_sqlite", "curl", "mbstring", "openssl"] as $extension) { if (!extension_loaded($extension)) { fwrite(STDERR, "Missing extension " . $extension); exit(1); } }'
15
- php web/tests/storybook.php
16
- python3 web/tests/startup.py
17
- python3 web/tests/integration.py
18
19
frontend_checks:
20
stage: test
21
image: node:22-bookworm-slim
22
script:
23
- node --check web/assets/app.js
24
25
# A real FTP fixture verifies that mirroring preserves production data and secrets.
26
deploy_tests:
27
stage: test
28
image: debian:bookworm-slim
29
before_script:
30
- apt-get update -qq
31
- apt-get install -y --no-install-recommends python3 python3-pyftpdlib lftp ca-certificates openssh-client
32
script:
33
- python3 ci/test_deploy.py
34
35
ftp_upload:
36
stage: deploy
37
image: debian:bookworm-slim
38
resource_group: production
39
environment:
40
name: production
41
rules:
42
- if: '$CI_COMMIT_BRANCH == "master"'
43
before_script:
44
- apt-get update -qq
45
- apt-get install -y --no-install-recommends python3 lftp ca-certificates openssh-client
46
script:
47
- python3 ci/deploy.py
@@ -0,0 +1,47 @@1
stages:2
- test3
- deploy4
5
php_tests:6
stage: test7
image: php:8.3-cli-bookworm8
before_script:9
- apt-get update -qq10
- apt-get install -y --no-install-recommends python3 libonig-dev11
- docker-php-ext-install mbstring12
script:13
- find web -name '*.php' -not -path '*/artifacts/*' -print0 | xargs -0 -n1 php -l14
- php -r 'foreach (["pdo_sqlite", "curl", "mbstring", "openssl"] as $extension) { if (!extension_loaded($extension)) { fwrite(STDERR, "Missing extension " . $extension); exit(1); } }'15
- php web/tests/storybook.php16
- python3 web/tests/startup.py17
- python3 web/tests/integration.py18
19
frontend_checks:20
stage: test21
image: node:22-bookworm-slim22
script:23
- node --check web/assets/app.js24
25
# A real FTP fixture verifies that mirroring preserves production data and secrets.26
deploy_tests:27
stage: test28
image: debian:bookworm-slim29
before_script:30
- apt-get update -qq31
- apt-get install -y --no-install-recommends python3 python3-pyftpdlib lftp ca-certificates openssh-client32
script:33
- python3 ci/test_deploy.py34
35
ftp_upload:36
stage: deploy37
image: debian:bookworm-slim38
resource_group: production39
environment:40
name: production41
rules:42
- if: '$CI_COMMIT_BRANCH == "master"'43
before_script:44
- apt-get update -qq45
- apt-get install -y --no-install-recommends python3 lftp ca-certificates openssh-client46
script:47
- python3 ci/deploy.py@@ -1,3 +1,130 @@
1
1
# Verhalenboek
2
2
3
Verhalenboek: dagen met elk drie verhalen, login via auth.timfalken.com.
3
Een verhalenboek: elke kalenderdag heeft een titel en precies drie verhalen. Lezers zien wat ze al gelezen hebben. Een beheerder vult het boek, met de hand of via een API-sleutel. Inloggen gaat via [auth.timfalken.com](https://auth.timfalken.com).
4
5
De applicatie staat in [`web/`](web/). Lokaal:
6
7
```sh
8
php -S 127.0.0.1:8080 -t web web/router.php
9
```
10
11
Open http://127.0.0.1:8080. Je bent automatisch `test_user_1` en daarmee beheerder. Onder Instellingen wissel je naar `test_user_2`, een gewone lezer.
12
13
## Publieke URL
14
15
Microchess staat op `https://projects.timfalken.com/microchess` omdat die map de FTP-map onder de site `projects.timfalken.com` is. Hier is de CI-variabele `projectftp` gelijk aan `$timftproot/verhaaltjesboek`. Dezelfde afleiding geeft:
16
17
**https://projects.timfalken.com/verhaaltjesboek**
18
19
## Wat Tim moet instellen
20
21
Deploy naar `master` zet de code op de server, maar raakt `data/` niet aan. Daarin blijven de database, sessies en het geheim staan. Bij de eerste paginabezoek maakt de app `data/config.php` aan als dat bestand er nog niet is. Een bestaand bestand wordt nooit overschreven.
22
23
1. Zet de code op `master` (de pipeline test eerst, en uploadt daarna alleen bij een groene `master`).
24
2. Open eenmaal https://projects.timfalken.com/verhaaltjesboek zodat `data/config.php` ontstaat. Het bestand staat op de server in de FTP-map `verhaaltjesboek/data/config.php` (`projectftp` + `/data/config.php`).
25
3. Registreer bij https://auth.timfalken.com/admin het callback-pad op het domein `projects.timfalken.com`:
26
- **client_id:** `projects.timfalken.com` (het domein van de publieke URL, hetzelfde domein als microchess)
27
- **callback-pad:** `/verhaaltjesboek/callback.php`
28
- Voeg alleen dat pad toe. Genereer het clientgeheim niet opnieuw als microchess hetzelfde domein al gebruikt: een nieuw geheim maakt de andere site stuk. Kopieer het bestaande geheim.
29
4. Vul op de server `data/config.php` in. Dit bestand wordt niet gecommit en niet geüpload. Laat `key_secret` staan: die maakt de app zelf aan (64 hexadecimale tekens) en versleutelt daarmee API-sleutels, zodat een beheerder ze later opnieuw kan tonen. Ontbreekt hij, dan vult de app hem één keer aan zonder de andere velden te wissen.
30
31
```php
32
<?php
33
return [
34
'base_url' => 'https://projects.timfalken.com/verhaaltjesboek',
35
'client_id' => 'projects.timfalken.com',
36
'client_secret' => 'het-geheim-uit-admin',
37
'key_secret' => 'blijft-de-gegenereerde-waarde',
38
];
39
```
40
41
Lege velden voor URL en client vallen terug op `VERHALENBOEK_BASE_URL`, `VERHALENBOEK_CLIENT_ID` en `VERHALENBOEK_CLIENT_SECRET`. Een ingevuld veld wint van de omgeving. `base_url` mag een submap bevatten en heeft geen slash aan het eind. `key_secret` komt niet uit de omgeving.
42
43
5. Log als eerste zelf in. Die eerste gebruiker wordt beheerder. Iedereen daarna is lezer. Het account-id en de gebruikersnaam komen uit `/api/me`. E-mail wordt niet gelezen en niet opgeslagen.
44
6. Maak onder **Sleutels** een API-sleutel voor de schrijver-agent. De volledige sleutel (`vb_…`) verschijnt meteen, en daarna opnieuw als je op die sleutel tikt. Alleen een ingelogde beheerder ziet dat; de lijst en de export tonen alleen het voorvoegsel.
45
46
De OAuth-flow is dezelfde als bij microchess: `state`, code wisselen op de server via `POST /oauth/token`, daarna `GET /api/me`, verlengen via `POST /api/session/extend`, en afmelden via `POST /api/logout`. Het bearer-token van het account blijft in de PHP-sessie en komt niet in JavaScript.
47
48
## Leesstatus
49
50
Een dag wordt gelezen zodra de dagpagina opent, niet pas onderaan. Korte verhalen passen vaak op één scherm, dus "onderaan" is dan hetzelfde als openen, of het gebeurt juist nooit. Opnieuw openen houdt de dag gelezen. Per ongeluk geopend? Houd de dag in het overzicht ingedrukt (telefoon) of klik met de rechtermuisknop (desktop) en kies ongelezen. Het standaardmenu en tekstselectie blijven tijdens die handeling uit.
51
52
**Verderlezen** opent de vroegste ongelezen dag. Standaard volgen kleuren het systeem; het lettertype is een serif. Licht, donker, serif, schreefloos en rond worden per gebruiker op de server bewaard.
53
54
## API
55
56
Schrijven kan met een Bearer-sleutel of, in de browser, als beheerder. Een volledige dag heeft precies drie verhalen, elk met een titel en minstens één alinea. De volgorde in de lijst is plek 1, 2 en 3.
57
58
`GET /api.php/days/latest` is de nieuwste datum die nog een dagrecord heeft, ook als daar een verhaal uit verwijderd is (`complete` is dan `false`). Ontbreekt er nog niets, dan is het antwoord 404.
59
60
`GET /api.php/days/gaps` geeft, tussen de eerste en de laatste dag:
61
62
- `missing`: kalenderdagen zonder dagrecord (verwijderd of nooit geschreven)
63
- `incomplete`: dagen die bestaan maar geen drie verhalen meer hebben, met `missingPositions`
64
65
Een onvolledige dag staat niet óók in `missing`. Staat een datum in `missing`, maak hem met POST. Staat hij in `incomplete`, vul de plek of vervang de dag met PUT en precies drie verhalen.
66
67
```sh
68
curl -sS -X POST \
69
-H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
70
-H 'Accept: application/json' \
71
-H 'Content-Type: application/json' \
72
-d '{"date":"2026-10-05","title":"De herfstwind","stories":[
73
{"title":"Ochtend","paragraphs":["De wind stond al vroeg aan de deur."]},
74
{"title":"Middag","paragraphs":["Op het plein joeg een krant zichzelf achterna."]},
75
{"title":"Avond","paragraphs":["Het licht in de keuken bleef aan."]}
76
]}' \
77
'https://projects.timfalken.com/verhaaltjesboek/api.php/days'
78
79
curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
80
'https://projects.timfalken.com/verhaaltjesboek/api.php/days/latest'
81
82
curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
83
'https://projects.timfalken.com/verhaaltjesboek/api.php/days/gaps'
84
```
85
86
| Methode | Pad | Betekenis |
87
| --- | --- | --- |
88
| GET | `/days` | Dagen, oudste eerst. Een ingelogde lezer ziet ook `read`. |
89
| GET | `/days/latest` | Nieuwste geschreven datum. |
90
| GET | `/days/gaps` | Gaten en onvolledige dagen. |
91
| GET | `/days/JJJJ-MM-DD` | Dag, verhalen, `previous` en `next`. |
92
| POST | `/days` | Nieuwe dag met precies drie verhalen. 201, of 409 als de datum bezet is. |
93
| PUT | `/days/JJJJ-MM-DD` | Titel en/of vervanging door precies drie verhalen. |
94
| DELETE | `/days/JJJJ-MM-DD` | Dag weg. |
95
| POST | `/days/JJJJ-MM-DD/stories` | Verhaal erbij zolang er minder dan drie zijn. |
96
| PUT | `/days/JJJJ-MM-DD/stories/1` | Plek 1, 2 of 3 bijwerken. |
97
| DELETE | `/days/JJJJ-MM-DD/stories/2` | Eén verhaal weg; de andere plekken blijven. |
98
| POST / DELETE | `/days/JJJJ-MM-DD/read` | Alleen een ingelogde lezer. |
99
| PUT | `/me/settings` | `theme`: `system`, `light` of `dark`. `font`: `serif`, `sans` of `rounded`. |
100
| GET | `/me/export` | Eigen gegevens als JSON. |
101
102
Fouten zijn `{"error":"…"}`. Validatie die de drie-verhalenregel raakt geeft 422. De menselijke uitleg met dezelfde voorbeelden staat op `docs.php`.
103
104
Een 401 (geen header, verkeerd formaat, of een onbekende/ingetrokken sleutel) zet `WWW-Authenticate: Bearer` en voegt `how_to_authenticate` toe, met dezelfde tekst in `hint`. Die tekst noemt het geval, de header `Authorization: Bearer vb_…`, Sleutels op `{base_url}/#/sleutels`, en een link naar `docs.php`. Een 403 omdat een lezer iets doet dat een sleutel of beheerder vereist, heeft die uitleg ook, zonder `WWW-Authenticate`. Sleutels zelf beheren kan alleen in de beheerderssessie. Een 403 door een ongeldige CSRF-header blijft alleen `{"error":"…"}`.
105
106
```sh
107
curl -sS -D - -o - \
108
'https://projects.timfalken.com/verhaaltjesboek/api.php/days/latest'
109
```
110
111
`GET /api.php/keys/{id}` geeft de volledige sleutel terug aan een ingelogde beheerder. Opzoeken bij een verzoek blijft een hash op `token_hash`.
112
113
## Deploy
114
115
`.gitlab-ci.yml` is die van microchess: PHP-syntax, domeintests, API-tests, een JavaScript-syntaxcheck, en een echte FTP-fixture. Alleen `master` uploadt, en nooit tegelijk met een andere productie-deploy. [`ci/deploy.py`](ci/deploy.py) spiegelt `web/` met lftp en slaat `data/` (database, WAL, `config.php`, sessies) over, zowel bij upload als bij verwijderen. `data/.htaccess` wordt apart gezet. `tests/`, `router.php` en `README.md` gaan niet mee.
116
117
Benodigde CI-variabelen, al aanwezig in dit project: `timftphost`, `timftpuser`, `timftppassword`, `timftproot`, `projectftp` (`$timftproot/verhaaltjesboek`).
118
119
## Tests
120
121
```sh
122
find web -name '*.php' -not -path '*/artifacts/*' -print0 | xargs -0 -n1 php -l
123
php web/tests/storybook.php
124
python3 web/tests/startup.py
125
python3 web/tests/integration.py
126
node --check web/assets/app.js
127
python3 ci/test_deploy.py
128
```
129
130
De API-tests draaien een kopie onder `web/tests/artifacts/` en laten de echte database met rust.
@@ -1,3 +1,130 @@1
# Verhalenboek1
# Verhalenboek2
2
3
Verhalenboek: dagen met elk drie verhalen, login via auth.timfalken.com.3
Een verhalenboek: elke kalenderdag heeft een titel en precies drie verhalen. Lezers zien wat ze al gelezen hebben. Een beheerder vult het boek, met de hand of via een API-sleutel. Inloggen gaat via [auth.timfalken.com](https://auth.timfalken.com).4
5
De applicatie staat in [`web/`](web/). Lokaal:6
7
```sh8
php -S 127.0.0.1:8080 -t web web/router.php9
```10
11
Open http://127.0.0.1:8080. Je bent automatisch `test_user_1` en daarmee beheerder. Onder Instellingen wissel je naar `test_user_2`, een gewone lezer.12
13
## Publieke URL14
15
Microchess staat op `https://projects.timfalken.com/microchess` omdat die map de FTP-map onder de site `projects.timfalken.com` is. Hier is de CI-variabele `projectftp` gelijk aan `$timftproot/verhaaltjesboek`. Dezelfde afleiding geeft:16
17
**https://projects.timfalken.com/verhaaltjesboek**18
19
## Wat Tim moet instellen20
21
Deploy naar `master` zet de code op de server, maar raakt `data/` niet aan. Daarin blijven de database, sessies en het geheim staan. Bij de eerste paginabezoek maakt de app `data/config.php` aan als dat bestand er nog niet is. Een bestaand bestand wordt nooit overschreven.22
23
1. Zet de code op `master` (de pipeline test eerst, en uploadt daarna alleen bij een groene `master`).24
2. Open eenmaal https://projects.timfalken.com/verhaaltjesboek zodat `data/config.php` ontstaat. Het bestand staat op de server in de FTP-map `verhaaltjesboek/data/config.php` (`projectftp` + `/data/config.php`).25
3. Registreer bij https://auth.timfalken.com/admin het callback-pad op het domein `projects.timfalken.com`:26
- **client_id:** `projects.timfalken.com` (het domein van de publieke URL, hetzelfde domein als microchess)27
- **callback-pad:** `/verhaaltjesboek/callback.php`28
- Voeg alleen dat pad toe. Genereer het clientgeheim niet opnieuw als microchess hetzelfde domein al gebruikt: een nieuw geheim maakt de andere site stuk. Kopieer het bestaande geheim.29
4. Vul op de server `data/config.php` in. Dit bestand wordt niet gecommit en niet geüpload. Laat `key_secret` staan: die maakt de app zelf aan (64 hexadecimale tekens) en versleutelt daarmee API-sleutels, zodat een beheerder ze later opnieuw kan tonen. Ontbreekt hij, dan vult de app hem één keer aan zonder de andere velden te wissen.30
31
```php32
<?php33
return [34
'base_url' => 'https://projects.timfalken.com/verhaaltjesboek',35
'client_id' => 'projects.timfalken.com',36
'client_secret' => 'het-geheim-uit-admin',37
'key_secret' => 'blijft-de-gegenereerde-waarde',38
];39
```40
41
Lege velden voor URL en client vallen terug op `VERHALENBOEK_BASE_URL`, `VERHALENBOEK_CLIENT_ID` en `VERHALENBOEK_CLIENT_SECRET`. Een ingevuld veld wint van de omgeving. `base_url` mag een submap bevatten en heeft geen slash aan het eind. `key_secret` komt niet uit de omgeving.42
43
5. Log als eerste zelf in. Die eerste gebruiker wordt beheerder. Iedereen daarna is lezer. Het account-id en de gebruikersnaam komen uit `/api/me`. E-mail wordt niet gelezen en niet opgeslagen.44
6. Maak onder **Sleutels** een API-sleutel voor de schrijver-agent. De volledige sleutel (`vb_…`) verschijnt meteen, en daarna opnieuw als je op die sleutel tikt. Alleen een ingelogde beheerder ziet dat; de lijst en de export tonen alleen het voorvoegsel.45
46
De OAuth-flow is dezelfde als bij microchess: `state`, code wisselen op de server via `POST /oauth/token`, daarna `GET /api/me`, verlengen via `POST /api/session/extend`, en afmelden via `POST /api/logout`. Het bearer-token van het account blijft in de PHP-sessie en komt niet in JavaScript.47
48
## Leesstatus49
50
Een dag wordt gelezen zodra de dagpagina opent, niet pas onderaan. Korte verhalen passen vaak op één scherm, dus "onderaan" is dan hetzelfde als openen, of het gebeurt juist nooit. Opnieuw openen houdt de dag gelezen. Per ongeluk geopend? Houd de dag in het overzicht ingedrukt (telefoon) of klik met de rechtermuisknop (desktop) en kies ongelezen. Het standaardmenu en tekstselectie blijven tijdens die handeling uit.51
52
**Verderlezen** opent de vroegste ongelezen dag. Standaard volgen kleuren het systeem; het lettertype is een serif. Licht, donker, serif, schreefloos en rond worden per gebruiker op de server bewaard.53
54
## API55
56
Schrijven kan met een Bearer-sleutel of, in de browser, als beheerder. Een volledige dag heeft precies drie verhalen, elk met een titel en minstens één alinea. De volgorde in de lijst is plek 1, 2 en 3.57
58
`GET /api.php/days/latest` is de nieuwste datum die nog een dagrecord heeft, ook als daar een verhaal uit verwijderd is (`complete` is dan `false`). Ontbreekt er nog niets, dan is het antwoord 404.59
60
`GET /api.php/days/gaps` geeft, tussen de eerste en de laatste dag:61
62
- `missing`: kalenderdagen zonder dagrecord (verwijderd of nooit geschreven)63
- `incomplete`: dagen die bestaan maar geen drie verhalen meer hebben, met `missingPositions`64
65
Een onvolledige dag staat niet óók in `missing`. Staat een datum in `missing`, maak hem met POST. Staat hij in `incomplete`, vul de plek of vervang de dag met PUT en precies drie verhalen.66
67
```sh68
curl -sS -X POST \69
-H 'Authorization: Bearer vb_JOUW_SLEUTEL' \70
-H 'Accept: application/json' \71
-H 'Content-Type: application/json' \72
-d '{"date":"2026-10-05","title":"De herfstwind","stories":[73
{"title":"Ochtend","paragraphs":["De wind stond al vroeg aan de deur."]},74
{"title":"Middag","paragraphs":["Op het plein joeg een krant zichzelf achterna."]},75
{"title":"Avond","paragraphs":["Het licht in de keuken bleef aan."]}76
]}' \77
'https://projects.timfalken.com/verhaaltjesboek/api.php/days'78
79
curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \80
'https://projects.timfalken.com/verhaaltjesboek/api.php/days/latest'81
82
curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \83
'https://projects.timfalken.com/verhaaltjesboek/api.php/days/gaps'84
```85
86
| Methode | Pad | Betekenis |87
| --- | --- | --- |88
| GET | `/days` | Dagen, oudste eerst. Een ingelogde lezer ziet ook `read`. |89
| GET | `/days/latest` | Nieuwste geschreven datum. |90
| GET | `/days/gaps` | Gaten en onvolledige dagen. |91
| GET | `/days/JJJJ-MM-DD` | Dag, verhalen, `previous` en `next`. |92
| POST | `/days` | Nieuwe dag met precies drie verhalen. 201, of 409 als de datum bezet is. |93
| PUT | `/days/JJJJ-MM-DD` | Titel en/of vervanging door precies drie verhalen. |94
| DELETE | `/days/JJJJ-MM-DD` | Dag weg. |95
| POST | `/days/JJJJ-MM-DD/stories` | Verhaal erbij zolang er minder dan drie zijn. |96
| PUT | `/days/JJJJ-MM-DD/stories/1` | Plek 1, 2 of 3 bijwerken. |97
| DELETE | `/days/JJJJ-MM-DD/stories/2` | Eén verhaal weg; de andere plekken blijven. |98
| POST / DELETE | `/days/JJJJ-MM-DD/read` | Alleen een ingelogde lezer. |99
| PUT | `/me/settings` | `theme`: `system`, `light` of `dark`. `font`: `serif`, `sans` of `rounded`. |100
| GET | `/me/export` | Eigen gegevens als JSON. |101
102
Fouten zijn `{"error":"…"}`. Validatie die de drie-verhalenregel raakt geeft 422. De menselijke uitleg met dezelfde voorbeelden staat op `docs.php`.103
104
Een 401 (geen header, verkeerd formaat, of een onbekende/ingetrokken sleutel) zet `WWW-Authenticate: Bearer` en voegt `how_to_authenticate` toe, met dezelfde tekst in `hint`. Die tekst noemt het geval, de header `Authorization: Bearer vb_…`, Sleutels op `{base_url}/#/sleutels`, en een link naar `docs.php`. Een 403 omdat een lezer iets doet dat een sleutel of beheerder vereist, heeft die uitleg ook, zonder `WWW-Authenticate`. Sleutels zelf beheren kan alleen in de beheerderssessie. Een 403 door een ongeldige CSRF-header blijft alleen `{"error":"…"}`.105
106
```sh107
curl -sS -D - -o - \108
'https://projects.timfalken.com/verhaaltjesboek/api.php/days/latest'109
```110
111
`GET /api.php/keys/{id}` geeft de volledige sleutel terug aan een ingelogde beheerder. Opzoeken bij een verzoek blijft een hash op `token_hash`.112
113
## Deploy114
115
`.gitlab-ci.yml` is die van microchess: PHP-syntax, domeintests, API-tests, een JavaScript-syntaxcheck, en een echte FTP-fixture. Alleen `master` uploadt, en nooit tegelijk met een andere productie-deploy. [`ci/deploy.py`](ci/deploy.py) spiegelt `web/` met lftp en slaat `data/` (database, WAL, `config.php`, sessies) over, zowel bij upload als bij verwijderen. `data/.htaccess` wordt apart gezet. `tests/`, `router.php` en `README.md` gaan niet mee.116
117
Benodigde CI-variabelen, al aanwezig in dit project: `timftphost`, `timftpuser`, `timftppassword`, `timftproot`, `projectftp` (`$timftproot/verhaaltjesboek`).118
119
## Tests120
121
```sh122
find web -name '*.php' -not -path '*/artifacts/*' -print0 | xargs -0 -n1 php -l123
php web/tests/storybook.php124
python3 web/tests/startup.py125
python3 web/tests/integration.py126
node --check web/assets/app.js127
python3 ci/test_deploy.py128
```129
130
De API-tests draaien een kopie onder `web/tests/artifacts/` en laten de echte database met rust.@@ -0,0 +1,81 @@
1
#!/usr/bin/env python3
2
"""Deploy only web/, preserving server-owned data. Passwords never enter argv."""
3
import os
4
from pathlib import Path
5
import subprocess
6
import sys
7
from urllib.parse import urlsplit
8
9
ROOT = Path(__file__).resolve().parents[1]
10
11
def quoted(value):
12
if any(c in value for c in '\r\n\x00'):
13
raise ValueError('Deployment variables must not contain line breaks or NUL bytes.')
14
return '"' + value.replace('\\', '\\\\').replace('"', '\\"') + '"'
15
16
def deployment_commands(environ, webroot):
17
for key in ['timftphost', 'timftpuser', 'timftppassword', 'projectftp']:
18
if not environ.get(key):
19
raise ValueError(f'CI variable {key} is not set.')
20
host = environ['timftphost']
21
if '://' not in host:
22
host = 'ftp://' + host
23
parsed = urlsplit(host)
24
if parsed.scheme not in ['ftp', 'ftps', 'sftp'] or not parsed.hostname:
25
raise ValueError('timftphost must be an FTP, FTPS or SFTP host URL.')
26
if parsed.username or parsed.password or parsed.query or parsed.fragment:
27
raise ValueError('Keep login credentials in timftpuser/timftppassword; use a plain host URL.')
28
commands = [
29
'set cmd:fail-exit yes',
30
'set net:timeout 20',
31
'set net:max-retries 2',
32
'set net:reconnect-interval-base 3',
33
# This hosting account uses a mismatched FTP certificate; retain the owner's deployment policy.
34
'set ssl:verify-certificate no',
35
'set ftp:list-options -a',
36
# New SFTP hosts are remembered within this runner; changed host keys fail.
37
'set sftp:connect-program "ssh -a -x -o StrictHostKeyChecking=accept-new"',
38
f'open --user {quoted(environ["timftpuser"])} --env-password {quoted(host)}',
39
f'cd {quoted(environ["projectftp"])}',
40
'mkdir -p data || echo "Using existing data directory"',
41
f'put {quoted(str(webroot / "data/.htaccess"))} -o data/.htaccess',
42
# No --delete-excluded: these paths belong to the running server.
43
'mirror --reverse --delete --no-perms --no-symlinks --max-errors=1 '
44
'--exclude-glob "data/" --exclude-glob "data/**" '
45
'--exclude-glob "tests/" --exclude-glob "tests/**" '
46
'--exclude-glob "README.md" --exclude-glob "router.php" '
47
f'{quoted(str(webroot))} .',
48
'bye',
49
]
50
return '\n'.join(commands) + '\n'
51
52
def write_asset_version(webroot, environ=None):
53
"""Stamp the deploy commit into web/asset-version.txt for cache-busting."""
54
environ = os.environ if environ is None else environ
55
sha = (environ.get('CI_COMMIT_SHA') or '').strip()
56
if not sha:
57
try:
58
sha = subprocess.check_output(
59
['git', '-C', str(ROOT), 'rev-parse', 'HEAD'], text=True, stderr=subprocess.DEVNULL
60
).strip()
61
except (subprocess.CalledProcessError, FileNotFoundError):
62
sha = ''
63
if not sha or len(sha) < 7:
64
raise ValueError('Unable to determine commit SHA for asset-version.txt (set CI_COMMIT_SHA).')
65
(webroot / 'asset-version.txt').write_text(sha + '\n', encoding='utf-8')
66
print(f'Wrote asset-version.txt = {sha}')
67
68
def main():
69
try:
70
webroot = ROOT / 'web'
71
write_asset_version(webroot, os.environ)
72
commands = deployment_commands(os.environ, webroot)
73
subprocess.run(['lftp', '--norc'], input=commands, text=True,
74
env={**os.environ, 'LFTP_PASSWORD':os.environ['timftppassword']}, check=True)
75
except (ValueError, subprocess.CalledProcessError) as error:
76
print(str(error), file=sys.stderr)
77
return 1
78
return 0
79
80
if __name__ == '__main__':
81
sys.exit(main())
@@ -0,0 +1,81 @@1
#!/usr/bin/env python32
"""Deploy only web/, preserving server-owned data. Passwords never enter argv."""3
import os4
from pathlib import Path5
import subprocess6
import sys7
from urllib.parse import urlsplit8
9
ROOT = Path(__file__).resolve().parents[1]10
11
def quoted(value):12
if any(c in value for c in '\r\n\x00'):13
raise ValueError('Deployment variables must not contain line breaks or NUL bytes.')14
return '"' + value.replace('\\', '\\\\').replace('"', '\\"') + '"'15
16
def deployment_commands(environ, webroot):17
for key in ['timftphost', 'timftpuser', 'timftppassword', 'projectftp']:18
if not environ.get(key):19
raise ValueError(f'CI variable {key} is not set.')20
host = environ['timftphost']21
if '://' not in host:22
host = 'ftp://' + host23
parsed = urlsplit(host)24
if parsed.scheme not in ['ftp', 'ftps', 'sftp'] or not parsed.hostname:25
raise ValueError('timftphost must be an FTP, FTPS or SFTP host URL.')26
if parsed.username or parsed.password or parsed.query or parsed.fragment:27
raise ValueError('Keep login credentials in timftpuser/timftppassword; use a plain host URL.')28
commands = [29
'set cmd:fail-exit yes',30
'set net:timeout 20',31
'set net:max-retries 2',32
'set net:reconnect-interval-base 3',33
# This hosting account uses a mismatched FTP certificate; retain the owner's deployment policy.34
'set ssl:verify-certificate no',35
'set ftp:list-options -a',36
# New SFTP hosts are remembered within this runner; changed host keys fail.37
'set sftp:connect-program "ssh -a -x -o StrictHostKeyChecking=accept-new"',38
f'open --user {quoted(environ["timftpuser"])} --env-password {quoted(host)}',39
f'cd {quoted(environ["projectftp"])}',40
'mkdir -p data || echo "Using existing data directory"',41
f'put {quoted(str(webroot / "data/.htaccess"))} -o data/.htaccess',42
# No --delete-excluded: these paths belong to the running server.43
'mirror --reverse --delete --no-perms --no-symlinks --max-errors=1 '44
'--exclude-glob "data/" --exclude-glob "data/**" '45
'--exclude-glob "tests/" --exclude-glob "tests/**" '46
'--exclude-glob "README.md" --exclude-glob "router.php" '47
f'{quoted(str(webroot))} .',48
'bye',49
]50
return '\n'.join(commands) + '\n'51
52
def write_asset_version(webroot, environ=None):53
"""Stamp the deploy commit into web/asset-version.txt for cache-busting."""54
environ = os.environ if environ is None else environ55
sha = (environ.get('CI_COMMIT_SHA') or '').strip()56
if not sha:57
try:58
sha = subprocess.check_output(59
['git', '-C', str(ROOT), 'rev-parse', 'HEAD'], text=True, stderr=subprocess.DEVNULL60
).strip()61
except (subprocess.CalledProcessError, FileNotFoundError):62
sha = ''63
if not sha or len(sha) < 7:64
raise ValueError('Unable to determine commit SHA for asset-version.txt (set CI_COMMIT_SHA).')65
(webroot / 'asset-version.txt').write_text(sha + '\n', encoding='utf-8')66
print(f'Wrote asset-version.txt = {sha}')67
68
def main():69
try:70
webroot = ROOT / 'web'71
write_asset_version(webroot, os.environ)72
commands = deployment_commands(os.environ, webroot)73
subprocess.run(['lftp', '--norc'], input=commands, text=True,74
env={**os.environ, 'LFTP_PASSWORD':os.environ['timftppassword']}, check=True)75
except (ValueError, subprocess.CalledProcessError) as error:76
print(str(error), file=sys.stderr)77
return 178
return 079
80
if __name__ == '__main__':81
sys.exit(main())@@ -0,0 +1,80 @@
1
#!/usr/bin/env python3
2
"""Run the actual lftp command sequence against an isolated local FTP server."""
3
import os
4
import logging
5
from pathlib import Path
6
import subprocess
7
import tempfile
8
import threading
9
import unittest
10
11
from pyftpdlib.log import config_logging
12
config_logging(level=logging.ERROR)
13
14
from pyftpdlib.authorizers import DummyAuthorizer
15
from pyftpdlib.handlers import FTPHandler
16
from pyftpdlib.servers import FTPServer
17
from deploy import ROOT, deployment_commands, write_asset_version
18
19
class DeployTests(unittest.TestCase):
20
def test_mirror_preserves_data(self):
21
artifacts=ROOT/'web/tests/artifacts'
22
artifacts.mkdir(exist_ok=True)
23
with tempfile.TemporaryDirectory(dir=artifacts,prefix='deploy-') as directory:
24
base=Path(directory); local=base/'local web'; remote=base/'remote'
25
local.mkdir();remote.mkdir();target=remote/'verhaaltjesboek';target.mkdir()
26
for folder in [local/'data', local/'tests',local/'assets',target/'data',target/'data/backups']:
27
folder.mkdir()
28
(local/'data/.htaccess').write_text('Require all denied\n')
29
(local/'data/config.php').write_text('DO NOT UPLOAD LOCAL SECRET')
30
(local/'data/verhalenboek.sqlite').write_text('DO NOT UPLOAD LOCAL DB')
31
(local/'tests/check.php').write_text('test code')
32
(local/'router.php').write_text('dev router')
33
(local/'README.md').write_text('readme')
34
(local/'index.php').write_text('new application')
35
(local/'.htaccess').write_text('Options -Indexes\n')
36
(local/'assets/app.js').write_text('new frontend')
37
(target/'obsolete.php').write_text('stale application code')
38
retained={'config.php':'PRODUCTION SECRET','verhalenboek.sqlite':'PRODUCTION DB',
39
'verhalenboek.sqlite-wal':'LIVE WAL','backups/older.sqlite':'BACKUP'}
40
for file,data in retained.items():(target/'data'/file).write_text(data)
41
authorizer=DummyAuthorizer();authorizer.add_user('fixture-user','fixture-password',str(remote),perm='elradfmwMT')
42
class Handler(FTPHandler):
43
pass
44
Handler.authorizer=authorizer
45
server=FTPServer(('127.0.0.1',0),Handler)
46
thread=threading.Thread(target=server.serve_forever,kwargs={'timeout':.1},daemon=True);thread.start()
47
env={'timftphost':f'ftp://127.0.0.1:{server.socket.getsockname()[1]}','timftpuser':'fixture-user',
48
'timftppassword':'fixture-password','projectftp':'verhaaltjesboek'}
49
try:
50
commands=deployment_commands(env,local)
51
self.assertNotIn(env['timftppassword'],commands)
52
for _ in range(2):
53
result=subprocess.run(['lftp','--norc'],input=commands,text=True,
54
env={**os.environ,'LFTP_PASSWORD':env['timftppassword'], 'LFTP_HOME':str(base/'lftp')},
55
capture_output=True,timeout=30)
56
self.assertEqual(result.returncode,0,result.stdout+result.stderr)
57
for file,data in retained.items():self.assertEqual((target/'data'/file).read_text(),data)
58
self.assertEqual((target/'data/.htaccess').read_text(),'Require all denied\n')
59
self.assertEqual((target/'index.php').read_text(),'new application')
60
self.assertEqual((target/'.htaccess').read_text(),'Options -Indexes\n')
61
self.assertEqual((target/'assets/app.js').read_text(),'new frontend')
62
for excluded in ['tests','router.php','README.md','obsolete.php']:
63
self.assertFalse((target/excluded).exists(),excluded)
64
finally:
65
server.close_all();thread.join(timeout=2)
66
67
68
def test_write_asset_version_from_ci(self):
69
with tempfile.TemporaryDirectory() as directory:
70
webroot = Path(directory)
71
write_asset_version(webroot, {'CI_COMMIT_SHA': 'deadbeefcafebabe0123456789abcdef01234567'})
72
self.assertEqual((webroot/'asset-version.txt').read_text(), 'deadbeefcafebabe0123456789abcdef01234567\n')
73
74
def test_invalid_config_fails_before_connecting(self):
75
with self.assertRaises(ValueError):deployment_commands({},ROOT/'web')
76
env={'timftphost':'ftp://example.test','timftpuser':'user','timftppassword':'secret','projectftp':'x\nrm -r data'}
77
with self.assertRaises(ValueError):deployment_commands(env,ROOT/'web')
78
79
if __name__=='__main__':
80
unittest.main()
@@ -0,0 +1,80 @@1
#!/usr/bin/env python32
"""Run the actual lftp command sequence against an isolated local FTP server."""3
import os4
import logging5
from pathlib import Path6
import subprocess7
import tempfile8
import threading9
import unittest10
11
from pyftpdlib.log import config_logging12
config_logging(level=logging.ERROR)13
14
from pyftpdlib.authorizers import DummyAuthorizer15
from pyftpdlib.handlers import FTPHandler16
from pyftpdlib.servers import FTPServer17
from deploy import ROOT, deployment_commands, write_asset_version18
19
class DeployTests(unittest.TestCase):20
def test_mirror_preserves_data(self):21
artifacts=ROOT/'web/tests/artifacts'22
artifacts.mkdir(exist_ok=True)23
with tempfile.TemporaryDirectory(dir=artifacts,prefix='deploy-') as directory:24
base=Path(directory); local=base/'local web'; remote=base/'remote'25
local.mkdir();remote.mkdir();target=remote/'verhaaltjesboek';target.mkdir()26
for folder in [local/'data', local/'tests',local/'assets',target/'data',target/'data/backups']:27
folder.mkdir()28
(local/'data/.htaccess').write_text('Require all denied\n')29
(local/'data/config.php').write_text('DO NOT UPLOAD LOCAL SECRET')30
(local/'data/verhalenboek.sqlite').write_text('DO NOT UPLOAD LOCAL DB')31
(local/'tests/check.php').write_text('test code')32
(local/'router.php').write_text('dev router')33
(local/'README.md').write_text('readme')34
(local/'index.php').write_text('new application')35
(local/'.htaccess').write_text('Options -Indexes\n')36
(local/'assets/app.js').write_text('new frontend')37
(target/'obsolete.php').write_text('stale application code')38
retained={'config.php':'PRODUCTION SECRET','verhalenboek.sqlite':'PRODUCTION DB',39
'verhalenboek.sqlite-wal':'LIVE WAL','backups/older.sqlite':'BACKUP'}40
for file,data in retained.items():(target/'data'/file).write_text(data)41
authorizer=DummyAuthorizer();authorizer.add_user('fixture-user','fixture-password',str(remote),perm='elradfmwMT')42
class Handler(FTPHandler):43
pass44
Handler.authorizer=authorizer45
server=FTPServer(('127.0.0.1',0),Handler)46
thread=threading.Thread(target=server.serve_forever,kwargs={'timeout':.1},daemon=True);thread.start()47
env={'timftphost':f'ftp://127.0.0.1:{server.socket.getsockname()[1]}','timftpuser':'fixture-user',48
'timftppassword':'fixture-password','projectftp':'verhaaltjesboek'}49
try:50
commands=deployment_commands(env,local)51
self.assertNotIn(env['timftppassword'],commands)52
for _ in range(2):53
result=subprocess.run(['lftp','--norc'],input=commands,text=True,54
env={**os.environ,'LFTP_PASSWORD':env['timftppassword'], 'LFTP_HOME':str(base/'lftp')},55
capture_output=True,timeout=30)56
self.assertEqual(result.returncode,0,result.stdout+result.stderr)57
for file,data in retained.items():self.assertEqual((target/'data'/file).read_text(),data)58
self.assertEqual((target/'data/.htaccess').read_text(),'Require all denied\n')59
self.assertEqual((target/'index.php').read_text(),'new application')60
self.assertEqual((target/'.htaccess').read_text(),'Options -Indexes\n')61
self.assertEqual((target/'assets/app.js').read_text(),'new frontend')62
for excluded in ['tests','router.php','README.md','obsolete.php']:63
self.assertFalse((target/excluded).exists(),excluded)64
finally:65
server.close_all();thread.join(timeout=2)66
67
68
def test_write_asset_version_from_ci(self):69
with tempfile.TemporaryDirectory() as directory:70
webroot = Path(directory)71
write_asset_version(webroot, {'CI_COMMIT_SHA': 'deadbeefcafebabe0123456789abcdef01234567'})72
self.assertEqual((webroot/'asset-version.txt').read_text(), 'deadbeefcafebabe0123456789abcdef01234567\n')73
74
def test_invalid_config_fails_before_connecting(self):75
with self.assertRaises(ValueError):deployment_commands({},ROOT/'web')76
env={'timftphost':'ftp://example.test','timftpuser':'user','timftppassword':'secret','projectftp':'x\nrm -r data'}77
with self.assertRaises(ValueError):deployment_commands(env,ROOT/'web')78
79
if __name__=='__main__':80
unittest.main()@@ -0,0 +1,20 @@
1
Options -Indexes
2
DirectoryIndex index.php
3
<FilesMatch "^(README\.md|router\.php)$">
4
Require all denied
5
</FilesMatch>
6
<IfModule mod_headers.c>
7
Header always set X-Content-Type-Options "nosniff"
8
Header always set Referrer-Policy "same-origin"
9
</IfModule>
10
11
<IfModule mod_mime.c>
12
AddType application/manifest+json .webmanifest
13
</IfModule>
14
15
# Versioned asset URLs (?v=commit) may be cached for a long time.
16
<IfModule mod_headers.c>
17
<FilesMatch "\.(css|js|png|svg|webp|woff2?)$">
18
Header set Cache-Control "public, max-age=31536000, immutable"
19
</FilesMatch>
20
</IfModule>
@@ -0,0 +1,20 @@1
Options -Indexes2
DirectoryIndex index.php3
<FilesMatch "^(README\.md|router\.php)$">4
Require all denied5
</FilesMatch>6
<IfModule mod_headers.c>7
Header always set X-Content-Type-Options "nosniff"8
Header always set Referrer-Policy "same-origin"9
</IfModule>10
11
<IfModule mod_mime.c>12
AddType application/manifest+json .webmanifest13
</IfModule>14
15
# Versioned asset URLs (?v=commit) may be cached for a long time.16
<IfModule mod_headers.c>17
<FilesMatch "\.(css|js|png|svg|webp|woff2?)$">18
Header set Cache-Control "public, max-age=31536000, immutable"19
</FilesMatch>20
</IfModule>@@ -0,0 +1,41 @@
1
# Verhalenboek
2
3
PHP 8.2+ met SQLite en gewone JavaScript. Zet de document root op deze map `web/`. Productie heeft geen Composer, Node of build nodig.
4
5
De volledige uitleg, inclusief de API en de stappen voor auth.timfalken.com, staat in de [README in de repository](../README.md). Dit bestand gaat niet mee naar de server.
6
7
## Lokaal
8
9
```sh
10
php -S 127.0.0.1:8080 -t web web/router.php
11
```
12
13
http://127.0.0.1:8080 logt automatisch in als `test_user_1` (beheerder). Dat gebeurt alleen bij een loopback-adres én een localhost-host. Op een publiek domein niet.
14
15
## Productie
16
17
PHP 8.2+, PDO SQLite, cURL, mbstring en een schrijfbare `data/`. De database is `data/verhalenboek.sqlite`. Het eerste verzoek maakt `data/config.php` als het er nog niet is. Een bestaand bestand blijft staan; ontbreekt `key_secret`, dan vult de app alleen die waarde aan. Die versleutelt API-sleutels zodat een beheerder ze opnieuw kan tonen.
18
19
```php
20
<?php
21
return [
22
'base_url' => 'https://projects.timfalken.com/verhaaltjesboek',
23
'client_id' => 'projects.timfalken.com',
24
'client_secret' => 'het-geheim-uit-admin',
25
'key_secret' => 'blijft-de-gegenereerde-waarde',
26
];
27
```
28
29
Registreer op https://auth.timfalken.com/admin het callback-pad `/verhaaltjesboek/callback.php` voor het domein `projects.timfalken.com`. Het geheim hoort alleen in dit serverbestand (of in `VERHALENBOEK_CLIENT_SECRET`). Deploy uploadt `data/` niet en verwijdert het ook niet.
30
31
De eerste gebruiker die inlogt wordt beheerder. E-mail van het account wordt niet gebruikt.
32
33
Apache leest de meegeleverde `.htaccess` (geen directory-index, `data/`, `lib/` en `tests/` dicht). Nginx leest die niet; zet dan vóór de PHP-location:
34
35
```nginx
36
location ~* ^/(data|lib|tests)(/|$) { deny all; }
37
location ~ /\. { deny all; }
38
location ~* ^/(README\.md|router\.php)$ { deny all; }
39
```
40
41
Controleer dat `/data/verhalenboek.sqlite`, `/data/config.php` en `/lib/bootstrap.php` 403 geven.
@@ -0,0 +1,41 @@1
# Verhalenboek2
3
PHP 8.2+ met SQLite en gewone JavaScript. Zet de document root op deze map `web/`. Productie heeft geen Composer, Node of build nodig.4
5
De volledige uitleg, inclusief de API en de stappen voor auth.timfalken.com, staat in de [README in de repository](../README.md). Dit bestand gaat niet mee naar de server.6
7
## Lokaal8
9
```sh10
php -S 127.0.0.1:8080 -t web web/router.php11
```12
13
http://127.0.0.1:8080 logt automatisch in als `test_user_1` (beheerder). Dat gebeurt alleen bij een loopback-adres én een localhost-host. Op een publiek domein niet.14
15
## Productie16
17
PHP 8.2+, PDO SQLite, cURL, mbstring en een schrijfbare `data/`. De database is `data/verhalenboek.sqlite`. Het eerste verzoek maakt `data/config.php` als het er nog niet is. Een bestaand bestand blijft staan; ontbreekt `key_secret`, dan vult de app alleen die waarde aan. Die versleutelt API-sleutels zodat een beheerder ze opnieuw kan tonen.18
19
```php20
<?php21
return [22
'base_url' => 'https://projects.timfalken.com/verhaaltjesboek',23
'client_id' => 'projects.timfalken.com',24
'client_secret' => 'het-geheim-uit-admin',25
'key_secret' => 'blijft-de-gegenereerde-waarde',26
];27
```28
29
Registreer op https://auth.timfalken.com/admin het callback-pad `/verhaaltjesboek/callback.php` voor het domein `projects.timfalken.com`. Het geheim hoort alleen in dit serverbestand (of in `VERHALENBOEK_CLIENT_SECRET`). Deploy uploadt `data/` niet en verwijdert het ook niet.30
31
De eerste gebruiker die inlogt wordt beheerder. E-mail van het account wordt niet gebruikt.32
33
Apache leest de meegeleverde `.htaccess` (geen directory-index, `data/`, `lib/` en `tests/` dicht). Nginx leest die niet; zet dan vóór de PHP-location:34
35
```nginx36
location ~* ^/(data|lib|tests)(/|$) { deny all; }37
location ~ /\. { deny all; }38
location ~* ^/(README\.md|router\.php)$ { deny all; }39
```40
41
Controleer dat `/data/verhalenboek.sqlite`, `/data/config.php` en `/lib/bootstrap.php` 403 geven.@@ -0,0 +1,120 @@
1
<?php
2
declare(strict_types=1);
3
require __DIR__.'/lib/bootstrap.php';
4
5
try {
6
$method = $_SERVER['REQUEST_METHOD'] ?? 'GET';
7
$route = apiRoute();
8
$actor = authenticate();
9
if ($method !== 'GET' && $method !== 'HEAD') requireCsrf($actor);
10
$readerId = $actor['kind'] === 'user' ? $actor['userId'] : null;
11
12
if ($route === '/me') {
13
if ($method !== 'GET') fail('Deze methode is hier niet toegestaan.', 405);
14
jsonOut([
15
'user' => publicUser($actor['userId']),
16
'csrf' => $actor['kind'] === 'user' ? ($_SESSION['csrf'] ?? null) : null,
17
'local' => localDev(),
18
'auth' => $actor['kind'],
19
]);
20
}
21
if ($route === '/me/settings') {
22
if ($method !== 'PUT') fail('Deze methode is hier niet toegestaan.', 405);
23
requireReader($actor);
24
jsonOut(['user' => saveSettings($actor['userId'], readJson())]);
25
}
26
if ($route === '/me/export') {
27
if ($method !== 'GET') fail('Deze methode is hier niet toegestaan.', 405);
28
requireReader($actor);
29
header('Content-Disposition: attachment; filename="verhalenboek-gegevens.json"');
30
jsonOut(exportUser($actor['userId']));
31
}
32
if ($route === '/session/switch') {
33
if ($method !== 'POST') fail('Deze methode is hier niet toegestaan.', 405);
34
requireReader($actor);
35
if (!localDev()) fail('Niet beschikbaar.', 403);
36
$in = readJson();
37
if (!in_array($in['user'] ?? '', ['test_user_1', 'test_user_2'], true)) throw new AppException('Onbekende testgebruiker.');
38
loginUser('local:'.$in['user'], $in['user']);
39
jsonOut(['ok' => true, 'user' => publicUser($_SESSION['user']), 'csrf' => $_SESSION['csrf']]);
40
}
41
if ($route === '/session/logout') {
42
if ($method !== 'POST') fail('Deze methode is hier niet toegestaan.', 405);
43
requireReader($actor);
44
if (!localDev() && isset($_SESSION['token'])) {
45
try { authRequest('/api/logout', [], (string)$_SESSION['token']); } catch (Throwable $e) { /* lokaal alsnog afmelden */ }
46
}
47
$_SESSION = [];
48
session_destroy();
49
jsonOut(['ok' => true]);
50
}
51
if ($route === '/keys') {
52
requireAdminSession($actor);
53
if ($method === 'GET') jsonOut(['keys' => listApiKeys()]);
54
if ($method === 'POST') {
55
$in = readJson();
56
jsonOut(['key' => createApiKey($actor['userId'], $in['name'] ?? null)], 201);
57
}
58
fail('Deze methode is hier niet toegestaan.', 405);
59
}
60
if (preg_match('#^/keys/(\d+)$#', $route, $match)) {
61
requireAdminSession($actor);
62
if ($method === 'GET') jsonOut(['key' => revealApiKey((int)$match[1])]);
63
if ($method === 'DELETE') jsonOut(['key' => revokeApiKey((int)$match[1])]);
64
fail('Deze methode is hier niet toegestaan.', 405);
65
}
66
if ($route === '/days') {
67
if ($method === 'GET') jsonOut(['days' => listDays($readerId)]);
68
if ($method === 'POST') {
69
requireWriter($actor);
70
$in = readJson();
71
if (!is_string($in['date'] ?? null)) throw new AppException('De datum moet de vorm JJJJ-MM-DD hebben.');
72
jsonOut(createDay($in['date'], $in['title'] ?? null, $in['stories'] ?? null), 201);
73
}
74
fail('Deze methode is hier niet toegestaan.', 405);
75
}
76
if ($route === '/days/latest') {
77
if ($method !== 'GET') fail('Deze methode is hier niet toegestaan.', 405);
78
jsonOut(latestWritten());
79
}
80
if ($route === '/days/gaps') {
81
if ($method !== 'GET') fail('Deze methode is hier niet toegestaan.', 405);
82
jsonOut(dayGaps());
83
}
84
if (preg_match('#^/days/(\d{4}-\d{2}-\d{2})$#', $route, $match)) {
85
$date = $match[1];
86
if ($method === 'GET') jsonOut(loadDay($date, $readerId));
87
if ($method === 'PUT') {
88
requireWriter($actor);
89
jsonOut(updateDay($date, readJson()));
90
}
91
if ($method === 'DELETE') {
92
requireWriter($actor);
93
jsonOut(['ok' => true, 'date' => deleteDay($date)]);
94
}
95
fail('Deze methode is hier niet toegestaan.', 405);
96
}
97
if (preg_match('#^/days/(\d{4}-\d{2}-\d{2})/read$#', $route, $match)) {
98
requireReader($actor);
99
if ($method === 'POST') jsonOut(markRead($actor['userId'], $match[1], true));
100
if ($method === 'DELETE') jsonOut(markRead($actor['userId'], $match[1], false));
101
fail('Deze methode is hier niet toegestaan.', 405);
102
}
103
if (preg_match('#^/days/(\d{4}-\d{2}-\d{2})/stories$#', $route, $match)) {
104
if ($method !== 'POST') fail('Deze methode is hier niet toegestaan.', 405);
105
requireWriter($actor);
106
jsonOut(addStory($match[1], readJson()), 201);
107
}
108
if (preg_match('#^/days/(\d{4}-\d{2}-\d{2})/stories/([123])$#', $route, $match)) {
109
requireWriter($actor);
110
if ($method === 'PUT') jsonOut(updateStory($match[1], (int)$match[2], readJson()));
111
if ($method === 'DELETE') jsonOut(deleteStory($match[1], (int)$match[2]));
112
fail('Deze methode is hier niet toegestaan.', 405);
113
}
114
fail('Onbekend pad.', 404);
115
} catch (AppException $e) {
116
fail($e->getMessage(), $e->status, $e->auth);
117
} catch (Throwable $e) {
118
error_log($e->getMessage());
119
fail('Er ging iets mis.', 500);
120
}
@@ -0,0 +1,120 @@1
<?php2
declare(strict_types=1);3
require __DIR__.'/lib/bootstrap.php';4
5
try {6
$method = $_SERVER['REQUEST_METHOD'] ?? 'GET';7
$route = apiRoute();8
$actor = authenticate();9
if ($method !== 'GET' && $method !== 'HEAD') requireCsrf($actor);10
$readerId = $actor['kind'] === 'user' ? $actor['userId'] : null;11
12
if ($route === '/me') {13
if ($method !== 'GET') fail('Deze methode is hier niet toegestaan.', 405);14
jsonOut([15
'user' => publicUser($actor['userId']),16
'csrf' => $actor['kind'] === 'user' ? ($_SESSION['csrf'] ?? null) : null,17
'local' => localDev(),18
'auth' => $actor['kind'],19
]);20
}21
if ($route === '/me/settings') {22
if ($method !== 'PUT') fail('Deze methode is hier niet toegestaan.', 405);23
requireReader($actor);24
jsonOut(['user' => saveSettings($actor['userId'], readJson())]);25
}26
if ($route === '/me/export') {27
if ($method !== 'GET') fail('Deze methode is hier niet toegestaan.', 405);28
requireReader($actor);29
header('Content-Disposition: attachment; filename="verhalenboek-gegevens.json"');30
jsonOut(exportUser($actor['userId']));31
}32
if ($route === '/session/switch') {33
if ($method !== 'POST') fail('Deze methode is hier niet toegestaan.', 405);34
requireReader($actor);35
if (!localDev()) fail('Niet beschikbaar.', 403);36
$in = readJson();37
if (!in_array($in['user'] ?? '', ['test_user_1', 'test_user_2'], true)) throw new AppException('Onbekende testgebruiker.');38
loginUser('local:'.$in['user'], $in['user']);39
jsonOut(['ok' => true, 'user' => publicUser($_SESSION['user']), 'csrf' => $_SESSION['csrf']]);40
}41
if ($route === '/session/logout') {42
if ($method !== 'POST') fail('Deze methode is hier niet toegestaan.', 405);43
requireReader($actor);44
if (!localDev() && isset($_SESSION['token'])) {45
try { authRequest('/api/logout', [], (string)$_SESSION['token']); } catch (Throwable $e) { /* lokaal alsnog afmelden */ }46
}47
$_SESSION = [];48
session_destroy();49
jsonOut(['ok' => true]);50
}51
if ($route === '/keys') {52
requireAdminSession($actor);53
if ($method === 'GET') jsonOut(['keys' => listApiKeys()]);54
if ($method === 'POST') {55
$in = readJson();56
jsonOut(['key' => createApiKey($actor['userId'], $in['name'] ?? null)], 201);57
}58
fail('Deze methode is hier niet toegestaan.', 405);59
}60
if (preg_match('#^/keys/(\d+)$#', $route, $match)) {61
requireAdminSession($actor);62
if ($method === 'GET') jsonOut(['key' => revealApiKey((int)$match[1])]);63
if ($method === 'DELETE') jsonOut(['key' => revokeApiKey((int)$match[1])]);64
fail('Deze methode is hier niet toegestaan.', 405);65
}66
if ($route === '/days') {67
if ($method === 'GET') jsonOut(['days' => listDays($readerId)]);68
if ($method === 'POST') {69
requireWriter($actor);70
$in = readJson();71
if (!is_string($in['date'] ?? null)) throw new AppException('De datum moet de vorm JJJJ-MM-DD hebben.');72
jsonOut(createDay($in['date'], $in['title'] ?? null, $in['stories'] ?? null), 201);73
}74
fail('Deze methode is hier niet toegestaan.', 405);75
}76
if ($route === '/days/latest') {77
if ($method !== 'GET') fail('Deze methode is hier niet toegestaan.', 405);78
jsonOut(latestWritten());79
}80
if ($route === '/days/gaps') {81
if ($method !== 'GET') fail('Deze methode is hier niet toegestaan.', 405);82
jsonOut(dayGaps());83
}84
if (preg_match('#^/days/(\d{4}-\d{2}-\d{2})$#', $route, $match)) {85
$date = $match[1];86
if ($method === 'GET') jsonOut(loadDay($date, $readerId));87
if ($method === 'PUT') {88
requireWriter($actor);89
jsonOut(updateDay($date, readJson()));90
}91
if ($method === 'DELETE') {92
requireWriter($actor);93
jsonOut(['ok' => true, 'date' => deleteDay($date)]);94
}95
fail('Deze methode is hier niet toegestaan.', 405);96
}97
if (preg_match('#^/days/(\d{4}-\d{2}-\d{2})/read$#', $route, $match)) {98
requireReader($actor);99
if ($method === 'POST') jsonOut(markRead($actor['userId'], $match[1], true));100
if ($method === 'DELETE') jsonOut(markRead($actor['userId'], $match[1], false));101
fail('Deze methode is hier niet toegestaan.', 405);102
}103
if (preg_match('#^/days/(\d{4}-\d{2}-\d{2})/stories$#', $route, $match)) {104
if ($method !== 'POST') fail('Deze methode is hier niet toegestaan.', 405);105
requireWriter($actor);106
jsonOut(addStory($match[1], readJson()), 201);107
}108
if (preg_match('#^/days/(\d{4}-\d{2}-\d{2})/stories/([123])$#', $route, $match)) {109
requireWriter($actor);110
if ($method === 'PUT') jsonOut(updateStory($match[1], (int)$match[2], readJson()));111
if ($method === 'DELETE') jsonOut(deleteStory($match[1], (int)$match[2]));112
fail('Deze methode is hier niet toegestaan.', 405);113
}114
fail('Onbekend pad.', 404);115
} catch (AppException $e) {116
fail($e->getMessage(), $e->status, $e->auth);117
} catch (Throwable $e) {118
error_log($e->getMessage());119
fail('Er ging iets mis.', 500);120
}@@ -0,0 +1,310 @@
1
:root {
2
color-scheme: light;
3
--bg: #f3eee4;
4
--bg-raised: #fffaf3;
5
--ink: #1d1915;
6
--muted: #6d6258;
7
--line: #e3d5c6;
8
--accent: #9a4032;
9
--accent-ink: #fff8f4;
10
--read: #2c6a4a;
11
--shadow: 0 16px 40px rgba(70, 42, 24, 0.08);
12
--serif: "Iowan Old Style", "Palatino Linotype", Palatino, Georgia, "Liberation Serif", "Times New Roman", serif;
13
--sans: system-ui, -apple-system, "Segoe UI", "Liberation Sans", sans-serif;
14
--rounded: ui-rounded, "Comic Sans MS", "Chalkboard SE", "Segoe Print", "Comic Neue", Verdana, sans-serif;
15
--font: var(--serif);
16
--measure: 38rem;
17
}
18
19
:root[data-font="serif"] { --font: var(--serif); }
20
:root[data-font="sans"] { --font: var(--sans); }
21
:root[data-font="rounded"] { --font: var(--rounded); }
22
23
:root[data-theme="dark"] {
24
color-scheme: dark;
25
--bg: #141210;
26
--bg-raised: #221e19;
27
--ink: #f6f0e6;
28
--muted: #c2b4a4;
29
--line: #3c342c;
30
--accent: #e7a07a;
31
--accent-ink: #1a120e;
32
--read: #9ed8b8;
33
--shadow: 0 16px 40px rgba(0, 0, 0, 0.35);
34
}
35
36
@media (prefers-color-scheme: dark) {
37
:root[data-theme="system"] {
38
color-scheme: dark;
39
--bg: #141210;
40
--bg-raised: #221e19;
41
--ink: #f6f0e6;
42
--muted: #c2b4a4;
43
--line: #3c342c;
44
--accent: #e7a07a;
45
--accent-ink: #1a120e;
46
--read: #9ed8b8;
47
--shadow: 0 16px 40px rgba(0, 0, 0, 0.35);
48
}
49
}
50
51
* { box-sizing: border-box; }
52
html { scroll-behavior: smooth; }
53
body {
54
margin: 0;
55
min-height: 100vh;
56
background:
57
radial-gradient(1200px 400px at 10% -10%, rgba(154, 64, 50, 0.08), transparent 50%),
58
var(--bg);
59
color: var(--ink);
60
font-family: var(--font);
61
font-size: 1.0625rem;
62
line-height: 1.5;
63
}
64
body, button, input, textarea { font-family: var(--font); }
65
a { color: inherit; }
66
:focus-visible { outline: 3px solid var(--accent); outline-offset: 3px; }
67
@media (prefers-reduced-motion: reduce) {
68
html { scroll-behavior: auto; }
69
* { transition: none !important; }
70
}
71
72
.topbar, .gate, #app, .docs {
73
width: min(100% - 2rem, var(--measure));
74
margin-inline: auto;
75
}
76
.topbar {
77
display: flex;
78
justify-content: space-between;
79
align-items: baseline;
80
gap: 1rem 1.5rem;
81
flex-wrap: wrap;
82
padding: 1.1rem 0 0.4rem;
83
}
84
.brand {
85
display: inline-flex;
86
align-items: center;
87
gap: 0.55rem;
88
text-decoration: none;
89
font-weight: 600;
90
letter-spacing: -0.03em;
91
font-size: 1.25rem;
92
}
93
.brand img { width: 1.7rem; height: 1.7rem; border-radius: 0.4rem; }
94
.nav { display: flex; flex-wrap: wrap; gap: 0.35rem 0.9rem; }
95
.nav a {
96
text-decoration: none;
97
color: var(--muted);
98
padding: 0.35rem 0;
99
}
100
.nav a[aria-current="page"] { color: var(--ink); box-shadow: inset 0 -2px 0 var(--accent); }
101
102
.gate { padding: 18vh 0 4rem; }
103
.eyebrow, .day-kicker {
104
margin: 0 0 0.4rem;
105
color: var(--accent);
106
font-size: 0.78rem;
107
letter-spacing: 0.14em;
108
text-transform: uppercase;
109
}
110
h1, h2, h3 { font-weight: 600; letter-spacing: -0.03em; line-height: 1.15; }
111
.gate h1 { font-size: clamp(2.6rem, 8vw, 4.4rem); margin: 0 0 0.6rem; }
112
.lede { max-width: 34rem; color: var(--muted); font-size: 1.15rem; }
113
.gate-links { margin-top: 1.5rem; }
114
.gate-links a { color: var(--muted); }
115
116
.button, button, .continue {
117
font: inherit;
118
font-size: 1rem;
119
}
120
.button, .continue, .primary, .quiet, .danger {
121
display: inline-flex;
122
align-items: center;
123
justify-content: center;
124
min-height: 2.9rem;
125
padding: 0.55rem 1rem;
126
border-radius: 0.85rem;
127
border: 1px solid transparent;
128
text-decoration: none;
129
cursor: pointer;
130
background: transparent;
131
color: var(--ink);
132
}
133
.primary, a.primary, button.primary {
134
background: var(--accent);
135
color: var(--accent-ink);
136
border-color: var(--accent);
137
}
138
.quiet, button.quiet {
139
border-color: var(--line);
140
background: var(--bg-raised);
141
}
142
.danger { color: var(--accent); border-color: var(--line); background: var(--bg-raised); }
143
button:disabled, .continue:disabled { opacity: 0.55; cursor: default; }
144
.continue, .block { width: 100%; }
145
146
.day-list { list-style: none; margin: 1rem 0 2rem; padding: 0; display: grid; gap: 0.7rem; }
147
.day-link {
148
display: grid;
149
grid-template-columns: 1fr auto;
150
gap: 0.15rem 0.8rem;
151
padding: 0.9rem 1rem;
152
background: var(--bg-raised);
153
border: 1px solid var(--line);
154
border-radius: 1rem;
155
text-decoration: none;
156
box-shadow: var(--shadow);
157
-webkit-user-select: none;
158
user-select: none;
159
-webkit-touch-callout: none;
160
touch-action: pan-y;
161
}
162
.day-link.is-holding { background: color-mix(in srgb, var(--accent) 12%, var(--bg-raised)); }
163
.day-link.unread { box-shadow: inset 4px 0 0 var(--accent), var(--shadow); }
164
.day-date { color: var(--muted); font-size: 0.92rem; }
165
.day-state { font-size: 0.82rem; letter-spacing: 0.04em; text-transform: uppercase; }
166
.day-link.unread .day-state { color: var(--accent); }
167
.day-link.read .day-state { color: var(--read); }
168
.day-title { grid-column: 1 / -1; font-size: 1.25rem; }
169
.badge {
170
justify-self: start;
171
font-size: 0.75rem;
172
letter-spacing: 0.06em;
173
text-transform: uppercase;
174
color: var(--accent);
175
}
176
177
.continue-wrap { margin: 0.6rem 0 0.2rem; }
178
.continue-note { margin: 0.45rem 0 0; color: var(--muted); font-size: 0.95rem; }
179
.status, .empty { color: var(--muted); }
180
.form-error { color: var(--accent); min-height: 1.4em; }
181
182
.day-head h1 { font-size: clamp(1.9rem, 5vw, 2.7rem); margin: 0.2rem 0 1rem; }
183
.pager { margin: 0.4rem 0 1.2rem; }
184
.pager.bottom { margin: 1.6rem 0 2.5rem; }
185
.story { padding: 0.4rem 0 0.8rem; border-top: 1px solid var(--line); }
186
.story h2 { font-size: 1.35rem; margin: 0.9rem 0 0.7rem; }
187
.story h2 span { color: var(--accent); font-weight: 500; margin-right: 0.45rem; }
188
.story p { font-size: 1.15rem; line-height: 1.75; margin: 0 0 1rem; }
189
190
.read-menu {
191
position: fixed;
192
z-index: 20;
193
min-width: 14rem;
194
max-width: calc(100vw - 1rem);
195
padding: 0.45rem;
196
background: var(--bg-raised);
197
color: var(--ink);
198
border: 1px solid var(--line);
199
border-radius: 0.9rem;
200
box-shadow: var(--shadow);
201
}
202
.read-menu[hidden] { display: none; }
203
.read-menu p { margin: 0.35rem 0.55rem 0.25rem; color: var(--muted); font-size: 0.85rem; }
204
.read-menu button { width: 100%; justify-content: flex-start; background: transparent; border: 0; min-height: 2.75rem; }
205
206
#toast {
207
position: fixed;
208
left: 50%;
209
bottom: 1rem;
210
transform: translate(-50%, 0.6rem);
211
width: min(100% - 2rem, 28rem);
212
background: var(--ink);
213
color: var(--bg);
214
padding: 0.8rem 1rem;
215
border-radius: 0.8rem;
216
opacity: 0;
217
pointer-events: none;
218
z-index: 30;
219
}
220
#toast[data-show="1"] { opacity: 1; transform: translate(-50%, 0); }
221
222
.panel, .editor, .settings, .keys {
223
display: grid;
224
gap: 0.9rem;
225
margin: 0.4rem 0 3rem;
226
}
227
label { display: grid; gap: 0.3rem; font-size: 0.95rem; }
228
input, textarea {
229
width: 100%;
230
padding: 0.7rem 0.8rem;
231
border-radius: 0.75rem;
232
border: 1px solid var(--line);
233
background: var(--bg-raised);
234
color: var(--ink);
235
font-size: 1rem;
236
}
237
textarea { min-height: 7.5rem; line-height: 1.55; resize: vertical; }
238
fieldset {
239
margin: 0;
240
padding: 0.9rem;
241
border: 1px solid var(--line);
242
border-radius: 1rem;
243
background: var(--bg-raised);
244
display: grid;
245
gap: 0.7rem;
246
}
247
legend { padding: 0 0.3rem; color: var(--muted); }
248
.choice { display: grid; gap: 0.45rem; }
249
.choice label {
250
display: flex;
251
align-items: center;
252
gap: 0.6rem;
253
min-height: 2.75rem;
254
padding: 0.35rem 0.2rem;
255
}
256
.choice input { width: 1.1rem; height: 1.1rem; }
257
.row-actions, .paragraph-actions { display: flex; flex-wrap: wrap; gap: 0.5rem; }
258
.admin-day {
259
display: flex;
260
justify-content: space-between;
261
gap: 0.8rem;
262
align-items: center;
263
padding: 0.8rem 0;
264
border-bottom: 1px solid var(--line);
265
}
266
.admin-day a { text-decoration: none; }
267
.admin-day small { color: var(--muted); }
268
.token-once {
269
padding: 0.9rem;
270
border-radius: 1rem;
271
background: color-mix(in srgb, var(--accent) 14%, var(--bg-raised));
272
border: 1px solid var(--accent);
273
display: grid;
274
gap: 0.55rem;
275
}
276
.token-once textarea { font-family: ui-monospace, "Cascadia Mono", "Liberation Mono", monospace; min-height: 5rem; }
277
.key-row { display: flex; justify-content: space-between; gap: 0.8rem; align-items: center; padding: 0.35rem 0; border-bottom: 1px solid var(--line); }
278
.key-row p, .key-open span { display: block; margin: 0.15rem 0; }
279
.key-row .revoked { color: var(--muted); text-decoration: line-through; }
280
.key-open {
281
flex: 1;
282
min-width: 0;
283
margin: 0;
284
padding: 0.45rem 0.2rem;
285
border: 0;
286
background: transparent;
287
color: inherit;
288
font: inherit;
289
text-align: left;
290
cursor: pointer;
291
}
292
.key-open:hover span:first-child, .key-open:focus-visible span:first-child { text-decoration: underline; }
293
.docs { padding-bottom: 3rem; }
294
.docs h1 { font-size: clamp(2rem, 5vw, 3rem); }
295
.docs pre {
296
overflow: auto;
297
padding: 0.9rem 1rem;
298
background: var(--bg-raised);
299
border: 1px solid var(--line);
300
border-radius: 0.9rem;
301
line-height: 1.45;
302
font-size: 0.86rem;
303
}
304
.docs code { font-family: ui-monospace, "Cascadia Mono", "Liberation Mono", monospace; }
305
.docs table { width: 100%; border-collapse: collapse; font-size: 0.95rem; }
306
.docs th, .docs td { text-align: left; vertical-align: top; padding: 0.45rem 0.4rem; border-bottom: 1px solid var(--line); }
307
@media (min-width: 800px) {
308
.topbar, .gate, #app, .docs { width: min(100% - 4rem, 46rem); }
309
.story p { font-size: 1.2rem; }
310
}
@@ -0,0 +1,310 @@1
:root {2
color-scheme: light;3
--bg: #f3eee4;4
--bg-raised: #fffaf3;5
--ink: #1d1915;6
--muted: #6d6258;7
--line: #e3d5c6;8
--accent: #9a4032;9
--accent-ink: #fff8f4;10
--read: #2c6a4a;11
--shadow: 0 16px 40px rgba(70, 42, 24, 0.08);12
--serif: "Iowan Old Style", "Palatino Linotype", Palatino, Georgia, "Liberation Serif", "Times New Roman", serif;13
--sans: system-ui, -apple-system, "Segoe UI", "Liberation Sans", sans-serif;14
--rounded: ui-rounded, "Comic Sans MS", "Chalkboard SE", "Segoe Print", "Comic Neue", Verdana, sans-serif;15
--font: var(--serif);16
--measure: 38rem;17
}18
19
:root[data-font="serif"] { --font: var(--serif); }20
:root[data-font="sans"] { --font: var(--sans); }21
:root[data-font="rounded"] { --font: var(--rounded); }22
23
:root[data-theme="dark"] {24
color-scheme: dark;25
--bg: #141210;26
--bg-raised: #221e19;27
--ink: #f6f0e6;28
--muted: #c2b4a4;29
--line: #3c342c;30
--accent: #e7a07a;31
--accent-ink: #1a120e;32
--read: #9ed8b8;33
--shadow: 0 16px 40px rgba(0, 0, 0, 0.35);34
}35
36
@media (prefers-color-scheme: dark) {37
:root[data-theme="system"] {38
color-scheme: dark;39
--bg: #141210;40
--bg-raised: #221e19;41
--ink: #f6f0e6;42
--muted: #c2b4a4;43
--line: #3c342c;44
--accent: #e7a07a;45
--accent-ink: #1a120e;46
--read: #9ed8b8;47
--shadow: 0 16px 40px rgba(0, 0, 0, 0.35);48
}49
}50
51
* { box-sizing: border-box; }52
html { scroll-behavior: smooth; }53
body {54
margin: 0;55
min-height: 100vh;56
background:57
radial-gradient(1200px 400px at 10% -10%, rgba(154, 64, 50, 0.08), transparent 50%),58
var(--bg);59
color: var(--ink);60
font-family: var(--font);61
font-size: 1.0625rem;62
line-height: 1.5;63
}64
body, button, input, textarea { font-family: var(--font); }65
a { color: inherit; }66
:focus-visible { outline: 3px solid var(--accent); outline-offset: 3px; }67
@media (prefers-reduced-motion: reduce) {68
html { scroll-behavior: auto; }69
* { transition: none !important; }70
}71
72
.topbar, .gate, #app, .docs {73
width: min(100% - 2rem, var(--measure));74
margin-inline: auto;75
}76
.topbar {77
display: flex;78
justify-content: space-between;79
align-items: baseline;80
gap: 1rem 1.5rem;81
flex-wrap: wrap;82
padding: 1.1rem 0 0.4rem;83
}84
.brand {85
display: inline-flex;86
align-items: center;87
gap: 0.55rem;88
text-decoration: none;89
font-weight: 600;90
letter-spacing: -0.03em;91
font-size: 1.25rem;92
}93
.brand img { width: 1.7rem; height: 1.7rem; border-radius: 0.4rem; }94
.nav { display: flex; flex-wrap: wrap; gap: 0.35rem 0.9rem; }95
.nav a {96
text-decoration: none;97
color: var(--muted);98
padding: 0.35rem 0;99
}100
.nav a[aria-current="page"] { color: var(--ink); box-shadow: inset 0 -2px 0 var(--accent); }101
102
.gate { padding: 18vh 0 4rem; }103
.eyebrow, .day-kicker {104
margin: 0 0 0.4rem;105
color: var(--accent);106
font-size: 0.78rem;107
letter-spacing: 0.14em;108
text-transform: uppercase;109
}110
h1, h2, h3 { font-weight: 600; letter-spacing: -0.03em; line-height: 1.15; }111
.gate h1 { font-size: clamp(2.6rem, 8vw, 4.4rem); margin: 0 0 0.6rem; }112
.lede { max-width: 34rem; color: var(--muted); font-size: 1.15rem; }113
.gate-links { margin-top: 1.5rem; }114
.gate-links a { color: var(--muted); }115
116
.button, button, .continue {117
font: inherit;118
font-size: 1rem;119
}120
.button, .continue, .primary, .quiet, .danger {121
display: inline-flex;122
align-items: center;123
justify-content: center;124
min-height: 2.9rem;125
padding: 0.55rem 1rem;126
border-radius: 0.85rem;127
border: 1px solid transparent;128
text-decoration: none;129
cursor: pointer;130
background: transparent;131
color: var(--ink);132
}133
.primary, a.primary, button.primary {134
background: var(--accent);135
color: var(--accent-ink);136
border-color: var(--accent);137
}138
.quiet, button.quiet {139
border-color: var(--line);140
background: var(--bg-raised);141
}142
.danger { color: var(--accent); border-color: var(--line); background: var(--bg-raised); }143
button:disabled, .continue:disabled { opacity: 0.55; cursor: default; }144
.continue, .block { width: 100%; }145
146
.day-list { list-style: none; margin: 1rem 0 2rem; padding: 0; display: grid; gap: 0.7rem; }147
.day-link {148
display: grid;149
grid-template-columns: 1fr auto;150
gap: 0.15rem 0.8rem;151
padding: 0.9rem 1rem;152
background: var(--bg-raised);153
border: 1px solid var(--line);154
border-radius: 1rem;155
text-decoration: none;156
box-shadow: var(--shadow);157
-webkit-user-select: none;158
user-select: none;159
-webkit-touch-callout: none;160
touch-action: pan-y;161
}162
.day-link.is-holding { background: color-mix(in srgb, var(--accent) 12%, var(--bg-raised)); }163
.day-link.unread { box-shadow: inset 4px 0 0 var(--accent), var(--shadow); }164
.day-date { color: var(--muted); font-size: 0.92rem; }165
.day-state { font-size: 0.82rem; letter-spacing: 0.04em; text-transform: uppercase; }166
.day-link.unread .day-state { color: var(--accent); }167
.day-link.read .day-state { color: var(--read); }168
.day-title { grid-column: 1 / -1; font-size: 1.25rem; }169
.badge {170
justify-self: start;171
font-size: 0.75rem;172
letter-spacing: 0.06em;173
text-transform: uppercase;174
color: var(--accent);175
}176
177
.continue-wrap { margin: 0.6rem 0 0.2rem; }178
.continue-note { margin: 0.45rem 0 0; color: var(--muted); font-size: 0.95rem; }179
.status, .empty { color: var(--muted); }180
.form-error { color: var(--accent); min-height: 1.4em; }181
182
.day-head h1 { font-size: clamp(1.9rem, 5vw, 2.7rem); margin: 0.2rem 0 1rem; }183
.pager { margin: 0.4rem 0 1.2rem; }184
.pager.bottom { margin: 1.6rem 0 2.5rem; }185
.story { padding: 0.4rem 0 0.8rem; border-top: 1px solid var(--line); }186
.story h2 { font-size: 1.35rem; margin: 0.9rem 0 0.7rem; }187
.story h2 span { color: var(--accent); font-weight: 500; margin-right: 0.45rem; }188
.story p { font-size: 1.15rem; line-height: 1.75; margin: 0 0 1rem; }189
190
.read-menu {191
position: fixed;192
z-index: 20;193
min-width: 14rem;194
max-width: calc(100vw - 1rem);195
padding: 0.45rem;196
background: var(--bg-raised);197
color: var(--ink);198
border: 1px solid var(--line);199
border-radius: 0.9rem;200
box-shadow: var(--shadow);201
}202
.read-menu[hidden] { display: none; }203
.read-menu p { margin: 0.35rem 0.55rem 0.25rem; color: var(--muted); font-size: 0.85rem; }204
.read-menu button { width: 100%; justify-content: flex-start; background: transparent; border: 0; min-height: 2.75rem; }205
206
#toast {207
position: fixed;208
left: 50%;209
bottom: 1rem;210
transform: translate(-50%, 0.6rem);211
width: min(100% - 2rem, 28rem);212
background: var(--ink);213
color: var(--bg);214
padding: 0.8rem 1rem;215
border-radius: 0.8rem;216
opacity: 0;217
pointer-events: none;218
z-index: 30;219
}220
#toast[data-show="1"] { opacity: 1; transform: translate(-50%, 0); }221
222
.panel, .editor, .settings, .keys {223
display: grid;224
gap: 0.9rem;225
margin: 0.4rem 0 3rem;226
}227
label { display: grid; gap: 0.3rem; font-size: 0.95rem; }228
input, textarea {229
width: 100%;230
padding: 0.7rem 0.8rem;231
border-radius: 0.75rem;232
border: 1px solid var(--line);233
background: var(--bg-raised);234
color: var(--ink);235
font-size: 1rem;236
}237
textarea { min-height: 7.5rem; line-height: 1.55; resize: vertical; }238
fieldset {239
margin: 0;240
padding: 0.9rem;241
border: 1px solid var(--line);242
border-radius: 1rem;243
background: var(--bg-raised);244
display: grid;245
gap: 0.7rem;246
}247
legend { padding: 0 0.3rem; color: var(--muted); }248
.choice { display: grid; gap: 0.45rem; }249
.choice label {250
display: flex;251
align-items: center;252
gap: 0.6rem;253
min-height: 2.75rem;254
padding: 0.35rem 0.2rem;255
}256
.choice input { width: 1.1rem; height: 1.1rem; }257
.row-actions, .paragraph-actions { display: flex; flex-wrap: wrap; gap: 0.5rem; }258
.admin-day {259
display: flex;260
justify-content: space-between;261
gap: 0.8rem;262
align-items: center;263
padding: 0.8rem 0;264
border-bottom: 1px solid var(--line);265
}266
.admin-day a { text-decoration: none; }267
.admin-day small { color: var(--muted); }268
.token-once {269
padding: 0.9rem;270
border-radius: 1rem;271
background: color-mix(in srgb, var(--accent) 14%, var(--bg-raised));272
border: 1px solid var(--accent);273
display: grid;274
gap: 0.55rem;275
}276
.token-once textarea { font-family: ui-monospace, "Cascadia Mono", "Liberation Mono", monospace; min-height: 5rem; }277
.key-row { display: flex; justify-content: space-between; gap: 0.8rem; align-items: center; padding: 0.35rem 0; border-bottom: 1px solid var(--line); }278
.key-row p, .key-open span { display: block; margin: 0.15rem 0; }279
.key-row .revoked { color: var(--muted); text-decoration: line-through; }280
.key-open {281
flex: 1;282
min-width: 0;283
margin: 0;284
padding: 0.45rem 0.2rem;285
border: 0;286
background: transparent;287
color: inherit;288
font: inherit;289
text-align: left;290
cursor: pointer;291
}292
.key-open:hover span:first-child, .key-open:focus-visible span:first-child { text-decoration: underline; }293
.docs { padding-bottom: 3rem; }294
.docs h1 { font-size: clamp(2rem, 5vw, 3rem); }295
.docs pre {296
overflow: auto;297
padding: 0.9rem 1rem;298
background: var(--bg-raised);299
border: 1px solid var(--line);300
border-radius: 0.9rem;301
line-height: 1.45;302
font-size: 0.86rem;303
}304
.docs code { font-family: ui-monospace, "Cascadia Mono", "Liberation Mono", monospace; }305
.docs table { width: 100%; border-collapse: collapse; font-size: 0.95rem; }306
.docs th, .docs td { text-align: left; vertical-align: top; padding: 0.45rem 0.4rem; border-bottom: 1px solid var(--line); }307
@media (min-width: 800px) {308
.topbar, .gate, #app, .docs { width: min(100% - 4rem, 46rem); }309
.story p { font-size: 1.2rem; }310
}@@ -0,0 +1,555 @@
1
'use strict';
2
3
const MONTHS = ['januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december'];
4
const ROMAN = ['I', 'II', 'III'];
5
const state = { me: null, csrf: '', local: false, freshKey: null, revealedKey: null };
6
let renderToken = 0;
7
let menuAnchor = null;
8
let ignoreCloseUntil = 0;
9
10
const app = document.querySelector('#app');
11
if (app) boot();
12
13
function formatDate(iso) {
14
const [year, month, day] = iso.split('-').map(Number);
15
return day + ' ' + MONTHS[month - 1] + ' ' + year;
16
}
17
18
function pathNow() {
19
const raw = location.hash.replace(/^#/, '');
20
if (!raw || raw === '/') return '/';
21
return raw.startsWith('/') ? raw : '/' + raw;
22
}
23
24
function el(tag, attrs, children) {
25
const node = document.createElement(tag);
26
Object.entries(attrs || {}).forEach(([key, value]) => {
27
if (value == null || value === false) return;
28
if (key === 'class') node.className = value;
29
else node.setAttribute(key, value === true ? '' : value);
30
});
31
(children || []).forEach((child) => node.append(child instanceof Node ? child : document.createTextNode(String(child))));
32
return node;
33
}
34
35
function toast(message) {
36
const node = document.querySelector('#toast');
37
node.textContent = message;
38
node.dataset.show = '1';
39
clearTimeout(toast.timer);
40
toast.timer = setTimeout(() => { node.dataset.show = '0'; }, 4200);
41
}
42
43
async function api(method, path, body) {
44
const headers = { Accept: 'application/json' };
45
if (body !== undefined) headers['Content-Type'] = 'application/json';
46
if (method !== 'GET' && state.csrf) headers['X-CSRF-Token'] = state.csrf;
47
const response = await fetch('api.php' + path, {
48
method,
49
headers,
50
body: body !== undefined ? JSON.stringify(body) : undefined,
51
});
52
let data = null;
53
try { data = await response.json(); } catch (error) { data = null; }
54
if (!response.ok) {
55
const failure = new Error((data && data.error) || 'Er ging iets mis.');
56
failure.status = response.status;
57
throw failure;
58
}
59
return data;
60
}
61
62
function applyPrefs(user) {
63
document.documentElement.dataset.theme = user.theme || 'system';
64
document.documentElement.dataset.font = user.font || 'serif';
65
const dark = user.theme === 'dark' || (user.theme !== 'light' && window.matchMedia('(prefers-color-scheme: dark)').matches);
66
const meta = document.querySelector('meta[name="theme-color"]');
67
if (meta) meta.content = dark ? '#141210' : '#f4efe6';
68
}
69
70
function highlight(path) {
71
document.querySelectorAll('[data-nav]').forEach((link) => {
72
const nav = link.getAttribute('data-nav');
73
const current = nav === '/beheer' ? path.startsWith('/beheer') : path === nav;
74
if (current) link.setAttribute('aria-current', 'page');
75
else link.removeAttribute('aria-current');
76
});
77
}
78
79
function closeMenu() {
80
const menu = document.querySelector('#read-menu');
81
if (!menu || menu.hidden) return;
82
menu.hidden = true;
83
if (menuAnchor && menuAnchor.isConnected) menuAnchor.focus();
84
menuAnchor = null;
85
}
86
87
function openMenu(x, y, day, anchor) {
88
const menu = document.querySelector('#read-menu');
89
menu.hidden = false;
90
menu.dataset.date = day.date;
91
menu.querySelector('[data-caption]').textContent = formatDate(day.date) + ' · ' + day.title;
92
const button = menu.querySelector('button');
93
button.textContent = day.read ? 'Markeer als ongelezen' : 'Markeer als gelezen';
94
button.dataset.makeRead = day.read ? '0' : '1';
95
menu.style.left = '0px';
96
menu.style.top = '0px';
97
const rect = menu.getBoundingClientRect();
98
menu.style.left = Math.max(8, Math.min(x, window.innerWidth - rect.width - 8)) + 'px';
99
menu.style.top = Math.max(8, Math.min(y, window.innerHeight - rect.height - 8)) + 'px';
100
menuAnchor = anchor;
101
ignoreCloseUntil = Date.now() + 450;
102
button.focus();
103
}
104
105
function bindReadMenu() {
106
const menu = document.querySelector('#read-menu');
107
menu.querySelector('button').addEventListener('click', async () => {
108
const date = menu.dataset.date;
109
const makeRead = menu.querySelector('button').dataset.makeRead === '1';
110
closeMenu();
111
try {
112
await api(makeRead ? 'POST' : 'DELETE', '/days/' + date + '/read');
113
await render();
114
} catch (error) {
115
toast(error.message);
116
}
117
});
118
document.addEventListener('click', (event) => {
119
if (menu.hidden || Date.now() < ignoreCloseUntil || menu.contains(event.target)) return;
120
closeMenu();
121
});
122
document.addEventListener('keydown', (event) => {
123
if (event.key === 'Escape') closeMenu();
124
});
125
window.addEventListener('scroll', () => closeMenu(), true);
126
}
127
128
function bindDayLink(link, day) {
129
let timer = null;
130
let startX = 0;
131
let startY = 0;
132
let suppressClick = false;
133
const cancel = () => {
134
if (timer) clearTimeout(timer);
135
timer = null;
136
link.classList.remove('is-holding');
137
};
138
link.addEventListener('contextmenu', (event) => {
139
event.preventDefault();
140
cancel();
141
suppressClick = true;
142
openMenu(event.clientX, event.clientY, day, link);
143
});
144
link.addEventListener('pointerdown', (event) => {
145
if (event.pointerType === 'mouse' || event.button !== 0) return;
146
startX = event.clientX;
147
startY = event.clientY;
148
suppressClick = false;
149
link.classList.add('is-holding');
150
timer = setTimeout(() => {
151
timer = null;
152
suppressClick = true;
153
openMenu(startX, startY, day, link);
154
}, 550);
155
});
156
link.addEventListener('pointermove', (event) => {
157
if (timer && Math.hypot(event.clientX - startX, event.clientY - startY) > 12) cancel();
158
});
159
link.addEventListener('pointerup', cancel);
160
link.addEventListener('pointercancel', cancel);
161
link.addEventListener('selectstart', (event) => event.preventDefault());
162
link.addEventListener('dragstart', (event) => event.preventDefault());
163
link.addEventListener('click', (event) => {
164
if (!suppressClick) return;
165
event.preventDefault();
166
suppressClick = false;
167
});
168
}
169
170
function unreadLabel(count) {
171
if (count === 1) return '1 dag ongelezen';
172
return count + ' dagen ongelezen';
173
}
174
175
function paintOverview(days) {
176
const unread = days.filter((day) => !day.read);
177
const wrap = el('div', { class: 'continue-wrap' });
178
if (!days.length) {
179
wrap.append(el('p', { class: 'empty' }, [state.me.admin ? 'Er staan nog geen dagen in het boek.' : 'Er staan nog geen verhalen klaar.']));
180
if (state.me.admin) wrap.append(el('a', { class: 'button primary', href: '#/beheer/nieuw' }, ['Nieuwe dag']));
181
} else if (unread.length) {
182
wrap.append(el('a', { class: 'button primary continue', href: '#/dag/' + unread[0].date }, ['Verderlezen']));
183
wrap.append(el('p', { class: 'continue-note' }, [unreadLabel(unread.length)]));
184
} else {
185
const done = el('button', { class: 'button continue', type: 'button', disabled: 'disabled' }, ['Alles gelezen']);
186
wrap.append(done);
187
}
188
const list = el('ol', { class: 'day-list' });
189
days.forEach((day) => {
190
const link = el('a', { class: 'day-link ' + (day.read ? 'read' : 'unread'), href: '#/dag/' + day.date }, [
191
el('span', { class: 'day-date' }, [formatDate(day.date)]),
192
el('span', { class: 'day-state' }, [day.read ? 'Gelezen' : 'Ongelezen']),
193
el('span', { class: 'day-title' }, [day.title]),
194
]);
195
if (!day.complete) link.append(el('span', { class: 'badge' }, ['Onvolledig']));
196
bindDayLink(link, day);
197
list.append(el('li', {}, [link]));
198
});
199
app.replaceChildren(el('h1', {}, ['Dagen']), wrap, list);
200
const firstUnread = list.querySelector('.unread');
201
if (firstUnread) firstUnread.scrollIntoView({ block: 'nearest' });
202
}
203
204
function paintDay(day) {
205
const head = el('header', { class: 'day-head' }, [
206
el('p', { class: 'day-kicker' }, [formatDate(day.date)]),
207
el('h1', {}, [day.title]),
208
]);
209
const top = el('div', { class: 'pager' });
210
if (day.previous) top.append(el('a', { class: 'button quiet', href: '#/dag/' + day.previous }, ['← Vorige dag']));
211
const stories = day.stories.map((story) => el('article', { class: 'story' }, [
212
el('h2', {}, [el('span', {}, [ROMAN[(story.position || 1) - 1] || String(story.position)]), story.title]),
213
...story.paragraphs.map((paragraph) => el('p', {}, [paragraph])),
214
]));
215
if (!day.complete) stories.unshift(el('p', { class: 'form-error' }, ['Deze dag is onvolledig.']));
216
const bottom = el('div', { class: 'pager bottom' });
217
if (day.next) bottom.append(el('a', { class: 'button primary continue', href: '#/dag/' + day.next }, ['Volgende dag →']));
218
else bottom.append(el('a', { class: 'button quiet', href: '#/' }, ['Terug naar het overzicht']));
219
app.replaceChildren(head, top, ...stories, bottom);
220
}
221
222
function choice(name, value, label, current) {
223
const input = el('input', { type: 'radio', name, value });
224
input.checked = current === value;
225
return el('label', {}, [input, label]);
226
}
227
228
function paintSettings() {
229
const theme = el('fieldset', {}, [
230
el('legend', {}, ['Weergave']),
231
el('div', { class: 'choice' }, [
232
choice('theme', 'system', 'Systeem', state.me.theme),
233
choice('theme', 'light', 'Licht', state.me.theme),
234
choice('theme', 'dark', 'Donker', state.me.theme),
235
]),
236
]);
237
const font = el('fieldset', {}, [
238
el('legend', {}, ['Lettertype']),
239
el('div', { class: 'choice' }, [
240
choice('font', 'serif', 'Serif', state.me.font),
241
choice('font', 'sans', 'Schreefloos', state.me.font),
242
choice('font', 'rounded', 'Rond', state.me.font),
243
]),
244
]);
245
const preview = el('p', { class: 'lede' }, ['Zo lees je een verhaal. De regen tikte zacht op het dak, en de bladzijde bleef openliggen.']);
246
const error = el('p', { class: 'form-error' });
247
async function persist() {
248
const nextTheme = theme.querySelector('input:checked').value;
249
const nextFont = font.querySelector('input:checked').value;
250
const previous = { theme: state.me.theme, font: state.me.font };
251
state.me = { ...state.me, theme: nextTheme, font: nextFont };
252
applyPrefs(state.me);
253
try {
254
const result = await api('PUT', '/me/settings', { theme: nextTheme, font: nextFont });
255
state.me = result.user;
256
applyPrefs(state.me);
257
error.textContent = '';
258
} catch (failure) {
259
state.me = { ...state.me, ...previous };
260
applyPrefs(state.me);
261
theme.querySelector('input[value="' + previous.theme + '"]').checked = true;
262
font.querySelector('input[value="' + previous.font + '"]').checked = true;
263
error.textContent = failure.message;
264
}
265
}
266
theme.addEventListener('change', persist);
267
font.addEventListener('change', persist);
268
const actions = el('div', { class: 'row-actions' }, [
269
el('button', { class: 'quiet', type: 'button' }, ['Exporteer mijn gegevens (JSON)']),
270
el('button', { class: 'danger', type: 'button' }, ['Uitloggen']),
271
]);
272
actions.children[0].addEventListener('click', () => { window.location.href = 'api.php/me/export'; });
273
actions.children[1].addEventListener('click', async () => {
274
try {
275
await api('POST', '/session/logout');
276
window.location.href = 'index.php';
277
} catch (failure) { toast(failure.message); }
278
});
279
const section = el('section', { class: 'settings' }, [
280
el('h1', {}, ['Instellingen']),
281
el('p', { class: 'continue-note' }, ['Ingelogd als ' + state.me.name + (state.me.admin ? ' · beheerder' : '')]),
282
theme, font, preview, error, actions,
283
]);
284
if (state.local) {
285
const other = state.me.name === 'test_user_2' ? 'test_user_1' : 'test_user_2';
286
const swap = el('button', { class: 'quiet', type: 'button' }, ['Wissel naar ' + other]);
287
swap.addEventListener('click', async () => {
288
try {
289
await api('POST', '/session/switch', { user: other });
290
window.location.reload();
291
} catch (failure) { toast(failure.message); }
292
});
293
section.append(swap);
294
}
295
app.replaceChildren(section);
296
}
297
298
function paragraphField(value) {
299
const area = el('textarea', { rows: '4' });
300
area.value = value || '';
301
const remove = el('button', { class: 'quiet', type: 'button' }, ['Alinea verwijderen']);
302
const block = el('div', { class: 'paragraph-actions' }, [area, remove]);
303
remove.addEventListener('click', () => {
304
const boxes = block.parentElement.querySelectorAll('textarea');
305
if (boxes.length <= 1) { area.value = ''; return; }
306
block.remove();
307
});
308
return block;
309
}
310
311
function storyField(position, story, onDelete) {
312
const title = el('input', { type: 'text', maxlength: '200', 'data-title': '1', required: 'required' });
313
title.value = story.title || '';
314
const paragraphs = el('div', {});
315
(story.paragraphs && story.paragraphs.length ? story.paragraphs : ['']).forEach((paragraph) => paragraphs.append(paragraphField(paragraph)));
316
const add = el('button', { class: 'quiet', type: 'button' }, ['Alinea toevoegen']);
317
add.addEventListener('click', () => paragraphs.append(paragraphField('')));
318
const fieldset = el('fieldset', { 'data-position': String(position) }, [
319
el('legend', {}, ['Verhaal ' + ROMAN[position - 1]]),
320
el('label', {}, ['Titel', title]),
321
paragraphs,
322
add,
323
]);
324
if (onDelete) {
325
const remove = el('button', { class: 'danger', type: 'button' }, ['Dit verhaal verwijderen']);
326
remove.addEventListener('click', onDelete);
327
fieldset.append(remove);
328
}
329
return fieldset;
330
}
331
332
function readStories(form) {
333
return [...form.querySelectorAll('fieldset')].map((fieldset) => ({
334
title: fieldset.querySelector('[data-title]').value,
335
paragraphs: [...fieldset.querySelectorAll('textarea')].map((area) => area.value),
336
}));
337
}
338
339
async function paintEditor(date) {
340
const creating = !date;
341
let day = { title: '', stories: [{}, {}, {}] };
342
if (!creating) day = await api('GET', '/days/' + date);
343
const byPosition = {};
344
(day.stories || []).forEach((story) => { byPosition[story.position] = story; });
345
const title = el('input', { type: 'text', maxlength: '200', required: 'required' });
346
title.value = day.title || '';
347
const dateInput = el('input', { type: 'date', required: 'required' });
348
if (creating) dateInput.value = '';
349
else { dateInput.value = date; dateInput.readOnly = true; }
350
const error = el('p', { class: 'form-error' });
351
const form = el('form', { class: 'editor' }, [
352
el('h1', {}, [creating ? 'Nieuwe dag' : 'Dag bewerken']),
353
el('label', {}, ['Datum', dateInput]),
354
el('label', {}, ['Titel van de dag', title]),
355
]);
356
for (let position = 1; position <= 3; position += 1) {
357
const existing = byPosition[position];
358
form.append(storyField(position, existing || { title: '', paragraphs: [''] }, !creating && existing ? async () => {
359
if (!window.confirm('Dit verhaal verwijderen? De dag wordt onvolledig.')) return;
360
try {
361
await api('DELETE', '/days/' + date + '/stories/' + position);
362
await render();
363
} catch (failure) { error.textContent = failure.message; }
364
} : null));
365
}
366
const save = el('button', { class: 'primary', type: 'submit' }, ['Dag opslaan']);
367
form.append(error, save);
368
if (!creating) {
369
const remove = el('button', { class: 'danger', type: 'button' }, ['Hele dag verwijderen']);
370
remove.addEventListener('click', async () => {
371
if (!window.confirm('Deze dag en de bijbehorende verhalen verwijderen? Dit kan niet ongedaan worden.')) return;
372
try {
373
await api('DELETE', '/days/' + date);
374
location.hash = '#/beheer';
375
} catch (failure) { error.textContent = failure.message; }
376
});
377
form.append(remove);
378
}
379
form.addEventListener('submit', async (event) => {
380
event.preventDefault();
381
error.textContent = '';
382
save.disabled = true;
383
const payload = { title: title.value, stories: readStories(form) };
384
try {
385
if (creating) {
386
const created = await api('POST', '/days', { date: dateInput.value, ...payload });
387
location.hash = '#/beheer/' + created.date;
388
} else {
389
await api('PUT', '/days/' + date, payload);
390
toast('Opgeslagen.');
391
await render();
392
}
393
} catch (failure) {
394
error.textContent = failure.message;
395
save.disabled = false;
396
}
397
});
398
app.replaceChildren(form);
399
}
400
401
async function paintBeheer() {
402
const data = await api('GET', '/days');
403
const list = el('div', {});
404
data.days.forEach((day) => {
405
list.append(el('div', { class: 'admin-day' }, [
406
el('a', { href: '#/beheer/' + day.date }, [
407
el('strong', {}, [day.title]),
408
document.createElement('br'),
409
el('small', {}, [formatDate(day.date) + (day.complete ? '' : ' · onvolledig')]),
410
]),
411
el('a', { class: 'button quiet', href: '#/dag/' + day.date }, ['Lezen']),
412
]));
413
});
414
if (!data.days.length) list.append(el('p', { class: 'empty' }, ['Nog geen dagen.']));
415
app.replaceChildren(el('section', { class: 'panel' }, [
416
el('h1', {}, ['Beheer']),
417
el('a', { class: 'button primary', href: '#/beheer/nieuw' }, ['Nieuwe dag']),
418
list,
419
]));
420
}
421
422
function tokenPanel(title, token) {
423
const field = el('textarea', { readonly: 'readonly', rows: '3' });
424
field.value = token;
425
const copy = el('button', { class: 'quiet', type: 'button' }, ['Kopieer']);
426
copy.addEventListener('click', async () => {
427
field.select();
428
try { await navigator.clipboard.writeText(field.value); toast('Gekopieerd.'); }
429
catch (failure) { toast('Selecteer de sleutel en kopieer hem handmatig.'); }
430
});
431
return el('div', { class: 'token-once' }, [el('strong', {}, [title]), field, copy]);
432
}
433
434
function paintKeys(keys) {
435
const name = el('input', { type: 'text', maxlength: '80', required: 'required' });
436
const error = el('p', { class: 'form-error' });
437
const form = el('form', {}, [
438
el('label', {}, ['Naam van de sleutel', name]),
439
el('button', { class: 'primary', type: 'submit' }, ['Sleutel aanmaken']),
440
error,
441
]);
442
form.addEventListener('submit', async (event) => {
443
event.preventDefault();
444
error.textContent = '';
445
try {
446
const result = await api('POST', '/keys', { name: name.value });
447
state.freshKey = result.key;
448
state.revealedKey = null;
449
await render();
450
} catch (failure) { error.textContent = failure.message; }
451
});
452
const section = el('section', { class: 'keys' }, [el('h1', {}, ['API-sleutels']), form]);
453
if (state.revealedKey && state.revealedKey.token) {
454
section.append(tokenPanel('Sleutel van ' + state.revealedKey.name, state.revealedKey.token));
455
} else if (state.freshKey && state.freshKey.token) {
456
section.append(tokenPanel('Nieuwe sleutel. Tik er later opnieuw op om hem te zien.', state.freshKey.token));
457
}
458
const list = el('div', {});
459
keys.forEach((key) => {
460
const open = el('button', { type: 'button', class: 'key-open' }, [
461
el('span', { class: key.revoked ? 'revoked' : '' }, [key.name]),
462
el('span', {}, [key.prefix + '…']),
463
el('span', {}, [key.revoked ? 'Ingetrokken' : 'Actief']),
464
]);
465
open.addEventListener('click', async () => {
466
try {
467
const result = await api('GET', '/keys/' + key.id);
468
state.freshKey = null;
469
state.revealedKey = result.key;
470
await render();
471
} catch (failure) { toast(failure.message); }
472
});
473
const revoke = el('button', { class: 'danger', type: 'button' }, ['Intrekken']);
474
revoke.disabled = key.revoked != null;
475
revoke.addEventListener('click', async () => {
476
if (!window.confirm('Deze API-sleutel intrekken? Bestaande scripts kunnen dan niet meer schrijven.')) return;
477
try { await api('DELETE', '/keys/' + key.id); await render(); }
478
catch (failure) { toast(failure.message); }
479
});
480
list.append(el('div', { class: 'key-row' }, [open, revoke]));
481
});
482
if (!keys.length) list.append(el('p', { class: 'empty' }, ['Nog geen sleutels.']));
483
section.append(el('h2', {}, ['Bestaande sleutels']), el('p', { class: 'lede' }, ['Tik op een sleutel om de volledige sleutel opnieuw te zien.']), list);
484
app.replaceChildren(section);
485
}
486
487
async function render() {
488
const token = ++renderToken;
489
const path = pathNow();
490
if (path !== '/sleutels') {
491
state.freshKey = null;
492
state.revealedKey = null;
493
}
494
closeMenu();
495
highlight(path);
496
document.title = 'Verhalenboek';
497
try {
498
if (path === '/' || path === '') {
499
const data = await api('GET', '/days');
500
if (token !== renderToken) return;
501
paintOverview(data.days);
502
} else if (path === '/instellingen') {
503
paintSettings();
504
} else if (path === '/beheer') {
505
if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }
506
await paintBeheer();
507
} else if (path === '/beheer/nieuw') {
508
if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }
509
await paintEditor(null);
510
} else if (/^\/beheer\/\d{4}-\d{2}-\d{2}$/.test(path)) {
511
if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }
512
await paintEditor(path.slice('/beheer/'.length));
513
} else if (path === '/sleutels') {
514
if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }
515
const data = await api('GET', '/keys');
516
if (token !== renderToken) return;
517
paintKeys(data.keys);
518
} else if (/^\/dag\/\d{4}-\d{2}-\d{2}$/.test(path)) {
519
const date = path.slice(5);
520
const day = await api('GET', '/days/' + date);
521
if (token !== renderToken) return;
522
paintDay(day);
523
document.title = day.title + ' · Verhalenboek';
524
if (!day.read) {
525
try { await api('POST', '/days/' + date + '/read'); } catch (error) { /* de pagina blijft leesbaar */ }
526
}
527
} else {
528
app.replaceChildren(el('p', { class: 'empty' }, ['Deze pagina bestaat niet.']), el('a', { href: '#/' }, ['Naar het overzicht']));
529
}
530
} catch (error) {
531
if (token !== renderToken) return;
532
if (error.status === 401) { window.location.href = 'index.php'; return; }
533
app.replaceChildren(el('p', { class: 'form-error' }, [error.message]), el('a', { href: '#/' }, ['Naar het overzicht']));
534
}
535
}
536
537
async function boot() {
538
bindReadMenu();
539
try {
540
const me = await api('GET', '/me');
541
state.me = me.user;
542
state.csrf = me.csrf;
543
state.local = !!me.local;
544
applyPrefs(me.user);
545
} catch (error) {
546
app.replaceChildren(el('p', { class: 'form-error' }, [error.message]));
547
return;
548
}
549
window.addEventListener('hashchange', () => { render(); });
550
if (!location.hash) location.replace('#/');
551
else render();
552
window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {
553
if (state.me && state.me.theme === 'system') applyPrefs(state.me);
554
});
555
}
@@ -0,0 +1,555 @@1
'use strict';2
3
const MONTHS = ['januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december'];4
const ROMAN = ['I', 'II', 'III'];5
const state = { me: null, csrf: '', local: false, freshKey: null, revealedKey: null };6
let renderToken = 0;7
let menuAnchor = null;8
let ignoreCloseUntil = 0;9
10
const app = document.querySelector('#app');11
if (app) boot();12
13
function formatDate(iso) {14
const [year, month, day] = iso.split('-').map(Number);15
return day + ' ' + MONTHS[month - 1] + ' ' + year;16
}17
18
function pathNow() {19
const raw = location.hash.replace(/^#/, '');20
if (!raw || raw === '/') return '/';21
return raw.startsWith('/') ? raw : '/' + raw;22
}23
24
function el(tag, attrs, children) {25
const node = document.createElement(tag);26
Object.entries(attrs || {}).forEach(([key, value]) => {27
if (value == null || value === false) return;28
if (key === 'class') node.className = value;29
else node.setAttribute(key, value === true ? '' : value);30
});31
(children || []).forEach((child) => node.append(child instanceof Node ? child : document.createTextNode(String(child))));32
return node;33
}34
35
function toast(message) {36
const node = document.querySelector('#toast');37
node.textContent = message;38
node.dataset.show = '1';39
clearTimeout(toast.timer);40
toast.timer = setTimeout(() => { node.dataset.show = '0'; }, 4200);41
}42
43
async function api(method, path, body) {44
const headers = { Accept: 'application/json' };45
if (body !== undefined) headers['Content-Type'] = 'application/json';46
if (method !== 'GET' && state.csrf) headers['X-CSRF-Token'] = state.csrf;47
const response = await fetch('api.php' + path, {48
method,49
headers,50
body: body !== undefined ? JSON.stringify(body) : undefined,51
});52
let data = null;53
try { data = await response.json(); } catch (error) { data = null; }54
if (!response.ok) {55
const failure = new Error((data && data.error) || 'Er ging iets mis.');56
failure.status = response.status;57
throw failure;58
}59
return data;60
}61
62
function applyPrefs(user) {63
document.documentElement.dataset.theme = user.theme || 'system';64
document.documentElement.dataset.font = user.font || 'serif';65
const dark = user.theme === 'dark' || (user.theme !== 'light' && window.matchMedia('(prefers-color-scheme: dark)').matches);66
const meta = document.querySelector('meta[name="theme-color"]');67
if (meta) meta.content = dark ? '#141210' : '#f4efe6';68
}69
70
function highlight(path) {71
document.querySelectorAll('[data-nav]').forEach((link) => {72
const nav = link.getAttribute('data-nav');73
const current = nav === '/beheer' ? path.startsWith('/beheer') : path === nav;74
if (current) link.setAttribute('aria-current', 'page');75
else link.removeAttribute('aria-current');76
});77
}78
79
function closeMenu() {80
const menu = document.querySelector('#read-menu');81
if (!menu || menu.hidden) return;82
menu.hidden = true;83
if (menuAnchor && menuAnchor.isConnected) menuAnchor.focus();84
menuAnchor = null;85
}86
87
function openMenu(x, y, day, anchor) {88
const menu = document.querySelector('#read-menu');89
menu.hidden = false;90
menu.dataset.date = day.date;91
menu.querySelector('[data-caption]').textContent = formatDate(day.date) + ' · ' + day.title;92
const button = menu.querySelector('button');93
button.textContent = day.read ? 'Markeer als ongelezen' : 'Markeer als gelezen';94
button.dataset.makeRead = day.read ? '0' : '1';95
menu.style.left = '0px';96
menu.style.top = '0px';97
const rect = menu.getBoundingClientRect();98
menu.style.left = Math.max(8, Math.min(x, window.innerWidth - rect.width - 8)) + 'px';99
menu.style.top = Math.max(8, Math.min(y, window.innerHeight - rect.height - 8)) + 'px';100
menuAnchor = anchor;101
ignoreCloseUntil = Date.now() + 450;102
button.focus();103
}104
105
function bindReadMenu() {106
const menu = document.querySelector('#read-menu');107
menu.querySelector('button').addEventListener('click', async () => {108
const date = menu.dataset.date;109
const makeRead = menu.querySelector('button').dataset.makeRead === '1';110
closeMenu();111
try {112
await api(makeRead ? 'POST' : 'DELETE', '/days/' + date + '/read');113
await render();114
} catch (error) {115
toast(error.message);116
}117
});118
document.addEventListener('click', (event) => {119
if (menu.hidden || Date.now() < ignoreCloseUntil || menu.contains(event.target)) return;120
closeMenu();121
});122
document.addEventListener('keydown', (event) => {123
if (event.key === 'Escape') closeMenu();124
});125
window.addEventListener('scroll', () => closeMenu(), true);126
}127
128
function bindDayLink(link, day) {129
let timer = null;130
let startX = 0;131
let startY = 0;132
let suppressClick = false;133
const cancel = () => {134
if (timer) clearTimeout(timer);135
timer = null;136
link.classList.remove('is-holding');137
};138
link.addEventListener('contextmenu', (event) => {139
event.preventDefault();140
cancel();141
suppressClick = true;142
openMenu(event.clientX, event.clientY, day, link);143
});144
link.addEventListener('pointerdown', (event) => {145
if (event.pointerType === 'mouse' || event.button !== 0) return;146
startX = event.clientX;147
startY = event.clientY;148
suppressClick = false;149
link.classList.add('is-holding');150
timer = setTimeout(() => {151
timer = null;152
suppressClick = true;153
openMenu(startX, startY, day, link);154
}, 550);155
});156
link.addEventListener('pointermove', (event) => {157
if (timer && Math.hypot(event.clientX - startX, event.clientY - startY) > 12) cancel();158
});159
link.addEventListener('pointerup', cancel);160
link.addEventListener('pointercancel', cancel);161
link.addEventListener('selectstart', (event) => event.preventDefault());162
link.addEventListener('dragstart', (event) => event.preventDefault());163
link.addEventListener('click', (event) => {164
if (!suppressClick) return;165
event.preventDefault();166
suppressClick = false;167
});168
}169
170
function unreadLabel(count) {171
if (count === 1) return '1 dag ongelezen';172
return count + ' dagen ongelezen';173
}174
175
function paintOverview(days) {176
const unread = days.filter((day) => !day.read);177
const wrap = el('div', { class: 'continue-wrap' });178
if (!days.length) {179
wrap.append(el('p', { class: 'empty' }, [state.me.admin ? 'Er staan nog geen dagen in het boek.' : 'Er staan nog geen verhalen klaar.']));180
if (state.me.admin) wrap.append(el('a', { class: 'button primary', href: '#/beheer/nieuw' }, ['Nieuwe dag']));181
} else if (unread.length) {182
wrap.append(el('a', { class: 'button primary continue', href: '#/dag/' + unread[0].date }, ['Verderlezen']));183
wrap.append(el('p', { class: 'continue-note' }, [unreadLabel(unread.length)]));184
} else {185
const done = el('button', { class: 'button continue', type: 'button', disabled: 'disabled' }, ['Alles gelezen']);186
wrap.append(done);187
}188
const list = el('ol', { class: 'day-list' });189
days.forEach((day) => {190
const link = el('a', { class: 'day-link ' + (day.read ? 'read' : 'unread'), href: '#/dag/' + day.date }, [191
el('span', { class: 'day-date' }, [formatDate(day.date)]),192
el('span', { class: 'day-state' }, [day.read ? 'Gelezen' : 'Ongelezen']),193
el('span', { class: 'day-title' }, [day.title]),194
]);195
if (!day.complete) link.append(el('span', { class: 'badge' }, ['Onvolledig']));196
bindDayLink(link, day);197
list.append(el('li', {}, [link]));198
});199
app.replaceChildren(el('h1', {}, ['Dagen']), wrap, list);200
const firstUnread = list.querySelector('.unread');201
if (firstUnread) firstUnread.scrollIntoView({ block: 'nearest' });202
}203
204
function paintDay(day) {205
const head = el('header', { class: 'day-head' }, [206
el('p', { class: 'day-kicker' }, [formatDate(day.date)]),207
el('h1', {}, [day.title]),208
]);209
const top = el('div', { class: 'pager' });210
if (day.previous) top.append(el('a', { class: 'button quiet', href: '#/dag/' + day.previous }, ['← Vorige dag']));211
const stories = day.stories.map((story) => el('article', { class: 'story' }, [212
el('h2', {}, [el('span', {}, [ROMAN[(story.position || 1) - 1] || String(story.position)]), story.title]),213
...story.paragraphs.map((paragraph) => el('p', {}, [paragraph])),214
]));215
if (!day.complete) stories.unshift(el('p', { class: 'form-error' }, ['Deze dag is onvolledig.']));216
const bottom = el('div', { class: 'pager bottom' });217
if (day.next) bottom.append(el('a', { class: 'button primary continue', href: '#/dag/' + day.next }, ['Volgende dag →']));218
else bottom.append(el('a', { class: 'button quiet', href: '#/' }, ['Terug naar het overzicht']));219
app.replaceChildren(head, top, ...stories, bottom);220
}221
222
function choice(name, value, label, current) {223
const input = el('input', { type: 'radio', name, value });224
input.checked = current === value;225
return el('label', {}, [input, label]);226
}227
228
function paintSettings() {229
const theme = el('fieldset', {}, [230
el('legend', {}, ['Weergave']),231
el('div', { class: 'choice' }, [232
choice('theme', 'system', 'Systeem', state.me.theme),233
choice('theme', 'light', 'Licht', state.me.theme),234
choice('theme', 'dark', 'Donker', state.me.theme),235
]),236
]);237
const font = el('fieldset', {}, [238
el('legend', {}, ['Lettertype']),239
el('div', { class: 'choice' }, [240
choice('font', 'serif', 'Serif', state.me.font),241
choice('font', 'sans', 'Schreefloos', state.me.font),242
choice('font', 'rounded', 'Rond', state.me.font),243
]),244
]);245
const preview = el('p', { class: 'lede' }, ['Zo lees je een verhaal. De regen tikte zacht op het dak, en de bladzijde bleef openliggen.']);246
const error = el('p', { class: 'form-error' });247
async function persist() {248
const nextTheme = theme.querySelector('input:checked').value;249
const nextFont = font.querySelector('input:checked').value;250
const previous = { theme: state.me.theme, font: state.me.font };251
state.me = { ...state.me, theme: nextTheme, font: nextFont };252
applyPrefs(state.me);253
try {254
const result = await api('PUT', '/me/settings', { theme: nextTheme, font: nextFont });255
state.me = result.user;256
applyPrefs(state.me);257
error.textContent = '';258
} catch (failure) {259
state.me = { ...state.me, ...previous };260
applyPrefs(state.me);261
theme.querySelector('input[value="' + previous.theme + '"]').checked = true;262
font.querySelector('input[value="' + previous.font + '"]').checked = true;263
error.textContent = failure.message;264
}265
}266
theme.addEventListener('change', persist);267
font.addEventListener('change', persist);268
const actions = el('div', { class: 'row-actions' }, [269
el('button', { class: 'quiet', type: 'button' }, ['Exporteer mijn gegevens (JSON)']),270
el('button', { class: 'danger', type: 'button' }, ['Uitloggen']),271
]);272
actions.children[0].addEventListener('click', () => { window.location.href = 'api.php/me/export'; });273
actions.children[1].addEventListener('click', async () => {274
try {275
await api('POST', '/session/logout');276
window.location.href = 'index.php';277
} catch (failure) { toast(failure.message); }278
});279
const section = el('section', { class: 'settings' }, [280
el('h1', {}, ['Instellingen']),281
el('p', { class: 'continue-note' }, ['Ingelogd als ' + state.me.name + (state.me.admin ? ' · beheerder' : '')]),282
theme, font, preview, error, actions,283
]);284
if (state.local) {285
const other = state.me.name === 'test_user_2' ? 'test_user_1' : 'test_user_2';286
const swap = el('button', { class: 'quiet', type: 'button' }, ['Wissel naar ' + other]);287
swap.addEventListener('click', async () => {288
try {289
await api('POST', '/session/switch', { user: other });290
window.location.reload();291
} catch (failure) { toast(failure.message); }292
});293
section.append(swap);294
}295
app.replaceChildren(section);296
}297
298
function paragraphField(value) {299
const area = el('textarea', { rows: '4' });300
area.value = value || '';301
const remove = el('button', { class: 'quiet', type: 'button' }, ['Alinea verwijderen']);302
const block = el('div', { class: 'paragraph-actions' }, [area, remove]);303
remove.addEventListener('click', () => {304
const boxes = block.parentElement.querySelectorAll('textarea');305
if (boxes.length <= 1) { area.value = ''; return; }306
block.remove();307
});308
return block;309
}310
311
function storyField(position, story, onDelete) {312
const title = el('input', { type: 'text', maxlength: '200', 'data-title': '1', required: 'required' });313
title.value = story.title || '';314
const paragraphs = el('div', {});315
(story.paragraphs && story.paragraphs.length ? story.paragraphs : ['']).forEach((paragraph) => paragraphs.append(paragraphField(paragraph)));316
const add = el('button', { class: 'quiet', type: 'button' }, ['Alinea toevoegen']);317
add.addEventListener('click', () => paragraphs.append(paragraphField('')));318
const fieldset = el('fieldset', { 'data-position': String(position) }, [319
el('legend', {}, ['Verhaal ' + ROMAN[position - 1]]),320
el('label', {}, ['Titel', title]),321
paragraphs,322
add,323
]);324
if (onDelete) {325
const remove = el('button', { class: 'danger', type: 'button' }, ['Dit verhaal verwijderen']);326
remove.addEventListener('click', onDelete);327
fieldset.append(remove);328
}329
return fieldset;330
}331
332
function readStories(form) {333
return [...form.querySelectorAll('fieldset')].map((fieldset) => ({334
title: fieldset.querySelector('[data-title]').value,335
paragraphs: [...fieldset.querySelectorAll('textarea')].map((area) => area.value),336
}));337
}338
339
async function paintEditor(date) {340
const creating = !date;341
let day = { title: '', stories: [{}, {}, {}] };342
if (!creating) day = await api('GET', '/days/' + date);343
const byPosition = {};344
(day.stories || []).forEach((story) => { byPosition[story.position] = story; });345
const title = el('input', { type: 'text', maxlength: '200', required: 'required' });346
title.value = day.title || '';347
const dateInput = el('input', { type: 'date', required: 'required' });348
if (creating) dateInput.value = '';349
else { dateInput.value = date; dateInput.readOnly = true; }350
const error = el('p', { class: 'form-error' });351
const form = el('form', { class: 'editor' }, [352
el('h1', {}, [creating ? 'Nieuwe dag' : 'Dag bewerken']),353
el('label', {}, ['Datum', dateInput]),354
el('label', {}, ['Titel van de dag', title]),355
]);356
for (let position = 1; position <= 3; position += 1) {357
const existing = byPosition[position];358
form.append(storyField(position, existing || { title: '', paragraphs: [''] }, !creating && existing ? async () => {359
if (!window.confirm('Dit verhaal verwijderen? De dag wordt onvolledig.')) return;360
try {361
await api('DELETE', '/days/' + date + '/stories/' + position);362
await render();363
} catch (failure) { error.textContent = failure.message; }364
} : null));365
}366
const save = el('button', { class: 'primary', type: 'submit' }, ['Dag opslaan']);367
form.append(error, save);368
if (!creating) {369
const remove = el('button', { class: 'danger', type: 'button' }, ['Hele dag verwijderen']);370
remove.addEventListener('click', async () => {371
if (!window.confirm('Deze dag en de bijbehorende verhalen verwijderen? Dit kan niet ongedaan worden.')) return;372
try {373
await api('DELETE', '/days/' + date);374
location.hash = '#/beheer';375
} catch (failure) { error.textContent = failure.message; }376
});377
form.append(remove);378
}379
form.addEventListener('submit', async (event) => {380
event.preventDefault();381
error.textContent = '';382
save.disabled = true;383
const payload = { title: title.value, stories: readStories(form) };384
try {385
if (creating) {386
const created = await api('POST', '/days', { date: dateInput.value, ...payload });387
location.hash = '#/beheer/' + created.date;388
} else {389
await api('PUT', '/days/' + date, payload);390
toast('Opgeslagen.');391
await render();392
}393
} catch (failure) {394
error.textContent = failure.message;395
save.disabled = false;396
}397
});398
app.replaceChildren(form);399
}400
401
async function paintBeheer() {402
const data = await api('GET', '/days');403
const list = el('div', {});404
data.days.forEach((day) => {405
list.append(el('div', { class: 'admin-day' }, [406
el('a', { href: '#/beheer/' + day.date }, [407
el('strong', {}, [day.title]),408
document.createElement('br'),409
el('small', {}, [formatDate(day.date) + (day.complete ? '' : ' · onvolledig')]),410
]),411
el('a', { class: 'button quiet', href: '#/dag/' + day.date }, ['Lezen']),412
]));413
});414
if (!data.days.length) list.append(el('p', { class: 'empty' }, ['Nog geen dagen.']));415
app.replaceChildren(el('section', { class: 'panel' }, [416
el('h1', {}, ['Beheer']),417
el('a', { class: 'button primary', href: '#/beheer/nieuw' }, ['Nieuwe dag']),418
list,419
]));420
}421
422
function tokenPanel(title, token) {423
const field = el('textarea', { readonly: 'readonly', rows: '3' });424
field.value = token;425
const copy = el('button', { class: 'quiet', type: 'button' }, ['Kopieer']);426
copy.addEventListener('click', async () => {427
field.select();428
try { await navigator.clipboard.writeText(field.value); toast('Gekopieerd.'); }429
catch (failure) { toast('Selecteer de sleutel en kopieer hem handmatig.'); }430
});431
return el('div', { class: 'token-once' }, [el('strong', {}, [title]), field, copy]);432
}433
434
function paintKeys(keys) {435
const name = el('input', { type: 'text', maxlength: '80', required: 'required' });436
const error = el('p', { class: 'form-error' });437
const form = el('form', {}, [438
el('label', {}, ['Naam van de sleutel', name]),439
el('button', { class: 'primary', type: 'submit' }, ['Sleutel aanmaken']),440
error,441
]);442
form.addEventListener('submit', async (event) => {443
event.preventDefault();444
error.textContent = '';445
try {446
const result = await api('POST', '/keys', { name: name.value });447
state.freshKey = result.key;448
state.revealedKey = null;449
await render();450
} catch (failure) { error.textContent = failure.message; }451
});452
const section = el('section', { class: 'keys' }, [el('h1', {}, ['API-sleutels']), form]);453
if (state.revealedKey && state.revealedKey.token) {454
section.append(tokenPanel('Sleutel van ' + state.revealedKey.name, state.revealedKey.token));455
} else if (state.freshKey && state.freshKey.token) {456
section.append(tokenPanel('Nieuwe sleutel. Tik er later opnieuw op om hem te zien.', state.freshKey.token));457
}458
const list = el('div', {});459
keys.forEach((key) => {460
const open = el('button', { type: 'button', class: 'key-open' }, [461
el('span', { class: key.revoked ? 'revoked' : '' }, [key.name]),462
el('span', {}, [key.prefix + '…']),463
el('span', {}, [key.revoked ? 'Ingetrokken' : 'Actief']),464
]);465
open.addEventListener('click', async () => {466
try {467
const result = await api('GET', '/keys/' + key.id);468
state.freshKey = null;469
state.revealedKey = result.key;470
await render();471
} catch (failure) { toast(failure.message); }472
});473
const revoke = el('button', { class: 'danger', type: 'button' }, ['Intrekken']);474
revoke.disabled = key.revoked != null;475
revoke.addEventListener('click', async () => {476
if (!window.confirm('Deze API-sleutel intrekken? Bestaande scripts kunnen dan niet meer schrijven.')) return;477
try { await api('DELETE', '/keys/' + key.id); await render(); }478
catch (failure) { toast(failure.message); }479
});480
list.append(el('div', { class: 'key-row' }, [open, revoke]));481
});482
if (!keys.length) list.append(el('p', { class: 'empty' }, ['Nog geen sleutels.']));483
section.append(el('h2', {}, ['Bestaande sleutels']), el('p', { class: 'lede' }, ['Tik op een sleutel om de volledige sleutel opnieuw te zien.']), list);484
app.replaceChildren(section);485
}486
487
async function render() {488
const token = ++renderToken;489
const path = pathNow();490
if (path !== '/sleutels') {491
state.freshKey = null;492
state.revealedKey = null;493
}494
closeMenu();495
highlight(path);496
document.title = 'Verhalenboek';497
try {498
if (path === '/' || path === '') {499
const data = await api('GET', '/days');500
if (token !== renderToken) return;501
paintOverview(data.days);502
} else if (path === '/instellingen') {503
paintSettings();504
} else if (path === '/beheer') {505
if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }506
await paintBeheer();507
} else if (path === '/beheer/nieuw') {508
if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }509
await paintEditor(null);510
} else if (/^\/beheer\/\d{4}-\d{2}-\d{2}$/.test(path)) {511
if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }512
await paintEditor(path.slice('/beheer/'.length));513
} else if (path === '/sleutels') {514
if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }515
const data = await api('GET', '/keys');516
if (token !== renderToken) return;517
paintKeys(data.keys);518
} else if (/^\/dag\/\d{4}-\d{2}-\d{2}$/.test(path)) {519
const date = path.slice(5);520
const day = await api('GET', '/days/' + date);521
if (token !== renderToken) return;522
paintDay(day);523
document.title = day.title + ' · Verhalenboek';524
if (!day.read) {525
try { await api('POST', '/days/' + date + '/read'); } catch (error) { /* de pagina blijft leesbaar */ }526
}527
} else {528
app.replaceChildren(el('p', { class: 'empty' }, ['Deze pagina bestaat niet.']), el('a', { href: '#/' }, ['Naar het overzicht']));529
}530
} catch (error) {531
if (token !== renderToken) return;532
if (error.status === 401) { window.location.href = 'index.php'; return; }533
app.replaceChildren(el('p', { class: 'form-error' }, [error.message]), el('a', { href: '#/' }, ['Naar het overzicht']));534
}535
}536
537
async function boot() {538
bindReadMenu();539
try {540
const me = await api('GET', '/me');541
state.me = me.user;542
state.csrf = me.csrf;543
state.local = !!me.local;544
applyPrefs(me.user);545
} catch (error) {546
app.replaceChildren(el('p', { class: 'form-error' }, [error.message]));547
return;548
}549
window.addEventListener('hashchange', () => { render(); });550
if (!location.hash) location.replace('#/');551
else render();552
window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {553
if (state.me && state.me.theme === 'system') applyPrefs(state.me);554
});555
}@@ -0,0 +1,6 @@
1
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Verhalenboek">
2
<rect width="64" height="64" rx="14" fill="#9a4032"/>
3
<path fill="#fffaf3" d="M16 14h24a8 8 0 0 1 8 8v26a8 8 0 0 0-8-6H16V14z"/>
4
<path fill="#f0e2d4" d="M16 42h24a8 8 0 0 1 8 8v0H22a6 6 0 0 1-6-6v-2z"/>
5
<path stroke="#9a4032" stroke-width="1.5" d="M24 24h14M24 30h14M24 36h9"/>
6
</svg>
@@ -0,0 +1,6 @@1
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Verhalenboek">2
<rect width="64" height="64" rx="14" fill="#9a4032"/>3
<path fill="#fffaf3" d="M16 14h24a8 8 0 0 1 8 8v26a8 8 0 0 0-8-6H16V14z"/>4
<path fill="#f0e2d4" d="M16 42h24a8 8 0 0 1 8 8v0H22a6 6 0 0 1-6-6v-2z"/>5
<path stroke="#9a4032" stroke-width="1.5" d="M24 24h14M24 30h14M24 36h9"/>6
</svg>@@ -0,0 +1,20 @@
1
<?php
2
declare(strict_types=1);
3
require __DIR__.'/lib/bootstrap.php';
4
try {
5
$cfg = config();
6
if (($cfg['client_id'] ?? '') === '' || ($cfg['client_secret'] ?? '') === '') {
7
throw new RuntimeException('Productie-login heeft een geregistreerde client-id en een geheim nodig. Zie README.md.');
8
}
9
$_SESSION['oauth_state'] = bin2hex(random_bytes(32));
10
$_SESSION['oauth_started'] = time();
11
header('Location: https://auth.timfalken.com/oauth/authorize?'.http_build_query([
12
'client_id' => $cfg['client_id'],
13
'redirect_uri' => baseUrl().'/callback.php',
14
'response_type' => 'code',
15
'state' => $_SESSION['oauth_state'],
16
]));
17
} catch (Throwable $e) {
18
http_response_code(503);
19
echo htmlspecialchars($e->getMessage());
20
}
@@ -0,0 +1,20 @@1
<?php2
declare(strict_types=1);3
require __DIR__.'/lib/bootstrap.php';4
try {5
$cfg = config();6
if (($cfg['client_id'] ?? '') === '' || ($cfg['client_secret'] ?? '') === '') {7
throw new RuntimeException('Productie-login heeft een geregistreerde client-id en een geheim nodig. Zie README.md.');8
}9
$_SESSION['oauth_state'] = bin2hex(random_bytes(32));10
$_SESSION['oauth_started'] = time();11
header('Location: https://auth.timfalken.com/oauth/authorize?'.http_build_query([12
'client_id' => $cfg['client_id'],13
'redirect_uri' => baseUrl().'/callback.php',14
'response_type' => 'code',15
'state' => $_SESSION['oauth_state'],16
]));17
} catch (Throwable $e) {18
http_response_code(503);19
echo htmlspecialchars($e->getMessage());20
}@@ -0,0 +1,34 @@
1
<?php
2
declare(strict_types=1);
3
require __DIR__.'/lib/bootstrap.php';
4
try {
5
$state = $_GET['state'] ?? null;
6
if (!is_string($state) || !isset($_SESSION['oauth_state']) || !hash_equals((string)$_SESSION['oauth_state'], $state) || time() - (int)($_SESSION['oauth_started'] ?? 0) > 600) {
7
throw new RuntimeException('Ongeldige of verlopen login.');
8
}
9
unset($_SESSION['oauth_state'], $_SESSION['oauth_started']);
10
$code = $_GET['code'] ?? null;
11
if (!is_string($code) || $code === '') throw new RuntimeException('De login is niet afgerond.');
12
$cfg = config();
13
$token = authRequest('/oauth/token', [
14
'grant_type' => 'authorization_code',
15
'code' => $code,
16
'client_id' => $cfg['client_id'],
17
'client_secret' => $cfg['client_secret'],
18
'redirect_uri' => baseUrl().'/callback.php',
19
]);
20
if (!isset($token['access_token'], $token['expires_in']) || !is_string($token['access_token'])) {
21
throw new RuntimeException('Geen toegangstoken ontvangen.');
22
}
23
$me = authRequest('/api/me', null, $token['access_token']);
24
if (!isset($me['user']) || !is_array($me['user'])) throw new RuntimeException('Het profiel ontbreekt.');
25
[$id, $name] = authIdentity($me['user']);
26
loginUser($id, $name);
27
$_SESSION['token'] = $token['access_token'];
28
$_SESSION['expires'] = time() + (int)$token['expires_in'];
29
$_SESSION['validated'] = time();
30
header('Location: '.baseUrl().'/');
31
} catch (Throwable $e) {
32
http_response_code(401);
33
echo 'Inloggen is mislukt. '.htmlspecialchars($e->getMessage()).' <a href="auth.php">Opnieuw proberen</a>';
34
}
@@ -0,0 +1,34 @@1
<?php2
declare(strict_types=1);3
require __DIR__.'/lib/bootstrap.php';4
try {5
$state = $_GET['state'] ?? null;6
if (!is_string($state) || !isset($_SESSION['oauth_state']) || !hash_equals((string)$_SESSION['oauth_state'], $state) || time() - (int)($_SESSION['oauth_started'] ?? 0) > 600) {7
throw new RuntimeException('Ongeldige of verlopen login.');8
}9
unset($_SESSION['oauth_state'], $_SESSION['oauth_started']);10
$code = $_GET['code'] ?? null;11
if (!is_string($code) || $code === '') throw new RuntimeException('De login is niet afgerond.');12
$cfg = config();13
$token = authRequest('/oauth/token', [14
'grant_type' => 'authorization_code',15
'code' => $code,16
'client_id' => $cfg['client_id'],17
'client_secret' => $cfg['client_secret'],18
'redirect_uri' => baseUrl().'/callback.php',19
]);20
if (!isset($token['access_token'], $token['expires_in']) || !is_string($token['access_token'])) {21
throw new RuntimeException('Geen toegangstoken ontvangen.');22
}23
$me = authRequest('/api/me', null, $token['access_token']);24
if (!isset($me['user']) || !is_array($me['user'])) throw new RuntimeException('Het profiel ontbreekt.');25
[$id, $name] = authIdentity($me['user']);26
loginUser($id, $name);27
$_SESSION['token'] = $token['access_token'];28
$_SESSION['expires'] = time() + (int)$token['expires_in'];29
$_SESSION['validated'] = time();30
header('Location: '.baseUrl().'/');31
} catch (Throwable $e) {32
http_response_code(401);33
echo 'Inloggen is mislukt. '.htmlspecialchars($e->getMessage()).' <a href="auth.php">Opnieuw proberen</a>';34
}@@ -0,0 +1 @@
1
Require all denied
@@ -0,0 +1 @@1
Require all denied@@ -0,0 +1,81 @@
1
<?php
2
declare(strict_types=1);
3
require __DIR__.'/lib/bootstrap.php';
4
$base = 'https://projects.timfalken.com/verhaaltjesboek';
5
?>
6
<!doctype html>
7
<html lang="nl" data-theme="system" data-font="sans">
8
<head>
9
<meta charset="utf-8">
10
<meta name="viewport" content="width=device-width, initial-scale=1">
11
<title>API · Verhalenboek</title>
12
<link rel="icon" href="<?= htmlspecialchars(assetUrl('assets/favicon.svg'), ENT_QUOTES) ?>" type="image/svg+xml">
13
<link rel="stylesheet" href="<?= htmlspecialchars(assetUrl('assets/app.css'), ENT_QUOTES) ?>">
14
</head>
15
<body>
16
<article class="docs">
17
<p><a href="./">← Verhalenboek</a></p>
18
<h1>API</h1>
19
<p>JSON REST voor een schrijver-agent. Elke aanvraag gaat naar <code>api.php</code> gevolgd door het pad, bijvoorbeeld <code><?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days</code>. Lokaal is het pad hetzelfde op de ontwikkelserver.</p>
20
<p>Authenticatie: <code>Authorization: Bearer vb_…</code>. Een beheerder maakt sleutels aan onder Sleutels (<code><?= htmlspecialchars($base, ENT_QUOTES) ?>/#/sleutels</code>) en kan een bestaande sleutel daar opnieuw tonen. Stuur <code>Accept: application/json</code> en, bij een body, <code>Content-Type: application/json</code>. Fouten zijn JSON met status 401, 403, 404, 405, 409 of 422.</p>
21
<h2>Geen of ongeldige authenticatie</h2>
22
<p>Een 401 heeft de header <code>WWW-Authenticate: Bearer</code>. Een 401, en een 403 wanneer een lezer iets doet dat een sleutel of beheerder vereist, bevat naast <code>error</code> ook <code>how_to_authenticate</code> en dezelfde tekst in <code>hint</code>. Die tekst onderscheidt drie gevallen en verwijst naar deze pagina:</p>
23
<ul>
24
<li><strong>Geen header.</strong> Er is geen <code>Authorization</code>-header.</li>
25
<li><strong>Verkeerd formaat.</strong> De header is geen <code>Bearer</code>, of de sleutel is niet <code>vb_</code> plus 64 hexadecimale tekens.</li>
26
<li><strong>Onbekend of ingetrokken.</strong> Het formaat klopt, maar de sleutel bestaat niet of is ingetrokken.</li>
27
</ul>
28
<p>Voorbeeld bij een ontbrekende header:</p>
29
<pre><code>{
30
"error": "Log in om verder te gaan.",
31
"how_to_authenticate": "Er is geen Authorization-header. Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Sleutels op <?= htmlspecialchars($base, ENT_QUOTES) ?>/#/sleutels. Uitleg: <?= htmlspecialchars($base, ENT_QUOTES) ?>/docs.php",
32
"hint": "…"
33
}</code></pre>
34
<p><code>hint</code> is dezelfde tekst als <code>how_to_authenticate</code>. Een 403 voor een lezer die wil schrijven legt uit dat een API-sleutel of een beheerder nodig is. Sleutels beheren kan alleen in de ingelogde beheerderssessie, niet met de sleutel zelf. Een 403 door een ongeldige sessiecookie (CSRF) heeft deze uitleg niet.</p>
35
<h2>Dagen</h2>
36
<table>
37
<thead><tr><th>Methode</th><th>Pad</th><th>Wat</th></tr></thead>
38
<tbody>
39
<tr><td>GET</td><td><code>/days</code></td><td>Alle dagen, oudste eerst.</td></tr>
40
<tr><td>GET</td><td><code>/days/latest</code></td><td>De nieuwste datum die nog een dagrecord heeft, ook als die onvolledig is. 404 als er nog niets is.</td></tr>
41
<tr><td>GET</td><td><code>/days/gaps</code></td><td>Ontbrekende datums tussen de eerste en de laatste dag, plus dagen met minder dan drie verhalen.</td></tr>
42
<tr><td>GET</td><td><code>/days/JJJJ-MM-DD</code></td><td>Dag met verhalen, vorige en volgende bestaande dag.</td></tr>
43
<tr><td>POST</td><td><code>/days</code></td><td>Maak één volledige dag met precies drie verhalen.</td></tr>
44
<tr><td>PUT</td><td><code>/days/JJJJ-MM-DD</code></td><td>Werk de titel bij en/of vervang alle verhalen (dan weer precies drie).</td></tr>
45
<tr><td>DELETE</td><td><code>/days/JJJJ-MM-DD</code></td><td>Verwijder de dag.</td></tr>
46
<tr><td>POST</td><td><code>/days/JJJJ-MM-DD/stories</code></td><td>Voeg een verhaal toe zolang er minder dan drie zijn. <code>position</code> is optioneel (1, 2 of 3).</td></tr>
47
<tr><td>PUT</td><td><code>/days/JJJJ-MM-DD/stories/1</code></td><td>Werk titel en/of alinea's van plek 1, 2 of 3 bij.</td></tr>
48
<tr><td>DELETE</td><td><code>/days/JJJJ-MM-DD/stories/2</code></td><td>Verwijder één verhaal. De andere plekken blijven staan, de dag wordt onvolledig.</td></tr>
49
</tbody>
50
</table>
51
<p>Een verhaal heeft een titel en minstens één alinea. De volgorde in <code>stories</code> wordt plek 1, 2 en 3. Een dag die al bestaat geeft 409. Een ongeldige of onvolledige dag geeft 422.</p>
52
<h2>Voorbeeld: een dag in één aanroep</h2>
53
<pre><code>curl -sS -X POST \
54
-H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
55
-H 'Accept: application/json' \
56
-H 'Content-Type: application/json' \
57
-d '{"date":"2026-10-05","title":"De herfstwind","stories":[
58
{"title":"Ochtend","paragraphs":["De wind stond al vroeg aan de deur."]},
59
{"title":"Middag","paragraphs":["Op het plein joeg een krant zichzelf achterna.","Iemand lachte en liep door."]},
60
{"title":"Avond","paragraphs":["Het licht in de keuken bleef aan tot de wind ging liggen."]}
61
]}' \
62
'<?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days'</code></pre>
63
<h2>Laatste datum en gaten</h2>
64
<pre><code>curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
65
'<?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days/latest'
66
67
curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
68
'<?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days/gaps'</code></pre>
69
<p><code>latest</code> antwoordt met <code>date</code>, <code>title</code>, <code>storyCount</code> en <code>complete</code>. <code>gaps</code> antwoordt met <code>first</code>, <code>latest</code>, <code>missing</code> (datums zonder dag) en <code>incomplete</code> (datums die bestaan maar geen drie verhalen meer hebben, met <code>missingPositions</code>).</p>
70
<p>Staat een datum in <code>missing</code>, maak hem dan met POST. Staat hij in <code>incomplete</code>, vul de ontbrekende plek met POST <code>/stories</code> of vervang de dag met PUT en precies drie verhalen.</p>
71
<h2>Eén verhaal wijzigen</h2>
72
<pre><code>curl -sS -X PUT \
73
-H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
74
-H 'Accept: application/json' \
75
-H 'Content-Type: application/json' \
76
-d '{"title":"Middaglicht","paragraphs":["De schaduw werd korter."] }' \
77
'<?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days/2026-10-05/stories/2'</code></pre>
78
<p>Lezers gebruiken deze sleutel niet. Hun gelezen-status hoort bij een ingelogde sessie: POST of DELETE <code>/days/JJJJ-MM-DD/read</code>.</p>
79
</article>
80
</body>
81
</html>
@@ -0,0 +1,81 @@1
<?php2
declare(strict_types=1);3
require __DIR__.'/lib/bootstrap.php';4
$base = 'https://projects.timfalken.com/verhaaltjesboek';5
?>6
<!doctype html>7
<html lang="nl" data-theme="system" data-font="sans">8
<head>9
<meta charset="utf-8">10
<meta name="viewport" content="width=device-width, initial-scale=1">11
<title>API · Verhalenboek</title>12
<link rel="icon" href="<?= htmlspecialchars(assetUrl('assets/favicon.svg'), ENT_QUOTES) ?>" type="image/svg+xml">13
<link rel="stylesheet" href="<?= htmlspecialchars(assetUrl('assets/app.css'), ENT_QUOTES) ?>">14
</head>15
<body>16
<article class="docs">17
<p><a href="./">← Verhalenboek</a></p>18
<h1>API</h1>19
<p>JSON REST voor een schrijver-agent. Elke aanvraag gaat naar <code>api.php</code> gevolgd door het pad, bijvoorbeeld <code><?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days</code>. Lokaal is het pad hetzelfde op de ontwikkelserver.</p>20
<p>Authenticatie: <code>Authorization: Bearer vb_…</code>. Een beheerder maakt sleutels aan onder Sleutels (<code><?= htmlspecialchars($base, ENT_QUOTES) ?>/#/sleutels</code>) en kan een bestaande sleutel daar opnieuw tonen. Stuur <code>Accept: application/json</code> en, bij een body, <code>Content-Type: application/json</code>. Fouten zijn JSON met status 401, 403, 404, 405, 409 of 422.</p>21
<h2>Geen of ongeldige authenticatie</h2>22
<p>Een 401 heeft de header <code>WWW-Authenticate: Bearer</code>. Een 401, en een 403 wanneer een lezer iets doet dat een sleutel of beheerder vereist, bevat naast <code>error</code> ook <code>how_to_authenticate</code> en dezelfde tekst in <code>hint</code>. Die tekst onderscheidt drie gevallen en verwijst naar deze pagina:</p>23
<ul>24
<li><strong>Geen header.</strong> Er is geen <code>Authorization</code>-header.</li>25
<li><strong>Verkeerd formaat.</strong> De header is geen <code>Bearer</code>, of de sleutel is niet <code>vb_</code> plus 64 hexadecimale tekens.</li>26
<li><strong>Onbekend of ingetrokken.</strong> Het formaat klopt, maar de sleutel bestaat niet of is ingetrokken.</li>27
</ul>28
<p>Voorbeeld bij een ontbrekende header:</p>29
<pre><code>{30
"error": "Log in om verder te gaan.",31
"how_to_authenticate": "Er is geen Authorization-header. Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Sleutels op <?= htmlspecialchars($base, ENT_QUOTES) ?>/#/sleutels. Uitleg: <?= htmlspecialchars($base, ENT_QUOTES) ?>/docs.php",32
"hint": "…"33
}</code></pre>34
<p><code>hint</code> is dezelfde tekst als <code>how_to_authenticate</code>. Een 403 voor een lezer die wil schrijven legt uit dat een API-sleutel of een beheerder nodig is. Sleutels beheren kan alleen in de ingelogde beheerderssessie, niet met de sleutel zelf. Een 403 door een ongeldige sessiecookie (CSRF) heeft deze uitleg niet.</p>35
<h2>Dagen</h2>36
<table>37
<thead><tr><th>Methode</th><th>Pad</th><th>Wat</th></tr></thead>38
<tbody>39
<tr><td>GET</td><td><code>/days</code></td><td>Alle dagen, oudste eerst.</td></tr>40
<tr><td>GET</td><td><code>/days/latest</code></td><td>De nieuwste datum die nog een dagrecord heeft, ook als die onvolledig is. 404 als er nog niets is.</td></tr>41
<tr><td>GET</td><td><code>/days/gaps</code></td><td>Ontbrekende datums tussen de eerste en de laatste dag, plus dagen met minder dan drie verhalen.</td></tr>42
<tr><td>GET</td><td><code>/days/JJJJ-MM-DD</code></td><td>Dag met verhalen, vorige en volgende bestaande dag.</td></tr>43
<tr><td>POST</td><td><code>/days</code></td><td>Maak één volledige dag met precies drie verhalen.</td></tr>44
<tr><td>PUT</td><td><code>/days/JJJJ-MM-DD</code></td><td>Werk de titel bij en/of vervang alle verhalen (dan weer precies drie).</td></tr>45
<tr><td>DELETE</td><td><code>/days/JJJJ-MM-DD</code></td><td>Verwijder de dag.</td></tr>46
<tr><td>POST</td><td><code>/days/JJJJ-MM-DD/stories</code></td><td>Voeg een verhaal toe zolang er minder dan drie zijn. <code>position</code> is optioneel (1, 2 of 3).</td></tr>47
<tr><td>PUT</td><td><code>/days/JJJJ-MM-DD/stories/1</code></td><td>Werk titel en/of alinea's van plek 1, 2 of 3 bij.</td></tr>48
<tr><td>DELETE</td><td><code>/days/JJJJ-MM-DD/stories/2</code></td><td>Verwijder één verhaal. De andere plekken blijven staan, de dag wordt onvolledig.</td></tr>49
</tbody>50
</table>51
<p>Een verhaal heeft een titel en minstens één alinea. De volgorde in <code>stories</code> wordt plek 1, 2 en 3. Een dag die al bestaat geeft 409. Een ongeldige of onvolledige dag geeft 422.</p>52
<h2>Voorbeeld: een dag in één aanroep</h2>53
<pre><code>curl -sS -X POST \54
-H 'Authorization: Bearer vb_JOUW_SLEUTEL' \55
-H 'Accept: application/json' \56
-H 'Content-Type: application/json' \57
-d '{"date":"2026-10-05","title":"De herfstwind","stories":[58
{"title":"Ochtend","paragraphs":["De wind stond al vroeg aan de deur."]},59
{"title":"Middag","paragraphs":["Op het plein joeg een krant zichzelf achterna.","Iemand lachte en liep door."]},60
{"title":"Avond","paragraphs":["Het licht in de keuken bleef aan tot de wind ging liggen."]}61
]}' \62
'<?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days'</code></pre>63
<h2>Laatste datum en gaten</h2>64
<pre><code>curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \65
'<?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days/latest'66
67
curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \68
'<?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days/gaps'</code></pre>69
<p><code>latest</code> antwoordt met <code>date</code>, <code>title</code>, <code>storyCount</code> en <code>complete</code>. <code>gaps</code> antwoordt met <code>first</code>, <code>latest</code>, <code>missing</code> (datums zonder dag) en <code>incomplete</code> (datums die bestaan maar geen drie verhalen meer hebben, met <code>missingPositions</code>).</p>70
<p>Staat een datum in <code>missing</code>, maak hem dan met POST. Staat hij in <code>incomplete</code>, vul de ontbrekende plek met POST <code>/stories</code> of vervang de dag met PUT en precies drie verhalen.</p>71
<h2>Eén verhaal wijzigen</h2>72
<pre><code>curl -sS -X PUT \73
-H 'Authorization: Bearer vb_JOUW_SLEUTEL' \74
-H 'Accept: application/json' \75
-H 'Content-Type: application/json' \76
-d '{"title":"Middaglicht","paragraphs":["De schaduw werd korter."] }' \77
'<?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days/2026-10-05/stories/2'</code></pre>78
<p>Lezers gebruiken deze sleutel niet. Hun gelezen-status hoort bij een ingelogde sessie: POST of DELETE <code>/days/JJJJ-MM-DD/read</code>.</p>79
</article>80
</body>81
</html>@@ -0,0 +1,55 @@
1
<?php
2
declare(strict_types=1);
3
require __DIR__.'/lib/bootstrap.php';
4
$logged = isset($_SESSION['user']) && (localDev() || (($_SESSION['expires'] ?? 0) > time()));
5
$prefs = ['theme' => 'system', 'font' => 'serif', 'name' => '', 'role' => 'user'];
6
if ($logged) {
7
$row = query('SELECT name, role, theme, font FROM users WHERE id=?', [$_SESSION['user']])->fetch();
8
if ($row) $prefs = $row;
9
}
10
$theme = in_array($prefs['theme'] ?? '', ['system', 'light', 'dark'], true) ? $prefs['theme'] : 'system';
11
$font = in_array($prefs['font'] ?? '', ['serif', 'sans', 'rounded'], true) ? $prefs['font'] : 'serif';
12
$themeColor = $theme === 'dark' ? '#141210' : '#f4efe6';
13
?>
14
<!doctype html>
15
<html lang="nl" data-theme="<?= htmlspecialchars($theme, ENT_QUOTES) ?>" data-font="<?= htmlspecialchars($font, ENT_QUOTES) ?>">
16
<head>
17
<meta charset="utf-8">
18
<meta name="viewport" content="width=device-width, initial-scale=1">
19
<meta name="theme-color" content="<?= htmlspecialchars($themeColor, ENT_QUOTES) ?>">
20
<title>Verhalenboek</title>
21
<link rel="icon" href="<?= htmlspecialchars(assetUrl('assets/favicon.svg'), ENT_QUOTES) ?>" type="image/svg+xml">
22
<link rel="stylesheet" href="<?= htmlspecialchars(assetUrl('assets/app.css'), ENT_QUOTES) ?>">
23
<?php if ($logged): ?><script src="<?= htmlspecialchars(assetUrl('assets/app.js'), ENT_QUOTES) ?>" defer></script><?php endif ?>
24
</head>
25
<body>
26
<?php if (!$logged): ?>
27
<main class="gate">
28
<p class="eyebrow">Elke dag drie verhalen</p>
29
<h1>Verhalenboek</h1>
30
<p class="lede">Lees de dagen in volgorde, of verder waar je gebleven was. Inloggen gaat via het account van Tim Falken.</p>
31
<a class="button primary" href="auth.php">Inloggen</a>
32
<p class="gate-links"><a href="docs.php">API-documentatie</a></p>
33
</main>
34
<?php else: ?>
35
<header class="topbar">
36
<a class="brand" href="#/"><img src="<?= htmlspecialchars(assetUrl('assets/favicon.svg'), ENT_QUOTES) ?>" alt="">Verhalenboek</a>
37
<nav class="nav" aria-label="Hoofdmenu">
38
<a href="#/" data-nav="/">Overzicht</a>
39
<a href="#/instellingen" data-nav="/instellingen">Instellingen</a>
40
<?php if (($prefs['role'] ?? '') === 'admin'): ?>
41
<a href="#/beheer" data-nav="/beheer">Beheer</a>
42
<a href="#/sleutels" data-nav="/sleutels">Sleutels</a>
43
<a href="docs.php">API</a>
44
<?php endif ?>
45
</nav>
46
</header>
47
<main id="app" tabindex="-1"><p class="status">Bezig met laden…</p></main>
48
<div id="toast" role="status" aria-live="polite"></div>
49
<div id="read-menu" class="read-menu" role="menu" hidden>
50
<p data-caption></p>
51
<button type="button" role="menuitem"></button>
52
</div>
53
<?php endif ?>
54
</body>
55
</html>
@@ -0,0 +1,55 @@1
<?php2
declare(strict_types=1);3
require __DIR__.'/lib/bootstrap.php';4
$logged = isset($_SESSION['user']) && (localDev() || (($_SESSION['expires'] ?? 0) > time()));5
$prefs = ['theme' => 'system', 'font' => 'serif', 'name' => '', 'role' => 'user'];6
if ($logged) {7
$row = query('SELECT name, role, theme, font FROM users WHERE id=?', [$_SESSION['user']])->fetch();8
if ($row) $prefs = $row;9
}10
$theme = in_array($prefs['theme'] ?? '', ['system', 'light', 'dark'], true) ? $prefs['theme'] : 'system';11
$font = in_array($prefs['font'] ?? '', ['serif', 'sans', 'rounded'], true) ? $prefs['font'] : 'serif';12
$themeColor = $theme === 'dark' ? '#141210' : '#f4efe6';13
?>14
<!doctype html>15
<html lang="nl" data-theme="<?= htmlspecialchars($theme, ENT_QUOTES) ?>" data-font="<?= htmlspecialchars($font, ENT_QUOTES) ?>">16
<head>17
<meta charset="utf-8">18
<meta name="viewport" content="width=device-width, initial-scale=1">19
<meta name="theme-color" content="<?= htmlspecialchars($themeColor, ENT_QUOTES) ?>">20
<title>Verhalenboek</title>21
<link rel="icon" href="<?= htmlspecialchars(assetUrl('assets/favicon.svg'), ENT_QUOTES) ?>" type="image/svg+xml">22
<link rel="stylesheet" href="<?= htmlspecialchars(assetUrl('assets/app.css'), ENT_QUOTES) ?>">23
<?php if ($logged): ?><script src="<?= htmlspecialchars(assetUrl('assets/app.js'), ENT_QUOTES) ?>" defer></script><?php endif ?>24
</head>25
<body>26
<?php if (!$logged): ?>27
<main class="gate">28
<p class="eyebrow">Elke dag drie verhalen</p>29
<h1>Verhalenboek</h1>30
<p class="lede">Lees de dagen in volgorde, of verder waar je gebleven was. Inloggen gaat via het account van Tim Falken.</p>31
<a class="button primary" href="auth.php">Inloggen</a>32
<p class="gate-links"><a href="docs.php">API-documentatie</a></p>33
</main>34
<?php else: ?>35
<header class="topbar">36
<a class="brand" href="#/"><img src="<?= htmlspecialchars(assetUrl('assets/favicon.svg'), ENT_QUOTES) ?>" alt="">Verhalenboek</a>37
<nav class="nav" aria-label="Hoofdmenu">38
<a href="#/" data-nav="/">Overzicht</a>39
<a href="#/instellingen" data-nav="/instellingen">Instellingen</a>40
<?php if (($prefs['role'] ?? '') === 'admin'): ?>41
<a href="#/beheer" data-nav="/beheer">Beheer</a>42
<a href="#/sleutels" data-nav="/sleutels">Sleutels</a>43
<a href="docs.php">API</a>44
<?php endif ?>45
</nav>46
</header>47
<main id="app" tabindex="-1"><p class="status">Bezig met laden…</p></main>48
<div id="toast" role="status" aria-live="polite"></div>49
<div id="read-menu" class="read-menu" role="menu" hidden>50
<p data-caption></p>51
<button type="button" role="menuitem"></button>52
</div>53
<?php endif ?>54
</body>55
</html>@@ -0,0 +1 @@
1
Require all denied
@@ -0,0 +1 @@1
Require all denied@@ -0,0 +1,398 @@
1
<?php
2
declare(strict_types=1);
3
4
final class AppException extends RuntimeException {
5
public function __construct(string $message, public int $status = 422, public ?string $auth = null) {
6
parent::__construct($message);
7
}
8
}
9
10
function transaction(callable $fn): mixed {
11
$pdo = db();
12
$pdo->exec('BEGIN IMMEDIATE');
13
try {
14
$result = $fn();
15
$pdo->exec('COMMIT');
16
return $result;
17
} catch (Throwable $e) {
18
try { $pdo->exec('ROLLBACK'); } catch (Throwable) { /* al afgesloten */ }
19
throw $e;
20
}
21
}
22
23
function validDate(mixed $value): string {
24
if (!is_string($value) || !preg_match('/^\d{4}-\d{2}-\d{2}$/', $value)) {
25
throw new AppException('De datum moet de vorm JJJJ-MM-DD hebben.');
26
}
27
$dt = DateTimeImmutable::createFromFormat('!Y-m-d', $value);
28
$errors = DateTimeImmutable::getLastErrors();
29
$bad = !$dt || (is_array($errors) && (($errors['warning_count'] ?? 0) > 0 || ($errors['error_count'] ?? 0) > 0));
30
if ($bad || $dt->format('Y-m-d') !== $value) throw new AppException('Die datum bestaat niet.');
31
return $value;
32
}
33
34
function cleanText(mixed $value, int $max, string $label): string {
35
if (!is_string($value)) throw new AppException($label.' moet tekst zijn.');
36
$value = trim($value);
37
if ($value === '') throw new AppException($label.' mag niet leeg zijn.');
38
if (preg_match('/[\x00-\x08\x0B\x0C\x0E-\x1F]/', $value)) throw new AppException($label.' bevat ongeldige tekens.');
39
if (mb_strlen($value) > $max) throw new AppException($label.' is te lang (maximaal '.$max.' tekens).');
40
return $value;
41
}
42
43
function parseStory(mixed $story, int $label): array {
44
if (!is_array($story) || array_is_list($story)) throw new AppException('Verhaal '.$label.' is ongeldig.');
45
$title = cleanText($story['title'] ?? null, 200, 'De titel van verhaal '.$label);
46
if (!isset($story['paragraphs']) || !is_array($story['paragraphs']) || !array_is_list($story['paragraphs'])) {
47
throw new AppException('Verhaal '.$label.' heeft een lijst alinea\'s nodig.');
48
}
49
if (count($story['paragraphs']) < 1) throw new AppException('Verhaal '.$label.' heeft minstens één alinea nodig.');
50
if (count($story['paragraphs']) > 40) throw new AppException('Verhaal '.$label.' heeft te veel alinea\'s (maximaal 40).');
51
$paragraphs = [];
52
foreach ($story['paragraphs'] as $paragraph) {
53
$paragraphs[] = cleanText($paragraph, 20000, 'Een alinea van verhaal '.$label);
54
}
55
return ['title' => $title, 'paragraphs' => $paragraphs];
56
}
57
58
/** @return list<array{position:int,title:string,paragraphs:list<string>}> */
59
function parseThreeStories(mixed $stories): array {
60
if (!is_array($stories) || !array_is_list($stories)) throw new AppException('Verhalen moeten een lijst zijn.');
61
if (count($stories) !== 3) throw new AppException('Een volledige dag heeft precies drie verhalen.');
62
$parsed = [];
63
foreach ($stories as $index => $story) {
64
$one = parseStory($story, $index + 1);
65
$one['position'] = $index + 1;
66
$parsed[] = $one;
67
}
68
return $parsed;
69
}
70
71
function insertStory(int $dayId, int $position, string $title, array $paragraphs): void {
72
$now = time();
73
query('INSERT INTO stories (day_id, position, title, created, updated) VALUES (?,?,?,?,?)', [$dayId, $position, $title, $now, $now]);
74
$storyId = (int)db()->lastInsertId();
75
foreach ($paragraphs as $index => $body) {
76
query('INSERT INTO paragraphs (story_id, position, body) VALUES (?,?,?)', [$storyId, $index + 1, $body]);
77
}
78
}
79
80
function dayRow(string $date): array {
81
$date = validDate($date);
82
$row = query('SELECT * FROM days WHERE date=?', [$date])->fetch();
83
if (!$row) throw new AppException('Deze dag bestaat niet.', 404);
84
return $row;
85
}
86
87
function storyPositions(int $dayId): array {
88
return array_map('intval', query('SELECT position FROM stories WHERE day_id=? ORDER BY position', [$dayId])->fetchAll(PDO::FETCH_COLUMN));
89
}
90
91
function loadDay(string $date, ?string $readerId): array {
92
$day = dayRow($date);
93
$stories = query('SELECT * FROM stories WHERE day_id=? ORDER BY position, id', [$day['id']])->fetchAll();
94
$out = [];
95
foreach ($stories as $story) {
96
$paragraphs = query('SELECT body FROM paragraphs WHERE story_id=? ORDER BY position, id', [$story['id']])->fetchAll(PDO::FETCH_COLUMN);
97
$out[] = [
98
'id' => (int)$story['id'],
99
'position' => (int)$story['position'],
100
'title' => $story['title'],
101
'paragraphs' => array_values($paragraphs),
102
];
103
}
104
$previous = query('SELECT date FROM days WHERE date < ? ORDER BY date DESC LIMIT 1', [$day['date']])->fetchColumn();
105
$next = query('SELECT date FROM days WHERE date > ? ORDER BY date ASC LIMIT 1', [$day['date']])->fetchColumn();
106
$result = [
107
'date' => $day['date'],
108
'title' => $day['title'],
109
'storyCount' => count($out),
110
'complete' => count($out) === 3,
111
'previous' => $previous !== false ? $previous : null,
112
'next' => $next !== false ? $next : null,
113
'stories' => $out,
114
];
115
if ($readerId !== null) {
116
$result['read'] = (bool)query('SELECT 1 FROM reads WHERE user_id=? AND day_id=?', [$readerId, $day['id']])->fetchColumn();
117
}
118
return $result;
119
}
120
121
function listDays(?string $readerId): array {
122
if ($readerId === null) {
123
$rows = query('SELECT d.date, d.title, (SELECT COUNT(*) FROM stories s WHERE s.day_id=d.id) AS story_count FROM days d ORDER BY d.date ASC')->fetchAll();
124
} else {
125
$rows = query('SELECT d.date, d.title, (SELECT COUNT(*) FROM stories s WHERE s.day_id=d.id) AS story_count, r.read_at FROM days d LEFT JOIN reads r ON r.day_id=d.id AND r.user_id=? ORDER BY d.date ASC', [$readerId])->fetchAll();
126
}
127
return array_map(function (array $row) use ($readerId): array {
128
$item = [
129
'date' => $row['date'],
130
'title' => $row['title'],
131
'storyCount' => (int)$row['story_count'],
132
'complete' => (int)$row['story_count'] === 3,
133
];
134
if ($readerId !== null) $item['read'] = $row['read_at'] !== null;
135
return $item;
136
}, $rows);
137
}
138
139
function createDay(string $date, mixed $title, mixed $stories): array {
140
$date = validDate($date);
141
$title = cleanText($title, 200, 'De dagtitel');
142
$parsed = parseThreeStories($stories);
143
transaction(function () use ($date, $title, $parsed): void {
144
if (query('SELECT 1 FROM days WHERE date=?', [$date])->fetchColumn()) {
145
throw new AppException('Er bestaat al een dag op deze datum.', 409);
146
}
147
$now = time();
148
query('INSERT INTO days (date, title, created, updated) VALUES (?,?,?,?)', [$date, $title, $now, $now]);
149
$dayId = (int)db()->lastInsertId();
150
foreach ($parsed as $story) insertStory($dayId, $story['position'], $story['title'], $story['paragraphs']);
151
});
152
return loadDay($date, null);
153
}
154
155
function updateDay(string $date, array $input): array {
156
$title = array_key_exists('title', $input) ? cleanText($input['title'], 200, 'De dagtitel') : null;
157
$stories = array_key_exists('stories', $input) ? parseThreeStories($input['stories']) : null;
158
if ($title === null && $stories === null) throw new AppException('Geef een titel of precies drie verhalen om bij te werken.');
159
transaction(function () use ($date, $title, $stories): void {
160
$day = dayRow($date);
161
if ($title !== null) query('UPDATE days SET title=?, updated=? WHERE id=?', [$title, time(), $day['id']]);
162
if ($stories !== null) {
163
query('DELETE FROM stories WHERE day_id=?', [$day['id']]);
164
foreach ($stories as $story) insertStory((int)$day['id'], $story['position'], $story['title'], $story['paragraphs']);
165
query('UPDATE days SET updated=? WHERE id=?', [time(), $day['id']]);
166
}
167
});
168
return loadDay($date, null);
169
}
170
171
function deleteDay(string $date): string {
172
$date = validDate($date);
173
transaction(function () use ($date): void {
174
$day = dayRow($date);
175
query('DELETE FROM days WHERE id=?', [$day['id']]);
176
});
177
return $date;
178
}
179
180
function addStory(string $date, array $input): array {
181
transaction(function () use ($date, $input): void {
182
$day = dayRow($date);
183
$used = storyPositions((int)$day['id']);
184
if (count($used) >= 3) throw new AppException('Deze dag heeft al drie verhalen.');
185
if (array_key_exists('position', $input) && $input['position'] !== null) {
186
if (!is_int($input['position']) && !(is_string($input['position']) && preg_match('/^[123]$/', $input['position']))) {
187
throw new AppException('De plek van een verhaal is 1, 2 of 3.');
188
}
189
$position = (int)$input['position'];
190
if (in_array($position, $used, true)) throw new AppException('Die plek is al bezet.', 409);
191
} else {
192
$position = [1, 2, 3][0];
193
foreach ([1, 2, 3] as $candidate) if (!in_array($candidate, $used, true)) { $position = $candidate; break; }
194
}
195
$story = parseStory($input, $position);
196
insertStory((int)$day['id'], $position, $story['title'], $story['paragraphs']);
197
query('UPDATE days SET updated=? WHERE id=?', [time(), $day['id']]);
198
});
199
return loadDay($date, null);
200
}
201
202
function updateStory(string $date, int $position, array $input): array {
203
if ($position < 1 || $position > 3) throw new AppException('De plek van een verhaal is 1, 2 of 3.');
204
$hasTitle = array_key_exists('title', $input);
205
$hasParagraphs = array_key_exists('paragraphs', $input);
206
if (!$hasTitle && !$hasParagraphs) throw new AppException('Geef een titel of alinea\'s om het verhaal bij te werken.');
207
$title = $hasTitle ? cleanText($input['title'], 200, 'De titel van verhaal '.$position) : null;
208
$paragraphs = null;
209
if ($hasParagraphs) $paragraphs = parseStory(['title' => $title ?? 'tijdelijk', 'paragraphs' => $input['paragraphs']], $position)['paragraphs'];
210
transaction(function () use ($date, $position, $title, $paragraphs): void {
211
$day = dayRow($date);
212
$story = query('SELECT * FROM stories WHERE day_id=? AND position=?', [$day['id'], $position])->fetch();
213
if (!$story) throw new AppException('Dit verhaal bestaat niet.', 404);
214
if ($title !== null) query('UPDATE stories SET title=?, updated=? WHERE id=?', [$title, time(), $story['id']]);
215
else query('UPDATE stories SET updated=? WHERE id=?', [time(), $story['id']]);
216
if ($paragraphs !== null) {
217
query('DELETE FROM paragraphs WHERE story_id=?', [$story['id']]);
218
foreach ($paragraphs as $index => $body) query('INSERT INTO paragraphs (story_id, position, body) VALUES (?,?,?)', [$story['id'], $index + 1, $body]);
219
}
220
query('UPDATE days SET updated=? WHERE id=?', [time(), $day['id']]);
221
});
222
return loadDay($date, null);
223
}
224
225
function deleteStory(string $date, int $position): array {
226
if ($position < 1 || $position > 3) throw new AppException('De plek van een verhaal is 1, 2 of 3.');
227
transaction(function () use ($date, $position): void {
228
$day = dayRow($date);
229
$gone = query('DELETE FROM stories WHERE day_id=? AND position=?', [$day['id'], $position]);
230
if ($gone->rowCount() !== 1) throw new AppException('Dit verhaal bestaat niet.', 404);
231
query('UPDATE days SET updated=? WHERE id=?', [time(), $day['id']]);
232
});
233
return loadDay($date, null);
234
}
235
236
function latestWritten(): array {
237
$row = query('SELECT d.date, d.title, (SELECT COUNT(*) FROM stories s WHERE s.day_id=d.id) AS story_count FROM days d ORDER BY d.date DESC LIMIT 1')->fetch();
238
if (!$row) throw new AppException('Er is nog geen dag geschreven.', 404);
239
return [
240
'date' => $row['date'],
241
'title' => $row['title'],
242
'storyCount' => (int)$row['story_count'],
243
'complete' => (int)$row['story_count'] === 3,
244
];
245
}
246
247
function dayGaps(): array {
248
$dates = query('SELECT date FROM days ORDER BY date ASC')->fetchAll(PDO::FETCH_COLUMN);
249
if (!$dates) return ['first' => null, 'latest' => null, 'missing' => [], 'incomplete' => []];
250
$first = $dates[0];
251
$latest = $dates[count($dates) - 1];
252
$known = array_fill_keys($dates, true);
253
$missing = [];
254
$cursor = (new DateTimeImmutable($first))->modify('+1 day');
255
$end = new DateTimeImmutable($latest);
256
while ($cursor < $end) {
257
$iso = $cursor->format('Y-m-d');
258
if (!isset($known[$iso])) $missing[] = $iso;
259
$cursor = $cursor->modify('+1 day');
260
}
261
$incomplete = [];
262
$rows = query('SELECT id, date, title FROM days ORDER BY date ASC')->fetchAll();
263
foreach ($rows as $row) {
264
$positions = storyPositions((int)$row['id']);
265
if (count($positions) >= 3) continue;
266
$incomplete[] = [
267
'date' => $row['date'],
268
'title' => $row['title'],
269
'storyCount' => count($positions),
270
'missingPositions' => array_values(array_diff([1, 2, 3], $positions)),
271
];
272
}
273
return ['first' => $first, 'latest' => $latest, 'missing' => $missing, 'incomplete' => $incomplete];
274
}
275
276
function markRead(string $userId, string $date, bool $read): array {
277
$day = dayRow($date);
278
if ($read) {
279
query('INSERT INTO reads (user_id, day_id, read_at) VALUES (?,?,?) ON CONFLICT(user_id, day_id) DO UPDATE SET read_at=excluded.read_at', [$userId, $day['id'], time()]);
280
} else {
281
query('DELETE FROM reads WHERE user_id=? AND day_id=?', [$userId, $day['id']]);
282
}
283
return loadDay($date, $userId);
284
}
285
286
function publicUser(string $id): array {
287
$row = query('SELECT id, name, role, theme, font, created FROM users WHERE id=?', [$id])->fetch();
288
if (!$row) throw new AppException('Gebruiker niet gevonden.', 404);
289
return [
290
'id' => $row['id'],
291
'name' => $row['name'],
292
'role' => $row['role'],
293
'admin' => $row['role'] === 'admin',
294
'theme' => $row['theme'],
295
'font' => $row['font'],
296
'created' => (int)$row['created'],
297
];
298
}
299
300
function saveSettings(string $userId, array $input): array {
301
$theme = $input['theme'] ?? null;
302
$font = $input['font'] ?? null;
303
if (!in_array($theme, ['system', 'light', 'dark'], true)) throw new AppException('Kies systeem, licht of donker.');
304
if (!in_array($font, ['serif', 'sans', 'rounded'], true)) throw new AppException('Kies serif, schreefloos of rond.');
305
query('UPDATE users SET theme=?, font=? WHERE id=?', [$theme, $font, $userId]);
306
return publicUser($userId);
307
}
308
309
function exportUser(string $userId): array {
310
$reads = query('SELECT d.date, d.title, r.read_at FROM reads r JOIN days d ON d.id=r.day_id WHERE r.user_id=? ORDER BY d.date', [$userId])->fetchAll();
311
$keys = query('SELECT id, name, token_prefix, created, revoked FROM api_keys WHERE user_id=? ORDER BY id', [$userId])->fetchAll();
312
return [
313
'exported_at' => gmdate('c'),
314
'profile' => publicUser($userId),
315
'reads' => array_map(fn(array $row): array => ['date' => $row['date'], 'title' => $row['title'], 'read_at' => (int)$row['read_at']], $reads),
316
'api_keys' => array_map(fn(array $row): array => [
317
'id' => (int)$row['id'],
318
'name' => $row['name'],
319
'prefix' => $row['token_prefix'],
320
'created' => (int)$row['created'],
321
'revoked' => $row['revoked'] !== null ? (int)$row['revoked'] : null,
322
], $keys),
323
];
324
}
325
326
function keyPublic(array $row): array {
327
return [
328
'id' => (int)$row['id'],
329
'name' => $row['name'],
330
'prefix' => $row['token_prefix'],
331
'created' => (int)$row['created'],
332
'revoked' => $row['revoked'] !== null ? (int)$row['revoked'] : null,
333
];
334
}
335
336
function sealToken(string $token): string {
337
$key = hex2bin((string)config()['key_secret']);
338
if ($key === false || strlen($key) !== 32) throw new RuntimeException('key_secret in data/config.php moet 64 hexadecimale tekens zijn.');
339
$iv = random_bytes(12);
340
$tag = '';
341
$cipher = openssl_encrypt($token, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
342
if ($cipher === false || strlen($tag) !== 16) throw new RuntimeException('De API-sleutel kon niet worden versleuteld.');
343
return base64_encode($iv.$tag.$cipher);
344
}
345
346
function openToken(string $sealed): string {
347
$key = hex2bin((string)config()['key_secret']);
348
$raw = base64_decode($sealed, true);
349
if ($key === false || strlen($key) !== 32 || $raw === false || strlen($raw) < 29) {
350
throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);
351
}
352
$plain = openssl_decrypt(substr($raw, 28), 'aes-256-gcm', $key, OPENSSL_RAW_DATA, substr($raw, 0, 12), substr($raw, 12, 16));
353
if (!is_string($plain) || $plain === '') throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);
354
return $plain;
355
}
356
357
function createApiKey(string $userId, mixed $name): array {
358
$name = cleanText($name, 80, 'De naam van de sleutel');
359
$token = 'vb_'.bin2hex(random_bytes(32));
360
query('INSERT INTO api_keys (user_id, name, token_hash, token_prefix, token_cipher, created, revoked) VALUES (?,?,?,?,?,?,NULL)', [
361
$userId, $name, hash('sha256', $token), substr($token, 0, 11), sealToken($token), time(),
362
]);
363
return keyPublic(query('SELECT * FROM api_keys WHERE id=?', [(int)db()->lastInsertId()])->fetch()) + ['token' => $token];
364
}
365
366
function revealApiKey(int $id): array {
367
$row = query('SELECT * FROM api_keys WHERE id=?', [$id])->fetch();
368
if (!$row) throw new AppException('Deze sleutel bestaat niet.', 404);
369
if (!is_string($row['token_cipher'] ?? null) || $row['token_cipher'] === '') {
370
throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);
371
}
372
$token = openToken($row['token_cipher']);
373
if (!hash_equals($row['token_hash'], hash('sha256', $token))) {
374
throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);
375
}
376
return keyPublic($row) + ['token' => $token];
377
}
378
379
function listApiKeys(): array {
380
return array_map('keyPublic', query('SELECT * FROM api_keys ORDER BY revoked IS NOT NULL, id DESC')->fetchAll());
381
}
382
383
function revokeApiKey(int $id): array {
384
return transaction(function () use ($id): array {
385
$row = query('SELECT * FROM api_keys WHERE id=?', [$id])->fetch();
386
if (!$row) throw new AppException('Deze sleutel bestaat niet.', 404);
387
if ($row['revoked'] === null) query('UPDATE api_keys SET revoked=? WHERE id=?', [time(), $id]);
388
return keyPublic(query('SELECT * FROM api_keys WHERE id=?', [$id])->fetch());
389
});
390
}
391
392
function actorFromToken(string $token): array {
393
if (!preg_match('/^vb_[a-f0-9]{64}$/', $token)) throw new AppException('De API-sleutel heeft het verkeerde formaat.', 401, 'format');
394
$row = query('SELECT * FROM api_keys WHERE token_hash=?', [hash('sha256', $token)])->fetch();
395
if (!$row) throw new AppException('Deze API-sleutel is onbekend.', 401, 'rejected');
396
if ($row['revoked'] !== null) throw new AppException('Deze API-sleutel is ingetrokken.', 401, 'rejected');
397
return ['kind' => 'token', 'userId' => $row['user_id'], 'role' => 'admin', 'keyId' => (int)$row['id']];
398
}
@@ -0,0 +1,398 @@1
<?php2
declare(strict_types=1);3
4
final class AppException extends RuntimeException {5
public function __construct(string $message, public int $status = 422, public ?string $auth = null) {6
parent::__construct($message);7
}8
}9
10
function transaction(callable $fn): mixed {11
$pdo = db();12
$pdo->exec('BEGIN IMMEDIATE');13
try {14
$result = $fn();15
$pdo->exec('COMMIT');16
return $result;17
} catch (Throwable $e) {18
try { $pdo->exec('ROLLBACK'); } catch (Throwable) { /* al afgesloten */ }19
throw $e;20
}21
}22
23
function validDate(mixed $value): string {24
if (!is_string($value) || !preg_match('/^\d{4}-\d{2}-\d{2}$/', $value)) {25
throw new AppException('De datum moet de vorm JJJJ-MM-DD hebben.');26
}27
$dt = DateTimeImmutable::createFromFormat('!Y-m-d', $value);28
$errors = DateTimeImmutable::getLastErrors();29
$bad = !$dt || (is_array($errors) && (($errors['warning_count'] ?? 0) > 0 || ($errors['error_count'] ?? 0) > 0));30
if ($bad || $dt->format('Y-m-d') !== $value) throw new AppException('Die datum bestaat niet.');31
return $value;32
}33
34
function cleanText(mixed $value, int $max, string $label): string {35
if (!is_string($value)) throw new AppException($label.' moet tekst zijn.');36
$value = trim($value);37
if ($value === '') throw new AppException($label.' mag niet leeg zijn.');38
if (preg_match('/[\x00-\x08\x0B\x0C\x0E-\x1F]/', $value)) throw new AppException($label.' bevat ongeldige tekens.');39
if (mb_strlen($value) > $max) throw new AppException($label.' is te lang (maximaal '.$max.' tekens).');40
return $value;41
}42
43
function parseStory(mixed $story, int $label): array {44
if (!is_array($story) || array_is_list($story)) throw new AppException('Verhaal '.$label.' is ongeldig.');45
$title = cleanText($story['title'] ?? null, 200, 'De titel van verhaal '.$label);46
if (!isset($story['paragraphs']) || !is_array($story['paragraphs']) || !array_is_list($story['paragraphs'])) {47
throw new AppException('Verhaal '.$label.' heeft een lijst alinea\'s nodig.');48
}49
if (count($story['paragraphs']) < 1) throw new AppException('Verhaal '.$label.' heeft minstens één alinea nodig.');50
if (count($story['paragraphs']) > 40) throw new AppException('Verhaal '.$label.' heeft te veel alinea\'s (maximaal 40).');51
$paragraphs = [];52
foreach ($story['paragraphs'] as $paragraph) {53
$paragraphs[] = cleanText($paragraph, 20000, 'Een alinea van verhaal '.$label);54
}55
return ['title' => $title, 'paragraphs' => $paragraphs];56
}57
58
/** @return list<array{position:int,title:string,paragraphs:list<string>}> */59
function parseThreeStories(mixed $stories): array {60
if (!is_array($stories) || !array_is_list($stories)) throw new AppException('Verhalen moeten een lijst zijn.');61
if (count($stories) !== 3) throw new AppException('Een volledige dag heeft precies drie verhalen.');62
$parsed = [];63
foreach ($stories as $index => $story) {64
$one = parseStory($story, $index + 1);65
$one['position'] = $index + 1;66
$parsed[] = $one;67
}68
return $parsed;69
}70
71
function insertStory(int $dayId, int $position, string $title, array $paragraphs): void {72
$now = time();73
query('INSERT INTO stories (day_id, position, title, created, updated) VALUES (?,?,?,?,?)', [$dayId, $position, $title, $now, $now]);74
$storyId = (int)db()->lastInsertId();75
foreach ($paragraphs as $index => $body) {76
query('INSERT INTO paragraphs (story_id, position, body) VALUES (?,?,?)', [$storyId, $index + 1, $body]);77
}78
}79
80
function dayRow(string $date): array {81
$date = validDate($date);82
$row = query('SELECT * FROM days WHERE date=?', [$date])->fetch();83
if (!$row) throw new AppException('Deze dag bestaat niet.', 404);84
return $row;85
}86
87
function storyPositions(int $dayId): array {88
return array_map('intval', query('SELECT position FROM stories WHERE day_id=? ORDER BY position', [$dayId])->fetchAll(PDO::FETCH_COLUMN));89
}90
91
function loadDay(string $date, ?string $readerId): array {92
$day = dayRow($date);93
$stories = query('SELECT * FROM stories WHERE day_id=? ORDER BY position, id', [$day['id']])->fetchAll();94
$out = [];95
foreach ($stories as $story) {96
$paragraphs = query('SELECT body FROM paragraphs WHERE story_id=? ORDER BY position, id', [$story['id']])->fetchAll(PDO::FETCH_COLUMN);97
$out[] = [98
'id' => (int)$story['id'],99
'position' => (int)$story['position'],100
'title' => $story['title'],101
'paragraphs' => array_values($paragraphs),102
];103
}104
$previous = query('SELECT date FROM days WHERE date < ? ORDER BY date DESC LIMIT 1', [$day['date']])->fetchColumn();105
$next = query('SELECT date FROM days WHERE date > ? ORDER BY date ASC LIMIT 1', [$day['date']])->fetchColumn();106
$result = [107
'date' => $day['date'],108
'title' => $day['title'],109
'storyCount' => count($out),110
'complete' => count($out) === 3,111
'previous' => $previous !== false ? $previous : null,112
'next' => $next !== false ? $next : null,113
'stories' => $out,114
];115
if ($readerId !== null) {116
$result['read'] = (bool)query('SELECT 1 FROM reads WHERE user_id=? AND day_id=?', [$readerId, $day['id']])->fetchColumn();117
}118
return $result;119
}120
121
function listDays(?string $readerId): array {122
if ($readerId === null) {123
$rows = query('SELECT d.date, d.title, (SELECT COUNT(*) FROM stories s WHERE s.day_id=d.id) AS story_count FROM days d ORDER BY d.date ASC')->fetchAll();124
} else {125
$rows = query('SELECT d.date, d.title, (SELECT COUNT(*) FROM stories s WHERE s.day_id=d.id) AS story_count, r.read_at FROM days d LEFT JOIN reads r ON r.day_id=d.id AND r.user_id=? ORDER BY d.date ASC', [$readerId])->fetchAll();126
}127
return array_map(function (array $row) use ($readerId): array {128
$item = [129
'date' => $row['date'],130
'title' => $row['title'],131
'storyCount' => (int)$row['story_count'],132
'complete' => (int)$row['story_count'] === 3,133
];134
if ($readerId !== null) $item['read'] = $row['read_at'] !== null;135
return $item;136
}, $rows);137
}138
139
function createDay(string $date, mixed $title, mixed $stories): array {140
$date = validDate($date);141
$title = cleanText($title, 200, 'De dagtitel');142
$parsed = parseThreeStories($stories);143
transaction(function () use ($date, $title, $parsed): void {144
if (query('SELECT 1 FROM days WHERE date=?', [$date])->fetchColumn()) {145
throw new AppException('Er bestaat al een dag op deze datum.', 409);146
}147
$now = time();148
query('INSERT INTO days (date, title, created, updated) VALUES (?,?,?,?)', [$date, $title, $now, $now]);149
$dayId = (int)db()->lastInsertId();150
foreach ($parsed as $story) insertStory($dayId, $story['position'], $story['title'], $story['paragraphs']);151
});152
return loadDay($date, null);153
}154
155
function updateDay(string $date, array $input): array {156
$title = array_key_exists('title', $input) ? cleanText($input['title'], 200, 'De dagtitel') : null;157
$stories = array_key_exists('stories', $input) ? parseThreeStories($input['stories']) : null;158
if ($title === null && $stories === null) throw new AppException('Geef een titel of precies drie verhalen om bij te werken.');159
transaction(function () use ($date, $title, $stories): void {160
$day = dayRow($date);161
if ($title !== null) query('UPDATE days SET title=?, updated=? WHERE id=?', [$title, time(), $day['id']]);162
if ($stories !== null) {163
query('DELETE FROM stories WHERE day_id=?', [$day['id']]);164
foreach ($stories as $story) insertStory((int)$day['id'], $story['position'], $story['title'], $story['paragraphs']);165
query('UPDATE days SET updated=? WHERE id=?', [time(), $day['id']]);166
}167
});168
return loadDay($date, null);169
}170
171
function deleteDay(string $date): string {172
$date = validDate($date);173
transaction(function () use ($date): void {174
$day = dayRow($date);175
query('DELETE FROM days WHERE id=?', [$day['id']]);176
});177
return $date;178
}179
180
function addStory(string $date, array $input): array {181
transaction(function () use ($date, $input): void {182
$day = dayRow($date);183
$used = storyPositions((int)$day['id']);184
if (count($used) >= 3) throw new AppException('Deze dag heeft al drie verhalen.');185
if (array_key_exists('position', $input) && $input['position'] !== null) {186
if (!is_int($input['position']) && !(is_string($input['position']) && preg_match('/^[123]$/', $input['position']))) {187
throw new AppException('De plek van een verhaal is 1, 2 of 3.');188
}189
$position = (int)$input['position'];190
if (in_array($position, $used, true)) throw new AppException('Die plek is al bezet.', 409);191
} else {192
$position = [1, 2, 3][0];193
foreach ([1, 2, 3] as $candidate) if (!in_array($candidate, $used, true)) { $position = $candidate; break; }194
}195
$story = parseStory($input, $position);196
insertStory((int)$day['id'], $position, $story['title'], $story['paragraphs']);197
query('UPDATE days SET updated=? WHERE id=?', [time(), $day['id']]);198
});199
return loadDay($date, null);200
}201
202
function updateStory(string $date, int $position, array $input): array {203
if ($position < 1 || $position > 3) throw new AppException('De plek van een verhaal is 1, 2 of 3.');204
$hasTitle = array_key_exists('title', $input);205
$hasParagraphs = array_key_exists('paragraphs', $input);206
if (!$hasTitle && !$hasParagraphs) throw new AppException('Geef een titel of alinea\'s om het verhaal bij te werken.');207
$title = $hasTitle ? cleanText($input['title'], 200, 'De titel van verhaal '.$position) : null;208
$paragraphs = null;209
if ($hasParagraphs) $paragraphs = parseStory(['title' => $title ?? 'tijdelijk', 'paragraphs' => $input['paragraphs']], $position)['paragraphs'];210
transaction(function () use ($date, $position, $title, $paragraphs): void {211
$day = dayRow($date);212
$story = query('SELECT * FROM stories WHERE day_id=? AND position=?', [$day['id'], $position])->fetch();213
if (!$story) throw new AppException('Dit verhaal bestaat niet.', 404);214
if ($title !== null) query('UPDATE stories SET title=?, updated=? WHERE id=?', [$title, time(), $story['id']]);215
else query('UPDATE stories SET updated=? WHERE id=?', [time(), $story['id']]);216
if ($paragraphs !== null) {217
query('DELETE FROM paragraphs WHERE story_id=?', [$story['id']]);218
foreach ($paragraphs as $index => $body) query('INSERT INTO paragraphs (story_id, position, body) VALUES (?,?,?)', [$story['id'], $index + 1, $body]);219
}220
query('UPDATE days SET updated=? WHERE id=?', [time(), $day['id']]);221
});222
return loadDay($date, null);223
}224
225
function deleteStory(string $date, int $position): array {226
if ($position < 1 || $position > 3) throw new AppException('De plek van een verhaal is 1, 2 of 3.');227
transaction(function () use ($date, $position): void {228
$day = dayRow($date);229
$gone = query('DELETE FROM stories WHERE day_id=? AND position=?', [$day['id'], $position]);230
if ($gone->rowCount() !== 1) throw new AppException('Dit verhaal bestaat niet.', 404);231
query('UPDATE days SET updated=? WHERE id=?', [time(), $day['id']]);232
});233
return loadDay($date, null);234
}235
236
function latestWritten(): array {237
$row = query('SELECT d.date, d.title, (SELECT COUNT(*) FROM stories s WHERE s.day_id=d.id) AS story_count FROM days d ORDER BY d.date DESC LIMIT 1')->fetch();238
if (!$row) throw new AppException('Er is nog geen dag geschreven.', 404);239
return [240
'date' => $row['date'],241
'title' => $row['title'],242
'storyCount' => (int)$row['story_count'],243
'complete' => (int)$row['story_count'] === 3,244
];245
}246
247
function dayGaps(): array {248
$dates = query('SELECT date FROM days ORDER BY date ASC')->fetchAll(PDO::FETCH_COLUMN);249
if (!$dates) return ['first' => null, 'latest' => null, 'missing' => [], 'incomplete' => []];250
$first = $dates[0];251
$latest = $dates[count($dates) - 1];252
$known = array_fill_keys($dates, true);253
$missing = [];254
$cursor = (new DateTimeImmutable($first))->modify('+1 day');255
$end = new DateTimeImmutable($latest);256
while ($cursor < $end) {257
$iso = $cursor->format('Y-m-d');258
if (!isset($known[$iso])) $missing[] = $iso;259
$cursor = $cursor->modify('+1 day');260
}261
$incomplete = [];262
$rows = query('SELECT id, date, title FROM days ORDER BY date ASC')->fetchAll();263
foreach ($rows as $row) {264
$positions = storyPositions((int)$row['id']);265
if (count($positions) >= 3) continue;266
$incomplete[] = [267
'date' => $row['date'],268
'title' => $row['title'],269
'storyCount' => count($positions),270
'missingPositions' => array_values(array_diff([1, 2, 3], $positions)),271
];272
}273
return ['first' => $first, 'latest' => $latest, 'missing' => $missing, 'incomplete' => $incomplete];274
}275
276
function markRead(string $userId, string $date, bool $read): array {277
$day = dayRow($date);278
if ($read) {279
query('INSERT INTO reads (user_id, day_id, read_at) VALUES (?,?,?) ON CONFLICT(user_id, day_id) DO UPDATE SET read_at=excluded.read_at', [$userId, $day['id'], time()]);280
} else {281
query('DELETE FROM reads WHERE user_id=? AND day_id=?', [$userId, $day['id']]);282
}283
return loadDay($date, $userId);284
}285
286
function publicUser(string $id): array {287
$row = query('SELECT id, name, role, theme, font, created FROM users WHERE id=?', [$id])->fetch();288
if (!$row) throw new AppException('Gebruiker niet gevonden.', 404);289
return [290
'id' => $row['id'],291
'name' => $row['name'],292
'role' => $row['role'],293
'admin' => $row['role'] === 'admin',294
'theme' => $row['theme'],295
'font' => $row['font'],296
'created' => (int)$row['created'],297
];298
}299
300
function saveSettings(string $userId, array $input): array {301
$theme = $input['theme'] ?? null;302
$font = $input['font'] ?? null;303
if (!in_array($theme, ['system', 'light', 'dark'], true)) throw new AppException('Kies systeem, licht of donker.');304
if (!in_array($font, ['serif', 'sans', 'rounded'], true)) throw new AppException('Kies serif, schreefloos of rond.');305
query('UPDATE users SET theme=?, font=? WHERE id=?', [$theme, $font, $userId]);306
return publicUser($userId);307
}308
309
function exportUser(string $userId): array {310
$reads = query('SELECT d.date, d.title, r.read_at FROM reads r JOIN days d ON d.id=r.day_id WHERE r.user_id=? ORDER BY d.date', [$userId])->fetchAll();311
$keys = query('SELECT id, name, token_prefix, created, revoked FROM api_keys WHERE user_id=? ORDER BY id', [$userId])->fetchAll();312
return [313
'exported_at' => gmdate('c'),314
'profile' => publicUser($userId),315
'reads' => array_map(fn(array $row): array => ['date' => $row['date'], 'title' => $row['title'], 'read_at' => (int)$row['read_at']], $reads),316
'api_keys' => array_map(fn(array $row): array => [317
'id' => (int)$row['id'],318
'name' => $row['name'],319
'prefix' => $row['token_prefix'],320
'created' => (int)$row['created'],321
'revoked' => $row['revoked'] !== null ? (int)$row['revoked'] : null,322
], $keys),323
];324
}325
326
function keyPublic(array $row): array {327
return [328
'id' => (int)$row['id'],329
'name' => $row['name'],330
'prefix' => $row['token_prefix'],331
'created' => (int)$row['created'],332
'revoked' => $row['revoked'] !== null ? (int)$row['revoked'] : null,333
];334
}335
336
function sealToken(string $token): string {337
$key = hex2bin((string)config()['key_secret']);338
if ($key === false || strlen($key) !== 32) throw new RuntimeException('key_secret in data/config.php moet 64 hexadecimale tekens zijn.');339
$iv = random_bytes(12);340
$tag = '';341
$cipher = openssl_encrypt($token, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);342
if ($cipher === false || strlen($tag) !== 16) throw new RuntimeException('De API-sleutel kon niet worden versleuteld.');343
return base64_encode($iv.$tag.$cipher);344
}345
346
function openToken(string $sealed): string {347
$key = hex2bin((string)config()['key_secret']);348
$raw = base64_decode($sealed, true);349
if ($key === false || strlen($key) !== 32 || $raw === false || strlen($raw) < 29) {350
throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);351
}352
$plain = openssl_decrypt(substr($raw, 28), 'aes-256-gcm', $key, OPENSSL_RAW_DATA, substr($raw, 0, 12), substr($raw, 12, 16));353
if (!is_string($plain) || $plain === '') throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);354
return $plain;355
}356
357
function createApiKey(string $userId, mixed $name): array {358
$name = cleanText($name, 80, 'De naam van de sleutel');359
$token = 'vb_'.bin2hex(random_bytes(32));360
query('INSERT INTO api_keys (user_id, name, token_hash, token_prefix, token_cipher, created, revoked) VALUES (?,?,?,?,?,?,NULL)', [361
$userId, $name, hash('sha256', $token), substr($token, 0, 11), sealToken($token), time(),362
]);363
return keyPublic(query('SELECT * FROM api_keys WHERE id=?', [(int)db()->lastInsertId()])->fetch()) + ['token' => $token];364
}365
366
function revealApiKey(int $id): array {367
$row = query('SELECT * FROM api_keys WHERE id=?', [$id])->fetch();368
if (!$row) throw new AppException('Deze sleutel bestaat niet.', 404);369
if (!is_string($row['token_cipher'] ?? null) || $row['token_cipher'] === '') {370
throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);371
}372
$token = openToken($row['token_cipher']);373
if (!hash_equals($row['token_hash'], hash('sha256', $token))) {374
throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);375
}376
return keyPublic($row) + ['token' => $token];377
}378
379
function listApiKeys(): array {380
return array_map('keyPublic', query('SELECT * FROM api_keys ORDER BY revoked IS NOT NULL, id DESC')->fetchAll());381
}382
383
function revokeApiKey(int $id): array {384
return transaction(function () use ($id): array {385
$row = query('SELECT * FROM api_keys WHERE id=?', [$id])->fetch();386
if (!$row) throw new AppException('Deze sleutel bestaat niet.', 404);387
if ($row['revoked'] === null) query('UPDATE api_keys SET revoked=? WHERE id=?', [time(), $id]);388
return keyPublic(query('SELECT * FROM api_keys WHERE id=?', [$id])->fetch());389
});390
}391
392
function actorFromToken(string $token): array {393
if (!preg_match('/^vb_[a-f0-9]{64}$/', $token)) throw new AppException('De API-sleutel heeft het verkeerde formaat.', 401, 'format');394
$row = query('SELECT * FROM api_keys WHERE token_hash=?', [hash('sha256', $token)])->fetch();395
if (!$row) throw new AppException('Deze API-sleutel is onbekend.', 401, 'rejected');396
if ($row['revoked'] !== null) throw new AppException('Deze API-sleutel is ingetrokken.', 401, 'rejected');397
return ['kind' => 'token', 'userId' => $row['user_id'], 'role' => 'admin', 'keyId' => (int)$row['id']];398
}@@ -0,0 +1,412 @@
1
<?php
2
declare(strict_types=1);
3
require_once __DIR__.'/Storybook.php';
4
ini_set('display_errors', '0');
5
ini_set('log_errors', '1');
6
ini_set('error_log', dataDir().'/php-errors.log');
7
header('X-Content-Type-Options: nosniff');
8
header('Referrer-Policy: same-origin');
9
header("Content-Security-Policy: default-src 'self'; img-src 'self'; style-src 'self'; script-src 'self'; connect-src 'self'; frame-ancestors 'none'; base-uri 'self'; form-action 'self'");
10
header('Cache-Control: no-store');
11
12
function dataDir(): string {
13
$env = getenv('VERHALENBOEK_DATA_DIR');
14
if (is_string($env) && $env !== '') return rtrim($env, '/');
15
return dirname(__DIR__).'/data';
16
}
17
18
function db(): PDO {
19
static $db;
20
if ($db) return $db;
21
$dir = dataDir();
22
if (!is_dir($dir) && !mkdir($dir, 0775, true) && !is_dir($dir)) throw new RuntimeException('De datamap moet bestaan en schrijfbaar zijn.');
23
$db = new PDO('sqlite:'.$dir.'/verhalenboek.sqlite', null, null, [
24
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
25
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
26
]);
27
$db->exec('PRAGMA journal_mode=WAL; PRAGMA foreign_keys=ON; PRAGMA busy_timeout=5000;');
28
$db->exec('CREATE TABLE IF NOT EXISTS users (
29
id TEXT PRIMARY KEY,
30
name TEXT NOT NULL,
31
role TEXT NOT NULL DEFAULT \'user\' CHECK(role IN (\'admin\',\'user\')),
32
theme TEXT NOT NULL DEFAULT \'system\' CHECK(theme IN (\'system\',\'light\',\'dark\')),
33
font TEXT NOT NULL DEFAULT \'serif\' CHECK(font IN (\'serif\',\'sans\',\'rounded\')),
34
created INTEGER NOT NULL
35
);
36
CREATE TABLE IF NOT EXISTS sessions (id TEXT PRIMARY KEY, payload TEXT NOT NULL, expires INTEGER NOT NULL);
37
CREATE TABLE IF NOT EXISTS days (
38
id INTEGER PRIMARY KEY AUTOINCREMENT,
39
date TEXT NOT NULL UNIQUE,
40
title TEXT NOT NULL,
41
created INTEGER NOT NULL,
42
updated INTEGER NOT NULL
43
);
44
CREATE TABLE IF NOT EXISTS stories (
45
id INTEGER PRIMARY KEY AUTOINCREMENT,
46
day_id INTEGER NOT NULL REFERENCES days(id) ON DELETE CASCADE,
47
position INTEGER NOT NULL CHECK(position BETWEEN 1 AND 3),
48
title TEXT NOT NULL,
49
created INTEGER NOT NULL,
50
updated INTEGER NOT NULL,
51
UNIQUE(day_id, position)
52
);
53
CREATE TABLE IF NOT EXISTS paragraphs (
54
id INTEGER PRIMARY KEY AUTOINCREMENT,
55
story_id INTEGER NOT NULL REFERENCES stories(id) ON DELETE CASCADE,
56
position INTEGER NOT NULL CHECK(position >= 1),
57
body TEXT NOT NULL,
58
UNIQUE(story_id, position)
59
);
60
CREATE TABLE IF NOT EXISTS reads (
61
user_id TEXT NOT NULL REFERENCES users(id),
62
day_id INTEGER NOT NULL REFERENCES days(id) ON DELETE CASCADE,
63
read_at INTEGER NOT NULL,
64
PRIMARY KEY(user_id, day_id)
65
);
66
CREATE TABLE IF NOT EXISTS api_keys (
67
id INTEGER PRIMARY KEY AUTOINCREMENT,
68
user_id TEXT NOT NULL REFERENCES users(id),
69
name TEXT NOT NULL,
70
token_hash TEXT NOT NULL UNIQUE,
71
token_prefix TEXT NOT NULL,
72
token_cipher TEXT NOT NULL DEFAULT \'\',
73
created INTEGER NOT NULL,
74
revoked INTEGER
75
);');
76
$columns = array_column($db->query('PRAGMA table_info(api_keys)')->fetchAll(), 'name');
77
if (!in_array('token_cipher', $columns, true)) {
78
$db->exec("ALTER TABLE api_keys ADD COLUMN token_cipher TEXT NOT NULL DEFAULT ''");
79
}
80
return $db;
81
}
82
83
function query(string $sql, array $args = []): PDOStatement {
84
$statement = db()->prepare($sql);
85
$statement->execute($args);
86
return $statement;
87
}
88
89
final class DatabaseSessions implements SessionHandlerInterface {
90
public function open(string $path, string $name): bool { return true; }
91
public function close(): bool { return true; }
92
public function read(string $id): string|false {
93
return query('SELECT payload FROM sessions WHERE id=? AND expires>?', [$id, time()])->fetchColumn() ?: '';
94
}
95
public function write(string $id, string $data): bool {
96
query('INSERT OR REPLACE INTO sessions (id, payload, expires) VALUES (?,?,?)', [$id, $data, time() + 86400]);
97
return true;
98
}
99
public function destroy(string $id): bool {
100
query('DELETE FROM sessions WHERE id=?', [$id]);
101
return true;
102
}
103
public function gc(int $max_lifetime): int|false {
104
return query('DELETE FROM sessions WHERE expires<?', [time()])->rowCount();
105
}
106
}
107
108
function localDev(): bool {
109
$host = parse_url('http://'.($_SERVER['HTTP_HOST'] ?? ''), PHP_URL_HOST);
110
return is_string($host) && in_array(strtolower($host), ['localhost', '127.0.0.1', '[::1]'], true)
111
&& in_array($_SERVER['REMOTE_ADDR'] ?? '', ['127.0.0.1', '::1'], true);
112
}
113
114
function config(): array {
115
$dir = dataDir();
116
$path = $dir.'/config.php';
117
if (!is_dir($dir) && !mkdir($dir, 0775, true) && !is_dir($dir)) throw new RuntimeException('De datamap moet schrijfbaar zijn om de configuratie te maken.');
118
$lock = fopen($dir.'/config.lock', 'c');
119
if ($lock === false) throw new RuntimeException('De datamap moet schrijfbaar zijn om de configuratie te maken.');
120
try {
121
if (!flock($lock, LOCK_EX)) throw new RuntimeException('De configuratie kon niet worden vergrendeld.');
122
if (!file_exists($path)) {
123
$secret = bin2hex(random_bytes(32));
124
$template = <<<PHP
125
<?php
126
// Vul deze waarden op deze server in. Lege velden gebruiken omgevingsvariabelen.
127
// Productie-URL: https://projects.timfalken.com/verhaaltjesboek
128
// client_id is het geregistreerde domein, meestal projects.timfalken.com.
129
// Het geheim komt uit https://auth.timfalken.com/admin en hoort alleen in dit bestand.
130
// key_secret versleutelt API-sleutels zodat een beheerder ze opnieuw kan tonen. Laat die staan.
131
return [
132
'base_url' => '',
133
'client_id' => '',
134
'client_secret' => '',
135
'key_secret' => '$secret',
136
];
137
138
PHP;
139
if (file_put_contents($path, $template) !== strlen($template)) throw new RuntimeException('data/config.php kon niet worden gemaakt.');
140
}
141
$values = require $path;
142
if (!is_array($values)) throw new RuntimeException('data/config.php moet een array teruggeven.');
143
$values = ensureKeySecret($path, $values);
144
} finally {
145
flock($lock, LOCK_UN);
146
fclose($lock);
147
}
148
foreach (['base_url' => 'VERHALENBOEK_BASE_URL', 'client_id' => 'VERHALENBOEK_CLIENT_ID', 'client_secret' => 'VERHALENBOEK_CLIENT_SECRET'] as $key => $env) {
149
if (($values[$key] ?? '') === '') $values[$key] = getenv($env) ?: '';
150
}
151
return $values;
152
}
153
154
function ensureKeySecret(string $path, array $values): array {
155
$secret = $values['key_secret'] ?? '';
156
if (is_string($secret) && preg_match('/^[a-f0-9]{64}$/', $secret)) return $values;
157
$secret = bin2hex(random_bytes(32));
158
$values['key_secret'] = $secret;
159
$raw = file_get_contents($path);
160
if (!is_string($raw)) throw new RuntimeException('data/config.php kon niet worden gelezen.');
161
if (preg_match("/'key_secret'\\s*=>\\s*'[^']*'/", $raw)) {
162
$updated = preg_replace("/'key_secret'\\s*=>\\s*'[^']*'/", "'key_secret' => '".$secret."'", $raw, 1);
163
} else {
164
$updated = preg_replace("/(\\r?\\n)(\\];)/", "$1 'key_secret' => '".$secret."',$1$2", $raw, 1);
165
}
166
if (!is_string($updated) || !str_contains($updated, $secret) || file_put_contents($path, $updated) !== strlen($updated)) {
167
throw new RuntimeException('key_secret kon niet in data/config.php worden gezet.');
168
}
169
return $values;
170
}
171
172
function authPublicBase(): string {
173
if (localDev()) return baseUrl();
174
$base = rtrim((string)(config()['base_url'] ?? ''), '/');
175
if (str_starts_with($base, 'https://')) return $base;
176
$env = getenv('VERHALENBOEK_BASE_URL');
177
if (is_string($env) && str_starts_with($env = rtrim($env, '/'), 'https://')) return $env;
178
return '';
179
}
180
181
function authHint(string $kind): string {
182
$base = authPublicBase();
183
$keys = ($base !== '' ? $base : '').'/#/sleutels';
184
$docs = ($base !== '' ? $base.'/' : '').'docs.php';
185
$how = 'Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Sleutels op '.$keys.'. Uitleg: '.$docs;
186
return match ($kind) {
187
'missing' => 'Er is geen Authorization-header. '.$how,
188
'format' => 'De Authorization-header heeft het verkeerde formaat. Gebruik Bearer, gevolgd door vb_ en 64 hexadecimale tekens. '.$how,
189
'rejected' => 'Deze API-sleutel is onbekend of ingetrokken. '.$how,
190
'writer' => 'Dit mag alleen met een API-sleutel of als beheerder. '.$how,
191
'admin' => 'Sleutels beheren kan alleen als ingelogde beheerder, niet met een API-sleutel. Open Sleutels op '.$keys.'. Uitleg: '.$docs,
192
default => $how,
193
};
194
}
195
196
function baseUrl(): string {
197
if (localDev()) {
198
$dir = rtrim(str_replace('\\', '/', dirname($_SERVER['SCRIPT_NAME'] ?? '')), '/');
199
if ($dir === '/' || $dir === '.') $dir = '';
200
return 'http://'.$_SERVER['HTTP_HOST'].$dir;
201
}
202
$base = rtrim((string)config()['base_url'], '/');
203
if (!str_starts_with($base, 'https://')) throw new RuntimeException("Zet 'base_url' in data/config.php op de HTTPS-URL van deze installatie, of zet VERHALENBOEK_BASE_URL. De datamap wordt niet meegedeployed.");
204
return $base;
205
}
206
207
function assetVersion(): string {
208
static $version;
209
if ($version !== null) return $version;
210
$file = dirname(__DIR__).'/asset-version.txt';
211
if (is_readable($file)) {
212
$hash = trim((string)file_get_contents($file));
213
if ($hash !== '' && preg_match('/^[0-9a-f]{7,64}$/i', $hash)) return $version = $hash;
214
}
215
$env = getenv('CI_COMMIT_SHA') ?: getenv('VERHALENBOEK_ASSET_VERSION') ?: '';
216
if (is_string($env) && preg_match('/^[0-9a-f]{7,64}$/i', trim($env))) return $version = trim($env);
217
$git = dirname(__DIR__, 2).'/.git';
218
if (is_dir($git)) {
219
$out = @shell_exec('git -C '.escapeshellarg(dirname($git)).' rev-parse HEAD 2>/dev/null');
220
if (is_string($out) && preg_match('/^[0-9a-f]{7,64}$/i', trim($out))) return $version = trim($out);
221
}
222
$js = dirname(__DIR__).'/assets/app.js';
223
return $version = is_file($js) ? (string)filemtime($js) : '0';
224
}
225
226
function assetUrl(string $path): string {
227
$path = ltrim($path, '/');
228
$version = rawurlencode(assetVersion());
229
return str_contains($path, '?') ? $path.'&v='.$version : $path.'?v='.$version;
230
}
231
232
function authRequest(string $path, ?array $form = null, ?string $token = null): array {
233
$ch=curl_init('https://auth.timfalken.com'.$path);
234
$headers = ['Accept: application/json', 'User-Agent: Verhalenboek/1.0'];
235
if ($token) $headers[] = 'Authorization: Bearer '.$token;
236
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 15, CURLOPT_HTTPHEADER => $headers]);
237
if ($form !== null) curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_POSTFIELDS => http_build_query($form)]);
238
$body = curl_exec($ch);
239
$status = (int)curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
240
curl_close($ch);
241
$data = is_string($body) ? json_decode($body, true) : null;
242
if ($status !== 200 || !is_array($data)) throw new RuntimeException('De authenticatiedienst is niet bereikbaar of de sessie is verlopen. Log opnieuw in.');
243
return $data;
244
}
245
246
/** @return array{0:string,1:string} */
247
function authIdentity(array $profile): array {
248
if (!isset($profile['id'], $profile['username']) || !is_string($profile['username'])) {
249
throw new RuntimeException('Het accountantwoord mist een id of gebruikersnaam.');
250
}
251
$raw = $profile['id'];
252
$numeric = is_int($raw) || (is_string($raw) && preg_match('/^[1-9][0-9]{0,17}$/', $raw));
253
if (!$numeric || (int)$raw < 1) throw new RuntimeException('Ongeldig account-id.');
254
return ['auth:'.(int)$raw, $profile['username']];
255
}
256
257
function loginUser(string $id, string $name): void {
258
if (!preg_match('/^(?:local:test_user_[12]|auth:[1-9][0-9]{0,17})$/', $id)) throw new RuntimeException('Ongeldig account.');
259
$name = trim($name);
260
if ($name === '' || mb_strlen($name) > 64 || preg_match('/[\x00-\x1F]/', $name)) throw new RuntimeException('Ongeldige gebruikersnaam.');
261
transaction(function () use ($id, $name): void {
262
$existing = query('SELECT id FROM users WHERE id=?', [$id])->fetch();
263
if ($existing) {
264
query('UPDATE users SET name=? WHERE id=?', [$name, $id]);
265
return;
266
}
267
$count = (int)query('SELECT COUNT(*) FROM users')->fetchColumn();
268
query('INSERT INTO users (id, name, role, theme, font, created) VALUES (?,?,?,?,?,?)', [
269
$id, $name, $count === 0 ? 'admin' : 'user', 'system', 'serif', time(),
270
]);
271
});
272
session_regenerate_id(true);
273
$_SESSION['user'] = $id;
274
$_SESSION['csrf'] = bin2hex(random_bytes(24));
275
}
276
277
config();
278
session_name('verhalenboek_session');
279
ini_set('session.use_strict_mode', '1');
280
$sessionLifetime = 86400;
281
$sessionPath = rtrim(str_replace('\\', '/', dirname($_SERVER['SCRIPT_NAME'] ?? '')), '/').'/';
282
if ($sessionPath === '//') $sessionPath = '/';
283
$sessionSecure = !localDev();
284
session_set_cookie_params(['lifetime' => $sessionLifetime, 'path' => $sessionPath, 'secure' => $sessionSecure, 'httponly' => true, 'samesite' => 'Lax']);
285
session_set_save_handler(new DatabaseSessions(), true);
286
session_start();
287
if (session_status() === PHP_SESSION_ACTIVE && session_id() !== '') {
288
setcookie(session_name(), session_id(), [
289
'expires' => time() + $sessionLifetime,
290
'path' => $sessionPath,
291
'secure' => $sessionSecure,
292
'httponly' => true,
293
'samesite' => 'Lax',
294
]);
295
}
296
if (localDev() && !in_array($_SESSION['user'] ?? '', ['local:test_user_1', 'local:test_user_2'], true)) {
297
unset($_SESSION['token'], $_SESSION['expires'], $_SESSION['validated']);
298
loginUser('local:test_user_1', 'test_user_1');
299
}
300
301
function user(): string {
302
if (!isset($_SESSION['user'])) fail('Log in om verder te gaan.', 401, 'missing');
303
if (!localDev() && (($_SESSION['expires'] ?? 0) < time())) {
304
unset($_SESSION['user']);
305
fail('Je sessie is verlopen. Log opnieuw in.', 401, 'missing');
306
}
307
return $_SESSION['user'];
308
}
309
310
function fail(string $message, int $status = 400, ?string $auth = null): never {
311
http_response_code($status);
312
header('Content-Type: application/json; charset=utf-8');
313
$body = ['error' => $message];
314
if ($auth !== null) {
315
$body['how_to_authenticate'] = authHint($auth);
316
$body['hint'] = $body['how_to_authenticate'];
317
if ($status === 401) header('WWW-Authenticate: Bearer');
318
}
319
echo json_encode($body, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
320
exit;
321
}
322
323
function jsonOut(mixed $data, int $status = 200): never {
324
http_response_code($status);
325
header('Content-Type: application/json; charset=utf-8');
326
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
327
exit;
328
}
329
330
function bearerToken(): ?string {
331
$header = $_SERVER['HTTP_AUTHORIZATION'] ?? $_SERVER['REDIRECT_HTTP_AUTHORIZATION'] ?? '';
332
if ($header === '' && function_exists('getallheaders')) {
333
$headers = getallheaders();
334
if (is_array($headers)) {
335
foreach ($headers as $name => $value) {
336
if (strcasecmp((string)$name, 'Authorization') === 0) { $header = (string)$value; break; }
337
}
338
}
339
}
340
if ($header === '') return null;
341
if (preg_match('/^Bearer\s+(\S+)\s*$/i', $header, $match)) return $match[1];
342
throw new AppException('De Authorization-header heeft het verkeerde formaat.', 401, 'format');
343
}
344
345
function authenticate(): array {
346
$token = bearerToken();
347
if ($token !== null) return actorFromToken($token);
348
$id = user();
349
if (!localDev() && time() - ($_SESSION['validated'] ?? 0) > 60) {
350
try {
351
authRequest('/api/me', null, (string)($_SESSION['token'] ?? ''));
352
if (($_SESSION['expires'] ?? 0) - time() < 900) {
353
$extended = authRequest('/api/session/extend', [], (string)$_SESSION['token']);
354
$_SESSION['expires'] = time() + (int)$extended['expires_in'];
355
}
356
$_SESSION['validated'] = time();
357
} catch (Throwable $e) {
358
unset($_SESSION['user']);
359
fail('Log opnieuw in.', 401, 'missing');
360
}
361
}
362
$row = query('SELECT id, role FROM users WHERE id=?', [$id])->fetch();
363
if (!$row) fail('Log opnieuw in.', 401, 'missing');
364
return ['kind' => 'user', 'userId' => $row['id'], 'role' => $row['role']];
365
}
366
367
function requireCsrf(array $actor): void {
368
if ($actor['kind'] === 'token') return;
369
$sent = $_SERVER['HTTP_X_CSRF_TOKEN'] ?? '';
370
$expected = $_SESSION['csrf'] ?? '';
371
if (!is_string($sent) || !is_string($expected) || $expected === '' || !hash_equals($expected, $sent)) {
372
fail('Ongeldige sessie. Laad de pagina opnieuw.', 403);
373
}
374
}
375
376
function requireWriter(array $actor): void {
377
if ($actor['kind'] === 'token') return;
378
if (($actor['role'] ?? '') !== 'admin') fail('Alleen een beheerder mag dit wijzigen.', 403, 'writer');
379
}
380
381
function requireAdminSession(array $actor): void {
382
if ($actor['kind'] !== 'user' || ($actor['role'] ?? '') !== 'admin') fail('Alleen een beheerder mag sleutels beheren.', 403, 'admin');
383
}
384
385
function requireReader(array $actor): void {
386
if ($actor['kind'] !== 'user') fail('Leesstatus hoort bij een ingelogde lezer.', 403);
387
}
388
389
function readJson(): array {
390
$raw = file_get_contents('php://input');
391
if ($raw === false || trim($raw) === '') throw new AppException('De aanvraag heeft een JSON-object nodig.');
392
try {
393
$data = json_decode($raw, true, 64, JSON_THROW_ON_ERROR);
394
} catch (JsonException) {
395
throw new AppException('De JSON is ongeldig.');
396
}
397
if (!is_array($data) || array_is_list($data)) throw new AppException('De JSON moet een object zijn.');
398
return $data;
399
}
400
401
function apiRoute(): string {
402
$candidates = [];
403
$info = $_SERVER['PATH_INFO'] ?? '';
404
if (is_string($info) && $info !== '') $candidates[] = $info;
405
$uri = rawurldecode(parse_url($_SERVER['REQUEST_URI'] ?? '/', PHP_URL_PATH) ?: '/');
406
if (preg_match('#/api\.php(/.*)$#', $uri, $match)) $candidates[] = $match[1];
407
foreach ($candidates as $candidate) {
408
$candidate = '/'.trim((string)$candidate, '/');
409
if ($candidate !== '/') return $candidate;
410
}
411
return '/';
412
}
@@ -0,0 +1,412 @@1
<?php2
declare(strict_types=1);3
require_once __DIR__.'/Storybook.php';4
ini_set('display_errors', '0');5
ini_set('log_errors', '1');6
ini_set('error_log', dataDir().'/php-errors.log');7
header('X-Content-Type-Options: nosniff');8
header('Referrer-Policy: same-origin');9
header("Content-Security-Policy: default-src 'self'; img-src 'self'; style-src 'self'; script-src 'self'; connect-src 'self'; frame-ancestors 'none'; base-uri 'self'; form-action 'self'");10
header('Cache-Control: no-store');11
12
function dataDir(): string {13
$env = getenv('VERHALENBOEK_DATA_DIR');14
if (is_string($env) && $env !== '') return rtrim($env, '/');15
return dirname(__DIR__).'/data';16
}17
18
function db(): PDO {19
static $db;20
if ($db) return $db;21
$dir = dataDir();22
if (!is_dir($dir) && !mkdir($dir, 0775, true) && !is_dir($dir)) throw new RuntimeException('De datamap moet bestaan en schrijfbaar zijn.');23
$db = new PDO('sqlite:'.$dir.'/verhalenboek.sqlite', null, null, [24
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,25
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,26
]);27
$db->exec('PRAGMA journal_mode=WAL; PRAGMA foreign_keys=ON; PRAGMA busy_timeout=5000;');28
$db->exec('CREATE TABLE IF NOT EXISTS users (29
id TEXT PRIMARY KEY,30
name TEXT NOT NULL,31
role TEXT NOT NULL DEFAULT \'user\' CHECK(role IN (\'admin\',\'user\')),32
theme TEXT NOT NULL DEFAULT \'system\' CHECK(theme IN (\'system\',\'light\',\'dark\')),33
font TEXT NOT NULL DEFAULT \'serif\' CHECK(font IN (\'serif\',\'sans\',\'rounded\')),34
created INTEGER NOT NULL35
);36
CREATE TABLE IF NOT EXISTS sessions (id TEXT PRIMARY KEY, payload TEXT NOT NULL, expires INTEGER NOT NULL);37
CREATE TABLE IF NOT EXISTS days (38
id INTEGER PRIMARY KEY AUTOINCREMENT,39
date TEXT NOT NULL UNIQUE,40
title TEXT NOT NULL,41
created INTEGER NOT NULL,42
updated INTEGER NOT NULL43
);44
CREATE TABLE IF NOT EXISTS stories (45
id INTEGER PRIMARY KEY AUTOINCREMENT,46
day_id INTEGER NOT NULL REFERENCES days(id) ON DELETE CASCADE,47
position INTEGER NOT NULL CHECK(position BETWEEN 1 AND 3),48
title TEXT NOT NULL,49
created INTEGER NOT NULL,50
updated INTEGER NOT NULL,51
UNIQUE(day_id, position)52
);53
CREATE TABLE IF NOT EXISTS paragraphs (54
id INTEGER PRIMARY KEY AUTOINCREMENT,55
story_id INTEGER NOT NULL REFERENCES stories(id) ON DELETE CASCADE,56
position INTEGER NOT NULL CHECK(position >= 1),57
body TEXT NOT NULL,58
UNIQUE(story_id, position)59
);60
CREATE TABLE IF NOT EXISTS reads (61
user_id TEXT NOT NULL REFERENCES users(id),62
day_id INTEGER NOT NULL REFERENCES days(id) ON DELETE CASCADE,63
read_at INTEGER NOT NULL,64
PRIMARY KEY(user_id, day_id)65
);66
CREATE TABLE IF NOT EXISTS api_keys (67
id INTEGER PRIMARY KEY AUTOINCREMENT,68
user_id TEXT NOT NULL REFERENCES users(id),69
name TEXT NOT NULL,70
token_hash TEXT NOT NULL UNIQUE,71
token_prefix TEXT NOT NULL,72
token_cipher TEXT NOT NULL DEFAULT \'\',73
created INTEGER NOT NULL,74
revoked INTEGER75
);');76
$columns = array_column($db->query('PRAGMA table_info(api_keys)')->fetchAll(), 'name');77
if (!in_array('token_cipher', $columns, true)) {78
$db->exec("ALTER TABLE api_keys ADD COLUMN token_cipher TEXT NOT NULL DEFAULT ''");79
}80
return $db;81
}82
83
function query(string $sql, array $args = []): PDOStatement {84
$statement = db()->prepare($sql);85
$statement->execute($args);86
return $statement;87
}88
89
final class DatabaseSessions implements SessionHandlerInterface {90
public function open(string $path, string $name): bool { return true; }91
public function close(): bool { return true; }92
public function read(string $id): string|false {93
return query('SELECT payload FROM sessions WHERE id=? AND expires>?', [$id, time()])->fetchColumn() ?: '';94
}95
public function write(string $id, string $data): bool {96
query('INSERT OR REPLACE INTO sessions (id, payload, expires) VALUES (?,?,?)', [$id, $data, time() + 86400]);97
return true;98
}99
public function destroy(string $id): bool {100
query('DELETE FROM sessions WHERE id=?', [$id]);101
return true;102
}103
public function gc(int $max_lifetime): int|false {104
return query('DELETE FROM sessions WHERE expires<?', [time()])->rowCount();105
}106
}107
108
function localDev(): bool {109
$host = parse_url('http://'.($_SERVER['HTTP_HOST'] ?? ''), PHP_URL_HOST);110
return is_string($host) && in_array(strtolower($host), ['localhost', '127.0.0.1', '[::1]'], true)111
&& in_array($_SERVER['REMOTE_ADDR'] ?? '', ['127.0.0.1', '::1'], true);112
}113
114
function config(): array {115
$dir = dataDir();116
$path = $dir.'/config.php';117
if (!is_dir($dir) && !mkdir($dir, 0775, true) && !is_dir($dir)) throw new RuntimeException('De datamap moet schrijfbaar zijn om de configuratie te maken.');118
$lock = fopen($dir.'/config.lock', 'c');119
if ($lock === false) throw new RuntimeException('De datamap moet schrijfbaar zijn om de configuratie te maken.');120
try {121
if (!flock($lock, LOCK_EX)) throw new RuntimeException('De configuratie kon niet worden vergrendeld.');122
if (!file_exists($path)) {123
$secret = bin2hex(random_bytes(32));124
$template = <<<PHP125
<?php126
// Vul deze waarden op deze server in. Lege velden gebruiken omgevingsvariabelen.127
// Productie-URL: https://projects.timfalken.com/verhaaltjesboek128
// client_id is het geregistreerde domein, meestal projects.timfalken.com.129
// Het geheim komt uit https://auth.timfalken.com/admin en hoort alleen in dit bestand.130
// key_secret versleutelt API-sleutels zodat een beheerder ze opnieuw kan tonen. Laat die staan.131
return [132
'base_url' => '',133
'client_id' => '',134
'client_secret' => '',135
'key_secret' => '$secret',136
];137
138
PHP;139
if (file_put_contents($path, $template) !== strlen($template)) throw new RuntimeException('data/config.php kon niet worden gemaakt.');140
}141
$values = require $path;142
if (!is_array($values)) throw new RuntimeException('data/config.php moet een array teruggeven.');143
$values = ensureKeySecret($path, $values);144
} finally {145
flock($lock, LOCK_UN);146
fclose($lock);147
}148
foreach (['base_url' => 'VERHALENBOEK_BASE_URL', 'client_id' => 'VERHALENBOEK_CLIENT_ID', 'client_secret' => 'VERHALENBOEK_CLIENT_SECRET'] as $key => $env) {149
if (($values[$key] ?? '') === '') $values[$key] = getenv($env) ?: '';150
}151
return $values;152
}153
154
function ensureKeySecret(string $path, array $values): array {155
$secret = $values['key_secret'] ?? '';156
if (is_string($secret) && preg_match('/^[a-f0-9]{64}$/', $secret)) return $values;157
$secret = bin2hex(random_bytes(32));158
$values['key_secret'] = $secret;159
$raw = file_get_contents($path);160
if (!is_string($raw)) throw new RuntimeException('data/config.php kon niet worden gelezen.');161
if (preg_match("/'key_secret'\\s*=>\\s*'[^']*'/", $raw)) {162
$updated = preg_replace("/'key_secret'\\s*=>\\s*'[^']*'/", "'key_secret' => '".$secret."'", $raw, 1);163
} else {164
$updated = preg_replace("/(\\r?\\n)(\\];)/", "$1 'key_secret' => '".$secret."',$1$2", $raw, 1);165
}166
if (!is_string($updated) || !str_contains($updated, $secret) || file_put_contents($path, $updated) !== strlen($updated)) {167
throw new RuntimeException('key_secret kon niet in data/config.php worden gezet.');168
}169
return $values;170
}171
172
function authPublicBase(): string {173
if (localDev()) return baseUrl();174
$base = rtrim((string)(config()['base_url'] ?? ''), '/');175
if (str_starts_with($base, 'https://')) return $base;176
$env = getenv('VERHALENBOEK_BASE_URL');177
if (is_string($env) && str_starts_with($env = rtrim($env, '/'), 'https://')) return $env;178
return '';179
}180
181
function authHint(string $kind): string {182
$base = authPublicBase();183
$keys = ($base !== '' ? $base : '').'/#/sleutels';184
$docs = ($base !== '' ? $base.'/' : '').'docs.php';185
$how = 'Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Sleutels op '.$keys.'. Uitleg: '.$docs;186
return match ($kind) {187
'missing' => 'Er is geen Authorization-header. '.$how,188
'format' => 'De Authorization-header heeft het verkeerde formaat. Gebruik Bearer, gevolgd door vb_ en 64 hexadecimale tekens. '.$how,189
'rejected' => 'Deze API-sleutel is onbekend of ingetrokken. '.$how,190
'writer' => 'Dit mag alleen met een API-sleutel of als beheerder. '.$how,191
'admin' => 'Sleutels beheren kan alleen als ingelogde beheerder, niet met een API-sleutel. Open Sleutels op '.$keys.'. Uitleg: '.$docs,192
default => $how,193
};194
}195
196
function baseUrl(): string {197
if (localDev()) {198
$dir = rtrim(str_replace('\\', '/', dirname($_SERVER['SCRIPT_NAME'] ?? '')), '/');199
if ($dir === '/' || $dir === '.') $dir = '';200
return 'http://'.$_SERVER['HTTP_HOST'].$dir;201
}202
$base = rtrim((string)config()['base_url'], '/');203
if (!str_starts_with($base, 'https://')) throw new RuntimeException("Zet 'base_url' in data/config.php op de HTTPS-URL van deze installatie, of zet VERHALENBOEK_BASE_URL. De datamap wordt niet meegedeployed.");204
return $base;205
}206
207
function assetVersion(): string {208
static $version;209
if ($version !== null) return $version;210
$file = dirname(__DIR__).'/asset-version.txt';211
if (is_readable($file)) {212
$hash = trim((string)file_get_contents($file));213
if ($hash !== '' && preg_match('/^[0-9a-f]{7,64}$/i', $hash)) return $version = $hash;214
}215
$env = getenv('CI_COMMIT_SHA') ?: getenv('VERHALENBOEK_ASSET_VERSION') ?: '';216
if (is_string($env) && preg_match('/^[0-9a-f]{7,64}$/i', trim($env))) return $version = trim($env);217
$git = dirname(__DIR__, 2).'/.git';218
if (is_dir($git)) {219
$out = @shell_exec('git -C '.escapeshellarg(dirname($git)).' rev-parse HEAD 2>/dev/null');220
if (is_string($out) && preg_match('/^[0-9a-f]{7,64}$/i', trim($out))) return $version = trim($out);221
}222
$js = dirname(__DIR__).'/assets/app.js';223
return $version = is_file($js) ? (string)filemtime($js) : '0';224
}225
226
function assetUrl(string $path): string {227
$path = ltrim($path, '/');228
$version = rawurlencode(assetVersion());229
return str_contains($path, '?') ? $path.'&v='.$version : $path.'?v='.$version;230
}231
232
function authRequest(string $path, ?array $form = null, ?string $token = null): array {233
$ch=curl_init('https://auth.timfalken.com'.$path);234
$headers = ['Accept: application/json', 'User-Agent: Verhalenboek/1.0'];235
if ($token) $headers[] = 'Authorization: Bearer '.$token;236
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 15, CURLOPT_HTTPHEADER => $headers]);237
if ($form !== null) curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_POSTFIELDS => http_build_query($form)]);238
$body = curl_exec($ch);239
$status = (int)curl_getinfo($ch, CURLINFO_RESPONSE_CODE);240
curl_close($ch);241
$data = is_string($body) ? json_decode($body, true) : null;242
if ($status !== 200 || !is_array($data)) throw new RuntimeException('De authenticatiedienst is niet bereikbaar of de sessie is verlopen. Log opnieuw in.');243
return $data;244
}245
246
/** @return array{0:string,1:string} */247
function authIdentity(array $profile): array {248
if (!isset($profile['id'], $profile['username']) || !is_string($profile['username'])) {249
throw new RuntimeException('Het accountantwoord mist een id of gebruikersnaam.');250
}251
$raw = $profile['id'];252
$numeric = is_int($raw) || (is_string($raw) && preg_match('/^[1-9][0-9]{0,17}$/', $raw));253
if (!$numeric || (int)$raw < 1) throw new RuntimeException('Ongeldig account-id.');254
return ['auth:'.(int)$raw, $profile['username']];255
}256
257
function loginUser(string $id, string $name): void {258
if (!preg_match('/^(?:local:test_user_[12]|auth:[1-9][0-9]{0,17})$/', $id)) throw new RuntimeException('Ongeldig account.');259
$name = trim($name);260
if ($name === '' || mb_strlen($name) > 64 || preg_match('/[\x00-\x1F]/', $name)) throw new RuntimeException('Ongeldige gebruikersnaam.');261
transaction(function () use ($id, $name): void {262
$existing = query('SELECT id FROM users WHERE id=?', [$id])->fetch();263
if ($existing) {264
query('UPDATE users SET name=? WHERE id=?', [$name, $id]);265
return;266
}267
$count = (int)query('SELECT COUNT(*) FROM users')->fetchColumn();268
query('INSERT INTO users (id, name, role, theme, font, created) VALUES (?,?,?,?,?,?)', [269
$id, $name, $count === 0 ? 'admin' : 'user', 'system', 'serif', time(),270
]);271
});272
session_regenerate_id(true);273
$_SESSION['user'] = $id;274
$_SESSION['csrf'] = bin2hex(random_bytes(24));275
}276
277
config();278
session_name('verhalenboek_session');279
ini_set('session.use_strict_mode', '1');280
$sessionLifetime = 86400;281
$sessionPath = rtrim(str_replace('\\', '/', dirname($_SERVER['SCRIPT_NAME'] ?? '')), '/').'/';282
if ($sessionPath === '//') $sessionPath = '/';283
$sessionSecure = !localDev();284
session_set_cookie_params(['lifetime' => $sessionLifetime, 'path' => $sessionPath, 'secure' => $sessionSecure, 'httponly' => true, 'samesite' => 'Lax']);285
session_set_save_handler(new DatabaseSessions(), true);286
session_start();287
if (session_status() === PHP_SESSION_ACTIVE && session_id() !== '') {288
setcookie(session_name(), session_id(), [289
'expires' => time() + $sessionLifetime,290
'path' => $sessionPath,291
'secure' => $sessionSecure,292
'httponly' => true,293
'samesite' => 'Lax',294
]);295
}296
if (localDev() && !in_array($_SESSION['user'] ?? '', ['local:test_user_1', 'local:test_user_2'], true)) {297
unset($_SESSION['token'], $_SESSION['expires'], $_SESSION['validated']);298
loginUser('local:test_user_1', 'test_user_1');299
}300
301
function user(): string {302
if (!isset($_SESSION['user'])) fail('Log in om verder te gaan.', 401, 'missing');303
if (!localDev() && (($_SESSION['expires'] ?? 0) < time())) {304
unset($_SESSION['user']);305
fail('Je sessie is verlopen. Log opnieuw in.', 401, 'missing');306
}307
return $_SESSION['user'];308
}309
310
function fail(string $message, int $status = 400, ?string $auth = null): never {311
http_response_code($status);312
header('Content-Type: application/json; charset=utf-8');313
$body = ['error' => $message];314
if ($auth !== null) {315
$body['how_to_authenticate'] = authHint($auth);316
$body['hint'] = $body['how_to_authenticate'];317
if ($status === 401) header('WWW-Authenticate: Bearer');318
}319
echo json_encode($body, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);320
exit;321
}322
323
function jsonOut(mixed $data, int $status = 200): never {324
http_response_code($status);325
header('Content-Type: application/json; charset=utf-8');326
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);327
exit;328
}329
330
function bearerToken(): ?string {331
$header = $_SERVER['HTTP_AUTHORIZATION'] ?? $_SERVER['REDIRECT_HTTP_AUTHORIZATION'] ?? '';332
if ($header === '' && function_exists('getallheaders')) {333
$headers = getallheaders();334
if (is_array($headers)) {335
foreach ($headers as $name => $value) {336
if (strcasecmp((string)$name, 'Authorization') === 0) { $header = (string)$value; break; }337
}338
}339
}340
if ($header === '') return null;341
if (preg_match('/^Bearer\s+(\S+)\s*$/i', $header, $match)) return $match[1];342
throw new AppException('De Authorization-header heeft het verkeerde formaat.', 401, 'format');343
}344
345
function authenticate(): array {346
$token = bearerToken();347
if ($token !== null) return actorFromToken($token);348
$id = user();349
if (!localDev() && time() - ($_SESSION['validated'] ?? 0) > 60) {350
try {351
authRequest('/api/me', null, (string)($_SESSION['token'] ?? ''));352
if (($_SESSION['expires'] ?? 0) - time() < 900) {353
$extended = authRequest('/api/session/extend', [], (string)$_SESSION['token']);354
$_SESSION['expires'] = time() + (int)$extended['expires_in'];355
}356
$_SESSION['validated'] = time();357
} catch (Throwable $e) {358
unset($_SESSION['user']);359
fail('Log opnieuw in.', 401, 'missing');360
}361
}362
$row = query('SELECT id, role FROM users WHERE id=?', [$id])->fetch();363
if (!$row) fail('Log opnieuw in.', 401, 'missing');364
return ['kind' => 'user', 'userId' => $row['id'], 'role' => $row['role']];365
}366
367
function requireCsrf(array $actor): void {368
if ($actor['kind'] === 'token') return;369
$sent = $_SERVER['HTTP_X_CSRF_TOKEN'] ?? '';370
$expected = $_SESSION['csrf'] ?? '';371
if (!is_string($sent) || !is_string($expected) || $expected === '' || !hash_equals($expected, $sent)) {372
fail('Ongeldige sessie. Laad de pagina opnieuw.', 403);373
}374
}375
376
function requireWriter(array $actor): void {377
if ($actor['kind'] === 'token') return;378
if (($actor['role'] ?? '') !== 'admin') fail('Alleen een beheerder mag dit wijzigen.', 403, 'writer');379
}380
381
function requireAdminSession(array $actor): void {382
if ($actor['kind'] !== 'user' || ($actor['role'] ?? '') !== 'admin') fail('Alleen een beheerder mag sleutels beheren.', 403, 'admin');383
}384
385
function requireReader(array $actor): void {386
if ($actor['kind'] !== 'user') fail('Leesstatus hoort bij een ingelogde lezer.', 403);387
}388
389
function readJson(): array {390
$raw = file_get_contents('php://input');391
if ($raw === false || trim($raw) === '') throw new AppException('De aanvraag heeft een JSON-object nodig.');392
try {393
$data = json_decode($raw, true, 64, JSON_THROW_ON_ERROR);394
} catch (JsonException) {395
throw new AppException('De JSON is ongeldig.');396
}397
if (!is_array($data) || array_is_list($data)) throw new AppException('De JSON moet een object zijn.');398
return $data;399
}400
401
function apiRoute(): string {402
$candidates = [];403
$info = $_SERVER['PATH_INFO'] ?? '';404
if (is_string($info) && $info !== '') $candidates[] = $info;405
$uri = rawurldecode(parse_url($_SERVER['REQUEST_URI'] ?? '/', PHP_URL_PATH) ?: '/');406
if (preg_match('#/api\.php(/.*)$#', $uri, $match)) $candidates[] = $match[1];407
foreach ($candidates as $candidate) {408
$candidate = '/'.trim((string)$candidate, '/');409
if ($candidate !== '/') return $candidate;410
}411
return '/';412
}@@ -0,0 +1,18 @@
1
<?php
2
declare(strict_types=1);
3
// Router voor de lokale PHP-server. Productie gebruikt de echte bestanden en .htaccess.
4
$path = rawurldecode(parse_url($_SERVER['REQUEST_URI'] ?? '/', PHP_URL_PATH) ?? '/');
5
$rel = $path === '' ? '/' : $path;
6
if (preg_match('~(?:^|/)(?:data|lib|tests|\.[^/]*)(?:/|$)|(?:README\.md|router\.php)$~i', $rel)) {
7
http_response_code(403);
8
header('Content-Type: text/plain; charset=utf-8');
9
exit('Verboden');
10
}
11
if (preg_match('~^/api\.php(?:/|$)~', $rel)) {
12
require __DIR__.'/api.php';
13
return true;
14
}
15
$full = __DIR__.$rel;
16
if ($rel !== '/' && is_file($full)) return false;
17
require __DIR__.'/index.php';
18
return true;
@@ -0,0 +1,18 @@1
<?php2
declare(strict_types=1);3
// Router voor de lokale PHP-server. Productie gebruikt de echte bestanden en .htaccess.4
$path = rawurldecode(parse_url($_SERVER['REQUEST_URI'] ?? '/', PHP_URL_PATH) ?? '/');5
$rel = $path === '' ? '/' : $path;6
if (preg_match('~(?:^|/)(?:data|lib|tests|\.[^/]*)(?:/|$)|(?:README\.md|router\.php)$~i', $rel)) {7
http_response_code(403);8
header('Content-Type: text/plain; charset=utf-8');9
exit('Verboden');10
}11
if (preg_match('~^/api\.php(?:/|$)~', $rel)) {12
require __DIR__.'/api.php';13
return true;14
}15
$full = __DIR__.$rel;16
if ($rel !== '/' && is_file($full)) return false;17
require __DIR__.'/index.php';18
return true;@@ -0,0 +1 @@
1
Require all denied
@@ -0,0 +1 @@1
Require all denied@@ -0,0 +1,286 @@
1
#!/usr/bin/env python3
2
"""Geïsoleerde API-tests. De echte database van de applicatie blijft onaangeroerd."""
3
import json
4
import os
5
import signal
6
import http.cookiejar
7
import shutil
8
import socket
9
import sqlite3
10
import subprocess
11
import tempfile
12
import time
13
import urllib.error
14
import urllib.request
15
from pathlib import Path
16
17
WEB = Path(__file__).resolve().parents[1]
18
ARTIFACTS = WEB / 'tests/artifacts'
19
ARTIFACTS.mkdir(exist_ok=True)
20
checks = 0
21
22
def check(value, label):
23
global checks
24
checks += 1
25
assert value, label
26
27
def stories(prefix='Verhaal'):
28
return [
29
{'title': f'{prefix} een', 'paragraphs': ['Eerste alinea.', 'Tweede alinea met één accent.']},
30
{'title': f'{prefix} twee', 'paragraphs': ['Midden.']},
31
{'title': f'{prefix} drie', 'paragraphs': ['Slot.']},
32
]
33
34
with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
35
root = Path(tmp)
36
for name in ['api.php', 'index.php', 'auth.php', 'callback.php', 'router.php', 'docs.php']:
37
shutil.copy(WEB / name, root / name)
38
shutil.copytree(WEB / 'lib', root / 'lib')
39
(root / 'assets').mkdir()
40
shutil.copy(WEB / 'assets/favicon.svg', root / 'assets/favicon.svg')
41
(root / 'data').mkdir()
42
with socket.socket() as sock:
43
sock.bind(('127.0.0.1', 0))
44
port = sock.getsockname()[1]
45
base = f'http://127.0.0.1:{port}'
46
log_path = root / 'server.log'
47
log = log_path.open('w')
48
process = subprocess.Popen(
49
['php', '-d', 'opcache.enable=0', '-S', f'127.0.0.1:{port}', '-t', str(root), str(root / 'router.php')],
50
stdout=log, stderr=log, start_new_session=True,
51
)
52
53
class Client:
54
def __init__(self, token=None):
55
self.token = token
56
self.opener = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(http.cookiejar.CookieJar()))
57
self.csrf = None
58
59
def request(self, method, path, body=None, expected=200, csrf=True, extra_headers=None):
60
headers = {'Accept': 'application/json'}
61
data = None
62
if body is not None:
63
data = json.dumps(body).encode()
64
headers['Content-Type'] = 'application/json'
65
if self.token:
66
headers['Authorization'] = 'Bearer ' + self.token
67
elif method not in ('GET', 'HEAD') and csrf:
68
headers['X-CSRF-Token'] = self.csrf or ''
69
if extra_headers:
70
headers.update(extra_headers)
71
req = urllib.request.Request(base + '/api.php' + path, data=data, headers=headers, method=method)
72
try:
73
response = self.opener.open(req)
74
except urllib.error.HTTPError as error:
75
response = error
76
with response:
77
raw = response.read().decode()
78
payload = json.loads(raw)
79
self.last_headers = {key.lower(): value for key, value in response.headers.items()}
80
check(response.status == expected, f'{method} {path}: verwacht {expected}, kreeg {response.status} {payload}')
81
return payload
82
83
def me(self):
84
data = self.request('GET', '/me')
85
self.csrf = data['csrf']
86
return data
87
88
try:
89
for _ in range(100):
90
try:
91
urllib.request.urlopen(base + '/index.php').close()
92
break
93
except urllib.error.URLError:
94
time.sleep(0.05)
95
else:
96
raise RuntimeError(log_path.read_text()[-2000:])
97
98
config_path = root / 'data/config.php'
99
check(config_path.is_file(), 'Eerste pagina maakt config.php')
100
generated = config_path.read_text()
101
check(all(f"'{key}' => ''" in generated for key in ['base_url', 'client_id', 'client_secret']), 'Gegenereerde configvelden zijn leeg')
102
configured = generated.replace("'client_id' => ''", "'client_id' => 'fixture-client'") + '\n// Bewaar deze servercommentaar.\n'
103
config_path.write_text(configured)
104
105
anonymous = Client()
106
missing = anonymous.request('GET', '/me', expected=401, extra_headers={'Host': 'verhalenboek.test'})
107
check('geen Authorization-header' in missing['how_to_authenticate'] and missing['hint'] == missing['how_to_authenticate'] and 'docs.php' in missing['how_to_authenticate'], '401 zonder header legt authenticatie uit')
108
check(anonymous.last_headers.get('www-authenticate') == 'Bearer', '401 stuurt WWW-Authenticate: Bearer')
109
malformed = anonymous.request('GET', '/days/latest', expected=401, extra_headers={'Authorization': 'Basic abc', 'Host': 'verhalenboek.test'})
110
check('verkeerde formaat' in malformed['how_to_authenticate'] and 'docs.php' in malformed['hint'], 'Verkeerde Authorization-vorm krijgt een eigen uitleg')
111
short = anonymous.request('GET', '/days/latest', expected=401, extra_headers={'Authorization': 'Bearer vb_kort', 'Host': 'verhalenboek.test'})
112
check(short['error'].startswith('De API-sleutel heeft het verkeerde formaat') and 'verkeerde formaat' in short['how_to_authenticate'], 'Een te korte sleutel is het verkeerde formaat')
113
unknown = anonymous.request('GET', '/days/latest', expected=401, extra_headers={'Authorization': 'Bearer vb_' + 'ab' * 32})
114
check(unknown['error'] == 'Deze API-sleutel is onbekend.' and 'onbekend of ingetrokken' in unknown['how_to_authenticate'], 'Onbekende sleutel krijgt de afwijs-uitleg')
115
116
admin = Client()
117
me = admin.me()
118
check(me['user']['name'] == 'test_user_1' and me['user']['admin'] is True and me['local'] is True, 'Eerste lokale gebruiker is beheerder')
119
check('email' not in me['user'], 'Profiel bevat geen e-mail')
120
check(config_path.read_text() == configured, 'Bestaande configuratie blijft byte voor byte staan')
121
loaded = subprocess.check_output(
122
['php', '-r', 'require $argv[1]; echo json_encode(config());', str(root / 'lib/bootstrap.php')],
123
env={**os.environ, 'VERHALENBOEK_BASE_URL': 'https://example.test', 'VERHALENBOEK_CLIENT_ID': 'environment-client', 'VERHALENBOEK_CLIENT_SECRET': 'fixture-secret'},
124
text=True,
125
)
126
loaded_config = json.loads(loaded)
127
check(loaded_config['base_url'] == 'https://example.test' and loaded_config['client_id'] == 'fixture-client' and loaded_config['client_secret'] == 'fixture-secret', 'Lege velden gebruiken de omgeving; gevulde velden winnen')
128
check(__import__('re').fullmatch(r'[a-f0-9]{64}', loaded_config['key_secret']) is not None, 'key_secret blijft de gegenereerde serverwaarde')
129
130
reader = Client()
131
reader.me()
132
switched = reader.request('POST', '/session/switch', {'user': 'test_user_2'})
133
reader.csrf = switched['csrf']
134
check(reader.me()['user']['name'] == 'test_user_2' and reader.me()['user']['admin'] is False, 'Tweede gebruiker is alleen lezer')
135
check(admin.me()['user']['name'] == 'test_user_1', 'Sessies blijven onafhankelijk')
136
137
forbidden = reader.request('POST', '/days', {'date': '2026-05-01', 'title': 'Verboden', 'stories': stories()}, expected=403)
138
check('API-sleutel of als beheerder' in forbidden['how_to_authenticate'] and 'docs.php' in forbidden['hint'] and 'www-authenticate' not in reader.last_headers, '403 voor een lezer legt de sleutel uit, zonder WWW-Authenticate')
139
keys_forbidden = reader.request('GET', '/keys', expected=403)
140
check('ingelogde beheerder' in keys_forbidden['how_to_authenticate'] and 'docs.php' in keys_forbidden['hint'], 'Sleutels bekijken mag alleen de beheerder')
141
reader.request('POST', '/keys', {'name': 'nee'}, expected=403)
142
old = admin.csrf
143
admin.csrf = 'fout'
144
csrf_denied = admin.request('POST', '/keys', {'name': 'nee'}, expected=403)
145
check('how_to_authenticate' not in csrf_denied and csrf_denied['error'] == 'Ongeldige sessie. Laad de pagina opnieuw.', 'Een CSRF-fout blijft een kale 403')
146
admin.csrf = old
147
148
created = admin.request('POST', '/keys', {'name': 'Schrijver'}, expected=201)['key']
149
token = created['token']
150
check(token.startswith('vb_') and created['prefix'] == token[:11], 'Nieuwe sleutel toont het geheim')
151
listed = admin.request('GET', '/keys')['keys']
152
check(token not in json.dumps(listed) and listed[0]['prefix'] == created['prefix'] and 'token' not in listed[0], 'De lijst verbergt het geheim')
153
revealed = admin.request('GET', '/keys/' + str(created['id']))['key']
154
check(revealed['token'] == token and 'token_cipher' not in revealed, 'De beheerder kan de volledige sleutel opnieuw opvragen')
155
reader.request('GET', '/keys/' + str(created['id']), expected=403)
156
with sqlite3.connect(root / 'data/verhalenboek.sqlite') as db:
157
stored_hash, stored_cipher = db.execute('SELECT token_hash, token_cipher FROM api_keys WHERE id=?', (created['id'],)).fetchone()
158
check(stored_hash != token and len(stored_hash) == 64 and token not in stored_cipher and stored_cipher != '', 'De database bewaart een hash en cijfertekst, geen platte sleutel')
159
160
bearer = Client(token)
161
check(bearer.request('GET', '/days/latest', expected=404)['error'], 'Nog geen laatste datum')
162
check(bearer.request('GET', '/days/gaps') == {'first': None, 'latest': None, 'missing': [], 'incomplete': []}, 'Lege gaten')
163
bearer.request('POST', '/days', {'date': '2026-05-01', 'title': 'Mei', 'stories': stories()[:2]}, expected=422)
164
bearer.request('POST', '/days', {'date': '2026-05-01', 'title': 'Mei', 'stories': stories() + [{'title': 'Extra', 'paragraphs': ['Te veel']}]}, expected=422)
165
bearer.request('POST', '/days', {'date': '2026-02-31', 'title': 'Nee', 'stories': stories()}, expected=422)
166
bearer.request('POST', '/days', {'date': '2026-05-01', 'title': 'Mei', 'stories': [
167
{'title': 'Een', 'paragraphs': ['']},
168
{'title': 'Twee', 'paragraphs': ['Oké']},
169
{'title': 'Drie', 'paragraphs': ['Oké']},
170
]}, expected=422)
171
first = bearer.request('POST', '/days', {'date': '2026-05-01', 'title': 'De eerste bladzijde', 'stories': stories('Eerste')}, expected=201)
172
check(first['complete'] is True and first['storyCount'] == 3 and [s['position'] for s in first['stories']] == [1, 2, 3], 'Eén aanroep maakt een volledige dag')
173
check(first['stories'][0]['paragraphs'][1] == 'Tweede alinea met één accent.', 'Unicode blijft intact')
174
bearer.request('POST', '/days', {'date': '2026-05-01', 'title': 'Dubbel', 'stories': stories()}, expected=409)
175
bearer.request('POST', '/days', {'date': '2026-05-02', 'title': 'De regen op het dak', 'stories': stories('Regen')}, expected=201)
176
bearer.request('POST', '/days', {'date': '2026-05-04', 'title': 'Het licht in de keuken', 'stories': stories('Licht')}, expected=201)
177
check(bearer.request('GET', '/days/latest')['date'] == '2026-05-04', 'Laatste geschreven datum')
178
gaps = bearer.request('GET', '/days/gaps')
179
check(gaps['first'] == '2026-05-01' and gaps['latest'] == '2026-05-04' and gaps['missing'] == ['2026-05-03'] and gaps['incomplete'] == [], 'Ontbrekende dag tussen de eerste en de laatste')
180
181
middle = bearer.request('GET', '/days/2026-05-02')
182
check(middle['previous'] == '2026-05-01' and middle['next'] == '2026-05-04' and 'read' not in middle, 'Vorige en volgende dag, zonder leesstatus voor een sleutel')
183
kept = bearer.request('PUT', '/days/2026-05-02/stories/2', {'title': 'Nieuwe middag'})
184
check(kept['stories'][1]['title'] == 'Nieuwe middag' and kept['stories'][1]['paragraphs'] == ['Midden.'], 'Verhaal bewerken bewaart de alinea\'s')
185
broken = bearer.request('DELETE', '/days/2026-05-04/stories/2')
186
check(broken['complete'] is False and [s['position'] for s in broken['stories']] == [1, 3], 'Verwijderd verhaal laat een gat in de plekken')
187
latest = bearer.request('GET', '/days/latest')
188
check(latest['date'] == '2026-05-04' and latest['complete'] is False and latest['storyCount'] == 2, 'De laatste datum blijft, ook als de dag onvolledig is')
189
gaps = bearer.request('GET', '/days/gaps')
190
check(gaps['missing'] == ['2026-05-03'], 'Een onvolledige dag staat niet bij de ontbrekende datums')
191
incomplete = gaps['incomplete']
192
check(len(incomplete) == 1 and incomplete[0]['date'] == '2026-05-04' and incomplete[0]['missingPositions'] == [2] and incomplete[0]['storyCount'] == 2, 'Onvolledige dag meldt de ontbrekende plek')
193
repaired = bearer.request('POST', '/days/2026-05-04/stories', {'title': 'Terug', 'paragraphs': ['Weer drie.']}, expected=201)
194
check(repaired['complete'] is True and repaired['stories'][1]['position'] == 2, 'Het ontbrekende verhaal vult plek 2')
195
bearer.request('POST', '/days/2026-05-04/stories', {'title': 'Vier', 'paragraphs': ['Nee']}, expected=422)
196
bearer.request('DELETE', '/days/2026-05-02')
197
check(bearer.request('GET', '/days/latest')['date'] == '2026-05-04', 'Verwijderen van een middendag laat de laatste datum staan')
198
check('2026-05-02' in bearer.request('GET', '/days/gaps')['missing'], 'Een verwijderde dag wordt een gat')
199
bearer.request('POST', '/days/2026-05-02/read', expected=403)
200
bearer_keys = bearer.request('GET', '/keys', expected=403)
201
check('ingelogde beheerder' in bearer_keys['how_to_authenticate'] and token not in json.dumps(bearer_keys), 'Een sleutel mag andere sleutels niet uitlezen')
202
bearer.request('DELETE', '/days/2099-01-01', expected=404)
203
204
check(reader.request('GET', '/days/2026-05-01')['read'] is False, 'Openen via GET markeert de dag nog niet')
205
check(reader.request('POST', '/days/2026-05-01/read')['read'] is True, 'De lezer markeert de dag als gelezen')
206
check(reader.request('POST', '/days/2026-05-01/read')['read'] is True, 'Opnieuw gelezen blijft gelezen')
207
reader_days = reader.request('GET', '/days')['days']
208
admin_days = admin.request('GET', '/days')['days']
209
check(next(day for day in reader_days if day['date'] == '2026-05-01')['read'] is True, 'Overzicht van de lezer toont gelezen')
210
check(next(day for day in admin_days if day['date'] == '2026-05-01')['read'] is False, 'De andere gebruiker heeft die dag niet gelezen')
211
check(reader.request('DELETE', '/days/2026-05-01/read')['read'] is False, 'Handmatig ongelezen')
212
reader.request('DELETE', '/days/2026-05-04', expected=403)
213
reader.request('PUT', '/me/settings', {'theme': 'dark', 'font': 'rounded'})
214
check(reader.me()['user']['theme'] == 'dark' and reader.me()['user']['font'] == 'rounded', 'Instellingen blijven bewaard')
215
check(admin.me()['user']['theme'] == 'system' and admin.me()['user']['font'] == 'serif', 'Instellingen zijn per gebruiker')
216
reader.request('PUT', '/me/settings', {'theme': 'blauw', 'font': 'serif'}, expected=422)
217
export = reader.request('GET', '/me/export')
218
check(export['profile']['name'] == 'test_user_2' and 'email' not in export['profile'] and export['api_keys'] == [], 'Export bevat alleen de eigen gegevens')
219
check(all(item['date'] != '2026-05-01' or item['read_at'] for item in export['reads']) or export['reads'] == [], 'Een ongelezen dag staat niet als gelezen in de export')
220
check(export['reads'] == [], 'Na ongelezen zit de dag niet meer in de export')
221
222
admin.request('PUT', '/days/2026-05-01', {'title': 'Herziene titel'})
223
check(admin.request('GET', '/days/2026-05-01')['title'] == 'Herziene titel', 'Beheerder bewerkt een dag in de sessie')
224
admin.request('PUT', '/days/2026-05-01', {'stories': stories()[:1]}, expected=422)
225
revoked = admin.request('DELETE', '/keys/' + str(created['id']))['key']
226
check(revoked['revoked'] is not None and 'token' not in revoked, 'Sleutel intrekken toont het geheim niet')
227
still = admin.request('GET', '/keys/' + str(created['id']))['key']
228
check(still['token'] == token and still['revoked'] is not None, 'Een ingetrokken sleutel blijft zichtbaar voor de beheerder')
229
rejected = bearer.request('GET', '/days/latest', expected=401)
230
check(rejected['error'] == 'Deze API-sleutel is ingetrokken.' and 'onbekend of ingetrokken' in rejected['how_to_authenticate'] and bearer.last_headers.get('www-authenticate') == 'Bearer', 'Ingetrokken sleutel krijgt 401 met uitleg')
231
admin.request('GET', '/days/nope', expected=404)
232
admin.request('PUT', '/days/latest', {'title': 'Nee'}, expected=405)
233
234
for path in ['/data/config.php', '/data/verhalenboek.sqlite', '/lib/bootstrap.php', '/lib/Storybook.php']:
235
try:
236
urllib.request.urlopen(base + path)
237
check(False, path + ' moet afgeschermd zijn')
238
except urllib.error.HTTPError as error:
239
check(error.code == 403, path + ' geeft ' + str(error.code))
240
241
docs = urllib.request.urlopen(base + '/docs.php')
242
body = docs.read().decode()
243
check(docs.status == 200 and 'precies drie verhalen' in body and 'days/latest' in body and 'how_to_authenticate' in body and 'WWW-Authenticate' in body, 'API-documentatie legt authenticatie uit')
244
245
auth_bootstrap = root / 'lib/bootstrap.php'
246
auth_bootstrap.write_text(auth_bootstrap.read_text().replace(
247
" $ch=curl_init('https://auth.timfalken.com'.$path);",
248
" return match($path) {'/api/me'=>['user'=>['id'=>7,'username'=>'oauth_user','email'=>'hidden@example.com']],'/api/logout'=>['ok'=>true],'/api/session/extend'=>['expires_in'=>86400],default=>['access_token'=>'fixture-token','expires_in'=>86400]};\n $ch=curl_init('https://auth.timfalken.com'.$path);",
249
))
250
config_path.write_text(config_path.read_text().replace("'client_secret' => ''", "'client_secret' => 'fixture-secret'"))
251
252
class NoRedirect(urllib.request.HTTPRedirectHandler):
253
def redirect_request(self, req, fp, code, msg, headers, newurl):
254
return None
255
256
oauth = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(http.cookiejar.CookieJar()), NoRedirect())
257
258
def redirect(path):
259
try:
260
oauth.open(base + path)
261
raise AssertionError('redirect verwacht')
262
except urllib.error.HTTPError as error:
263
check(error.code == 302, 'OAuth redirect: ' + error.read().decode())
264
return error.headers['Location']
265
266
from urllib.parse import parse_qs, urlsplit
267
login = redirect('/auth.php')
268
oauth_state = parse_qs(urlsplit(login).query)['state'][0]
269
check('client_id=fixture-client' in login and 'redirect_uri=' in login and login.startswith('https://auth.timfalken.com/oauth/authorize?'), 'Login gaat naar de account-dienst')
270
callback = redirect('/callback.php?state=' + oauth_state + '&code=fixture')
271
check(urlsplit(callback).path == '/', 'OAuth komt terug op het boek')
272
with sqlite3.connect(root / 'data/verhalenboek.sqlite') as db:
273
row = db.execute("SELECT id, name, role FROM users WHERE id='auth:7'").fetchone()
274
columns = [name for _, name, *_ in db.execute('PRAGMA table_info(users)')]
275
check(row == ('auth:7', 'oauth_user', 'user'), 'OAuth-gebruiker gebruikt het numerieke id en wordt geen beheerder')
276
check('email' not in columns and 'hidden@example.com' not in json.dumps(row), 'E-mail wordt niet opgeslagen')
277
278
print(f'API: {checks} assertions passed.')
279
except Exception:
280
log.flush()
281
print(log_path.read_text()[-4000:])
282
raise
283
finally:
284
os.killpg(process.pid, signal.SIGTERM)
285
process.wait(timeout=5)
286
log.close()
@@ -0,0 +1,286 @@1
#!/usr/bin/env python32
"""Geïsoleerde API-tests. De echte database van de applicatie blijft onaangeroerd."""3
import json4
import os5
import signal6
import http.cookiejar7
import shutil8
import socket9
import sqlite310
import subprocess11
import tempfile12
import time13
import urllib.error14
import urllib.request15
from pathlib import Path16
17
WEB = Path(__file__).resolve().parents[1]18
ARTIFACTS = WEB / 'tests/artifacts'19
ARTIFACTS.mkdir(exist_ok=True)20
checks = 021
22
def check(value, label):23
global checks24
checks += 125
assert value, label26
27
def stories(prefix='Verhaal'):28
return [29
{'title': f'{prefix} een', 'paragraphs': ['Eerste alinea.', 'Tweede alinea met één accent.']},30
{'title': f'{prefix} twee', 'paragraphs': ['Midden.']},31
{'title': f'{prefix} drie', 'paragraphs': ['Slot.']},32
]33
34
with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:35
root = Path(tmp)36
for name in ['api.php', 'index.php', 'auth.php', 'callback.php', 'router.php', 'docs.php']:37
shutil.copy(WEB / name, root / name)38
shutil.copytree(WEB / 'lib', root / 'lib')39
(root / 'assets').mkdir()40
shutil.copy(WEB / 'assets/favicon.svg', root / 'assets/favicon.svg')41
(root / 'data').mkdir()42
with socket.socket() as sock:43
sock.bind(('127.0.0.1', 0))44
port = sock.getsockname()[1]45
base = f'http://127.0.0.1:{port}'46
log_path = root / 'server.log'47
log = log_path.open('w')48
process = subprocess.Popen(49
['php', '-d', 'opcache.enable=0', '-S', f'127.0.0.1:{port}', '-t', str(root), str(root / 'router.php')],50
stdout=log, stderr=log, start_new_session=True,51
)52
53
class Client:54
def __init__(self, token=None):55
self.token = token56
self.opener = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(http.cookiejar.CookieJar()))57
self.csrf = None58
59
def request(self, method, path, body=None, expected=200, csrf=True, extra_headers=None):60
headers = {'Accept': 'application/json'}61
data = None62
if body is not None:63
data = json.dumps(body).encode()64
headers['Content-Type'] = 'application/json'65
if self.token:66
headers['Authorization'] = 'Bearer ' + self.token67
elif method not in ('GET', 'HEAD') and csrf:68
headers['X-CSRF-Token'] = self.csrf or ''69
if extra_headers:70
headers.update(extra_headers)71
req = urllib.request.Request(base + '/api.php' + path, data=data, headers=headers, method=method)72
try:73
response = self.opener.open(req)74
except urllib.error.HTTPError as error:75
response = error76
with response:77
raw = response.read().decode()78
payload = json.loads(raw)79
self.last_headers = {key.lower(): value for key, value in response.headers.items()}80
check(response.status == expected, f'{method} {path}: verwacht {expected}, kreeg {response.status} {payload}')81
return payload82
83
def me(self):84
data = self.request('GET', '/me')85
self.csrf = data['csrf']86
return data87
88
try:89
for _ in range(100):90
try:91
urllib.request.urlopen(base + '/index.php').close()92
break93
except urllib.error.URLError:94
time.sleep(0.05)95
else:96
raise RuntimeError(log_path.read_text()[-2000:])97
98
config_path = root / 'data/config.php'99
check(config_path.is_file(), 'Eerste pagina maakt config.php')100
generated = config_path.read_text()101
check(all(f"'{key}' => ''" in generated for key in ['base_url', 'client_id', 'client_secret']), 'Gegenereerde configvelden zijn leeg')102
configured = generated.replace("'client_id' => ''", "'client_id' => 'fixture-client'") + '\n// Bewaar deze servercommentaar.\n'103
config_path.write_text(configured)104
105
anonymous = Client()106
missing = anonymous.request('GET', '/me', expected=401, extra_headers={'Host': 'verhalenboek.test'})107
check('geen Authorization-header' in missing['how_to_authenticate'] and missing['hint'] == missing['how_to_authenticate'] and 'docs.php' in missing['how_to_authenticate'], '401 zonder header legt authenticatie uit')108
check(anonymous.last_headers.get('www-authenticate') == 'Bearer', '401 stuurt WWW-Authenticate: Bearer')109
malformed = anonymous.request('GET', '/days/latest', expected=401, extra_headers={'Authorization': 'Basic abc', 'Host': 'verhalenboek.test'})110
check('verkeerde formaat' in malformed['how_to_authenticate'] and 'docs.php' in malformed['hint'], 'Verkeerde Authorization-vorm krijgt een eigen uitleg')111
short = anonymous.request('GET', '/days/latest', expected=401, extra_headers={'Authorization': 'Bearer vb_kort', 'Host': 'verhalenboek.test'})112
check(short['error'].startswith('De API-sleutel heeft het verkeerde formaat') and 'verkeerde formaat' in short['how_to_authenticate'], 'Een te korte sleutel is het verkeerde formaat')113
unknown = anonymous.request('GET', '/days/latest', expected=401, extra_headers={'Authorization': 'Bearer vb_' + 'ab' * 32})114
check(unknown['error'] == 'Deze API-sleutel is onbekend.' and 'onbekend of ingetrokken' in unknown['how_to_authenticate'], 'Onbekende sleutel krijgt de afwijs-uitleg')115
116
admin = Client()117
me = admin.me()118
check(me['user']['name'] == 'test_user_1' and me['user']['admin'] is True and me['local'] is True, 'Eerste lokale gebruiker is beheerder')119
check('email' not in me['user'], 'Profiel bevat geen e-mail')120
check(config_path.read_text() == configured, 'Bestaande configuratie blijft byte voor byte staan')121
loaded = subprocess.check_output(122
['php', '-r', 'require $argv[1]; echo json_encode(config());', str(root / 'lib/bootstrap.php')],123
env={**os.environ, 'VERHALENBOEK_BASE_URL': 'https://example.test', 'VERHALENBOEK_CLIENT_ID': 'environment-client', 'VERHALENBOEK_CLIENT_SECRET': 'fixture-secret'},124
text=True,125
)126
loaded_config = json.loads(loaded)127
check(loaded_config['base_url'] == 'https://example.test' and loaded_config['client_id'] == 'fixture-client' and loaded_config['client_secret'] == 'fixture-secret', 'Lege velden gebruiken de omgeving; gevulde velden winnen')128
check(__import__('re').fullmatch(r'[a-f0-9]{64}', loaded_config['key_secret']) is not None, 'key_secret blijft de gegenereerde serverwaarde')129
130
reader = Client()131
reader.me()132
switched = reader.request('POST', '/session/switch', {'user': 'test_user_2'})133
reader.csrf = switched['csrf']134
check(reader.me()['user']['name'] == 'test_user_2' and reader.me()['user']['admin'] is False, 'Tweede gebruiker is alleen lezer')135
check(admin.me()['user']['name'] == 'test_user_1', 'Sessies blijven onafhankelijk')136
137
forbidden = reader.request('POST', '/days', {'date': '2026-05-01', 'title': 'Verboden', 'stories': stories()}, expected=403)138
check('API-sleutel of als beheerder' in forbidden['how_to_authenticate'] and 'docs.php' in forbidden['hint'] and 'www-authenticate' not in reader.last_headers, '403 voor een lezer legt de sleutel uit, zonder WWW-Authenticate')139
keys_forbidden = reader.request('GET', '/keys', expected=403)140
check('ingelogde beheerder' in keys_forbidden['how_to_authenticate'] and 'docs.php' in keys_forbidden['hint'], 'Sleutels bekijken mag alleen de beheerder')141
reader.request('POST', '/keys', {'name': 'nee'}, expected=403)142
old = admin.csrf143
admin.csrf = 'fout'144
csrf_denied = admin.request('POST', '/keys', {'name': 'nee'}, expected=403)145
check('how_to_authenticate' not in csrf_denied and csrf_denied['error'] == 'Ongeldige sessie. Laad de pagina opnieuw.', 'Een CSRF-fout blijft een kale 403')146
admin.csrf = old147
148
created = admin.request('POST', '/keys', {'name': 'Schrijver'}, expected=201)['key']149
token = created['token']150
check(token.startswith('vb_') and created['prefix'] == token[:11], 'Nieuwe sleutel toont het geheim')151
listed = admin.request('GET', '/keys')['keys']152
check(token not in json.dumps(listed) and listed[0]['prefix'] == created['prefix'] and 'token' not in listed[0], 'De lijst verbergt het geheim')153
revealed = admin.request('GET', '/keys/' + str(created['id']))['key']154
check(revealed['token'] == token and 'token_cipher' not in revealed, 'De beheerder kan de volledige sleutel opnieuw opvragen')155
reader.request('GET', '/keys/' + str(created['id']), expected=403)156
with sqlite3.connect(root / 'data/verhalenboek.sqlite') as db:157
stored_hash, stored_cipher = db.execute('SELECT token_hash, token_cipher FROM api_keys WHERE id=?', (created['id'],)).fetchone()158
check(stored_hash != token and len(stored_hash) == 64 and token not in stored_cipher and stored_cipher != '', 'De database bewaart een hash en cijfertekst, geen platte sleutel')159
160
bearer = Client(token)161
check(bearer.request('GET', '/days/latest', expected=404)['error'], 'Nog geen laatste datum')162
check(bearer.request('GET', '/days/gaps') == {'first': None, 'latest': None, 'missing': [], 'incomplete': []}, 'Lege gaten')163
bearer.request('POST', '/days', {'date': '2026-05-01', 'title': 'Mei', 'stories': stories()[:2]}, expected=422)164
bearer.request('POST', '/days', {'date': '2026-05-01', 'title': 'Mei', 'stories': stories() + [{'title': 'Extra', 'paragraphs': ['Te veel']}]}, expected=422)165
bearer.request('POST', '/days', {'date': '2026-02-31', 'title': 'Nee', 'stories': stories()}, expected=422)166
bearer.request('POST', '/days', {'date': '2026-05-01', 'title': 'Mei', 'stories': [167
{'title': 'Een', 'paragraphs': ['']},168
{'title': 'Twee', 'paragraphs': ['Oké']},169
{'title': 'Drie', 'paragraphs': ['Oké']},170
]}, expected=422)171
first = bearer.request('POST', '/days', {'date': '2026-05-01', 'title': 'De eerste bladzijde', 'stories': stories('Eerste')}, expected=201)172
check(first['complete'] is True and first['storyCount'] == 3 and [s['position'] for s in first['stories']] == [1, 2, 3], 'Eén aanroep maakt een volledige dag')173
check(first['stories'][0]['paragraphs'][1] == 'Tweede alinea met één accent.', 'Unicode blijft intact')174
bearer.request('POST', '/days', {'date': '2026-05-01', 'title': 'Dubbel', 'stories': stories()}, expected=409)175
bearer.request('POST', '/days', {'date': '2026-05-02', 'title': 'De regen op het dak', 'stories': stories('Regen')}, expected=201)176
bearer.request('POST', '/days', {'date': '2026-05-04', 'title': 'Het licht in de keuken', 'stories': stories('Licht')}, expected=201)177
check(bearer.request('GET', '/days/latest')['date'] == '2026-05-04', 'Laatste geschreven datum')178
gaps = bearer.request('GET', '/days/gaps')179
check(gaps['first'] == '2026-05-01' and gaps['latest'] == '2026-05-04' and gaps['missing'] == ['2026-05-03'] and gaps['incomplete'] == [], 'Ontbrekende dag tussen de eerste en de laatste')180
181
middle = bearer.request('GET', '/days/2026-05-02')182
check(middle['previous'] == '2026-05-01' and middle['next'] == '2026-05-04' and 'read' not in middle, 'Vorige en volgende dag, zonder leesstatus voor een sleutel')183
kept = bearer.request('PUT', '/days/2026-05-02/stories/2', {'title': 'Nieuwe middag'})184
check(kept['stories'][1]['title'] == 'Nieuwe middag' and kept['stories'][1]['paragraphs'] == ['Midden.'], 'Verhaal bewerken bewaart de alinea\'s')185
broken = bearer.request('DELETE', '/days/2026-05-04/stories/2')186
check(broken['complete'] is False and [s['position'] for s in broken['stories']] == [1, 3], 'Verwijderd verhaal laat een gat in de plekken')187
latest = bearer.request('GET', '/days/latest')188
check(latest['date'] == '2026-05-04' and latest['complete'] is False and latest['storyCount'] == 2, 'De laatste datum blijft, ook als de dag onvolledig is')189
gaps = bearer.request('GET', '/days/gaps')190
check(gaps['missing'] == ['2026-05-03'], 'Een onvolledige dag staat niet bij de ontbrekende datums')191
incomplete = gaps['incomplete']192
check(len(incomplete) == 1 and incomplete[0]['date'] == '2026-05-04' and incomplete[0]['missingPositions'] == [2] and incomplete[0]['storyCount'] == 2, 'Onvolledige dag meldt de ontbrekende plek')193
repaired = bearer.request('POST', '/days/2026-05-04/stories', {'title': 'Terug', 'paragraphs': ['Weer drie.']}, expected=201)194
check(repaired['complete'] is True and repaired['stories'][1]['position'] == 2, 'Het ontbrekende verhaal vult plek 2')195
bearer.request('POST', '/days/2026-05-04/stories', {'title': 'Vier', 'paragraphs': ['Nee']}, expected=422)196
bearer.request('DELETE', '/days/2026-05-02')197
check(bearer.request('GET', '/days/latest')['date'] == '2026-05-04', 'Verwijderen van een middendag laat de laatste datum staan')198
check('2026-05-02' in bearer.request('GET', '/days/gaps')['missing'], 'Een verwijderde dag wordt een gat')199
bearer.request('POST', '/days/2026-05-02/read', expected=403)200
bearer_keys = bearer.request('GET', '/keys', expected=403)201
check('ingelogde beheerder' in bearer_keys['how_to_authenticate'] and token not in json.dumps(bearer_keys), 'Een sleutel mag andere sleutels niet uitlezen')202
bearer.request('DELETE', '/days/2099-01-01', expected=404)203
204
check(reader.request('GET', '/days/2026-05-01')['read'] is False, 'Openen via GET markeert de dag nog niet')205
check(reader.request('POST', '/days/2026-05-01/read')['read'] is True, 'De lezer markeert de dag als gelezen')206
check(reader.request('POST', '/days/2026-05-01/read')['read'] is True, 'Opnieuw gelezen blijft gelezen')207
reader_days = reader.request('GET', '/days')['days']208
admin_days = admin.request('GET', '/days')['days']209
check(next(day for day in reader_days if day['date'] == '2026-05-01')['read'] is True, 'Overzicht van de lezer toont gelezen')210
check(next(day for day in admin_days if day['date'] == '2026-05-01')['read'] is False, 'De andere gebruiker heeft die dag niet gelezen')211
check(reader.request('DELETE', '/days/2026-05-01/read')['read'] is False, 'Handmatig ongelezen')212
reader.request('DELETE', '/days/2026-05-04', expected=403)213
reader.request('PUT', '/me/settings', {'theme': 'dark', 'font': 'rounded'})214
check(reader.me()['user']['theme'] == 'dark' and reader.me()['user']['font'] == 'rounded', 'Instellingen blijven bewaard')215
check(admin.me()['user']['theme'] == 'system' and admin.me()['user']['font'] == 'serif', 'Instellingen zijn per gebruiker')216
reader.request('PUT', '/me/settings', {'theme': 'blauw', 'font': 'serif'}, expected=422)217
export = reader.request('GET', '/me/export')218
check(export['profile']['name'] == 'test_user_2' and 'email' not in export['profile'] and export['api_keys'] == [], 'Export bevat alleen de eigen gegevens')219
check(all(item['date'] != '2026-05-01' or item['read_at'] for item in export['reads']) or export['reads'] == [], 'Een ongelezen dag staat niet als gelezen in de export')220
check(export['reads'] == [], 'Na ongelezen zit de dag niet meer in de export')221
222
admin.request('PUT', '/days/2026-05-01', {'title': 'Herziene titel'})223
check(admin.request('GET', '/days/2026-05-01')['title'] == 'Herziene titel', 'Beheerder bewerkt een dag in de sessie')224
admin.request('PUT', '/days/2026-05-01', {'stories': stories()[:1]}, expected=422)225
revoked = admin.request('DELETE', '/keys/' + str(created['id']))['key']226
check(revoked['revoked'] is not None and 'token' not in revoked, 'Sleutel intrekken toont het geheim niet')227
still = admin.request('GET', '/keys/' + str(created['id']))['key']228
check(still['token'] == token and still['revoked'] is not None, 'Een ingetrokken sleutel blijft zichtbaar voor de beheerder')229
rejected = bearer.request('GET', '/days/latest', expected=401)230
check(rejected['error'] == 'Deze API-sleutel is ingetrokken.' and 'onbekend of ingetrokken' in rejected['how_to_authenticate'] and bearer.last_headers.get('www-authenticate') == 'Bearer', 'Ingetrokken sleutel krijgt 401 met uitleg')231
admin.request('GET', '/days/nope', expected=404)232
admin.request('PUT', '/days/latest', {'title': 'Nee'}, expected=405)233
234
for path in ['/data/config.php', '/data/verhalenboek.sqlite', '/lib/bootstrap.php', '/lib/Storybook.php']:235
try:236
urllib.request.urlopen(base + path)237
check(False, path + ' moet afgeschermd zijn')238
except urllib.error.HTTPError as error:239
check(error.code == 403, path + ' geeft ' + str(error.code))240
241
docs = urllib.request.urlopen(base + '/docs.php')242
body = docs.read().decode()243
check(docs.status == 200 and 'precies drie verhalen' in body and 'days/latest' in body and 'how_to_authenticate' in body and 'WWW-Authenticate' in body, 'API-documentatie legt authenticatie uit')244
245
auth_bootstrap = root / 'lib/bootstrap.php'246
auth_bootstrap.write_text(auth_bootstrap.read_text().replace(247
" $ch=curl_init('https://auth.timfalken.com'.$path);",248
" return match($path) {'/api/me'=>['user'=>['id'=>7,'username'=>'oauth_user','email'=>'hidden@example.com']],'/api/logout'=>['ok'=>true],'/api/session/extend'=>['expires_in'=>86400],default=>['access_token'=>'fixture-token','expires_in'=>86400]};\n $ch=curl_init('https://auth.timfalken.com'.$path);",249
))250
config_path.write_text(config_path.read_text().replace("'client_secret' => ''", "'client_secret' => 'fixture-secret'"))251
252
class NoRedirect(urllib.request.HTTPRedirectHandler):253
def redirect_request(self, req, fp, code, msg, headers, newurl):254
return None255
256
oauth = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(http.cookiejar.CookieJar()), NoRedirect())257
258
def redirect(path):259
try:260
oauth.open(base + path)261
raise AssertionError('redirect verwacht')262
except urllib.error.HTTPError as error:263
check(error.code == 302, 'OAuth redirect: ' + error.read().decode())264
return error.headers['Location']265
266
from urllib.parse import parse_qs, urlsplit267
login = redirect('/auth.php')268
oauth_state = parse_qs(urlsplit(login).query)['state'][0]269
check('client_id=fixture-client' in login and 'redirect_uri=' in login and login.startswith('https://auth.timfalken.com/oauth/authorize?'), 'Login gaat naar de account-dienst')270
callback = redirect('/callback.php?state=' + oauth_state + '&code=fixture')271
check(urlsplit(callback).path == '/', 'OAuth komt terug op het boek')272
with sqlite3.connect(root / 'data/verhalenboek.sqlite') as db:273
row = db.execute("SELECT id, name, role FROM users WHERE id='auth:7'").fetchone()274
columns = [name for _, name, *_ in db.execute('PRAGMA table_info(users)')]275
check(row == ('auth:7', 'oauth_user', 'user'), 'OAuth-gebruiker gebruikt het numerieke id en wordt geen beheerder')276
check('email' not in columns and 'hidden@example.com' not in json.dumps(row), 'E-mail wordt niet opgeslagen')277
278
print(f'API: {checks} assertions passed.')279
except Exception:280
log.flush()281
print(log_path.read_text()[-4000:])282
raise283
finally:284
os.killpg(process.pid, signal.SIGTERM)285
process.wait(timeout=5)286
log.close()@@ -0,0 +1,55 @@
1
#!/usr/bin/env python3
2
"""Eerste start en een tweede start bewaren bestaande dagen en configuratie."""
3
from pathlib import Path
4
import shutil
5
import sqlite3
6
import subprocess
7
import tempfile
8
9
WEB = Path(__file__).resolve().parents[1]
10
ARTIFACTS = WEB / 'tests/artifacts'
11
ARTIFACTS.mkdir(exist_ok=True)
12
with tempfile.TemporaryDirectory(prefix='startup-', dir=ARTIFACTS) as tmp:
13
root = Path(tmp)
14
shutil.copytree(WEB / 'lib', root / 'lib')
15
(root / 'data').mkdir()
16
17
def startup():
18
result = subprocess.run(
19
['php', '-r', 'require $argv[1]; db();', str(root / 'lib/bootstrap.php')],
20
capture_output=True, text=True, check=True,
21
)
22
assert not result.stderr, result.stderr
23
log = root / 'data/php-errors.log'
24
assert not log.exists() or not log.read_text(), 'Startup emitted PHP errors'
25
26
startup()
27
config = root / 'data/config.php'
28
assert config.is_file(), 'Eerste start maakt config.php'
29
original = config.read_text()
30
assert all(f"'{key}' => ''" in original for key in ['base_url', 'client_id', 'client_secret'])
31
assert __import__('re').search(r"'key_secret' => '[a-f0-9]{64}'", original), original
32
config.write_text(original.replace("'client_id' => ''", "'client_id' => 'projects.timfalken.com'") + '\n// servercommentaar\n')
33
marked = config.read_text()
34
con = sqlite3.connect(root / 'data/verhalenboek.sqlite')
35
con.execute("INSERT INTO users (id, name, role, theme, font, created) VALUES ('auth:1','tim','admin','system','serif',1)")
36
con.execute("INSERT INTO days (date, title, created, updated) VALUES ('2026-01-01','Bewaard',1,1)")
37
con.execute("INSERT INTO stories (day_id, position, title, created, updated) VALUES (1,1,'Een',1,1)")
38
con.execute("INSERT INTO paragraphs (story_id, position, body) VALUES (1,1,'Blijft staan.')")
39
con.commit()
40
startup()
41
assert config.read_text() == marked, 'Bestaande config.php blijft byte voor byte staan'
42
row = con.execute('SELECT date, title FROM days').fetchone()
43
assert row == ('2026-01-01', 'Bewaard'), row
44
assert con.execute('SELECT body FROM paragraphs').fetchone()[0] == 'Blijft staan.'
45
assert 'email' not in [name for _, name, *_ in con.execute('PRAGMA table_info(users)')]
46
con.close()
47
import re
48
stripped = re.sub(r"\n 'key_secret' => '[a-f0-9]{64}',", '', marked, count=1)
49
assert "'key_secret' =>" not in stripped
50
config.write_text(stripped)
51
startup()
52
restored = config.read_text()
53
assert 'servercommentaar' in restored and "'client_id' => 'projects.timfalken.com'" in restored
54
assert re.search(r"'key_secret' => '[a-f0-9]{64}'", restored), restored
55
print('Startup: fresh database, preserved day and preserved config passed.')
@@ -0,0 +1,55 @@1
#!/usr/bin/env python32
"""Eerste start en een tweede start bewaren bestaande dagen en configuratie."""3
from pathlib import Path4
import shutil5
import sqlite36
import subprocess7
import tempfile8
9
WEB = Path(__file__).resolve().parents[1]10
ARTIFACTS = WEB / 'tests/artifacts'11
ARTIFACTS.mkdir(exist_ok=True)12
with tempfile.TemporaryDirectory(prefix='startup-', dir=ARTIFACTS) as tmp:13
root = Path(tmp)14
shutil.copytree(WEB / 'lib', root / 'lib')15
(root / 'data').mkdir()16
17
def startup():18
result = subprocess.run(19
['php', '-r', 'require $argv[1]; db();', str(root / 'lib/bootstrap.php')],20
capture_output=True, text=True, check=True,21
)22
assert not result.stderr, result.stderr23
log = root / 'data/php-errors.log'24
assert not log.exists() or not log.read_text(), 'Startup emitted PHP errors'25
26
startup()27
config = root / 'data/config.php'28
assert config.is_file(), 'Eerste start maakt config.php'29
original = config.read_text()30
assert all(f"'{key}' => ''" in original for key in ['base_url', 'client_id', 'client_secret'])31
assert __import__('re').search(r"'key_secret' => '[a-f0-9]{64}'", original), original32
config.write_text(original.replace("'client_id' => ''", "'client_id' => 'projects.timfalken.com'") + '\n// servercommentaar\n')33
marked = config.read_text()34
con = sqlite3.connect(root / 'data/verhalenboek.sqlite')35
con.execute("INSERT INTO users (id, name, role, theme, font, created) VALUES ('auth:1','tim','admin','system','serif',1)")36
con.execute("INSERT INTO days (date, title, created, updated) VALUES ('2026-01-01','Bewaard',1,1)")37
con.execute("INSERT INTO stories (day_id, position, title, created, updated) VALUES (1,1,'Een',1,1)")38
con.execute("INSERT INTO paragraphs (story_id, position, body) VALUES (1,1,'Blijft staan.')")39
con.commit()40
startup()41
assert config.read_text() == marked, 'Bestaande config.php blijft byte voor byte staan'42
row = con.execute('SELECT date, title FROM days').fetchone()43
assert row == ('2026-01-01', 'Bewaard'), row44
assert con.execute('SELECT body FROM paragraphs').fetchone()[0] == 'Blijft staan.'45
assert 'email' not in [name for _, name, *_ in con.execute('PRAGMA table_info(users)')]46
con.close()47
import re48
stripped = re.sub(r"\n 'key_secret' => '[a-f0-9]{64}',", '', marked, count=1)49
assert "'key_secret' =>" not in stripped50
config.write_text(stripped)51
startup()52
restored = config.read_text()53
assert 'servercommentaar' in restored and "'client_id' => 'projects.timfalken.com'" in restored54
assert re.search(r"'key_secret' => '[a-f0-9]{64}'", restored), restored55
print('Startup: fresh database, preserved day and preserved config passed.')@@ -0,0 +1,139 @@
1
<?php
2
declare(strict_types=1);
3
$root = sys_get_temp_dir().'/verhalenboek-'.bin2hex(random_bytes(4));
4
mkdir($root, 0700, true);
5
putenv('VERHALENBOEK_DATA_DIR='.$root);
6
$_SERVER['HTTP_HOST'] = 'cli.test';
7
$_SERVER['REMOTE_ADDR'] = '127.0.0.1';
8
$_SERVER['SCRIPT_NAME'] = '/index.php';
9
require dirname(__DIR__).'/lib/bootstrap.php';
10
11
$checks = 0;
12
function check(bool $ok, string $label): void {
13
global $checks;
14
$checks++;
15
if (!$ok) throw new RuntimeException($label);
16
}
17
function rejects(callable $fn, int $status, string $label): void {
18
try {
19
$fn();
20
} catch (AppException $e) {
21
check($e->status === $status, $label.' gaf '.$e->status.' in plaats van '.$status);
22
return;
23
}
24
check(false, $label);
25
}
26
function three(string $prefix = 'Verhaal'): array {
27
return [
28
['title' => $prefix.' een', 'paragraphs' => ['Eerste alinea.', 'Tweede alinea.']],
29
['title' => $prefix.' twee', 'paragraphs' => ['Midden.']],
30
['title' => $prefix.' drie', 'paragraphs' => ['Slot.']],
31
];
32
}
33
34
$columns = array_column(query('PRAGMA table_info(users)')->fetchAll(), 'name');
35
check(!in_array('email', $columns, true), 'Gebruikers hebben geen e-mailkolom');
36
[$id, $name] = authIdentity(['id' => 9, 'username' => 'tim', 'email' => 'verborgen@example.com']);
37
check($id === 'auth:9' && $name === 'tim', 'Identiteit gebruikt id en gebruikersnaam, niet e-mail');
38
try { authIdentity(['username' => 'tim', 'email' => 'a@b.c']); check(false, 'Account zonder id moet falen'); }
39
catch (RuntimeException) { check(true, 'Account zonder id moet falen'); }
40
41
query('DELETE FROM reads');
42
query('DELETE FROM api_keys');
43
query('DELETE FROM users');
44
loginUser('auth:1', 'tim');
45
check(publicUser('auth:1')['role'] === 'admin' && publicUser('auth:1')['admin'] === true, 'Eerste gebruiker is beheerder');
46
loginUser('auth:2', 'sam');
47
check(publicUser('auth:2')['role'] === 'user' && publicUser('auth:2')['admin'] === false, 'Volgende gebruiker is lezer');
48
loginUser('auth:1', 'tim');
49
check(publicUser('auth:1')['role'] === 'admin', 'Opnieuw inloggen behoudt de rol');
50
check(publicUser('auth:1')['theme'] === 'system' && publicUser('auth:1')['font'] === 'serif', 'Standaard thema volgt het systeem, lettertype is serif');
51
52
rejects(fn() => latestWritten(), 404, 'Nog geen laatste datum');
53
check(dayGaps() === ['first' => null, 'latest' => null, 'missing' => [], 'incomplete' => []], 'Lege gaten');
54
rejects(fn() => createDay('2026-02-31', 'Nee', three()), 422, 'Onbestaande datum');
55
rejects(fn() => createDay('2026-05-01', ' ', three()), 422, 'Lege dagtitel');
56
rejects(fn() => createDay('2026-05-01', 'Dag', array_slice(three(), 0, 2)), 422, 'Twee verhalen is geen dag');
57
rejects(fn() => createDay('2026-05-01', 'Dag', array_merge(three(), [['title' => 'Extra', 'paragraphs' => ['Te veel']]])), 422, 'Vier verhalen is geen dag');
58
rejects(fn() => createDay('2026-05-01', 'Dag', [
59
['title' => 'Een', 'paragraphs' => ['']],
60
['title' => 'Twee', 'paragraphs' => ['Oké']],
61
['title' => 'Drie', 'paragraphs' => ['Oké']],
62
]), 422, 'Lege alinea');
63
rejects(fn() => createDay('2026-05-01', str_repeat('a', 201), three()), 422, 'Te lange titel');
64
65
$day = createDay('2024-02-28', 'Schrikkeldag', three('Schrikkel'));
66
check($day['complete'] === true && $day['storyCount'] === 3 && $day['stories'][0]['position'] === 1 && $day['stories'][2]['position'] === 3, 'Drie verhalen in volgorde');
67
check($day['stories'][0]['paragraphs'] === ['Eerste alinea.', 'Tweede alinea.'], 'Alinea\'s blijven in volgorde');
68
createDay('2024-03-01', 'Maart', three('Maart'));
69
$gaps = dayGaps();
70
check($gaps['missing'] === ['2024-02-29'], 'Schrikkeldag telt als ontbrekende datum');
71
check($gaps['incomplete'] === [], 'Volledige dagen zijn geen gaten');
72
check(latestWritten()['date'] === '2024-03-01' && latestWritten()['complete'] === true, 'Laatste geschreven datum');
73
74
$updated = updateStory('2024-02-28', 2, ['title' => 'Nieuwe middag']);
75
check($updated['stories'][1]['title'] === 'Nieuwe middag' && $updated['stories'][1]['paragraphs'] === ['Midden.'], 'Titel wijzigen bewaart de alinea\'s');
76
$replaced = updateStory('2024-02-28', 2, ['paragraphs' => ['Alleen deze.']]);
77
check($replaced['stories'][1]['title'] === 'Nieuwe middag' && $replaced['stories'][1]['paragraphs'] === ['Alleen deze.'], 'Alinea\'s vervangen bewaart de titel');
78
79
$afterDelete = deleteStory('2024-02-28', 2);
80
check(array_column($afterDelete['stories'], 'position') === [1, 3], 'Verwijderen hernummert de plekken niet');
81
check($afterDelete['complete'] === false, 'Minder dan drie verhalen is onvolledig');
82
$gaps = dayGaps();
83
check($gaps['incomplete'][0]['date'] === '2024-02-28' && $gaps['incomplete'][0]['missingPositions'] === [2], 'Onvolledige dag staat apart van ontbrekende datums');
84
check(in_array('2024-02-29', $gaps['missing'], true) && !in_array('2024-02-28', $gaps['missing'], true), 'Een onvolledige dag is niet ook missing');
85
check(latestWritten()['date'] === '2024-03-01', 'Een onvolledige eerdere dag verandert de laatste datum niet');
86
87
$filled = addStory('2024-02-28', ['title' => 'Terug', 'paragraphs' => ['Weer compleet.']]);
88
check($filled['stories'][1]['position'] === 2 && $filled['complete'] === true, 'Een nieuw verhaal vult de eerste vrije plek');
89
rejects(fn() => addStory('2024-02-28', ['title' => 'Vier', 'paragraphs' => ['Nee']]), 422, 'Geen vierde verhaal');
90
91
deleteDay('2024-03-01');
92
check(latestWritten()['date'] === '2024-02-28', 'Verwijderde laatste dag schuift de laatste datum terug');
93
check(dayGaps()['missing'] === [] && dayGaps()['incomplete'] === [], 'Na het verwijderen van de laatste dag vallen de gaten weg');
94
deleteDay('2024-02-28');
95
96
createDay('2026-05-01', 'Mei', three());
97
createDay('2026-05-03', 'Later', three());
98
check(dayGaps()['missing'] === ['2026-05-02'], 'Een verwijderde of nooit geschreven dag ertussen is een gat');
99
$read = markRead('auth:2', '2026-05-01', true);
100
check($read['read'] === true, 'Lezer markeert een dag als gelezen');
101
check(loadDay('2026-05-01', 'auth:1')['read'] === false, 'Gelezen-status is per gebruiker');
102
check(!array_key_exists('read', loadDay('2026-05-01', null)), 'Zonder lezer geen leesstatus');
103
check(markRead('auth:2', '2026-05-01', false)['read'] === false, 'Handmatig ongelezen');
104
$listed = listDays('auth:2');
105
check($listed[0]['date'] === '2026-05-01' && $listed[0]['read'] === false && $listed[1]['date'] === '2026-05-03', 'Overzicht staat op datum en toont leesstatus');
106
107
$settings = saveSettings('auth:2', ['theme' => 'dark', 'font' => 'rounded']);
108
check($settings['theme'] === 'dark' && $settings['font'] === 'rounded', 'Instellingen worden bewaard');
109
check(publicUser('auth:1')['theme'] === 'system', 'Instellingen blijven bij de gebruiker');
110
rejects(fn() => saveSettings('auth:2', ['theme' => 'blauw', 'font' => 'serif']), 422, 'Onbekend thema');
111
112
$key = createApiKey('auth:1', 'Schrijver');
113
check(isset($key['token']) && preg_match('/^vb_[a-f0-9]{64}$/', $key['token']) && $key['prefix'] === substr($key['token'], 0, 11), 'Sleutel wordt volledig teruggegeven');
114
$stored = query('SELECT token_hash, token_prefix, token_cipher FROM api_keys WHERE id=?', [$key['id']])->fetch();
115
check($stored['token_hash'] === hash('sha256', $key['token']) && !str_contains($stored['token_cipher'], $key['token']), 'De database bewaart een hash en een versleutelde sleutel');
116
check(revealApiKey($key['id'])['token'] === $key['token'], 'Een beheerder kan de sleutel opnieuw lezen');
117
check(!str_contains(json_encode(listApiKeys(), JSON_THROW_ON_ERROR), $key['token']), 'De lijst toont de sleutel niet');
118
$actor = actorFromToken($key['token']);
119
check($actor['kind'] === 'token' && $actor['userId'] === 'auth:1', 'Bearer-sleutel hoort bij de beheerder');
120
try { actorFromToken('vb_kort'); check(false, 'Verkeerd formaat'); }
121
catch (AppException $e) { check($e->status === 401 && $e->auth === 'format', 'Verkeerd formaat is een 401'); }
122
try { actorFromToken('vb_'.str_repeat('ab', 32)); check(false, 'Onbekende sleutel'); }
123
catch (AppException $e) { check($e->status === 401 && $e->auth === 'rejected', 'Onbekende sleutel is een 401'); }
124
revokeApiKey($key['id']);
125
check(revealApiKey($key['id'])['token'] === $key['token'], 'Ook een ingetrokken sleutel blijft toonbaar');
126
try { actorFromToken($key['token']); check(false, 'Ingetrokken sleutel'); }
127
catch (AppException $e) { check($e->status === 401 && $e->auth === 'rejected', 'Ingetrokken sleutel werkt niet'); }
128
$export = exportUser('auth:1');
129
check(!isset($export['profile']['email']) && !str_contains(json_encode($export, JSON_THROW_ON_ERROR), $key['token']), 'Export bevat geen e-mail en geen geheime sleutel');
130
check($export['api_keys'][0]['prefix'] === $key['prefix'] && $export['api_keys'][0]['revoked'] !== null, 'Export toont ingetrokken sleutels zonder geheim');
131
$secret = config()['key_secret'] ?? '';
132
check(is_string($secret) && preg_match('/^[a-f0-9]{64}$/', $secret) === 1, 'key_secret wordt automatisch aangemaakt');
133
file_put_contents($root.'/config.php', str_replace("'base_url' => ''", "'base_url' => 'https://projects.timfalken.com/verhaaltjesboek'", (string)file_get_contents($root.'/config.php')));
134
check(str_contains(authHint('missing'), 'geen Authorization-header') && str_contains(authHint('missing'), 'https://projects.timfalken.com/verhaaltjesboek/docs.php'), 'Ontbrekende header legt uit waar de sleutel vandaan komt');
135
check(str_contains(authHint('format'), 'verkeerde formaat') && str_contains(authHint('rejected'), 'onbekend of ingetrokken') && str_contains(authHint('writer'), 'API-sleutel of als beheerder'), 'De uitleg onderscheidt formaat, afwijzing en rechten');
136
137
$log = $root.'/php-errors.log';
138
check(!is_file($log) || file_get_contents($log) === '', 'Geen PHP-fouten tijdens de domeintests');
139
echo "Storybook: $checks assertions passed.\n";
@@ -0,0 +1,139 @@1
<?php2
declare(strict_types=1);3
$root = sys_get_temp_dir().'/verhalenboek-'.bin2hex(random_bytes(4));4
mkdir($root, 0700, true);5
putenv('VERHALENBOEK_DATA_DIR='.$root);6
$_SERVER['HTTP_HOST'] = 'cli.test';7
$_SERVER['REMOTE_ADDR'] = '127.0.0.1';8
$_SERVER['SCRIPT_NAME'] = '/index.php';9
require dirname(__DIR__).'/lib/bootstrap.php';10
11
$checks = 0;12
function check(bool $ok, string $label): void {13
global $checks;14
$checks++;15
if (!$ok) throw new RuntimeException($label);16
}17
function rejects(callable $fn, int $status, string $label): void {18
try {19
$fn();20
} catch (AppException $e) {21
check($e->status === $status, $label.' gaf '.$e->status.' in plaats van '.$status);22
return;23
}24
check(false, $label);25
}26
function three(string $prefix = 'Verhaal'): array {27
return [28
['title' => $prefix.' een', 'paragraphs' => ['Eerste alinea.', 'Tweede alinea.']],29
['title' => $prefix.' twee', 'paragraphs' => ['Midden.']],30
['title' => $prefix.' drie', 'paragraphs' => ['Slot.']],31
];32
}33
34
$columns = array_column(query('PRAGMA table_info(users)')->fetchAll(), 'name');35
check(!in_array('email', $columns, true), 'Gebruikers hebben geen e-mailkolom');36
[$id, $name] = authIdentity(['id' => 9, 'username' => 'tim', 'email' => 'verborgen@example.com']);37
check($id === 'auth:9' && $name === 'tim', 'Identiteit gebruikt id en gebruikersnaam, niet e-mail');38
try { authIdentity(['username' => 'tim', 'email' => 'a@b.c']); check(false, 'Account zonder id moet falen'); }39
catch (RuntimeException) { check(true, 'Account zonder id moet falen'); }40
41
query('DELETE FROM reads');42
query('DELETE FROM api_keys');43
query('DELETE FROM users');44
loginUser('auth:1', 'tim');45
check(publicUser('auth:1')['role'] === 'admin' && publicUser('auth:1')['admin'] === true, 'Eerste gebruiker is beheerder');46
loginUser('auth:2', 'sam');47
check(publicUser('auth:2')['role'] === 'user' && publicUser('auth:2')['admin'] === false, 'Volgende gebruiker is lezer');48
loginUser('auth:1', 'tim');49
check(publicUser('auth:1')['role'] === 'admin', 'Opnieuw inloggen behoudt de rol');50
check(publicUser('auth:1')['theme'] === 'system' && publicUser('auth:1')['font'] === 'serif', 'Standaard thema volgt het systeem, lettertype is serif');51
52
rejects(fn() => latestWritten(), 404, 'Nog geen laatste datum');53
check(dayGaps() === ['first' => null, 'latest' => null, 'missing' => [], 'incomplete' => []], 'Lege gaten');54
rejects(fn() => createDay('2026-02-31', 'Nee', three()), 422, 'Onbestaande datum');55
rejects(fn() => createDay('2026-05-01', ' ', three()), 422, 'Lege dagtitel');56
rejects(fn() => createDay('2026-05-01', 'Dag', array_slice(three(), 0, 2)), 422, 'Twee verhalen is geen dag');57
rejects(fn() => createDay('2026-05-01', 'Dag', array_merge(three(), [['title' => 'Extra', 'paragraphs' => ['Te veel']]])), 422, 'Vier verhalen is geen dag');58
rejects(fn() => createDay('2026-05-01', 'Dag', [59
['title' => 'Een', 'paragraphs' => ['']],60
['title' => 'Twee', 'paragraphs' => ['Oké']],61
['title' => 'Drie', 'paragraphs' => ['Oké']],62
]), 422, 'Lege alinea');63
rejects(fn() => createDay('2026-05-01', str_repeat('a', 201), three()), 422, 'Te lange titel');64
65
$day = createDay('2024-02-28', 'Schrikkeldag', three('Schrikkel'));66
check($day['complete'] === true && $day['storyCount'] === 3 && $day['stories'][0]['position'] === 1 && $day['stories'][2]['position'] === 3, 'Drie verhalen in volgorde');67
check($day['stories'][0]['paragraphs'] === ['Eerste alinea.', 'Tweede alinea.'], 'Alinea\'s blijven in volgorde');68
createDay('2024-03-01', 'Maart', three('Maart'));69
$gaps = dayGaps();70
check($gaps['missing'] === ['2024-02-29'], 'Schrikkeldag telt als ontbrekende datum');71
check($gaps['incomplete'] === [], 'Volledige dagen zijn geen gaten');72
check(latestWritten()['date'] === '2024-03-01' && latestWritten()['complete'] === true, 'Laatste geschreven datum');73
74
$updated = updateStory('2024-02-28', 2, ['title' => 'Nieuwe middag']);75
check($updated['stories'][1]['title'] === 'Nieuwe middag' && $updated['stories'][1]['paragraphs'] === ['Midden.'], 'Titel wijzigen bewaart de alinea\'s');76
$replaced = updateStory('2024-02-28', 2, ['paragraphs' => ['Alleen deze.']]);77
check($replaced['stories'][1]['title'] === 'Nieuwe middag' && $replaced['stories'][1]['paragraphs'] === ['Alleen deze.'], 'Alinea\'s vervangen bewaart de titel');78
79
$afterDelete = deleteStory('2024-02-28', 2);80
check(array_column($afterDelete['stories'], 'position') === [1, 3], 'Verwijderen hernummert de plekken niet');81
check($afterDelete['complete'] === false, 'Minder dan drie verhalen is onvolledig');82
$gaps = dayGaps();83
check($gaps['incomplete'][0]['date'] === '2024-02-28' && $gaps['incomplete'][0]['missingPositions'] === [2], 'Onvolledige dag staat apart van ontbrekende datums');84
check(in_array('2024-02-29', $gaps['missing'], true) && !in_array('2024-02-28', $gaps['missing'], true), 'Een onvolledige dag is niet ook missing');85
check(latestWritten()['date'] === '2024-03-01', 'Een onvolledige eerdere dag verandert de laatste datum niet');86
87
$filled = addStory('2024-02-28', ['title' => 'Terug', 'paragraphs' => ['Weer compleet.']]);88
check($filled['stories'][1]['position'] === 2 && $filled['complete'] === true, 'Een nieuw verhaal vult de eerste vrije plek');89
rejects(fn() => addStory('2024-02-28', ['title' => 'Vier', 'paragraphs' => ['Nee']]), 422, 'Geen vierde verhaal');90
91
deleteDay('2024-03-01');92
check(latestWritten()['date'] === '2024-02-28', 'Verwijderde laatste dag schuift de laatste datum terug');93
check(dayGaps()['missing'] === [] && dayGaps()['incomplete'] === [], 'Na het verwijderen van de laatste dag vallen de gaten weg');94
deleteDay('2024-02-28');95
96
createDay('2026-05-01', 'Mei', three());97
createDay('2026-05-03', 'Later', three());98
check(dayGaps()['missing'] === ['2026-05-02'], 'Een verwijderde of nooit geschreven dag ertussen is een gat');99
$read = markRead('auth:2', '2026-05-01', true);100
check($read['read'] === true, 'Lezer markeert een dag als gelezen');101
check(loadDay('2026-05-01', 'auth:1')['read'] === false, 'Gelezen-status is per gebruiker');102
check(!array_key_exists('read', loadDay('2026-05-01', null)), 'Zonder lezer geen leesstatus');103
check(markRead('auth:2', '2026-05-01', false)['read'] === false, 'Handmatig ongelezen');104
$listed = listDays('auth:2');105
check($listed[0]['date'] === '2026-05-01' && $listed[0]['read'] === false && $listed[1]['date'] === '2026-05-03', 'Overzicht staat op datum en toont leesstatus');106
107
$settings = saveSettings('auth:2', ['theme' => 'dark', 'font' => 'rounded']);108
check($settings['theme'] === 'dark' && $settings['font'] === 'rounded', 'Instellingen worden bewaard');109
check(publicUser('auth:1')['theme'] === 'system', 'Instellingen blijven bij de gebruiker');110
rejects(fn() => saveSettings('auth:2', ['theme' => 'blauw', 'font' => 'serif']), 422, 'Onbekend thema');111
112
$key = createApiKey('auth:1', 'Schrijver');113
check(isset($key['token']) && preg_match('/^vb_[a-f0-9]{64}$/', $key['token']) && $key['prefix'] === substr($key['token'], 0, 11), 'Sleutel wordt volledig teruggegeven');114
$stored = query('SELECT token_hash, token_prefix, token_cipher FROM api_keys WHERE id=?', [$key['id']])->fetch();115
check($stored['token_hash'] === hash('sha256', $key['token']) && !str_contains($stored['token_cipher'], $key['token']), 'De database bewaart een hash en een versleutelde sleutel');116
check(revealApiKey($key['id'])['token'] === $key['token'], 'Een beheerder kan de sleutel opnieuw lezen');117
check(!str_contains(json_encode(listApiKeys(), JSON_THROW_ON_ERROR), $key['token']), 'De lijst toont de sleutel niet');118
$actor = actorFromToken($key['token']);119
check($actor['kind'] === 'token' && $actor['userId'] === 'auth:1', 'Bearer-sleutel hoort bij de beheerder');120
try { actorFromToken('vb_kort'); check(false, 'Verkeerd formaat'); }121
catch (AppException $e) { check($e->status === 401 && $e->auth === 'format', 'Verkeerd formaat is een 401'); }122
try { actorFromToken('vb_'.str_repeat('ab', 32)); check(false, 'Onbekende sleutel'); }123
catch (AppException $e) { check($e->status === 401 && $e->auth === 'rejected', 'Onbekende sleutel is een 401'); }124
revokeApiKey($key['id']);125
check(revealApiKey($key['id'])['token'] === $key['token'], 'Ook een ingetrokken sleutel blijft toonbaar');126
try { actorFromToken($key['token']); check(false, 'Ingetrokken sleutel'); }127
catch (AppException $e) { check($e->status === 401 && $e->auth === 'rejected', 'Ingetrokken sleutel werkt niet'); }128
$export = exportUser('auth:1');129
check(!isset($export['profile']['email']) && !str_contains(json_encode($export, JSON_THROW_ON_ERROR), $key['token']), 'Export bevat geen e-mail en geen geheime sleutel');130
check($export['api_keys'][0]['prefix'] === $key['prefix'] && $export['api_keys'][0]['revoked'] !== null, 'Export toont ingetrokken sleutels zonder geheim');131
$secret = config()['key_secret'] ?? '';132
check(is_string($secret) && preg_match('/^[a-f0-9]{64}$/', $secret) === 1, 'key_secret wordt automatisch aangemaakt');133
file_put_contents($root.'/config.php', str_replace("'base_url' => ''", "'base_url' => 'https://projects.timfalken.com/verhaaltjesboek'", (string)file_get_contents($root.'/config.php')));134
check(str_contains(authHint('missing'), 'geen Authorization-header') && str_contains(authHint('missing'), 'https://projects.timfalken.com/verhaaltjesboek/docs.php'), 'Ontbrekende header legt uit waar de sleutel vandaan komt');135
check(str_contains(authHint('format'), 'verkeerde formaat') && str_contains(authHint('rejected'), 'onbekend of ingetrokken') && str_contains(authHint('writer'), 'API-sleutel of als beheerder'), 'De uitleg onderscheidt formaat, afwijzing en rechten');136
137
$log = $root.'/php-errors.log';138
check(!is_file($log) || file_get_contents($log) === '', 'Geen PHP-fouten tijdens de domeintests');139
echo "Storybook: $checks assertions passed.\n";