BlueGit

projects-timfalken-com verhalenboek

Merge branch 'cursor/verhalenboek-app-f4e7' into 'master'

Verhalenboek: dagen met drie verhalen, leesvoortgang en schrijf-API

See merge request Timfa/Verhalenboek!1

timfa Tim Falken · pushed by timfa

Authored 2026-10-05 · 6 weeks ago

Hash
cff2807825a3c36e042bbe3dd8c2c3de3d51c0ec
25 files changed +2899 −1
.gitignore added +10 −0
@@ -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/.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
.gitlab-ci.yml added +47 −0
@@ -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 @@
1stages:
2 - test
3 - deploy
4
5php_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
19frontend_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.
26deploy_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
35ftp_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
README.md +128 −1
@@ -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# Verhalenboek
1# Verhalenboek
2
2
3Verhalenboek: dagen met elk drie verhalen, login via auth.timfalken.com.
3Een 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
5De applicatie staat in [`web/`](web/). Lokaal:
6
7```sh
8php -S 127.0.0.1:8080 -t web web/router.php
9```
10
11Open 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
15Microchess 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
21Deploy 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
231. Zet de code op `master` (de pipeline test eerst, en uploadt daarna alleen bij een groene `master`).
242. 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`).
253. 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.
294. 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
33return [
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
41Lege 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
435. 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.
446. 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
46De 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
50Een 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
56Schrijven 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
65Een 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
68curl -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
79curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
80 'https://projects.timfalken.com/verhaaltjesboek/api.php/days/latest'
81
82curl -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
102Fouten zijn `{"error":"…"}`. Validatie die de drie-verhalenregel raakt geeft 422. De menselijke uitleg met dezelfde voorbeelden staat op `docs.php`.
103
104Een 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
107curl -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
117Benodigde CI-variabelen, al aanwezig in dit project: `timftphost`, `timftpuser`, `timftppassword`, `timftproot`, `projectftp` (`$timftproot/verhaaltjesboek`).
118
119## Tests
120
121```sh
122find web -name '*.php' -not -path '*/artifacts/*' -print0 | xargs -0 -n1 php -l
123php web/tests/storybook.php
124python3 web/tests/startup.py
125python3 web/tests/integration.py
126node --check web/assets/app.js
127python3 ci/test_deploy.py
128```
129
130De API-tests draaien een kopie onder `web/tests/artifacts/` en laten de echte database met rust.
ci/deploy.py added +81 −0
@@ -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 python3
2"""Deploy only web/, preserving server-owned data. Passwords never enter argv."""
3import os
4from pathlib import Path
5import subprocess
6import sys
7from urllib.parse import urlsplit
8
9ROOT = Path(__file__).resolve().parents[1]
10
11def 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
16def 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
52def 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
68def 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
80if __name__ == '__main__':
81 sys.exit(main())
ci/test_deploy.py added +80 −0
@@ -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 python3
2"""Run the actual lftp command sequence against an isolated local FTP server."""
3import os
4import logging
5from pathlib import Path
6import subprocess
7import tempfile
8import threading
9import unittest
10
11from pyftpdlib.log import config_logging
12config_logging(level=logging.ERROR)
13
14from pyftpdlib.authorizers import DummyAuthorizer
15from pyftpdlib.handlers import FTPHandler
16from pyftpdlib.servers import FTPServer
17from deploy import ROOT, deployment_commands, write_asset_version
18
19class 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
79if __name__=='__main__':
80 unittest.main()
web/.htaccess added +20 −0
@@ -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 @@
1Options -Indexes
2DirectoryIndex 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>
web/README.md added +41 −0
@@ -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# Verhalenboek
2
3PHP 8.2+ met SQLite en gewone JavaScript. Zet de document root op deze map `web/`. Productie heeft geen Composer, Node of build nodig.
4
5De 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
10php -S 127.0.0.1:8080 -t web web/router.php
11```
12
13http://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
17PHP 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
21return [
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
29Registreer 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
31De eerste gebruiker die inlogt wordt beheerder. E-mail van het account wordt niet gebruikt.
32
33Apache 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
36location ~* ^/(data|lib|tests)(/|$) { deny all; }
37location ~ /\. { deny all; }
38location ~* ^/(README\.md|router\.php)$ { deny all; }
39```
40
41Controleer dat `/data/verhalenboek.sqlite`, `/data/config.php` en `/lib/bootstrap.php` 403 geven.
web/api.php added +120 −0
@@ -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<?php
2declare(strict_types=1);
3require __DIR__.'/lib/bootstrap.php';
4
5try {
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}
web/assets/app.css added +310 −0
@@ -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; }
52html { scroll-behavior: smooth; }
53body {
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}
64body, button, input, textarea { font-family: var(--font); }
65a { 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}
110h1, 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); }
143button: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}
227label { display: grid; gap: 0.3rem; font-size: 0.95rem; }
228input, 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}
237textarea { min-height: 7.5rem; line-height: 1.55; resize: vertical; }
238fieldset {
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}
247legend { 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}
web/assets/app.js added +555 −0
@@ -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
3const MONTHS = ['januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december'];
4const ROMAN = ['I', 'II', 'III'];
5const state = { me: null, csrf: '', local: false, freshKey: null, revealedKey: null };
6let renderToken = 0;
7let menuAnchor = null;
8let ignoreCloseUntil = 0;
9
10const app = document.querySelector('#app');
11if (app) boot();
12
13function formatDate(iso) {
14 const [year, month, day] = iso.split('-').map(Number);
15 return day + ' ' + MONTHS[month - 1] + ' ' + year;
16}
17
18function pathNow() {
19 const raw = location.hash.replace(/^#/, '');
20 if (!raw || raw === '/') return '/';
21 return raw.startsWith('/') ? raw : '/' + raw;
22}
23
24function 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
35function 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
43async 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
62function 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
70function 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
79function 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
87function 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
105function 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
128function 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
170function unreadLabel(count) {
171 if (count === 1) return '1 dag ongelezen';
172 return count + ' dagen ongelezen';
173}
174
175function 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
204function 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
222function 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
228function 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
298function 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
311function 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
332function 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
339async 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
401async 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
422function 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
434function 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
487async 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
537async 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}
web/assets/favicon.svg added +6 −0
@@ -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>
web/auth.php added +20 −0
@@ -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<?php
2declare(strict_types=1);
3require __DIR__.'/lib/bootstrap.php';
4try {
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}
web/callback.php added +34 −0
@@ -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<?php
2declare(strict_types=1);
3require __DIR__.'/lib/bootstrap.php';
4try {
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}
web/data/.gitkeep added +0 −0
web/data/.htaccess added +1 −0
@@ -0,0 +1 @@
1 Require all denied
@@ -0,0 +1 @@
1Require all denied
web/docs.php added +81 −0
@@ -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<?php
2declare(strict_types=1);
3require __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
67curl -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>
web/index.php added +55 −0
@@ -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<?php
2declare(strict_types=1);
3require __DIR__.'/lib/bootstrap.php';
4$logged = isset($_SESSION['user']) && (localDev() || (($_SESSION['expires'] ?? 0) > time()));
5$prefs = ['theme' => 'system', 'font' => 'serif', 'name' => '', 'role' => 'user'];
6if ($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>
web/lib/.htaccess added +1 −0
@@ -0,0 +1 @@
1 Require all denied
@@ -0,0 +1 @@
1Require all denied
web/lib/Storybook.php added +398 −0
@@ -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<?php
2declare(strict_types=1);
3
4final 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
10function 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
23function 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
34function 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
43function 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>}> */
59function 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
71function 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
80function 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
87function 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
91function 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
121function 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
139function 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
155function 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
171function 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
180function 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
202function 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
225function 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
236function 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
247function 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
276function 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
286function 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
300function 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
309function 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
326function 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
336function 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
346function 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
357function 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
366function 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
379function listApiKeys(): array {
380 return array_map('keyPublic', query('SELECT * FROM api_keys ORDER BY revoked IS NOT NULL, id DESC')->fetchAll());
381}
382
383function 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
392function 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}
web/lib/bootstrap.php added +412 −0
@@ -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<?php
2declare(strict_types=1);
3require_once __DIR__.'/Storybook.php';
4ini_set('display_errors', '0');
5ini_set('log_errors', '1');
6ini_set('error_log', dataDir().'/php-errors.log');
7header('X-Content-Type-Options: nosniff');
8header('Referrer-Policy: same-origin');
9header("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'");
10header('Cache-Control: no-store');
11
12function dataDir(): string {
13 $env = getenv('VERHALENBOEK_DATA_DIR');
14 if (is_string($env) && $env !== '') return rtrim($env, '/');
15 return dirname(__DIR__).'/data';
16}
17
18function 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
83function query(string $sql, array $args = []): PDOStatement {
84 $statement = db()->prepare($sql);
85 $statement->execute($args);
86 return $statement;
87}
88
89final 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
108function 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
114function 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.
131return [
132 'base_url' => '',
133 'client_id' => '',
134 'client_secret' => '',
135 'key_secret' => '$secret',
136];
137
138PHP;
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
154function 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
172function 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
181function 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
196function 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
207function 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
226function 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
232function 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} */
247function 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
257function 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
277config();
278session_name('verhalenboek_session');
279ini_set('session.use_strict_mode', '1');
280$sessionLifetime = 86400;
281$sessionPath = rtrim(str_replace('\\', '/', dirname($_SERVER['SCRIPT_NAME'] ?? '')), '/').'/';
282if ($sessionPath === '//') $sessionPath = '/';
283$sessionSecure = !localDev();
284session_set_cookie_params(['lifetime' => $sessionLifetime, 'path' => $sessionPath, 'secure' => $sessionSecure, 'httponly' => true, 'samesite' => 'Lax']);
285session_set_save_handler(new DatabaseSessions(), true);
286session_start();
287if (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}
296if (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
301function 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
310function 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
323function 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
330function 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
345function 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
367function 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
376function 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
381function requireAdminSession(array $actor): void {
382 if ($actor['kind'] !== 'user' || ($actor['role'] ?? '') !== 'admin') fail('Alleen een beheerder mag sleutels beheren.', 403, 'admin');
383}
384
385function requireReader(array $actor): void {
386 if ($actor['kind'] !== 'user') fail('Leesstatus hoort bij een ingelogde lezer.', 403);
387}
388
389function 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
401function 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}
web/router.php added +18 −0
@@ -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<?php
2declare(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;
6if (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}
11if (preg_match('~^/api\.php(?:/|$)~', $rel)) {
12 require __DIR__.'/api.php';
13 return true;
14}
15$full = __DIR__.$rel;
16if ($rel !== '/' && is_file($full)) return false;
17require __DIR__.'/index.php';
18return true;
web/tests/.htaccess added +1 −0
@@ -0,0 +1 @@
1 Require all denied
@@ -0,0 +1 @@
1Require all denied
web/tests/integration.py added +286 −0
@@ -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 python3
2"""Geïsoleerde API-tests. De echte database van de applicatie blijft onaangeroerd."""
3import json
4import os
5import signal
6import http.cookiejar
7import shutil
8import socket
9import sqlite3
10import subprocess
11import tempfile
12import time
13import urllib.error
14import urllib.request
15from pathlib import Path
16
17WEB = Path(__file__).resolve().parents[1]
18ARTIFACTS = WEB / 'tests/artifacts'
19ARTIFACTS.mkdir(exist_ok=True)
20checks = 0
21
22def check(value, label):
23 global checks
24 checks += 1
25 assert value, label
26
27def 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
34with 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()
web/tests/startup.py added +55 −0
@@ -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 python3
2"""Eerste start en een tweede start bewaren bestaande dagen en configuratie."""
3from pathlib import Path
4import shutil
5import sqlite3
6import subprocess
7import tempfile
8
9WEB = Path(__file__).resolve().parents[1]
10ARTIFACTS = WEB / 'tests/artifacts'
11ARTIFACTS.mkdir(exist_ok=True)
12with 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
55print('Startup: fresh database, preserved day and preserved config passed.')
web/tests/storybook.php added +139 −0
@@ -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<?php
2declare(strict_types=1);
3$root = sys_get_temp_dir().'/verhalenboek-'.bin2hex(random_bytes(4));
4mkdir($root, 0700, true);
5putenv('VERHALENBOEK_DATA_DIR='.$root);
6$_SERVER['HTTP_HOST'] = 'cli.test';
7$_SERVER['REMOTE_ADDR'] = '127.0.0.1';
8$_SERVER['SCRIPT_NAME'] = '/index.php';
9require dirname(__DIR__).'/lib/bootstrap.php';
10
11$checks = 0;
12function check(bool $ok, string $label): void {
13 global $checks;
14 $checks++;
15 if (!$ok) throw new RuntimeException($label);
16}
17function 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}
26function 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');
35check(!in_array('email', $columns, true), 'Gebruikers hebben geen e-mailkolom');
36[$id, $name] = authIdentity(['id' => 9, 'username' => 'tim', 'email' => 'verborgen@example.com']);
37check($id === 'auth:9' && $name === 'tim', 'Identiteit gebruikt id en gebruikersnaam, niet e-mail');
38try { authIdentity(['username' => 'tim', 'email' => 'a@b.c']); check(false, 'Account zonder id moet falen'); }
39catch (RuntimeException) { check(true, 'Account zonder id moet falen'); }
40
41query('DELETE FROM reads');
42query('DELETE FROM api_keys');
43query('DELETE FROM users');
44loginUser('auth:1', 'tim');
45check(publicUser('auth:1')['role'] === 'admin' && publicUser('auth:1')['admin'] === true, 'Eerste gebruiker is beheerder');
46loginUser('auth:2', 'sam');
47check(publicUser('auth:2')['role'] === 'user' && publicUser('auth:2')['admin'] === false, 'Volgende gebruiker is lezer');
48loginUser('auth:1', 'tim');
49check(publicUser('auth:1')['role'] === 'admin', 'Opnieuw inloggen behoudt de rol');
50check(publicUser('auth:1')['theme'] === 'system' && publicUser('auth:1')['font'] === 'serif', 'Standaard thema volgt het systeem, lettertype is serif');
51
52rejects(fn() => latestWritten(), 404, 'Nog geen laatste datum');
53check(dayGaps() === ['first' => null, 'latest' => null, 'missing' => [], 'incomplete' => []], 'Lege gaten');
54rejects(fn() => createDay('2026-02-31', 'Nee', three()), 422, 'Onbestaande datum');
55rejects(fn() => createDay('2026-05-01', ' ', three()), 422, 'Lege dagtitel');
56rejects(fn() => createDay('2026-05-01', 'Dag', array_slice(three(), 0, 2)), 422, 'Twee verhalen is geen dag');
57rejects(fn() => createDay('2026-05-01', 'Dag', array_merge(three(), [['title' => 'Extra', 'paragraphs' => ['Te veel']]])), 422, 'Vier verhalen is geen dag');
58rejects(fn() => createDay('2026-05-01', 'Dag', [
59 ['title' => 'Een', 'paragraphs' => ['']],
60 ['title' => 'Twee', 'paragraphs' => ['Oké']],
61 ['title' => 'Drie', 'paragraphs' => ['Oké']],
62]), 422, 'Lege alinea');
63rejects(fn() => createDay('2026-05-01', str_repeat('a', 201), three()), 422, 'Te lange titel');
64
65$day = createDay('2024-02-28', 'Schrikkeldag', three('Schrikkel'));
66check($day['complete'] === true && $day['storyCount'] === 3 && $day['stories'][0]['position'] === 1 && $day['stories'][2]['position'] === 3, 'Drie verhalen in volgorde');
67check($day['stories'][0]['paragraphs'] === ['Eerste alinea.', 'Tweede alinea.'], 'Alinea\'s blijven in volgorde');
68createDay('2024-03-01', 'Maart', three('Maart'));
69$gaps = dayGaps();
70check($gaps['missing'] === ['2024-02-29'], 'Schrikkeldag telt als ontbrekende datum');
71check($gaps['incomplete'] === [], 'Volledige dagen zijn geen gaten');
72check(latestWritten()['date'] === '2024-03-01' && latestWritten()['complete'] === true, 'Laatste geschreven datum');
73
74$updated = updateStory('2024-02-28', 2, ['title' => 'Nieuwe middag']);
75check($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.']]);
77check($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);
80check(array_column($afterDelete['stories'], 'position') === [1, 3], 'Verwijderen hernummert de plekken niet');
81check($afterDelete['complete'] === false, 'Minder dan drie verhalen is onvolledig');
82$gaps = dayGaps();
83check($gaps['incomplete'][0]['date'] === '2024-02-28' && $gaps['incomplete'][0]['missingPositions'] === [2], 'Onvolledige dag staat apart van ontbrekende datums');
84check(in_array('2024-02-29', $gaps['missing'], true) && !in_array('2024-02-28', $gaps['missing'], true), 'Een onvolledige dag is niet ook missing');
85check(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.']]);
88check($filled['stories'][1]['position'] === 2 && $filled['complete'] === true, 'Een nieuw verhaal vult de eerste vrije plek');
89rejects(fn() => addStory('2024-02-28', ['title' => 'Vier', 'paragraphs' => ['Nee']]), 422, 'Geen vierde verhaal');
90
91deleteDay('2024-03-01');
92check(latestWritten()['date'] === '2024-02-28', 'Verwijderde laatste dag schuift de laatste datum terug');
93check(dayGaps()['missing'] === [] && dayGaps()['incomplete'] === [], 'Na het verwijderen van de laatste dag vallen de gaten weg');
94deleteDay('2024-02-28');
95
96createDay('2026-05-01', 'Mei', three());
97createDay('2026-05-03', 'Later', three());
98check(dayGaps()['missing'] === ['2026-05-02'], 'Een verwijderde of nooit geschreven dag ertussen is een gat');
99$read = markRead('auth:2', '2026-05-01', true);
100check($read['read'] === true, 'Lezer markeert een dag als gelezen');
101check(loadDay('2026-05-01', 'auth:1')['read'] === false, 'Gelezen-status is per gebruiker');
102check(!array_key_exists('read', loadDay('2026-05-01', null)), 'Zonder lezer geen leesstatus');
103check(markRead('auth:2', '2026-05-01', false)['read'] === false, 'Handmatig ongelezen');
104$listed = listDays('auth:2');
105check($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']);
108check($settings['theme'] === 'dark' && $settings['font'] === 'rounded', 'Instellingen worden bewaard');
109check(publicUser('auth:1')['theme'] === 'system', 'Instellingen blijven bij de gebruiker');
110rejects(fn() => saveSettings('auth:2', ['theme' => 'blauw', 'font' => 'serif']), 422, 'Onbekend thema');
111
112$key = createApiKey('auth:1', 'Schrijver');
113check(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();
115check($stored['token_hash'] === hash('sha256', $key['token']) && !str_contains($stored['token_cipher'], $key['token']), 'De database bewaart een hash en een versleutelde sleutel');
116check(revealApiKey($key['id'])['token'] === $key['token'], 'Een beheerder kan de sleutel opnieuw lezen');
117check(!str_contains(json_encode(listApiKeys(), JSON_THROW_ON_ERROR), $key['token']), 'De lijst toont de sleutel niet');
118$actor = actorFromToken($key['token']);
119check($actor['kind'] === 'token' && $actor['userId'] === 'auth:1', 'Bearer-sleutel hoort bij de beheerder');
120try { actorFromToken('vb_kort'); check(false, 'Verkeerd formaat'); }
121catch (AppException $e) { check($e->status === 401 && $e->auth === 'format', 'Verkeerd formaat is een 401'); }
122try { actorFromToken('vb_'.str_repeat('ab', 32)); check(false, 'Onbekende sleutel'); }
123catch (AppException $e) { check($e->status === 401 && $e->auth === 'rejected', 'Onbekende sleutel is een 401'); }
124revokeApiKey($key['id']);
125check(revealApiKey($key['id'])['token'] === $key['token'], 'Ook een ingetrokken sleutel blijft toonbaar');
126try { actorFromToken($key['token']); check(false, 'Ingetrokken sleutel'); }
127catch (AppException $e) { check($e->status === 401 && $e->auth === 'rejected', 'Ingetrokken sleutel werkt niet'); }
128$export = exportUser('auth:1');
129check(!isset($export['profile']['email']) && !str_contains(json_encode($export, JSON_THROW_ON_ERROR), $key['token']), 'Export bevat geen e-mail en geen geheime sleutel');
130check($export['api_keys'][0]['prefix'] === $key['prefix'] && $export['api_keys'][0]['revoked'] !== null, 'Export toont ingetrokken sleutels zonder geheim');
131$secret = config()['key_secret'] ?? '';
132check(is_string($secret) && preg_match('/^[a-f0-9]{64}$/', $secret) === 1, 'key_secret wordt automatisch aangemaakt');
133file_put_contents($root.'/config.php', str_replace("'base_url' => ''", "'base_url' => 'https://projects.timfalken.com/verhaaltjesboek'", (string)file_get_contents($root.'/config.php')));
134check(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');
135check(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';
138check(!is_file($log) || file_get_contents($log) === '', 'Geen PHP-fouten tijdens de domeintests');
139echo "Storybook: $checks assertions passed.\n";