Update docs

Author: bcb

docs/authentication.md

@@ -31,15 +31,10 @@ RUN make && make install
 WORKDIR /var/lib/postgresql
 ```
 
-Then rebuild:
+Then rebuild the Postgres imageand recreate the container:
 
 ```sh
 docker compose build postgres
-```
-
-And recreate the running container:
-
-```sh
 docker compose up -d postgres
 ```
 
@@ -249,14 +244,57 @@ applied.
 Add the auth schema to Postgres in `compose.yaml`:
 
 ```yaml
-PGRST_DB_SCHEMAS: api,auth
+postgrest:
+  environment:
+    PGRST_DB_SCHEMAS: api,auth
+```
+
+And recreate the PostgREST container:
+
+```sh
+docker compose up -d postgrest
+```
+
+## ✅ Usage
+
+To use the `auth` schema, requests [must include a
+header](https://docs.postgrest.org/en/stable/references/api/schemas.html#multiple-schemas).
+
+GET and HEAD requests should include the header:
+
+```
+Accept-Profile: auth
 ```
 
-✅ Usage
+Other methods (POST, PATCH, PUT and DELETE) should include:
 
-Explain that all auth endpoints must have a certain header.
+```
+Content-Profile: auth
+```
+
+### Examples
+
+Login:
+
+```sh
+curl \
+  -H "Content-Profile: auth" \
+  -H "Content-Type: application/json" \
+  --data '{"user_": "demo", "pass": "demo"}' \
+  http://localhost/rpc/login
+```
 
-Show example of using each endpoint.
+Get the refresh token inserted when logged in:
+
+```sh
+bin/postgres psql -c 'select token from auth.refresh_token order by created_at desc limit 1'
+```
+
+Refresh the access token and extract the new token from the Set-Cookie header:
+
+```sh
+export ACCESS_TOKEN=$(curl --silent -i -X POST -H 'Cookie: refresh_token='$REFRESH_TOKEN'; HttpOnly' http://localhost/rpc/refresh_token |sed -nE 's/^Set-Cookie: access_token=([^;]*).*/\1/p')
+```
 
 - POST-ing a user.
 - `/rpc/login`

docs/index.md

@@ -2,9 +2,9 @@
 
 # SuperStack
 
-_SuperStack_ is a lightweight, modular backend powered by PostgreSQL —
-perfect for indie developers, SaaS builders, and teams who want full
-rontrol without the bloat.
+_SuperStack_ is a lightweight, modular backend powered by PostgreSQL — perfect
+for indie developers, SaaS builders, and teams who want full control without
+the bloat.
 
 Spin up a fully working backend in seconds, with zero setup. Just clone and
 run.

docs/rabbitmq.md

@@ -20,12 +20,18 @@ RUN apt-get update && apt-get install -y \
 # pg_amqp - Used by api schema
 COPY ./pg_amqp /pg_amqp
 WORKDIR /pg_amqp
-RUN make
-RUN make install
+RUN make && make install
 
 WORKDIR /var/lib/postgresql
 ```
 
+Then rebuild the Postgres imageand recreate the container:
+
+```sh
+docker compose build postgres
+docker compose up -d postgres
+```
+
 > You may need to fix "implicit int" errors in pg_amqp, which were reported
 > [here](https://github.com/omniti-labs/pg_amqp/issues/41), and [fixed but not
 > yet merged](https://github.com/omniti-labs/pg_amqp/pull/43).