Compare commits
@@ -79,12 +79,18 @@ jobs:
|
|||||||
working-directory: web
|
working-directory: web
|
||||||
run: npm ci --no-audit --no-fund
|
run: npm ci --no-audit --no-fund
|
||||||
|
|
||||||
# Chromium only. A smoke test exists to catch a build that does not work at
|
# Chromium for the suite, WebKit for one test.
|
||||||
# all; running it three times in three engines finds the same breakage three
|
#
|
||||||
# times and costs three times as much.
|
# A smoke test exists to catch a build that does not work at all, and running
|
||||||
- name: Install Chromium
|
# the whole thing in three engines finds the same breakage three times for
|
||||||
|
# three times the cost. Focus is the exception, and it took a real report to
|
||||||
|
# learn it: Safari ignores `autofocus` on anything inserted after the page has
|
||||||
|
# loaded, so every inline form in the app opened with no cursor in it. WebKit
|
||||||
|
# here is the same engine Safari is, and `webkit-forms` in the Playwright
|
||||||
|
# config greps a single test out of the suite to run in it.
|
||||||
|
- name: Install browsers
|
||||||
working-directory: web
|
working-directory: web
|
||||||
run: npx playwright install --with-deps chromium
|
run: npx playwright install --with-deps chromium webkit
|
||||||
|
|
||||||
# The suite builds the frontend, embeds it and starts the real binary — see
|
# The suite builds the frontend, embeds it and starts the real binary — see
|
||||||
# playwright.config.js. There is nothing to build here first.
|
# playwright.config.js. There is nothing to build here first.
|
||||||
|
|||||||
@@ -11,6 +11,16 @@
|
|||||||
|
|
||||||
# Frontend
|
# Frontend
|
||||||
node_modules/
|
node_modules/
|
||||||
|
# iCloud syncs ~/Documents, and it evicts what it thinks is cold — which for a
|
||||||
|
# dependency tree is nearly all of it. An evicted file blocks on read until it is
|
||||||
|
# downloaded again, and a download that stalls hangs the build for good: 0 % CPU,
|
||||||
|
# no output, forever. macOS never syncs anything ending in .nosync, so the tree
|
||||||
|
# lives there and `node_modules` is a symlink to it. Redo it after a fresh clone:
|
||||||
|
#
|
||||||
|
# mv node_modules node_modules.nosync && ln -s node_modules.nosync node_modules
|
||||||
|
#
|
||||||
|
# The real fix is a repo path outside a synced folder.
|
||||||
|
node_modules.nosync/
|
||||||
/web/.svelte-kit/
|
/web/.svelte-kit/
|
||||||
/web/build/
|
/web/build/
|
||||||
|
|
||||||
|
|||||||
@@ -5,7 +5,17 @@
|
|||||||
# manager and no libc — the attack surface of the running container is the binary.
|
# manager and no libc — the attack surface of the running container is the binary.
|
||||||
|
|
||||||
# --- 1. the web interface ----------------------------------------------------
|
# --- 1. the web interface ----------------------------------------------------
|
||||||
FROM node:22-alpine AS web
|
#
|
||||||
|
# Pinned to the *build* platform, not the target. What this stage produces is
|
||||||
|
# HTML, CSS and JavaScript, which are the same bytes whatever the image will run
|
||||||
|
# on — so building it once and copying it into both architectures is not an
|
||||||
|
# optimisation, it is the correct thing.
|
||||||
|
#
|
||||||
|
# Without the pin, buildx runs this stage once per target, which means running
|
||||||
|
# Node and esbuild under QEMU for arm64. That crashes: exit 132, SIGILL, an
|
||||||
|
# instruction the emulator does not implement, roughly one release in three. It
|
||||||
|
# looks like a broken build and is a broken emulator.
|
||||||
|
FROM --platform=$BUILDPLATFORM node:22-alpine AS web
|
||||||
|
|
||||||
WORKDIR /src
|
WORKDIR /src
|
||||||
COPY web/ ./
|
COPY web/ ./
|
||||||
@@ -24,7 +34,12 @@ RUN if [ -f package.json ]; then \
|
|||||||
fi
|
fi
|
||||||
|
|
||||||
# --- 2. the binary -----------------------------------------------------------
|
# --- 2. the binary -----------------------------------------------------------
|
||||||
FROM golang:1.26-alpine AS build
|
#
|
||||||
|
# Also pinned to the build platform, and cross-compiled instead. Go does that
|
||||||
|
# natively and CGO is already off, so there is nothing to emulate — where
|
||||||
|
# building *in* the target architecture means running the whole Go toolchain
|
||||||
|
# under QEMU for one of the two.
|
||||||
|
FROM --platform=$BUILDPLATFORM golang:1.26-alpine AS build
|
||||||
|
|
||||||
WORKDIR /src
|
WORKDIR /src
|
||||||
|
|
||||||
@@ -37,11 +52,13 @@ COPY . .
|
|||||||
COPY --from=web /src/build ./cmd/verdande/webbuild
|
COPY --from=web /src/build ./cmd/verdande/webbuild
|
||||||
|
|
||||||
ARG VERSION=dev
|
ARG VERSION=dev
|
||||||
|
# Supplied by buildx per target. The default keeps a plain `docker build` working.
|
||||||
|
ARG TARGETARCH=amd64
|
||||||
|
|
||||||
# CGO off is what makes this binary static, and it is only possible because the
|
# CGO off is what makes this binary static, and it is only possible because the
|
||||||
# SQLite driver is pure Go. -trimpath and the empty buildid keep the output
|
# SQLite driver is pure Go. -trimpath and the empty buildid keep the output
|
||||||
# reproducible; -s -w drop the symbol and DWARF tables, which is most of the size.
|
# reproducible; -s -w drop the symbol and DWARF tables, which is most of the size.
|
||||||
RUN CGO_ENABLED=0 GOOS=linux go build \
|
RUN CGO_ENABLED=0 GOOS=linux GOARCH=${TARGETARCH} go build \
|
||||||
-tags embedweb \
|
-tags embedweb \
|
||||||
-trimpath \
|
-trimpath \
|
||||||
-ldflags="-s -w -buildid= -X main.version=${VERSION}" \
|
-ldflags="-s -w -buildid= -X main.version=${VERSION}" \
|
||||||
|
|||||||
@@ -65,6 +65,9 @@ Apple Reminders, forward mail into it, and add it to Claude as a connector.
|
|||||||
| REST API: projects, sections, tasks, sub-tasks, ordering | Done, tested |
|
| REST API: projects, sections, tasks, sub-tasks, ordering | Done, tested |
|
||||||
| Today, Upcoming, search, activity log | Done, tested |
|
| Today, Upcoming, search, activity log | Done, tested |
|
||||||
| Waiting on others: what you have delegated, by person | Done, tested |
|
| Waiting on others: what you have delegated, by person | Done, tested |
|
||||||
|
| Assignee shown on every task that is somebody else's | Done, smoke-tested |
|
||||||
|
| Activity log, visible per project | Done, smoke-tested |
|
||||||
|
| Change a member's role without removing them | Done, tested |
|
||||||
| Sharing: invites, roles, members | Done, tested |
|
| Sharing: invites, roles, members | Done, tested |
|
||||||
| Live sync over WebSocket | Done |
|
| Live sync over WebSocket | Done |
|
||||||
| Web interface: sign-in, views, quick add, ⌘K, shortcuts | Done |
|
| Web interface: sign-in, views, quick add, ⌘K, shortcuts | Done |
|
||||||
@@ -72,6 +75,8 @@ Apple Reminders, forward mail into it, and add it to Claude as a connector.
|
|||||||
| Settings: account, notifications, integrations, AI, tokens, data | Done |
|
| Settings: account, notifications, integrations, AI, tokens, data | Done |
|
||||||
| Device list: where you are signed in, and signing one out | Done, tested |
|
| Device list: where you are signed in, and signing one out | Done, tested |
|
||||||
| User administration: invite to the instance, promote, remove | Done, tested |
|
| User administration: invite to the instance, promote, remove | Done, tested |
|
||||||
|
| Server errors kept in the database, readable after a restart | Done, tested |
|
||||||
|
| PWA icons: PNG for launchers, apple-touch-icon for iOS | Done, smoke-tested |
|
||||||
| Invite and password-reset links that open the right page | Done, smoke-tested |
|
| Invite and password-reset links that open the right page | Done, smoke-tested |
|
||||||
| Drag to reorder, in both the list and the board | Done |
|
| Drag to reorder, in both the list and the board | Done |
|
||||||
| Drag a task to another project or another day | Done, smoke-tested |
|
| Drag a task to another project or another day | Done, smoke-tested |
|
||||||
@@ -113,8 +118,15 @@ accented `o` and a Danish-first app that cannot do this is broken for its own us
|
|||||||
|---|---|
|
|---|---|
|
||||||
|  |  |
|
|  |  |
|
||||||
| Board view — one column per section. | The light theme. |
|
| Board view — one column per section. | The light theme. |
|
||||||
|
|  |  |
|
||||||
|
| A week at a time, so a task can be dragged across a month boundary. | A task, opened. |
|
||||||
|
|  |  |
|
||||||
|
| Five themes, all measured for contrast. | What has been done on the server. |
|
||||||
|
|
||||||
Regenerate these with `go run ./tools/shots` against a running instance.
|
Regenerate these with `node scripts/generate-screenshots.js` from `web/`. It starts
|
||||||
|
the real binary, creates its own account, fills it with demo data and photographs
|
||||||
|
eleven surfaces — nothing to set up and nothing to remember. (`go run ./tools/shots`
|
||||||
|
still works, and is the way to photograph an instance that is already running.)
|
||||||
|
|
||||||
## Running it
|
## Running it
|
||||||
|
|
||||||
@@ -185,6 +197,9 @@ to put one that the operator would ever see.
|
|||||||
| `VERDANDE_GMAIL_CLIENT_ID` | — | OAuth client from Google Cloud, if anyone will connect a mailbox. |
|
| `VERDANDE_GMAIL_CLIENT_ID` | — | OAuth client from Google Cloud, if anyone will connect a mailbox. |
|
||||||
| `VERDANDE_GMAIL_CLIENT_SECRET` | — | |
|
| `VERDANDE_GMAIL_CLIENT_SECRET` | — | |
|
||||||
| `VERDANDE_UPDATE_CHECK` | `false` | Ask GitHub whether a newer release exists. Sends nothing about your instance. |
|
| `VERDANDE_UPDATE_CHECK` | `false` | Ask GitHub whether a newer release exists. Sends nothing about your instance. |
|
||||||
|
| `VERDANDE_PANEL_URL` | — | The Yggdrasil panel this instance runs under, so it can ask to be restarted from its own settings. |
|
||||||
|
| `VERDANDE_PANEL_TOKEN` | — | An API token from that panel, belonging to somebody with control of this server. |
|
||||||
|
| `VERDANDE_PANEL_SERVER_ID` | — | Which server to restart — the id in the panel's URL. |
|
||||||
| `VERDANDE_DEV` | `false` | Human-readable logs at debug level. |
|
| `VERDANDE_DEV` | `false` | Human-readable logs at debug level. |
|
||||||
|
|
||||||
## What lives in `/data`
|
## What lives in `/data`
|
||||||
|
|||||||
@@ -60,6 +60,18 @@ own mailbox from **Settings → Gmail**. The redirect URI is derived from
|
|||||||
| Variable | Default | What it does |
|
| Variable | Default | What it does |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| `VERDANDE_UPDATE_CHECK` | `false` | Ask GitHub whether a newer release exists. |
|
| `VERDANDE_UPDATE_CHECK` | `false` | Ask GitHub whether a newer release exists. |
|
||||||
|
| `VERDANDE_PANEL_URL` | — | The Yggdrasil panel this instance runs under. |
|
||||||
|
| `VERDANDE_PANEL_TOKEN` | — | An API token from that panel, belonging to somebody with control of this server. |
|
||||||
|
| `VERDANDE_PANEL_SERVER_ID` | — | Which server to restart — the id in the panel's URL. |
|
||||||
|
|
||||||
|
All three together let **Indstillinger → Notifikationer** restart this instance,
|
||||||
|
which is also how it picks up a new version: a container cannot replace its own
|
||||||
|
image, so the panel recreates it and pulls `:latest` on the way. Any one of the
|
||||||
|
three alone does nothing, and the page names the ones that are missing.
|
||||||
|
|
||||||
|
The token is a panel credential with control over that server. Anybody who can
|
||||||
|
read this environment can restart it — which is true of anybody with the host
|
||||||
|
anyway — and it is never sent to a browser.
|
||||||
|
|
||||||
Off unless you turn it on. When on, verdande asks the public GitHub releases API
|
Off unless you turn it on. When on, verdande asks the public GitHub releases API
|
||||||
at most every six hours and sends nothing about your instance — no identifier, no
|
at most every six hours and sends nothing about your instance — no identifier, no
|
||||||
|
|||||||
@@ -226,6 +226,43 @@ paths:
|
|||||||
"422": { $ref: "#/components/responses/Validation" }
|
"422": { $ref: "#/components/responses/Validation" }
|
||||||
"429": { $ref: "#/components/responses/RateLimited" }
|
"429": { $ref: "#/components/responses/RateLimited" }
|
||||||
|
|
||||||
|
/api/v1/auth/sidebar-sections:
|
||||||
|
put:
|
||||||
|
tags: [auth]
|
||||||
|
summary: Which sidebar headings are folded away.
|
||||||
|
description: |
|
||||||
|
On the account rather than in the browser. A project group already carries
|
||||||
|
`collapsed` on its own row for the same reason: folding a heading is a
|
||||||
|
statement about the work — "I am not in Etiketter at the moment" — and that
|
||||||
|
is as true on a laptop as on a desktop. The sidebar's *width* is the
|
||||||
|
opposite case and stays in the browser, because a narrow laptop and a wide
|
||||||
|
monitor deserve different answers.
|
||||||
|
|
||||||
|
Its own route rather than a field on `PATCH /auth/me`. That one backs a
|
||||||
|
form with a save button and validates three fields together; this writes on
|
||||||
|
every click of a chevron, and sharing the path would mean a fold sending a
|
||||||
|
name and a timezone it was never asked to change.
|
||||||
|
|
||||||
|
The keys belong to the interface and are not checked here. An unknown one
|
||||||
|
costs nothing — the sidebar folds what it recognises and ignores the rest —
|
||||||
|
so renaming or removing a heading leaves a harmless entry rather than
|
||||||
|
needing a migration.
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
sections:
|
||||||
|
type: array
|
||||||
|
maxItems: 20
|
||||||
|
items: { type: string }
|
||||||
|
example: ["labels", "filters"]
|
||||||
|
responses:
|
||||||
|
"204": { description: Saved. }
|
||||||
|
"400": { $ref: "#/components/responses/BadRequest" }
|
||||||
|
|
||||||
/api/v1/auth/me:
|
/api/v1/auth/me:
|
||||||
get:
|
get:
|
||||||
tags: [auth]
|
tags: [auth]
|
||||||
@@ -351,6 +388,195 @@ paths:
|
|||||||
"204": { description: Off. }
|
"204": { description: Off. }
|
||||||
"422": { $ref: "#/components/responses/Validation" }
|
"422": { $ref: "#/components/responses/Validation" }
|
||||||
|
|
||||||
|
/api/v1/auth/passkeys:
|
||||||
|
get:
|
||||||
|
tags: [auth]
|
||||||
|
summary: The keys registered on this account.
|
||||||
|
description: |
|
||||||
|
A passkey is a key on a device rather than a secret in a head. The private
|
||||||
|
half never leaves the device, and the signature is bound to the origin that
|
||||||
|
asked for it — so a convincing copy of the sign-in page at another address
|
||||||
|
gets a signature it cannot use.
|
||||||
|
|
||||||
|
One row per credential, because a person has a laptop and a phone and losing
|
||||||
|
one must not mean losing the way in. The name is theirs to write: a list
|
||||||
|
nobody can read is a list nobody revokes from.
|
||||||
|
|
||||||
|
Sessions only, like `/tokens` — a leaked API token must not be able to add
|
||||||
|
its own way in, which would turn a theft into a tenancy.
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: OK
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
passkeys:
|
||||||
|
type: array
|
||||||
|
items: { $ref: "#/components/schemas/Passkey" }
|
||||||
|
available:
|
||||||
|
type: boolean
|
||||||
|
description: |
|
||||||
|
Whether this deployment can offer passkeys at all. False when
|
||||||
|
`VERDANDE_BASE_URL` is an IP address or otherwise not a
|
||||||
|
domain an authenticator will accept — the interface asks once
|
||||||
|
rather than discovering it from a 503 it caused by offering a
|
||||||
|
button.
|
||||||
|
"403": { $ref: "#/components/responses/Forbidden" }
|
||||||
|
|
||||||
|
/api/v1/auth/passkeys/register/begin:
|
||||||
|
post:
|
||||||
|
tags: [auth]
|
||||||
|
summary: Start registering a key. Returns the options and a challenge id.
|
||||||
|
description: |
|
||||||
|
Registration is done by somebody already signed in: you cannot be handed a
|
||||||
|
way into an account you have not proved you own.
|
||||||
|
|
||||||
|
The challenge is kept server-side rather than in a cookie, because the whole
|
||||||
|
point of it is that the server chose it and remembers choosing it. It is
|
||||||
|
answerable once and expires after five minutes.
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: Pass `options` to `navigator.credentials.create()`.
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
challenge_id: { type: string }
|
||||||
|
options: { type: object, additionalProperties: true }
|
||||||
|
"503":
|
||||||
|
description: |
|
||||||
|
`VERDANDE_BASE_URL` is not an address an authenticator will accept. 503
|
||||||
|
rather than 404: this version has passkeys, this deployment cannot offer
|
||||||
|
them, and those are different things to fix.
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema: { $ref: "#/components/schemas/Error" }
|
||||||
|
|
||||||
|
/api/v1/auth/passkeys/register/finish:
|
||||||
|
post:
|
||||||
|
tags: [auth]
|
||||||
|
summary: Finish registering a key.
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
challenge_id: { type: string }
|
||||||
|
name:
|
||||||
|
type: string
|
||||||
|
description: What to call it in the list — "min bærbare".
|
||||||
|
credential:
|
||||||
|
type: object
|
||||||
|
additionalProperties: true
|
||||||
|
description: The response from `navigator.credentials.create()`.
|
||||||
|
responses:
|
||||||
|
"201":
|
||||||
|
description: Registered.
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema: { $ref: "#/components/schemas/Passkey" }
|
||||||
|
"400":
|
||||||
|
description: The attempt expired, was already used, or did not verify.
|
||||||
|
"503":
|
||||||
|
description: Passkeys are unavailable on this instance.
|
||||||
|
|
||||||
|
/api/v1/auth/passkeys/{passkeyID}:
|
||||||
|
parameters:
|
||||||
|
- { name: passkeyID, in: path, required: true, schema: { type: string } }
|
||||||
|
patch:
|
||||||
|
tags: [auth]
|
||||||
|
summary: Rename a key.
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
name: { type: string }
|
||||||
|
responses:
|
||||||
|
"204": { description: Renamed. }
|
||||||
|
"404": { $ref: "#/components/responses/NotFound" }
|
||||||
|
delete:
|
||||||
|
tags: [auth]
|
||||||
|
summary: Remove a key.
|
||||||
|
description: |
|
||||||
|
Scoped in the SQL rather than checked first: an id read in one step and
|
||||||
|
deleted in the next is a window, and the reason somebody is on this screen
|
||||||
|
is usually that they think a device is gone.
|
||||||
|
responses:
|
||||||
|
"204": { description: Removed. }
|
||||||
|
"404": { $ref: "#/components/responses/NotFound" }
|
||||||
|
|
||||||
|
/api/v1/auth/passkey/login/begin:
|
||||||
|
post:
|
||||||
|
tags: [auth]
|
||||||
|
summary: Start signing in with a key. No session, and no email.
|
||||||
|
description: |
|
||||||
|
A discoverable login: nobody has said who they are yet, and that is the
|
||||||
|
point. The device knows which account its key belongs to, so there is no
|
||||||
|
address to type and no list of accounts for anybody to probe.
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: Pass `options` to `navigator.credentials.get()`.
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
challenge_id: { type: string }
|
||||||
|
options: { type: object, additionalProperties: true }
|
||||||
|
"429": { $ref: "#/components/responses/RateLimited" }
|
||||||
|
"503":
|
||||||
|
description: Passkeys are unavailable on this instance.
|
||||||
|
|
||||||
|
/api/v1/auth/passkey/login/finish:
|
||||||
|
post:
|
||||||
|
tags: [auth]
|
||||||
|
summary: Finish signing in with a key.
|
||||||
|
description: |
|
||||||
|
A key that verified its owner — a PIN, a fingerprint, a face — is both
|
||||||
|
factors at once, and completes the login outright. One that only proved
|
||||||
|
possession still stops at the TOTP step, exactly as a password does.
|
||||||
|
|
||||||
|
A counter that has gone backwards means the credential has been cloned. It
|
||||||
|
is refused rather than logged: that counter is the only signal this design
|
||||||
|
gives.
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
challenge_id: { type: string }
|
||||||
|
credential:
|
||||||
|
type: object
|
||||||
|
additionalProperties: true
|
||||||
|
description: The response from `navigator.credentials.get()`.
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: Signed in, or `totp_required` when the key was possession only.
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
user: { $ref: "#/components/schemas/User" }
|
||||||
|
totp_required: { type: boolean }
|
||||||
|
"401":
|
||||||
|
description: |
|
||||||
|
One message for an unknown key and for a bad signature. Telling them
|
||||||
|
apart is a way to learn which credentials exist here.
|
||||||
|
"429": { $ref: "#/components/responses/RateLimited" }
|
||||||
|
"503":
|
||||||
|
description: Passkeys are unavailable on this instance.
|
||||||
|
|
||||||
/api/v1/auth/sessions:
|
/api/v1/auth/sessions:
|
||||||
get:
|
get:
|
||||||
tags: [auth]
|
tags: [auth]
|
||||||
@@ -856,6 +1082,376 @@ paths:
|
|||||||
"204": { description: Deleted. }
|
"204": { description: Deleted. }
|
||||||
"404": { $ref: "#/components/responses/NotFound" }
|
"404": { $ref: "#/components/responses/NotFound" }
|
||||||
|
|
||||||
|
/api/v1/activity:
|
||||||
|
get:
|
||||||
|
tags: [auth]
|
||||||
|
summary: What has been done on this instance. Administrators only.
|
||||||
|
description: |
|
||||||
|
The same rows as `/projects/{projectID}/activity`, read across every
|
||||||
|
project instead of one at a time.
|
||||||
|
|
||||||
|
The per-project history is a question a project's members ask about their
|
||||||
|
own work. This is a different question — "what has happened on this
|
||||||
|
server" — and nothing could answer it: the per-project endpoint takes one
|
||||||
|
project id, and an administrator is not necessarily a member of the
|
||||||
|
project they need to look into.
|
||||||
|
|
||||||
|
It is the other half of `/errors`. That one is what broke; this is what was
|
||||||
|
done.
|
||||||
|
|
||||||
|
Rows outlive the accounts that wrote them. `activity.user_id` is
|
||||||
|
`ON DELETE SET NULL`, so a deleted account leaves its trail behind with
|
||||||
|
`user_id` and `user_name` absent — a log that lost those rows would be
|
||||||
|
missing the part most worth keeping.
|
||||||
|
|
||||||
|
Paged with a keyset cursor rather than an offset. The log is written to
|
||||||
|
constantly and read rarely, so a page fetched a minute after the one
|
||||||
|
before it would be shifted by everything written in between: a row shown
|
||||||
|
twice and the row behind it skipped.
|
||||||
|
parameters:
|
||||||
|
- { name: limit, in: query, schema: { type: integer, default: 100, maximum: 500 } }
|
||||||
|
- name: before
|
||||||
|
in: query
|
||||||
|
schema: { type: string }
|
||||||
|
description: |
|
||||||
|
`next_cursor` from the previous page, as `<unix>:<id>`. Both halves
|
||||||
|
are required: the log is written in whole seconds, so a timestamp
|
||||||
|
alone cannot separate two rows written in the same one.
|
||||||
|
example: "1755432000:01J8Z9"
|
||||||
|
- { name: user_id, in: query, schema: { type: string } }
|
||||||
|
- { name: project_id, in: query, schema: { type: string } }
|
||||||
|
- name: event
|
||||||
|
in: query
|
||||||
|
schema: { type: string }
|
||||||
|
description: An exact event name, as listed by `/activity/events`.
|
||||||
|
example: task.completed
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: OK
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
activity:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
id: { type: string }
|
||||||
|
at: { type: string, format: date-time }
|
||||||
|
project_id: { type: string }
|
||||||
|
project_name: { type: string }
|
||||||
|
task_id: { type: string }
|
||||||
|
user_id:
|
||||||
|
type: string
|
||||||
|
description: Absent when the account has been deleted.
|
||||||
|
user_name:
|
||||||
|
type: string
|
||||||
|
description: Absent when the account has been deleted.
|
||||||
|
event: { type: string, example: task.completed }
|
||||||
|
payload: { type: object, additionalProperties: true }
|
||||||
|
next_cursor:
|
||||||
|
type: string
|
||||||
|
description: |
|
||||||
|
Absent on the last page. Present only when the page came
|
||||||
|
back full — a short page is the end of the log, and a
|
||||||
|
cursor there invites one more request that can only come
|
||||||
|
back empty.
|
||||||
|
"403": { $ref: "#/components/responses/Forbidden" }
|
||||||
|
|
||||||
|
/api/v1/activity/events:
|
||||||
|
get:
|
||||||
|
tags: [auth]
|
||||||
|
summary: The event names the log contains, with counts. Administrators only.
|
||||||
|
description: |
|
||||||
|
What the `event` filter is drawn from, most frequent first.
|
||||||
|
|
||||||
|
Offered rather than typed. Event names are an internal vocabulary —
|
||||||
|
`member.role_changed`, not a sentence anybody would guess — so a text
|
||||||
|
field for them is a field that returns nothing until you have read the
|
||||||
|
source. The counts are worth having on their own: they are the shape of
|
||||||
|
what the instance does.
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: OK
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
events:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
event: { type: string, example: task.completed }
|
||||||
|
count: { type: integer }
|
||||||
|
"403": { $ref: "#/components/responses/Forbidden" }
|
||||||
|
|
||||||
|
/api/v1/gmail/client:
|
||||||
|
get:
|
||||||
|
tags: [integrations]
|
||||||
|
summary: The Gmail OAuth client this instance uses. Administrators only.
|
||||||
|
description: |
|
||||||
|
The registration Google requires, enterable rather than deployed.
|
||||||
|
|
||||||
|
The one click that opens Google's consent screen already exists. What it
|
||||||
|
needs behind it is a registered client, and no app can conjure one: Google
|
||||||
|
issues no Gmail access to an unregistered client, and `gmail.readonly` is a
|
||||||
|
restricted scope, so an id shipped inside a public image would be both
|
||||||
|
extractable from it and unusable without Google's security review of every
|
||||||
|
deployment that used it.
|
||||||
|
|
||||||
|
The registration is a one-off. Having to edit a Rune's manifest and
|
||||||
|
recreate the container to paste the result was not, which is what this
|
||||||
|
replaces.
|
||||||
|
|
||||||
|
`VERDANDE_GMAIL_CLIENT_ID` and `_SECRET` still win when they are set. A
|
||||||
|
value in the environment is a deliberate deployment decision — under
|
||||||
|
version control, reapplied on every recreate — and a form that could
|
||||||
|
quietly override it would make the manifest a lie. `from_env` says so, and
|
||||||
|
`PUT` answers 409.
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: OK
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema: { $ref: "#/components/schemas/GmailClient" }
|
||||||
|
"403": { $ref: "#/components/responses/Forbidden" }
|
||||||
|
put:
|
||||||
|
tags: [integrations]
|
||||||
|
summary: Set the Gmail OAuth client. Administrators only.
|
||||||
|
description: |
|
||||||
|
An empty `client_secret` means "leave the stored one alone", not "delete
|
||||||
|
it" — otherwise correcting a typo in the id would silently clear the
|
||||||
|
secret. The secret is never read back, for the same reason the AI key is
|
||||||
|
not: a settings page that repopulates a password field is one that will
|
||||||
|
eventually leak into a screenshot.
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
client_id: { type: string }
|
||||||
|
client_secret: { type: string }
|
||||||
|
responses:
|
||||||
|
"204": { description: Saved. }
|
||||||
|
"403": { $ref: "#/components/responses/Forbidden" }
|
||||||
|
"409":
|
||||||
|
description: The environment sets it, so this cannot.
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema: { $ref: "#/components/schemas/Error" }
|
||||||
|
"422": { $ref: "#/components/responses/Validation" }
|
||||||
|
|
||||||
|
/api/v1/backups:
|
||||||
|
get:
|
||||||
|
tags: [auth]
|
||||||
|
summary: The nightly backups. Administrators only.
|
||||||
|
description: |
|
||||||
|
The backup job has run since the beginning and nothing showed it. A backup
|
||||||
|
nobody can see is a backup nobody knows has been failing, and the failure
|
||||||
|
is quiet: a volume that went read-only, a disk that filled, a container
|
||||||
|
that has not been up at midnight all week. The first anybody hears of it
|
||||||
|
is the day they need one.
|
||||||
|
|
||||||
|
The most recent fourteen files are kept — counted by file rather than by
|
||||||
|
age, so a container that was off for a month does not come back and delete
|
||||||
|
every backup for being too old. Rows older than that stay in the list with
|
||||||
|
`present: false`: a true record of a backup that was made and a file that
|
||||||
|
is no longer there.
|
||||||
|
|
||||||
|
Sessions-only as well as administrators-only. A backup is a complete copy
|
||||||
|
of the database, so this is everybody's data in one file.
|
||||||
|
parameters:
|
||||||
|
- { name: limit, in: query, schema: { type: integer, default: 30, maximum: 100 } }
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: OK
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
backups:
|
||||||
|
type: array
|
||||||
|
items: { $ref: "#/components/schemas/BackupRun" }
|
||||||
|
"403": { $ref: "#/components/responses/Forbidden" }
|
||||||
|
post:
|
||||||
|
tags: [auth]
|
||||||
|
summary: Take a backup now. Administrators only.
|
||||||
|
description: |
|
||||||
|
The same work the nightly job does, without its "one a day" check.
|
||||||
|
|
||||||
|
Two reasons it exists: waiting until tonight to find out whether backups
|
||||||
|
work at all is how somebody finds out on the day they need one, and it is
|
||||||
|
the only way to get a snapshot from *before* something you are about to
|
||||||
|
do.
|
||||||
|
|
||||||
|
Synchronous — a homelab database is a second or two, and a button that
|
||||||
|
returns immediately and says nothing is a button people press twice.
|
||||||
|
responses:
|
||||||
|
"201":
|
||||||
|
description: Written.
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema: { $ref: "#/components/schemas/BackupRun" }
|
||||||
|
"403": { $ref: "#/components/responses/Forbidden" }
|
||||||
|
"500":
|
||||||
|
description: |
|
||||||
|
The snapshot failed — a full volume, or one that has gone read-only,
|
||||||
|
which is precisely the condition this button exists to surface.
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema: { $ref: "#/components/schemas/Error" }
|
||||||
|
|
||||||
|
/api/v1/backups/{backupID}:
|
||||||
|
parameters:
|
||||||
|
- { name: backupID, in: path, required: true, schema: { type: string } }
|
||||||
|
get:
|
||||||
|
tags: [auth]
|
||||||
|
summary: Download one backup file. Administrators only.
|
||||||
|
description: |
|
||||||
|
A SQLite database, served as `application/octet-stream` with
|
||||||
|
`Content-Disposition: attachment` — nothing should ever be tempted to
|
||||||
|
render it inline.
|
||||||
|
|
||||||
|
Restoring is deliberately not an API call. Putting a database back under a
|
||||||
|
running server means stopping every writer, swapping the file and
|
||||||
|
reopening, and a half-done version of that corrupts the thing it was
|
||||||
|
restoring. Stop the container, put the file in place of `verdande.db` in
|
||||||
|
the data volume, delete the `-wal` and `-shm` beside it, and start it
|
||||||
|
again.
|
||||||
|
|
||||||
|
A row whose file has been rotated away answers 404. That is the honest
|
||||||
|
answer to "send me that one".
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: The database file.
|
||||||
|
content:
|
||||||
|
application/octet-stream:
|
||||||
|
schema: { type: string, format: binary }
|
||||||
|
"403": { $ref: "#/components/responses/Forbidden" }
|
||||||
|
"404": { $ref: "#/components/responses/NotFound" }
|
||||||
|
|
||||||
|
/api/v1/panel:
|
||||||
|
get:
|
||||||
|
tags: [auth]
|
||||||
|
summary: Whether this instance can restart itself. Administrators only.
|
||||||
|
description: |
|
||||||
|
A container cannot replace its own image from the inside, so "update" is
|
||||||
|
really "ask whoever owns the container to recreate it" — Yggdrasil pulls
|
||||||
|
`:latest` on the way, which is what makes a restart an update at all.
|
||||||
|
|
||||||
|
This says whether the three settings are present. The token is never sent:
|
||||||
|
the page needs to know whether the button can work, not what the credential
|
||||||
|
is. When it cannot, the missing variables are named — an operator reading
|
||||||
|
"not configured" should not have to go and find out which of three.
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: OK
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
configured: { type: boolean }
|
||||||
|
panel_url: { type: string }
|
||||||
|
missing:
|
||||||
|
type: array
|
||||||
|
items: { type: string }
|
||||||
|
description: The environment variables that are not set.
|
||||||
|
"403": { $ref: "#/components/responses/Forbidden" }
|
||||||
|
|
||||||
|
/api/v1/panel/restart:
|
||||||
|
post:
|
||||||
|
tags: [auth]
|
||||||
|
summary: Ask the panel to recreate this container. Administrators only.
|
||||||
|
description: |
|
||||||
|
The panel does the work and records who asked; this removes the second
|
||||||
|
browser tab, not the panel's authority.
|
||||||
|
|
||||||
|
Answers 202 rather than waiting: the panel stops this container as part of
|
||||||
|
answering, so the reply may never arrive. A request cut off mid-flight is
|
||||||
|
the successful case wearing a failure's clothes — the interface polls
|
||||||
|
`/healthz` rather than believing either answer.
|
||||||
|
|
||||||
|
Sessions only, like the rest of this group. A leaked API token that could
|
||||||
|
restart the server is a denial of service in one request.
|
||||||
|
responses:
|
||||||
|
"202":
|
||||||
|
description: The panel accepted, or was already restarting this container.
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
restarting: { type: boolean }
|
||||||
|
note: { type: string }
|
||||||
|
"403": { $ref: "#/components/responses/Forbidden" }
|
||||||
|
"502":
|
||||||
|
description: |
|
||||||
|
The panel refused. Usually a token without control of this server.
|
||||||
|
"503":
|
||||||
|
description: The three settings are not all present.
|
||||||
|
|
||||||
|
/api/v1/errors:
|
||||||
|
get:
|
||||||
|
tags: [auth]
|
||||||
|
summary: What has gone wrong lately. Administrators only.
|
||||||
|
description: |
|
||||||
|
Every 500 the API has answered, newest first, with what the handler was
|
||||||
|
attempting and the error it hit.
|
||||||
|
|
||||||
|
These are written to the database rather than only to the log because the
|
||||||
|
log does not survive. On a Rune the log belongs to the container, and the
|
||||||
|
container is replaced on every restart — so a panel watcher reports "HTTP
|
||||||
|
5xx, twice, at 11:49" long after the line explaining it has gone, which
|
||||||
|
tells an operator that something broke and gives them no way to find out
|
||||||
|
what.
|
||||||
|
|
||||||
|
Kept for thirty days by the nightly sweep: long enough to answer "what
|
||||||
|
happened last week", short enough that a fault loop cannot fill the volume
|
||||||
|
the tasks live on.
|
||||||
|
parameters:
|
||||||
|
- { name: limit, in: query, schema: { type: integer, default: 100, maximum: 500 } }
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: OK
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
errors:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
id: { type: string }
|
||||||
|
at: { type: string, format: date-time }
|
||||||
|
method: { type: string }
|
||||||
|
path: { type: string }
|
||||||
|
status: { type: integer }
|
||||||
|
what:
|
||||||
|
type: string
|
||||||
|
description: What the handler was attempting, in its own words.
|
||||||
|
example: list projects
|
||||||
|
message: { type: string }
|
||||||
|
user_name:
|
||||||
|
type: string
|
||||||
|
description: |
|
||||||
|
Who was asking, when there was somebody. A fault only
|
||||||
|
one account hits is a different problem from one
|
||||||
|
everybody hits.
|
||||||
|
request_id:
|
||||||
|
type: string
|
||||||
|
description: Ties the row back to the log line, for whoever still has it.
|
||||||
|
"403": { $ref: "#/components/responses/Forbidden" }
|
||||||
|
|
||||||
/api/v1/users:
|
/api/v1/users:
|
||||||
get:
|
get:
|
||||||
tags: [auth]
|
tags: [auth]
|
||||||
@@ -958,11 +1554,12 @@ paths:
|
|||||||
The only hard delete in this API. Everything else is soft-deleted with a
|
The only hard delete in this API. Everything else is soft-deleted with a
|
||||||
trash behind it; this is not recoverable.
|
trash behind it; this is not recoverable.
|
||||||
|
|
||||||
What goes is wider than it looks: their projects, every task in those
|
What goes: their projects, and every task in those projects.
|
||||||
projects, **and every task they wrote anywhere** — `tasks.created_by`
|
|
||||||
cascades, so retiring a colleague's account removes their contributions
|
What stays: everything they wrote in **somebody else's** project.
|
||||||
from shared projects too. Tasks merely assigned to them are unassigned
|
`tasks.created_by` is `ON DELETE SET NULL`, so that work survives and
|
||||||
and survive.
|
loses its author rather than disappearing with the account. Tasks merely
|
||||||
|
assigned to them are unassigned and survive by the same rule.
|
||||||
|
|
||||||
Refused for your own account, and for the last administrator.
|
Refused for your own account, and for the last administrator.
|
||||||
responses:
|
responses:
|
||||||
@@ -1046,6 +1643,37 @@ paths:
|
|||||||
/api/v1/project-groups/{groupID}:
|
/api/v1/project-groups/{groupID}:
|
||||||
parameters:
|
parameters:
|
||||||
- { name: groupID, in: path, required: true, schema: { type: string } }
|
- { name: groupID, in: path, required: true, schema: { type: string } }
|
||||||
|
get:
|
||||||
|
tags: [projects]
|
||||||
|
summary: The group as a place, with what is in it.
|
||||||
|
description: |
|
||||||
|
A heading can carry a name. A page carries what the group *is*: the
|
||||||
|
sentence saying why these projects are one body of work, the documents
|
||||||
|
that belong to all of them rather than to any one, and the projects
|
||||||
|
themselves.
|
||||||
|
|
||||||
|
The projects come with the group rather than being fetched per row — the
|
||||||
|
page is nothing without them, and two round trips to draw one list is one
|
||||||
|
too many.
|
||||||
|
|
||||||
|
A group that is not yours is not found. That is the rule for every route
|
||||||
|
here, and it is enforced by the lookup rather than by a separate check.
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: OK
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
group: { $ref: "#/components/schemas/ProjectGroup" }
|
||||||
|
projects:
|
||||||
|
type: array
|
||||||
|
items: { $ref: "#/components/schemas/Project" }
|
||||||
|
attachments:
|
||||||
|
type: array
|
||||||
|
items: { $ref: "#/components/schemas/Attachment" }
|
||||||
|
"404": { $ref: "#/components/responses/NotFound" }
|
||||||
patch:
|
patch:
|
||||||
tags: [projects]
|
tags: [projects]
|
||||||
summary: Rename a group, or fold it.
|
summary: Rename a group, or fold it.
|
||||||
@@ -1073,6 +1701,41 @@ paths:
|
|||||||
"204": { description: Deleted. }
|
"204": { description: Deleted. }
|
||||||
"404": { $ref: "#/components/responses/NotFound" }
|
"404": { $ref: "#/components/responses/NotFound" }
|
||||||
|
|
||||||
|
/api/v1/project-groups/{groupID}/attachments:
|
||||||
|
parameters:
|
||||||
|
- { name: groupID, in: path, required: true, schema: { type: string } }
|
||||||
|
post:
|
||||||
|
tags: [projects]
|
||||||
|
summary: Put a document on the group itself.
|
||||||
|
description: |
|
||||||
|
A file that belongs to the whole group rather than to any one task in it —
|
||||||
|
the contract that governs all of "Arbejde", not a step in it.
|
||||||
|
|
||||||
|
The same storage as every other attachment: content-addressed by hash, so
|
||||||
|
the path never contains anything the uploader chose, and the same file
|
||||||
|
uploaded twice is stored once. 25 MB maximum.
|
||||||
|
|
||||||
|
Downloading and deleting go through `/attachments/{attachmentID}` like any
|
||||||
|
other. A group's attachment is reachable by its owner and nobody else,
|
||||||
|
because a group belongs to one person and is never shared.
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
multipart/form-data:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
file: { type: string, format: binary }
|
||||||
|
responses:
|
||||||
|
"201":
|
||||||
|
description: Stored.
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema: { $ref: "#/components/schemas/Attachment" }
|
||||||
|
"404": { $ref: "#/components/responses/NotFound" }
|
||||||
|
"413": { $ref: "#/components/responses/TooLarge" }
|
||||||
|
"422": { $ref: "#/components/responses/Validation" }
|
||||||
|
|
||||||
/api/v1/trash/projects:
|
/api/v1/trash/projects:
|
||||||
get:
|
get:
|
||||||
tags: [projects]
|
tags: [projects]
|
||||||
@@ -1211,9 +1874,46 @@ paths:
|
|||||||
parameters:
|
parameters:
|
||||||
- { name: projectID, in: path, required: true, schema: { type: string } }
|
- { name: projectID, in: path, required: true, schema: { type: string } }
|
||||||
- { name: userID, in: path, required: true, schema: { type: string } }
|
- { name: userID, in: path, required: true, schema: { type: string } }
|
||||||
|
patch:
|
||||||
|
tags: [projects]
|
||||||
|
summary: Change what an existing member may do. The project's owner only.
|
||||||
|
description: |
|
||||||
|
Editor or viewer. An UPDATE against a membership that already exists —
|
||||||
|
somebody who is not a member is not silently made one, because that is an
|
||||||
|
invite and belongs to the invite flow.
|
||||||
|
|
||||||
|
Not the owner: ownership is transferred, not granted, and two owners is a
|
||||||
|
state with no way to settle a disagreement about who may remove whom. The
|
||||||
|
owner also has no membership row at all — ownership lives on the project —
|
||||||
|
so this answers 409 with the real reason rather than "not a member".
|
||||||
|
|
||||||
|
Correcting a role used to mean removing the person and inviting them
|
||||||
|
again, which also unassigns every task they were responsible for.
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
required: [role]
|
||||||
|
properties:
|
||||||
|
role: { type: string, enum: [editor, viewer] }
|
||||||
|
responses:
|
||||||
|
"204": { description: Changed. }
|
||||||
|
"404": { $ref: "#/components/responses/NotFound" }
|
||||||
|
"409":
|
||||||
|
description: The owner's standing cannot be changed.
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema: { $ref: "#/components/schemas/Error" }
|
||||||
|
"422": { $ref: "#/components/responses/Validation" }
|
||||||
delete:
|
delete:
|
||||||
tags: [projects]
|
tags: [projects]
|
||||||
summary: Remove somebody from a project. Its owner only.
|
summary: Remove somebody from a project. Its owner only.
|
||||||
|
description: |
|
||||||
|
Their tasks are unassigned rather than left pointing at somebody who can
|
||||||
|
no longer see the project — which is why changing a role is a PATCH and
|
||||||
|
not a remove-and-reinvite.
|
||||||
responses:
|
responses:
|
||||||
"204": { description: Removed. }
|
"204": { description: Removed. }
|
||||||
"404": { $ref: "#/components/responses/NotFound" }
|
"404": { $ref: "#/components/responses/NotFound" }
|
||||||
@@ -1315,6 +2015,36 @@ paths:
|
|||||||
type: array
|
type: array
|
||||||
items: { $ref: "#/components/schemas/Task" }
|
items: { $ref: "#/components/schemas/Task" }
|
||||||
|
|
||||||
|
/api/v1/people:
|
||||||
|
get:
|
||||||
|
tags: [views]
|
||||||
|
summary: Everybody you share a project with, and yourself.
|
||||||
|
description: |
|
||||||
|
What an interface needs to put a name and a face on an `assignee_id` — in
|
||||||
|
a task row, in a filter, anywhere a person appears beside work. One
|
||||||
|
request per session rather than a lookup per row, and per project members
|
||||||
|
would mean knowing which project every task belongs to first.
|
||||||
|
|
||||||
|
Deliberately not the instance's user list: that is
|
||||||
|
`/users`, administrators only. A task list has no business enumerating
|
||||||
|
everybody with an account here.
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: OK
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
people:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
id: { type: string }
|
||||||
|
name: { type: string }
|
||||||
|
avatar_color: { type: string }
|
||||||
|
|
||||||
/api/v1/delegated:
|
/api/v1/delegated:
|
||||||
get:
|
get:
|
||||||
tags: [views]
|
tags: [views]
|
||||||
@@ -2395,6 +3125,14 @@ components:
|
|||||||
locale: { type: string, enum: [da, en] }
|
locale: { type: string, enum: [da, en] }
|
||||||
is_admin: { type: boolean }
|
is_admin: { type: boolean }
|
||||||
totp_enabled: { type: boolean }
|
totp_enabled: { type: boolean }
|
||||||
|
sidebar_collapsed:
|
||||||
|
type: array
|
||||||
|
items: { type: string }
|
||||||
|
description: |
|
||||||
|
The sidebar headings this person has folded away. Always an array,
|
||||||
|
never null: a client that has to check for both an absent array and an
|
||||||
|
empty one will one day check for only one of them.
|
||||||
|
example: ["labels"]
|
||||||
created_at: { type: string, format: date-time }
|
created_at: { type: string, format: date-time }
|
||||||
|
|
||||||
RecoveryCodes:
|
RecoveryCodes:
|
||||||
@@ -2429,9 +3167,60 @@ components:
|
|||||||
task_count:
|
task_count:
|
||||||
type: integer
|
type: integer
|
||||||
description: |
|
description: |
|
||||||
Everything a delete would destroy: tasks in projects they own, plus
|
What a delete would destroy: the tasks in the projects they own,
|
||||||
every task they wrote anywhere. Not the same as "their tasks", and
|
which go with those projects.
|
||||||
the difference is the whole point of showing it.
|
authored_elsewhere:
|
||||||
|
type: integer
|
||||||
|
description: |
|
||||||
|
What a delete would leave behind: tasks they wrote in projects other
|
||||||
|
people own. Those survive without an author. A separate number from
|
||||||
|
`task_count` because it is a separate sentence — one is what
|
||||||
|
disappears, the other is what stays unattributed.
|
||||||
|
|
||||||
|
GmailClient:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
client_id: { type: string }
|
||||||
|
has_secret:
|
||||||
|
type: boolean
|
||||||
|
description: Whether a secret is stored. The secret itself is never sent back.
|
||||||
|
from_env:
|
||||||
|
type: boolean
|
||||||
|
description: |
|
||||||
|
The deployment set this, so the stored pair is ignored and the fields
|
||||||
|
are not worth editing.
|
||||||
|
redirect_uri:
|
||||||
|
type: string
|
||||||
|
description: |
|
||||||
|
What has to be registered with Google, spelled out. Derived from
|
||||||
|
`VERDANDE_BASE_URL` and matched exactly — it is the single most likely
|
||||||
|
thing to be wrong, and the error Google returns for it names neither
|
||||||
|
value. Google rejects private IP addresses over http, so a LAN address
|
||||||
|
will not do: it has to be https, or `http://localhost`.
|
||||||
|
example: https://verdande.example.com/oauth/gmail/callback
|
||||||
|
|
||||||
|
BackupRun:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
id: { type: string }
|
||||||
|
started_at: { type: string, format: date-time }
|
||||||
|
finished_at:
|
||||||
|
type: string
|
||||||
|
format: date-time
|
||||||
|
description: |
|
||||||
|
Absent while a run is still going, and on one the process died in the
|
||||||
|
middle of — which is the same shape from outside, and honestly so: a
|
||||||
|
run that was interrupted never finished.
|
||||||
|
size_bytes: { type: integer }
|
||||||
|
error:
|
||||||
|
type: string
|
||||||
|
description: Present only on a run that failed, in the words it failed with.
|
||||||
|
present:
|
||||||
|
type: boolean
|
||||||
|
description: |
|
||||||
|
Whether the file is still on disk. Rotation keeps the most recent
|
||||||
|
fourteen, so an older row is a record with nothing behind it and its
|
||||||
|
download answers 404.
|
||||||
|
|
||||||
PendingInvite:
|
PendingInvite:
|
||||||
type: object
|
type: object
|
||||||
@@ -2488,7 +3277,12 @@ components:
|
|||||||
items: { type: string }
|
items: { type: string }
|
||||||
completed: { type: boolean }
|
completed: { type: boolean }
|
||||||
completed_at: { type: string, format: date-time }
|
completed_at: { type: string, format: date-time }
|
||||||
created_by: { type: string }
|
created_by:
|
||||||
|
type: string
|
||||||
|
description: |
|
||||||
|
Empty when the author's account has been deleted. The task outlives
|
||||||
|
the person who wrote it.
|
||||||
|
|
||||||
sort_order: { type: number }
|
sort_order: { type: number }
|
||||||
created_at: { type: string, format: date-time }
|
created_at: { type: string, format: date-time }
|
||||||
updated_at: { type: string, format: date-time }
|
updated_at: { type: string, format: date-time }
|
||||||
@@ -2549,7 +3343,7 @@ components:
|
|||||||
properties:
|
properties:
|
||||||
id: { type: string }
|
id: { type: string }
|
||||||
name: { type: string }
|
name: { type: string }
|
||||||
color: { type: string }
|
color: { $ref: "#/components/schemas/Color" }
|
||||||
icon: { type: string }
|
icon: { type: string }
|
||||||
view_mode: { type: string, enum: [list, board, calendar] }
|
view_mode: { type: string, enum: [list, board, calendar] }
|
||||||
owner_id: { type: string }
|
owner_id: { type: string }
|
||||||
@@ -2570,7 +3364,7 @@ components:
|
|||||||
type: object
|
type: object
|
||||||
properties:
|
properties:
|
||||||
name: { type: string }
|
name: { type: string }
|
||||||
color: { type: string }
|
color: { $ref: "#/components/schemas/Color" }
|
||||||
icon: { type: string }
|
icon: { type: string }
|
||||||
view_mode: { type: string, enum: [list, board, calendar] }
|
view_mode: { type: string, enum: [list, board, calendar] }
|
||||||
archived: { type: boolean }
|
archived: { type: boolean }
|
||||||
@@ -2583,11 +3377,44 @@ components:
|
|||||||
same thing once decoded, and telling "put it nowhere" apart from "I
|
same thing once decoded, and telling "put it nowhere" apart from "I
|
||||||
did not mention it" is what makes this a PATCH.
|
did not mention it" is what makes this a PATCH.
|
||||||
|
|
||||||
|
Passkey:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
id: { type: string }
|
||||||
|
name:
|
||||||
|
type: string
|
||||||
|
description: What the owner called it. "min bærbare" is what makes a list reviewable.
|
||||||
|
aaguid:
|
||||||
|
type: string
|
||||||
|
description: |
|
||||||
|
Identifies the authenticator model, which is what lets a list say
|
||||||
|
something recognisable beside a key somebody named months ago.
|
||||||
|
discoverable:
|
||||||
|
type: boolean
|
||||||
|
description: |
|
||||||
|
Whether the credential lives on the device. Only these can start a login
|
||||||
|
with no email typed first.
|
||||||
|
user_verified:
|
||||||
|
type: boolean
|
||||||
|
description: |
|
||||||
|
Whether the authenticator verified the person — a PIN, a fingerprint, a
|
||||||
|
face. One that did is both factors at once; one that only proved
|
||||||
|
possession is a first factor and still meets the TOTP step.
|
||||||
|
created_at: { type: string, format: date-time }
|
||||||
|
last_used_at: { type: string, format: date-time }
|
||||||
|
|
||||||
ProjectGroup:
|
ProjectGroup:
|
||||||
type: object
|
type: object
|
||||||
properties:
|
properties:
|
||||||
id: { type: string }
|
id: { type: string }
|
||||||
name: { type: string }
|
name: { type: string }
|
||||||
|
color: { $ref: "#/components/schemas/Color" }
|
||||||
|
description:
|
||||||
|
type: string
|
||||||
|
description: |
|
||||||
|
What the group is, in the owner's words. A heading carries a name; a
|
||||||
|
page carries the sentence that says why these projects are one body of
|
||||||
|
work. Empty until somebody writes one.
|
||||||
collapsed: { type: boolean }
|
collapsed: { type: boolean }
|
||||||
sort_order: { type: number }
|
sort_order: { type: number }
|
||||||
|
|
||||||
@@ -2595,8 +3422,30 @@ components:
|
|||||||
type: object
|
type: object
|
||||||
properties:
|
properties:
|
||||||
name: { type: string }
|
name: { type: string }
|
||||||
|
color: { $ref: "#/components/schemas/Color" }
|
||||||
|
description:
|
||||||
|
type: string
|
||||||
|
maxLength: 4000
|
||||||
|
description: What the group is, in the owner's words.
|
||||||
collapsed: { type: boolean }
|
collapsed: { type: boolean }
|
||||||
|
|
||||||
|
Color:
|
||||||
|
type: string
|
||||||
|
default: graphite
|
||||||
|
enum: [graphite, tomato, amber, lime, green, teal, blue, indigo, violet, magenta]
|
||||||
|
description: |
|
||||||
|
A name, not a hex value. The interface resolves it when it paints, so the
|
||||||
|
palette can be retuned for a new theme or a new display without rewriting
|
||||||
|
every row — and a database that stores a fact rather than a rendering.
|
||||||
|
|
||||||
|
The set is closed: an unknown name is refused rather than stored and
|
||||||
|
painted as the default, which would look like a colour that did not save.
|
||||||
|
|
||||||
|
One palette for all five themes. These are small solid marks beside a
|
||||||
|
label that carries the meaning, not text or grounds, so what they owe is
|
||||||
|
to be told apart and to be visible on both a near-black and a white
|
||||||
|
ground — which is why they all sit in the mid-tone band.
|
||||||
|
|
||||||
Section:
|
Section:
|
||||||
type: object
|
type: object
|
||||||
properties:
|
properties:
|
||||||
|
|||||||
|
After Width: | Height: | Size: 166 KiB |
|
Before Width: | Height: | Size: 56 KiB After Width: | Height: | Size: 181 KiB |
|
After Width: | Height: | Size: 91 KiB |
|
After Width: | Height: | Size: 228 KiB |
|
After Width: | Height: | Size: 243 KiB |
|
After Width: | Height: | Size: 176 KiB |
|
After Width: | Height: | Size: 230 KiB |
|
After Width: | Height: | Size: 199 KiB |
|
Before Width: | Height: | Size: 42 KiB After Width: | Height: | Size: 154 KiB |
|
Before Width: | Height: | Size: 42 KiB After Width: | Height: | Size: 153 KiB |
|
Before Width: | Height: | Size: 58 KiB After Width: | Height: | Size: 188 KiB |
|
After Width: | Height: | Size: 167 KiB |
@@ -3,21 +3,30 @@ module github.com/kristianwind/verdande
|
|||||||
go 1.26.3
|
go 1.26.3
|
||||||
|
|
||||||
require (
|
require (
|
||||||
|
github.com/coder/websocket v1.8.15
|
||||||
github.com/go-chi/chi/v5 v5.3.1
|
github.com/go-chi/chi/v5 v5.3.1
|
||||||
|
github.com/go-webauthn/webauthn v0.17.4
|
||||||
github.com/pquerna/otp v1.5.0
|
github.com/pquerna/otp v1.5.0
|
||||||
|
github.com/teambition/rrule-go v1.8.2
|
||||||
golang.org/x/crypto v0.55.0
|
golang.org/x/crypto v0.55.0
|
||||||
modernc.org/sqlite v1.56.0
|
modernc.org/sqlite v1.56.0
|
||||||
)
|
)
|
||||||
|
|
||||||
require (
|
require (
|
||||||
github.com/boombuler/barcode v1.0.1-0.20190219062509-6c824513bacc // indirect
|
github.com/boombuler/barcode v1.0.1-0.20190219062509-6c824513bacc // indirect
|
||||||
github.com/coder/websocket v1.8.15 // indirect
|
|
||||||
github.com/dustin/go-humanize v1.0.1 // indirect
|
github.com/dustin/go-humanize v1.0.1 // indirect
|
||||||
|
github.com/fxamacker/cbor/v2 v2.9.2 // indirect
|
||||||
|
github.com/go-viper/mapstructure/v2 v2.5.0 // indirect
|
||||||
|
github.com/go-webauthn/x v0.2.6 // indirect
|
||||||
|
github.com/golang-jwt/jwt/v5 v5.3.1 // indirect
|
||||||
|
github.com/google/go-tpm v0.9.8 // indirect
|
||||||
github.com/google/uuid v1.6.0 // indirect
|
github.com/google/uuid v1.6.0 // indirect
|
||||||
github.com/mattn/go-isatty v0.0.24 // indirect
|
github.com/mattn/go-isatty v0.0.24 // indirect
|
||||||
github.com/ncruces/go-strftime v1.0.0 // indirect
|
github.com/ncruces/go-strftime v1.0.0 // indirect
|
||||||
|
github.com/philhofer/fwd v1.2.0 // indirect
|
||||||
github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect
|
github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect
|
||||||
github.com/teambition/rrule-go v1.8.2 // indirect
|
github.com/tinylib/msgp v1.6.4 // indirect
|
||||||
|
github.com/x448/float16 v0.8.4 // indirect
|
||||||
golang.org/x/sys v0.47.0 // indirect
|
golang.org/x/sys v0.47.0 // indirect
|
||||||
modernc.org/libc v1.74.4 // indirect
|
modernc.org/libc v1.74.4 // indirect
|
||||||
modernc.org/mathutil v1.7.1 // indirect
|
modernc.org/mathutil v1.7.1 // indirect
|
||||||
|
|||||||
@@ -2,12 +2,27 @@ github.com/boombuler/barcode v1.0.1-0.20190219062509-6c824513bacc h1:biVzkmvwrH8
|
|||||||
github.com/boombuler/barcode v1.0.1-0.20190219062509-6c824513bacc/go.mod h1:paBWMcWSl3LHKBqUq+rly7CNSldXjb2rDl3JlRe0mD8=
|
github.com/boombuler/barcode v1.0.1-0.20190219062509-6c824513bacc/go.mod h1:paBWMcWSl3LHKBqUq+rly7CNSldXjb2rDl3JlRe0mD8=
|
||||||
github.com/coder/websocket v1.8.15 h1:6B2JPeOGlpff2Uz6vOEH1Vzpi0iUz20A+lPVhPHtNUA=
|
github.com/coder/websocket v1.8.15 h1:6B2JPeOGlpff2Uz6vOEH1Vzpi0iUz20A+lPVhPHtNUA=
|
||||||
github.com/coder/websocket v1.8.15/go.mod h1:NX3SzP+inril6yawo5CQXx8+fk145lPDC6pumgx0mVg=
|
github.com/coder/websocket v1.8.15/go.mod h1:NX3SzP+inril6yawo5CQXx8+fk145lPDC6pumgx0mVg=
|
||||||
github.com/davecgh/go-spew v1.1.0 h1:ZDRjVQ15GmhC3fiQ8ni8+OwkZQO4DARzQgrnXU1Liz8=
|
|
||||||
github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
|
github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
|
||||||
|
github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
|
||||||
|
github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
|
||||||
github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY=
|
github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY=
|
||||||
github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto=
|
github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto=
|
||||||
|
github.com/fxamacker/cbor/v2 v2.9.2 h1:X4Ksno9+x3cz0TZv69ec1hxP/+tymuR8PXQJyDwfh78=
|
||||||
|
github.com/fxamacker/cbor/v2 v2.9.2/go.mod h1:vM4b+DJCtHn+zz7h3FFp/hDAI9WNWCsZj23V5ytsSxQ=
|
||||||
github.com/go-chi/chi/v5 v5.3.1 h1:3j4HZLGZQ3JpMCrPJF/Jl3mYJfWLKBfNJ6quurUGCf8=
|
github.com/go-chi/chi/v5 v5.3.1 h1:3j4HZLGZQ3JpMCrPJF/Jl3mYJfWLKBfNJ6quurUGCf8=
|
||||||
github.com/go-chi/chi/v5 v5.3.1/go.mod h1:R+tYY2hNuVUUjxoPtqUdgBqevM9s9njzkTLutVsOCto=
|
github.com/go-chi/chi/v5 v5.3.1/go.mod h1:R+tYY2hNuVUUjxoPtqUdgBqevM9s9njzkTLutVsOCto=
|
||||||
|
github.com/go-viper/mapstructure/v2 v2.5.0 h1:vM5IJoUAy3d7zRSVtIwQgBj7BiWtMPfmPEgAXnvj1Ro=
|
||||||
|
github.com/go-viper/mapstructure/v2 v2.5.0/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM=
|
||||||
|
github.com/go-webauthn/webauthn v0.17.4 h1:KFTSz3R2RYDiUn/0cDi3XTJgFenSG74eKTTHlqWhlxk=
|
||||||
|
github.com/go-webauthn/webauthn v0.17.4/go.mod h1:pZk63EE/BdztlmyS4Yc+9H5g4a8blNlbtGmdHQHbZX8=
|
||||||
|
github.com/go-webauthn/x v0.2.6 h1:TEyDuQAIiEgYpx60nKiBJIX/5nSUC8LxNbH+uf5U9uk=
|
||||||
|
github.com/go-webauthn/x v0.2.6/go.mod h1:45bA7YEqyQhRcQJ/TiBb46Ww8yqHBGvgEhQ3WWF0aDo=
|
||||||
|
github.com/golang-jwt/jwt/v5 v5.3.1 h1:kYf81DTWFe7t+1VvL7eS+jKFVWaUnK9cB1qbwn63YCY=
|
||||||
|
github.com/golang-jwt/jwt/v5 v5.3.1/go.mod h1:fxCRLWMO43lRc8nhHWY6LGqRcf+1gQWArsqaEUEa5bE=
|
||||||
|
github.com/google/go-tpm v0.9.8 h1:slArAR9Ft+1ybZu0lBwpSmpwhRXaa85hWtMinMyRAWo=
|
||||||
|
github.com/google/go-tpm v0.9.8/go.mod h1:h9jEsEECg7gtLis0upRBQU+GhYVH6jMjrFxI8u6bVUY=
|
||||||
|
github.com/google/go-tpm-tools v0.3.13-0.20230620182252-4639ecce2aba h1:qJEJcuLzH5KDR0gKc0zcktin6KSAwL7+jWKBYceddTc=
|
||||||
|
github.com/google/go-tpm-tools v0.3.13-0.20230620182252-4639ecce2aba/go.mod h1:EFYHy8/1y2KfgTAsx7Luu7NGhoxtuVHnNo8jE7FikKc=
|
||||||
github.com/google/pprof v0.0.0-20260802141513-ef3492d7dac3 h1:LMLX+LgTNWpfvCBdFebv6EsYotImrt/Ppc5cXIriCSo=
|
github.com/google/pprof v0.0.0-20260802141513-ef3492d7dac3 h1:LMLX+LgTNWpfvCBdFebv6EsYotImrt/Ppc5cXIriCSo=
|
||||||
github.com/google/pprof v0.0.0-20260802141513-ef3492d7dac3/go.mod h1:jl5iWTm0/hd5PjEYEOuwAJ57L/CibdZfrqZ5XA5GrCk=
|
github.com/google/pprof v0.0.0-20260802141513-ef3492d7dac3/go.mod h1:jl5iWTm0/hd5PjEYEOuwAJ57L/CibdZfrqZ5XA5GrCk=
|
||||||
github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
|
github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
|
||||||
@@ -18,6 +33,8 @@ github.com/mattn/go-isatty v0.0.24 h1:tGZZoVgT/KiqK1c8ocVLeDS8BSWMRd47J3Lbz7vsRe
|
|||||||
github.com/mattn/go-isatty v0.0.24/go.mod h1:nMCL3Zebbrt45jsMDgnfIwz6ydEQApk5oEI3HqDio6A=
|
github.com/mattn/go-isatty v0.0.24/go.mod h1:nMCL3Zebbrt45jsMDgnfIwz6ydEQApk5oEI3HqDio6A=
|
||||||
github.com/ncruces/go-strftime v1.0.0 h1:HMFp8mLCTPp341M/ZnA4qaf7ZlsbTc+miZjCLOFAw7w=
|
github.com/ncruces/go-strftime v1.0.0 h1:HMFp8mLCTPp341M/ZnA4qaf7ZlsbTc+miZjCLOFAw7w=
|
||||||
github.com/ncruces/go-strftime v1.0.0/go.mod h1:Fwc5htZGVVkseilnfgOVb9mKy6w1naJmn9CehxcKcls=
|
github.com/ncruces/go-strftime v1.0.0/go.mod h1:Fwc5htZGVVkseilnfgOVb9mKy6w1naJmn9CehxcKcls=
|
||||||
|
github.com/philhofer/fwd v1.2.0 h1:e6DnBTl7vGY+Gz322/ASL4Gyp1FspeMvx1RNDoToZuM=
|
||||||
|
github.com/philhofer/fwd v1.2.0/go.mod h1:RqIHx9QI14HlwKwm98g9Re5prTQ6LdeRQn+gXJFxsJM=
|
||||||
github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
|
github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
|
||||||
github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
|
github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
|
||||||
github.com/pquerna/otp v1.5.0 h1:NMMR+WrmaqXU4EzdGJEE1aUUI0AMRzsp96fFFWNPwxs=
|
github.com/pquerna/otp v1.5.0 h1:NMMR+WrmaqXU4EzdGJEE1aUUI0AMRzsp96fFFWNPwxs=
|
||||||
@@ -25,10 +42,17 @@ github.com/pquerna/otp v1.5.0/go.mod h1:dkJfzwRKNiegxyNb54X/3fLwhCynbMspSyWKnvi1
|
|||||||
github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE=
|
github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE=
|
||||||
github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo=
|
github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo=
|
||||||
github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
|
github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
|
||||||
github.com/stretchr/testify v1.3.0 h1:TivCn/peBQ7UY8ooIcPgZFpTNSz0Q2U6UrFlUfqbe0Q=
|
|
||||||
github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
|
github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
|
||||||
|
github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
|
||||||
|
github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
|
||||||
github.com/teambition/rrule-go v1.8.2 h1:lIjpjvWTj9fFUZCmuoVDrKVOtdiyzbzc93qTmRVe/J8=
|
github.com/teambition/rrule-go v1.8.2 h1:lIjpjvWTj9fFUZCmuoVDrKVOtdiyzbzc93qTmRVe/J8=
|
||||||
github.com/teambition/rrule-go v1.8.2/go.mod h1:Ieq5AbrKGciP1V//Wq8ktsTXwSwJHDD5mD/wLBGl3p4=
|
github.com/teambition/rrule-go v1.8.2/go.mod h1:Ieq5AbrKGciP1V//Wq8ktsTXwSwJHDD5mD/wLBGl3p4=
|
||||||
|
github.com/tinylib/msgp v1.6.4 h1:mOwYbyYDLPj35mkA2BjjYejgJk9BuHxDdvRnb6v2ZcQ=
|
||||||
|
github.com/tinylib/msgp v1.6.4/go.mod h1:RSp0LW9oSxFut3KzESt5Voq4GVWyS+PSulT77roAqEA=
|
||||||
|
github.com/x448/float16 v0.8.4 h1:qLwI1I70+NjRFUR3zs1JPUCgaCXSh3SW62uAKT1mSBM=
|
||||||
|
github.com/x448/float16 v0.8.4/go.mod h1:14CWIYCyZA/cWjXOioeEpHeN/83MdbZDRQHoFcYsOfg=
|
||||||
|
go.uber.org/mock v0.6.0 h1:hyF9dfmbgIX5EfOdasqLsWD6xqpNZlXblLB/Dbnwv3Y=
|
||||||
|
go.uber.org/mock v0.6.0/go.mod h1:KiVJ4BqZJaMj4svdfmHM0AUx4NJYO8ZNpPnZn1Z+BBU=
|
||||||
golang.org/x/crypto v0.55.0 h1:+KWHjbgOaAQ66dh/YlkZKHlz9ZUlq61AFirAR9ntP8M=
|
golang.org/x/crypto v0.55.0 h1:+KWHjbgOaAQ66dh/YlkZKHlz9ZUlq61AFirAR9ntP8M=
|
||||||
golang.org/x/crypto v0.55.0/go.mod h1:uq0V9dE/fzQuJtbnL+2EhWOE63vo164FY8xqEnV9xis=
|
golang.org/x/crypto v0.55.0/go.mod h1:uq0V9dE/fzQuJtbnL+2EhWOE63vo164FY8xqEnV9xis=
|
||||||
golang.org/x/mod v0.37.0 h1:vF1DjpVEshcIqoEaauuHebaLk1O1forxjxBaVn884JQ=
|
golang.org/x/mod v0.37.0 h1:vF1DjpVEshcIqoEaauuHebaLk1O1forxjxBaVn884JQ=
|
||||||
@@ -39,6 +63,8 @@ golang.org/x/sys v0.47.0 h1:o7XGOvZQCADBQQ4Y7VNq2dRWQR7JmOUW8Kxx4ZsNgWs=
|
|||||||
golang.org/x/sys v0.47.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
|
golang.org/x/sys v0.47.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
|
||||||
golang.org/x/tools v0.47.0 h1:7Kn5x/d1svx/PzryTsqeoZN4TZwqeH5pGWjefhLi/1Q=
|
golang.org/x/tools v0.47.0 h1:7Kn5x/d1svx/PzryTsqeoZN4TZwqeH5pGWjefhLi/1Q=
|
||||||
golang.org/x/tools v0.47.0/go.mod h1:dFHnyTvFWY212G+h7ZY4Vsp/K3U4/7W9TyVaAul8uCA=
|
golang.org/x/tools v0.47.0/go.mod h1:dFHnyTvFWY212G+h7ZY4Vsp/K3U4/7W9TyVaAul8uCA=
|
||||||
|
gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
|
||||||
|
gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
|
||||||
modernc.org/cc/v4 v4.29.1 h1:MKgdCV3WykTSPqpVrnxdEDS0HEd2FHpKZDzxzU5LyeI=
|
modernc.org/cc/v4 v4.29.1 h1:MKgdCV3WykTSPqpVrnxdEDS0HEd2FHpKZDzxzU5LyeI=
|
||||||
modernc.org/cc/v4 v4.29.1/go.mod h1:OnovgIhbbMXMu1aISnJ0wvVD1KnW+cAUJkIrAWh+kVI=
|
modernc.org/cc/v4 v4.29.1/go.mod h1:OnovgIhbbMXMu1aISnJ0wvVD1KnW+cAUJkIrAWh+kVI=
|
||||||
modernc.org/ccgo/v4 v4.34.6 h1:sBgfIwyN0TQ9C5hwIeuqyeAKyMWnbvj2fvpF4L11uzU=
|
modernc.org/ccgo/v4 v4.34.6 h1:sBgfIwyN0TQ9C5hwIeuqyeAKyMWnbvj2fvpF4L11uzU=
|
||||||
|
|||||||
@@ -280,3 +280,33 @@ func codeAt(t *testing.T, secret string, now time.Time) string {
|
|||||||
}
|
}
|
||||||
return code
|
return code
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// The relying party is derived from the instance's own base URL, and the two ways
|
||||||
|
// that goes wrong are both silent until a browser refuses.
|
||||||
|
func TestPasskeysRefuseAnAddressNoBrowserWillAccept(t *testing.T) {
|
||||||
|
for _, c := range []struct {
|
||||||
|
base string
|
||||||
|
ok bool
|
||||||
|
why string
|
||||||
|
}{
|
||||||
|
{"https://verdande.example.dk", true, "a real domain"},
|
||||||
|
{"http://localhost:5173", true, "localhost, which every browser excepts"},
|
||||||
|
{"https://verdande.example.dk:8443", true, "a port is dropped from the RP ID"},
|
||||||
|
|
||||||
|
// An IP address is not a domain. The browser throws SecurityError long
|
||||||
|
// after the server has happily issued a challenge, so it is refused here
|
||||||
|
// and the endpoints answer 503 instead.
|
||||||
|
{"http://127.0.0.1:8080", false, "an IPv4 literal"},
|
||||||
|
{"http://[::1]:8080", false, "an IPv6 literal"},
|
||||||
|
{"", false, "no address at all"},
|
||||||
|
{"not a url", false, "not an address"},
|
||||||
|
} {
|
||||||
|
_, err := NewWebAuthn(c.base, "verdande")
|
||||||
|
if c.ok && err != nil {
|
||||||
|
t.Errorf("NewWebAuthn(%q) refused %s: %v", c.base, c.why, err)
|
||||||
|
}
|
||||||
|
if !c.ok && err == nil {
|
||||||
|
t.Errorf("NewWebAuthn(%q) accepted %s, which a browser will not", c.base, c.why)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
@@ -0,0 +1,98 @@
|
|||||||
|
package auth
|
||||||
|
|
||||||
|
import (
|
||||||
|
"encoding/base64"
|
||||||
|
"fmt"
|
||||||
|
"net"
|
||||||
|
"net/url"
|
||||||
|
"strings"
|
||||||
|
|
||||||
|
"github.com/go-webauthn/webauthn/webauthn"
|
||||||
|
)
|
||||||
|
|
||||||
|
// Passkeys, wrapped so the rest of the app never touches the protocol types.
|
||||||
|
//
|
||||||
|
// A password and a TOTP code are both shared secrets: the server keeps something
|
||||||
|
// that can be stolen from it, and the person keeps something that can be talked
|
||||||
|
// out of them. A passkey is neither. The private half never leaves the device, and
|
||||||
|
// the signature is bound to the origin that asked for it — so a convincing copy of
|
||||||
|
// the sign-in page at another address gets a signature it cannot use.
|
||||||
|
//
|
||||||
|
// That binding is also the one thing that can be got wrong here, and it is
|
||||||
|
// invisible when it is: the RP ID has to be the registrable domain of the address
|
||||||
|
// people actually visit. Get it wrong and registration works, login works on your
|
||||||
|
// machine, and everybody behind a different hostname is quietly locked out.
|
||||||
|
|
||||||
|
// WebAuthn is the relying party — this instance, as an authenticator sees it.
|
||||||
|
type WebAuthn struct{ *webauthn.WebAuthn }
|
||||||
|
|
||||||
|
// NewWebAuthn derives the relying party from the instance's own base URL.
|
||||||
|
//
|
||||||
|
// Derived rather than configured, because a second setting that has to agree with
|
||||||
|
// VERDANDE_BASE_URL is a second setting that will one day disagree with it — and
|
||||||
|
// the failure is a login that cannot be completed, reported as "the button does
|
||||||
|
// nothing".
|
||||||
|
func NewWebAuthn(baseURL, displayName string) (*WebAuthn, error) {
|
||||||
|
parsed, err := url.Parse(strings.TrimSpace(baseURL))
|
||||||
|
if err != nil || parsed.Host == "" {
|
||||||
|
return nil, fmt.Errorf("auth: %q is not a usable base URL for passkeys", baseURL)
|
||||||
|
}
|
||||||
|
|
||||||
|
// The RP ID is the host without the port. A port in it is rejected by every
|
||||||
|
// browser, and localhost:5173 during development is exactly where somebody
|
||||||
|
// would first put one.
|
||||||
|
rpID := parsed.Hostname()
|
||||||
|
|
||||||
|
// An IP address is not a domain, and no browser will accept one as an RP ID —
|
||||||
|
// `SecurityError: This is an invalid domain`, thrown in the browser, long after
|
||||||
|
// the server has happily issued a challenge. Refused here instead, so the
|
||||||
|
// endpoints answer 503 and the interface never offers a button that cannot
|
||||||
|
// work. `localhost` is the exception every browser makes, and it is what
|
||||||
|
// development runs on.
|
||||||
|
if ip := net.ParseIP(rpID); ip != nil {
|
||||||
|
return nil, fmt.Errorf(
|
||||||
|
"auth: passkeys need a domain name, and %q is an IP address — "+
|
||||||
|
"set VERDANDE_BASE_URL to the address people actually visit", rpID)
|
||||||
|
}
|
||||||
|
|
||||||
|
w, err := webauthn.New(&webauthn.Config{
|
||||||
|
RPID: rpID,
|
||||||
|
RPDisplayName: displayName,
|
||||||
|
// The origin is the full scheme://host:port, which is what the browser
|
||||||
|
// sends and what the signature is checked against.
|
||||||
|
RPOrigins: []string{strings.TrimSuffix(parsed.Scheme+"://"+parsed.Host, "/")},
|
||||||
|
})
|
||||||
|
if err != nil {
|
||||||
|
return nil, fmt.Errorf("auth: passkeys: %w", err)
|
||||||
|
}
|
||||||
|
return &WebAuthn{w}, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// A PasskeyUser is what the library needs to know about an account.
|
||||||
|
//
|
||||||
|
// The handle is the account id rather than anything a person chose. It is written
|
||||||
|
// into the credential on the device and cannot be changed afterwards, so it must
|
||||||
|
// not be an email address: changing your email would orphan every key you own.
|
||||||
|
type PasskeyUser struct {
|
||||||
|
ID string
|
||||||
|
Email string
|
||||||
|
Name string
|
||||||
|
Credentials []webauthn.Credential
|
||||||
|
}
|
||||||
|
|
||||||
|
func (u *PasskeyUser) WebAuthnID() []byte { return []byte(u.ID) }
|
||||||
|
func (u *PasskeyUser) WebAuthnName() string { return u.Email }
|
||||||
|
func (u *PasskeyUser) WebAuthnDisplayName() string { return u.Name }
|
||||||
|
func (u *PasskeyUser) WebAuthnCredentials() []webauthn.Credential { return u.Credentials }
|
||||||
|
|
||||||
|
// EncodeCredentialID renders a credential id for storage and for a URL. Raw bytes
|
||||||
|
// go in a BLOB well enough, but the id is also compared against what the browser
|
||||||
|
// sends back as base64url, and one encoding on both sides is one thing to be
|
||||||
|
// wrong about.
|
||||||
|
func EncodeCredentialID(raw []byte) string {
|
||||||
|
return base64.RawURLEncoding.EncodeToString(raw)
|
||||||
|
}
|
||||||
|
|
||||||
|
func DecodeCredentialID(encoded string) ([]byte, error) {
|
||||||
|
return base64.RawURLEncoding.DecodeString(encoded)
|
||||||
|
}
|
||||||
@@ -38,6 +38,22 @@ type Config struct {
|
|||||||
// the deal its operator made by self-hosting.
|
// the deal its operator made by self-hosting.
|
||||||
UpdateCheck bool
|
UpdateCheck bool
|
||||||
|
|
||||||
|
// The Yggdrasil panel this instance runs under, so it can ask to be restarted
|
||||||
|
// from its own interface rather than from another browser tab.
|
||||||
|
//
|
||||||
|
// A container cannot replace its own image from the inside. Restarting is the
|
||||||
|
// panel's job — it recreates the container and pulls `:latest` on the way — so
|
||||||
|
// what this needs is a way to ask. All three are required together; any one
|
||||||
|
// alone cannot do anything.
|
||||||
|
//
|
||||||
|
// The token is a panel credential with control over that server. Anybody who
|
||||||
|
// can read this environment can restart it, which is true of anybody with the
|
||||||
|
// host anyway. It is never sent to a browser: the settings page is told only
|
||||||
|
// whether it is set.
|
||||||
|
PanelURL string
|
||||||
|
PanelToken string
|
||||||
|
PanelServerID string
|
||||||
|
|
||||||
// TrashRetention is how long a soft-deleted task or project stays recoverable.
|
// TrashRetention is how long a soft-deleted task or project stays recoverable.
|
||||||
TrashRetention time.Duration
|
TrashRetention time.Duration
|
||||||
|
|
||||||
@@ -69,6 +85,9 @@ func Load() (*Config, error) {
|
|||||||
Dev: envBool("VERDANDE_DEV", false),
|
Dev: envBool("VERDANDE_DEV", false),
|
||||||
|
|
||||||
GmailClientID: env("VERDANDE_GMAIL_CLIENT_ID", ""),
|
GmailClientID: env("VERDANDE_GMAIL_CLIENT_ID", ""),
|
||||||
|
PanelURL: strings.TrimSuffix(env("VERDANDE_PANEL_URL", ""), "/"),
|
||||||
|
PanelToken: env("VERDANDE_PANEL_TOKEN", ""),
|
||||||
|
PanelServerID: env("VERDANDE_PANEL_SERVER_ID", ""),
|
||||||
GmailClientSecret: env("VERDANDE_GMAIL_CLIENT_SECRET", ""),
|
GmailClientSecret: env("VERDANDE_GMAIL_CLIENT_SECRET", ""),
|
||||||
UpdateCheck: envBool("VERDANDE_UPDATE_CHECK", false),
|
UpdateCheck: envBool("VERDANDE_UPDATE_CHECK", false),
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,111 @@
|
|||||||
|
package httpapi
|
||||||
|
|
||||||
|
import (
|
||||||
|
"net/http"
|
||||||
|
"strconv"
|
||||||
|
"strings"
|
||||||
|
"time"
|
||||||
|
|
||||||
|
"github.com/kristianwind/verdande/internal/store"
|
||||||
|
)
|
||||||
|
|
||||||
|
// What has happened on this server, across every project.
|
||||||
|
//
|
||||||
|
// The per-project history under /projects/{id}/activity is the same rows read by
|
||||||
|
// the people who work in that project. This is the administrator's version of the
|
||||||
|
// question, and it is a different one: an administrator is not necessarily a member
|
||||||
|
// of the project they need to look into, and "which account did that" cannot be
|
||||||
|
// asked one project at a time.
|
||||||
|
//
|
||||||
|
// It sits beside the error log for a reason. That one is the half about what broke;
|
||||||
|
// this is the half about what was done, and an instance had only ever had the first.
|
||||||
|
|
||||||
|
type auditEntryJSON struct {
|
||||||
|
ID string `json:"id"`
|
||||||
|
At string `json:"at"`
|
||||||
|
ProjectID string `json:"project_id"`
|
||||||
|
ProjectName string `json:"project_name"`
|
||||||
|
TaskID string `json:"task_id,omitempty"`
|
||||||
|
// UserID and UserName are absent when the account has been deleted. The row
|
||||||
|
// stays — an audit log that lost its rows when somebody left would be missing
|
||||||
|
// exactly the part worth keeping.
|
||||||
|
UserID string `json:"user_id,omitempty"`
|
||||||
|
UserName string `json:"user_name,omitempty"`
|
||||||
|
Event string `json:"event"`
|
||||||
|
Payload map[string]any `json:"payload,omitempty"`
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) handleAuditLog(w http.ResponseWriter, r *http.Request) {
|
||||||
|
q := r.URL.Query()
|
||||||
|
f := store.AuditFilter{
|
||||||
|
UserID: q.Get("user_id"),
|
||||||
|
ProjectID: q.Get("project_id"),
|
||||||
|
Event: q.Get("event"),
|
||||||
|
Limit: parseLimit(q.Get("limit"), 100, 500),
|
||||||
|
}
|
||||||
|
if cursor := q.Get("before"); cursor != "" {
|
||||||
|
at, id, ok := parseAuditCursor(cursor)
|
||||||
|
if !ok {
|
||||||
|
writeError(w, http.StatusBadRequest, CodeBadRequest,
|
||||||
|
"before must be <unix>:<id>, as next_cursor returns it")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
f.BeforeAt, f.BeforeID = at, id
|
||||||
|
}
|
||||||
|
|
||||||
|
entries, err := s.db.ListAuditLog(r.Context(), f)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "list audit log", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
out := make([]auditEntryJSON, 0, len(entries))
|
||||||
|
for _, a := range entries {
|
||||||
|
out = append(out, auditEntryJSON{
|
||||||
|
ID: a.ID, At: a.CreatedAt.Format(time.RFC3339),
|
||||||
|
ProjectID: a.ProjectID, ProjectName: a.ProjectName, TaskID: a.TaskID,
|
||||||
|
UserID: a.UserID, UserName: a.UserName, Event: a.Event, Payload: a.Payload,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
body := map[string]any{"activity": out}
|
||||||
|
// A cursor only when the page was full. A short page is the end of the log, and
|
||||||
|
// a cursor there invites one more request that can only come back empty.
|
||||||
|
if len(entries) == f.Limit && f.Limit > 0 {
|
||||||
|
last := entries[len(entries)-1]
|
||||||
|
body["next_cursor"] = strconv.FormatInt(last.CreatedAt.Unix(), 10) + ":" + last.ID
|
||||||
|
}
|
||||||
|
writeJSON(w, http.StatusOK, body)
|
||||||
|
}
|
||||||
|
|
||||||
|
// handleAuditEvents is what the event filter is drawn from: the names that occur,
|
||||||
|
// with counts. Offered rather than typed — "member.role_changed" is an internal
|
||||||
|
// vocabulary, and a text field for it is a field that returns nothing until you
|
||||||
|
// have read the source.
|
||||||
|
func (s *Server) handleAuditEvents(w http.ResponseWriter, r *http.Request) {
|
||||||
|
events, err := s.db.AuditEvents(r.Context())
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "list audit events", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
out := make([]map[string]any, 0, len(events))
|
||||||
|
for _, e := range events {
|
||||||
|
out = append(out, map[string]any{"event": e.Event, "count": e.Count})
|
||||||
|
}
|
||||||
|
writeJSON(w, http.StatusOK, map[string]any{"events": out})
|
||||||
|
}
|
||||||
|
|
||||||
|
// parseAuditCursor reads "<unix>:<id>" — the pair the keyset walk needs. Both
|
||||||
|
// halves are required: a cursor carrying only a timestamp cannot separate two rows
|
||||||
|
// written in the same second, which is the case it exists for.
|
||||||
|
func parseAuditCursor(s string) (int64, string, bool) {
|
||||||
|
at, id, found := strings.Cut(s, ":")
|
||||||
|
if !found || id == "" {
|
||||||
|
return 0, "", false
|
||||||
|
}
|
||||||
|
unix, err := strconv.ParseInt(at, 10, 64)
|
||||||
|
if err != nil || unix <= 0 {
|
||||||
|
return 0, "", false
|
||||||
|
}
|
||||||
|
return unix, id, true
|
||||||
|
}
|
||||||
@@ -0,0 +1,264 @@
|
|||||||
|
package httpapi
|
||||||
|
|
||||||
|
import (
|
||||||
|
"fmt"
|
||||||
|
"net/http"
|
||||||
|
"testing"
|
||||||
|
)
|
||||||
|
|
||||||
|
// The point of the instance-wide log is that it crosses projects the caller is not
|
||||||
|
// a member of. The per-project endpoint cannot answer this question, and an
|
||||||
|
// administrator asking "what has happened on this server" was previously told to
|
||||||
|
// go and look in each project they happen to belong to.
|
||||||
|
func TestTheAuditLogCrossesProjectsTheAdminIsNotInAllOfThem(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
other := ts.newUser(t, "anden@example.dk", "Anden")
|
||||||
|
|
||||||
|
// A project the administrator is not a member of.
|
||||||
|
_, theirs := other.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Deres eget"})
|
||||||
|
theirID := theirs["id"].(string)
|
||||||
|
other.do(t, "POST", "/api/v1/tasks", map[string]any{
|
||||||
|
"content": "noget i deres eget", "project_id": theirID,
|
||||||
|
})
|
||||||
|
|
||||||
|
// The administrator cannot read that project's own history at all.
|
||||||
|
if resp, _ := ts.do(t, "GET", "/api/v1/projects/"+theirID+"/activity", nil); resp.StatusCode != http.StatusNotFound {
|
||||||
|
t.Fatalf("a project the admin is not in: status %d, want 404", resp.StatusCode)
|
||||||
|
}
|
||||||
|
|
||||||
|
// The instance log has it.
|
||||||
|
resp, body := ts.do(t, "GET", "/api/v1/activity", nil)
|
||||||
|
if resp.StatusCode != http.StatusOK {
|
||||||
|
t.Fatalf("audit log: status %d", resp.StatusCode)
|
||||||
|
}
|
||||||
|
entries, _ := body["activity"].([]any)
|
||||||
|
var found map[string]any
|
||||||
|
for _, raw := range entries {
|
||||||
|
e := raw.(map[string]any)
|
||||||
|
if e["project_id"] == theirID && e["event"] == "task.created" {
|
||||||
|
found = e
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if found == nil {
|
||||||
|
t.Fatalf("nothing from a project the admin is not in: %v", entries)
|
||||||
|
}
|
||||||
|
if found["project_name"] != "Deres eget" {
|
||||||
|
t.Errorf("project_name = %v — a row that does not name its project says nothing",
|
||||||
|
found["project_name"])
|
||||||
|
}
|
||||||
|
if found["user_name"] != "Anden" {
|
||||||
|
t.Errorf("user_name = %v", found["user_name"])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Administrators only, and sessions only. An audit log readable with a bearer token
|
||||||
|
// would let a stolen token read the record of the theft — and of everything else on
|
||||||
|
// the instance.
|
||||||
|
func TestTheAuditLogIsAdminsOnlyAndSessionsOnly(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
other := ts.newUser(t, "anden@example.dk", "Anden")
|
||||||
|
|
||||||
|
for _, path := range []string{"/api/v1/activity", "/api/v1/activity/events"} {
|
||||||
|
if resp, _ := other.do(t, "GET", path, nil); resp.StatusCode != http.StatusForbidden {
|
||||||
|
t.Errorf("%s as an ordinary user: status %d, want 403", path, resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
admin, err := ts.db.UserByEmail(t.Context(), "kristian@example.dk")
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
token := ts.apiToken(t, admin.ID)
|
||||||
|
for _, path := range []string{"/api/v1/activity", "/api/v1/activity/events"} {
|
||||||
|
req, _ := http.NewRequest("GET", ts.URL+path, nil)
|
||||||
|
req.Header.Set("Authorization", "Bearer "+token)
|
||||||
|
resp, err := (&http.Client{}).Do(req)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
resp.Body.Close()
|
||||||
|
if resp.StatusCode != http.StatusForbidden {
|
||||||
|
t.Errorf("%s with an admin's API token: status %d, want 403", path, resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// The cursor is keyed on (created_at, id) because the log is written in whole
|
||||||
|
// seconds. A page boundary that landed inside a busy second would, with a
|
||||||
|
// timestamp-only cursor, either repeat those rows or skip them — and an audit log
|
||||||
|
// that skips rows is worse than no audit log.
|
||||||
|
func TestTheAuditLogPagesWithoutRepeatingOrSkipping(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
_, project := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Meget"})
|
||||||
|
projectID := project["id"].(string)
|
||||||
|
// Written as fast as the loop goes, so they share timestamps.
|
||||||
|
const written = 25
|
||||||
|
for i := range written {
|
||||||
|
ts.do(t, "POST", "/api/v1/tasks", map[string]any{
|
||||||
|
"content": fmt.Sprintf("opgave %d", i), "project_id": projectID,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
seen := map[string]bool{}
|
||||||
|
cursor := ""
|
||||||
|
for page := 0; page < 20; page++ {
|
||||||
|
path := "/api/v1/activity?limit=4"
|
||||||
|
if cursor != "" {
|
||||||
|
path += "&before=" + cursor
|
||||||
|
}
|
||||||
|
resp, body := ts.do(t, "GET", path, nil)
|
||||||
|
if resp.StatusCode != http.StatusOK {
|
||||||
|
t.Fatalf("page %d: status %d", page, resp.StatusCode)
|
||||||
|
}
|
||||||
|
entries, _ := body["activity"].([]any)
|
||||||
|
for _, raw := range entries {
|
||||||
|
id := raw.(map[string]any)["id"].(string)
|
||||||
|
if seen[id] {
|
||||||
|
t.Fatalf("row %s came back on two pages", id)
|
||||||
|
}
|
||||||
|
seen[id] = true
|
||||||
|
}
|
||||||
|
next, _ := body["next_cursor"].(string)
|
||||||
|
if next == "" {
|
||||||
|
break
|
||||||
|
}
|
||||||
|
if next == cursor {
|
||||||
|
t.Fatalf("the cursor did not move: %s", next)
|
||||||
|
}
|
||||||
|
cursor = next
|
||||||
|
}
|
||||||
|
|
||||||
|
// Everything that was written is in the walk exactly once: the task creations,
|
||||||
|
// plus the project creation.
|
||||||
|
if len(seen) != written+1 {
|
||||||
|
t.Errorf("the walk saw %d rows, want %d — a page boundary lost some",
|
||||||
|
len(seen), written+1)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// The filters, and the list the event filter is drawn from.
|
||||||
|
func TestTheAuditLogFiltersAndListsItsEvents(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
other := ts.newUser(t, "anden@example.dk", "Anden")
|
||||||
|
otherUser, err := ts.db.UserByEmail(t.Context(), "anden@example.dk")
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
|
||||||
|
_, mine := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Mit"})
|
||||||
|
mineID := mine["id"].(string)
|
||||||
|
ts.do(t, "POST", "/api/v1/tasks", map[string]any{"content": "min", "project_id": mineID})
|
||||||
|
|
||||||
|
_, theirs := other.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Deres"})
|
||||||
|
theirID := theirs["id"].(string)
|
||||||
|
other.do(t, "POST", "/api/v1/tasks", map[string]any{"content": "deres", "project_id": theirID})
|
||||||
|
|
||||||
|
_, byUser := ts.do(t, "GET", "/api/v1/activity?user_id="+otherUser.ID, nil)
|
||||||
|
for _, raw := range byUser["activity"].([]any) {
|
||||||
|
if got := raw.(map[string]any)["user_id"]; got != otherUser.ID {
|
||||||
|
t.Errorf("user_id filter returned a row by %v", got)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if len(byUser["activity"].([]any)) == 0 {
|
||||||
|
t.Error("the user filter returned nothing")
|
||||||
|
}
|
||||||
|
|
||||||
|
_, byProject := ts.do(t, "GET", "/api/v1/activity?project_id="+mineID, nil)
|
||||||
|
for _, raw := range byProject["activity"].([]any) {
|
||||||
|
if got := raw.(map[string]any)["project_id"]; got != mineID {
|
||||||
|
t.Errorf("project_id filter returned a row from %v", got)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
_, byEvent := ts.do(t, "GET", "/api/v1/activity?event=project.created", nil)
|
||||||
|
rows := byEvent["activity"].([]any)
|
||||||
|
if len(rows) != 2 {
|
||||||
|
t.Errorf("event filter found %d project.created rows, want 2", len(rows))
|
||||||
|
}
|
||||||
|
for _, raw := range rows {
|
||||||
|
if got := raw.(map[string]any)["event"]; got != "project.created" {
|
||||||
|
t.Errorf("event filter returned %v", got)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// And the vocabulary the filter is built from.
|
||||||
|
_, events := ts.do(t, "GET", "/api/v1/activity/events", nil)
|
||||||
|
counts := map[string]float64{}
|
||||||
|
for _, raw := range events["events"].([]any) {
|
||||||
|
e := raw.(map[string]any)
|
||||||
|
counts[e["event"].(string)] = e["count"].(float64)
|
||||||
|
}
|
||||||
|
if counts["project.created"] != 2 || counts["task.created"] != 2 {
|
||||||
|
t.Errorf("event counts = %v", counts)
|
||||||
|
}
|
||||||
|
|
||||||
|
// A malformed cursor is a 400, not a silent first page: paging that quietly
|
||||||
|
// restarts is how an audit walk reads the same rows forever.
|
||||||
|
if resp, _ := ts.do(t, "GET", "/api/v1/activity?before=igår", nil); resp.StatusCode != http.StatusBadRequest {
|
||||||
|
t.Errorf("a malformed cursor: status %d, want 400", resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// A deleted account leaves its trail behind. This is the reason migration 0009
|
||||||
|
// exists: an audit log that lost its rows when somebody left would be missing
|
||||||
|
// exactly the part worth keeping.
|
||||||
|
func TestTheAuditLogOutlivesTheAccountItDescribes(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
other := ts.newUser(t, "anden@example.dk", "Anden")
|
||||||
|
otherUser, err := ts.db.UserByEmail(t.Context(), "anden@example.dk")
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
|
||||||
|
// In a project that outlives them, so the row is not carried off by the
|
||||||
|
// project cascade instead.
|
||||||
|
_, mine := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Fælles"})
|
||||||
|
sharedID := mine["id"].(string)
|
||||||
|
ts.do(t, "POST", "/api/v1/projects/"+sharedID+"/invites", map[string]any{
|
||||||
|
"email": "anden@example.dk", "role": "editor",
|
||||||
|
})
|
||||||
|
other.do(t, "POST", "/api/v1/tasks", map[string]any{
|
||||||
|
"content": "deres bidrag", "project_id": sharedID,
|
||||||
|
})
|
||||||
|
|
||||||
|
_, before := ts.do(t, "GET", "/api/v1/activity?user_id="+otherUser.ID+"&event=task.created", nil)
|
||||||
|
if len(before["activity"].([]any)) != 1 {
|
||||||
|
t.Fatalf("expected one row before the delete: %v", before["activity"])
|
||||||
|
}
|
||||||
|
|
||||||
|
if resp, _ := ts.do(t, "DELETE", "/api/v1/users/"+otherUser.ID, nil); resp.StatusCode != http.StatusNoContent {
|
||||||
|
t.Fatalf("delete: status %d", resp.StatusCode)
|
||||||
|
}
|
||||||
|
|
||||||
|
_, after := ts.do(t, "GET", "/api/v1/activity?project_id="+sharedID+"&event=task.created", nil)
|
||||||
|
rows := after["activity"].([]any)
|
||||||
|
if len(rows) != 1 {
|
||||||
|
t.Fatalf("the row went with the account: %v", rows)
|
||||||
|
}
|
||||||
|
row := rows[0].(map[string]any)
|
||||||
|
if _, ok := row["user_id"]; ok {
|
||||||
|
t.Errorf("user_id is still there after the account went: %v", row["user_id"])
|
||||||
|
}
|
||||||
|
if _, ok := row["user_name"]; ok {
|
||||||
|
t.Errorf("user_name is still there after the account went: %v", row["user_name"])
|
||||||
|
}
|
||||||
|
|
||||||
|
// And the project's own history still shows it, rather than dropping the row
|
||||||
|
// on an inner join to a user that is gone.
|
||||||
|
_, project := ts.do(t, "GET", "/api/v1/projects/"+sharedID+"/activity", nil)
|
||||||
|
var kept int
|
||||||
|
for _, raw := range project["activity"].([]any) {
|
||||||
|
if raw.(map[string]any)["event"] == "task.created" {
|
||||||
|
kept++
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if kept != 1 {
|
||||||
|
t.Errorf("the project history dropped the authorless row: %d", kept)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -8,6 +8,8 @@ import (
|
|||||||
"time"
|
"time"
|
||||||
"unicode/utf8"
|
"unicode/utf8"
|
||||||
|
|
||||||
|
"github.com/go-chi/chi/v5/middleware"
|
||||||
|
|
||||||
"github.com/kristianwind/verdande/internal/auth"
|
"github.com/kristianwind/verdande/internal/auth"
|
||||||
"github.com/kristianwind/verdande/internal/store"
|
"github.com/kristianwind/verdande/internal/store"
|
||||||
)
|
)
|
||||||
@@ -25,17 +27,62 @@ type userJSON struct {
|
|||||||
Locale string `json:"locale"`
|
Locale string `json:"locale"`
|
||||||
IsAdmin bool `json:"is_admin"`
|
IsAdmin bool `json:"is_admin"`
|
||||||
TOTPEnabled bool `json:"totp_enabled"`
|
TOTPEnabled bool `json:"totp_enabled"`
|
||||||
CreatedAt string `json:"created_at"`
|
// SidebarCollapsed is which sidebar headings this person has folded away. On
|
||||||
|
// the account rather than in the browser, because folding one is a statement
|
||||||
|
// about the work and not about the screen — the sidebar's width is the
|
||||||
|
// opposite case and stays in localStorage.
|
||||||
|
SidebarCollapsed []string `json:"sidebar_collapsed"`
|
||||||
|
CreatedAt string `json:"created_at"`
|
||||||
}
|
}
|
||||||
|
|
||||||
func toUserJSON(u *store.User) userJSON {
|
func toUserJSON(u *store.User) userJSON {
|
||||||
|
collapsed := u.SidebarCollapsed
|
||||||
|
// Never null in the response: a client that has to check for both an absent
|
||||||
|
// array and an empty one will one day check for only one of them.
|
||||||
|
if collapsed == nil {
|
||||||
|
collapsed = []string{}
|
||||||
|
}
|
||||||
return userJSON{
|
return userJSON{
|
||||||
ID: u.ID, Email: u.Email, Name: u.Name, AvatarColor: u.AvatarColor,
|
ID: u.ID, Email: u.Email, Name: u.Name, AvatarColor: u.AvatarColor,
|
||||||
Timezone: u.Timezone, Locale: u.Locale, IsAdmin: u.IsAdmin,
|
Timezone: u.Timezone, Locale: u.Locale, IsAdmin: u.IsAdmin,
|
||||||
TOTPEnabled: u.TOTPEnabled, CreatedAt: u.CreatedAt.Format(time.RFC3339),
|
TOTPEnabled: u.TOTPEnabled, SidebarCollapsed: collapsed,
|
||||||
|
CreatedAt: u.CreatedAt.Format(time.RFC3339),
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// handleSetSidebarSections records which sidebar headings are folded away.
|
||||||
|
//
|
||||||
|
// Its own route rather than a field on the profile: that one backs a form with a
|
||||||
|
// save button and validates three fields together, and this writes on every click
|
||||||
|
// of a chevron. Sharing the path would mean a fold sending a name and a timezone
|
||||||
|
// it was never asked to change — and a validation error on one of those failing a
|
||||||
|
// fold.
|
||||||
|
//
|
||||||
|
// The keys are the sidebar's and are not checked here. An unknown one costs
|
||||||
|
// nothing: the sidebar folds the headings it recognises and ignores the rest, so
|
||||||
|
// a heading that is renamed or removed leaves a harmless entry rather than a
|
||||||
|
// migration.
|
||||||
|
func (s *Server) handleSetSidebarSections(w http.ResponseWriter, r *http.Request) {
|
||||||
|
var req struct {
|
||||||
|
Sections []string `json:"sections"`
|
||||||
|
}
|
||||||
|
if err := decodeJSON(w, r, &req); err != nil {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
// A cap, because this is a list the client decides the length of. Twenty is far
|
||||||
|
// more headings than the sidebar has ever had.
|
||||||
|
if len(req.Sections) > 20 {
|
||||||
|
writeError(w, http.StatusBadRequest, CodeBadRequest, "too many sections")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
user := userFrom(r.Context())
|
||||||
|
if err := s.db.SetSidebarCollapsed(r.Context(), user.ID, req.Sections); err != nil {
|
||||||
|
s.storeError(w, r, "set sidebar sections", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
w.WriteHeader(http.StatusNoContent)
|
||||||
|
}
|
||||||
|
|
||||||
// --- sign in -----------------------------------------------------------------
|
// --- sign in -----------------------------------------------------------------
|
||||||
|
|
||||||
type loginRequest struct {
|
type loginRequest struct {
|
||||||
@@ -88,7 +135,7 @@ func (s *Server) handleLogin(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
token, _, err := s.db.CreateSession(r.Context(), user.ID, r.UserAgent(), clientIP(r), ttl, user.TOTPEnabled)
|
token, _, err := s.db.CreateSession(r.Context(), user.ID, r.UserAgent(), clientIP(r), ttl, user.TOTPEnabled)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "create session", err)
|
s.internal(w, r, "create session", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.setSessionCookie(w, token, ttl)
|
s.setSessionCookie(w, token, ttl)
|
||||||
@@ -130,7 +177,7 @@ func (s *Server) handleLoginTOTP(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if err := s.db.PromoteSession(r.Context(), session.ID, s.cfg.SessionTTL); err != nil {
|
if err := s.db.PromoteSession(r.Context(), session.ID, s.cfg.SessionTTL); err != nil {
|
||||||
s.internal(w, "promote session", err)
|
s.internal(w, r, "promote session", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
// The cookie is reissued so its lifetime matches the session's new one.
|
// The cookie is reissued so its lifetime matches the session's new one.
|
||||||
@@ -210,13 +257,13 @@ func (s *Server) handleUpdateProfile(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if err := s.db.UpdateProfile(r.Context(), user.ID, name, timezone, locale); err != nil {
|
if err := s.db.UpdateProfile(r.Context(), user.ID, name, timezone, locale); err != nil {
|
||||||
s.storeError(w, "update profile", err)
|
s.storeError(w, r, "update profile", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
updated, err := s.db.UserByID(r.Context(), user.ID)
|
updated, err := s.db.UserByID(r.Context(), user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "reload user", err)
|
s.internal(w, r, "reload user", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, toUserJSON(updated))
|
writeJSON(w, http.StatusOK, toUserJSON(updated))
|
||||||
@@ -263,7 +310,7 @@ func (s *Server) handleSignup(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
hash, err := auth.HashPassword(req.Password)
|
hash, err := auth.HashPassword(req.Password)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "hash password", err)
|
s.internal(w, r, "hash password", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -277,14 +324,14 @@ func (s *Server) handleSignup(w http.ResponseWriter, r *http.Request) {
|
|||||||
"an account already exists for that email address")
|
"an account already exists for that email address")
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.internal(w, "create user", err)
|
s.internal(w, r, "create user", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
// Accepting the invite is what adds the membership and burns the token, in one
|
// Accepting the invite is what adds the membership and burns the token, in one
|
||||||
// transaction: a signup that half-succeeded would leave a usable invite behind.
|
// transaction: a signup that half-succeeded would leave a usable invite behind.
|
||||||
if err := s.db.AcceptInvite(r.Context(), invite.ID, user.ID); err != nil {
|
if err := s.db.AcceptInvite(r.Context(), invite.ID, user.ID); err != nil {
|
||||||
s.internal(w, "accept invite", err)
|
s.internal(w, r, "accept invite", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -328,7 +375,7 @@ func (s *Server) handleBootstrap(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
hash, err := auth.HashPassword(req.Password)
|
hash, err := auth.HashPassword(req.Password)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "hash password", err)
|
s.internal(w, r, "hash password", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -341,7 +388,7 @@ func (s *Server) handleBootstrap(w http.ResponseWriter, r *http.Request) {
|
|||||||
writeError(w, http.StatusConflict, CodeConflict, "this instance is already set up")
|
writeError(w, http.StatusConflict, CodeConflict, "this instance is already set up")
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.internal(w, "create first admin", err)
|
s.internal(w, r, "create first admin", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -355,7 +402,7 @@ func (s *Server) handleBootstrap(w http.ResponseWriter, r *http.Request) {
|
|||||||
func (s *Server) handleSetupState(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleSetupState(w http.ResponseWriter, r *http.Request) {
|
||||||
n, err := s.db.UserCount(r.Context())
|
n, err := s.db.UserCount(r.Context())
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "count users", err)
|
s.internal(w, r, "count users", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, map[string]bool{"needs_setup": n == 0})
|
writeJSON(w, http.StatusOK, map[string]bool{"needs_setup": n == 0})
|
||||||
@@ -364,7 +411,7 @@ func (s *Server) handleSetupState(w http.ResponseWriter, r *http.Request) {
|
|||||||
func (s *Server) startSession(w http.ResponseWriter, r *http.Request, user *store.User) {
|
func (s *Server) startSession(w http.ResponseWriter, r *http.Request, user *store.User) {
|
||||||
token, _, err := s.db.CreateSession(r.Context(), user.ID, r.UserAgent(), clientIP(r), s.cfg.SessionTTL, false)
|
token, _, err := s.db.CreateSession(r.Context(), user.ID, r.UserAgent(), clientIP(r), s.cfg.SessionTTL, false)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "create session", err)
|
s.internal(w, r, "create session", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.setSessionCookie(w, token, s.cfg.SessionTTL)
|
s.setSessionCookie(w, token, s.cfg.SessionTTL)
|
||||||
@@ -393,7 +440,7 @@ func (s *Server) handleForgotPassword(w http.ResponseWriter, r *http.Request) {
|
|||||||
if err == nil {
|
if err == nil {
|
||||||
token, err := s.db.CreatePasswordReset(r.Context(), user.ID, s.cfg.ResetTTL)
|
token, err := s.db.CreatePasswordReset(r.Context(), user.ID, s.cfg.ResetTTL)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "create password reset", err)
|
s.internal(w, r, "create password reset", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
link := s.cfg.BaseURL + "/reset?token=" + token
|
link := s.cfg.BaseURL + "/reset?token=" + token
|
||||||
@@ -431,13 +478,13 @@ func (s *Server) handleResetPassword(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
hash, err := auth.HashPassword(req.Password)
|
hash, err := auth.HashPassword(req.Password)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "hash password", err)
|
s.internal(w, r, "hash password", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
// Every session ends: a password reset is what somebody does when they think
|
// Every session ends: a password reset is what somebody does when they think
|
||||||
// another person has been in their account.
|
// another person has been in their account.
|
||||||
if err := s.db.UpdatePasswordHash(r.Context(), userID, hash, ""); err != nil {
|
if err := s.db.UpdatePasswordHash(r.Context(), userID, hash, ""); err != nil {
|
||||||
s.internal(w, "update password", err)
|
s.internal(w, r, "update password", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -469,7 +516,7 @@ func (s *Server) handleChangePassword(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
hash, err := auth.HashPassword(req.NewPassword)
|
hash, err := auth.HashPassword(req.NewPassword)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "hash password", err)
|
s.internal(w, r, "hash password", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
keep := ""
|
keep := ""
|
||||||
@@ -477,7 +524,7 @@ func (s *Server) handleChangePassword(w http.ResponseWriter, r *http.Request) {
|
|||||||
keep = session.ID
|
keep = session.ID
|
||||||
}
|
}
|
||||||
if err := s.db.UpdatePasswordHash(r.Context(), user.ID, hash, keep); err != nil {
|
if err := s.db.UpdatePasswordHash(r.Context(), user.ID, hash, keep); err != nil {
|
||||||
s.internal(w, "update password", err)
|
s.internal(w, r, "update password", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
@@ -520,7 +567,27 @@ func inboxName(locale string) string {
|
|||||||
// internal logs the real error and tells the client nothing about it. The detail
|
// internal logs the real error and tells the client nothing about it. The detail
|
||||||
// belongs in the log, where the operator can see it; in the response it would be a
|
// belongs in the log, where the operator can see it; in the response it would be a
|
||||||
// description of the server's internals handed to whoever asked.
|
// description of the server's internals handed to whoever asked.
|
||||||
func (s *Server) internal(w http.ResponseWriter, what string, err error) {
|
//
|
||||||
|
// It is also written to the database. On a Rune the log is the container's, and
|
||||||
|
// every restart begins a new one — so the panel reports "HTTP 5xx, twice, at
|
||||||
|
// 11:49" long after the line explaining it has gone, which tells an operator that
|
||||||
|
// something broke and gives them no way to find out what. The row outlives the
|
||||||
|
// container; Indstillinger → Fejl is where it is read.
|
||||||
|
func (s *Server) internal(w http.ResponseWriter, r *http.Request, what string, err error) {
|
||||||
s.log.Error(what, "err", err)
|
s.log.Error(what, "err", err)
|
||||||
|
|
||||||
|
userID := ""
|
||||||
|
if u := userFrom(r.Context()); u != nil {
|
||||||
|
userID = u.ID
|
||||||
|
}
|
||||||
|
// Best effort, and deliberately not checked: this is the path that is already
|
||||||
|
// reporting a failure, and a diagnostic that can fail the request would turn
|
||||||
|
// one broken screen into two.
|
||||||
|
s.db.RecordError(r.Context(), store.ServerError{
|
||||||
|
Method: r.Method, Path: r.URL.Path, Status: http.StatusInternalServerError,
|
||||||
|
What: what, Message: err.Error(), UserID: userID,
|
||||||
|
RequestID: middleware.GetReqID(r.Context()),
|
||||||
|
})
|
||||||
|
|
||||||
writeError(w, http.StatusInternalServerError, CodeInternal, "something went wrong")
|
writeError(w, http.StatusInternalServerError, CodeInternal, "something went wrong")
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -46,7 +46,9 @@ func newTestServerWith(t *testing.T, configure func(*config.Config)) *testServer
|
|||||||
t.Cleanup(func() { db.Close() })
|
t.Cleanup(func() { db.Close() })
|
||||||
|
|
||||||
cfg := &config.Config{
|
cfg := &config.Config{
|
||||||
BaseURL: "http://127.0.0.1",
|
// `localhost`, not a loopback IP: passkeys refuse an IP address as a relying
|
||||||
|
// party id, and every browser makes the same exception for localhost.
|
||||||
|
BaseURL: "http://localhost",
|
||||||
DataDir: t.TempDir(),
|
DataDir: t.TempDir(),
|
||||||
SessionTTL: 24 * time.Hour,
|
SessionTTL: 24 * time.Hour,
|
||||||
InviteTTL: 7 * 24 * time.Hour,
|
InviteTTL: 7 * 24 * time.Hour,
|
||||||
|
|||||||
@@ -0,0 +1,158 @@
|
|||||||
|
package httpapi
|
||||||
|
|
||||||
|
import (
|
||||||
|
"fmt"
|
||||||
|
"net/http"
|
||||||
|
"os"
|
||||||
|
"path/filepath"
|
||||||
|
"strings"
|
||||||
|
"time"
|
||||||
|
|
||||||
|
"github.com/go-chi/chi/v5"
|
||||||
|
|
||||||
|
"github.com/kristianwind/verdande/internal/jobs"
|
||||||
|
)
|
||||||
|
|
||||||
|
// The nightly backup, made visible.
|
||||||
|
//
|
||||||
|
// It has run since the beginning and nothing showed it. A backup nobody can see is
|
||||||
|
// a backup nobody knows has been failing — and the failure mode is quiet: a volume
|
||||||
|
// that went read-only, a disk that filled, a container that has not been up at
|
||||||
|
// midnight for a week. The first time anybody finds out is the day they need one.
|
||||||
|
//
|
||||||
|
// Administrators only, and behind a session as well as the admin check. A backup
|
||||||
|
// file is a complete copy of the database, so downloading one is downloading
|
||||||
|
// everybody's data; a leaked API token must not be able to.
|
||||||
|
|
||||||
|
type backupRunJSON struct {
|
||||||
|
ID string `json:"id"`
|
||||||
|
Started string `json:"started_at"`
|
||||||
|
// Finished is absent while a backup is still running, and on one that was
|
||||||
|
// interrupted — which is the same shape from outside and honestly so: a run
|
||||||
|
// the process died in the middle of never finished.
|
||||||
|
Finished string `json:"finished_at,omitempty"`
|
||||||
|
Size int64 `json:"size_bytes"`
|
||||||
|
Error string `json:"error,omitempty"`
|
||||||
|
// Present says the file is still on disk. Rotation keeps the most recent
|
||||||
|
// fourteen, so an older row is a true record of a backup that was made and a
|
||||||
|
// file that is no longer there — and a download link for it would 404.
|
||||||
|
Present bool `json:"present"`
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) handleListBackups(w http.ResponseWriter, r *http.Request) {
|
||||||
|
runs, err := s.db.ListBackupRuns(r.Context(), parseLimit(r.URL.Query().Get("limit"), 30, 100))
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "list backups", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
out := make([]backupRunJSON, 0, len(runs))
|
||||||
|
for _, b := range runs {
|
||||||
|
j := backupRunJSON{
|
||||||
|
ID: b.ID, Started: b.StartedAt.Format(time.RFC3339),
|
||||||
|
Size: b.SizeBytes, Error: b.Error,
|
||||||
|
}
|
||||||
|
if b.FinishedAt != nil {
|
||||||
|
j.Finished = b.FinishedAt.Format(time.RFC3339)
|
||||||
|
}
|
||||||
|
if b.Path != "" {
|
||||||
|
if _, err := os.Stat(b.Path); err == nil {
|
||||||
|
j.Present = true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
out = append(out, j)
|
||||||
|
}
|
||||||
|
writeJSON(w, http.StatusOK, map[string]any{"backups": out})
|
||||||
|
}
|
||||||
|
|
||||||
|
// handleRunBackup takes one now.
|
||||||
|
//
|
||||||
|
// The same function the nightly job runs, without the "has one run today" check.
|
||||||
|
// Waiting until tonight to learn whether backups work at all is how somebody finds
|
||||||
|
// out on the day they need one — and it is the only way to get a snapshot from
|
||||||
|
// *before* something you are about to do.
|
||||||
|
//
|
||||||
|
// Synchronous. A backup of a homelab database is a second or two, and a button
|
||||||
|
// that returns immediately and tells you nothing is a button you press twice.
|
||||||
|
func (s *Server) handleRunBackup(w http.ResponseWriter, r *http.Request) {
|
||||||
|
if err := jobs.Backup(r.Context(), s.cfg, s.db, s.log); err != nil {
|
||||||
|
s.internal(w, r, "run backup", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
runs, err := s.db.ListBackupRuns(r.Context(), 1)
|
||||||
|
if err != nil || len(runs) == 0 {
|
||||||
|
w.WriteHeader(http.StatusNoContent)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
b := runs[0]
|
||||||
|
j := backupRunJSON{
|
||||||
|
ID: b.ID, Started: b.StartedAt.Format(time.RFC3339),
|
||||||
|
Size: b.SizeBytes, Error: b.Error, Present: true,
|
||||||
|
}
|
||||||
|
if b.FinishedAt != nil {
|
||||||
|
j.Finished = b.FinishedAt.Format(time.RFC3339)
|
||||||
|
}
|
||||||
|
writeJSON(w, http.StatusCreated, j)
|
||||||
|
}
|
||||||
|
|
||||||
|
// handleDownloadBackup sends one backup file.
|
||||||
|
//
|
||||||
|
// The path comes from the row rather than from the request, and is then checked to
|
||||||
|
// be inside the backups directory anyway. The row is written by this process and
|
||||||
|
// should always be safe; the check is there because "should always" is how a path
|
||||||
|
// traversal gets shipped, and the thing on the other side of it is every account's
|
||||||
|
// data in one file.
|
||||||
|
func (s *Server) handleDownloadBackup(w http.ResponseWriter, r *http.Request) {
|
||||||
|
runs, err := s.db.ListBackupRuns(r.Context(), 100)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "list backups", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
id := chi.URLParam(r, "backupID")
|
||||||
|
var path string
|
||||||
|
for _, b := range runs {
|
||||||
|
if b.ID == id {
|
||||||
|
path = b.Path
|
||||||
|
break
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if path == "" {
|
||||||
|
writeError(w, http.StatusNotFound, CodeNotFound, "not found")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
dir, err := filepath.Abs(s.cfg.BackupsDir())
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "backups dir", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
full, err := filepath.Abs(path)
|
||||||
|
if err != nil || !strings.HasPrefix(full, dir+string(os.PathSeparator)) {
|
||||||
|
writeError(w, http.StatusNotFound, CodeNotFound, "not found")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
file, err := os.Open(full)
|
||||||
|
if err != nil {
|
||||||
|
// Rotation keeps the most recent fourteen, so a row older than that is a
|
||||||
|
// true record with no file behind it. Not an error — a 404 is the honest
|
||||||
|
// answer to "send me that one".
|
||||||
|
writeError(w, http.StatusNotFound, CodeNotFound, "not found")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
defer file.Close()
|
||||||
|
|
||||||
|
info, err := file.Stat()
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "stat backup", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
// The same treatment attachments get, and for a stronger reason: this is a
|
||||||
|
// SQLite database, and nothing should ever be tempted to render it inline.
|
||||||
|
w.Header().Set("Content-Type", "application/octet-stream")
|
||||||
|
w.Header().Set("Content-Disposition",
|
||||||
|
fmt.Sprintf("attachment; filename=%q", filepath.Base(full)))
|
||||||
|
w.Header().Set("X-Content-Type-Options", "nosniff")
|
||||||
|
http.ServeContent(w, r, "", info.ModTime(), file)
|
||||||
|
}
|
||||||
@@ -0,0 +1,116 @@
|
|||||||
|
package httpapi
|
||||||
|
|
||||||
|
import (
|
||||||
|
"net/http"
|
||||||
|
"testing"
|
||||||
|
)
|
||||||
|
|
||||||
|
// The backup panel exists because the job was invisible, so the thing to check is
|
||||||
|
// that it can be seen and asked for — and that the file it hands out is guarded
|
||||||
|
// like what it is, which is every account's data in one download.
|
||||||
|
func TestABackupCanBeTakenListedAndDownloaded(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
// Nothing yet, and that is a state the list has to survive rather than a case
|
||||||
|
// nobody hits: it is what a fresh instance looks like.
|
||||||
|
_, empty := ts.do(t, "GET", "/api/v1/backups", nil)
|
||||||
|
if got, _ := empty["backups"].([]any); len(got) != 0 {
|
||||||
|
t.Fatalf("a fresh instance has %d backups", len(got))
|
||||||
|
}
|
||||||
|
|
||||||
|
resp, made := ts.do(t, "POST", "/api/v1/backups", nil)
|
||||||
|
if resp.StatusCode != http.StatusCreated {
|
||||||
|
t.Fatalf("run backup: status %d, body %v", resp.StatusCode, made)
|
||||||
|
}
|
||||||
|
id, _ := made["id"].(string)
|
||||||
|
if id == "" {
|
||||||
|
t.Fatal("the new run has no id")
|
||||||
|
}
|
||||||
|
if size, _ := made["size_bytes"].(float64); size <= 0 {
|
||||||
|
t.Errorf("size_bytes = %v — a backup of a database with rows in it is not empty", made["size_bytes"])
|
||||||
|
}
|
||||||
|
if made["error"] != nil {
|
||||||
|
t.Errorf("the backup reported an error: %v", made["error"])
|
||||||
|
}
|
||||||
|
|
||||||
|
_, listed := ts.do(t, "GET", "/api/v1/backups", nil)
|
||||||
|
rows, _ := listed["backups"].([]any)
|
||||||
|
if len(rows) != 1 {
|
||||||
|
t.Fatalf("listed %d backups, want 1", len(rows))
|
||||||
|
}
|
||||||
|
row := rows[0].(map[string]any)
|
||||||
|
if row["id"] != id {
|
||||||
|
t.Errorf("the listed run is not the one that was made")
|
||||||
|
}
|
||||||
|
if row["present"] != true {
|
||||||
|
t.Error("present = false on a backup that was just written")
|
||||||
|
}
|
||||||
|
|
||||||
|
// And the file itself, which must arrive as a download rather than as
|
||||||
|
// something a browser might try to render.
|
||||||
|
req, _ := http.NewRequest("GET", ts.URL+"/api/v1/backups/"+id, nil)
|
||||||
|
req.Header.Set("Sec-Fetch-Site", "same-origin")
|
||||||
|
dl, err := ts.client.Do(req)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
defer dl.Body.Close()
|
||||||
|
if dl.StatusCode != http.StatusOK {
|
||||||
|
t.Fatalf("download: status %d", dl.StatusCode)
|
||||||
|
}
|
||||||
|
if ct := dl.Header.Get("Content-Type"); ct != "application/octet-stream" {
|
||||||
|
t.Errorf("Content-Type = %q, want application/octet-stream", ct)
|
||||||
|
}
|
||||||
|
if cd := dl.Header.Get("Content-Disposition"); cd == "" || cd[:10] != "attachment" {
|
||||||
|
t.Errorf("Content-Disposition = %q, want an attachment", cd)
|
||||||
|
}
|
||||||
|
|
||||||
|
// An id that is not a backup is a 404, not a path to try opening.
|
||||||
|
if resp, _ := ts.do(t, "GET", "/api/v1/backups/../../etc/passwd", nil); resp.StatusCode == http.StatusOK {
|
||||||
|
t.Error("a traversal in the id was served")
|
||||||
|
}
|
||||||
|
if resp, _ := ts.do(t, "GET", "/api/v1/backups/nogetsomhelst", nil); resp.StatusCode != http.StatusNotFound {
|
||||||
|
t.Errorf("an unknown id: status %d, want 404", resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Administrators only, and sessions only. A backup is a complete copy of the
|
||||||
|
// database — a leaked token that could download one turns a stolen credential into
|
||||||
|
// a copy of everybody's data.
|
||||||
|
func TestBackupsAreAdminsOnlyAndSessionsOnly(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
other := ts.newUser(t, "anden@example.dk", "Anden")
|
||||||
|
|
||||||
|
for _, c := range []struct{ method, path string }{
|
||||||
|
{"GET", "/api/v1/backups"},
|
||||||
|
{"POST", "/api/v1/backups"},
|
||||||
|
{"GET", "/api/v1/backups/whichever"},
|
||||||
|
} {
|
||||||
|
if resp, _ := other.do(t, c.method, c.path, nil); resp.StatusCode != http.StatusForbidden {
|
||||||
|
t.Errorf("%s %s as an ordinary user: status %d, want 403", c.method, c.path, resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
admin, err := ts.db.UserByEmail(t.Context(), "kristian@example.dk")
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
token := ts.apiToken(t, admin.ID)
|
||||||
|
for _, c := range []struct{ method, path string }{
|
||||||
|
{"GET", "/api/v1/backups"},
|
||||||
|
{"POST", "/api/v1/backups"},
|
||||||
|
} {
|
||||||
|
req, _ := http.NewRequest(c.method, ts.URL+c.path, nil)
|
||||||
|
req.Header.Set("Authorization", "Bearer "+token)
|
||||||
|
resp, err := (&http.Client{}).Do(req)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
resp.Body.Close()
|
||||||
|
if resp.StatusCode != http.StatusForbidden {
|
||||||
|
t.Errorf("%s %s with an admin's API token: status %d, want 403", c.method, c.path, resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -85,7 +85,7 @@ func (s *Server) handleCalDAVHome(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
projects, err := s.db.ListProjects(r.Context(), user.ID, false)
|
projects, err := s.db.ListProjects(r.Context(), user.ID, false)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "caldav home", err)
|
s.internal(w, r, "caldav home", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -131,7 +131,7 @@ func (s *Server) handleCalDAVCalendar(w http.ResponseWriter, r *http.Request) {
|
|||||||
if r.Header.Get("Depth") != "0" {
|
if r.Header.Get("Depth") != "0" {
|
||||||
tasks, err := s.caldavTasks(r, user, projectID)
|
tasks, err := s.caldavTasks(r, user, projectID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "caldav tasks", err)
|
s.internal(w, r, "caldav tasks", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
for _, t := range tasks {
|
for _, t := range tasks {
|
||||||
@@ -157,7 +157,7 @@ func (s *Server) handleCalDAVReport(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
tasks, err := s.caldavTasks(r, user, projectID)
|
tasks, err := s.caldavTasks(r, user, projectID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "caldav report", err)
|
s.internal(w, r, "caldav report", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
byID := map[string]store.Task{}
|
byID := map[string]store.Task{}
|
||||||
@@ -240,7 +240,7 @@ func (s *Server) handleCalDAVPut(w http.ResponseWriter, r *http.Request) {
|
|||||||
update.DueDatetime = parsed.DueDatetime
|
update.DueDatetime = parsed.DueDatetime
|
||||||
|
|
||||||
if err := s.db.UpdateTask(r.Context(), taskID, user.ID, update); err != nil {
|
if err := s.db.UpdateTask(r.Context(), taskID, user.ID, update); err != nil {
|
||||||
s.internal(w, "caldav update", err)
|
s.internal(w, r, "caldav update", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
if parsed.Completed && !existing.Completed() {
|
if parsed.Completed && !existing.Completed() {
|
||||||
@@ -275,7 +275,7 @@ func (s *Server) handleCalDAVPut(w http.ResponseWriter, r *http.Request) {
|
|||||||
task.Content = "(uden titel)"
|
task.Content = "(uden titel)"
|
||||||
}
|
}
|
||||||
if err := s.db.CreateTask(r.Context(), task, nil); err != nil {
|
if err := s.db.CreateTask(r.Context(), task, nil); err != nil {
|
||||||
s.internal(w, "caldav create", err)
|
s.internal(w, r, "caldav create", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.publish(projectID, "task.created", toTaskJSON(*task))
|
s.publish(projectID, "task.created", toTaskJSON(*task))
|
||||||
@@ -294,7 +294,7 @@ func (s *Server) handleCalDAVDelete(w http.ResponseWriter, r *http.Request) {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.DeleteTask(r.Context(), taskID); err != nil {
|
if err := s.db.DeleteTask(r.Context(), taskID); err != nil {
|
||||||
s.internal(w, "caldav delete", err)
|
s.internal(w, r, "caldav delete", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
|
|||||||
@@ -68,7 +68,7 @@ func (s *Server) handleListComments(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
comments, err := s.db.ListComments(r.Context(), taskID)
|
comments, err := s.db.ListComments(r.Context(), taskID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list comments", err)
|
s.internal(w, r, "list comments", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
out := make([]commentJSON, 0, len(comments))
|
out := make([]commentJSON, 0, len(comments))
|
||||||
@@ -78,7 +78,7 @@ func (s *Server) handleListComments(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
files, err := s.db.ListTaskAttachments(r.Context(), taskID)
|
files, err := s.db.ListTaskAttachments(r.Context(), taskID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list attachments", err)
|
s.internal(w, r, "list attachments", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
direct := make([]attachmentJSON, 0, len(files))
|
direct := make([]attachmentJSON, 0, len(files))
|
||||||
@@ -119,7 +119,7 @@ func (s *Server) handleCreateComment(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
comment, err := s.db.CreateComment(r.Context(), taskID, user.ID, body)
|
comment, err := s.db.CreateComment(r.Context(), taskID, user.ID, body)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "create comment", err)
|
s.internal(w, r, "create comment", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
comment.UserName, comment.UserColor = user.Name, user.AvatarColor
|
comment.UserName, comment.UserColor = user.Name, user.AvatarColor
|
||||||
@@ -149,7 +149,7 @@ func (s *Server) handleUpdateComment(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
err := s.db.UpdateComment(r.Context(), chi.URLParam(r, "commentID"), userFrom(r.Context()).ID, body)
|
err := s.db.UpdateComment(r.Context(), chi.URLParam(r, "commentID"), userFrom(r.Context()).ID, body)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "update comment", err)
|
s.storeError(w, r, "update comment", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
@@ -161,7 +161,7 @@ func (s *Server) handleDeleteComment(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
taskID, err := s.db.CommentTask(r.Context(), commentID)
|
taskID, err := s.db.CommentTask(r.Context(), commentID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "comment task", err)
|
s.storeError(w, r, "comment task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
role, err := store.TaskRole(r.Context(), s.db, taskID, user.ID)
|
role, err := store.TaskRole(r.Context(), s.db, taskID, user.ID)
|
||||||
@@ -171,7 +171,7 @@ func (s *Server) handleDeleteComment(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if err := s.db.DeleteComment(r.Context(), commentID, user.ID, role.CanManage()); err != nil {
|
if err := s.db.DeleteComment(r.Context(), commentID, user.ID, role.CanManage()); err != nil {
|
||||||
s.storeError(w, "delete comment", err)
|
s.storeError(w, r, "delete comment", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
@@ -219,7 +219,7 @@ func (s *Server) handleUploadAttachment(w http.ResponseWriter, r *http.Request)
|
|||||||
|
|
||||||
stored, size, err := s.storeUpload(file)
|
stored, size, err := s.storeUpload(file)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "store upload", err)
|
s.internal(w, r, "store upload", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -240,7 +240,7 @@ func (s *Server) handleUploadAttachment(w http.ResponseWriter, r *http.Request)
|
|||||||
|
|
||||||
if err := s.db.CreateAttachment(r.Context(), a); err != nil {
|
if err := s.db.CreateAttachment(r.Context(), a); err != nil {
|
||||||
os.Remove(filepath.Join(s.cfg.FilesDir(), stored))
|
os.Remove(filepath.Join(s.cfg.FilesDir(), stored))
|
||||||
s.internal(w, "record attachment", err)
|
s.internal(w, r, "record attachment", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -300,23 +300,55 @@ func (s *Server) storeUpload(file io.Reader) (string, int64, error) {
|
|||||||
return rel, size, nil
|
return rel, size, nil
|
||||||
}
|
}
|
||||||
|
|
||||||
func (s *Server) handleDownloadAttachment(w http.ResponseWriter, r *http.Request) {
|
// reachAttachment answers whether this person may see an attachment at all, and
|
||||||
attachmentID := chi.URLParam(r, "attachmentID")
|
// whether they may change it.
|
||||||
|
//
|
||||||
|
// An attachment hangs on exactly one of three things, and each has its own idea of
|
||||||
|
// who may reach it. A task's is governed by its project's roles, directly or
|
||||||
|
// through the comment it hangs on. A group's is governed by nothing but ownership:
|
||||||
|
// a group belongs to one person, is never shared, and a group that is not yours is
|
||||||
|
// not found — the same rule the rest of the group routes use.
|
||||||
|
//
|
||||||
|
// Both callers below used to resolve straight to a task, so a group's attachment
|
||||||
|
// answered 404 for its own owner.
|
||||||
|
func (s *Server) reachAttachment(r *http.Request, attachmentID string) (canEdit bool, err error) {
|
||||||
user := userFrom(r.Context())
|
user := userFrom(r.Context())
|
||||||
|
|
||||||
|
a, err := s.db.GetAttachment(r.Context(), attachmentID)
|
||||||
|
if err != nil {
|
||||||
|
return false, err
|
||||||
|
}
|
||||||
|
|
||||||
|
if a.GroupID != "" {
|
||||||
|
if _, err := s.db.GetProjectGroup(r.Context(), a.GroupID, user.ID); err != nil {
|
||||||
|
return false, err
|
||||||
|
}
|
||||||
|
// Nobody else can reach it, so whoever can, can change it.
|
||||||
|
return true, nil
|
||||||
|
}
|
||||||
|
|
||||||
taskID, err := s.db.AttachmentTask(r.Context(), attachmentID)
|
taskID, err := s.db.AttachmentTask(r.Context(), attachmentID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "attachment task", err)
|
return false, err
|
||||||
return
|
|
||||||
}
|
}
|
||||||
if _, err := store.TaskRole(r.Context(), s.db, taskID, user.ID); err != nil {
|
role, err := store.TaskRole(r.Context(), s.db, taskID, user.ID)
|
||||||
|
if err != nil {
|
||||||
|
return false, err
|
||||||
|
}
|
||||||
|
return role.CanEdit(), nil
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) handleDownloadAttachment(w http.ResponseWriter, r *http.Request) {
|
||||||
|
attachmentID := chi.URLParam(r, "attachmentID")
|
||||||
|
|
||||||
|
if _, err := s.reachAttachment(r, attachmentID); err != nil {
|
||||||
writeError(w, http.StatusNotFound, CodeNotFound, "not found")
|
writeError(w, http.StatusNotFound, CodeNotFound, "not found")
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
a, err := s.db.GetAttachment(r.Context(), attachmentID)
|
a, err := s.db.GetAttachment(r.Context(), attachmentID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get attachment", err)
|
s.storeError(w, r, "get attachment", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -354,22 +386,16 @@ func (s *Server) handleDownloadAttachment(w http.ResponseWriter, r *http.Request
|
|||||||
|
|
||||||
func (s *Server) handleDeleteAttachment(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleDeleteAttachment(w http.ResponseWriter, r *http.Request) {
|
||||||
attachmentID := chi.URLParam(r, "attachmentID")
|
attachmentID := chi.URLParam(r, "attachmentID")
|
||||||
user := userFrom(r.Context())
|
|
||||||
|
|
||||||
taskID, err := s.db.AttachmentTask(r.Context(), attachmentID)
|
canEdit, err := s.reachAttachment(r, attachmentID)
|
||||||
if err != nil {
|
if err != nil || !canEdit {
|
||||||
s.storeError(w, "attachment task", err)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
role, err := store.TaskRole(r.Context(), s.db, taskID, user.ID)
|
|
||||||
if err != nil || !role.CanEdit() {
|
|
||||||
writeError(w, http.StatusNotFound, CodeNotFound, "not found")
|
writeError(w, http.StatusNotFound, CodeNotFound, "not found")
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
path, err := s.db.DeleteAttachment(r.Context(), attachmentID)
|
path, err := s.db.DeleteAttachment(r.Context(), attachmentID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "delete attachment", err)
|
s.storeError(w, r, "delete attachment", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,47 @@
|
|||||||
|
package httpapi
|
||||||
|
|
||||||
|
import (
|
||||||
|
"net/http"
|
||||||
|
"time"
|
||||||
|
)
|
||||||
|
|
||||||
|
// What has gone wrong lately, kept where a restart cannot take it.
|
||||||
|
//
|
||||||
|
// The panel's watcher reports "HTTP 5xx, twice, at 11:49" — which is enough to
|
||||||
|
// know something broke and nothing at all to act on. The line that explains it is
|
||||||
|
// in the container's log, and a Rune's container is replaced on every restart, so
|
||||||
|
// by the time anybody looks the explanation is gone. These rows are the same
|
||||||
|
// information written somewhere that survives.
|
||||||
|
|
||||||
|
type serverErrorJSON struct {
|
||||||
|
ID string `json:"id"`
|
||||||
|
At string `json:"at"`
|
||||||
|
Method string `json:"method"`
|
||||||
|
Path string `json:"path"`
|
||||||
|
Status int `json:"status"`
|
||||||
|
// What the handler was doing, in its own words — "list projects", "move task".
|
||||||
|
What string `json:"what"`
|
||||||
|
Message string `json:"message"`
|
||||||
|
// Who was asking, when there was somebody: a fault only one account hits is a
|
||||||
|
// different problem from one everybody hits.
|
||||||
|
UserName string `json:"user_name,omitempty"`
|
||||||
|
// RequestID ties the row back to the log line, for whoever still has it.
|
||||||
|
RequestID string `json:"request_id,omitempty"`
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) handleListErrors(w http.ResponseWriter, r *http.Request) {
|
||||||
|
errs, err := s.db.ListErrors(r.Context(), parseLimit(r.URL.Query().Get("limit"), 100, 500))
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "list errors", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
out := make([]serverErrorJSON, 0, len(errs))
|
||||||
|
for _, e := range errs {
|
||||||
|
out = append(out, serverErrorJSON{
|
||||||
|
ID: e.ID, At: e.At.Format(time.RFC3339), Method: e.Method, Path: e.Path,
|
||||||
|
Status: e.Status, What: e.What, Message: e.Message,
|
||||||
|
UserName: e.UserName, RequestID: e.RequestID,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
writeJSON(w, http.StatusOK, map[string]any{"errors": out})
|
||||||
|
}
|
||||||
@@ -36,13 +36,13 @@ func (s *Server) handleICSFeed(w http.ResponseWriter, r *http.Request) {
|
|||||||
Limit: 2000,
|
Limit: 2000,
|
||||||
})
|
})
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "ics feed", err)
|
s.internal(w, r, "ics feed", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
projects, err := s.db.ListProjects(r.Context(), user.ID, true)
|
projects, err := s.db.ListProjects(r.Context(), user.ID, true)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "ics feed projects", err)
|
s.internal(w, r, "ics feed projects", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
names := map[string]string{}
|
names := map[string]string{}
|
||||||
@@ -89,7 +89,7 @@ func (s *Server) handleGetFeed(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
token, err := s.db.EnsureICSToken(r.Context(), user.ID)
|
token, err := s.db.EnsureICSToken(r.Context(), user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "ics token", err)
|
s.internal(w, r, "ics token", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, feedResponse{URL: s.cfg.BaseURL + "/ics/" + token + ".ics"})
|
writeJSON(w, http.StatusOK, feedResponse{URL: s.cfg.BaseURL + "/ics/" + token + ".ics"})
|
||||||
@@ -103,11 +103,11 @@ func (s *Server) handleRotateFeed(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
token, err := auth.NewToken()
|
token, err := auth.NewToken()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "generate feed token", err)
|
s.internal(w, r, "generate feed token", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.SetICSToken(r.Context(), user.ID, token); err != nil {
|
if err := s.db.SetICSToken(r.Context(), user.ID, token); err != nil {
|
||||||
s.internal(w, "set feed token", err)
|
s.internal(w, r, "set feed token", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, feedResponse{URL: s.cfg.BaseURL + "/ics/" + token + ".ics"})
|
writeJSON(w, http.StatusOK, feedResponse{URL: s.cfg.BaseURL + "/ics/" + token + ".ics"})
|
||||||
@@ -151,7 +151,7 @@ func (s *Server) handleListReminders(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
reminders, err := s.db.ListReminders(r.Context(), taskID)
|
reminders, err := s.db.ListReminders(r.Context(), taskID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list reminders", err)
|
s.internal(w, r, "list reminders", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
out := make([]reminderJSON, 0, len(reminders))
|
out := make([]reminderJSON, 0, len(reminders))
|
||||||
@@ -197,7 +197,7 @@ func (s *Server) handleCreateReminder(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
rem, err := s.db.CreateReminder(r.Context(), taskID, user.ID, at, req.OffsetMin)
|
rem, err := s.db.CreateReminder(r.Context(), taskID, user.ID, at, req.OffsetMin)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "create reminder", err)
|
s.internal(w, r, "create reminder", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -211,7 +211,7 @@ func (s *Server) handleCreateReminder(w http.ResponseWriter, r *http.Request) {
|
|||||||
func (s *Server) handleDeleteReminder(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleDeleteReminder(w http.ResponseWriter, r *http.Request) {
|
||||||
err := s.db.DeleteReminder(r.Context(), chi.URLParam(r, "reminderID"), userFrom(r.Context()).ID)
|
err := s.db.DeleteReminder(r.Context(), chi.URLParam(r, "reminderID"), userFrom(r.Context()).ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "delete reminder", err)
|
s.storeError(w, r, "delete reminder", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
@@ -238,7 +238,7 @@ func toTemplateJSON(t store.Template) templateJSON {
|
|||||||
func (s *Server) handleListTemplates(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleListTemplates(w http.ResponseWriter, r *http.Request) {
|
||||||
templates, err := s.db.ListTemplates(r.Context(), userFrom(r.Context()).ID)
|
templates, err := s.db.ListTemplates(r.Context(), userFrom(r.Context()).ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list templates", err)
|
s.internal(w, r, "list templates", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
out := make([]templateJSON, 0, len(templates))
|
out := make([]templateJSON, 0, len(templates))
|
||||||
@@ -273,7 +273,7 @@ func (s *Server) handleSaveTemplate(w http.ResponseWriter, r *http.Request) {
|
|||||||
tpl, err := s.db.SaveProjectAsTemplate(r.Context(), req.ProjectID, user.ID,
|
tpl, err := s.db.SaveProjectAsTemplate(r.Context(), req.ProjectID, user.ID,
|
||||||
strings.TrimSpace(req.Name), strings.TrimSpace(req.Description))
|
strings.TrimSpace(req.Name), strings.TrimSpace(req.Description))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "save template", err)
|
s.storeError(w, r, "save template", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusCreated, toTemplateJSON(*tpl))
|
writeJSON(w, http.StatusCreated, toTemplateJSON(*tpl))
|
||||||
@@ -295,7 +295,7 @@ func (s *Server) handleUseTemplate(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
tpl, err := s.db.GetTemplate(r.Context(), user.ID, chi.URLParam(r, "templateID"))
|
tpl, err := s.db.GetTemplate(r.Context(), user.ID, chi.URLParam(r, "templateID"))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get template", err)
|
s.storeError(w, r, "get template", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -311,7 +311,7 @@ func (s *Server) handleUseTemplate(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
project, err := s.db.CreateProjectFromTemplate(r.Context(), tpl, user.ID, strings.TrimSpace(req.Name), start)
|
project, err := s.db.CreateProjectFromTemplate(r.Context(), tpl, user.ID, strings.TrimSpace(req.Name), start)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "create from template", err)
|
s.internal(w, r, "create from template", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.activity(r, project.ID, "", "project.created", map[string]any{
|
s.activity(r, project.ID, "", "project.created", map[string]any{
|
||||||
@@ -323,7 +323,7 @@ func (s *Server) handleUseTemplate(w http.ResponseWriter, r *http.Request) {
|
|||||||
func (s *Server) handleDeleteTemplate(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleDeleteTemplate(w http.ResponseWriter, r *http.Request) {
|
||||||
err := s.db.DeleteTemplate(r.Context(), userFrom(r.Context()).ID, chi.URLParam(r, "templateID"))
|
err := s.db.DeleteTemplate(r.Context(), userFrom(r.Context()).ID, chi.URLParam(r, "templateID"))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "delete template", err)
|
s.storeError(w, r, "delete template", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
|
|||||||
@@ -27,7 +27,7 @@ func toFilterJSON(f store.Filter) filterJSON {
|
|||||||
func (s *Server) handleListFilters(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleListFilters(w http.ResponseWriter, r *http.Request) {
|
||||||
filters, err := s.db.ListFilters(r.Context(), userFrom(r.Context()).ID)
|
filters, err := s.db.ListFilters(r.Context(), userFrom(r.Context()).ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list filters", err)
|
s.internal(w, r, "list filters", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
out := make([]filterJSON, 0, len(filters))
|
out := make([]filterJSON, 0, len(filters))
|
||||||
@@ -74,7 +74,7 @@ func (s *Server) handleCreateFilter(w http.ResponseWriter, r *http.Request) {
|
|||||||
f.SortOrder = *req.SortOrder
|
f.SortOrder = *req.SortOrder
|
||||||
}
|
}
|
||||||
if err := s.db.CreateFilter(r.Context(), f); err != nil {
|
if err := s.db.CreateFilter(r.Context(), f); err != nil {
|
||||||
s.internal(w, "create filter", err)
|
s.internal(w, r, "create filter", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusCreated, toFilterJSON(*f))
|
writeJSON(w, http.StatusCreated, toFilterJSON(*f))
|
||||||
@@ -108,7 +108,7 @@ func (s *Server) handleUpdateFilter(w http.ResponseWriter, r *http.Request) {
|
|||||||
Name: req.Name, Query: req.Query, Color: req.Color, SortOrder: req.SortOrder,
|
Name: req.Name, Query: req.Query, Color: req.Color, SortOrder: req.SortOrder,
|
||||||
})
|
})
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "update filter", err)
|
s.storeError(w, r, "update filter", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
@@ -117,7 +117,7 @@ func (s *Server) handleUpdateFilter(w http.ResponseWriter, r *http.Request) {
|
|||||||
func (s *Server) handleDeleteFilter(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleDeleteFilter(w http.ResponseWriter, r *http.Request) {
|
||||||
err := s.db.DeleteFilter(r.Context(), userFrom(r.Context()).ID, chi.URLParam(r, "filterID"))
|
err := s.db.DeleteFilter(r.Context(), userFrom(r.Context()).ID, chi.URLParam(r, "filterID"))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "delete filter", err)
|
s.storeError(w, r, "delete filter", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
@@ -129,7 +129,7 @@ func (s *Server) handleRunFilter(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
f, err := s.db.GetFilter(r.Context(), user.ID, chi.URLParam(r, "filterID"))
|
f, err := s.db.GetFilter(r.Context(), user.ID, chi.URLParam(r, "filterID"))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get filter", err)
|
s.storeError(w, r, "get filter", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.runQuery(w, r, f.Query)
|
s.runQuery(w, r, f.Query)
|
||||||
@@ -167,7 +167,7 @@ func (s *Server) runQuery(w http.ResponseWriter, r *http.Request, query string)
|
|||||||
Limit: parseLimit(r.URL.Query().Get("limit"), 200, 500),
|
Limit: parseLimit(r.URL.Query().Get("limit"), 200, 500),
|
||||||
})
|
})
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "run filter", err)
|
s.internal(w, r, "run filter", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, map[string]any{"tasks": toTaskList(tasks)})
|
writeJSON(w, http.StatusOK, map[string]any{"tasks": toTaskList(tasks)})
|
||||||
@@ -210,7 +210,7 @@ type labelJSON struct {
|
|||||||
func (s *Server) handleListLabels(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleListLabels(w http.ResponseWriter, r *http.Request) {
|
||||||
labels, err := s.db.ListLabels(r.Context(), userFrom(r.Context()).ID)
|
labels, err := s.db.ListLabels(r.Context(), userFrom(r.Context()).ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list labels", err)
|
s.internal(w, r, "list labels", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
out := make([]labelJSON, 0, len(labels))
|
out := make([]labelJSON, 0, len(labels))
|
||||||
@@ -242,7 +242,7 @@ func (s *Server) handleCreateLabel(w http.ResponseWriter, r *http.Request) {
|
|||||||
writeError(w, http.StatusConflict, CodeConflict, "you already have a label with that name")
|
writeError(w, http.StatusConflict, CodeConflict, "you already have a label with that name")
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.internal(w, "create label", err)
|
s.internal(w, r, "create label", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.publishToOwner(r, "label.changed", labelJSON{l.ID, l.Name, l.Color, l.SortOrder, 0})
|
s.publishToOwner(r, "label.changed", labelJSON{l.ID, l.Name, l.Color, l.SortOrder, 0})
|
||||||
@@ -261,7 +261,7 @@ func (s *Server) handleUpdateLabel(w http.ResponseWriter, r *http.Request) {
|
|||||||
writeError(w, http.StatusConflict, CodeConflict, "you already have a label with that name")
|
writeError(w, http.StatusConflict, CodeConflict, "you already have a label with that name")
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.storeError(w, "update label", err)
|
s.storeError(w, r, "update label", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.publishToOwner(r, "label.changed", nil)
|
s.publishToOwner(r, "label.changed", nil)
|
||||||
@@ -271,7 +271,7 @@ func (s *Server) handleUpdateLabel(w http.ResponseWriter, r *http.Request) {
|
|||||||
func (s *Server) handleDeleteLabel(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleDeleteLabel(w http.ResponseWriter, r *http.Request) {
|
||||||
err := s.db.DeleteLabel(r.Context(), userFrom(r.Context()).ID, chi.URLParam(r, "labelID"))
|
err := s.db.DeleteLabel(r.Context(), userFrom(r.Context()).ID, chi.URLParam(r, "labelID"))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "delete label", err)
|
s.storeError(w, r, "delete label", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.publishToOwner(r, "label.changed", nil)
|
s.publishToOwner(r, "label.changed", nil)
|
||||||
|
|||||||
@@ -10,12 +10,44 @@ import (
|
|||||||
"github.com/kristianwind/verdande/internal/store"
|
"github.com/kristianwind/verdande/internal/store"
|
||||||
)
|
)
|
||||||
|
|
||||||
func (s *Server) gmailConfig() gmail.Config {
|
// gmailConfig is the OAuth client this instance authorises with.
|
||||||
return gmail.Config{
|
//
|
||||||
|
// The environment wins when it is set. A value in the environment is a deliberate
|
||||||
|
// deployment decision — it is in the Rune's manifest, under version control,
|
||||||
|
// applied on every recreate — and a form that could quietly override it would make
|
||||||
|
// the manifest a lie. The stored pair is for the ordinary case, where nobody wants
|
||||||
|
// to redeploy a container to paste a client id.
|
||||||
|
func (s *Server) gmailConfig(ctx context.Context) gmail.Config {
|
||||||
|
cfg := gmail.Config{
|
||||||
ClientID: s.cfg.GmailClientID,
|
ClientID: s.cfg.GmailClientID,
|
||||||
ClientSecret: s.cfg.GmailClientSecret,
|
ClientSecret: s.cfg.GmailClientSecret,
|
||||||
RedirectURL: s.cfg.GmailRedirectURL(),
|
RedirectURL: s.cfg.GmailRedirectURL(),
|
||||||
}
|
}
|
||||||
|
if cfg.ClientID != "" && cfg.ClientSecret != "" {
|
||||||
|
return cfg
|
||||||
|
}
|
||||||
|
|
||||||
|
stored, err := s.db.InstanceSettings(ctx, "gmail")
|
||||||
|
if err != nil {
|
||||||
|
// Not fatal: an unconfigured Gmail and a database that could not answer
|
||||||
|
// look the same from here, and the caller's next step is the same either
|
||||||
|
// way — say it is not set up.
|
||||||
|
return cfg
|
||||||
|
}
|
||||||
|
if id, _ := stored["client_id"].(string); cfg.ClientID == "" {
|
||||||
|
cfg.ClientID = id
|
||||||
|
}
|
||||||
|
if secret, _ := stored["client_secret"].(string); cfg.ClientSecret == "" {
|
||||||
|
cfg.ClientSecret = secret
|
||||||
|
}
|
||||||
|
return cfg
|
||||||
|
}
|
||||||
|
|
||||||
|
// gmailFromEnv says whether the deployment set the client, which the settings page
|
||||||
|
// needs so it can explain why the fields are not editable rather than accepting
|
||||||
|
// changes that will never take effect.
|
||||||
|
func (s *Server) gmailFromEnv() bool {
|
||||||
|
return s.cfg.GmailClientID != "" && s.cfg.GmailClientSecret != ""
|
||||||
}
|
}
|
||||||
|
|
||||||
// handleGmailAuthorize starts the flow: it mints a PKCE pair, remembers it against
|
// handleGmailAuthorize starts the flow: it mints a PKCE pair, remembers it against
|
||||||
@@ -27,7 +59,7 @@ func (s *Server) gmailConfig() gmail.Config {
|
|||||||
// defaults.
|
// defaults.
|
||||||
func (s *Server) handleGmailAuthorize(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleGmailAuthorize(w http.ResponseWriter, r *http.Request) {
|
||||||
user := userFrom(r.Context())
|
user := userFrom(r.Context())
|
||||||
cfg := s.gmailConfig()
|
cfg := s.gmailConfig(r.Context())
|
||||||
|
|
||||||
if !cfg.Configured() {
|
if !cfg.Configured() {
|
||||||
writeError(w, http.StatusConflict, CodeGmailNotConfigured,
|
writeError(w, http.StatusConflict, CodeGmailNotConfigured,
|
||||||
@@ -37,13 +69,13 @@ func (s *Server) handleGmailAuthorize(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
pkce, err := gmail.NewPKCE()
|
pkce, err := gmail.NewPKCE()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "gmail pkce", err)
|
s.internal(w, r, "gmail pkce", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
settings, err := s.db.UserSettings(r.Context(), user.ID, "gmail")
|
settings, err := s.db.UserSettings(r.Context(), user.ID, "gmail")
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "gmail settings", err)
|
s.internal(w, r, "gmail settings", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
settings["pkce_verifier"] = pkce.Verifier
|
settings["pkce_verifier"] = pkce.Verifier
|
||||||
@@ -53,7 +85,7 @@ func (s *Server) handleGmailAuthorize(w http.ResponseWriter, r *http.Request) {
|
|||||||
settings["pkce_expires"] = time.Now().Add(10 * time.Minute).Unix()
|
settings["pkce_expires"] = time.Now().Add(10 * time.Minute).Unix()
|
||||||
|
|
||||||
if err := s.db.SetUserSettings(r.Context(), user.ID, "gmail", settings); err != nil {
|
if err := s.db.SetUserSettings(r.Context(), user.ID, "gmail", settings); err != nil {
|
||||||
s.internal(w, "gmail settings", err)
|
s.internal(w, r, "gmail settings", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, map[string]string{"url": cfg.AuthURL(pkce)})
|
writeJSON(w, http.StatusOK, map[string]string{"url": cfg.AuthURL(pkce)})
|
||||||
@@ -83,7 +115,7 @@ func (s *Server) handleGmailCallback(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
settings, err := s.db.UserSettings(r.Context(), user.ID, "gmail")
|
settings, err := s.db.UserSettings(r.Context(), user.ID, "gmail")
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "gmail settings", err)
|
s.internal(w, r, "gmail settings", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
verifier, _ := settings["pkce_verifier"].(string)
|
verifier, _ := settings["pkce_verifier"].(string)
|
||||||
@@ -102,7 +134,7 @@ func (s *Server) handleGmailCallback(w http.ResponseWriter, r *http.Request) {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
token, err := s.gmailConfig().Exchange(r.Context(), code, gmail.PKCE{Verifier: verifier})
|
token, err := s.gmailConfig(r.Context()).Exchange(r.Context(), code, gmail.PKCE{Verifier: verifier})
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.log.Error("gmail exchange", "err", err, "user", user.ID)
|
s.log.Error("gmail exchange", "err", err, "user", user.ID)
|
||||||
http.Redirect(w, r, settingsURL+"?gmail=failed", http.StatusFound)
|
http.Redirect(w, r, settingsURL+"?gmail=failed", http.StatusFound)
|
||||||
@@ -138,7 +170,7 @@ func (s *Server) handleGmailCallback(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if err := s.db.SetUserSettings(r.Context(), user.ID, "gmail", settings); err != nil {
|
if err := s.db.SetUserSettings(r.Context(), user.ID, "gmail", settings); err != nil {
|
||||||
s.internal(w, "save gmail tokens", err)
|
s.internal(w, r, "save gmail tokens", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.log.Info("gmail connected", "user", user.ID, "mailbox", email)
|
s.log.Info("gmail connected", "user", user.ID, "mailbox", email)
|
||||||
@@ -185,7 +217,7 @@ func (s *Server) SyncGmail(ctx context.Context, user *store.User) (int, error) {
|
|||||||
access := str("access_token")
|
access := str("access_token")
|
||||||
expires, _ := settings["expires_at"].(float64)
|
expires, _ := settings["expires_at"].(float64)
|
||||||
if access == "" || int64(expires) <= time.Now().Unix() {
|
if access == "" || int64(expires) <= time.Now().Unix() {
|
||||||
token, err := s.gmailConfig().Refresh(ctx, refresh)
|
token, err := s.gmailConfig(ctx).Refresh(ctx, refresh)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return 0, err
|
return 0, err
|
||||||
}
|
}
|
||||||
@@ -300,3 +332,96 @@ func (s *Server) handleVersion(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, status)
|
writeJSON(w, http.StatusOK, status)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// --- the OAuth client itself ------------------------------------------------------
|
||||||
|
|
||||||
|
// The registration Google requires, enterable rather than deployed.
|
||||||
|
//
|
||||||
|
// The one click that opens Google's consent screen already exists; what it needs
|
||||||
|
// behind it is a registered client, and that is not something any app can conjure:
|
||||||
|
// Google issues no Gmail access to an unregistered client, and `gmail.readonly` is
|
||||||
|
// a restricted scope, so an id shipped inside a public image would be both
|
||||||
|
// extractable from it and unusable without Google's security review of every
|
||||||
|
// deployment. The registration is a one-off. Having to edit a Rune's manifest and
|
||||||
|
// recreate the container to paste the result was not.
|
||||||
|
//
|
||||||
|
// Administrators only, and sessions only: this is the instance's identity to
|
||||||
|
// Google, and a leaked API token must not be able to read or replace it.
|
||||||
|
|
||||||
|
type gmailClientJSON struct {
|
||||||
|
ClientID string `json:"client_id"`
|
||||||
|
// Secret is written and never read back, like the AI key: a settings page that
|
||||||
|
// repopulates a password field is one that will eventually leak into a
|
||||||
|
// screenshot.
|
||||||
|
ClientSecret string `json:"client_secret,omitempty"`
|
||||||
|
HasSecret bool `json:"has_secret"`
|
||||||
|
// FromEnv says the deployment set this, in which case the stored pair is
|
||||||
|
// ignored and the fields are not worth editing. Sent so the page can say why
|
||||||
|
// rather than accepting changes that will never take effect.
|
||||||
|
FromEnv bool `json:"from_env"`
|
||||||
|
// RedirectURI is what has to be registered with Google, spelled out. It is
|
||||||
|
// derived from VERDANDE_BASE_URL and must match exactly — it is the single
|
||||||
|
// most likely thing to be wrong, and the error Google gives for it names
|
||||||
|
// neither value.
|
||||||
|
RedirectURI string `json:"redirect_uri"`
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) handleGetGmailClient(w http.ResponseWriter, r *http.Request) {
|
||||||
|
stored, err := s.db.InstanceSettings(r.Context(), "gmail")
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "gmail client", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
out := gmailClientJSON{
|
||||||
|
FromEnv: s.gmailFromEnv(),
|
||||||
|
RedirectURI: s.cfg.GmailRedirectURL(),
|
||||||
|
}
|
||||||
|
if out.FromEnv {
|
||||||
|
out.ClientID = s.cfg.GmailClientID
|
||||||
|
out.HasSecret = true
|
||||||
|
} else {
|
||||||
|
out.ClientID, _ = stored["client_id"].(string)
|
||||||
|
secret, _ := stored["client_secret"].(string)
|
||||||
|
out.HasSecret = secret != ""
|
||||||
|
}
|
||||||
|
writeJSON(w, http.StatusOK, out)
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) handleSetGmailClient(w http.ResponseWriter, r *http.Request) {
|
||||||
|
var req gmailClientJSON
|
||||||
|
if err := decodeJSON(w, r, &req); err != nil {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
if s.gmailFromEnv() {
|
||||||
|
writeError(w, http.StatusConflict, CodeConflict,
|
||||||
|
"the Gmail client is set in the environment and cannot be changed here")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
stored, err := s.db.InstanceSettings(r.Context(), "gmail")
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "gmail client", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
// An empty secret means "leave it alone", not "delete it" — otherwise
|
||||||
|
// correcting a typo in the client id would silently clear the secret.
|
||||||
|
secret, _ := stored["client_secret"].(string)
|
||||||
|
if req.ClientSecret != "" {
|
||||||
|
secret = strings.TrimSpace(req.ClientSecret)
|
||||||
|
}
|
||||||
|
id := strings.TrimSpace(req.ClientID)
|
||||||
|
|
||||||
|
if fields := map[string]string{}; id == "" && secret != "" {
|
||||||
|
fields["client_id"] = "required"
|
||||||
|
writeFieldErrors(w, fields)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
if err := s.db.SetInstanceSettings(r.Context(), "gmail", map[string]any{
|
||||||
|
"client_id": id, "client_secret": secret,
|
||||||
|
}); err != nil {
|
||||||
|
s.internal(w, r, "save gmail client", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
w.WriteHeader(http.StatusNoContent)
|
||||||
|
}
|
||||||
|
|||||||
@@ -69,7 +69,7 @@ func (s *Server) handleImportTodoist(w http.ResponseWriter, r *http.Request) {
|
|||||||
project := todoist.FromRows(rows, name)
|
project := todoist.FromRows(rows, name)
|
||||||
result, err := s.importProject(r, user, project)
|
result, err := s.importProject(r, user, project)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "import project", err)
|
s.internal(w, r, "import project", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusCreated, result)
|
writeJSON(w, http.StatusCreated, result)
|
||||||
@@ -240,7 +240,7 @@ func (s *Server) handleImportCSV(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
result, err := s.importProject(r, user, project)
|
result, err := s.importProject(r, user, project)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "import csv", err)
|
s.internal(w, r, "import csv", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusCreated, result)
|
writeJSON(w, http.StatusCreated, result)
|
||||||
@@ -255,12 +255,12 @@ func (s *Server) handleExportProject(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
project, err := s.db.GetProject(r.Context(), projectID, user.ID)
|
project, err := s.db.GetProject(r.Context(), projectID, user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get project", err)
|
s.storeError(w, r, "get project", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
exported, err := s.buildExport(r, user, project)
|
exported, err := s.buildExport(r, user, project)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "export project", err)
|
s.internal(w, r, "export project", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -346,7 +346,7 @@ func (s *Server) handleExportAccount(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
projects, err := s.db.ListProjects(ctx, user.ID, true)
|
projects, err := s.db.ListProjects(ctx, user.ID, true)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "export projects", err)
|
s.internal(w, r, "export projects", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -390,7 +390,7 @@ func (s *Server) handleExportAccount(w http.ResponseWriter, r *http.Request) {
|
|||||||
ProjectIDs: []string{p.ID}, IncludeCompleted: true, Limit: 5000,
|
ProjectIDs: []string{p.ID}, IncludeCompleted: true, Limit: 5000,
|
||||||
})
|
})
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "export tasks", err)
|
s.internal(w, r, "export tasks", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
for _, t := range tasks {
|
for _, t := range tasks {
|
||||||
@@ -445,14 +445,14 @@ func (s *Server) handleExportProjectICS(w http.ResponseWriter, r *http.Request)
|
|||||||
|
|
||||||
project, err := s.db.GetProject(r.Context(), projectID, user.ID)
|
project, err := s.db.GetProject(r.Context(), projectID, user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get project", err)
|
s.storeError(w, r, "get project", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
tasks, err := s.db.ListTasks(r.Context(), user.ID, store.TaskFilter{
|
tasks, err := s.db.ListTasks(r.Context(), user.ID, store.TaskFilter{
|
||||||
ProjectIDs: []string{projectID}, IncludeCompleted: true, Limit: 5000,
|
ProjectIDs: []string{projectID}, IncludeCompleted: true, Limit: 5000,
|
||||||
})
|
})
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "export ics", err)
|
s.internal(w, r, "export ics", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -37,7 +37,7 @@ func (s *Server) handleGetMailAddress(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
token, err := s.db.EnsureMailToken(r.Context(), user.ID)
|
token, err := s.db.EnsureMailToken(r.Context(), user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "mail token", err)
|
s.internal(w, r, "mail token", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, mailAddressResponse{
|
writeJSON(w, http.StatusOK, mailAddressResponse{
|
||||||
@@ -49,11 +49,11 @@ func (s *Server) handleGetMailAddress(w http.ResponseWriter, r *http.Request) {
|
|||||||
func (s *Server) handleRotateMailAddress(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleRotateMailAddress(w http.ResponseWriter, r *http.Request) {
|
||||||
token, err := auth.NewToken()
|
token, err := auth.NewToken()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "generate mail token", err)
|
s.internal(w, r, "generate mail token", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.SetMailToken(r.Context(), userFrom(r.Context()).ID, token); err != nil {
|
if err := s.db.SetMailToken(r.Context(), userFrom(r.Context()).ID, token); err != nil {
|
||||||
s.internal(w, "set mail token", err)
|
s.internal(w, r, "set mail token", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, mailAddressResponse{
|
writeJSON(w, http.StatusOK, mailAddressResponse{
|
||||||
@@ -134,7 +134,7 @@ func (s *Server) handleInboundMail(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
if projectID == "" {
|
if projectID == "" {
|
||||||
if projectID, err = s.db.InboxID(r.Context(), user.ID); err != nil {
|
if projectID, err = s.db.InboxID(r.Context(), user.ID); err != nil {
|
||||||
s.internal(w, "inbox", err)
|
s.internal(w, r, "inbox", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -145,7 +145,7 @@ func (s *Server) handleInboundMail(w http.ResponseWriter, r *http.Request) {
|
|||||||
RecurrenceRule: parsed.Recurrence, CreatedBy: user.ID,
|
RecurrenceRule: parsed.Recurrence, CreatedBy: user.ID,
|
||||||
}
|
}
|
||||||
if err := s.db.CreateTask(r.Context(), task, parsed.Labels); err != nil {
|
if err := s.db.CreateTask(r.Context(), task, parsed.Labels); err != nil {
|
||||||
s.internal(w, "create task from mail", err)
|
s.internal(w, r, "create task from mail", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -187,7 +187,7 @@ type aiSettings struct {
|
|||||||
func (s *Server) handleGetAISettings(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleGetAISettings(w http.ResponseWriter, r *http.Request) {
|
||||||
cfg, err := s.aiConfig(r, userFrom(r.Context()).ID)
|
cfg, err := s.aiConfig(r, userFrom(r.Context()).ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "ai settings", err)
|
s.internal(w, r, "ai settings", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
// The key is never sent back. A settings page that repopulates a password
|
// The key is never sent back. A settings page that repopulates a password
|
||||||
@@ -216,7 +216,7 @@ func (s *Server) handleSetAISettings(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
existing, err := s.aiConfig(r, user.ID)
|
existing, err := s.aiConfig(r, user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "ai settings", err)
|
s.internal(w, r, "ai settings", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
// An empty key means "leave it alone", not "delete it" — otherwise saving a
|
// An empty key means "leave it alone", not "delete it" — otherwise saving a
|
||||||
@@ -231,7 +231,7 @@ func (s *Server) handleSetAISettings(w http.ResponseWriter, r *http.Request) {
|
|||||||
"model": req.Model, "api_key": key,
|
"model": req.Model, "api_key": key,
|
||||||
}
|
}
|
||||||
if err := s.db.SetUserSettings(r.Context(), user.ID, "ai", settings); err != nil {
|
if err := s.db.SetUserSettings(r.Context(), user.ID, "ai", settings); err != nil {
|
||||||
s.internal(w, "save ai settings", err)
|
s.internal(w, r, "save ai settings", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
@@ -266,7 +266,7 @@ func (s *Server) handleAISplit(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
cfg, err := s.aiConfig(r, user.ID)
|
cfg, err := s.aiConfig(r, user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "ai settings", err)
|
s.internal(w, r, "ai settings", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
if !cfg.Configured() {
|
if !cfg.Configured() {
|
||||||
@@ -278,7 +278,7 @@ func (s *Server) handleAISplit(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
task, err := s.db.GetTask(r.Context(), taskID, user.ID)
|
task, err := s.db.GetTask(r.Context(), taskID, user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get task", err)
|
s.storeError(w, r, "get task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -299,7 +299,7 @@ func (s *Server) handleAISplit(w http.ResponseWriter, r *http.Request) {
|
|||||||
Priority: task.Priority, CreatedBy: user.ID,
|
Priority: task.Priority, CreatedBy: user.ID,
|
||||||
}
|
}
|
||||||
if err := s.db.CreateTask(r.Context(), child, nil); err != nil {
|
if err := s.db.CreateTask(r.Context(), child, nil); err != nil {
|
||||||
s.internal(w, "create subtask", err)
|
s.internal(w, r, "create subtask", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
created = append(created, toTaskJSON(*child))
|
created = append(created, toTaskJSON(*child))
|
||||||
@@ -315,7 +315,7 @@ func (s *Server) handleAISummary(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
cfg, err := s.aiConfig(r, user.ID)
|
cfg, err := s.aiConfig(r, user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "ai settings", err)
|
s.internal(w, r, "ai settings", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
if !cfg.Configured() {
|
if !cfg.Configured() {
|
||||||
@@ -326,7 +326,7 @@ func (s *Server) handleAISummary(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
tasks, err := s.db.ListTasks(r.Context(), user.ID, store.TaskFilter{Limit: 100})
|
tasks, err := s.db.ListTasks(r.Context(), user.ID, store.TaskFilter{Limit: 100})
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list tasks", err)
|
s.internal(w, r, "list tasks", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
if len(tasks) == 0 {
|
if len(tasks) == 0 {
|
||||||
@@ -372,7 +372,7 @@ type gmailSettings struct {
|
|||||||
func (s *Server) handleGetGmail(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleGetGmail(w http.ResponseWriter, r *http.Request) {
|
||||||
values, err := s.db.UserSettings(r.Context(), userFrom(r.Context()).ID, "gmail")
|
values, err := s.db.UserSettings(r.Context(), userFrom(r.Context()).ID, "gmail")
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "gmail settings", err)
|
s.internal(w, r, "gmail settings", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
str := func(key string) string {
|
str := func(key string) string {
|
||||||
@@ -396,14 +396,14 @@ func (s *Server) handleSetGmail(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
values, err := s.db.UserSettings(r.Context(), user.ID, "gmail")
|
values, err := s.db.UserSettings(r.Context(), user.ID, "gmail")
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "gmail settings", err)
|
s.internal(w, r, "gmail settings", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
values["trigger"] = req.Trigger
|
values["trigger"] = req.Trigger
|
||||||
values["label"] = req.Label
|
values["label"] = req.Label
|
||||||
|
|
||||||
if err := s.db.SetUserSettings(r.Context(), user.ID, "gmail", values); err != nil {
|
if err := s.db.SetUserSettings(r.Context(), user.ID, "gmail", values); err != nil {
|
||||||
s.internal(w, "save gmail settings", err)
|
s.internal(w, r, "save gmail settings", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
@@ -412,7 +412,7 @@ func (s *Server) handleSetGmail(w http.ResponseWriter, r *http.Request) {
|
|||||||
// handleDisconnectGmail forgets the connection, tokens and all.
|
// handleDisconnectGmail forgets the connection, tokens and all.
|
||||||
func (s *Server) handleDisconnectGmail(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleDisconnectGmail(w http.ResponseWriter, r *http.Request) {
|
||||||
if err := s.db.SetUserSettings(r.Context(), userFrom(r.Context()).ID, "gmail", map[string]any{}); err != nil {
|
if err := s.db.SetUserSettings(r.Context(), userFrom(r.Context()).ID, "gmail", map[string]any{}); err != nil {
|
||||||
s.internal(w, "disconnect gmail", err)
|
s.internal(w, r, "disconnect gmail", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
|
|||||||
@@ -1153,3 +1153,130 @@ func TestMCPCreateRefusesASecondLevelOfSubtask(t *testing.T) {
|
|||||||
t.Errorf("a sub-task of a sub-task was accepted: %v", response)
|
t.Errorf("a sub-task of a sub-task was accepted: %v", response)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// The Gmail OAuth client, enterable rather than deployed.
|
||||||
|
//
|
||||||
|
// The registration itself cannot be avoided — Google issues no Gmail access to an
|
||||||
|
// unregistered client — but having to edit a Rune's manifest and recreate the
|
||||||
|
// container to paste the result can be, and that is what this covers.
|
||||||
|
func TestTheGmailClientCanBeSetFromTheInterface(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
_, empty := ts.do(t, "GET", "/api/v1/gmail/client", nil)
|
||||||
|
if empty["client_id"] != "" || empty["has_secret"] != false {
|
||||||
|
t.Errorf("a fresh instance already has a client: %v", empty)
|
||||||
|
}
|
||||||
|
if empty["from_env"] != false {
|
||||||
|
t.Errorf("from_env = %v with nothing in the environment", empty["from_env"])
|
||||||
|
}
|
||||||
|
// The single most likely thing to be wrong, so it is spelled out rather than
|
||||||
|
// left for somebody to reconstruct.
|
||||||
|
if empty["redirect_uri"] != "http://localhost/oauth/gmail/callback" {
|
||||||
|
t.Errorf("redirect_uri = %v", empty["redirect_uri"])
|
||||||
|
}
|
||||||
|
|
||||||
|
resp, _ := ts.do(t, "PUT", "/api/v1/gmail/client", map[string]any{
|
||||||
|
"client_id": "1234.apps.googleusercontent.com", "client_secret": "hemmelig",
|
||||||
|
})
|
||||||
|
if resp.StatusCode != http.StatusNoContent {
|
||||||
|
t.Fatalf("save: status %d", resp.StatusCode)
|
||||||
|
}
|
||||||
|
|
||||||
|
_, saved := ts.do(t, "GET", "/api/v1/gmail/client", nil)
|
||||||
|
if saved["client_id"] != "1234.apps.googleusercontent.com" {
|
||||||
|
t.Errorf("client_id = %v", saved["client_id"])
|
||||||
|
}
|
||||||
|
if saved["has_secret"] != true {
|
||||||
|
t.Error("has_secret is false after saving one")
|
||||||
|
}
|
||||||
|
// Never read back. A settings page that repopulates a password field is one
|
||||||
|
// that will eventually leak into a screenshot.
|
||||||
|
if _, present := saved["client_secret"]; present {
|
||||||
|
t.Error("the secret came back in the response")
|
||||||
|
}
|
||||||
|
|
||||||
|
// Saving only the id must not clear the secret — otherwise correcting a typo
|
||||||
|
// silently breaks the connection.
|
||||||
|
ts.do(t, "PUT", "/api/v1/gmail/client", map[string]any{
|
||||||
|
"client_id": "5678.apps.googleusercontent.com",
|
||||||
|
})
|
||||||
|
_, again := ts.do(t, "GET", "/api/v1/gmail/client", nil)
|
||||||
|
if again["client_id"] != "5678.apps.googleusercontent.com" || again["has_secret"] != true {
|
||||||
|
t.Errorf("saving the id alone lost the secret: %v", again)
|
||||||
|
}
|
||||||
|
|
||||||
|
// And the authorise call now has something to build a URL with, which is the
|
||||||
|
// whole point: one click, and Google's consent screen.
|
||||||
|
resp, body := ts.do(t, "POST", "/api/v1/gmail/authorize", nil)
|
||||||
|
if resp.StatusCode != http.StatusOK {
|
||||||
|
t.Fatalf("authorize with a stored client: status %d, body %v", resp.StatusCode, body)
|
||||||
|
}
|
||||||
|
if url, _ := body["url"].(string); !strings.Contains(url, "5678.apps.googleusercontent.com") {
|
||||||
|
t.Errorf("the consent URL does not carry the stored client: %v", body["url"])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// The environment wins, and says so. A value in the Rune's manifest is applied on
|
||||||
|
// every recreate, so a form that could quietly override it would make the manifest
|
||||||
|
// a lie.
|
||||||
|
func TestTheEnvironmentsGmailClientCannotBeOverwritten(t *testing.T) {
|
||||||
|
ts := newTestServerWith(t, func(c *config.Config) {
|
||||||
|
c.GmailClientID = "fra-miljøet.apps.googleusercontent.com"
|
||||||
|
c.GmailClientSecret = "også-fra-miljøet"
|
||||||
|
})
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
_, shown := ts.do(t, "GET", "/api/v1/gmail/client", nil)
|
||||||
|
if shown["from_env"] != true {
|
||||||
|
t.Errorf("from_env = %v with the environment set", shown["from_env"])
|
||||||
|
}
|
||||||
|
if shown["client_id"] != "fra-miljøet.apps.googleusercontent.com" {
|
||||||
|
t.Errorf("client_id = %v", shown["client_id"])
|
||||||
|
}
|
||||||
|
|
||||||
|
resp, _ := ts.do(t, "PUT", "/api/v1/gmail/client", map[string]any{
|
||||||
|
"client_id": "min-egen", "client_secret": "min-egen",
|
||||||
|
})
|
||||||
|
if resp.StatusCode != http.StatusConflict {
|
||||||
|
t.Fatalf("overwriting the environment: status %d, want 409", resp.StatusCode)
|
||||||
|
}
|
||||||
|
|
||||||
|
_, after := ts.do(t, "GET", "/api/v1/gmail/client", nil)
|
||||||
|
if after["client_id"] != "fra-miljøet.apps.googleusercontent.com" {
|
||||||
|
t.Errorf("the environment's client was replaced: %v", after["client_id"])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Administrators only, and sessions only: this is the instance's identity to
|
||||||
|
// Google, and a leaked token must not be able to read or replace it.
|
||||||
|
func TestTheGmailClientIsAdminsOnlyAndSessionsOnly(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
other := ts.newUser(t, "anden@example.dk", "Anden")
|
||||||
|
|
||||||
|
for _, c := range []struct {
|
||||||
|
method string
|
||||||
|
body any
|
||||||
|
}{{"GET", nil}, {"PUT", map[string]any{"client_id": "x"}}} {
|
||||||
|
if resp, _ := other.do(t, c.method, "/api/v1/gmail/client", c.body); resp.StatusCode != http.StatusForbidden {
|
||||||
|
t.Errorf("%s as an ordinary user: status %d, want 403", c.method, resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
admin, err := ts.db.UserByEmail(t.Context(), "kristian@example.dk")
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
token := ts.apiToken(t, admin.ID)
|
||||||
|
req, _ := http.NewRequest("GET", ts.URL+"/api/v1/gmail/client", nil)
|
||||||
|
req.Header.Set("Authorization", "Bearer "+token)
|
||||||
|
resp, err := (&http.Client{}).Do(req)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
resp.Body.Close()
|
||||||
|
if resp.StatusCode != http.StatusForbidden {
|
||||||
|
t.Errorf("with an admin's API token: status %d, want 403", resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
@@ -154,7 +154,7 @@ func (s *Server) handleMCPWithKey(w http.ResponseWriter, r *http.Request) {
|
|||||||
user, err := s.db.UserByAPIToken(r.Context(), key)
|
user, err := s.db.UserByAPIToken(r.Context(), key)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
if !errors.Is(err, store.ErrNotFound) {
|
if !errors.Is(err, store.ErrNotFound) {
|
||||||
s.internal(w, "mcp key", err)
|
s.internal(w, r, "mcp key", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeError(w, http.StatusUnauthorized, CodeUnauthorized, "that key is not valid")
|
writeError(w, http.StatusUnauthorized, CodeUnauthorized, "that key is not valid")
|
||||||
|
|||||||
@@ -83,7 +83,7 @@ func (s *Server) requireAuth(next http.Handler) http.Handler {
|
|||||||
// as everybody being logged out at once — the frontend clears its state
|
// as everybody being logged out at once — the frontend clears its state
|
||||||
// and shows the sign-in screen — and nothing in the logs says why.
|
// and shows the sign-in screen — and nothing in the logs says why.
|
||||||
if !errors.Is(err, errNoCredentials) && !errors.Is(err, store.ErrNotFound) {
|
if !errors.Is(err, errNoCredentials) && !errors.Is(err, store.ErrNotFound) {
|
||||||
s.internal(w, "authenticate", err)
|
s.internal(w, r, "authenticate", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeError(w, http.StatusUnauthorized, CodeUnauthorized, "not signed in")
|
writeError(w, http.StatusUnauthorized, CodeUnauthorized, "not signed in")
|
||||||
|
|||||||
@@ -27,12 +27,12 @@ func (s *Server) handleListNotifications(w http.ResponseWriter, r *http.Request)
|
|||||||
|
|
||||||
list, err := s.db.ListNotifications(r.Context(), user.ID, 30)
|
list, err := s.db.ListNotifications(r.Context(), user.ID, 30)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list notifications", err)
|
s.internal(w, r, "list notifications", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
unread, err := s.db.UnreadNotificationCount(r.Context(), user.ID)
|
unread, err := s.db.UnreadNotificationCount(r.Context(), user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "count notifications", err)
|
s.internal(w, r, "count notifications", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -50,7 +50,7 @@ func (s *Server) handleListNotifications(w http.ResponseWriter, r *http.Request)
|
|||||||
func (s *Server) handleMarkNotificationsRead(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleMarkNotificationsRead(w http.ResponseWriter, r *http.Request) {
|
||||||
err := s.db.MarkNotificationsRead(r.Context(), userFrom(r.Context()).ID, chi.URLParam(r, "notificationID"))
|
err := s.db.MarkNotificationsRead(r.Context(), userFrom(r.Context()).ID, chi.URLParam(r, "notificationID"))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "mark notifications read", err)
|
s.internal(w, r, "mark notifications read", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
@@ -148,7 +148,7 @@ type pushSubscriptionRequest struct {
|
|||||||
func (s *Server) handlePushKey(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handlePushKey(w http.ResponseWriter, r *http.Request) {
|
||||||
public, _, err := s.vapidKeys(r.Context())
|
public, _, err := s.vapidKeys(r.Context())
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "vapid keys", err)
|
s.internal(w, r, "vapid keys", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, map[string]string{"public_key": public})
|
writeJSON(w, http.StatusOK, map[string]string{"public_key": public})
|
||||||
@@ -172,7 +172,7 @@ func (s *Server) handleSubscribePush(w http.ResponseWriter, r *http.Request) {
|
|||||||
UserAgent: r.UserAgent(),
|
UserAgent: r.UserAgent(),
|
||||||
})
|
})
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "save push subscription", err)
|
s.internal(w, r, "save push subscription", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
@@ -184,7 +184,7 @@ func (s *Server) handleUnsubscribePush(w http.ResponseWriter, r *http.Request) {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.DeletePushSubscription(r.Context(), req.Endpoint); err != nil {
|
if err := s.db.DeletePushSubscription(r.Context(), req.Endpoint); err != nil {
|
||||||
s.internal(w, "delete push subscription", err)
|
s.internal(w, r, "delete push subscription", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
|
|||||||
@@ -0,0 +1,105 @@
|
|||||||
|
package httpapi
|
||||||
|
|
||||||
|
import (
|
||||||
|
"context"
|
||||||
|
"fmt"
|
||||||
|
"net/http"
|
||||||
|
"time"
|
||||||
|
)
|
||||||
|
|
||||||
|
// Asking the panel to restart this instance.
|
||||||
|
//
|
||||||
|
// A container cannot replace its own image from the inside, so "update" is really
|
||||||
|
// "ask whoever owns the container to recreate it" — Yggdrasil pulls `:latest` on
|
||||||
|
// the way, which is what makes a restart an update at all.
|
||||||
|
//
|
||||||
|
// The alternative was a second browser tab: read the version here, go to the
|
||||||
|
// panel, find the server, press Restart. This removes the tab, not the panel's
|
||||||
|
// authority — the panel still does the work and still records who asked.
|
||||||
|
//
|
||||||
|
// Administrators only, and sessions only. A leaked API token that could restart
|
||||||
|
// the server is a denial of service in one request, and the whole point of the
|
||||||
|
// session rule elsewhere in this file is that a stolen token must not be able to
|
||||||
|
// do things only a person at a keyboard should.
|
||||||
|
|
||||||
|
type panelStatusJSON struct {
|
||||||
|
// Configured is all three settings being present. The token itself is never
|
||||||
|
// sent: the page needs to know whether the button can work, not what the
|
||||||
|
// credential is.
|
||||||
|
Configured bool `json:"configured"`
|
||||||
|
PanelURL string `json:"panel_url,omitempty"`
|
||||||
|
// Why it cannot work, when it cannot. An operator reading "not configured"
|
||||||
|
// should not have to go and find out which of three things is missing.
|
||||||
|
Missing []string `json:"missing,omitempty"`
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) panelStatus() panelStatusJSON {
|
||||||
|
var missing []string
|
||||||
|
if s.cfg.PanelURL == "" {
|
||||||
|
missing = append(missing, "VERDANDE_PANEL_URL")
|
||||||
|
}
|
||||||
|
if s.cfg.PanelToken == "" {
|
||||||
|
missing = append(missing, "VERDANDE_PANEL_TOKEN")
|
||||||
|
}
|
||||||
|
if s.cfg.PanelServerID == "" {
|
||||||
|
missing = append(missing, "VERDANDE_PANEL_SERVER_ID")
|
||||||
|
}
|
||||||
|
return panelStatusJSON{
|
||||||
|
Configured: len(missing) == 0,
|
||||||
|
PanelURL: s.cfg.PanelURL,
|
||||||
|
Missing: missing,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) handlePanelStatus(w http.ResponseWriter, r *http.Request) {
|
||||||
|
writeJSON(w, http.StatusOK, s.panelStatus())
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) handleRestartFromPanel(w http.ResponseWriter, r *http.Request) {
|
||||||
|
status := s.panelStatus()
|
||||||
|
if !status.Configured {
|
||||||
|
writeError(w, http.StatusServiceUnavailable, CodeInternal,
|
||||||
|
fmt.Sprintf("this instance cannot restart itself: %v are not set", status.Missing))
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
user := userFrom(r.Context())
|
||||||
|
s.log.Info("restart requested from the interface", "user", user.ID, "server", s.cfg.PanelServerID)
|
||||||
|
|
||||||
|
// A short timeout of its own. The panel stops this container as part of
|
||||||
|
// answering, so the reply may never arrive — that is not a failure, and a
|
||||||
|
// request that hung waiting for it would look like one.
|
||||||
|
ctx, cancel := context.WithTimeout(context.WithoutCancel(r.Context()), 10*time.Second)
|
||||||
|
defer cancel()
|
||||||
|
|
||||||
|
url := fmt.Sprintf("%s/api/servers/%s/restart", s.cfg.PanelURL, s.cfg.PanelServerID)
|
||||||
|
req, err := http.NewRequestWithContext(ctx, http.MethodPost, url, nil)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "build panel request", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
req.Header.Set("Authorization", "Bearer "+s.cfg.PanelToken)
|
||||||
|
|
||||||
|
resp, err := (&http.Client{Timeout: 10 * time.Second}).Do(req)
|
||||||
|
if err != nil {
|
||||||
|
// Including "the panel killed us mid-reply", which is the successful case
|
||||||
|
// wearing a failure's clothes. The interface polls /healthz rather than
|
||||||
|
// believing either answer, so this only has to be honest about what it saw.
|
||||||
|
s.log.Warn("panel restart call did not complete", "err", err)
|
||||||
|
writeJSON(w, http.StatusAccepted, map[string]any{
|
||||||
|
"restarting": true,
|
||||||
|
"note": "the panel did not answer; it may already be restarting this container",
|
||||||
|
})
|
||||||
|
return
|
||||||
|
}
|
||||||
|
defer resp.Body.Close()
|
||||||
|
|
||||||
|
if resp.StatusCode >= 400 {
|
||||||
|
s.log.Error("panel refused the restart", "status", resp.StatusCode)
|
||||||
|
writeError(w, http.StatusBadGateway, CodeInternal,
|
||||||
|
fmt.Sprintf("the panel refused: HTTP %d — check VERDANDE_PANEL_TOKEN has control of this server", resp.StatusCode))
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
writeJSON(w, http.StatusAccepted, map[string]any{"restarting": true})
|
||||||
|
}
|
||||||
@@ -0,0 +1,131 @@
|
|||||||
|
package httpapi
|
||||||
|
|
||||||
|
import (
|
||||||
|
"net/http"
|
||||||
|
"net/http/httptest"
|
||||||
|
"testing"
|
||||||
|
|
||||||
|
"github.com/kristianwind/verdande/internal/config"
|
||||||
|
)
|
||||||
|
|
||||||
|
// Restarting is administrators only, and sessions only. A leaked API token that
|
||||||
|
// could restart the server is a denial of service in one request.
|
||||||
|
func TestRestartingIsAdminsOnlyAndSessionsOnly(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
other := ts.newUser(t, "anden@example.dk", "Anden")
|
||||||
|
|
||||||
|
for _, path := range []string{"/api/v1/panel", "/api/v1/panel/restart"} {
|
||||||
|
method := "GET"
|
||||||
|
if path != "/api/v1/panel" {
|
||||||
|
method = "POST"
|
||||||
|
}
|
||||||
|
if resp, _ := other.do(t, method, path, nil); resp.StatusCode != http.StatusForbidden {
|
||||||
|
t.Errorf("%s as an ordinary user: status %d, want 403", path, resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
admin, err := ts.db.UserByEmail(t.Context(), "kristian@example.dk")
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
token := ts.apiToken(t, admin.ID)
|
||||||
|
req, _ := http.NewRequest("POST", ts.URL+"/api/v1/panel/restart", nil)
|
||||||
|
req.Header.Set("Authorization", "Bearer "+token)
|
||||||
|
resp, err := (&http.Client{}).Do(req)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
resp.Body.Close()
|
||||||
|
if resp.StatusCode != http.StatusForbidden {
|
||||||
|
t.Errorf("restart with an admin's API token: status %d, want 403", resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Unconfigured, it says which of the three settings are missing rather than
|
||||||
|
// "not configured" — an operator should not have to go and find out which.
|
||||||
|
func TestAnUnconfiguredPanelSaysWhatIsMissing(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
_, status := ts.do(t, "GET", "/api/v1/panel", nil)
|
||||||
|
if status["configured"] != false {
|
||||||
|
t.Fatalf("configured = %v on an instance with no panel settings", status["configured"])
|
||||||
|
}
|
||||||
|
missing, _ := status["missing"].([]any)
|
||||||
|
if len(missing) != 3 {
|
||||||
|
t.Errorf("missing = %v, want all three settings named", missing)
|
||||||
|
}
|
||||||
|
|
||||||
|
resp, body := ts.do(t, "POST", "/api/v1/panel/restart", nil)
|
||||||
|
if resp.StatusCode != http.StatusServiceUnavailable {
|
||||||
|
t.Errorf("restart with nothing configured: status %d, want 503", resp.StatusCode)
|
||||||
|
}
|
||||||
|
if body["error"] == nil {
|
||||||
|
t.Error("the refusal says nothing about why")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Configured, it calls the panel with a bearer token and reports what came back.
|
||||||
|
func TestARestartCallsThePanelWithItsToken(t *testing.T) {
|
||||||
|
var gotPath, gotAuth string
|
||||||
|
panel := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
||||||
|
gotPath, gotAuth = r.URL.Path, r.Header.Get("Authorization")
|
||||||
|
w.WriteHeader(http.StatusOK)
|
||||||
|
}))
|
||||||
|
defer panel.Close()
|
||||||
|
|
||||||
|
ts := newTestServerWith(t, func(cfg *config.Config) {
|
||||||
|
cfg.PanelURL = panel.URL
|
||||||
|
cfg.PanelToken = "hemmelig"
|
||||||
|
cfg.PanelServerID = "abc-123"
|
||||||
|
})
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
_, status := ts.do(t, "GET", "/api/v1/panel", nil)
|
||||||
|
if status["configured"] != true {
|
||||||
|
t.Fatalf("configured = %v with all three set", status["configured"])
|
||||||
|
}
|
||||||
|
// The token is a credential and must never reach a browser.
|
||||||
|
for key, value := range status {
|
||||||
|
if s, ok := value.(string); ok && s == "hemmelig" {
|
||||||
|
t.Errorf("the panel token was sent to the client in %q", key)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
resp, _ := ts.do(t, "POST", "/api/v1/panel/restart", nil)
|
||||||
|
if resp.StatusCode != http.StatusAccepted {
|
||||||
|
t.Fatalf("restart: status %d, want 202", resp.StatusCode)
|
||||||
|
}
|
||||||
|
if gotPath != "/api/servers/abc-123/restart" {
|
||||||
|
t.Errorf("called %q", gotPath)
|
||||||
|
}
|
||||||
|
if gotAuth != "Bearer hemmelig" {
|
||||||
|
t.Errorf("Authorization = %q", gotAuth)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// A panel that refuses is reported as the panel refusing, not as this server
|
||||||
|
// breaking: the fix is a token with control of that server, and saying "internal
|
||||||
|
// error" would send somebody looking in the wrong place.
|
||||||
|
func TestAPanelThatRefusesIsReportedAsSuch(t *testing.T) {
|
||||||
|
panel := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
||||||
|
http.Error(w, "forbidden", http.StatusForbidden)
|
||||||
|
}))
|
||||||
|
defer panel.Close()
|
||||||
|
|
||||||
|
ts := newTestServerWith(t, func(cfg *config.Config) {
|
||||||
|
cfg.PanelURL = panel.URL
|
||||||
|
cfg.PanelToken = "forkert"
|
||||||
|
cfg.PanelServerID = "abc-123"
|
||||||
|
})
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
resp, body := ts.do(t, "POST", "/api/v1/panel/restart", nil)
|
||||||
|
if resp.StatusCode != http.StatusBadGateway {
|
||||||
|
t.Errorf("a refusing panel: status %d, want 502", resp.StatusCode)
|
||||||
|
}
|
||||||
|
if msg, _ := body["error"].(string); msg == "" {
|
||||||
|
t.Error("the refusal does not say what to check")
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,404 @@
|
|||||||
|
package httpapi
|
||||||
|
|
||||||
|
import (
|
||||||
|
"encoding/json"
|
||||||
|
"net/http"
|
||||||
|
"strings"
|
||||||
|
"time"
|
||||||
|
|
||||||
|
"github.com/go-chi/chi/v5"
|
||||||
|
"github.com/go-webauthn/webauthn/protocol"
|
||||||
|
"github.com/go-webauthn/webauthn/webauthn"
|
||||||
|
|
||||||
|
"github.com/kristianwind/verdande/internal/auth"
|
||||||
|
"github.com/kristianwind/verdande/internal/store"
|
||||||
|
)
|
||||||
|
|
||||||
|
// Passkeys: a key on a device instead of a secret in a head.
|
||||||
|
//
|
||||||
|
// Four endpoints, in two pairs. Registration is done by somebody already signed in
|
||||||
|
// — you cannot be handed a way into an account you have not proved you own.
|
||||||
|
// Logging in is done by somebody who is not, and is the one place here that is
|
||||||
|
// reachable without a session.
|
||||||
|
//
|
||||||
|
// Each ceremony is two requests because the browser has to talk to the
|
||||||
|
// authenticator in between: the server issues a challenge, the device signs it,
|
||||||
|
// the server checks the signature against what it remembers issuing. The challenge
|
||||||
|
// lives in the database rather than in a cookie, because the whole point of it is
|
||||||
|
// that the server chose it and remembers choosing it.
|
||||||
|
|
||||||
|
const challengeTTL = 5 * time.Minute
|
||||||
|
|
||||||
|
// passkeyAvailable answers 503 rather than 404 when the relying party could not be
|
||||||
|
// built. 404 would read as "this version does not have passkeys"; the truth is
|
||||||
|
// that this deployment cannot offer them, which is a different thing to fix.
|
||||||
|
func (s *Server) passkeyAvailable(w http.ResponseWriter, r *http.Request) bool {
|
||||||
|
if s.passkeys != nil {
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
writeError(w, http.StatusServiceUnavailable, CodeInternal,
|
||||||
|
"passkeys are unavailable on this instance: VERDANDE_BASE_URL is not an address an authenticator will accept")
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
type passkeyJSON struct {
|
||||||
|
ID string `json:"id"`
|
||||||
|
Name string `json:"name"`
|
||||||
|
// AAGUID identifies the authenticator model, which is what lets the list say
|
||||||
|
// something recognisable beside a key somebody named three months ago.
|
||||||
|
AAGUID string `json:"aaguid,omitempty"`
|
||||||
|
Discoverable bool `json:"discoverable"`
|
||||||
|
UserVerified bool `json:"user_verified"`
|
||||||
|
CreatedAt string `json:"created_at"`
|
||||||
|
LastUsedAt string `json:"last_used_at,omitempty"`
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) handleListPasskeys(w http.ResponseWriter, r *http.Request) {
|
||||||
|
keys, err := s.db.ListPasskeys(r.Context(), userFrom(r.Context()).ID)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "list passkeys", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
out := make([]passkeyJSON, 0, len(keys))
|
||||||
|
for _, k := range keys {
|
||||||
|
j := passkeyJSON{
|
||||||
|
ID: k.ID, Name: k.Name, AAGUID: k.AAGUID,
|
||||||
|
Discoverable: k.Discoverable, UserVerified: k.UserVerified,
|
||||||
|
CreatedAt: k.CreatedAt.Format(time.RFC3339),
|
||||||
|
}
|
||||||
|
if !k.LastUsedAt.IsZero() {
|
||||||
|
j.LastUsedAt = k.LastUsedAt.Format(time.RFC3339)
|
||||||
|
}
|
||||||
|
out = append(out, j)
|
||||||
|
}
|
||||||
|
// Whether this deployment can offer them at all, alongside the ones that exist.
|
||||||
|
// The interface asks one question rather than discovering the answer from a 503
|
||||||
|
// it triggered by offering a button — an address an authenticator refuses is a
|
||||||
|
// deployment fact, not an error somebody caused.
|
||||||
|
writeJSON(w, http.StatusOK, map[string]any{
|
||||||
|
"passkeys": out, "available": s.passkeys != nil,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
// --- registering a key ------------------------------------------------------------
|
||||||
|
|
||||||
|
func (s *Server) handleBeginPasskeyRegistration(w http.ResponseWriter, r *http.Request) {
|
||||||
|
if !s.passkeyAvailable(w, r) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
user := userFrom(r.Context())
|
||||||
|
|
||||||
|
account, err := s.passkeyUser(r, user.ID, user.Email, user.Name)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "load passkeys", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
// Resident keys, and the authenticator asked to verify its owner. Both are
|
||||||
|
// what make this a *passkey* rather than a second factor: only a discoverable
|
||||||
|
// credential can start a login with no email typed, and only a verified one
|
||||||
|
// stands in for the password rather than beside it.
|
||||||
|
creation, session, err := s.passkeys.BeginRegistration(account,
|
||||||
|
webauthn.WithResidentKeyRequirement(protocol.ResidentKeyRequirementPreferred),
|
||||||
|
webauthn.WithAuthenticatorSelection(protocol.AuthenticatorSelection{
|
||||||
|
ResidentKey: protocol.ResidentKeyRequirementPreferred,
|
||||||
|
UserVerification: protocol.VerificationPreferred,
|
||||||
|
}),
|
||||||
|
// Excluding what they already have, so a second registration on the same
|
||||||
|
// device replaces nothing and reports itself instead of silently making a
|
||||||
|
// duplicate.
|
||||||
|
webauthn.WithExclusions(account.excludeList()),
|
||||||
|
)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "begin passkey registration", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
s.issueChallenge(w, r, user.ID, "register", session, creation)
|
||||||
|
}
|
||||||
|
|
||||||
|
type finishRegistrationRequest struct {
|
||||||
|
ChallengeID string `json:"challenge_id"`
|
||||||
|
Name string `json:"name"`
|
||||||
|
Credential json.RawMessage `json:"credential"`
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) handleFinishPasskeyRegistration(w http.ResponseWriter, r *http.Request) {
|
||||||
|
if !s.passkeyAvailable(w, r) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
var req finishRegistrationRequest
|
||||||
|
if err := decodeJSON(w, r, &req); err != nil {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
user := userFrom(r.Context())
|
||||||
|
|
||||||
|
session, ok := s.takeChallenge(w, r, req.ChallengeID, "register", user.ID)
|
||||||
|
if !ok {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
parsed, err := protocol.ParseCredentialCreationResponseBody(strings.NewReader(string(req.Credential)))
|
||||||
|
if err != nil {
|
||||||
|
writeError(w, http.StatusBadRequest, CodeBadRequest, "that response could not be read")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
account, err := s.passkeyUser(r, user.ID, user.Email, user.Name)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "load passkeys", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
credential, err := s.passkeys.CreateCredential(account, *session, parsed)
|
||||||
|
if err != nil {
|
||||||
|
writeError(w, http.StatusBadRequest, CodeBadRequest, "that key could not be verified")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
name := strings.TrimSpace(req.Name)
|
||||||
|
if name == "" {
|
||||||
|
name = "Passkey"
|
||||||
|
}
|
||||||
|
key := &store.Passkey{
|
||||||
|
UserID: user.ID,
|
||||||
|
CredentialID: auth.EncodeCredentialID(credential.ID),
|
||||||
|
PublicKey: credential.PublicKey,
|
||||||
|
AAGUID: auth.EncodeCredentialID(credential.Authenticator.AAGUID),
|
||||||
|
SignCount: credential.Authenticator.SignCount,
|
||||||
|
Discoverable: credential.Flags.BackupEligible || parsed.Response.AttestationObject.AuthData.Flags.HasBackupState(),
|
||||||
|
UserVerified: credential.Flags.UserVerified,
|
||||||
|
Name: name,
|
||||||
|
}
|
||||||
|
if err := s.db.CreatePasskey(r.Context(), key); err != nil {
|
||||||
|
s.internal(w, r, "store passkey", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
writeJSON(w, http.StatusCreated, passkeyJSON{
|
||||||
|
ID: key.ID, Name: key.Name, AAGUID: key.AAGUID,
|
||||||
|
Discoverable: key.Discoverable, UserVerified: key.UserVerified,
|
||||||
|
CreatedAt: key.CreatedAt.Format(time.RFC3339),
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
// --- signing in with a key ---------------------------------------------------------
|
||||||
|
|
||||||
|
func (s *Server) handleBeginPasskeyLogin(w http.ResponseWriter, r *http.Request) {
|
||||||
|
if !s.passkeyAvailable(w, r) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
// Discoverable: nobody has said who they are yet, and that is the point. The
|
||||||
|
// device knows which account its key belongs to, so there is no email to type
|
||||||
|
// and no list of accounts for anybody to probe.
|
||||||
|
assertion, session, err := s.passkeys.BeginDiscoverableLogin()
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "begin passkey login", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
s.issueChallenge(w, r, "", "login", session, assertion)
|
||||||
|
}
|
||||||
|
|
||||||
|
type finishLoginRequest struct {
|
||||||
|
ChallengeID string `json:"challenge_id"`
|
||||||
|
Credential json.RawMessage `json:"credential"`
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) handleFinishPasskeyLogin(w http.ResponseWriter, r *http.Request) {
|
||||||
|
if !s.passkeyAvailable(w, r) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
var req finishLoginRequest
|
||||||
|
if err := decodeJSON(w, r, &req); err != nil {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
session, ok := s.takeChallenge(w, r, req.ChallengeID, "login", "")
|
||||||
|
if !ok {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
parsed, err := protocol.ParseCredentialRequestResponseBody(strings.NewReader(string(req.Credential)))
|
||||||
|
if err != nil {
|
||||||
|
writeError(w, http.StatusBadRequest, CodeBadRequest, "that response could not be read")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
// Which account, resolved from the credential the device signed with. The
|
||||||
|
// handler is given the raw id and returns the owner; the library checks the
|
||||||
|
// signature against that owner's stored public key.
|
||||||
|
var matched *store.Passkey
|
||||||
|
credential, err := s.passkeys.ValidateDiscoverableLogin(
|
||||||
|
func(rawID, userHandle []byte) (webauthn.User, error) {
|
||||||
|
key, err := s.db.PasskeyByCredentialID(r.Context(), auth.EncodeCredentialID(rawID))
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
matched = key
|
||||||
|
owner, err := s.db.UserByID(r.Context(), key.UserID)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return s.passkeyUser(r, owner.ID, owner.Email, owner.Name)
|
||||||
|
}, *session, parsed)
|
||||||
|
if err != nil || matched == nil {
|
||||||
|
// One message, as with a wrong password: telling "no such key" apart from
|
||||||
|
// "bad signature" is a way to learn which credentials exist here.
|
||||||
|
writeError(w, http.StatusUnauthorized, CodeUnauthorized, "that key was not accepted")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
// A counter that goes backwards means the credential has been cloned. Not
|
||||||
|
// every authenticator keeps one, so zero on both sides is silence rather than
|
||||||
|
// suspicion — but a real counter that has gone down is the one signal this
|
||||||
|
// design gives, and it is refused rather than logged.
|
||||||
|
if credential.Authenticator.CloneWarning {
|
||||||
|
s.log.Warn("passkey clone warning", "passkey", matched.ID, "user", matched.UserID)
|
||||||
|
writeError(w, http.StatusUnauthorized, CodeUnauthorized, "that key was not accepted")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
owner, err := s.db.UserByID(r.Context(), matched.UserID)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "load account", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
if err := s.db.TouchPasskey(r.Context(), matched.ID, credential.Authenticator.SignCount); err != nil {
|
||||||
|
s.log.Warn("record passkey use", "err", err)
|
||||||
|
}
|
||||||
|
s.loginLimiter.reset(clientIP(r))
|
||||||
|
|
||||||
|
// A verified key is both factors at once: the device proved possession and the
|
||||||
|
// person proved they were there, which is exactly what a password plus a code
|
||||||
|
// is for. One that only proved possession still stops at the code.
|
||||||
|
pending := owner.TOTPEnabled && !credential.Flags.UserVerified
|
||||||
|
ttl := s.cfg.SessionTTL
|
||||||
|
if pending {
|
||||||
|
ttl = 10 * time.Minute
|
||||||
|
}
|
||||||
|
token, _, err := s.db.CreateSession(r.Context(), owner.ID, r.UserAgent(), clientIP(r), ttl, pending)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "create session", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
s.setSessionCookie(w, token, ttl)
|
||||||
|
|
||||||
|
if pending {
|
||||||
|
writeJSON(w, http.StatusOK, loginResponse{TOTPRequired: true})
|
||||||
|
return
|
||||||
|
}
|
||||||
|
uj := toUserJSON(owner)
|
||||||
|
writeJSON(w, http.StatusOK, loginResponse{User: &uj})
|
||||||
|
}
|
||||||
|
|
||||||
|
// --- managing them ------------------------------------------------------------------
|
||||||
|
|
||||||
|
func (s *Server) handleRenamePasskey(w http.ResponseWriter, r *http.Request) {
|
||||||
|
var req struct {
|
||||||
|
Name string `json:"name"`
|
||||||
|
}
|
||||||
|
if err := decodeJSON(w, r, &req); err != nil {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
name := strings.TrimSpace(req.Name)
|
||||||
|
if name == "" {
|
||||||
|
writeFieldErrors(w, map[string]string{"name": "required"})
|
||||||
|
return
|
||||||
|
}
|
||||||
|
if err := s.db.RenamePasskey(r.Context(), chi.URLParam(r, "passkeyID"),
|
||||||
|
userFrom(r.Context()).ID, name); err != nil {
|
||||||
|
s.storeError(w, r, "rename passkey", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
w.WriteHeader(http.StatusNoContent)
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) handleDeletePasskey(w http.ResponseWriter, r *http.Request) {
|
||||||
|
if err := s.db.DeletePasskey(r.Context(), chi.URLParam(r, "passkeyID"),
|
||||||
|
userFrom(r.Context()).ID); err != nil {
|
||||||
|
s.storeError(w, r, "delete passkey", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
w.WriteHeader(http.StatusNoContent)
|
||||||
|
}
|
||||||
|
|
||||||
|
// --- shared plumbing -----------------------------------------------------------------
|
||||||
|
|
||||||
|
// passkeyAccount is the library's view of an account, plus the rows behind it.
|
||||||
|
type passkeyAccount struct {
|
||||||
|
*auth.PasskeyUser
|
||||||
|
stored []store.Passkey
|
||||||
|
}
|
||||||
|
|
||||||
|
func (a *passkeyAccount) excludeList() []protocol.CredentialDescriptor {
|
||||||
|
out := make([]protocol.CredentialDescriptor, 0, len(a.stored))
|
||||||
|
for _, c := range a.PasskeyUser.Credentials {
|
||||||
|
out = append(out, c.Descriptor())
|
||||||
|
}
|
||||||
|
return out
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) passkeyUser(r *http.Request, userID, email, name string) (*passkeyAccount, error) {
|
||||||
|
keys, err := s.db.ListPasskeys(r.Context(), userID)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
credentials := make([]webauthn.Credential, 0, len(keys))
|
||||||
|
for _, k := range keys {
|
||||||
|
raw, err := auth.DecodeCredentialID(k.CredentialID)
|
||||||
|
if err != nil {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
credentials = append(credentials, webauthn.Credential{
|
||||||
|
ID: raw,
|
||||||
|
PublicKey: k.PublicKey,
|
||||||
|
Authenticator: webauthn.Authenticator{
|
||||||
|
SignCount: k.SignCount,
|
||||||
|
},
|
||||||
|
})
|
||||||
|
}
|
||||||
|
return &passkeyAccount{
|
||||||
|
PasskeyUser: &auth.PasskeyUser{
|
||||||
|
ID: userID, Email: email, Name: name, Credentials: credentials,
|
||||||
|
},
|
||||||
|
stored: keys,
|
||||||
|
}, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// issueChallenge stores the server's side of a ceremony and hands the browser the
|
||||||
|
// options plus the id it will answer with.
|
||||||
|
func (s *Server) issueChallenge(w http.ResponseWriter, r *http.Request, userID, purpose string, session *webauthn.SessionData, options any) {
|
||||||
|
encoded, err := json.Marshal(session)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "encode webauthn session", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
id, err := s.db.StoreChallenge(r.Context(), userID, string(session.Challenge), purpose, encoded, challengeTTL)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "store challenge", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
writeJSON(w, http.StatusOK, map[string]any{"challenge_id": id, "options": options})
|
||||||
|
}
|
||||||
|
|
||||||
|
// takeChallenge reads a challenge once and checks it belongs where it is being
|
||||||
|
// used. A registration challenge answered by a login — or one account's answered
|
||||||
|
// by another — is refused rather than merely failing later.
|
||||||
|
func (s *Server) takeChallenge(w http.ResponseWriter, r *http.Request, id, purpose, userID string) (*webauthn.SessionData, bool) {
|
||||||
|
owner, raw, err := s.db.TakeChallenge(r.Context(), id, purpose)
|
||||||
|
if err != nil {
|
||||||
|
writeError(w, http.StatusBadRequest, CodeBadRequest,
|
||||||
|
"that attempt has expired or was already used; start again")
|
||||||
|
return nil, false
|
||||||
|
}
|
||||||
|
if userID != "" && owner != userID {
|
||||||
|
writeError(w, http.StatusBadRequest, CodeBadRequest, "that attempt belongs to another account")
|
||||||
|
return nil, false
|
||||||
|
}
|
||||||
|
var session webauthn.SessionData
|
||||||
|
if err := json.Unmarshal(raw, &session); err != nil {
|
||||||
|
s.internal(w, r, "decode webauthn session", err)
|
||||||
|
return nil, false
|
||||||
|
}
|
||||||
|
return &session, true
|
||||||
|
}
|
||||||
@@ -0,0 +1,201 @@
|
|||||||
|
package httpapi
|
||||||
|
|
||||||
|
import (
|
||||||
|
"encoding/json"
|
||||||
|
"net/http"
|
||||||
|
"testing"
|
||||||
|
|
||||||
|
"github.com/kristianwind/verdande/internal/store"
|
||||||
|
)
|
||||||
|
|
||||||
|
// What can be tested without an authenticator, which is most of the surface that
|
||||||
|
// actually goes wrong.
|
||||||
|
//
|
||||||
|
// The signature itself cannot be produced here — that needs a real device or a
|
||||||
|
// virtual one, and Playwright's CDP virtual authenticator is where that belongs.
|
||||||
|
// What is testable is everything around it: who may reach these endpoints, that a
|
||||||
|
// challenge is answerable exactly once, that one account's challenge cannot be
|
||||||
|
// answered by another, and that an expired one is refused. Those are the parts a
|
||||||
|
// mistake would make silently permissive.
|
||||||
|
|
||||||
|
func TestPasskeyRegistrationIsSessionsOnly(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
admin, err := ts.db.UserByEmail(t.Context(), "kristian@example.dk")
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
token := ts.apiToken(t, admin.ID)
|
||||||
|
|
||||||
|
// A leaked API token must not be able to add its own way in: that would turn a
|
||||||
|
// theft into a tenancy.
|
||||||
|
for _, c := range []struct{ method, path string }{
|
||||||
|
{"GET", "/api/v1/auth/passkeys"},
|
||||||
|
{"POST", "/api/v1/auth/passkeys/register/begin"},
|
||||||
|
{"POST", "/api/v1/auth/passkeys/register/finish"},
|
||||||
|
} {
|
||||||
|
req, _ := http.NewRequest(c.method, ts.URL+c.path, nil)
|
||||||
|
req.Header.Set("Authorization", "Bearer "+token)
|
||||||
|
resp, err := (&http.Client{}).Do(req)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
resp.Body.Close()
|
||||||
|
if resp.StatusCode != http.StatusForbidden {
|
||||||
|
t.Errorf("%s %s with an API token: status %d, want 403", c.method, c.path, resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Beginning a registration hands back options and a challenge id, and the options
|
||||||
|
// carry the things that make this a passkey rather than a second factor.
|
||||||
|
func TestBeginningARegistrationAsksForADiscoverableVerifiedKey(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
resp, body := ts.do(t, "POST", "/api/v1/auth/passkeys/register/begin", nil)
|
||||||
|
if resp.StatusCode != http.StatusOK {
|
||||||
|
t.Fatalf("begin: status %d, body %v", resp.StatusCode, body)
|
||||||
|
}
|
||||||
|
if body["challenge_id"] == "" || body["challenge_id"] == nil {
|
||||||
|
t.Fatal("no challenge id came back")
|
||||||
|
}
|
||||||
|
|
||||||
|
options, _ := body["options"].(map[string]any)
|
||||||
|
publicKey, _ := options["publicKey"].(map[string]any)
|
||||||
|
if publicKey == nil {
|
||||||
|
t.Fatalf("no publicKey in the options: %v", options)
|
||||||
|
}
|
||||||
|
selection, _ := publicKey["authenticatorSelection"].(map[string]any)
|
||||||
|
if selection["residentKey"] != "preferred" {
|
||||||
|
t.Errorf("residentKey = %v — only a discoverable credential can start a login "+
|
||||||
|
"with no email typed", selection["residentKey"])
|
||||||
|
}
|
||||||
|
if selection["userVerification"] != "preferred" {
|
||||||
|
t.Errorf("userVerification = %v — a key that only proves possession cannot "+
|
||||||
|
"stand in for the password", selection["userVerification"])
|
||||||
|
}
|
||||||
|
// The user handle must be the account id rather than the email: it is written
|
||||||
|
// into the credential and cannot be changed, so an email there would orphan
|
||||||
|
// every key the moment somebody changed their address.
|
||||||
|
user, _ := publicKey["user"].(map[string]any)
|
||||||
|
if user["name"] != "kristian@example.dk" {
|
||||||
|
t.Errorf("user.name = %v", user["name"])
|
||||||
|
}
|
||||||
|
if id, _ := user["id"].(string); id == "" {
|
||||||
|
t.Error("no user handle in the options")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// A challenge is answerable exactly once, and only by whom it was issued to.
|
||||||
|
func TestAChallengeIsSpentWhenItIsUsed(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
other := ts.newUser(t, "anden@example.dk", "Anden")
|
||||||
|
|
||||||
|
_, begun := ts.do(t, "POST", "/api/v1/auth/passkeys/register/begin", nil)
|
||||||
|
challenge := begun["challenge_id"].(string)
|
||||||
|
|
||||||
|
// Somebody else's challenge, answered by this account. Refused before the
|
||||||
|
// signature is even looked at.
|
||||||
|
resp, _ := other.do(t, "POST", "/api/v1/auth/passkeys/register/finish", map[string]any{
|
||||||
|
"challenge_id": challenge, "credential": json.RawMessage(`{}`),
|
||||||
|
})
|
||||||
|
if resp.StatusCode != http.StatusBadRequest {
|
||||||
|
t.Errorf("another account's challenge: status %d, want 400", resp.StatusCode)
|
||||||
|
}
|
||||||
|
|
||||||
|
// And it is spent: the rightful owner cannot use it either now, because taking
|
||||||
|
// it is what deleted it. That is deliberate — a challenge that survives a
|
||||||
|
// failed attempt is a challenge somebody can keep trying.
|
||||||
|
resp, _ = ts.do(t, "POST", "/api/v1/auth/passkeys/register/finish", map[string]any{
|
||||||
|
"challenge_id": challenge, "credential": json.RawMessage(`{}`),
|
||||||
|
})
|
||||||
|
if resp.StatusCode != http.StatusBadRequest {
|
||||||
|
t.Errorf("a spent challenge: status %d, want 400", resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Logging in with a key needs no session and says nothing about who exists here.
|
||||||
|
func TestPasskeyLoginRevealsNothingAboutWhoHasAKey(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
// No session at all — a fresh client, which is the whole point.
|
||||||
|
fresh := &testServer{Server: ts.Server, db: ts.db, client: newJarClient(t)}
|
||||||
|
|
||||||
|
resp, body := fresh.do(t, "POST", "/api/v1/auth/passkey/login/begin", nil)
|
||||||
|
if resp.StatusCode != http.StatusOK {
|
||||||
|
t.Fatalf("begin login: status %d, body %v", resp.StatusCode, body)
|
||||||
|
}
|
||||||
|
challenge := body["challenge_id"].(string)
|
||||||
|
|
||||||
|
options, _ := body["options"].(map[string]any)
|
||||||
|
publicKey, _ := options["publicKey"].(map[string]any)
|
||||||
|
// A discoverable login must not list credentials: that list would say which
|
||||||
|
// keys exist on this instance to anybody who asked.
|
||||||
|
if allowed, present := publicKey["allowCredentials"]; present && allowed != nil {
|
||||||
|
if list, _ := allowed.([]any); len(list) > 0 {
|
||||||
|
t.Errorf("the login options list %d credentials; a discoverable login must not",
|
||||||
|
len(list))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// A garbage answer is refused with the same message a wrong key would get.
|
||||||
|
resp, _ = fresh.do(t, "POST", "/api/v1/auth/passkey/login/finish", map[string]any{
|
||||||
|
"challenge_id": challenge, "credential": json.RawMessage(`{}`),
|
||||||
|
})
|
||||||
|
if resp.StatusCode != http.StatusBadRequest && resp.StatusCode != http.StatusUnauthorized {
|
||||||
|
t.Errorf("a junk assertion: status %d, want 400 or 401", resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// A key belongs to its owner, and nobody else can rename or remove it.
|
||||||
|
func TestAPasskeyCanOnlyBeManagedByItsOwner(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
other := ts.newUser(t, "anden@example.dk", "Anden")
|
||||||
|
|
||||||
|
admin, err := ts.db.UserByEmail(t.Context(), "kristian@example.dk")
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
// Written straight to the store: registering one properly needs a device.
|
||||||
|
key := &store.Passkey{
|
||||||
|
UserID: admin.ID, CredentialID: "abc", PublicKey: []byte{1, 2, 3}, Name: "Min bærbare",
|
||||||
|
}
|
||||||
|
if err := ts.db.CreatePasskey(t.Context(), key); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
|
||||||
|
_, listed := ts.do(t, "GET", "/api/v1/auth/passkeys", nil)
|
||||||
|
if keys, _ := listed["passkeys"].([]any); len(keys) != 1 {
|
||||||
|
t.Fatalf("the owner sees %d keys, want 1", len(keys))
|
||||||
|
}
|
||||||
|
_, theirs := other.do(t, "GET", "/api/v1/auth/passkeys", nil)
|
||||||
|
if keys, _ := theirs["passkeys"].([]any); len(keys) != 0 {
|
||||||
|
t.Errorf("somebody else sees %d of this account's keys", len(keys))
|
||||||
|
}
|
||||||
|
|
||||||
|
for _, c := range []struct {
|
||||||
|
what, method string
|
||||||
|
body any
|
||||||
|
}{
|
||||||
|
{"rename", "PATCH", map[string]any{"name": "min nu"}},
|
||||||
|
{"delete", "DELETE", nil},
|
||||||
|
} {
|
||||||
|
resp, _ := other.do(t, c.method, "/api/v1/auth/passkeys/"+key.ID, c.body)
|
||||||
|
if resp.StatusCode != http.StatusNotFound {
|
||||||
|
t.Errorf("%s somebody else's key: status %d, want 404", c.what, resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if resp, _ := ts.do(t, "PATCH", "/api/v1/auth/passkeys/"+key.ID,
|
||||||
|
map[string]any{"name": "Telefonen"}); resp.StatusCode != http.StatusNoContent {
|
||||||
|
t.Errorf("the owner renaming: status %d", resp.StatusCode)
|
||||||
|
}
|
||||||
|
if resp, _ := ts.do(t, "DELETE", "/api/v1/auth/passkeys/"+key.ID, nil); resp.StatusCode != http.StatusNoContent {
|
||||||
|
t.Errorf("the owner deleting: status %d", resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -2,6 +2,8 @@ package httpapi
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"net/http"
|
"net/http"
|
||||||
|
"os"
|
||||||
|
"path/filepath"
|
||||||
"strings"
|
"strings"
|
||||||
|
|
||||||
"github.com/go-chi/chi/v5"
|
"github.com/go-chi/chi/v5"
|
||||||
@@ -17,20 +19,25 @@ import (
|
|||||||
// that is not yours is not found.
|
// that is not yours is not found.
|
||||||
|
|
||||||
type projectGroupJSON struct {
|
type projectGroupJSON struct {
|
||||||
ID string `json:"id"`
|
ID string `json:"id"`
|
||||||
Name string `json:"name"`
|
Name string `json:"name"`
|
||||||
Collapsed bool `json:"collapsed"`
|
Color string `json:"color"`
|
||||||
SortOrder float64 `json:"sort_order"`
|
Description string `json:"description"`
|
||||||
|
Collapsed bool `json:"collapsed"`
|
||||||
|
SortOrder float64 `json:"sort_order"`
|
||||||
}
|
}
|
||||||
|
|
||||||
func toProjectGroupJSON(g store.ProjectGroup) projectGroupJSON {
|
func toProjectGroupJSON(g store.ProjectGroup) projectGroupJSON {
|
||||||
return projectGroupJSON{ID: g.ID, Name: g.Name, Collapsed: g.Collapsed, SortOrder: g.SortOrder}
|
return projectGroupJSON{
|
||||||
|
ID: g.ID, Name: g.Name, Color: g.Color, Description: g.Description,
|
||||||
|
Collapsed: g.Collapsed, SortOrder: g.SortOrder,
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
func (s *Server) handleListProjectGroups(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleListProjectGroups(w http.ResponseWriter, r *http.Request) {
|
||||||
groups, err := s.db.ListProjectGroups(r.Context(), userFrom(r.Context()).ID)
|
groups, err := s.db.ListProjectGroups(r.Context(), userFrom(r.Context()).ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list project groups", err)
|
s.internal(w, r, "list project groups", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
out := make([]projectGroupJSON, 0, len(groups))
|
out := make([]projectGroupJSON, 0, len(groups))
|
||||||
@@ -41,8 +48,10 @@ func (s *Server) handleListProjectGroups(w http.ResponseWriter, r *http.Request)
|
|||||||
}
|
}
|
||||||
|
|
||||||
type projectGroupRequest struct {
|
type projectGroupRequest struct {
|
||||||
Name *string `json:"name"`
|
Name *string `json:"name"`
|
||||||
Collapsed *bool `json:"collapsed"`
|
Color *string `json:"color"`
|
||||||
|
Description *string `json:"description"`
|
||||||
|
Collapsed *bool `json:"collapsed"`
|
||||||
}
|
}
|
||||||
|
|
||||||
func (s *Server) handleCreateProjectGroup(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleCreateProjectGroup(w http.ResponseWriter, r *http.Request) {
|
||||||
@@ -59,12 +68,23 @@ func (s *Server) handleCreateProjectGroup(w http.ResponseWriter, r *http.Request
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if req.Color != nil && !store.ValidColor(*req.Color) {
|
||||||
|
writeFieldErrors(w, map[string]string{"color": colorFieldError})
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
g := &store.ProjectGroup{Name: name, OwnerID: userFrom(r.Context()).ID}
|
g := &store.ProjectGroup{Name: name, OwnerID: userFrom(r.Context()).ID}
|
||||||
|
if req.Color != nil {
|
||||||
|
g.Color = *req.Color
|
||||||
|
}
|
||||||
|
if req.Description != nil {
|
||||||
|
g.Description = strings.TrimSpace(*req.Description)
|
||||||
|
}
|
||||||
if req.Collapsed != nil {
|
if req.Collapsed != nil {
|
||||||
g.Collapsed = *req.Collapsed
|
g.Collapsed = *req.Collapsed
|
||||||
}
|
}
|
||||||
if err := s.db.CreateProjectGroup(r.Context(), g); err != nil {
|
if err := s.db.CreateProjectGroup(r.Context(), g); err != nil {
|
||||||
s.internal(w, "create project group", err)
|
s.internal(w, r, "create project group", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.publishToOwner(r, "project_group.created", toProjectGroupJSON(*g))
|
s.publishToOwner(r, "project_group.created", toProjectGroupJSON(*g))
|
||||||
@@ -87,29 +107,163 @@ func (s *Server) handleUpdateProjectGroup(w http.ResponseWriter, r *http.Request
|
|||||||
}
|
}
|
||||||
req.Name = &name
|
req.Name = &name
|
||||||
}
|
}
|
||||||
|
if req.Color != nil && !store.ValidColor(*req.Color) {
|
||||||
|
writeFieldErrors(w, map[string]string{"color": colorFieldError})
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
if req.Description != nil {
|
||||||
|
description := strings.TrimSpace(*req.Description)
|
||||||
|
if len(description) > 4000 {
|
||||||
|
writeFieldErrors(w, map[string]string{"description": "must be at most 4000 characters"})
|
||||||
|
return
|
||||||
|
}
|
||||||
|
req.Description = &description
|
||||||
|
}
|
||||||
|
|
||||||
if err := s.db.UpdateProjectGroup(r.Context(), groupID, userID, store.ProjectGroupUpdate{
|
if err := s.db.UpdateProjectGroup(r.Context(), groupID, userID, store.ProjectGroupUpdate{
|
||||||
Name: req.Name, Collapsed: req.Collapsed,
|
Name: req.Name, Color: req.Color, Description: req.Description,
|
||||||
|
Collapsed: req.Collapsed,
|
||||||
}); err != nil {
|
}); err != nil {
|
||||||
s.storeError(w, "update project group", err)
|
s.storeError(w, r, "update project group", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
g, err := s.db.GetProjectGroup(r.Context(), groupID, userID)
|
g, err := s.db.GetProjectGroup(r.Context(), groupID, userID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get project group", err)
|
s.storeError(w, r, "get project group", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.publishToOwner(r, "project_group.updated", toProjectGroupJSON(*g))
|
s.publishToOwner(r, "project_group.updated", toProjectGroupJSON(*g))
|
||||||
writeJSON(w, http.StatusOK, toProjectGroupJSON(*g))
|
writeJSON(w, http.StatusOK, toProjectGroupJSON(*g))
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// groupProjectJSON is a project as the group's page lists it: the project, plus
|
||||||
|
// how much is left in it. Open tasks, not all of them — "12" beside a project
|
||||||
|
// somebody finished last year is a number that means nothing.
|
||||||
|
type groupProjectJSON struct {
|
||||||
|
projectJSON
|
||||||
|
OpenTasks int `json:"open_tasks"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// handleGetProjectGroup is the group as a place rather than a heading.
|
||||||
|
//
|
||||||
|
// A heading can carry a name. A page carries what the group *is* — the sentence
|
||||||
|
// that says why these projects are one body of work, the documents that belong to
|
||||||
|
// all of them rather than to any one, and the projects themselves with what is
|
||||||
|
// left in each.
|
||||||
|
//
|
||||||
|
// The projects come with the group rather than being fetched per row, because the
|
||||||
|
// page is nothing without them and two round trips to draw one list is one too
|
||||||
|
// many.
|
||||||
|
func (s *Server) handleGetProjectGroup(w http.ResponseWriter, r *http.Request) {
|
||||||
|
groupID := chi.URLParam(r, "groupID")
|
||||||
|
userID := userFrom(r.Context()).ID
|
||||||
|
|
||||||
|
g, err := s.db.GetProjectGroup(r.Context(), groupID, userID)
|
||||||
|
if err != nil {
|
||||||
|
s.storeError(w, r, "get project group", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
projects, err := s.db.ListProjects(r.Context(), userID, false)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "list projects", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
counts, err := s.db.OpenTaskCounts(r.Context(), groupID, userID)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "open task counts", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
inside := make([]groupProjectJSON, 0, 4)
|
||||||
|
for _, p := range projects {
|
||||||
|
if p.GroupID == groupID {
|
||||||
|
inside = append(inside, groupProjectJSON{
|
||||||
|
projectJSON: toProjectJSON(p), OpenTasks: counts[p.ID],
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
files, err := s.db.ListGroupAttachments(r.Context(), groupID)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "list group attachments", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
attachments := make([]attachmentJSON, 0, len(files))
|
||||||
|
for _, a := range files {
|
||||||
|
attachments = append(attachments, toAttachmentJSON(a))
|
||||||
|
}
|
||||||
|
|
||||||
|
writeJSON(w, http.StatusOK, map[string]any{
|
||||||
|
"group": toProjectGroupJSON(*g), "projects": inside, "attachments": attachments,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
// handleUploadGroupAttachment puts a document on the group itself.
|
||||||
|
//
|
||||||
|
// The same storage as everywhere else — content-addressed by hash, so the path
|
||||||
|
// never contains anything the uploader chose. What differs is only the parent.
|
||||||
|
func (s *Server) handleUploadGroupAttachment(w http.ResponseWriter, r *http.Request) {
|
||||||
|
groupID := chi.URLParam(r, "groupID")
|
||||||
|
user := userFrom(r.Context())
|
||||||
|
|
||||||
|
// Scoped by the lookup rather than by a separate check: a group that is not
|
||||||
|
// yours is not found, which is the rule for everything in this file.
|
||||||
|
if _, err := s.db.GetProjectGroup(r.Context(), groupID, user.ID); err != nil {
|
||||||
|
s.storeError(w, r, "get project group", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
r.Body = http.MaxBytesReader(w, r.Body, maxUploadBytes+(1<<20))
|
||||||
|
if err := r.ParseMultipartForm(8 << 20); err != nil {
|
||||||
|
writeError(w, http.StatusRequestEntityTooLarge, CodePayloadTooLarge,
|
||||||
|
"that file is too large (25 MB maximum)")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
defer r.MultipartForm.RemoveAll()
|
||||||
|
|
||||||
|
file, header, err := r.FormFile("file")
|
||||||
|
if err != nil {
|
||||||
|
writeFieldErrors(w, map[string]string{"file": "required"})
|
||||||
|
return
|
||||||
|
}
|
||||||
|
defer file.Close()
|
||||||
|
|
||||||
|
if header.Size > maxUploadBytes {
|
||||||
|
writeError(w, http.StatusRequestEntityTooLarge, CodePayloadTooLarge,
|
||||||
|
"that file is too large (25 MB maximum)")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
stored, size, err := s.storeUpload(file)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "store upload", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
a := &store.Attachment{
|
||||||
|
GroupID: groupID,
|
||||||
|
Filename: safeFilename(header.Filename),
|
||||||
|
MimeType: detectMime(header.Filename, header.Header.Get("Content-Type")),
|
||||||
|
Size: size,
|
||||||
|
Path: stored,
|
||||||
|
UploadedBy: user.ID,
|
||||||
|
}
|
||||||
|
if err := s.db.CreateAttachment(r.Context(), a); err != nil {
|
||||||
|
os.Remove(filepath.Join(s.cfg.FilesDir(), stored))
|
||||||
|
s.internal(w, r, "record attachment", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
writeJSON(w, http.StatusCreated, toAttachmentJSON(*a))
|
||||||
|
}
|
||||||
|
|
||||||
// handleDeleteProjectGroup removes the heading. The projects under it come back
|
// handleDeleteProjectGroup removes the heading. The projects under it come back
|
||||||
// out as ungrouped, which is why this is not behind a confirmation about losing
|
// out as ungrouped, which is why this is not behind a confirmation about losing
|
||||||
// work: there is none to lose.
|
// work: there is none to lose.
|
||||||
func (s *Server) handleDeleteProjectGroup(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleDeleteProjectGroup(w http.ResponseWriter, r *http.Request) {
|
||||||
groupID := chi.URLParam(r, "groupID")
|
groupID := chi.URLParam(r, "groupID")
|
||||||
if err := s.db.DeleteProjectGroup(r.Context(), groupID, userFrom(r.Context()).ID); err != nil {
|
if err := s.db.DeleteProjectGroup(r.Context(), groupID, userFrom(r.Context()).ID); err != nil {
|
||||||
s.storeError(w, "delete project group", err)
|
s.storeError(w, r, "delete project group", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.publishToOwner(r, "project_group.deleted", map[string]string{"id": groupID})
|
s.publishToOwner(r, "project_group.deleted", map[string]string{"id": groupID})
|
||||||
@@ -128,7 +282,7 @@ func (s *Server) handleReorderProjectGroups(w http.ResponseWriter, r *http.Reque
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.ReorderProjectGroups(r.Context(), userFrom(r.Context()).ID, req.IDs); err != nil {
|
if err := s.db.ReorderProjectGroups(r.Context(), userFrom(r.Context()).ID, req.IDs); err != nil {
|
||||||
s.internal(w, "reorder project groups", err)
|
s.internal(w, r, "reorder project groups", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
|
|||||||
@@ -219,3 +219,133 @@ func groupOf(t *testing.T, ts *testServer, projectID string) string {
|
|||||||
t.Fatalf("project %s is not in the listing", projectID)
|
t.Fatalf("project %s is not in the listing", projectID)
|
||||||
return ""
|
return ""
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Colour is a name from a closed set, on both a project and a group.
|
||||||
|
//
|
||||||
|
// Refused rather than stored: an unknown name would be written happily and then
|
||||||
|
// painted as the default, which looks like a colour that did not save.
|
||||||
|
func TestAColourMustBeOneFromThePalette(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
_, group := ts.do(t, "POST", "/api/v1/project-groups", map[string]any{"name": "Arbejde"})
|
||||||
|
groupID := group["id"].(string)
|
||||||
|
if group["color"] != "graphite" {
|
||||||
|
t.Errorf("a new group's colour = %v, want graphite", group["color"])
|
||||||
|
}
|
||||||
|
|
||||||
|
_, project := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Regnskab"})
|
||||||
|
projectID := project["id"].(string)
|
||||||
|
|
||||||
|
for _, c := range []struct {
|
||||||
|
what, method, path string
|
||||||
|
}{
|
||||||
|
{"group", "PATCH", "/api/v1/project-groups/" + groupID},
|
||||||
|
{"project", "PATCH", "/api/v1/projects/" + projectID},
|
||||||
|
} {
|
||||||
|
resp, body := ts.do(t, c.method, c.path, map[string]any{"color": "teal"})
|
||||||
|
if resp.StatusCode != http.StatusOK {
|
||||||
|
t.Fatalf("%s, a real colour: %d %v", c.what, resp.StatusCode, body)
|
||||||
|
}
|
||||||
|
if body["color"] != "teal" {
|
||||||
|
t.Errorf("%s colour = %v, want teal", c.what, body["color"])
|
||||||
|
}
|
||||||
|
|
||||||
|
resp, body = ts.do(t, c.method, c.path, map[string]any{"color": "#ff0000"})
|
||||||
|
if resp.StatusCode != http.StatusUnprocessableEntity {
|
||||||
|
t.Errorf("%s, a hex value: status %d, want 422 — body %v", c.what, resp.StatusCode, body)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// A rename does not disturb the colour, and a recolour does not disturb the
|
||||||
|
// name: both are PATCH fields on the same row, and the whole point of a PATCH
|
||||||
|
// is that the one you did not send is the one you did not mean.
|
||||||
|
_, renamed := ts.do(t, "PATCH", "/api/v1/project-groups/"+groupID,
|
||||||
|
map[string]any{"name": "Kontoret"})
|
||||||
|
if renamed["color"] != "teal" {
|
||||||
|
t.Errorf("colour = %v after a rename, want teal", renamed["color"])
|
||||||
|
}
|
||||||
|
if renamed["name"] != "Kontoret" {
|
||||||
|
t.Errorf("name = %v", renamed["name"])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// A group is somewhere you can go, not only a heading.
|
||||||
|
func TestAGroupIsAPageWithItsProjectsDescriptionAndFiles(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
_, group := ts.do(t, "POST", "/api/v1/project-groups", map[string]any{"name": "Arbejde"})
|
||||||
|
groupID := group["id"].(string)
|
||||||
|
|
||||||
|
_, first := ts.do(t, "POST", "/api/v1/projects", map[string]any{
|
||||||
|
"name": "Sæsonstart", "group_id": groupID,
|
||||||
|
})
|
||||||
|
ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Regnskab", "group_id": groupID})
|
||||||
|
// And one outside it, which must not appear.
|
||||||
|
ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Haven"})
|
||||||
|
|
||||||
|
// Two open, one closed — the count is what is left, not what has ever been.
|
||||||
|
ts.do(t, "POST", "/api/v1/tasks", map[string]any{
|
||||||
|
"content": "skriv oplæg", "project_id": first["id"].(string),
|
||||||
|
})
|
||||||
|
_, done := ts.do(t, "POST", "/api/v1/tasks", map[string]any{
|
||||||
|
"content": "book lokale", "project_id": first["id"].(string),
|
||||||
|
})
|
||||||
|
ts.do(t, "POST", "/api/v1/tasks/"+done["id"].(string)+"/complete", nil)
|
||||||
|
|
||||||
|
resp, page := ts.do(t, "GET", "/api/v1/project-groups/"+groupID, nil)
|
||||||
|
if resp.StatusCode != http.StatusOK {
|
||||||
|
t.Fatalf("get group: status %d, body %v", resp.StatusCode, page)
|
||||||
|
}
|
||||||
|
projects, _ := page["projects"].([]any)
|
||||||
|
if len(projects) != 2 {
|
||||||
|
t.Fatalf("the page lists %d projects, want 2", len(projects))
|
||||||
|
}
|
||||||
|
for _, raw := range projects {
|
||||||
|
p := raw.(map[string]any)
|
||||||
|
if p["name"] == "Haven" {
|
||||||
|
t.Error("a project outside the group is on its page")
|
||||||
|
}
|
||||||
|
if p["name"] == "Sæsonstart" && p["open_tasks"] != float64(1) {
|
||||||
|
t.Errorf("open_tasks = %v, want 1 — the closed one must not count", p["open_tasks"])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// The description, which is the part a heading cannot carry.
|
||||||
|
if resp, _ := ts.do(t, "PATCH", "/api/v1/project-groups/"+groupID, map[string]any{
|
||||||
|
"description": "Alt det, der har en faktura for enden.",
|
||||||
|
}); resp.StatusCode != http.StatusOK {
|
||||||
|
t.Fatalf("set description: status %d", resp.StatusCode)
|
||||||
|
}
|
||||||
|
_, again := ts.do(t, "GET", "/api/v1/project-groups/"+groupID, nil)
|
||||||
|
if g, _ := again["group"].(map[string]any); g["description"] != "Alt det, der har en faktura for enden." {
|
||||||
|
t.Errorf("description = %v", g["description"])
|
||||||
|
}
|
||||||
|
// And setting only the description must not lose the name or colour.
|
||||||
|
if g, _ := again["group"].(map[string]any); g["name"] != "Arbejde" {
|
||||||
|
t.Errorf("the name went with the description: %v", g["name"])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// A group belongs to one person and is never shared, so somebody else's group is
|
||||||
|
// not found — including its files.
|
||||||
|
func TestAGroupsPageAndFilesAreItsOwnersAlone(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
other := ts.newUser(t, "anden@example.dk", "Anden")
|
||||||
|
|
||||||
|
_, group := ts.do(t, "POST", "/api/v1/project-groups", map[string]any{"name": "Arbejde"})
|
||||||
|
groupID := group["id"].(string)
|
||||||
|
|
||||||
|
for _, c := range []struct{ method, path string }{
|
||||||
|
{"GET", "/api/v1/project-groups/" + groupID},
|
||||||
|
{"PATCH", "/api/v1/project-groups/" + groupID},
|
||||||
|
{"POST", "/api/v1/project-groups/" + groupID + "/attachments"},
|
||||||
|
} {
|
||||||
|
resp, _ := other.do(t, c.method, c.path, map[string]any{"description": "min nu"})
|
||||||
|
if resp.StatusCode != http.StatusNotFound {
|
||||||
|
t.Errorf("%s %s as somebody else: status %d, want 404", c.method, c.path, resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
@@ -45,7 +45,7 @@ func (s *Server) handleListProjects(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
projects, err := s.db.ListProjects(r.Context(), user.ID, includeArchived)
|
projects, err := s.db.ListProjects(r.Context(), user.ID, includeArchived)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list projects", err)
|
s.internal(w, r, "list projects", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
out := make([]projectJSON, 0, len(projects))
|
out := make([]projectJSON, 0, len(projects))
|
||||||
@@ -59,7 +59,7 @@ func (s *Server) handleGetProject(w http.ResponseWriter, r *http.Request) {
|
|||||||
user := userFrom(r.Context())
|
user := userFrom(r.Context())
|
||||||
p, err := s.db.GetProject(r.Context(), chi.URLParam(r, "projectID"), user.ID)
|
p, err := s.db.GetProject(r.Context(), chi.URLParam(r, "projectID"), user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get project", err)
|
s.storeError(w, r, "get project", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, toProjectJSON(*p))
|
writeJSON(w, http.StatusOK, toProjectJSON(*p))
|
||||||
@@ -105,7 +105,7 @@ func (s *Server) handleReorderProjects(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if err := s.db.ReorderProjects(r.Context(), userFrom(r.Context()).ID, req.IDs); err != nil {
|
if err := s.db.ReorderProjects(r.Context(), userFrom(r.Context()).ID, req.IDs); err != nil {
|
||||||
s.internal(w, "reorder projects", err)
|
s.internal(w, r, "reorder projects", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
@@ -122,7 +122,7 @@ func (s *Server) handleCreateProject(w http.ResponseWriter, r *http.Request) {
|
|||||||
if req.Name != nil {
|
if req.Name != nil {
|
||||||
name = strings.TrimSpace(*req.Name)
|
name = strings.TrimSpace(*req.Name)
|
||||||
}
|
}
|
||||||
if fields := validateProject(name, req.ViewMode); len(fields) > 0 {
|
if fields := validateProject(name, req.ViewMode, req.Color); len(fields) > 0 {
|
||||||
writeFieldErrors(w, fields)
|
writeFieldErrors(w, fields)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
@@ -138,9 +138,21 @@ func (s *Server) handleCreateProject(w http.ResponseWriter, r *http.Request) {
|
|||||||
p.ViewMode = *req.ViewMode
|
p.ViewMode = *req.ViewMode
|
||||||
}
|
}
|
||||||
if err := s.db.CreateProject(r.Context(), p); err != nil {
|
if err := s.db.CreateProject(r.Context(), p); err != nil {
|
||||||
s.internal(w, "create project", err)
|
s.internal(w, r, "create project", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
// Filed under a group in the same call. `group_id` was declared on this
|
||||||
|
// request type, documented on it, applied by the update handler — and silently
|
||||||
|
// dropped here, so creating a project into a group answered 201 and put it
|
||||||
|
// nowhere. A field that is accepted and thrown away is worse than one that is
|
||||||
|
// refused.
|
||||||
|
if req.GroupID != nil && *req.GroupID != "" {
|
||||||
|
if err := s.db.SetProjectGroup(r.Context(), p.ID, *req.GroupID, user.ID); err != nil {
|
||||||
|
s.storeError(w, r, "set project group", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
p.GroupID = *req.GroupID
|
||||||
|
}
|
||||||
s.activity(r, p.ID, "", "project.created", map[string]any{"name": p.Name})
|
s.activity(r, p.ID, "", "project.created", map[string]any{"name": p.Name})
|
||||||
s.publishToOwner(r, "project.created", toProjectJSON(*p))
|
s.publishToOwner(r, "project.created", toProjectJSON(*p))
|
||||||
writeJSON(w, http.StatusCreated, toProjectJSON(*p))
|
writeJSON(w, http.StatusCreated, toProjectJSON(*p))
|
||||||
@@ -158,7 +170,13 @@ func (s *Server) handleUpdateProject(w http.ResponseWriter, r *http.Request) {
|
|||||||
name = strings.TrimSpace(*req.Name)
|
name = strings.TrimSpace(*req.Name)
|
||||||
req.Name = &name
|
req.Name = &name
|
||||||
}
|
}
|
||||||
if fields := validateProject(name, req.ViewMode); req.Name != nil && len(fields) > 0 {
|
// The name is only checked when it was sent — but the colour is checked
|
||||||
|
// whenever it was, which is why this is two conditions rather than one.
|
||||||
|
fields := validateProject(name, req.ViewMode, req.Color)
|
||||||
|
if req.Name == nil {
|
||||||
|
delete(fields, "name")
|
||||||
|
}
|
||||||
|
if len(fields) > 0 {
|
||||||
writeFieldErrors(w, fields)
|
writeFieldErrors(w, fields)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
@@ -168,7 +186,7 @@ func (s *Server) handleUpdateProject(w http.ResponseWriter, r *http.Request) {
|
|||||||
ViewMode: req.ViewMode, Archived: req.Archived,
|
ViewMode: req.ViewMode, Archived: req.Archived,
|
||||||
})
|
})
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "update project", err)
|
s.storeError(w, r, "update project", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
// Grouping is written separately because it is scoped differently: the fields
|
// Grouping is written separately because it is scoped differently: the fields
|
||||||
@@ -178,7 +196,7 @@ func (s *Server) handleUpdateProject(w http.ResponseWriter, r *http.Request) {
|
|||||||
if req.GroupID != nil {
|
if req.GroupID != nil {
|
||||||
if err := s.db.SetProjectGroup(r.Context(), projectID, *req.GroupID,
|
if err := s.db.SetProjectGroup(r.Context(), projectID, *req.GroupID,
|
||||||
userFrom(r.Context()).ID); err != nil {
|
userFrom(r.Context()).ID); err != nil {
|
||||||
s.storeError(w, "set project group", err)
|
s.storeError(w, r, "set project group", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -186,7 +204,7 @@ func (s *Server) handleUpdateProject(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
p, err := s.db.GetProject(r.Context(), projectID, userFrom(r.Context()).ID)
|
p, err := s.db.GetProject(r.Context(), projectID, userFrom(r.Context()).ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get project", err)
|
s.storeError(w, r, "get project", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.publishToOwner(r, "project.updated", toProjectJSON(*p))
|
s.publishToOwner(r, "project.updated", toProjectJSON(*p))
|
||||||
@@ -200,7 +218,7 @@ func (s *Server) handleDeleteProject(w http.ResponseWriter, r *http.Request) {
|
|||||||
writeError(w, http.StatusConflict, CodeInboxProtected, "the Inbox cannot be deleted")
|
writeError(w, http.StatusConflict, CodeInboxProtected, "the Inbox cannot be deleted")
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.storeError(w, "delete project", err)
|
s.storeError(w, r, "delete project", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.activity(r, projectID, "", "project.deleted", nil)
|
s.activity(r, projectID, "", "project.deleted", nil)
|
||||||
@@ -224,7 +242,7 @@ type trashedProjectJSON struct {
|
|||||||
func (s *Server) handleListTrashedProjects(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleListTrashedProjects(w http.ResponseWriter, r *http.Request) {
|
||||||
trashed, err := s.db.ListTrashedProjects(r.Context(), userFrom(r.Context()).ID)
|
trashed, err := s.db.ListTrashedProjects(r.Context(), userFrom(r.Context()).ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list trashed projects", err)
|
s.internal(w, r, "list trashed projects", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -246,7 +264,7 @@ func (s *Server) handleRestoreProject(w http.ResponseWriter, r *http.Request) {
|
|||||||
// deliberately invisible to it. Ownership is what governs restoring.
|
// deliberately invisible to it. Ownership is what governs restoring.
|
||||||
owner, err := s.db.ProjectOwner(r.Context(), projectID)
|
owner, err := s.db.ProjectOwner(r.Context(), projectID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "project owner", err)
|
s.storeError(w, r, "project owner", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
if owner != userFrom(r.Context()).ID {
|
if owner != userFrom(r.Context()).ID {
|
||||||
@@ -254,13 +272,18 @@ func (s *Server) handleRestoreProject(w http.ResponseWriter, r *http.Request) {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.RestoreProject(r.Context(), projectID); err != nil {
|
if err := s.db.RestoreProject(r.Context(), projectID); err != nil {
|
||||||
s.storeError(w, "restore project", err)
|
s.storeError(w, r, "restore project", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
}
|
}
|
||||||
|
|
||||||
func validateProject(name string, viewMode *string) map[string]string {
|
// colorFieldError names the closed set rather than listing it. The list is ten
|
||||||
|
// long and lives in three places already; a caller that got it wrong needs to be
|
||||||
|
// pointed at the documentation, not handed a copy that will one day be stale.
|
||||||
|
const colorFieldError = "must be one of the colours in the palette — see the Color schema"
|
||||||
|
|
||||||
|
func validateProject(name string, viewMode, color *string) map[string]string {
|
||||||
fields := map[string]string{}
|
fields := map[string]string{}
|
||||||
switch {
|
switch {
|
||||||
case name == "":
|
case name == "":
|
||||||
@@ -275,6 +298,11 @@ func validateProject(name string, viewMode *string) map[string]string {
|
|||||||
fields["view_mode"] = "must be list, board or calendar"
|
fields["view_mode"] = "must be list, board or calendar"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
// Refused rather than stored and quietly painted as the default, which is what
|
||||||
|
// an unknown name would do — and which looks like a colour that did not save.
|
||||||
|
if color != nil && !store.ValidColor(*color) {
|
||||||
|
fields["color"] = colorFieldError
|
||||||
|
}
|
||||||
return fields
|
return fields
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -290,7 +318,7 @@ type sectionJSON struct {
|
|||||||
func (s *Server) handleListSections(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleListSections(w http.ResponseWriter, r *http.Request) {
|
||||||
sections, err := s.db.ListSections(r.Context(), chi.URLParam(r, "projectID"))
|
sections, err := s.db.ListSections(r.Context(), chi.URLParam(r, "projectID"))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list sections", err)
|
s.internal(w, r, "list sections", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
out := make([]sectionJSON, 0, len(sections))
|
out := make([]sectionJSON, 0, len(sections))
|
||||||
@@ -320,7 +348,7 @@ func (s *Server) handleCreateSection(w http.ResponseWriter, r *http.Request) {
|
|||||||
sec.SortOrder = *req.SortOrder
|
sec.SortOrder = *req.SortOrder
|
||||||
}
|
}
|
||||||
if err := s.db.CreateSection(r.Context(), sec); err != nil {
|
if err := s.db.CreateSection(r.Context(), sec); err != nil {
|
||||||
s.internal(w, "create section", err)
|
s.internal(w, r, "create section", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.activity(r, sec.ProjectID, "", "section.created", map[string]any{"name": sec.Name})
|
s.activity(r, sec.ProjectID, "", "section.created", map[string]any{"name": sec.Name})
|
||||||
@@ -334,7 +362,7 @@ func (s *Server) sectionAccess(w http.ResponseWriter, r *http.Request, min store
|
|||||||
sectionID := chi.URLParam(r, "sectionID")
|
sectionID := chi.URLParam(r, "sectionID")
|
||||||
projectID, err := s.db.SectionProject(r.Context(), sectionID)
|
projectID, err := s.db.SectionProject(r.Context(), sectionID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "section project", err)
|
s.storeError(w, r, "section project", err)
|
||||||
return "", "", false
|
return "", "", false
|
||||||
}
|
}
|
||||||
if _, err := store.RequireProjectRole(r.Context(), s.db, projectID, userFrom(r.Context()).ID, min); err != nil {
|
if _, err := store.RequireProjectRole(r.Context(), s.db, projectID, userFrom(r.Context()).ID, min); err != nil {
|
||||||
@@ -365,7 +393,7 @@ func (s *Server) handleUpdateSection(w http.ResponseWriter, r *http.Request) {
|
|||||||
if err := s.db.UpdateSection(r.Context(), sectionID, store.SectionUpdate{
|
if err := s.db.UpdateSection(r.Context(), sectionID, store.SectionUpdate{
|
||||||
Name: req.Name, SortOrder: req.SortOrder,
|
Name: req.Name, SortOrder: req.SortOrder,
|
||||||
}); err != nil {
|
}); err != nil {
|
||||||
s.storeError(w, "update section", err)
|
s.storeError(w, r, "update section", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.activity(r, projectID, "", "section.updated", nil)
|
s.activity(r, projectID, "", "section.updated", nil)
|
||||||
@@ -378,7 +406,7 @@ func (s *Server) handleDeleteSection(w http.ResponseWriter, r *http.Request) {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.DeleteSection(r.Context(), sectionID); err != nil {
|
if err := s.db.DeleteSection(r.Context(), sectionID); err != nil {
|
||||||
s.storeError(w, "delete section", err)
|
s.storeError(w, r, "delete section", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.activity(r, projectID, "", "section.deleted", nil)
|
s.activity(r, projectID, "", "section.deleted", nil)
|
||||||
@@ -398,7 +426,7 @@ type memberJSON struct {
|
|||||||
func (s *Server) handleListMembers(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleListMembers(w http.ResponseWriter, r *http.Request) {
|
||||||
members, err := s.db.ListMembers(r.Context(), chi.URLParam(r, "projectID"))
|
members, err := s.db.ListMembers(r.Context(), chi.URLParam(r, "projectID"))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list members", err)
|
s.internal(w, r, "list members", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
out := make([]memberJSON, 0, len(members))
|
out := make([]memberJSON, 0, len(members))
|
||||||
@@ -447,7 +475,7 @@ func (s *Server) handleInvite(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
project, err := s.db.GetProject(r.Context(), projectID, inviter.ID)
|
project, err := s.db.GetProject(r.Context(), projectID, inviter.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get project", err)
|
s.storeError(w, r, "get project", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -459,7 +487,7 @@ func (s *Server) handleInvite(w http.ResponseWriter, r *http.Request) {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.AddMember(r.Context(), projectID, existing.ID, role); err != nil {
|
if err := s.db.AddMember(r.Context(), projectID, existing.ID, role); err != nil {
|
||||||
s.internal(w, "add member", err)
|
s.internal(w, r, "add member", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.activity(r, projectID, "", "member.added", map[string]any{"email": email, "role": string(role)})
|
s.activity(r, projectID, "", "member.added", map[string]any{"email": email, "role": string(role)})
|
||||||
@@ -469,7 +497,7 @@ func (s *Server) handleInvite(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
token, _, err := s.db.CreateInvite(r.Context(), email, projectID, role, inviter.ID, s.cfg.InviteTTL)
|
token, _, err := s.db.CreateInvite(r.Context(), email, projectID, role, inviter.ID, s.cfg.InviteTTL)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "create invite", err)
|
s.internal(w, r, "create invite", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
link := s.cfg.BaseURL + "/invite?token=" + token
|
link := s.cfg.BaseURL + "/invite?token=" + token
|
||||||
@@ -486,13 +514,60 @@ func (s *Server) handleInvite(w http.ResponseWriter, r *http.Request) {
|
|||||||
writeJSON(w, http.StatusCreated, inviteResponse{Link: link, Emailed: emailed})
|
writeJSON(w, http.StatusCreated, inviteResponse{Link: link, Emailed: emailed})
|
||||||
}
|
}
|
||||||
|
|
||||||
|
type memberRoleRequest struct {
|
||||||
|
Role string `json:"role"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// handleSetMemberRole changes an existing member between editor and viewer.
|
||||||
|
//
|
||||||
|
// Until now the only way to correct an invite sent with the wrong role was to
|
||||||
|
// remove the person and invite them again — which also unassigns everything they
|
||||||
|
// were responsible for, because removing a member clears their tasks' assignee.
|
||||||
|
// Fixing a dropdown should not cost somebody their work.
|
||||||
|
func (s *Server) handleSetMemberRole(w http.ResponseWriter, r *http.Request) {
|
||||||
|
var req memberRoleRequest
|
||||||
|
if err := decodeJSON(w, r, &req); err != nil {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
projectID := chi.URLParam(r, "projectID")
|
||||||
|
userID := chi.URLParam(r, "userID")
|
||||||
|
|
||||||
|
role := store.Role(req.Role)
|
||||||
|
if !role.Valid() || role == store.RoleOwner {
|
||||||
|
writeFieldErrors(w, map[string]string{"role": "must be editor or viewer"})
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
// The owner has no project_members row at all — ownership lives on the project
|
||||||
|
// — so this would report "not a member", which is true and completely
|
||||||
|
// unhelpful. Say the real reason instead.
|
||||||
|
owner, err := s.db.ProjectOwner(r.Context(), projectID)
|
||||||
|
if err != nil {
|
||||||
|
s.storeError(w, r, "project owner", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
if userID == owner {
|
||||||
|
writeError(w, http.StatusConflict, CodeConflict,
|
||||||
|
"the owner's standing cannot be changed; ownership is transferred, not granted")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
if err := s.db.SetMemberRole(r.Context(), projectID, userID, role); err != nil {
|
||||||
|
s.storeError(w, r, "set member role", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
s.activity(r, projectID, "", "member.role_changed",
|
||||||
|
map[string]any{"user_id": userID, "role": string(role)})
|
||||||
|
w.WriteHeader(http.StatusNoContent)
|
||||||
|
}
|
||||||
|
|
||||||
func (s *Server) handleRemoveMember(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleRemoveMember(w http.ResponseWriter, r *http.Request) {
|
||||||
projectID := chi.URLParam(r, "projectID")
|
projectID := chi.URLParam(r, "projectID")
|
||||||
userID := chi.URLParam(r, "userID")
|
userID := chi.URLParam(r, "userID")
|
||||||
|
|
||||||
owner, err := s.db.ProjectOwner(r.Context(), projectID)
|
owner, err := s.db.ProjectOwner(r.Context(), projectID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "project owner", err)
|
s.storeError(w, r, "project owner", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
if userID == owner {
|
if userID == owner {
|
||||||
@@ -501,7 +576,7 @@ func (s *Server) handleRemoveMember(w http.ResponseWriter, r *http.Request) {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.RemoveMember(r.Context(), projectID, userID); err != nil {
|
if err := s.db.RemoveMember(r.Context(), projectID, userID); err != nil {
|
||||||
s.storeError(w, "remove member", err)
|
s.storeError(w, r, "remove member", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.activity(r, projectID, "", "member.removed", map[string]any{"user_id": userID})
|
s.activity(r, projectID, "", "member.removed", map[string]any{"user_id": userID})
|
||||||
@@ -513,13 +588,13 @@ func (s *Server) handleRemoveMember(w http.ResponseWriter, r *http.Request) {
|
|||||||
// Everything a caller is not allowed to see is reported as 404 rather than 403: a
|
// Everything a caller is not allowed to see is reported as 404 rather than 403: a
|
||||||
// 403 confirms the thing exists, which is exactly what somebody probing ids wants
|
// 403 confirms the thing exists, which is exactly what somebody probing ids wants
|
||||||
// to learn.
|
// to learn.
|
||||||
func (s *Server) storeError(w http.ResponseWriter, what string, err error) {
|
func (s *Server) storeError(w http.ResponseWriter, r *http.Request, what string, err error) {
|
||||||
switch {
|
switch {
|
||||||
case errors.Is(err, store.ErrNotFound), errors.Is(err, store.ErrNoAccess):
|
case errors.Is(err, store.ErrNotFound), errors.Is(err, store.ErrNoAccess):
|
||||||
writeError(w, http.StatusNotFound, CodeNotFound, "not found")
|
writeError(w, http.StatusNotFound, CodeNotFound, "not found")
|
||||||
case errors.Is(err, store.ErrEmailInUse):
|
case errors.Is(err, store.ErrEmailInUse):
|
||||||
writeError(w, http.StatusConflict, CodeConflict, "that email address already has an account")
|
writeError(w, http.StatusConflict, CodeConflict, "that email address already has an account")
|
||||||
default:
|
default:
|
||||||
s.internal(w, what, err)
|
s.internal(w, r, what, err)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -194,3 +194,230 @@ func TestListMembersWorksForTheInbox(t *testing.T) {
|
|||||||
t.Fatalf("status %d, body %v", resp.StatusCode, body)
|
t.Fatalf("status %d, body %v", resp.StatusCode, body)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// A role sent by mistake used to be uncorrectable: the only way back was to remove
|
||||||
|
// the person and invite them again, which unassigns every task they were
|
||||||
|
// responsible for. Fixing a dropdown should not cost somebody their work.
|
||||||
|
func TestAMembersRoleCanBeChangedWithoutRemovingThem(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
member := ts.newUser(t, "anden@example.dk", "Anden")
|
||||||
|
|
||||||
|
memberUser, err := ts.db.UserByEmail(t.Context(), "anden@example.dk")
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
|
||||||
|
_, project := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Delt"})
|
||||||
|
projectID := project["id"].(string)
|
||||||
|
ts.do(t, "POST", "/api/v1/projects/"+projectID+"/invites", map[string]any{
|
||||||
|
"email": "anden@example.dk", "role": "viewer",
|
||||||
|
})
|
||||||
|
|
||||||
|
// A viewer cannot write. That is the rule, not the bug.
|
||||||
|
if resp, _ := member.do(t, "POST", "/api/v1/tasks",
|
||||||
|
map[string]any{"content": "prøv", "project_id": projectID}); resp.StatusCode != http.StatusNotFound {
|
||||||
|
t.Fatalf("a viewer created a task: status %d", resp.StatusCode)
|
||||||
|
}
|
||||||
|
|
||||||
|
resp, _ := ts.do(t, "PATCH", "/api/v1/projects/"+projectID+"/members/"+memberUser.ID,
|
||||||
|
map[string]any{"role": "editor"})
|
||||||
|
if resp.StatusCode != http.StatusNoContent {
|
||||||
|
t.Fatalf("promote to editor: status %d", resp.StatusCode)
|
||||||
|
}
|
||||||
|
|
||||||
|
if resp, _ := member.do(t, "POST", "/api/v1/tasks",
|
||||||
|
map[string]any{"content": "nu kan jeg", "project_id": projectID}); resp.StatusCode != http.StatusCreated {
|
||||||
|
t.Errorf("an editor could not create a task: status %d", resp.StatusCode)
|
||||||
|
}
|
||||||
|
_, members := ts.do(t, "GET", "/api/v1/projects/"+projectID+"/members", nil)
|
||||||
|
for _, raw := range members["members"].([]any) {
|
||||||
|
if m := raw.(map[string]any); m["user_id"] == memberUser.ID && m["role"] != "editor" {
|
||||||
|
t.Errorf("role = %v after the change, want editor", m["role"])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// The owner is not a member row, and ownership is not a role you can hand out.
|
||||||
|
func TestTheOwnersStandingCannotBeChanged(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
member := ts.newUser(t, "anden@example.dk", "Anden")
|
||||||
|
|
||||||
|
owner, err := ts.db.UserByEmail(t.Context(), "kristian@example.dk")
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
memberUser, err := ts.db.UserByEmail(t.Context(), "anden@example.dk")
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
|
||||||
|
_, project := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Delt"})
|
||||||
|
projectID := project["id"].(string)
|
||||||
|
ts.do(t, "POST", "/api/v1/projects/"+projectID+"/invites", map[string]any{
|
||||||
|
"email": "anden@example.dk", "role": "editor",
|
||||||
|
})
|
||||||
|
|
||||||
|
// Demoting the owner would leave a project nobody can administer.
|
||||||
|
if resp, _ := ts.do(t, "PATCH", "/api/v1/projects/"+projectID+"/members/"+owner.ID,
|
||||||
|
map[string]any{"role": "viewer"}); resp.StatusCode != http.StatusConflict {
|
||||||
|
t.Errorf("changing the owner's role: status %d, want 409", resp.StatusCode)
|
||||||
|
}
|
||||||
|
// And no member may promote themselves to owner.
|
||||||
|
if resp, _ := ts.do(t, "PATCH", "/api/v1/projects/"+projectID+"/members/"+memberUser.ID,
|
||||||
|
map[string]any{"role": "owner"}); resp.StatusCode != http.StatusUnprocessableEntity {
|
||||||
|
t.Errorf("granting ownership: status %d, want 422", resp.StatusCode)
|
||||||
|
}
|
||||||
|
// Nor may an editor change anybody's role: this is the owner's to do.
|
||||||
|
if resp, _ := member.do(t, "PATCH", "/api/v1/projects/"+projectID+"/members/"+memberUser.ID,
|
||||||
|
map[string]any{"role": "viewer"}); resp.StatusCode != http.StatusNotFound {
|
||||||
|
t.Errorf("an editor changed a role: status %d, want 404", resp.StatusCode)
|
||||||
|
}
|
||||||
|
// Somebody with no membership at all is not quietly given one.
|
||||||
|
stranger := ts.newUser(t, "tredje@example.dk", "Tredje")
|
||||||
|
_ = stranger
|
||||||
|
strangerUser, _ := ts.db.UserByEmail(t.Context(), "tredje@example.dk")
|
||||||
|
if resp, _ := ts.do(t, "PATCH", "/api/v1/projects/"+projectID+"/members/"+strangerUser.ID,
|
||||||
|
map[string]any{"role": "editor"}); resp.StatusCode != http.StatusNotFound {
|
||||||
|
t.Errorf("a non-member was given a role: status %d, want 404", resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// A project can have more than one section.
|
||||||
|
//
|
||||||
|
// Reported from use: sections "have no function, because you cannot create more
|
||||||
|
// than one". Every test here made exactly one, which is the shape of test that
|
||||||
|
// cannot see this — and so is every smoke test.
|
||||||
|
func TestAProjectCanHaveSeveralSections(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
_, project := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Ombygning"})
|
||||||
|
id := project["id"].(string)
|
||||||
|
|
||||||
|
names := []string{"Planlægning", "I gang", "Til gennemsyn"}
|
||||||
|
for _, name := range names {
|
||||||
|
resp, body := ts.do(t, "POST", "/api/v1/projects/"+id+"/sections",
|
||||||
|
map[string]any{"name": name})
|
||||||
|
if resp.StatusCode != http.StatusCreated {
|
||||||
|
t.Fatalf("create section %q: status %d, body %v", name, resp.StatusCode, body)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
_, listed := ts.do(t, "GET", "/api/v1/projects/"+id+"/sections", nil)
|
||||||
|
got, _ := listed["sections"].([]any)
|
||||||
|
if len(got) != len(names) {
|
||||||
|
t.Fatalf("the project has %d sections, want %d", len(got), len(names))
|
||||||
|
}
|
||||||
|
// In the order they were made, and each with its own place: a sort_order that
|
||||||
|
// came out the same for all three would put them in an arbitrary order that
|
||||||
|
// changes between reads.
|
||||||
|
seen := map[float64]bool{}
|
||||||
|
for i, raw := range got {
|
||||||
|
s := raw.(map[string]any)
|
||||||
|
if s["name"] != names[i] {
|
||||||
|
t.Errorf("section %d is %v, want %q", i, s["name"], names[i])
|
||||||
|
}
|
||||||
|
order, _ := s["sort_order"].(float64)
|
||||||
|
if seen[order] {
|
||||||
|
t.Errorf("two sections share sort_order %v", order)
|
||||||
|
}
|
||||||
|
seen[order] = true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// A project can be created straight into a group.
|
||||||
|
//
|
||||||
|
// `group_id` was declared on the request type, documented on it, and applied by
|
||||||
|
// the update handler — but the create handler ignored it, so a client that asked
|
||||||
|
// for a project in a group got a 201 and a project in no group. A field that is
|
||||||
|
// accepted and thrown away is worse than one that is refused: nothing reports it.
|
||||||
|
func TestAProjectCanBeCreatedIntoAGroup(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
_, group := ts.do(t, "POST", "/api/v1/project-groups", map[string]any{"name": "Arbejde"})
|
||||||
|
groupID := group["id"].(string)
|
||||||
|
|
||||||
|
resp, project := ts.do(t, "POST", "/api/v1/projects", map[string]any{
|
||||||
|
"name": "Sæsonstart", "group_id": groupID,
|
||||||
|
})
|
||||||
|
if resp.StatusCode != http.StatusCreated {
|
||||||
|
t.Fatalf("create: status %d, body %v", resp.StatusCode, project)
|
||||||
|
}
|
||||||
|
if project["group_id"] != groupID {
|
||||||
|
t.Errorf("the response says group_id = %v, want %q", project["group_id"], groupID)
|
||||||
|
}
|
||||||
|
|
||||||
|
// And it is really filed there, not just claimed in the reply.
|
||||||
|
_, listed := ts.do(t, "GET", "/api/v1/projects", nil)
|
||||||
|
var found map[string]any
|
||||||
|
for _, raw := range listed["projects"].([]any) {
|
||||||
|
if p := raw.(map[string]any); p["id"] == project["id"] {
|
||||||
|
found = p
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if found == nil {
|
||||||
|
t.Fatal("the new project is not in the list")
|
||||||
|
}
|
||||||
|
if found["group_id"] != groupID {
|
||||||
|
t.Errorf("the stored project has group_id = %v, want %q", found["group_id"], groupID)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// A section holds as many tasks as you put in it.
|
||||||
|
//
|
||||||
|
// Reported from use: "sections can only have one task". Driven through the same
|
||||||
|
// endpoint the interface uses, with the same `after_id` the drop handler sends —
|
||||||
|
// the second task goes after the first, which is the case that would fail if
|
||||||
|
// positioning inside a section were wrong.
|
||||||
|
func TestASectionHoldsMoreThanOneTask(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
_, project := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Skovvænget"})
|
||||||
|
projectID := project["id"].(string)
|
||||||
|
_, section := ts.do(t, "POST", "/api/v1/projects/"+projectID+"/sections",
|
||||||
|
map[string]any{"name": "Håndværker"})
|
||||||
|
sectionID := section["id"].(string)
|
||||||
|
|
||||||
|
var previous string
|
||||||
|
for _, content := range []string{"knager på badeværelset", "plade på opvaskemaskine", "fuge om vinduet"} {
|
||||||
|
_, created := ts.do(t, "POST", "/api/v1/tasks", map[string]any{
|
||||||
|
"content": content, "project_id": projectID,
|
||||||
|
})
|
||||||
|
id := created["id"].(string)
|
||||||
|
|
||||||
|
resp, moved := ts.do(t, "POST", "/api/v1/tasks/"+id+"/move", map[string]any{
|
||||||
|
"project_id": projectID, "section_id": sectionID, "after_id": previous,
|
||||||
|
})
|
||||||
|
if resp.StatusCode != http.StatusOK {
|
||||||
|
t.Fatalf("move %q: status %d, body %v", content, resp.StatusCode, moved)
|
||||||
|
}
|
||||||
|
if moved["section_id"] != sectionID {
|
||||||
|
t.Fatalf("%q did not land in the section: %v", content, moved["section_id"])
|
||||||
|
}
|
||||||
|
previous = id
|
||||||
|
}
|
||||||
|
|
||||||
|
_, listed := ts.do(t, "GET", "/api/v1/tasks?project_id="+projectID, nil)
|
||||||
|
tasks, _ := listed["tasks"].([]any)
|
||||||
|
inSection := []string{}
|
||||||
|
for _, raw := range tasks {
|
||||||
|
task := raw.(map[string]any)
|
||||||
|
if task["section_id"] == sectionID {
|
||||||
|
inSection = append(inSection, task["content"].(string))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if len(inSection) != 3 {
|
||||||
|
t.Fatalf("the section holds %d tasks, want 3: %v", len(inSection), inSection)
|
||||||
|
}
|
||||||
|
// And in the order they were placed, since each went after the one before it.
|
||||||
|
want := []string{"knager på badeværelset", "plade på opvaskemaskine", "fuge om vinduet"}
|
||||||
|
for i, content := range want {
|
||||||
|
if inSection[i] != content {
|
||||||
|
t.Errorf("position %d is %q, want %q — the whole list: %v", i, inSection[i], content, inSection)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
@@ -16,6 +16,7 @@ import (
|
|||||||
"github.com/go-chi/chi/v5"
|
"github.com/go-chi/chi/v5"
|
||||||
"github.com/go-chi/chi/v5/middleware"
|
"github.com/go-chi/chi/v5/middleware"
|
||||||
|
|
||||||
|
"github.com/kristianwind/verdande/internal/auth"
|
||||||
"github.com/kristianwind/verdande/internal/config"
|
"github.com/kristianwind/verdande/internal/config"
|
||||||
"github.com/kristianwind/verdande/internal/mail"
|
"github.com/kristianwind/verdande/internal/mail"
|
||||||
"github.com/kristianwind/verdande/internal/mcp"
|
"github.com/kristianwind/verdande/internal/mcp"
|
||||||
@@ -39,6 +40,12 @@ type Server struct {
|
|||||||
mcp *mcp.Server
|
mcp *mcp.Server
|
||||||
updates *update.Checker
|
updates *update.Checker
|
||||||
|
|
||||||
|
// Nil when the base URL is not something an authenticator will accept — a bare
|
||||||
|
// hostname with no scheme, say. The endpoints answer 503 rather than the
|
||||||
|
// process refusing to start: passkeys are one way in among three, and an
|
||||||
|
// instance should not be unreachable because one of them cannot be offered.
|
||||||
|
passkeys *auth.WebAuthn
|
||||||
|
|
||||||
// Password guessing is the attack this application is actually exposed to, so
|
// Password guessing is the attack this application is actually exposed to, so
|
||||||
// the endpoints that check a secret are limited separately and more tightly
|
// the endpoints that check a secret are limited separately and more tightly
|
||||||
// than the rest of the API.
|
// than the rest of the API.
|
||||||
@@ -63,6 +70,11 @@ func New(cfg *config.Config, db *store.DB, log *slog.Logger, web fs.FS) *Server
|
|||||||
resetLimiter: newLimiter(5, time.Hour),
|
resetLimiter: newLimiter(5, time.Hour),
|
||||||
}
|
}
|
||||||
s.csp = contentSecurityPolicy(scriptHashes(web))
|
s.csp = contentSecurityPolicy(scriptHashes(web))
|
||||||
|
if w, err := auth.NewWebAuthn(cfg.BaseURL, "verdande"); err == nil {
|
||||||
|
s.passkeys = w
|
||||||
|
} else {
|
||||||
|
log.Warn("passkeys are unavailable", "err", err, "base_url", cfg.BaseURL)
|
||||||
|
}
|
||||||
s.mcp = s.buildMCP()
|
s.mcp = s.buildMCP()
|
||||||
s.updates = update.New(Version, cfg.UpdateCheck)
|
s.updates = update.New(Version, cfg.UpdateCheck)
|
||||||
|
|
||||||
@@ -132,6 +144,14 @@ func New(cfg *config.Config, db *store.DB, log *slog.Logger, web fs.FS) *Server
|
|||||||
r.Method(http.MethodPost, "/password/reset",
|
r.Method(http.MethodPost, "/password/reset",
|
||||||
s.rateLimit(s.resetLimiter, http.HandlerFunc(s.handleResetPassword)))
|
s.rateLimit(s.resetLimiter, http.HandlerFunc(s.handleResetPassword)))
|
||||||
|
|
||||||
|
// Signing in with a passkey. Rate-limited like the password path: a
|
||||||
|
// signature cannot be guessed, but the endpoint can still be used to
|
||||||
|
// hammer the database.
|
||||||
|
r.Method(http.MethodPost, "/passkey/login/begin",
|
||||||
|
s.rateLimit(s.loginLimiter, http.HandlerFunc(s.handleBeginPasskeyLogin)))
|
||||||
|
r.Method(http.MethodPost, "/passkey/login/finish",
|
||||||
|
s.rateLimit(s.loginLimiter, http.HandlerFunc(s.handleFinishPasskeyLogin)))
|
||||||
|
|
||||||
// The second step of a login: a session that has passed the password
|
// The second step of a login: a session that has passed the password
|
||||||
// but not yet the code, and can reach nothing else.
|
// but not yet the code, and can reach nothing else.
|
||||||
r.Group(func(r chi.Router) {
|
r.Group(func(r chi.Router) {
|
||||||
@@ -144,6 +164,7 @@ func New(cfg *config.Config, db *store.DB, log *slog.Logger, web fs.FS) *Server
|
|||||||
r.Use(s.requireAuth)
|
r.Use(s.requireAuth)
|
||||||
r.Get("/me", s.handleMe)
|
r.Get("/me", s.handleMe)
|
||||||
r.Patch("/me", s.handleUpdateProfile)
|
r.Patch("/me", s.handleUpdateProfile)
|
||||||
|
r.Put("/sidebar-sections", s.handleSetSidebarSections)
|
||||||
r.Post("/logout", s.handleLogout)
|
r.Post("/logout", s.handleLogout)
|
||||||
r.Post("/password/change", s.handleChangePassword)
|
r.Post("/password/change", s.handleChangePassword)
|
||||||
r.Post("/totp/setup", s.handleTOTPSetup)
|
r.Post("/totp/setup", s.handleTOTPSetup)
|
||||||
@@ -159,6 +180,15 @@ func New(cfg *config.Config, db *store.DB, log *slog.Logger, web fs.FS) *Server
|
|||||||
r.Use(s.requireSession)
|
r.Use(s.requireSession)
|
||||||
r.Get("/sessions", s.handleListSessions)
|
r.Get("/sessions", s.handleListSessions)
|
||||||
r.Delete("/sessions/{sessionID}", s.handleDeleteSession)
|
r.Delete("/sessions/{sessionID}", s.handleDeleteSession)
|
||||||
|
|
||||||
|
// Registering a key, and the list of them. Sessions only, for
|
||||||
|
// the same reason: a leaked token must not be able to add its
|
||||||
|
// own way in — that would turn a theft into a tenancy.
|
||||||
|
r.Get("/passkeys", s.handleListPasskeys)
|
||||||
|
r.Post("/passkeys/register/begin", s.handleBeginPasskeyRegistration)
|
||||||
|
r.Post("/passkeys/register/finish", s.handleFinishPasskeyRegistration)
|
||||||
|
r.Patch("/passkeys/{passkeyID}", s.handleRenamePasskey)
|
||||||
|
r.Delete("/passkeys/{passkeyID}", s.handleDeletePasskey)
|
||||||
})
|
})
|
||||||
})
|
})
|
||||||
})
|
})
|
||||||
@@ -236,6 +266,17 @@ func New(cfg *config.Config, db *store.DB, log *slog.Logger, web fs.FS) *Server
|
|||||||
r.Delete("/", s.handleDisconnectGmail)
|
r.Delete("/", s.handleDisconnectGmail)
|
||||||
r.Post("/authorize", s.handleGmailAuthorize)
|
r.Post("/authorize", s.handleGmailAuthorize)
|
||||||
r.Post("/sync", s.handleGmailSyncNow)
|
r.Post("/sync", s.handleGmailSyncNow)
|
||||||
|
|
||||||
|
// The OAuth client itself is the instance's registration with
|
||||||
|
// Google, not anybody's mailbox — so unlike everything above it, it
|
||||||
|
// is administrators only, and behind a session as well: a leaked
|
||||||
|
// token must not be able to read or replace this instance's
|
||||||
|
// identity to Google.
|
||||||
|
r.Group(func(r chi.Router) {
|
||||||
|
r.Use(s.requireSession, s.requireAdmin)
|
||||||
|
r.Get("/client", s.handleGetGmailClient)
|
||||||
|
r.Put("/client", s.handleSetGmailClient)
|
||||||
|
})
|
||||||
})
|
})
|
||||||
|
|
||||||
r.Route("/import", func(r chi.Router) {
|
r.Route("/import", func(r chi.Router) {
|
||||||
@@ -264,6 +305,7 @@ func New(cfg *config.Config, db *store.DB, log *slog.Logger, web fs.FS) *Server
|
|||||||
})
|
})
|
||||||
r.Get("/upcoming", s.handleUpcoming)
|
r.Get("/upcoming", s.handleUpcoming)
|
||||||
r.Get("/delegated", s.handleDelegated)
|
r.Get("/delegated", s.handleDelegated)
|
||||||
|
r.Get("/people", s.handlePeople)
|
||||||
r.Get("/search", s.handleSearch)
|
r.Get("/search", s.handleSearch)
|
||||||
|
|
||||||
r.Route("/projects", func(r chi.Router) {
|
r.Route("/projects", func(r chi.Router) {
|
||||||
@@ -292,6 +334,7 @@ func New(cfg *config.Config, db *store.DB, log *slog.Logger, web fs.FS) *Server
|
|||||||
r.Patch("/", s.handleUpdateProject)
|
r.Patch("/", s.handleUpdateProject)
|
||||||
r.Delete("/", s.handleDeleteProject)
|
r.Delete("/", s.handleDeleteProject)
|
||||||
r.Post("/invites", s.handleInvite)
|
r.Post("/invites", s.handleInvite)
|
||||||
|
r.Patch("/members/{userID}", s.handleSetMemberRole)
|
||||||
r.Delete("/members/{userID}", s.handleRemoveMember)
|
r.Delete("/members/{userID}", s.handleRemoveMember)
|
||||||
})
|
})
|
||||||
})
|
})
|
||||||
@@ -303,6 +346,23 @@ func New(cfg *config.Config, db *store.DB, log *slog.Logger, web fs.FS) *Server
|
|||||||
// delete somebody else's.
|
// delete somebody else's.
|
||||||
r.Group(func(r chi.Router) {
|
r.Group(func(r chi.Router) {
|
||||||
r.Use(s.requireSession, s.requireAdmin)
|
r.Use(s.requireSession, s.requireAdmin)
|
||||||
|
r.Get("/errors", s.handleListErrors)
|
||||||
|
// Restarting this instance from its own interface. The panel does
|
||||||
|
// the work — a container cannot replace its own image — and pulls
|
||||||
|
// `:latest` on the way, which is what makes a restart an update.
|
||||||
|
r.Get("/panel", s.handlePanelStatus)
|
||||||
|
r.Post("/panel/restart", s.handleRestartFromPanel)
|
||||||
|
// A backup file is a complete copy of the database, so this whole
|
||||||
|
// group is sessions-only as well as administrators-only: a leaked
|
||||||
|
// token must not be able to download everybody's data.
|
||||||
|
r.Get("/backups", s.handleListBackups)
|
||||||
|
r.Post("/backups", s.handleRunBackup)
|
||||||
|
r.Get("/backups/{backupID}", s.handleDownloadBackup)
|
||||||
|
// The instance-wide history. Above the per-project one in every
|
||||||
|
// sense: it crosses projects the caller is not a member of, which
|
||||||
|
// is the whole reason it is here and not there.
|
||||||
|
r.Get("/activity", s.handleAuditLog)
|
||||||
|
r.Get("/activity/events", s.handleAuditEvents)
|
||||||
r.Get("/users", s.handleListUsers)
|
r.Get("/users", s.handleListUsers)
|
||||||
r.Post("/users", s.handleCreateUser)
|
r.Post("/users", s.handleCreateUser)
|
||||||
r.Patch("/users/{userID}", s.handleUpdateUser)
|
r.Patch("/users/{userID}", s.handleUpdateUser)
|
||||||
@@ -318,8 +378,10 @@ func New(cfg *config.Config, db *store.DB, log *slog.Logger, web fs.FS) *Server
|
|||||||
r.Post("/", s.handleCreateProjectGroup)
|
r.Post("/", s.handleCreateProjectGroup)
|
||||||
// Above /{groupID}, or chi reads "reorder" as an id.
|
// Above /{groupID}, or chi reads "reorder" as an id.
|
||||||
r.Post("/reorder", s.handleReorderProjectGroups)
|
r.Post("/reorder", s.handleReorderProjectGroups)
|
||||||
|
r.Get("/{groupID}", s.handleGetProjectGroup)
|
||||||
r.Patch("/{groupID}", s.handleUpdateProjectGroup)
|
r.Patch("/{groupID}", s.handleUpdateProjectGroup)
|
||||||
r.Delete("/{groupID}", s.handleDeleteProjectGroup)
|
r.Delete("/{groupID}", s.handleDeleteProjectGroup)
|
||||||
|
r.Post("/{groupID}/attachments", s.handleUploadGroupAttachment)
|
||||||
})
|
})
|
||||||
|
|
||||||
// The trash is outside the block above: a deleted project is invisible
|
// The trash is outside the block above: a deleted project is invisible
|
||||||
|
|||||||
@@ -41,7 +41,7 @@ func (s *Server) handleListSessions(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
sessions, err := s.db.ListSessions(r.Context(), user.ID)
|
sessions, err := s.db.ListSessions(r.Context(), user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list sessions", err)
|
s.internal(w, r, "list sessions", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -69,7 +69,7 @@ func (s *Server) handleDeleteSession(w http.ResponseWriter, r *http.Request) {
|
|||||||
sessionID := chi.URLParam(r, "sessionID")
|
sessionID := chi.URLParam(r, "sessionID")
|
||||||
|
|
||||||
if err := s.db.DeleteUserSession(r.Context(), sessionID, user.ID); err != nil {
|
if err := s.db.DeleteUserSession(r.Context(), sessionID, user.ID); err != nil {
|
||||||
s.storeError(w, "delete session", err)
|
s.storeError(w, r, "delete session", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
if current := sessionFrom(r.Context()); current != nil && current.ID == sessionID {
|
if current := sessionFrom(r.Context()); current != nil && current.ID == sessionID {
|
||||||
|
|||||||
@@ -33,9 +33,14 @@ type taskJSON struct {
|
|||||||
Completed bool `json:"completed"`
|
Completed bool `json:"completed"`
|
||||||
CompletedAt string `json:"completed_at,omitempty"`
|
CompletedAt string `json:"completed_at,omitempty"`
|
||||||
CreatedBy string `json:"created_by"`
|
CreatedBy string `json:"created_by"`
|
||||||
SortOrder float64 `json:"sort_order"`
|
// What the row can say without being opened. Sent with every task rather than
|
||||||
CreatedAt string `json:"created_at"`
|
// fetched when one is opened, because the point is that you see it in the list.
|
||||||
UpdatedAt string `json:"updated_at"`
|
SubtaskCount int `json:"subtask_count,omitempty"`
|
||||||
|
SubtaskDone int `json:"subtask_done,omitempty"`
|
||||||
|
AttachmentCount int `json:"attachment_count,omitempty"`
|
||||||
|
SortOrder float64 `json:"sort_order"`
|
||||||
|
CreatedAt string `json:"created_at"`
|
||||||
|
UpdatedAt string `json:"updated_at"`
|
||||||
}
|
}
|
||||||
|
|
||||||
func toTaskJSON(t store.Task) taskJSON {
|
func toTaskJSON(t store.Task) taskJSON {
|
||||||
@@ -45,9 +50,11 @@ func toTaskJSON(t store.Task) taskJSON {
|
|||||||
DueDate: t.DueDate, DurationMin: t.DurationMin, Recurrence: t.RecurrenceRule,
|
DueDate: t.DueDate, DurationMin: t.DurationMin, Recurrence: t.RecurrenceRule,
|
||||||
RepeatText: recurrence.Describe(t.RecurrenceRule),
|
RepeatText: recurrence.Describe(t.RecurrenceRule),
|
||||||
AssigneeID: t.AssigneeID, Completed: t.Completed(), CreatedBy: t.CreatedBy,
|
AssigneeID: t.AssigneeID, Completed: t.Completed(), CreatedBy: t.CreatedBy,
|
||||||
SortOrder: t.SortOrder,
|
SubtaskCount: t.SubtaskCount, SubtaskDone: t.SubtaskDone,
|
||||||
CreatedAt: t.CreatedAt.Format(time.RFC3339),
|
AttachmentCount: t.AttachmentCount,
|
||||||
UpdatedAt: t.UpdatedAt.Format(time.RFC3339),
|
SortOrder: t.SortOrder,
|
||||||
|
CreatedAt: t.CreatedAt.Format(time.RFC3339),
|
||||||
|
UpdatedAt: t.UpdatedAt.Format(time.RFC3339),
|
||||||
// Never nil: a client iterating labels should not have to null-check first.
|
// Never nil: a client iterating labels should not have to null-check first.
|
||||||
Labels: t.Labels,
|
Labels: t.Labels,
|
||||||
}
|
}
|
||||||
@@ -99,7 +106,7 @@ func (s *Server) handleListTasks(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
tasks, err := s.db.ListTasks(r.Context(), user.ID, f)
|
tasks, err := s.db.ListTasks(r.Context(), user.ID, f)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list tasks", err)
|
s.internal(w, r, "list tasks", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, map[string]any{"tasks": toTaskList(tasks)})
|
writeJSON(w, http.StatusOK, map[string]any{"tasks": toTaskList(tasks)})
|
||||||
@@ -116,7 +123,7 @@ func toTaskList(tasks []store.Task) []taskJSON {
|
|||||||
func (s *Server) handleGetTask(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleGetTask(w http.ResponseWriter, r *http.Request) {
|
||||||
t, err := s.db.GetTask(r.Context(), chi.URLParam(r, "taskID"), userFrom(r.Context()).ID)
|
t, err := s.db.GetTask(r.Context(), chi.URLParam(r, "taskID"), userFrom(r.Context()).ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get task", err)
|
s.storeError(w, r, "get task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, toTaskJSON(*t))
|
writeJSON(w, http.StatusOK, toTaskJSON(*t))
|
||||||
@@ -162,7 +169,7 @@ func (s *Server) handleCreateTask(w http.ResponseWriter, r *http.Request) {
|
|||||||
if projectID == "" {
|
if projectID == "" {
|
||||||
var err error
|
var err error
|
||||||
if projectID, err = s.db.InboxID(r.Context(), user.ID); err != nil {
|
if projectID, err = s.db.InboxID(r.Context(), user.ID); err != nil {
|
||||||
s.internal(w, "inbox", err)
|
s.internal(w, r, "inbox", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -226,7 +233,7 @@ func (s *Server) handleCreateTask(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if err := s.db.CreateTask(r.Context(), t, req.Labels); err != nil {
|
if err := s.db.CreateTask(r.Context(), t, req.Labels); err != nil {
|
||||||
s.internal(w, "create task", err)
|
s.internal(w, r, "create task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
// The store wrote the labels; the struct it was handed does not know that, and
|
// The store wrote the labels; the struct it was handed does not know that, and
|
||||||
@@ -302,13 +309,13 @@ func (s *Server) handleUpdateTask(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if err := s.db.UpdateTask(r.Context(), taskID, user.ID, u); err != nil {
|
if err := s.db.UpdateTask(r.Context(), taskID, user.ID, u); err != nil {
|
||||||
s.storeError(w, "update task", err)
|
s.storeError(w, r, "update task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
t, err := s.db.GetTask(r.Context(), taskID, user.ID)
|
t, err := s.db.GetTask(r.Context(), taskID, user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get task", err)
|
s.storeError(w, r, "get task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.activity(r, t.ProjectID, t.ID, "task.updated", nil)
|
s.activity(r, t.ProjectID, t.ID, "task.updated", nil)
|
||||||
@@ -327,13 +334,13 @@ func (s *Server) handleCompleteTask(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
result, err := s.db.CompleteTask(r.Context(), taskID, user.ID)
|
result, err := s.db.CompleteTask(r.Context(), taskID, user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "complete task", err)
|
s.storeError(w, r, "complete task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
t, err := s.db.GetTask(r.Context(), taskID, user.ID)
|
t, err := s.db.GetTask(r.Context(), taskID, user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get task", err)
|
s.storeError(w, r, "get task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -369,13 +376,13 @@ func (s *Server) handleReopenTask(w http.ResponseWriter, r *http.Request) {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.ReopenTask(r.Context(), taskID); err != nil {
|
if err := s.db.ReopenTask(r.Context(), taskID); err != nil {
|
||||||
s.storeError(w, "reopen task", err)
|
s.storeError(w, r, "reopen task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
t, err := s.db.GetTask(r.Context(), taskID, user.ID)
|
t, err := s.db.GetTask(r.Context(), taskID, user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get task", err)
|
s.storeError(w, r, "get task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.activity(r, t.ProjectID, t.ID, "task.reopened", nil)
|
s.activity(r, t.ProjectID, t.ID, "task.reopened", nil)
|
||||||
@@ -394,11 +401,11 @@ func (s *Server) handleDeleteTask(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
t, err := s.db.GetTask(r.Context(), taskID, user.ID)
|
t, err := s.db.GetTask(r.Context(), taskID, user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get task", err)
|
s.storeError(w, r, "get task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.DeleteTask(r.Context(), taskID); err != nil {
|
if err := s.db.DeleteTask(r.Context(), taskID); err != nil {
|
||||||
s.storeError(w, "delete task", err)
|
s.storeError(w, r, "delete task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.activity(r, t.ProjectID, "", "task.deleted", map[string]any{"content": t.Content})
|
s.activity(r, t.ProjectID, "", "task.deleted", map[string]any{"content": t.Content})
|
||||||
@@ -427,7 +434,7 @@ func (s *Server) handleMoveTask(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
current, err := s.db.GetTask(r.Context(), taskID, user.ID)
|
current, err := s.db.GetTask(r.Context(), taskID, user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get task", err)
|
s.storeError(w, r, "get task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
role, err := store.TaskRole(r.Context(), s.db, taskID, user.ID)
|
role, err := store.TaskRole(r.Context(), s.db, taskID, user.ID)
|
||||||
@@ -449,12 +456,12 @@ func (s *Server) handleMoveTask(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if _, err := s.db.MoveTask(r.Context(), taskID, projectID, req.SectionID, req.AfterID, req.BeforeID); err != nil {
|
if _, err := s.db.MoveTask(r.Context(), taskID, projectID, req.SectionID, req.AfterID, req.BeforeID); err != nil {
|
||||||
s.storeError(w, "move task", err)
|
s.storeError(w, r, "move task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
t, err := s.db.GetTask(r.Context(), taskID, user.ID)
|
t, err := s.db.GetTask(r.Context(), taskID, user.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get task", err)
|
s.storeError(w, r, "get task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.publish(t.ProjectID, "task.moved", toTaskJSON(*t))
|
s.publish(t.ProjectID, "task.moved", toTaskJSON(*t))
|
||||||
@@ -468,6 +475,10 @@ type quickAddRequest struct {
|
|||||||
// ProjectID is the view the user was looking at. A "#project" in the text
|
// ProjectID is the view the user was looking at. A "#project" in the text
|
||||||
// wins over it: what somebody typed beats where they happened to be standing.
|
// wins over it: what somebody typed beats where they happened to be standing.
|
||||||
ProjectID string `json:"project_id,omitempty"`
|
ProjectID string `json:"project_id,omitempty"`
|
||||||
|
// SectionID is the section the box was opened in, for the field that sits at
|
||||||
|
// the foot of one. Same rule as the project: a "/section" in the text wins,
|
||||||
|
// because typing it is a choice and standing there is a circumstance.
|
||||||
|
SectionID string `json:"section_id,omitempty"`
|
||||||
}
|
}
|
||||||
|
|
||||||
func (s *Server) handleQuickAdd(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleQuickAdd(w http.ResponseWriter, r *http.Request) {
|
||||||
@@ -502,7 +513,7 @@ func (s *Server) handleQuickAdd(w http.ResponseWriter, r *http.Request) {
|
|||||||
if projectID == "" {
|
if projectID == "" {
|
||||||
var err error
|
var err error
|
||||||
if projectID, err = s.db.InboxID(r.Context(), user.ID); err != nil {
|
if projectID, err = s.db.InboxID(r.Context(), user.ID); err != nil {
|
||||||
s.internal(w, "inbox", err)
|
s.internal(w, r, "inbox", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -511,9 +522,31 @@ func (s *Server) handleQuickAdd(w http.ResponseWriter, r *http.Request) {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Resolved after the project, because a section belongs to one project and the
|
||||||
|
// same name can exist in several. A name that matches nothing is reported the
|
||||||
|
// same way an unknown project is: the task is still created, in the project
|
||||||
|
// without a section, and the caller is told which word did not land.
|
||||||
|
sectionID, unknownSection := "", ""
|
||||||
|
// The section the box belongs to, unless the text names one. Checked against
|
||||||
|
// the project the task actually landed in, so a "#project" that moved it
|
||||||
|
// elsewhere cannot drag a section id from another project along with it.
|
||||||
|
if req.SectionID != "" {
|
||||||
|
if belongs, err := s.db.SectionInProject(r.Context(), req.SectionID, projectID); err == nil && belongs {
|
||||||
|
sectionID = req.SectionID
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if parsed.Section != "" {
|
||||||
|
if id, err := s.db.SectionByName(r.Context(), projectID, parsed.Section); err == nil {
|
||||||
|
sectionID = id
|
||||||
|
} else {
|
||||||
|
unknownSection = parsed.Section
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
t := &store.Task{
|
t := &store.Task{
|
||||||
ProjectID: projectID, Content: parsed.Content, Priority: parsed.Priority,
|
ProjectID: projectID, SectionID: sectionID, Content: parsed.Content,
|
||||||
CreatedBy: user.ID, DueDate: parsed.DueDate, RecurrenceRule: parsed.Recurrence,
|
Priority: parsed.Priority, CreatedBy: user.ID, DueDate: parsed.DueDate,
|
||||||
|
RecurrenceRule: parsed.Recurrence,
|
||||||
}
|
}
|
||||||
if parsed.DueDate != "" {
|
if parsed.DueDate != "" {
|
||||||
_, when, err := resolveDue(parsed.DueDate, parsed.DueTime, user.Timezone)
|
_, when, err := resolveDue(parsed.DueDate, parsed.DueTime, user.Timezone)
|
||||||
@@ -523,20 +556,21 @@ func (s *Server) handleQuickAdd(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if err := s.db.CreateTask(r.Context(), t, parsed.Labels); err != nil {
|
if err := s.db.CreateTask(r.Context(), t, parsed.Labels); err != nil {
|
||||||
s.internal(w, "create task", err)
|
s.internal(w, r, "create task", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
t.Labels = parsed.Labels
|
t.Labels = parsed.Labels
|
||||||
s.activity(r, t.ProjectID, t.ID, "task.created", map[string]any{"content": t.Content})
|
s.activity(r, t.ProjectID, t.ID, "task.created", map[string]any{"content": t.Content})
|
||||||
s.publish(t.ProjectID, "task.created", toTaskJSON(*t))
|
s.publish(t.ProjectID, "task.created", toTaskJSON(*t))
|
||||||
|
|
||||||
if unknownProject != "" {
|
if unknownProject != "" || unknownSection != "" {
|
||||||
// Alongside the task rather than instead of it: the task was created, and
|
// Alongside the task rather than instead of it: the task was created, and
|
||||||
// this says what could not be honoured while creating it.
|
// this says what could not be honoured while creating it.
|
||||||
writeJSON(w, http.StatusCreated, struct {
|
writeJSON(w, http.StatusCreated, struct {
|
||||||
taskJSON
|
taskJSON
|
||||||
UnknownProject string `json:"unknown_project"`
|
UnknownProject string `json:"unknown_project,omitempty"`
|
||||||
}{toTaskJSON(*t), unknownProject})
|
UnknownSection string `json:"unknown_section,omitempty"`
|
||||||
|
}{toTaskJSON(*t), unknownProject, unknownSection})
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusCreated, toTaskJSON(*t))
|
writeJSON(w, http.StatusCreated, toTaskJSON(*t))
|
||||||
|
|||||||
@@ -1682,3 +1682,98 @@ func TestNotifications(t *testing.T) {
|
|||||||
t.Errorf("unread = %v after marking everything read", after["unread"])
|
t.Errorf("unread = %v after marking everything read", after["unread"])
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Quick add can put a task straight into a section.
|
||||||
|
//
|
||||||
|
// A section belongs to one project, so the name is resolved after the project is
|
||||||
|
// decided — and two projects may both have a "Produktion", which are different
|
||||||
|
// sections. A name that matches nothing is reported the way an unknown project is:
|
||||||
|
// the task is still created, and the caller is told which word did not land.
|
||||||
|
func TestQuickAddPutsATaskInASection(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
_, project := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Risteriet"})
|
||||||
|
projectID := project["id"].(string)
|
||||||
|
_, section := ts.do(t, "POST", "/api/v1/projects/"+projectID+"/sections",
|
||||||
|
map[string]any{"name": "Kunder/Ordrer"})
|
||||||
|
sectionID := section["id"].(string)
|
||||||
|
|
||||||
|
// The section name has a slash in it, which is also the sigil. The bare form is
|
||||||
|
// greedy, so the whole name comes across.
|
||||||
|
resp, task := ts.do(t, "POST", "/api/v1/tasks/quick-add",
|
||||||
|
map[string]any{"text": "Karpenhøj kaffe bestilling #Risteriet /Kunder/Ordrer"})
|
||||||
|
if resp.StatusCode != http.StatusCreated {
|
||||||
|
t.Fatalf("quick add: status %d, body %v", resp.StatusCode, task)
|
||||||
|
}
|
||||||
|
if task["section_id"] != sectionID {
|
||||||
|
t.Errorf("section_id = %v, want %v", task["section_id"], sectionID)
|
||||||
|
}
|
||||||
|
if task["content"] != "Karpenhøj kaffe bestilling" {
|
||||||
|
t.Errorf("content = %v — the sigils should be gone", task["content"])
|
||||||
|
}
|
||||||
|
|
||||||
|
// Case-insensitive, like the project sigil.
|
||||||
|
_, lower := ts.do(t, "POST", "/api/v1/tasks/quick-add",
|
||||||
|
map[string]any{"text": `nye poser #Risteriet /"kunder/ordrer"`})
|
||||||
|
if lower["section_id"] != sectionID {
|
||||||
|
t.Errorf("a differently-cased name did not resolve: %v", lower["section_id"])
|
||||||
|
}
|
||||||
|
|
||||||
|
// A name that matches nothing still creates the task, and says so.
|
||||||
|
_, missing := ts.do(t, "POST", "/api/v1/tasks/quick-add",
|
||||||
|
map[string]any{"text": "noget andet #Risteriet /Findesikke"})
|
||||||
|
if missing["section_id"] != nil && missing["section_id"] != "" {
|
||||||
|
t.Errorf("an unknown section should leave the task unsectioned: %v", missing["section_id"])
|
||||||
|
}
|
||||||
|
if missing["unknown_section"] != "Findesikke" {
|
||||||
|
t.Errorf("unknown_section = %v, want Findesikke", missing["unknown_section"])
|
||||||
|
}
|
||||||
|
if missing["content"] != "noget andet" {
|
||||||
|
t.Errorf("content = %v", missing["content"])
|
||||||
|
}
|
||||||
|
|
||||||
|
// A section in another project is a different section, and must not be found.
|
||||||
|
_, other := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Andet"})
|
||||||
|
ts.do(t, "POST", "/api/v1/projects/"+other["id"].(string)+"/sections",
|
||||||
|
map[string]any{"name": "Egen"})
|
||||||
|
_, crossed := ts.do(t, "POST", "/api/v1/tasks/quick-add",
|
||||||
|
map[string]any{"text": "forkert sted #Risteriet /Egen"})
|
||||||
|
if crossed["unknown_section"] != "Egen" {
|
||||||
|
t.Errorf("a section from another project was found: %v", crossed["section_id"])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// The field at the foot of a section passes the section it sits in, and a
|
||||||
|
// "#project" in the same line can move the task out from under it.
|
||||||
|
func TestQuickAddSectionIDIsCheckedAgainstTheProject(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
_, here := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Her"})
|
||||||
|
hereID := here["id"].(string)
|
||||||
|
_, section := ts.do(t, "POST", "/api/v1/projects/"+hereID+"/sections",
|
||||||
|
map[string]any{"name": "Produktion"})
|
||||||
|
sectionID := section["id"].(string)
|
||||||
|
|
||||||
|
// Standing in the section is enough; no sigil needed.
|
||||||
|
_, plain := ts.do(t, "POST", "/api/v1/tasks/quick-add", map[string]any{
|
||||||
|
"text": "male gavlen", "project_id": hereID, "section_id": sectionID,
|
||||||
|
})
|
||||||
|
if plain["section_id"] != sectionID {
|
||||||
|
t.Errorf("section_id = %v, want %v", plain["section_id"], sectionID)
|
||||||
|
}
|
||||||
|
|
||||||
|
// A "#project" that moves the task must not drag the section id with it: that
|
||||||
|
// section belongs to the project being left behind.
|
||||||
|
ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Andetsted"})
|
||||||
|
_, moved := ts.do(t, "POST", "/api/v1/tasks/quick-add", map[string]any{
|
||||||
|
"text": "male gavlen #Andetsted", "project_id": hereID, "section_id": sectionID,
|
||||||
|
})
|
||||||
|
if moved["section_id"] != nil && moved["section_id"] != "" {
|
||||||
|
t.Errorf("the section came along to another project: %v", moved["section_id"])
|
||||||
|
}
|
||||||
|
if moved["content"] != "male gavlen" {
|
||||||
|
t.Errorf("content = %v", moved["content"])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
@@ -36,7 +36,7 @@ type createdTokenJSON struct {
|
|||||||
func (s *Server) handleListAPITokens(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleListAPITokens(w http.ResponseWriter, r *http.Request) {
|
||||||
tokens, err := s.db.ListAPITokens(r.Context(), userFrom(r.Context()).ID)
|
tokens, err := s.db.ListAPITokens(r.Context(), userFrom(r.Context()).ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list api tokens", err)
|
s.internal(w, r, "list api tokens", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -96,7 +96,7 @@ func (s *Server) handleCreateAPIToken(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
plaintext, token, err := s.db.CreateAPIToken(r.Context(), userFrom(r.Context()).ID, name, expires)
|
plaintext, token, err := s.db.CreateAPIToken(r.Context(), userFrom(r.Context()).ID, name, expires)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "create api token", err)
|
s.internal(w, r, "create api token", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -117,7 +117,7 @@ func (s *Server) handleCreateAPIToken(w http.ResponseWriter, r *http.Request) {
|
|||||||
func (s *Server) handleDeleteAPIToken(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleDeleteAPIToken(w http.ResponseWriter, r *http.Request) {
|
||||||
err := s.db.DeleteAPIToken(r.Context(), userFrom(r.Context()).ID, chi.URLParam(r, "tokenID"))
|
err := s.db.DeleteAPIToken(r.Context(), userFrom(r.Context()).ID, chi.URLParam(r, "tokenID"))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "delete api token", err)
|
s.storeError(w, r, "delete api token", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
|
|||||||
@@ -29,12 +29,12 @@ func (s *Server) handleTOTPSetup(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
secret, uri, err := auth.NewTOTPSecret(s.issuer(), user.Email)
|
secret, uri, err := auth.NewTOTPSecret(s.issuer(), user.Email)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "generate totp secret", err)
|
s.internal(w, r, "generate totp secret", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
// Stored but not enabled: confirm decides that.
|
// Stored but not enabled: confirm decides that.
|
||||||
if err := s.db.SetTOTPSecret(r.Context(), user.ID, secret, false); err != nil {
|
if err := s.db.SetTOTPSecret(r.Context(), user.ID, secret, false); err != nil {
|
||||||
s.internal(w, "store totp secret", err)
|
s.internal(w, r, "store totp secret", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, totpSetupResponse{Secret: secret, URI: uri})
|
writeJSON(w, http.StatusOK, totpSetupResponse{Secret: secret, URI: uri})
|
||||||
@@ -63,15 +63,15 @@ func (s *Server) handleTOTPConfirm(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
codes, hashes, err := auth.NewRecoveryCodes()
|
codes, hashes, err := auth.NewRecoveryCodes()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "generate recovery codes", err)
|
s.internal(w, r, "generate recovery codes", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.ReplaceRecoveryCodes(r.Context(), user.ID, hashes); err != nil {
|
if err := s.db.ReplaceRecoveryCodes(r.Context(), user.ID, hashes); err != nil {
|
||||||
s.internal(w, "store recovery codes", err)
|
s.internal(w, r, "store recovery codes", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.SetTOTPSecret(r.Context(), user.ID, user.TOTPSecret, true); err != nil {
|
if err := s.db.SetTOTPSecret(r.Context(), user.ID, user.TOTPSecret, true); err != nil {
|
||||||
s.internal(w, "enable totp", err)
|
s.internal(w, r, "enable totp", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -98,7 +98,7 @@ func (s *Server) handleTOTPDisable(w http.ResponseWriter, r *http.Request) {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.SetTOTPSecret(r.Context(), user.ID, "", false); err != nil {
|
if err := s.db.SetTOTPSecret(r.Context(), user.ID, "", false); err != nil {
|
||||||
s.internal(w, "disable totp", err)
|
s.internal(w, r, "disable totp", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.ReplaceRecoveryCodes(r.Context(), user.ID, nil); err != nil {
|
if err := s.db.ReplaceRecoveryCodes(r.Context(), user.ID, nil); err != nil {
|
||||||
@@ -127,11 +127,11 @@ func (s *Server) handleRecoveryCodesRegenerate(w http.ResponseWriter, r *http.Re
|
|||||||
|
|
||||||
codes, hashes, err := auth.NewRecoveryCodes()
|
codes, hashes, err := auth.NewRecoveryCodes()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "generate recovery codes", err)
|
s.internal(w, r, "generate recovery codes", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
if err := s.db.ReplaceRecoveryCodes(r.Context(), user.ID, hashes); err != nil {
|
if err := s.db.ReplaceRecoveryCodes(r.Context(), user.ID, hashes); err != nil {
|
||||||
s.internal(w, "store recovery codes", err)
|
s.internal(w, r, "store recovery codes", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, totpConfirmResponse{RecoveryCodes: codes})
|
writeJSON(w, http.StatusOK, totpConfirmResponse{RecoveryCodes: codes})
|
||||||
@@ -140,7 +140,7 @@ func (s *Server) handleRecoveryCodesRegenerate(w http.ResponseWriter, r *http.Re
|
|||||||
func (s *Server) handleRecoveryCodesCount(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleRecoveryCodesCount(w http.ResponseWriter, r *http.Request) {
|
||||||
n, err := s.db.CountRecoveryCodes(r.Context(), userFrom(r.Context()).ID)
|
n, err := s.db.CountRecoveryCodes(r.Context(), userFrom(r.Context()).ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "count recovery codes", err)
|
s.internal(w, r, "count recovery codes", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
writeJSON(w, http.StatusOK, map[string]int{"remaining": n})
|
writeJSON(w, http.StatusOK, map[string]int{"remaining": n})
|
||||||
|
|||||||
@@ -30,11 +30,13 @@ type adminUserJSON struct {
|
|||||||
Self bool `json:"self"`
|
Self bool `json:"self"`
|
||||||
CreatedAt string `json:"created_at"`
|
CreatedAt string `json:"created_at"`
|
||||||
LastSeenAt string `json:"last_seen_at,omitempty"`
|
LastSeenAt string `json:"last_seen_at,omitempty"`
|
||||||
// ProjectCount and TaskCount are what a delete would destroy. Sent with the
|
// ProjectCount and TaskCount are what a delete would destroy, and
|
||||||
// list rather than fetched when the button is pressed, so the confirmation can
|
// AuthoredElsewhere is what it would leave behind without an author. Sent with
|
||||||
// name real numbers without a round trip in the middle of a decision.
|
// the list rather than fetched when the button is pressed, so the confirmation
|
||||||
ProjectCount int `json:"project_count"`
|
// can name real numbers without a round trip in the middle of a decision.
|
||||||
TaskCount int `json:"task_count"`
|
ProjectCount int `json:"project_count"`
|
||||||
|
TaskCount int `json:"task_count"`
|
||||||
|
AuthoredElsewhere int `json:"authored_elsewhere"`
|
||||||
}
|
}
|
||||||
|
|
||||||
type pendingInviteJSON struct {
|
type pendingInviteJSON struct {
|
||||||
@@ -54,12 +56,12 @@ func (s *Server) handleListUsers(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
users, err := s.db.ListUsers(r.Context())
|
users, err := s.db.ListUsers(r.Context())
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list users", err)
|
s.internal(w, r, "list users", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
invites, err := s.db.ListPendingInvites(r.Context())
|
invites, err := s.db.ListPendingInvites(r.Context())
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list pending invites", err)
|
s.internal(w, r, "list pending invites", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -70,6 +72,7 @@ func (s *Server) handleListUsers(w http.ResponseWriter, r *http.Request) {
|
|||||||
IsAdmin: u.IsAdmin, Self: u.ID == me.ID,
|
IsAdmin: u.IsAdmin, Self: u.ID == me.ID,
|
||||||
CreatedAt: u.CreatedAt.Format(time.RFC3339),
|
CreatedAt: u.CreatedAt.Format(time.RFC3339),
|
||||||
ProjectCount: u.ProjectCount, TaskCount: u.TaskCount,
|
ProjectCount: u.ProjectCount, TaskCount: u.TaskCount,
|
||||||
|
AuthoredElsewhere: u.AuthoredElsewhere,
|
||||||
}
|
}
|
||||||
// Zero means never signed in, which is not a time and must not be sent as
|
// Zero means never signed in, which is not a time and must not be sent as
|
||||||
// one — 1970 in an interface reads as a bug rather than as "never".
|
// one — 1970 in an interface reads as a bug rather than as "never".
|
||||||
@@ -128,7 +131,7 @@ func (s *Server) handleCreateUser(w http.ResponseWriter, r *http.Request) {
|
|||||||
token, _, err := s.db.CreateInvite(r.Context(), email, "", store.RoleEditor,
|
token, _, err := s.db.CreateInvite(r.Context(), email, "", store.RoleEditor,
|
||||||
inviter.ID, s.cfg.InviteTTL)
|
inviter.ID, s.cfg.InviteTTL)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "create instance invite", err)
|
s.internal(w, r, "create instance invite", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
link := s.cfg.BaseURL + "/invite?token=" + token
|
link := s.cfg.BaseURL + "/invite?token=" + token
|
||||||
@@ -170,7 +173,7 @@ func (s *Server) handleUpdateUser(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if err := s.db.SetUserAdmin(r.Context(), userID, *req.IsAdmin); err != nil {
|
if err := s.db.SetUserAdmin(r.Context(), userID, *req.IsAdmin); err != nil {
|
||||||
s.storeError(w, "set user admin", err)
|
s.storeError(w, r, "set user admin", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.log.Info("admin changed", "by", me.ID, "user", userID, "is_admin", *req.IsAdmin)
|
s.log.Info("admin changed", "by", me.ID, "user", userID, "is_admin", *req.IsAdmin)
|
||||||
@@ -197,7 +200,7 @@ func (s *Server) handleDeleteUser(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if err := s.db.DeleteUser(r.Context(), userID); err != nil {
|
if err := s.db.DeleteUser(r.Context(), userID); err != nil {
|
||||||
s.storeError(w, "delete user", err)
|
s.storeError(w, r, "delete user", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
s.log.Info("user deleted", "by", me.ID, "user", userID)
|
s.log.Info("user deleted", "by", me.ID, "user", userID)
|
||||||
@@ -206,7 +209,7 @@ func (s *Server) handleDeleteUser(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
func (s *Server) handleDeleteInvite(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleDeleteInvite(w http.ResponseWriter, r *http.Request) {
|
||||||
if err := s.db.DeleteInvite(r.Context(), chi.URLParam(r, "inviteID")); err != nil {
|
if err := s.db.DeleteInvite(r.Context(), chi.URLParam(r, "inviteID")); err != nil {
|
||||||
s.storeError(w, "delete invite", err)
|
s.storeError(w, r, "delete invite", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
w.WriteHeader(http.StatusNoContent)
|
w.WriteHeader(http.StatusNoContent)
|
||||||
@@ -218,7 +221,7 @@ func (s *Server) handleDeleteInvite(w http.ResponseWriter, r *http.Request) {
|
|||||||
func (s *Server) refuseIfLastAdmin(w http.ResponseWriter, r *http.Request, userID, message string) error {
|
func (s *Server) refuseIfLastAdmin(w http.ResponseWriter, r *http.Request, userID, message string) error {
|
||||||
target, err := s.db.UserByID(r.Context(), userID)
|
target, err := s.db.UserByID(r.Context(), userID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.storeError(w, "get user", err)
|
s.storeError(w, r, "get user", err)
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
if !target.IsAdmin {
|
if !target.IsAdmin {
|
||||||
@@ -226,7 +229,7 @@ func (s *Server) refuseIfLastAdmin(w http.ResponseWriter, r *http.Request, userI
|
|||||||
}
|
}
|
||||||
admins, err := s.db.CountAdmins(r.Context())
|
admins, err := s.db.CountAdmins(r.Context())
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "count admins", err)
|
s.internal(w, r, "count admins", err)
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
if admins <= 1 {
|
if admins <= 1 {
|
||||||
|
|||||||
@@ -2,6 +2,7 @@ package httpapi
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"net/http"
|
"net/http"
|
||||||
|
"net/url"
|
||||||
"testing"
|
"testing"
|
||||||
)
|
)
|
||||||
|
|
||||||
@@ -125,8 +126,8 @@ func TestASecondAdministratorCanBeDemoted(t *testing.T) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// Deleting an account takes more than its own projects, and the list says so
|
// Deleting an account takes its own projects and leaves everything else behind.
|
||||||
// before anybody presses the button.
|
// The list says both numbers before anybody presses the button.
|
||||||
func TestTheDeleteCountsSayWhatWouldGo(t *testing.T) {
|
func TestTheDeleteCountsSayWhatWouldGo(t *testing.T) {
|
||||||
ts := newTestServer(t)
|
ts := newTestServer(t)
|
||||||
ts.bootstrap(t)
|
ts.bootstrap(t)
|
||||||
@@ -143,9 +144,10 @@ func TestTheDeleteCountsSayWhatWouldGo(t *testing.T) {
|
|||||||
"content": "deres egen", "project_id": theirs["id"].(string),
|
"content": "deres egen", "project_id": theirs["id"].(string),
|
||||||
})
|
})
|
||||||
|
|
||||||
// And a task they wrote in a project somebody else owns. tasks.created_by
|
// And a task they wrote in a project somebody else owns. This one survives —
|
||||||
// cascades, so this one goes too — and a count that missed it would understate
|
// `created_by` is ON DELETE SET NULL — and it is counted separately, because
|
||||||
// the damage in exactly the case that matters.
|
// "this much disappears" and "this much stays unattributed" are two different
|
||||||
|
// things to tell somebody who is about to press delete.
|
||||||
_, mine := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Fælles"})
|
_, mine := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Fælles"})
|
||||||
sharedID := mine["id"].(string)
|
sharedID := mine["id"].(string)
|
||||||
ts.do(t, "POST", "/api/v1/projects/"+sharedID+"/invites", map[string]any{
|
ts.do(t, "POST", "/api/v1/projects/"+sharedID+"/invites", map[string]any{
|
||||||
@@ -168,18 +170,52 @@ func TestTheDeleteCountsSayWhatWouldGo(t *testing.T) {
|
|||||||
if found["project_count"] != float64(1) {
|
if found["project_count"] != float64(1) {
|
||||||
t.Errorf("project_count = %v, want 1 — the Inbox must not be counted", found["project_count"])
|
t.Errorf("project_count = %v, want 1 — the Inbox must not be counted", found["project_count"])
|
||||||
}
|
}
|
||||||
if found["task_count"] != float64(2) {
|
if found["task_count"] != float64(1) {
|
||||||
t.Errorf("task_count = %v, want 2 — the task in the shared project cascades too",
|
t.Errorf("task_count = %v, want 1 — only the task in their own project goes",
|
||||||
found["task_count"])
|
found["task_count"])
|
||||||
}
|
}
|
||||||
|
if found["authored_elsewhere"] != float64(1) {
|
||||||
|
t.Errorf("authored_elsewhere = %v, want 1 — the task in the shared project stays",
|
||||||
|
found["authored_elsewhere"])
|
||||||
|
}
|
||||||
|
|
||||||
// And the delete really does take it.
|
// And the delete leaves it standing, without an author.
|
||||||
if resp, _ := ts.do(t, "DELETE", "/api/v1/users/"+otherUser.ID, nil); resp.StatusCode != http.StatusNoContent {
|
if resp, _ := ts.do(t, "DELETE", "/api/v1/users/"+otherUser.ID, nil); resp.StatusCode != http.StatusNoContent {
|
||||||
t.Fatalf("delete: status %d", resp.StatusCode)
|
t.Fatalf("delete: status %d", resp.StatusCode)
|
||||||
}
|
}
|
||||||
_, tasks := ts.do(t, "GET", "/api/v1/tasks?project_id="+sharedID, nil)
|
_, tasks := ts.do(t, "GET", "/api/v1/tasks?project_id="+sharedID, nil)
|
||||||
if got, _ := tasks["tasks"].([]any); len(got) != 0 {
|
got, _ := tasks["tasks"].([]any)
|
||||||
t.Errorf("a task written by the deleted account survived in a shared project: %v", got)
|
if len(got) != 1 {
|
||||||
|
t.Fatalf("a task written by the deleted account should survive in a shared project, got %v", got)
|
||||||
|
}
|
||||||
|
surviving := got[0].(map[string]any)
|
||||||
|
if surviving["content"] != "skrevet i et delt projekt" {
|
||||||
|
t.Errorf("the surviving task is not the one that was written: %v", surviving["content"])
|
||||||
|
}
|
||||||
|
if surviving["created_by"] != "" {
|
||||||
|
t.Errorf("created_by = %q, want empty — the author is gone, the work is not",
|
||||||
|
surviving["created_by"])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// The tasks table was rebuilt to change created_by's delete action, and a rebuild
|
||||||
|
// is where an index quietly stops matching its table: tasks_fts is external-content
|
||||||
|
// and keyed on tasks.rowid, which a rebuilt table hands out afresh. Search is the
|
||||||
|
// only place that would notice.
|
||||||
|
func TestSearchStillFindsTasksAfterTheTableRebuild(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
_, project := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Have"})
|
||||||
|
ts.do(t, "POST", "/api/v1/tasks", map[string]any{
|
||||||
|
"content": "beskær det grønne hegn", "project_id": project["id"].(string),
|
||||||
|
})
|
||||||
|
|
||||||
|
for _, q := range []string{"grønne", "gronne", "hegn"} {
|
||||||
|
_, found := ts.do(t, "GET", "/api/v1/search?q="+url.QueryEscape(q), nil)
|
||||||
|
if got, _ := found["tasks"].([]any); len(got) != 1 {
|
||||||
|
t.Errorf("search for %q found %d tasks, want 1", q, len(got))
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -277,3 +313,70 @@ func indexAfter(s, needle string) int {
|
|||||||
}
|
}
|
||||||
return 0
|
return 0
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// A 500 has to leave something behind that a restart cannot take.
|
||||||
|
//
|
||||||
|
// The panel's watcher already reports that one happened. What it cannot report is
|
||||||
|
// what it was: that lives in the container's log, and a Rune replaces the
|
||||||
|
// container on every restart, so the explanation is usually gone before anybody
|
||||||
|
// looks.
|
||||||
|
func TestAServerErrorIsKeptWhereARestartCannotTakeIt(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
|
||||||
|
// Nothing has gone wrong yet.
|
||||||
|
_, empty := ts.do(t, "GET", "/api/v1/errors", nil)
|
||||||
|
if rows, _ := empty["errors"].([]any); len(rows) != 0 {
|
||||||
|
t.Fatalf("a fresh instance has errors already: %v", rows)
|
||||||
|
}
|
||||||
|
|
||||||
|
// Break something the handler cannot survive: the table it reads is gone, so
|
||||||
|
// the query fails and the handler answers 500. Dropping it is a blunt way to
|
||||||
|
// provoke that, and a faithful one — it is the same code path a disk error or
|
||||||
|
// a corrupt page would take.
|
||||||
|
if _, err := ts.db.ExecContext(t.Context(), `DROP TABLE project_groups`); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
resp, _ := ts.do(t, "GET", "/api/v1/project-groups", nil)
|
||||||
|
if resp.StatusCode != http.StatusInternalServerError {
|
||||||
|
t.Fatalf("status %d, want 500 — the fault was not provoked", resp.StatusCode)
|
||||||
|
}
|
||||||
|
|
||||||
|
_, body := ts.do(t, "GET", "/api/v1/errors", nil)
|
||||||
|
rows, _ := body["errors"].([]any)
|
||||||
|
if len(rows) != 1 {
|
||||||
|
t.Fatalf("want one recorded error, got %v", rows)
|
||||||
|
}
|
||||||
|
row := rows[0].(map[string]any)
|
||||||
|
if row["what"] != "list project groups" {
|
||||||
|
t.Errorf("what = %v — the operation is the part a status code cannot give", row["what"])
|
||||||
|
}
|
||||||
|
if row["path"] != "/api/v1/project-groups" || row["method"] != "GET" {
|
||||||
|
t.Errorf("path/method = %v %v", row["method"], row["path"])
|
||||||
|
}
|
||||||
|
if row["status"] != float64(500) {
|
||||||
|
t.Errorf("status = %v", row["status"])
|
||||||
|
}
|
||||||
|
if row["message"] == "" {
|
||||||
|
t.Error("no message: the row says something broke and not what")
|
||||||
|
}
|
||||||
|
if row["user_name"] != "Kristian" {
|
||||||
|
t.Errorf("user_name = %v — a fault only one account hits is a different problem",
|
||||||
|
row["user_name"])
|
||||||
|
}
|
||||||
|
if row["request_id"] == "" {
|
||||||
|
t.Error("no request id, so the row cannot be tied back to the log line")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// The list is an administrator's: it carries paths, accounts and the server's own
|
||||||
|
// error strings.
|
||||||
|
func TestTheErrorLogIsAdminsOnly(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
other := ts.newUser(t, "anden@example.dk", "Anden")
|
||||||
|
|
||||||
|
if resp, _ := other.do(t, "GET", "/api/v1/errors", nil); resp.StatusCode != http.StatusForbidden {
|
||||||
|
t.Errorf("status %d, want 403", resp.StatusCode)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
@@ -31,7 +31,7 @@ func (s *Server) handleToday(w http.ResponseWriter, r *http.Request) {
|
|||||||
Limit: 500,
|
Limit: 500,
|
||||||
})
|
})
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "today", err)
|
s.internal(w, r, "today", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -71,7 +71,7 @@ func (s *Server) handleUpcoming(w http.ResponseWriter, r *http.Request) {
|
|||||||
Limit: 1000,
|
Limit: 1000,
|
||||||
})
|
})
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "upcoming", err)
|
s.internal(w, r, "upcoming", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -92,6 +92,31 @@ func (s *Server) handleUpcoming(w http.ResponseWriter, r *http.Request) {
|
|||||||
writeJSON(w, http.StatusOK, map[string]any{"days": out})
|
writeJSON(w, http.StatusOK, map[string]any{"days": out})
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// handlePeople lists everybody the caller shares a project with, so an interface
|
||||||
|
// can put a name and a face on an assignee id.
|
||||||
|
//
|
||||||
|
// One request per session rather than a lookup per row, and not the instance's
|
||||||
|
// user list — that is the administrator's page. A task list has no business
|
||||||
|
// enumerating everybody with an account here.
|
||||||
|
func (s *Server) handlePeople(w http.ResponseWriter, r *http.Request) {
|
||||||
|
people, err := s.db.ListPeople(r.Context(), userFrom(r.Context()).ID)
|
||||||
|
if err != nil {
|
||||||
|
s.internal(w, r, "list people", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
out := make([]personJSON, 0, len(people))
|
||||||
|
for _, p := range people {
|
||||||
|
out = append(out, personJSON{ID: p.ID, Name: p.Name, AvatarColor: p.AvatarColor})
|
||||||
|
}
|
||||||
|
writeJSON(w, http.StatusOK, map[string]any{"people": out})
|
||||||
|
}
|
||||||
|
|
||||||
|
type personJSON struct {
|
||||||
|
ID string `json:"id"`
|
||||||
|
Name string `json:"name"`
|
||||||
|
AvatarColor string `json:"avatar_color"`
|
||||||
|
}
|
||||||
|
|
||||||
type delegatedPerson struct {
|
type delegatedPerson struct {
|
||||||
UserID string `json:"user_id"`
|
UserID string `json:"user_id"`
|
||||||
Name string `json:"name"`
|
Name string `json:"name"`
|
||||||
@@ -117,7 +142,7 @@ func (s *Server) handleDelegated(w http.ResponseWriter, r *http.Request) {
|
|||||||
Limit: parseLimit(r.URL.Query().Get("limit"), 200, 500),
|
Limit: parseLimit(r.URL.Query().Get("limit"), 200, 500),
|
||||||
})
|
})
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "delegated", err)
|
s.internal(w, r, "delegated", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -132,7 +157,7 @@ func (s *Server) handleDelegated(w http.ResponseWriter, r *http.Request) {
|
|||||||
|
|
||||||
people, err := s.db.PeopleByIDs(r.Context(), ids)
|
people, err := s.db.PeopleByIDs(r.Context(), ids)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "delegated people", err)
|
s.internal(w, r, "delegated people", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -184,7 +209,7 @@ func (s *Server) handleSearch(w http.ResponseWriter, r *http.Request) {
|
|||||||
Limit: parseLimit(r.URL.Query().Get("limit"), 40, 100),
|
Limit: parseLimit(r.URL.Query().Get("limit"), 40, 100),
|
||||||
})
|
})
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "search tasks", err)
|
s.internal(w, r, "search tasks", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -192,7 +217,7 @@ func (s *Server) handleSearch(w http.ResponseWriter, r *http.Request) {
|
|||||||
// second FTS index for that would be more machinery than the problem needs.
|
// second FTS index for that would be more machinery than the problem needs.
|
||||||
projects, err := s.db.ListProjects(r.Context(), user.ID, false)
|
projects, err := s.db.ListProjects(r.Context(), user.ID, false)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "search projects", err)
|
s.internal(w, r, "search projects", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
matched := []projectJSON{}
|
matched := []projectJSON{}
|
||||||
@@ -214,7 +239,7 @@ func (s *Server) handleActivity(w http.ResponseWriter, r *http.Request) {
|
|||||||
entries, err := s.db.ListActivity(r.Context(), chi.URLParam(r, "projectID"),
|
entries, err := s.db.ListActivity(r.Context(), chi.URLParam(r, "projectID"),
|
||||||
parseLimit(r.URL.Query().Get("limit"), 50, 200))
|
parseLimit(r.URL.Query().Get("limit"), 50, 200))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
s.internal(w, "list activity", err)
|
s.internal(w, r, "list activity", err)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -153,3 +153,50 @@ func TestDelegatedIsPerPersonAndRespectsAccess(t *testing.T) {
|
|||||||
t.Errorf("a task in a project they cannot see: %v", people)
|
t.Errorf("a task in a project they cannot see: %v", people)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// /people is what puts a name on an assignee id. It must be the people you share
|
||||||
|
// work with — not the instance's user list, which is the administrator's page.
|
||||||
|
func TestPeopleIsWhoYouShareWorkWith(t *testing.T) {
|
||||||
|
ts := newTestServer(t)
|
||||||
|
ts.bootstrap(t)
|
||||||
|
colleague := ts.newUser(t, "anders@example.dk", "Anders")
|
||||||
|
ts.newUser(t, "fremmed@example.dk", "Fremmed")
|
||||||
|
|
||||||
|
_, project := ts.do(t, "POST", "/api/v1/projects", map[string]any{"name": "Delt"})
|
||||||
|
ts.do(t, "POST", "/api/v1/projects/"+project["id"].(string)+"/invites", map[string]any{
|
||||||
|
"email": "anders@example.dk", "role": "editor",
|
||||||
|
})
|
||||||
|
|
||||||
|
_, body := ts.do(t, "GET", "/api/v1/people", nil)
|
||||||
|
names := map[string]bool{}
|
||||||
|
for _, raw := range body["people"].([]any) {
|
||||||
|
p := raw.(map[string]any)
|
||||||
|
names[p["name"].(string)] = true
|
||||||
|
if p["avatar_color"] == "" {
|
||||||
|
t.Errorf("no avatar colour for %v — the row cannot draw a face", p["name"])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if !names["Kristian"] {
|
||||||
|
t.Error("yourself is missing, so a client cannot tell 'me' from 'somebody else' against one list")
|
||||||
|
}
|
||||||
|
if !names["Anders"] {
|
||||||
|
t.Error("somebody sharing a project is missing")
|
||||||
|
}
|
||||||
|
if names["Fremmed"] {
|
||||||
|
t.Error("an account with no project in common is listed — this is not the user directory")
|
||||||
|
}
|
||||||
|
|
||||||
|
// And it is symmetric: the person invited sees the person who invited them.
|
||||||
|
_, theirs := colleague.do(t, "GET", "/api/v1/people", nil)
|
||||||
|
seen := map[string]bool{}
|
||||||
|
for _, raw := range theirs["people"].([]any) {
|
||||||
|
seen[raw.(map[string]any)["name"].(string)] = true
|
||||||
|
}
|
||||||
|
if !seen["Kristian"] || !seen["Anders"] {
|
||||||
|
t.Errorf("the member cannot see who they share with: %v", seen)
|
||||||
|
}
|
||||||
|
if seen["Fremmed"] {
|
||||||
|
t.Errorf("a stranger is listed: %v", seen)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
@@ -0,0 +1,116 @@
|
|||||||
|
// Package i18n exists only to hold this test.
|
||||||
|
//
|
||||||
|
// The interface's strings live in the frontend, where they are read; nothing in Go
|
||||||
|
// needs them. What Go can do is fail the build when the two dictionaries drift,
|
||||||
|
// which is the failure mode a translation always has and which nothing else here
|
||||||
|
// would notice: a key present in Danish and missing from English renders as Danish
|
||||||
|
// inside an English screen, and a key present only in English is a string nobody
|
||||||
|
// will ever see.
|
||||||
|
//
|
||||||
|
// A scanner rather than a parser, the same approach `colors_test.go` and
|
||||||
|
// `openapi_test.go` take: it needs the keys out of two lists this repository owns,
|
||||||
|
// and that is worth more than a dependency in a project whose whole shape is "one
|
||||||
|
// static binary".
|
||||||
|
package i18n
|
||||||
|
|
||||||
|
import (
|
||||||
|
"os"
|
||||||
|
"path/filepath"
|
||||||
|
"regexp"
|
||||||
|
"sort"
|
||||||
|
"strings"
|
||||||
|
"testing"
|
||||||
|
)
|
||||||
|
|
||||||
|
func TestTheTwoDictionariesHaveTheSameKeys(t *testing.T) {
|
||||||
|
dir := filepath.Join("..", "..", "web", "src", "lib", "locales")
|
||||||
|
da := readKeys(t, filepath.Join(dir, "da.js"))
|
||||||
|
en := readKeys(t, filepath.Join(dir, "en.js"))
|
||||||
|
|
||||||
|
if len(da) == 0 {
|
||||||
|
t.Fatal("no keys found in da.js — the scanner is looking at the wrong shape")
|
||||||
|
}
|
||||||
|
|
||||||
|
var missing, extra []string
|
||||||
|
for key := range da {
|
||||||
|
if !en[key] {
|
||||||
|
missing = append(missing, key)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for key := range en {
|
||||||
|
if !da[key] {
|
||||||
|
extra = append(extra, key)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
sort.Strings(missing)
|
||||||
|
sort.Strings(extra)
|
||||||
|
|
||||||
|
if len(missing) > 0 {
|
||||||
|
t.Errorf("%d keys are in da.js and not in en.js — they render as Danish inside an "+
|
||||||
|
"English screen:\n %s", len(missing), strings.Join(missing, "\n "))
|
||||||
|
}
|
||||||
|
if len(extra) > 0 {
|
||||||
|
t.Errorf("%d keys are in en.js and not in da.js — nothing reads them, because Danish "+
|
||||||
|
"is the source:\n %s", len(extra), strings.Join(extra, "\n "))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// The placeholders have to match too. `t()` fills `{name}` from what the caller
|
||||||
|
// passes, so a translation that spells one differently leaves `{navn}` on the
|
||||||
|
// screen — which is worse than an untranslated sentence, because it looks like a
|
||||||
|
// bug in the app rather than a gap in the dictionary.
|
||||||
|
func TestTheTwoDictionariesUseTheSamePlaceholders(t *testing.T) {
|
||||||
|
dir := filepath.Join("..", "..", "web", "src", "lib", "locales")
|
||||||
|
da := readEntries(t, filepath.Join(dir, "da.js"))
|
||||||
|
en := readEntries(t, filepath.Join(dir, "en.js"))
|
||||||
|
|
||||||
|
for key, danish := range da {
|
||||||
|
english, ok := en[key]
|
||||||
|
if !ok {
|
||||||
|
continue // reported by the test above
|
||||||
|
}
|
||||||
|
want := placeholders(danish)
|
||||||
|
got := placeholders(english)
|
||||||
|
if strings.Join(want, ",") != strings.Join(got, ",") {
|
||||||
|
t.Errorf("%s: Danish fills %v, English fills %v", key, want, got)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
var (
|
||||||
|
// `'some.key': 'the string',` — single-quoted keys and values, which is what
|
||||||
|
// prettier writes for these files.
|
||||||
|
reEntry = regexp.MustCompile(`(?m)^\s*'([a-zA-Z0-9._]+)':\s*(.*?),?\s*$`)
|
||||||
|
rePlaceholder = regexp.MustCompile(`\{(\w+)\}`)
|
||||||
|
)
|
||||||
|
|
||||||
|
func readKeys(t *testing.T, path string) map[string]bool {
|
||||||
|
t.Helper()
|
||||||
|
keys := map[string]bool{}
|
||||||
|
for key := range readEntries(t, path) {
|
||||||
|
keys[key] = true
|
||||||
|
}
|
||||||
|
return keys
|
||||||
|
}
|
||||||
|
|
||||||
|
func readEntries(t *testing.T, path string) map[string]string {
|
||||||
|
t.Helper()
|
||||||
|
body, err := os.ReadFile(path)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("read %s: %v", filepath.Base(path), err)
|
||||||
|
}
|
||||||
|
out := map[string]string{}
|
||||||
|
for _, m := range reEntry.FindAllStringSubmatch(string(body), -1) {
|
||||||
|
out[m[1]] = m[2]
|
||||||
|
}
|
||||||
|
return out
|
||||||
|
}
|
||||||
|
|
||||||
|
func placeholders(s string) []string {
|
||||||
|
var found []string
|
||||||
|
for _, m := range rePlaceholder.FindAllStringSubmatch(s, -1) {
|
||||||
|
found = append(found, m[1])
|
||||||
|
}
|
||||||
|
sort.Strings(found)
|
||||||
|
return found
|
||||||
|
}
|
||||||
@@ -0,0 +1,70 @@
|
|||||||
|
package i18n
|
||||||
|
|
||||||
|
import (
|
||||||
|
"os"
|
||||||
|
"path/filepath"
|
||||||
|
"regexp"
|
||||||
|
"strings"
|
||||||
|
"testing"
|
||||||
|
)
|
||||||
|
|
||||||
|
// Danish prose left in a component is the failure the dictionaries cannot see.
|
||||||
|
//
|
||||||
|
// `i18n_test.go` checks that the two dictionaries agree. It cannot check the thing
|
||||||
|
// that actually went wrong: a string that was never put in either, because nobody
|
||||||
|
// noticed it. Three survived the sweep — "Ingen nyere version fundet.", "Ikke mere
|
||||||
|
// i dag." and a token hint split across two lines — and they survived it for the
|
||||||
|
// same reason. The sweep grepped for æøå, and none of them contain one.
|
||||||
|
//
|
||||||
|
// So this reads the templates instead and looks for the words that give Danish
|
||||||
|
// away whatever letters it happens to use. A word list rather than a language
|
||||||
|
// detector: this repository ships one static binary, and a list of thirty common
|
||||||
|
// words catches the sentences a person would actually write.
|
||||||
|
func TestNoDanishProseOutsideTheDictionaries(t *testing.T) {
|
||||||
|
// Text nodes of three characters or more, and the three attributes a person
|
||||||
|
// reads. Anything inside {…} is already an expression — usually a t() call —
|
||||||
|
// and is not what this is looking for.
|
||||||
|
text := regexp.MustCompile(`>\s*([^<>{}\n][^<>{}]{3,})\s*<`)
|
||||||
|
attrs := regexp.MustCompile(`(?:aria-label|title|placeholder)="([^"{][^"]{3,})"`)
|
||||||
|
// Words that are Danish and are not also English. "is", "for" and "to" would
|
||||||
|
// match English prose and are deliberately absent.
|
||||||
|
danish := regexp.MustCompile(`(?i)\b(og|er|ikke|det|den|der|til|kan|som|har|med|af|en|et|du|din|dine|vises|ingen|nyere|fundet|ude|valgt|slettet|gemt|opgave|projekt|indstillinger|fjern|opret|vælg|luk|tilføj|ryd|gem|slet|omdøb)\b`)
|
||||||
|
comments := regexp.MustCompile(`(?s)<!--.*?-->`)
|
||||||
|
styles := regexp.MustCompile(`(?s)<style>.*`)
|
||||||
|
|
||||||
|
var found []string
|
||||||
|
root := filepath.Join("..", "..", "web", "src")
|
||||||
|
err := filepath.Walk(root, func(path string, info os.FileInfo, err error) error {
|
||||||
|
if err != nil || info.IsDir() || !strings.HasSuffix(path, ".svelte") {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
body, err := os.ReadFile(path)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
markup := string(body)
|
||||||
|
if at := strings.Index(markup, "</script>"); at > 0 {
|
||||||
|
markup = markup[at:]
|
||||||
|
}
|
||||||
|
markup = styles.ReplaceAllString(comments.ReplaceAllString(markup, ""), "")
|
||||||
|
|
||||||
|
rel, _ := filepath.Rel(root, path)
|
||||||
|
for _, m := range append(text.FindAllStringSubmatch(markup, -1),
|
||||||
|
attrs.FindAllStringSubmatch(markup, -1)...) {
|
||||||
|
phrase := strings.TrimSpace(m[1])
|
||||||
|
if danish.MatchString(phrase) {
|
||||||
|
found = append(found, rel+": "+strings.Join(strings.Fields(phrase), " "))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return nil
|
||||||
|
})
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("walk %s: %v", root, err)
|
||||||
|
}
|
||||||
|
|
||||||
|
if len(found) > 0 {
|
||||||
|
t.Errorf("%d Danish string(s) are written into a component instead of going through "+
|
||||||
|
"t(). An English interface shows them in Danish, and neither dictionary knows "+
|
||||||
|
"they exist:\n %s", len(found), strings.Join(found, "\n "))
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -55,6 +55,7 @@ func (r *Runner) Start(ctx context.Context) {
|
|||||||
r.every(ctx, "backup", time.Hour, r.nightlyBackup)
|
r.every(ctx, "backup", time.Hour, r.nightlyBackup)
|
||||||
r.every(ctx, "trash", time.Hour, r.emptyTrash)
|
r.every(ctx, "trash", time.Hour, r.emptyTrash)
|
||||||
r.every(ctx, "sessions", 6*time.Hour, r.purgeSessions)
|
r.every(ctx, "sessions", 6*time.Hour, r.purgeSessions)
|
||||||
|
r.every(ctx, "errors", 12*time.Hour, r.purgeErrors)
|
||||||
// Ten minutes is a compromise: Gmail's push notifications would be instant but
|
// Ten minutes is a compromise: Gmail's push notifications would be instant but
|
||||||
// need a public webhook and a Cloud Pub/Sub topic, which is a lot of Google
|
// need a public webhook and a Cloud Pub/Sub topic, which is a lot of Google
|
||||||
// account for a to-do app. Ten minutes is fast enough for something somebody
|
// account for a to-do app. Ten minutes is fast enough for something somebody
|
||||||
@@ -161,22 +162,41 @@ func (r *Runner) nightlyBackup(ctx context.Context) error {
|
|||||||
if time.Since(last) < 23*time.Hour {
|
if time.Since(last) < 23*time.Hour {
|
||||||
return nil
|
return nil
|
||||||
}
|
}
|
||||||
|
return Backup(ctx, r.cfg, r.db, r.log)
|
||||||
|
}
|
||||||
|
|
||||||
|
// Backup takes one snapshot now, records the run and rotates the old files.
|
||||||
|
//
|
||||||
|
// Exported and free of the Runner, because the settings page can ask for one too:
|
||||||
|
// waiting until tonight to find out whether backups work at all is how somebody
|
||||||
|
// discovers on the day they need one that the volume has been read-only for a
|
||||||
|
// month. The nightly job is this function behind a "has one run today" check; the
|
||||||
|
// button is this function without it.
|
||||||
|
//
|
||||||
|
// It uses SQLite's own VACUUM INTO rather than copying the file. A plain copy of a
|
||||||
|
// live WAL-mode database can miss the most recent writes or catch a page
|
||||||
|
// mid-update; VACUUM INTO produces a consistent, already-compacted database
|
||||||
|
// without blocking writers for the duration.
|
||||||
|
func Backup(ctx context.Context, cfg *config.Config, db *store.DB, log *slog.Logger) error {
|
||||||
started := time.Now()
|
started := time.Now()
|
||||||
name := backupPrefix + started.UTC().Format("2006-01-02T150405Z") + ".db"
|
name := backupPrefix + started.UTC().Format("2006-01-02T150405Z") + ".db"
|
||||||
path := filepath.Join(r.cfg.BackupsDir(), name)
|
path := filepath.Join(cfg.BackupsDir(), name)
|
||||||
|
|
||||||
runID, err := r.db.StartBackupRun(ctx, started)
|
if err := os.MkdirAll(cfg.BackupsDir(), 0o755); err != nil {
|
||||||
|
return fmt.Errorf("backups dir: %w", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
runID, err := db.StartBackupRun(ctx, started)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
|
|
||||||
if err := r.db.Snapshot(ctx, path); err != nil {
|
if err := db.Snapshot(ctx, path); err != nil {
|
||||||
// A failed attempt can leave a partial file, which would then look like a
|
// A failed attempt can leave a partial file, which would then look like a
|
||||||
// backup to anybody reading the directory.
|
// backup to anybody reading the directory.
|
||||||
os.Remove(path)
|
os.Remove(path)
|
||||||
if recErr := r.db.FinishBackupRun(ctx, runID, "", 0, err); recErr != nil {
|
if recErr := db.FinishBackupRun(ctx, runID, "", 0, err); recErr != nil {
|
||||||
r.log.Warn("record backup failure", "err", recErr)
|
log.Warn("record backup failure", "err", recErr)
|
||||||
}
|
}
|
||||||
return fmt.Errorf("snapshot: %w", err)
|
return fmt.Errorf("snapshot: %w", err)
|
||||||
}
|
}
|
||||||
@@ -185,13 +205,13 @@ func (r *Runner) nightlyBackup(ctx context.Context) error {
|
|||||||
if info, err := os.Stat(path); err == nil {
|
if info, err := os.Stat(path); err == nil {
|
||||||
size = info.Size()
|
size = info.Size()
|
||||||
}
|
}
|
||||||
if err := r.db.FinishBackupRun(ctx, runID, path, size, nil); err != nil {
|
if err := db.FinishBackupRun(ctx, runID, path, size, nil); err != nil {
|
||||||
r.log.Warn("record backup", "err", err)
|
log.Warn("record backup", "err", err)
|
||||||
}
|
}
|
||||||
r.log.Info("backup written", "path", path, "bytes", size,
|
log.Info("backup written", "path", path, "bytes", size,
|
||||||
"took", time.Since(started).Round(time.Millisecond).String())
|
"took", time.Since(started).Round(time.Millisecond).String())
|
||||||
|
|
||||||
return r.rotateBackups()
|
return rotateBackups(cfg, log)
|
||||||
}
|
}
|
||||||
|
|
||||||
// rotateBackups keeps the most recent fourteen and deletes the rest.
|
// rotateBackups keeps the most recent fourteen and deletes the rest.
|
||||||
@@ -199,8 +219,8 @@ func (r *Runner) nightlyBackup(ctx context.Context) error {
|
|||||||
// Counted by file, not by age: a container that was off for a month would
|
// Counted by file, not by age: a container that was off for a month would
|
||||||
// otherwise come back, find every backup older than fourteen days, and delete all
|
// otherwise come back, find every backup older than fourteen days, and delete all
|
||||||
// of them — leaving none at exactly the moment they were most likely to be needed.
|
// of them — leaving none at exactly the moment they were most likely to be needed.
|
||||||
func (r *Runner) rotateBackups() error {
|
func rotateBackups(cfg *config.Config, log *slog.Logger) error {
|
||||||
entries, err := os.ReadDir(r.cfg.BackupsDir())
|
entries, err := os.ReadDir(cfg.BackupsDir())
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
@@ -215,12 +235,12 @@ func (r *Runner) rotateBackups() error {
|
|||||||
sort.Sort(sort.Reverse(sort.StringSlice(backups)))
|
sort.Sort(sort.Reverse(sort.StringSlice(backups)))
|
||||||
|
|
||||||
for _, name := range backups[min(len(backups), backupKeepDays):] {
|
for _, name := range backups[min(len(backups), backupKeepDays):] {
|
||||||
path := filepath.Join(r.cfg.BackupsDir(), name)
|
path := filepath.Join(cfg.BackupsDir(), name)
|
||||||
if err := os.Remove(path); err != nil {
|
if err := os.Remove(path); err != nil {
|
||||||
r.log.Warn("remove old backup", "err", err, "path", path)
|
log.Warn("remove old backup", "err", err, "path", path)
|
||||||
continue
|
continue
|
||||||
}
|
}
|
||||||
r.log.Info("old backup removed", "path", path)
|
log.Info("old backup removed", "path", path)
|
||||||
}
|
}
|
||||||
return nil
|
return nil
|
||||||
}
|
}
|
||||||
@@ -265,6 +285,20 @@ func (r *Runner) emptyTrash(ctx context.Context) error {
|
|||||||
return nil
|
return nil
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// purgeErrors keeps the diagnostic bounded. Thirty days is long enough to answer
|
||||||
|
// "what happened last week" and short enough that a fault loop cannot fill the
|
||||||
|
// volume the tasks live on.
|
||||||
|
func (r *Runner) purgeErrors(ctx context.Context) error {
|
||||||
|
n, err := r.db.PurgeOldErrors(ctx, 30*24*time.Hour)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
if n > 0 {
|
||||||
|
r.log.Debug("old error rows removed", "count", n)
|
||||||
|
}
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
func (r *Runner) purgeSessions(ctx context.Context) error {
|
func (r *Runner) purgeSessions(ctx context.Context) error {
|
||||||
n, err := r.db.PurgeExpiredSessions(ctx)
|
n, err := r.db.PurgeExpiredSessions(ctx)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -276,27 +310,12 @@ func (r *Runner) purgeSessions(ctx context.Context) error {
|
|||||||
return nil
|
return nil
|
||||||
}
|
}
|
||||||
|
|
||||||
// RunBackupNow is what the "back up now" button calls, and what the tests use.
|
// RunBackupNow is the Runner's way in, for the tests that already hold one.
|
||||||
|
//
|
||||||
|
// It was a second copy of Backup — written when the button that would call it did
|
||||||
|
// not exist yet — and the two had already drifted: this one never created the
|
||||||
|
// backups directory, and logged nothing. One implementation, so a fix to the
|
||||||
|
// nightly path is a fix to the button as well.
|
||||||
func (r *Runner) RunBackupNow(ctx context.Context) error {
|
func (r *Runner) RunBackupNow(ctx context.Context) error {
|
||||||
started := time.Now()
|
return Backup(ctx, r.cfg, r.db, r.log)
|
||||||
name := backupPrefix + started.UTC().Format("2006-01-02T150405Z") + ".db"
|
|
||||||
path := filepath.Join(r.cfg.BackupsDir(), name)
|
|
||||||
|
|
||||||
runID, err := r.db.StartBackupRun(ctx, started)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if err := r.db.Snapshot(ctx, path); err != nil {
|
|
||||||
os.Remove(path)
|
|
||||||
_ = r.db.FinishBackupRun(ctx, runID, "", 0, err)
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
var size int64
|
|
||||||
if info, err := os.Stat(path); err == nil {
|
|
||||||
size = info.Size()
|
|
||||||
}
|
|
||||||
if err := r.db.FinishBackupRun(ctx, runID, path, size, nil); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
return r.rotateBackups()
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -154,7 +154,7 @@ func TestBackupsRotateByCountNotAge(t *testing.T) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
if err := runner.rotateBackups(); err != nil {
|
if err := rotateBackups(cfg, runner.log); err != nil {
|
||||||
t.Fatalf("rotate: %v", err)
|
t.Fatalf("rotate: %v", err)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -34,6 +34,7 @@ const (
|
|||||||
KindTime Kind = "time"
|
KindTime Kind = "time"
|
||||||
KindPriority Kind = "priority"
|
KindPriority Kind = "priority"
|
||||||
KindProject Kind = "project"
|
KindProject Kind = "project"
|
||||||
|
KindSection Kind = "section"
|
||||||
KindLabel Kind = "label"
|
KindLabel Kind = "label"
|
||||||
KindRepeat Kind = "repeat"
|
KindRepeat Kind = "repeat"
|
||||||
)
|
)
|
||||||
@@ -52,7 +53,11 @@ type Result struct {
|
|||||||
Content string `json:"content"`
|
Content string `json:"content"`
|
||||||
// Project is the name written after '#', not an id: the caller resolves it
|
// Project is the name written after '#', not an id: the caller resolves it
|
||||||
// against the user's projects and decides what to do when it matches nothing.
|
// against the user's projects and decides what to do when it matches nothing.
|
||||||
Project string `json:"project,omitempty"`
|
Project string `json:"project,omitempty"`
|
||||||
|
// Section is the name written after '/', resolved by the caller against the
|
||||||
|
// sections of whichever project the task lands in. A section belongs to one
|
||||||
|
// project, so it cannot be looked up until the project is known.
|
||||||
|
Section string `json:"section,omitempty"`
|
||||||
Labels []string `json:"labels,omitempty"`
|
Labels []string `json:"labels,omitempty"`
|
||||||
// Priority is 1 (highest) to 4. 4 is both the default and "none stated".
|
// Priority is 1 (highest) to 4. 4 is both the default and "none stated".
|
||||||
Priority int `json:"priority"`
|
Priority int `json:"priority"`
|
||||||
@@ -81,6 +86,7 @@ func Parse(input string, now time.Time, locale string) Result {
|
|||||||
// Sigils first. '#' and '@' are unambiguous, and consuming them stops a project
|
// Sigils first. '#' and '@' are unambiguous, and consuming them stops a project
|
||||||
// called "Fredag" from later being read as a weekday.
|
// called "Fredag" from later being read as a weekday.
|
||||||
res.Project, spans = extractProject(input, spans)
|
res.Project, spans = extractProject(input, spans)
|
||||||
|
res.Section, spans = extractSection(input, spans)
|
||||||
res.Labels, spans = extractLabels(input, spans)
|
res.Labels, spans = extractLabels(input, spans)
|
||||||
res.Priority, spans = extractPriority(input, spans)
|
res.Priority, spans = extractPriority(input, spans)
|
||||||
|
|
||||||
@@ -144,6 +150,16 @@ func Parse(input string, now time.Time, locale string) Result {
|
|||||||
var (
|
var (
|
||||||
reProject = regexp.MustCompile(`(?:^|\s)#(?:"([^"]+)"|([\p{L}\p{N}_/-]+))`)
|
reProject = regexp.MustCompile(`(?:^|\s)#(?:"([^"]+)"|([\p{L}\p{N}_/-]+))`)
|
||||||
reLabel = regexp.MustCompile(`(?:^|\s)@(?:"([^"]+)"|([\p{L}\p{N}_/-]+))`)
|
reLabel = regexp.MustCompile(`(?:^|\s)@(?:"([^"]+)"|([\p{L}\p{N}_/-]+))`)
|
||||||
|
// A section, written '/Produktion' or '/"Kunder og ordrer"'.
|
||||||
|
//
|
||||||
|
// The name may itself contain a slash — "Kunder/Ordrer" is a real section
|
||||||
|
// name — so the bare form is greedy and swallows the lot.
|
||||||
|
//
|
||||||
|
// The leading `(?:^|\s)` is what keeps this out of ordinary text. A slash
|
||||||
|
// inside a word never matches, so "km/t" and "3/4" are safe, and the name has
|
||||||
|
// to start immediately after the slash, so "20 kr / stk" is safe too. Those
|
||||||
|
// three are the shapes a slash actually takes in a Danish task line.
|
||||||
|
reSection = regexp.MustCompile(`(?:^|\s)/(?:"([^"]+)"|([\p{L}\p{N}_/-]+))`)
|
||||||
)
|
)
|
||||||
|
|
||||||
func extractProject(input string, spans []Span) (string, []Span) {
|
func extractProject(input string, spans []Span) (string, []Span) {
|
||||||
@@ -160,6 +176,20 @@ func extractProject(input string, spans []Span) (string, []Span) {
|
|||||||
return name, spans
|
return name, spans
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Last one wins, as with the project: retyping is a correction, not two sections.
|
||||||
|
func extractSection(input string, spans []Span) (string, []Span) {
|
||||||
|
all := reSection.FindAllStringSubmatchIndex(input, -1)
|
||||||
|
if len(all) == 0 {
|
||||||
|
return "", spans
|
||||||
|
}
|
||||||
|
var name string
|
||||||
|
for _, m := range all {
|
||||||
|
name = submatch(input, m)
|
||||||
|
spans = append(spans, sigilSpan(input, m, KindSection))
|
||||||
|
}
|
||||||
|
return name, spans
|
||||||
|
}
|
||||||
|
|
||||||
func extractLabels(input string, spans []Span) ([]string, []Span) {
|
func extractLabels(input string, spans []Span) ([]string, []Span) {
|
||||||
var labels []string
|
var labels []string
|
||||||
seen := map[string]bool{}
|
seen := map[string]bool{}
|
||||||
|
|||||||
@@ -560,3 +560,46 @@ func TestRecurrenceIsHighlighted(t *testing.T) {
|
|||||||
t.Error("no span of kind repeat")
|
t.Error("no span of kind repeat")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// A section, and the three shapes a slash takes in ordinary text.
|
||||||
|
//
|
||||||
|
// The sigil is the one that needed thinking about: '#' and '@' never occur in a
|
||||||
|
// Danish task line by accident, and '/' occurs constantly. What keeps it apart is
|
||||||
|
// that the slash must follow whitespace and the name must follow the slash with
|
||||||
|
// nothing in between — which "km/t", "3/4" and "20 kr / stk" all fail.
|
||||||
|
func TestASectionIsWrittenWithASlash(t *testing.T) {
|
||||||
|
for _, c := range []struct {
|
||||||
|
in string
|
||||||
|
section string
|
||||||
|
content string
|
||||||
|
}{
|
||||||
|
{"ring til Karpenhøj /Produktion", "Produktion", "ring til Karpenhøj"},
|
||||||
|
{"/Produktion ring til Karpenhøj", "Produktion", "ring til Karpenhøj"},
|
||||||
|
// A real section name with a slash in it. The bare form is greedy, so the
|
||||||
|
// whole thing comes across rather than stopping at the second slash.
|
||||||
|
{"nye poser /Kunder/Ordrer", "Kunder/Ordrer", "nye poser"},
|
||||||
|
{`nye poser /"Kunder og ordrer"`, "Kunder og ordrer", "nye poser"},
|
||||||
|
// Retyping is a correction, not two sections.
|
||||||
|
{"nye poser /Drift /Produktion", "Produktion", "nye poser"},
|
||||||
|
// And alongside everything else.
|
||||||
|
{"betal moms i morgen kl 10 p1 #Firma /Bogholderi", "Bogholderi", "betal moms"},
|
||||||
|
|
||||||
|
// The ways a slash shows up when nobody meant a section. None of them may
|
||||||
|
// produce one: the slash has to follow whitespace, and the name has to
|
||||||
|
// follow the slash with nothing between.
|
||||||
|
{"kør 80 km/t forbi", "", "kør 80 km/t forbi"},
|
||||||
|
{"20 kr / stk hos grossisten", "", "20 kr / stk hos grossisten"},
|
||||||
|
// "3/4" is a section to nobody and a date to a Dane — the 3rd of April —
|
||||||
|
// and the date parser is right to claim it. What matters here is only that
|
||||||
|
// it did not become a section.
|
||||||
|
{"læs 3/4 af rapporten", "", "læs af rapporten"},
|
||||||
|
} {
|
||||||
|
got := Parse(c.in, ref(t), "da")
|
||||||
|
if got.Section != c.section {
|
||||||
|
t.Errorf("Parse(%q).Section = %q, want %q", c.in, got.Section, c.section)
|
||||||
|
}
|
||||||
|
if got.Content != c.content {
|
||||||
|
t.Errorf("Parse(%q).Content = %q, want %q", c.in, got.Content, c.content)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
@@ -5,13 +5,19 @@ import (
|
|||||||
"database/sql"
|
"database/sql"
|
||||||
"encoding/json"
|
"encoding/json"
|
||||||
"errors"
|
"errors"
|
||||||
|
"strings"
|
||||||
"time"
|
"time"
|
||||||
)
|
)
|
||||||
|
|
||||||
type Activity struct {
|
type Activity struct {
|
||||||
ID string
|
ID string
|
||||||
ProjectID string
|
ProjectID string
|
||||||
TaskID string
|
// ProjectName is filled by the instance-wide log, where a row without it says
|
||||||
|
// nothing: "renamed a section" needs to say which project's section.
|
||||||
|
ProjectName string
|
||||||
|
TaskID string
|
||||||
|
// UserID and UserName are empty when the account has been deleted. The record
|
||||||
|
// of what was done outlives whoever did it — see migration 0009.
|
||||||
UserID string
|
UserID string
|
||||||
UserName string
|
UserName string
|
||||||
Event string
|
Event string
|
||||||
@@ -19,6 +25,23 @@ type Activity struct {
|
|||||||
CreatedAt time.Time
|
CreatedAt time.Time
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// AuditFilter narrows the instance-wide log. Zero values mean "do not filter".
|
||||||
|
type AuditFilter struct {
|
||||||
|
UserID string
|
||||||
|
ProjectID string
|
||||||
|
// Event matches exactly, e.g. "task.completed". The interface offers the set
|
||||||
|
// that actually occurs rather than a text field, so there is no prefix or
|
||||||
|
// wildcard to support here.
|
||||||
|
Event string
|
||||||
|
// Before pages backwards. Keyed on (created_at, id) rather than on created_at
|
||||||
|
// alone: the log is written in whole seconds, so a busy moment puts several
|
||||||
|
// rows on the same timestamp and a cursor that only knew the time would either
|
||||||
|
// skip them or repeat them.
|
||||||
|
BeforeAt int64
|
||||||
|
BeforeID string
|
||||||
|
Limit int
|
||||||
|
}
|
||||||
|
|
||||||
// RecordActivity appends to a project's history.
|
// RecordActivity appends to a project's history.
|
||||||
//
|
//
|
||||||
// Every mutation writes one, which is what makes the activity log complete rather
|
// Every mutation writes one, which is what makes the activity log complete rather
|
||||||
@@ -35,7 +58,7 @@ func (db *DB) RecordActivity(ctx context.Context, projectID, taskID, userID, eve
|
|||||||
_, err := db.ExecContext(ctx,
|
_, err := db.ExecContext(ctx,
|
||||||
`INSERT INTO activity (id, project_id, task_id, user_id, event, payload_json, created_at)
|
`INSERT INTO activity (id, project_id, task_id, user_id, event, payload_json, created_at)
|
||||||
VALUES (?, ?, ?, ?, ?, ?, ?)`,
|
VALUES (?, ?, ?, ?, ?, ?, ?)`,
|
||||||
NewID(), projectID, nullString(taskID), userID, event, encoded, time.Now().Unix())
|
NewID(), projectID, nullString(taskID), nullString(userID), event, encoded, time.Now().Unix())
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -43,9 +66,12 @@ func (db *DB) ListActivity(ctx context.Context, projectID string, limit int) ([]
|
|||||||
if limit <= 0 || limit > 200 {
|
if limit <= 0 || limit > 200 {
|
||||||
limit = 50
|
limit = 50
|
||||||
}
|
}
|
||||||
|
// LEFT JOIN, not JOIN: a row whose author has been deleted still happened, and
|
||||||
|
// an inner join would drop it from the history silently.
|
||||||
rows, err := db.QueryContext(ctx, `
|
rows, err := db.QueryContext(ctx, `
|
||||||
SELECT a.id, a.project_id, a.task_id, a.user_id, u.name, a.event, a.payload_json, a.created_at
|
SELECT a.id, a.project_id, a.task_id, COALESCE(a.user_id, ''), COALESCE(u.name, ''),
|
||||||
FROM activity a JOIN users u ON u.id = a.user_id
|
a.event, a.payload_json, a.created_at
|
||||||
|
FROM activity a LEFT JOIN users u ON u.id = a.user_id
|
||||||
WHERE a.project_id = ?
|
WHERE a.project_id = ?
|
||||||
ORDER BY a.created_at DESC, a.id DESC
|
ORDER BY a.created_at DESC, a.id DESC
|
||||||
LIMIT ?`, projectID, limit)
|
LIMIT ?`, projectID, limit)
|
||||||
@@ -72,6 +98,117 @@ func (db *DB) ListActivity(ctx context.Context, projectID string, limit int) ([]
|
|||||||
return out, rows.Err()
|
return out, rows.Err()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// ListAuditLog is the same history read across the whole instance rather than one
|
||||||
|
// project at a time.
|
||||||
|
//
|
||||||
|
// The per-project log answers "what happened here", which is a question a project's
|
||||||
|
// members ask about their own work. This one answers "what has happened on this
|
||||||
|
// server", which only an administrator asks and which nothing in the API could
|
||||||
|
// answer before: ListActivity takes one project id, and an administrator is not
|
||||||
|
// necessarily a member of the project they need to look into.
|
||||||
|
//
|
||||||
|
// Reading is a keyset walk rather than an OFFSET. The log is append-heavy and read
|
||||||
|
// rarely, so a page fetched a minute after the one before it would otherwise be
|
||||||
|
// shifted by everything written in between — showing a row twice and skipping the
|
||||||
|
// one behind it, which is precisely the failure an audit log must not have.
|
||||||
|
func (db *DB) ListAuditLog(ctx context.Context, f AuditFilter) ([]Activity, error) {
|
||||||
|
limit := f.Limit
|
||||||
|
if limit <= 0 || limit > 500 {
|
||||||
|
limit = 100
|
||||||
|
}
|
||||||
|
|
||||||
|
where := []string{}
|
||||||
|
args := []any{}
|
||||||
|
if f.UserID != "" {
|
||||||
|
where = append(where, "a.user_id = ?")
|
||||||
|
args = append(args, f.UserID)
|
||||||
|
}
|
||||||
|
if f.ProjectID != "" {
|
||||||
|
where = append(where, "a.project_id = ?")
|
||||||
|
args = append(args, f.ProjectID)
|
||||||
|
}
|
||||||
|
if f.Event != "" {
|
||||||
|
where = append(where, "a.event = ?")
|
||||||
|
args = append(args, f.Event)
|
||||||
|
}
|
||||||
|
if f.BeforeAt > 0 {
|
||||||
|
// A row value, so the tie-break on id is part of the comparison rather
|
||||||
|
// than a second clause that would have to repeat the timestamp.
|
||||||
|
where = append(where, "(a.created_at, a.id) < (?, ?)")
|
||||||
|
args = append(args, f.BeforeAt, f.BeforeID)
|
||||||
|
}
|
||||||
|
clause := ""
|
||||||
|
if len(where) > 0 {
|
||||||
|
clause = "WHERE " + strings.Join(where, " AND ")
|
||||||
|
}
|
||||||
|
args = append(args, limit)
|
||||||
|
|
||||||
|
rows, err := db.QueryContext(ctx, `
|
||||||
|
SELECT a.id, a.project_id, p.name, a.task_id,
|
||||||
|
COALESCE(a.user_id, ''), COALESCE(u.name, ''),
|
||||||
|
a.event, a.payload_json, a.created_at
|
||||||
|
FROM activity a
|
||||||
|
JOIN projects p ON p.id = a.project_id
|
||||||
|
LEFT JOIN users u ON u.id = a.user_id
|
||||||
|
`+clause+`
|
||||||
|
ORDER BY a.created_at DESC, a.id DESC
|
||||||
|
LIMIT ?`, args...)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
defer rows.Close()
|
||||||
|
|
||||||
|
out := []Activity{}
|
||||||
|
for rows.Next() {
|
||||||
|
var a Activity
|
||||||
|
var taskID sql.NullString
|
||||||
|
var payload string
|
||||||
|
var created int64
|
||||||
|
if err := rows.Scan(&a.ID, &a.ProjectID, &a.ProjectName, &taskID, &a.UserID,
|
||||||
|
&a.UserName, &a.Event, &payload, &created); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
a.TaskID = taskID.String
|
||||||
|
a.CreatedAt = time.Unix(created, 0).UTC()
|
||||||
|
_ = json.Unmarshal([]byte(payload), &a.Payload)
|
||||||
|
out = append(out, a)
|
||||||
|
}
|
||||||
|
return out, rows.Err()
|
||||||
|
}
|
||||||
|
|
||||||
|
// AuditEvents is the set of event names the log actually contains, most frequent
|
||||||
|
// first, with how many of each.
|
||||||
|
//
|
||||||
|
// The filter offers these rather than a text field. Event names are an internal
|
||||||
|
// vocabulary — "member.role_changed", not a sentence anybody would guess — so a
|
||||||
|
// field to type them into is a field that returns nothing until you have read the
|
||||||
|
// source. The counts are worth having on their own: they are the shape of what the
|
||||||
|
// instance does.
|
||||||
|
func (db *DB) AuditEvents(ctx context.Context) ([]EventCount, error) {
|
||||||
|
rows, err := db.QueryContext(ctx, `
|
||||||
|
SELECT event, count(*) FROM activity
|
||||||
|
GROUP BY event ORDER BY count(*) DESC, event`)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
defer rows.Close()
|
||||||
|
|
||||||
|
out := []EventCount{}
|
||||||
|
for rows.Next() {
|
||||||
|
var e EventCount
|
||||||
|
if err := rows.Scan(&e.Event, &e.Count); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
out = append(out, e)
|
||||||
|
}
|
||||||
|
return out, rows.Err()
|
||||||
|
}
|
||||||
|
|
||||||
|
type EventCount struct {
|
||||||
|
Event string
|
||||||
|
Count int
|
||||||
|
}
|
||||||
|
|
||||||
// PurgeActivity drops history older than the retention window. An activity log that
|
// PurgeActivity drops history older than the retention window. An activity log that
|
||||||
// grows without limit turns a 10 MB database into a 2 GB one over a couple of years
|
// grows without limit turns a 10 MB database into a 2 GB one over a couple of years
|
||||||
// of ordinary use, on hardware that is somebody's spare machine.
|
// of ordinary use, on hardware that is somebody's spare machine.
|
||||||
|
|||||||
@@ -0,0 +1,39 @@
|
|||||||
|
package store
|
||||||
|
|
||||||
|
// The colours a project, group, label or filter may be marked with.
|
||||||
|
//
|
||||||
|
// Names rather than hex values, and the reason is what happens later: a hex in
|
||||||
|
// ten thousand rows is a decision nobody can revisit, while a name is resolved by
|
||||||
|
// the interface at the moment it paints and can be retuned for a new theme, a new
|
||||||
|
// palette, or a display nobody has yet. It is also the difference between a
|
||||||
|
// database that stores a fact and one that stores a rendering.
|
||||||
|
//
|
||||||
|
// The list is closed. An unknown name would be stored happily and then paint as
|
||||||
|
// the default, which looks like a colour that did not save — so it is refused at
|
||||||
|
// the edge instead. web/src/lib/colors.js carries the same ids for the picker, and
|
||||||
|
// a test reads that file to check the two have not drifted.
|
||||||
|
var Colors = []string{
|
||||||
|
"graphite",
|
||||||
|
"tomato",
|
||||||
|
"amber",
|
||||||
|
"lime",
|
||||||
|
"green",
|
||||||
|
"teal",
|
||||||
|
"blue",
|
||||||
|
"indigo",
|
||||||
|
"violet",
|
||||||
|
"magenta",
|
||||||
|
}
|
||||||
|
|
||||||
|
// DefaultColor is what an unmarked thing is, and what the schema defaults to.
|
||||||
|
const DefaultColor = "graphite"
|
||||||
|
|
||||||
|
// ValidColor reports whether a name is one this app can paint.
|
||||||
|
func ValidColor(name string) bool {
|
||||||
|
for _, c := range Colors {
|
||||||
|
if c == name {
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}
|
||||||
@@ -0,0 +1,93 @@
|
|||||||
|
package store
|
||||||
|
|
||||||
|
import (
|
||||||
|
"os"
|
||||||
|
"path/filepath"
|
||||||
|
"strings"
|
||||||
|
"testing"
|
||||||
|
)
|
||||||
|
|
||||||
|
// The palette is written down three times: here, in web/src/lib/colors.js for the
|
||||||
|
// picker, and in web/src/app.css as the tokens that actually paint. Three copies
|
||||||
|
// is two chances to drift, and the failure is quiet — a colour the server accepts
|
||||||
|
// and the interface cannot draw renders as the default, which looks like a colour
|
||||||
|
// that did not save.
|
||||||
|
//
|
||||||
|
// So this reads the other two. A small scanner rather than a parser, the same
|
||||||
|
// approach openapi_test.go takes to the spec: it needs the ids out of a list this
|
||||||
|
// repository also owns, and that is worth more than a dependency in a project
|
||||||
|
// whose whole shape is "one static binary".
|
||||||
|
func TestThePaletteIsTheSameInGoAndInTheFrontend(t *testing.T) {
|
||||||
|
js := readFrontendColors(t, filepath.Join("..", "..", "web", "src", "lib", "colors.js"))
|
||||||
|
css := readColorTokens(t, filepath.Join("..", "..", "web", "src", "app.css"))
|
||||||
|
|
||||||
|
for _, name := range Colors {
|
||||||
|
if !js[name] {
|
||||||
|
t.Errorf("%q is accepted by the server and missing from colors.js — the picker cannot offer it", name)
|
||||||
|
}
|
||||||
|
if !css[name] {
|
||||||
|
t.Errorf("--color-%s is missing from app.css — the server accepts a colour nothing can paint", name)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for name := range js {
|
||||||
|
if !ValidColor(name) {
|
||||||
|
t.Errorf("colors.js offers %q, which the server refuses — picking it would fail to save", name)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// readFrontendColors pulls the ids out of the COLORS array: lines shaped
|
||||||
|
// `{ id: 'tomato', name: 'Tomat' },`.
|
||||||
|
func readFrontendColors(t *testing.T, path string) map[string]bool {
|
||||||
|
t.Helper()
|
||||||
|
body, err := os.ReadFile(path)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("read colors.js: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
found := map[string]bool{}
|
||||||
|
for _, line := range strings.Split(string(body), "\n") {
|
||||||
|
id, ok := between(line, "{ id: '", "'")
|
||||||
|
if ok {
|
||||||
|
found[id] = true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if len(found) == 0 {
|
||||||
|
t.Fatal("no colours were read out of colors.js — the scanner and the file disagree")
|
||||||
|
}
|
||||||
|
return found
|
||||||
|
}
|
||||||
|
|
||||||
|
// readColorTokens pulls the names out of `--color-tomato: #d9614f;`.
|
||||||
|
func readColorTokens(t *testing.T, path string) map[string]bool {
|
||||||
|
t.Helper()
|
||||||
|
body, err := os.ReadFile(path)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("read app.css: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
found := map[string]bool{}
|
||||||
|
for _, line := range strings.Split(string(body), "\n") {
|
||||||
|
name, ok := between(line, "--color-", ":")
|
||||||
|
if ok {
|
||||||
|
found[name] = true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if len(found) == 0 {
|
||||||
|
t.Fatal("no --color- tokens were read out of app.css")
|
||||||
|
}
|
||||||
|
return found
|
||||||
|
}
|
||||||
|
|
||||||
|
func between(line, open, close string) (string, bool) {
|
||||||
|
start := strings.Index(line, open)
|
||||||
|
if start < 0 {
|
||||||
|
return "", false
|
||||||
|
}
|
||||||
|
rest := line[start+len(open):]
|
||||||
|
end := strings.Index(rest, close)
|
||||||
|
if end <= 0 {
|
||||||
|
return "", false
|
||||||
|
}
|
||||||
|
return rest[:end], true
|
||||||
|
}
|
||||||
@@ -21,9 +21,12 @@ type Comment struct {
|
|||||||
}
|
}
|
||||||
|
|
||||||
type Attachment struct {
|
type Attachment struct {
|
||||||
ID string
|
ID string
|
||||||
TaskID string
|
TaskID string
|
||||||
CommentID string
|
CommentID string
|
||||||
|
// GroupID hangs the file on a project group rather than on any one task in
|
||||||
|
// it: the contract that governs all of "Arbejde", not a step in it.
|
||||||
|
GroupID string
|
||||||
Filename string
|
Filename string
|
||||||
MimeType string
|
MimeType string
|
||||||
Size int64
|
Size int64
|
||||||
@@ -154,17 +157,17 @@ func (db *DB) CreateAttachment(ctx context.Context, a *Attachment) error {
|
|||||||
a.CreatedAt = time.Now().UTC()
|
a.CreatedAt = time.Now().UTC()
|
||||||
|
|
||||||
_, err := db.ExecContext(ctx,
|
_, err := db.ExecContext(ctx,
|
||||||
`INSERT INTO attachments (id, task_id, comment_id, filename, mime_type, size,
|
`INSERT INTO attachments (id, task_id, comment_id, group_id, filename, mime_type,
|
||||||
path, uploaded_by, created_at)
|
size, path, uploaded_by, created_at)
|
||||||
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
|
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
|
||||||
a.ID, nullString(a.TaskID), nullString(a.CommentID), a.Filename,
|
a.ID, nullString(a.TaskID), nullString(a.CommentID), nullString(a.GroupID),
|
||||||
a.MimeType, a.Size, a.Path, a.UploadedBy, a.CreatedAt.Unix())
|
a.Filename, a.MimeType, a.Size, a.Path, a.UploadedBy, a.CreatedAt.Unix())
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
|
|
||||||
func (db *DB) ListTaskAttachments(ctx context.Context, taskID string) ([]Attachment, error) {
|
func (db *DB) ListTaskAttachments(ctx context.Context, taskID string) ([]Attachment, error) {
|
||||||
rows, err := db.QueryContext(ctx,
|
rows, err := db.QueryContext(ctx,
|
||||||
`SELECT id, task_id, comment_id, filename, mime_type, size, path, uploaded_by, created_at
|
`SELECT id, task_id, comment_id, group_id, filename, mime_type, size, path, uploaded_by, created_at
|
||||||
FROM attachments WHERE task_id = ? ORDER BY created_at`, taskID)
|
FROM attachments WHERE task_id = ? ORDER BY created_at`, taskID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return nil, err
|
return nil, err
|
||||||
@@ -173,13 +176,26 @@ func (db *DB) ListTaskAttachments(ctx context.Context, taskID string) ([]Attachm
|
|||||||
return scanAttachments(rows)
|
return scanAttachments(rows)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// ListGroupAttachments is the documents that belong to a whole group rather than
|
||||||
|
// to anything inside it.
|
||||||
|
func (db *DB) ListGroupAttachments(ctx context.Context, groupID string) ([]Attachment, error) {
|
||||||
|
rows, err := db.QueryContext(ctx,
|
||||||
|
`SELECT id, task_id, comment_id, group_id, filename, mime_type, size, path, uploaded_by, created_at
|
||||||
|
FROM attachments WHERE group_id = ? ORDER BY created_at`, groupID)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
defer rows.Close()
|
||||||
|
return scanAttachments(rows)
|
||||||
|
}
|
||||||
|
|
||||||
func (db *DB) attachmentsByComment(ctx context.Context, commentIDs []string) (map[string][]Attachment, error) {
|
func (db *DB) attachmentsByComment(ctx context.Context, commentIDs []string) (map[string][]Attachment, error) {
|
||||||
args := make([]any, len(commentIDs))
|
args := make([]any, len(commentIDs))
|
||||||
for i, id := range commentIDs {
|
for i, id := range commentIDs {
|
||||||
args[i] = id
|
args[i] = id
|
||||||
}
|
}
|
||||||
rows, err := db.QueryContext(ctx,
|
rows, err := db.QueryContext(ctx,
|
||||||
`SELECT id, task_id, comment_id, filename, mime_type, size, path, uploaded_by, created_at
|
`SELECT id, task_id, comment_id, group_id, filename, mime_type, size, path, uploaded_by, created_at
|
||||||
FROM attachments WHERE comment_id IN (`+placeholders(len(commentIDs))+`)
|
FROM attachments WHERE comment_id IN (`+placeholders(len(commentIDs))+`)
|
||||||
ORDER BY created_at`, args...)
|
ORDER BY created_at`, args...)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -202,14 +218,15 @@ func scanAttachments(rows *sql.Rows) ([]Attachment, error) {
|
|||||||
out := []Attachment{}
|
out := []Attachment{}
|
||||||
for rows.Next() {
|
for rows.Next() {
|
||||||
var a Attachment
|
var a Attachment
|
||||||
var taskID, commentID sql.NullString
|
var taskID, commentID, groupID sql.NullString
|
||||||
var created int64
|
var created int64
|
||||||
if err := rows.Scan(&a.ID, &taskID, &commentID, &a.Filename, &a.MimeType,
|
if err := rows.Scan(&a.ID, &taskID, &commentID, &groupID, &a.Filename, &a.MimeType,
|
||||||
&a.Size, &a.Path, &a.UploadedBy, &created); err != nil {
|
&a.Size, &a.Path, &a.UploadedBy, &created); err != nil {
|
||||||
return nil, err
|
return nil, err
|
||||||
}
|
}
|
||||||
a.TaskID = taskID.String
|
a.TaskID = taskID.String
|
||||||
a.CommentID = commentID.String
|
a.CommentID = commentID.String
|
||||||
|
a.GroupID = groupID.String
|
||||||
a.CreatedAt = time.Unix(created, 0).UTC()
|
a.CreatedAt = time.Unix(created, 0).UTC()
|
||||||
out = append(out, a)
|
out = append(out, a)
|
||||||
}
|
}
|
||||||
@@ -218,7 +235,7 @@ func scanAttachments(rows *sql.Rows) ([]Attachment, error) {
|
|||||||
|
|
||||||
func (db *DB) GetAttachment(ctx context.Context, attachmentID string) (*Attachment, error) {
|
func (db *DB) GetAttachment(ctx context.Context, attachmentID string) (*Attachment, error) {
|
||||||
rows, err := db.QueryContext(ctx,
|
rows, err := db.QueryContext(ctx,
|
||||||
`SELECT id, task_id, comment_id, filename, mime_type, size, path, uploaded_by, created_at
|
`SELECT id, task_id, comment_id, group_id, filename, mime_type, size, path, uploaded_by, created_at
|
||||||
FROM attachments WHERE id = ?`, attachmentID)
|
FROM attachments WHERE id = ?`, attachmentID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return nil, err
|
return nil, err
|
||||||
|
|||||||
@@ -0,0 +1,77 @@
|
|||||||
|
package store
|
||||||
|
|
||||||
|
import (
|
||||||
|
"context"
|
||||||
|
"time"
|
||||||
|
)
|
||||||
|
|
||||||
|
// A ServerError is one 500 the API answered, kept so it can be read after the
|
||||||
|
// container that produced it has gone.
|
||||||
|
type ServerError struct {
|
||||||
|
ID string
|
||||||
|
At time.Time
|
||||||
|
Method string
|
||||||
|
Path string
|
||||||
|
Status int
|
||||||
|
What string
|
||||||
|
Message string
|
||||||
|
UserID string
|
||||||
|
UserName string
|
||||||
|
RequestID string
|
||||||
|
}
|
||||||
|
|
||||||
|
// RecordError stores one failure.
|
||||||
|
//
|
||||||
|
// Errors here are dropped rather than returned: this is called from the path that
|
||||||
|
// is already reporting a failure to somebody, and a diagnostic that can itself
|
||||||
|
// fail the request would turn one broken screen into two.
|
||||||
|
func (db *DB) RecordError(ctx context.Context, e ServerError) {
|
||||||
|
var user any
|
||||||
|
if e.UserID != "" {
|
||||||
|
user = e.UserID
|
||||||
|
}
|
||||||
|
_, _ = db.ExecContext(ctx,
|
||||||
|
`INSERT INTO error_log (id, at, method, path, status, what, message, user_id, request_id)
|
||||||
|
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
|
||||||
|
NewID(), time.Now().Unix(), e.Method, truncate(e.Path, 500), e.Status,
|
||||||
|
truncate(e.What, 200), truncate(e.Message, 2000), user, truncate(e.RequestID, 100))
|
||||||
|
}
|
||||||
|
|
||||||
|
// ListErrors returns the most recent failures, newest first.
|
||||||
|
func (db *DB) ListErrors(ctx context.Context, limit int) ([]ServerError, error) {
|
||||||
|
rows, err := db.QueryContext(ctx, `
|
||||||
|
SELECT e.id, e.at, e.method, e.path, e.status, e.what, e.message,
|
||||||
|
COALESCE(e.user_id, ''), COALESCE(u.name, ''), e.request_id
|
||||||
|
FROM error_log e
|
||||||
|
LEFT JOIN users u ON u.id = e.user_id
|
||||||
|
ORDER BY e.at DESC
|
||||||
|
LIMIT ?`, limit)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
defer rows.Close()
|
||||||
|
|
||||||
|
out := []ServerError{}
|
||||||
|
for rows.Next() {
|
||||||
|
var e ServerError
|
||||||
|
var at int64
|
||||||
|
if err := rows.Scan(&e.ID, &at, &e.Method, &e.Path, &e.Status, &e.What,
|
||||||
|
&e.Message, &e.UserID, &e.UserName, &e.RequestID); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
e.At = time.Unix(at, 0).UTC()
|
||||||
|
out = append(out, e)
|
||||||
|
}
|
||||||
|
return out, rows.Err()
|
||||||
|
}
|
||||||
|
|
||||||
|
// PurgeOldErrors is run by the nightly sweep. A diagnostic that grows without
|
||||||
|
// limit is a disk that fills for a reason nobody expected.
|
||||||
|
func (db *DB) PurgeOldErrors(ctx context.Context, keep time.Duration) (int64, error) {
|
||||||
|
res, err := db.ExecContext(ctx,
|
||||||
|
`DELETE FROM error_log WHERE at < ?`, time.Now().Add(-keep).Unix())
|
||||||
|
if err != nil {
|
||||||
|
return 0, err
|
||||||
|
}
|
||||||
|
return res.RowsAffected()
|
||||||
|
}
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
-- A colour on a sidebar group, so a group can be marked the way a project is.
|
||||||
|
--
|
||||||
|
-- Projects, labels and filters have carried a `color` since 0001; groups arrived
|
||||||
|
-- in 0005 without one because nothing rendered any of them yet. Now that the
|
||||||
|
-- sidebar paints them, a group without one would be the only thing in the list
|
||||||
|
-- that could not be told apart at a glance.
|
||||||
|
--
|
||||||
|
-- Same default and same spelling as the others: a colour name, not a hex. The
|
||||||
|
-- value has to survive a theme change and a redesign, and '#8a8f98' in ten
|
||||||
|
-- thousand rows is a decision nobody can revisit.
|
||||||
|
ALTER TABLE project_groups ADD COLUMN color TEXT NOT NULL DEFAULT 'graphite';
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
-- Server errors, kept where they can outlive the container that produced them.
|
||||||
|
--
|
||||||
|
-- verdande already logs the real cause of every 500 to stdout. On a Rune that is
|
||||||
|
-- the container's log, and every restart starts a new one — so the panel can
|
||||||
|
-- report "HTTP 5xx, twice, at 11:49" long after the line explaining it has gone.
|
||||||
|
-- An operator is then told that something broke and given no way to find out what.
|
||||||
|
--
|
||||||
|
-- Bounded by the sweeper rather than by size: this is a diagnostic, and one that
|
||||||
|
-- grows without limit is a disk that fills for a reason nobody expected.
|
||||||
|
CREATE TABLE error_log (
|
||||||
|
id TEXT PRIMARY KEY,
|
||||||
|
at INTEGER NOT NULL,
|
||||||
|
method TEXT NOT NULL,
|
||||||
|
path TEXT NOT NULL,
|
||||||
|
status INTEGER NOT NULL,
|
||||||
|
-- what: the operation the handler was attempting, in the words it uses in the
|
||||||
|
-- log — "list projects", "move task". The detail a stack trace would give and
|
||||||
|
-- a status code cannot.
|
||||||
|
what TEXT NOT NULL,
|
||||||
|
message TEXT NOT NULL,
|
||||||
|
-- Whose request it was, so a fault that only one account hits is visible as
|
||||||
|
-- one. NULL for anything that failed before authentication.
|
||||||
|
user_id TEXT REFERENCES users (id) ON DELETE SET NULL,
|
||||||
|
request_id TEXT NOT NULL DEFAULT ''
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE INDEX idx_error_log_at ON error_log (at DESC);
|
||||||
@@ -0,0 +1,101 @@
|
|||||||
|
-- `tasks.created_by` stops cascading.
|
||||||
|
--
|
||||||
|
-- It was ON DELETE CASCADE, which made deleting an account delete every task that
|
||||||
|
-- account ever wrote — including in projects somebody else owns. Retiring a
|
||||||
|
-- colleague therefore removed their contributions from shared work rather than
|
||||||
|
-- leaving it behind. It is the last remaining way to lose other people's work by
|
||||||
|
-- accident, and the administrator's page saying so in plain words is a warning, not
|
||||||
|
-- a fix.
|
||||||
|
--
|
||||||
|
-- SET NULL instead: the task stays and loses its author. `created_by` becomes
|
||||||
|
-- nullable to make that expressible, which is the same shape `assignee_id` and
|
||||||
|
-- `completed_by` already have for the same reason.
|
||||||
|
--
|
||||||
|
-- SQLite cannot alter a foreign key action, so the table is rebuilt. The FTS
|
||||||
|
-- triggers come along: they are dropped first so that DROP TABLE and ALTER TABLE
|
||||||
|
-- see a schema they can parse, and recreated below. `tasks_fts` is an
|
||||||
|
-- external-content table keyed on `tasks.rowid`, and a rebuilt table hands out new
|
||||||
|
-- rowids, so the index is rebuilt at the end rather than left pointing at rows that
|
||||||
|
-- have moved.
|
||||||
|
--
|
||||||
|
-- verdande:rebuild-tables
|
||||||
|
|
||||||
|
DROP TRIGGER tasks_fts_insert;
|
||||||
|
DROP TRIGGER tasks_fts_delete;
|
||||||
|
DROP TRIGGER tasks_fts_update;
|
||||||
|
|
||||||
|
CREATE TABLE tasks_rebuilt (
|
||||||
|
id TEXT PRIMARY KEY,
|
||||||
|
project_id TEXT NOT NULL REFERENCES projects (id) ON DELETE CASCADE,
|
||||||
|
section_id TEXT REFERENCES sections (id) ON DELETE SET NULL,
|
||||||
|
parent_id TEXT REFERENCES tasks (id) ON DELETE CASCADE,
|
||||||
|
content TEXT NOT NULL,
|
||||||
|
description TEXT NOT NULL DEFAULT '',
|
||||||
|
priority INTEGER NOT NULL DEFAULT 4,
|
||||||
|
due_date TEXT,
|
||||||
|
due_datetime INTEGER,
|
||||||
|
due_timezone TEXT,
|
||||||
|
duration_min INTEGER,
|
||||||
|
recurrence_rule TEXT,
|
||||||
|
assignee_id TEXT REFERENCES users (id) ON DELETE SET NULL,
|
||||||
|
-- Nullable, and SET NULL: an account can go without its work going with it.
|
||||||
|
created_by TEXT REFERENCES users (id) ON DELETE SET NULL,
|
||||||
|
completed_at INTEGER,
|
||||||
|
completed_by TEXT REFERENCES users (id) ON DELETE SET NULL,
|
||||||
|
sort_order REAL NOT NULL DEFAULT 0,
|
||||||
|
created_at INTEGER NOT NULL,
|
||||||
|
updated_at INTEGER NOT NULL,
|
||||||
|
deleted_at INTEGER,
|
||||||
|
fold TEXT GENERATED ALWAYS AS (
|
||||||
|
replace(replace(replace(replace(replace(replace(
|
||||||
|
content || ' ' || description,
|
||||||
|
'ø', 'o'), 'Ø', 'o'),
|
||||||
|
'æ', 'ae'), 'Æ', 'ae'),
|
||||||
|
'å', 'aa'), 'Å', 'aa')
|
||||||
|
) STORED,
|
||||||
|
CHECK (priority BETWEEN 1 AND 4)
|
||||||
|
);
|
||||||
|
|
||||||
|
INSERT INTO tasks_rebuilt
|
||||||
|
(id, project_id, section_id, parent_id, content, description, priority,
|
||||||
|
due_date, due_datetime, due_timezone, duration_min, recurrence_rule,
|
||||||
|
assignee_id, created_by, completed_at, completed_by, sort_order,
|
||||||
|
created_at, updated_at, deleted_at)
|
||||||
|
SELECT
|
||||||
|
id, project_id, section_id, parent_id, content, description, priority,
|
||||||
|
due_date, due_datetime, due_timezone, duration_min, recurrence_rule,
|
||||||
|
assignee_id, created_by, completed_at, completed_by, sort_order,
|
||||||
|
created_at, updated_at, deleted_at
|
||||||
|
FROM tasks;
|
||||||
|
|
||||||
|
DROP TABLE tasks;
|
||||||
|
|
||||||
|
ALTER TABLE tasks_rebuilt RENAME TO tasks;
|
||||||
|
|
||||||
|
CREATE INDEX idx_tasks_project ON tasks (project_id, sort_order)
|
||||||
|
WHERE deleted_at IS NULL AND completed_at IS NULL;
|
||||||
|
CREATE INDEX idx_tasks_due ON tasks (due_date)
|
||||||
|
WHERE deleted_at IS NULL AND completed_at IS NULL AND due_date IS NOT NULL;
|
||||||
|
CREATE INDEX idx_tasks_assignee ON tasks (assignee_id)
|
||||||
|
WHERE deleted_at IS NULL AND completed_at IS NULL AND assignee_id IS NOT NULL;
|
||||||
|
CREATE INDEX idx_tasks_parent ON tasks (parent_id) WHERE parent_id IS NOT NULL;
|
||||||
|
|
||||||
|
CREATE TRIGGER tasks_fts_insert AFTER INSERT ON tasks BEGIN
|
||||||
|
INSERT INTO tasks_fts (rowid, content, description, fold, id, project_id)
|
||||||
|
VALUES (new.rowid, new.content, new.description, new.fold, new.id, new.project_id);
|
||||||
|
END;
|
||||||
|
|
||||||
|
CREATE TRIGGER tasks_fts_delete AFTER DELETE ON tasks BEGIN
|
||||||
|
INSERT INTO tasks_fts (tasks_fts, rowid, content, description, fold, id, project_id)
|
||||||
|
VALUES ('delete', old.rowid, old.content, old.description, old.fold, old.id, old.project_id);
|
||||||
|
END;
|
||||||
|
|
||||||
|
CREATE TRIGGER tasks_fts_update AFTER UPDATE ON tasks BEGIN
|
||||||
|
INSERT INTO tasks_fts (tasks_fts, rowid, content, description, fold, id, project_id)
|
||||||
|
VALUES ('delete', old.rowid, old.content, old.description, old.fold, old.id, old.project_id);
|
||||||
|
INSERT INTO tasks_fts (rowid, content, description, fold, id, project_id)
|
||||||
|
VALUES (new.rowid, new.content, new.description, new.fold, new.id, new.project_id);
|
||||||
|
END;
|
||||||
|
|
||||||
|
-- The rowids the index was built against are gone with the old table.
|
||||||
|
INSERT INTO tasks_fts (tasks_fts) VALUES ('rebuild');
|
||||||
@@ -0,0 +1,54 @@
|
|||||||
|
-- `activity.user_id` stops cascading, and the log gets an index it can be read by.
|
||||||
|
--
|
||||||
|
-- Two changes with the same cause: there is now an instance-wide audit log, and
|
||||||
|
-- the table it reads was only ever built to answer "what happened in this
|
||||||
|
-- project".
|
||||||
|
--
|
||||||
|
-- The cascade first. An audit log whose rows disappear when the account they
|
||||||
|
-- describe is deleted answers "what has happened on this server" with everything
|
||||||
|
-- except the part somebody had a reason to remove. That is the wrong answer to the
|
||||||
|
-- question, and it is the same mistake migration 0008 fixed on `tasks.created_by`:
|
||||||
|
-- the record outlives the person. SET NULL, and the reader shows "en slettet
|
||||||
|
-- konto" rather than a name.
|
||||||
|
--
|
||||||
|
-- `project_id` keeps cascading on purpose. A project purged from the trash is
|
||||||
|
-- genuinely gone — the trash is the undo, and past it the deletion was deliberate
|
||||||
|
-- and complete. Activity has its own retention window besides.
|
||||||
|
--
|
||||||
|
-- Then the index. `idx_activity_project` leads with project_id, so a query that
|
||||||
|
-- wants the newest rows across every project cannot use it and scans the table to
|
||||||
|
-- sort it. The new one is ordered the way the audit log reads, and the compound
|
||||||
|
-- (created_at, id) matches the keyset the handler pages with — two rows written in
|
||||||
|
-- the same second must not be able to hide each other across a page boundary.
|
||||||
|
--
|
||||||
|
-- The marker below is not here because the drop would cascade: nothing references
|
||||||
|
-- `activity`, so it takes nothing with it. It is here for the check that comes
|
||||||
|
-- with it. With foreign keys on, the copy is validated a row at a time against a
|
||||||
|
-- schema that is half rebuilt, and the first bad row aborts with no idea how many
|
||||||
|
-- others are like it. With them off, `PRAGMA foreign_key_check` runs once before
|
||||||
|
-- the commit and names what is actually wrong — and this runs against a live
|
||||||
|
-- database on somebody's next restart.
|
||||||
|
--
|
||||||
|
-- verdande:rebuild-tables
|
||||||
|
|
||||||
|
CREATE TABLE activity_rebuilt (
|
||||||
|
id TEXT PRIMARY KEY,
|
||||||
|
project_id TEXT NOT NULL REFERENCES projects (id) ON DELETE CASCADE,
|
||||||
|
task_id TEXT REFERENCES tasks (id) ON DELETE SET NULL,
|
||||||
|
-- Nullable: the record of what was done outlives whoever did it.
|
||||||
|
user_id TEXT REFERENCES users (id) ON DELETE SET NULL,
|
||||||
|
event TEXT NOT NULL,
|
||||||
|
payload_json TEXT NOT NULL DEFAULT '{}',
|
||||||
|
created_at INTEGER NOT NULL
|
||||||
|
);
|
||||||
|
|
||||||
|
INSERT INTO activity_rebuilt (id, project_id, task_id, user_id, event, payload_json, created_at)
|
||||||
|
SELECT id, project_id, task_id, user_id, event, payload_json, created_at FROM activity;
|
||||||
|
|
||||||
|
DROP TABLE activity;
|
||||||
|
|
||||||
|
ALTER TABLE activity_rebuilt RENAME TO activity;
|
||||||
|
|
||||||
|
CREATE INDEX idx_activity_project ON activity (project_id, created_at DESC);
|
||||||
|
CREATE INDEX idx_activity_task ON activity (task_id) WHERE task_id IS NOT NULL;
|
||||||
|
CREATE INDEX idx_activity_recent ON activity (created_at DESC, id DESC);
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
-- Which of the sidebar's fixed headings a person has folded away.
|
||||||
|
--
|
||||||
|
-- A project group already carries `collapsed` on its own row, and the reasoning
|
||||||
|
-- there applies here too: folding a heading is a statement about the work, not
|
||||||
|
-- about the screen. "I am not in Etiketter at the moment" is as true on the laptop
|
||||||
|
-- as on the desktop, which is what separates this from the sidebar's *width* —
|
||||||
|
-- that one is in localStorage, because a narrow laptop and a wide monitor deserve
|
||||||
|
-- different answers and syncing it would make one of them wrong every time you
|
||||||
|
-- moved.
|
||||||
|
--
|
||||||
|
-- A JSON array of keys rather than a column per heading. The set is the sidebar's
|
||||||
|
-- to decide and it has already changed twice; a column each would mean a migration
|
||||||
|
-- every time a heading is added, and a row full of booleans nobody reads for the
|
||||||
|
-- ones that were removed. Unknown keys are ignored on the way out, so an old
|
||||||
|
-- client's folded state survives a heading being renamed rather than resetting it.
|
||||||
|
ALTER TABLE users ADD COLUMN sidebar_collapsed TEXT NOT NULL DEFAULT '[]';
|
||||||
@@ -0,0 +1,24 @@
|
|||||||
|
-- Settings that belong to the instance rather than to a person.
|
||||||
|
--
|
||||||
|
-- The first of them is the Gmail OAuth client. It was configuration only —
|
||||||
|
-- `VERDANDE_GMAIL_CLIENT_ID` and `_SECRET` — which on a Rune means editing the
|
||||||
|
-- manifest and recreating the container to change a value you paste once and
|
||||||
|
-- never touch again. The registration itself cannot be avoided (Google issues no
|
||||||
|
-- Gmail access to an unregistered client, and `gmail.readonly` is a restricted
|
||||||
|
-- scope, so a client id shipped inside a public image would be both extractable
|
||||||
|
-- and unusable), but having to redeploy to enter it can.
|
||||||
|
--
|
||||||
|
-- Its own table rather than `user_settings`, for two reasons. An OAuth client is
|
||||||
|
-- the instance's, not one person's — everybody connecting their mailbox uses the
|
||||||
|
-- same registration. And `user_settings` has `user_id` as its whole primary key,
|
||||||
|
-- so it can hold exactly one scope per person and its upsert rewrites the scope
|
||||||
|
-- name on conflict; adding a second scope there would silently overwrite the AI
|
||||||
|
-- provider's key.
|
||||||
|
--
|
||||||
|
-- JSON for the same reason templates are: written whole, read whole, and it would
|
||||||
|
-- otherwise be a migration every time a setting is added.
|
||||||
|
CREATE TABLE instance_settings (
|
||||||
|
scope TEXT PRIMARY KEY,
|
||||||
|
values_json TEXT NOT NULL DEFAULT '{}',
|
||||||
|
updated_at INTEGER NOT NULL
|
||||||
|
);
|
||||||
@@ -0,0 +1,60 @@
|
|||||||
|
-- A group becomes somewhere you can go, rather than only a heading.
|
||||||
|
--
|
||||||
|
-- Until now a project group was a label over some rows in the sidebar: a name, a
|
||||||
|
-- colour, and whether it was folded. That is enough to tidy a list and not enough
|
||||||
|
-- to be the thing people actually mean by it — "Arbejde" is a body of work with
|
||||||
|
-- context of its own: what it is, and the documents that belong to all of it
|
||||||
|
-- rather than to any one project inside it.
|
||||||
|
--
|
||||||
|
-- Two changes. A description on the group, and attachments that can hang on one.
|
||||||
|
--
|
||||||
|
-- The attachments table has to be rebuilt for the second, because its CHECK spells
|
||||||
|
-- out exactly which parent columns may be set, and SQLite cannot alter a CHECK.
|
||||||
|
--
|
||||||
|
-- Foreign keys go off for the length of it — see the marker below and the note in
|
||||||
|
-- `applyMigration`. Not because the drop would cascade: nothing references
|
||||||
|
-- `attachments`, so it takes nothing with it. It is for the check that comes with
|
||||||
|
-- the marker. With foreign keys on, the copy is validated a row at a time against
|
||||||
|
-- a half-rebuilt schema and the first bad row aborts with no idea how many others
|
||||||
|
-- there are; with them off, `PRAGMA foreign_key_check` runs once before the commit
|
||||||
|
-- and names what is actually wrong. This runs against a live database on somebody's
|
||||||
|
-- next restart, and an attachment whose task was already gone would otherwise stop
|
||||||
|
-- the server from starting with one row's worth of explanation.
|
||||||
|
--
|
||||||
|
-- The rule stays "exactly one parent": an attachment belongs to a task, a comment
|
||||||
|
-- or a group, never two. An attachment with two parents is one that gets deleted
|
||||||
|
-- once and stays visible in the other place.
|
||||||
|
--
|
||||||
|
-- verdande:rebuild-tables
|
||||||
|
|
||||||
|
ALTER TABLE project_groups ADD COLUMN description TEXT NOT NULL DEFAULT '';
|
||||||
|
|
||||||
|
CREATE TABLE attachments_rebuilt (
|
||||||
|
id TEXT PRIMARY KEY,
|
||||||
|
task_id TEXT REFERENCES tasks (id) ON DELETE CASCADE,
|
||||||
|
comment_id TEXT REFERENCES comments (id) ON DELETE CASCADE,
|
||||||
|
group_id TEXT REFERENCES project_groups (id) ON DELETE CASCADE,
|
||||||
|
filename TEXT NOT NULL,
|
||||||
|
mime_type TEXT NOT NULL DEFAULT 'application/octet-stream',
|
||||||
|
size INTEGER NOT NULL,
|
||||||
|
path TEXT NOT NULL,
|
||||||
|
uploaded_by TEXT NOT NULL REFERENCES users (id) ON DELETE CASCADE,
|
||||||
|
created_at INTEGER NOT NULL,
|
||||||
|
-- Exactly one parent, counted rather than spelled out as a chain of pairwise
|
||||||
|
-- comparisons: with three columns that is three clauses, with four it is six,
|
||||||
|
-- and the version that is wrong looks exactly like the version that is right.
|
||||||
|
CHECK ((task_id IS NOT NULL) + (comment_id IS NOT NULL) + (group_id IS NOT NULL) = 1)
|
||||||
|
);
|
||||||
|
|
||||||
|
INSERT INTO attachments_rebuilt
|
||||||
|
(id, task_id, comment_id, filename, mime_type, size, path, uploaded_by, created_at)
|
||||||
|
SELECT id, task_id, comment_id, filename, mime_type, size, path, uploaded_by, created_at
|
||||||
|
FROM attachments;
|
||||||
|
|
||||||
|
DROP TABLE attachments;
|
||||||
|
|
||||||
|
ALTER TABLE attachments_rebuilt RENAME TO attachments;
|
||||||
|
|
||||||
|
CREATE INDEX idx_attachments_task ON attachments (task_id) WHERE task_id IS NOT NULL;
|
||||||
|
CREATE INDEX idx_attachments_comment ON attachments (comment_id) WHERE comment_id IS NOT NULL;
|
||||||
|
CREATE INDEX idx_attachments_group ON attachments (group_id) WHERE group_id IS NOT NULL;
|
||||||
@@ -0,0 +1,73 @@
|
|||||||
|
-- Passkeys: a key on a device instead of a secret in a head.
|
||||||
|
--
|
||||||
|
-- The account already has two ways in — a password, and a TOTP code on top of it.
|
||||||
|
-- Both are shared secrets: the server keeps something that can be stolen from it,
|
||||||
|
-- and the person keeps something that can be phished out of them. A passkey is
|
||||||
|
-- neither. The private half never leaves the device, the public half is all this
|
||||||
|
-- table holds, and the signature is bound to the origin — so a convincing copy of
|
||||||
|
-- the sign-in page at a different address gets nothing.
|
||||||
|
--
|
||||||
|
-- One row per credential rather than per account, because a person has more than
|
||||||
|
-- one device and losing a laptop should not mean losing the way in. The name is
|
||||||
|
-- theirs to write: "min bærbare" is what makes a list of keys reviewable, and a
|
||||||
|
-- list nobody can read is a list nobody revokes from.
|
||||||
|
--
|
||||||
|
-- `sign_count` is the authenticator's own counter. It is stored to be compared:
|
||||||
|
-- a counter that goes backwards means the credential has been cloned, which is
|
||||||
|
-- the one thing this design cannot otherwise detect. Not every authenticator keeps
|
||||||
|
-- one — the spec allows zero — so zero means "not offered" rather than "suspicious".
|
||||||
|
CREATE TABLE passkeys (
|
||||||
|
id TEXT PRIMARY KEY,
|
||||||
|
user_id TEXT NOT NULL REFERENCES users (id) ON DELETE CASCADE,
|
||||||
|
-- The credential id the authenticator generated, raw bytes, base64url as
|
||||||
|
-- stored. Unique across the instance: it is what a login is looked up by,
|
||||||
|
-- before anybody has said who they are.
|
||||||
|
credential_id TEXT NOT NULL,
|
||||||
|
public_key BLOB NOT NULL,
|
||||||
|
-- The AAGUID identifies the authenticator model, which is what lets a list say
|
||||||
|
-- "iCloud Keychain" beside a key somebody named three months ago and forgot.
|
||||||
|
aaguid TEXT NOT NULL DEFAULT '',
|
||||||
|
sign_count INTEGER NOT NULL DEFAULT 0,
|
||||||
|
-- Whether the credential lives on the device itself (a resident key). Only
|
||||||
|
-- those can start a login with no email typed first, so the interface has to
|
||||||
|
-- know which it has before it offers that.
|
||||||
|
discoverable INTEGER NOT NULL DEFAULT 0,
|
||||||
|
-- Whether the authenticator verified the person — a PIN, a fingerprint, a
|
||||||
|
-- face. A key that only proves possession is a first factor; one that verified
|
||||||
|
-- its owner is both, and that is what decides whether a password is still
|
||||||
|
-- asked for.
|
||||||
|
user_verified INTEGER NOT NULL DEFAULT 0,
|
||||||
|
name TEXT NOT NULL DEFAULT '',
|
||||||
|
created_at INTEGER NOT NULL,
|
||||||
|
last_used_at INTEGER
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE UNIQUE INDEX idx_passkeys_credential ON passkeys (credential_id);
|
||||||
|
CREATE INDEX idx_passkeys_user ON passkeys (user_id);
|
||||||
|
|
||||||
|
-- The challenge a registration or a login is answered against.
|
||||||
|
--
|
||||||
|
-- Kept server-side rather than in a cookie: the whole point of the challenge is
|
||||||
|
-- that the server chose it and remembers choosing it. One row per attempt, deleted
|
||||||
|
-- when it is answered, and swept when it expires — a challenge that outlives its
|
||||||
|
-- ceremony is a replay waiting to be tried.
|
||||||
|
--
|
||||||
|
-- user_id is null for a login that has not said who it is yet, which is the case
|
||||||
|
-- a discoverable credential exists for.
|
||||||
|
CREATE TABLE webauthn_challenges (
|
||||||
|
id TEXT PRIMARY KEY,
|
||||||
|
user_id TEXT REFERENCES users (id) ON DELETE CASCADE,
|
||||||
|
challenge TEXT NOT NULL,
|
||||||
|
-- 'register' or 'login'. A challenge issued for one must not be answerable by
|
||||||
|
-- the other: registering is done by somebody already signed in, and logging in
|
||||||
|
-- is not.
|
||||||
|
purpose TEXT NOT NULL,
|
||||||
|
-- The library's own session state, which carries the allowed credentials and
|
||||||
|
-- the verification requirement it will check the answer against.
|
||||||
|
session BLOB NOT NULL,
|
||||||
|
created_at INTEGER NOT NULL,
|
||||||
|
expires_at INTEGER NOT NULL,
|
||||||
|
CHECK (purpose IN ('register', 'login'))
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE INDEX idx_webauthn_challenges_expiry ON webauthn_challenges (expires_at);
|
||||||
@@ -4,6 +4,7 @@ import (
|
|||||||
"context"
|
"context"
|
||||||
"database/sql"
|
"database/sql"
|
||||||
"encoding/json"
|
"encoding/json"
|
||||||
|
"errors"
|
||||||
"time"
|
"time"
|
||||||
|
|
||||||
"github.com/kristianwind/verdande/internal/auth"
|
"github.com/kristianwind/verdande/internal/auth"
|
||||||
@@ -346,3 +347,43 @@ func (db *DB) SetUserSettings(ctx context.Context, userID, scope string, values
|
|||||||
userID, scope, string(raw), time.Now().Unix())
|
userID, scope, string(raw), time.Now().Unix())
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// --- instance-wide settings -------------------------------------------------------------
|
||||||
|
|
||||||
|
// InstanceSettings reads one scope of the instance's own settings. A missing row
|
||||||
|
// is an empty map, not an error.
|
||||||
|
//
|
||||||
|
// Separate from UserSettings because some configuration is the server's rather
|
||||||
|
// than a person's — the Gmail OAuth client is one registration that everybody
|
||||||
|
// connecting a mailbox goes through, not a preference each of them holds.
|
||||||
|
func (db *DB) InstanceSettings(ctx context.Context, scope string) (map[string]any, error) {
|
||||||
|
var raw string
|
||||||
|
err := db.QueryRowContext(ctx,
|
||||||
|
`SELECT values_json FROM instance_settings WHERE scope = ?`, scope).Scan(&raw)
|
||||||
|
if errors.Is(err, sql.ErrNoRows) {
|
||||||
|
return map[string]any{}, nil
|
||||||
|
}
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
values := map[string]any{}
|
||||||
|
if err := json.Unmarshal([]byte(raw), &values); err != nil {
|
||||||
|
return map[string]any{}, nil
|
||||||
|
}
|
||||||
|
return values, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
func (db *DB) SetInstanceSettings(ctx context.Context, scope string, values map[string]any) error {
|
||||||
|
raw, err := json.Marshal(values)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
_, err = db.ExecContext(ctx, `
|
||||||
|
INSERT INTO instance_settings (scope, values_json, updated_at)
|
||||||
|
VALUES (?, ?, ?)
|
||||||
|
ON CONFLICT (scope) DO UPDATE SET
|
||||||
|
values_json = excluded.values_json,
|
||||||
|
updated_at = excluded.updated_at`,
|
||||||
|
scope, string(raw), time.Now().Unix())
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
|||||||
@@ -0,0 +1,206 @@
|
|||||||
|
package store
|
||||||
|
|
||||||
|
import (
|
||||||
|
"context"
|
||||||
|
"database/sql"
|
||||||
|
"errors"
|
||||||
|
"time"
|
||||||
|
)
|
||||||
|
|
||||||
|
// A Passkey is one credential on one device.
|
||||||
|
//
|
||||||
|
// One row per credential rather than per account: a person has a laptop and a
|
||||||
|
// phone, and losing one must not mean losing the way in. The name is theirs to
|
||||||
|
// write — "min bærbare" is what makes the list reviewable, and a list nobody can
|
||||||
|
// read is a list nobody revokes from.
|
||||||
|
type Passkey struct {
|
||||||
|
ID string
|
||||||
|
UserID string
|
||||||
|
CredentialID string
|
||||||
|
PublicKey []byte
|
||||||
|
AAGUID string
|
||||||
|
SignCount uint32
|
||||||
|
Discoverable bool
|
||||||
|
UserVerified bool
|
||||||
|
Name string
|
||||||
|
CreatedAt time.Time
|
||||||
|
LastUsedAt time.Time
|
||||||
|
}
|
||||||
|
|
||||||
|
func (db *DB) CreatePasskey(ctx context.Context, p *Passkey) error {
|
||||||
|
if p.ID == "" {
|
||||||
|
p.ID = NewID()
|
||||||
|
}
|
||||||
|
p.CreatedAt = time.Now().UTC()
|
||||||
|
_, err := db.ExecContext(ctx, `
|
||||||
|
INSERT INTO passkeys (id, user_id, credential_id, public_key, aaguid, sign_count,
|
||||||
|
discoverable, user_verified, name, created_at)
|
||||||
|
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
|
||||||
|
p.ID, p.UserID, p.CredentialID, p.PublicKey, p.AAGUID, p.SignCount,
|
||||||
|
boolToInt(p.Discoverable), boolToInt(p.UserVerified), p.Name, p.CreatedAt.Unix())
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
|
||||||
|
func (db *DB) ListPasskeys(ctx context.Context, userID string) ([]Passkey, error) {
|
||||||
|
rows, err := db.QueryContext(ctx, `
|
||||||
|
SELECT id, user_id, credential_id, public_key, aaguid, sign_count,
|
||||||
|
discoverable, user_verified, name, created_at, COALESCE(last_used_at, 0)
|
||||||
|
FROM passkeys WHERE user_id = ? ORDER BY created_at`, userID)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
defer rows.Close()
|
||||||
|
return scanPasskeys(rows)
|
||||||
|
}
|
||||||
|
|
||||||
|
// PasskeyByCredentialID is how a login finds the account, before anybody has said
|
||||||
|
// who they are. The credential id is unique across the instance, which is what
|
||||||
|
// makes that possible.
|
||||||
|
func (db *DB) PasskeyByCredentialID(ctx context.Context, credentialID string) (*Passkey, error) {
|
||||||
|
rows, err := db.QueryContext(ctx, `
|
||||||
|
SELECT id, user_id, credential_id, public_key, aaguid, sign_count,
|
||||||
|
discoverable, user_verified, name, created_at, COALESCE(last_used_at, 0)
|
||||||
|
FROM passkeys WHERE credential_id = ?`, credentialID)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
defer rows.Close()
|
||||||
|
|
||||||
|
list, err := scanPasskeys(rows)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
if len(list) == 0 {
|
||||||
|
return nil, ErrNotFound
|
||||||
|
}
|
||||||
|
return &list[0], nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// TouchPasskey records a use and the authenticator's counter.
|
||||||
|
//
|
||||||
|
// The counter is stored to be compared. One that goes backwards means the
|
||||||
|
// credential has been cloned, which is the single thing this design cannot
|
||||||
|
// otherwise detect — and not every authenticator keeps one, so zero means "not
|
||||||
|
// offered" rather than "suspicious".
|
||||||
|
func (db *DB) TouchPasskey(ctx context.Context, id string, signCount uint32) error {
|
||||||
|
_, err := db.ExecContext(ctx,
|
||||||
|
`UPDATE passkeys SET sign_count = ?, last_used_at = ? WHERE id = ?`,
|
||||||
|
signCount, time.Now().Unix(), id)
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
|
||||||
|
func (db *DB) RenamePasskey(ctx context.Context, id, userID, name string) error {
|
||||||
|
res, err := db.ExecContext(ctx,
|
||||||
|
`UPDATE passkeys SET name = ? WHERE id = ? AND user_id = ?`, name, id, userID)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
if n, _ := res.RowsAffected(); n == 0 {
|
||||||
|
return ErrNotFound
|
||||||
|
}
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// DeletePasskey removes one key. Scoped in the SQL rather than checked first: an
|
||||||
|
// id read in one step and deleted in the next is a window, and the reason somebody
|
||||||
|
// is on this screen at all is usually that they think a device is gone.
|
||||||
|
func (db *DB) DeletePasskey(ctx context.Context, id, userID string) error {
|
||||||
|
res, err := db.ExecContext(ctx,
|
||||||
|
`DELETE FROM passkeys WHERE id = ? AND user_id = ?`, id, userID)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
if n, _ := res.RowsAffected(); n == 0 {
|
||||||
|
return ErrNotFound
|
||||||
|
}
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// CountPasskeys is what stops somebody removing their last way in when it is the
|
||||||
|
// only one they have.
|
||||||
|
func (db *DB) CountPasskeys(ctx context.Context, userID string) (int, error) {
|
||||||
|
var n int
|
||||||
|
err := db.QueryRowContext(ctx,
|
||||||
|
`SELECT count(*) FROM passkeys WHERE user_id = ?`, userID).Scan(&n)
|
||||||
|
return n, err
|
||||||
|
}
|
||||||
|
|
||||||
|
func scanPasskeys(rows *sql.Rows) ([]Passkey, error) {
|
||||||
|
out := []Passkey{}
|
||||||
|
for rows.Next() {
|
||||||
|
var p Passkey
|
||||||
|
var discoverable, verified int
|
||||||
|
var created, used int64
|
||||||
|
if err := rows.Scan(&p.ID, &p.UserID, &p.CredentialID, &p.PublicKey, &p.AAGUID,
|
||||||
|
&p.SignCount, &discoverable, &verified, &p.Name, &created, &used); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
p.Discoverable = discoverable == 1
|
||||||
|
p.UserVerified = verified == 1
|
||||||
|
p.CreatedAt = time.Unix(created, 0).UTC()
|
||||||
|
if used > 0 {
|
||||||
|
p.LastUsedAt = time.Unix(used, 0).UTC()
|
||||||
|
}
|
||||||
|
out = append(out, p)
|
||||||
|
}
|
||||||
|
return out, rows.Err()
|
||||||
|
}
|
||||||
|
|
||||||
|
// --- challenges -------------------------------------------------------------------
|
||||||
|
|
||||||
|
// StoreChallenge keeps the server's side of one ceremony.
|
||||||
|
//
|
||||||
|
// Server-side rather than in a cookie: the whole point of a challenge is that the
|
||||||
|
// server chose it and remembers choosing it. It is deleted when answered and swept
|
||||||
|
// when it expires — a challenge that outlives its ceremony is a replay waiting to
|
||||||
|
// be tried.
|
||||||
|
func (db *DB) StoreChallenge(ctx context.Context, userID, challenge, purpose string, session []byte, ttl time.Duration) (string, error) {
|
||||||
|
id := NewID()
|
||||||
|
now := time.Now()
|
||||||
|
_, err := db.ExecContext(ctx, `
|
||||||
|
INSERT INTO webauthn_challenges (id, user_id, challenge, purpose, session, created_at, expires_at)
|
||||||
|
VALUES (?, ?, ?, ?, ?, ?, ?)`,
|
||||||
|
id, nullString(userID), challenge, purpose, session, now.Unix(), now.Add(ttl).Unix())
|
||||||
|
return id, err
|
||||||
|
}
|
||||||
|
|
||||||
|
// TakeChallenge reads a challenge and removes it in the same transaction.
|
||||||
|
//
|
||||||
|
// Taken rather than read, because a challenge is answerable exactly once. Two
|
||||||
|
// requests racing the same one would otherwise both succeed, which is the whole
|
||||||
|
// shape of a replay.
|
||||||
|
func (db *DB) TakeChallenge(ctx context.Context, id, purpose string) (userID string, session []byte, err error) {
|
||||||
|
err = db.Tx(ctx, func(tx *sql.Tx) error {
|
||||||
|
var owner sql.NullString
|
||||||
|
var expires int64
|
||||||
|
row := tx.QueryRowContext(ctx,
|
||||||
|
`SELECT user_id, session, expires_at FROM webauthn_challenges WHERE id = ? AND purpose = ?`,
|
||||||
|
id, purpose)
|
||||||
|
if err := row.Scan(&owner, &session, &expires); err != nil {
|
||||||
|
if errors.Is(err, sql.ErrNoRows) {
|
||||||
|
return ErrNotFound
|
||||||
|
}
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
if _, err := tx.ExecContext(ctx, `DELETE FROM webauthn_challenges WHERE id = ?`, id); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
if time.Now().Unix() > expires {
|
||||||
|
return ErrNotFound
|
||||||
|
}
|
||||||
|
userID = owner.String
|
||||||
|
return nil
|
||||||
|
})
|
||||||
|
return userID, session, err
|
||||||
|
}
|
||||||
|
|
||||||
|
// PurgeChallenges is run by the nightly sweep. An answered challenge deletes
|
||||||
|
// itself; an abandoned one is what this is for.
|
||||||
|
func (db *DB) PurgeChallenges(ctx context.Context) (int64, error) {
|
||||||
|
res, err := db.ExecContext(ctx,
|
||||||
|
`DELETE FROM webauthn_challenges WHERE expires_at < ?`, time.Now().Unix())
|
||||||
|
if err != nil {
|
||||||
|
return 0, err
|
||||||
|
}
|
||||||
|
return res.RowsAffected()
|
||||||
|
}
|
||||||
@@ -15,18 +15,23 @@ import (
|
|||||||
// not. That is also why a shared project can never be in a group — see
|
// not. That is also why a shared project can never be in a group — see
|
||||||
// SetProjectGroup.
|
// SetProjectGroup.
|
||||||
type ProjectGroup struct {
|
type ProjectGroup struct {
|
||||||
ID string
|
ID string
|
||||||
OwnerID string
|
OwnerID string
|
||||||
Name string
|
Name string
|
||||||
Collapsed bool
|
Color string
|
||||||
SortOrder float64
|
// Description is what the group is, in the owner's words. A heading can carry
|
||||||
CreatedAt time.Time
|
// a name; a page can carry the sentence that says why these projects are the
|
||||||
UpdatedAt time.Time
|
// same body of work.
|
||||||
|
Description string
|
||||||
|
Collapsed bool
|
||||||
|
SortOrder float64
|
||||||
|
CreatedAt time.Time
|
||||||
|
UpdatedAt time.Time
|
||||||
}
|
}
|
||||||
|
|
||||||
func (db *DB) ListProjectGroups(ctx context.Context, userID string) ([]ProjectGroup, error) {
|
func (db *DB) ListProjectGroups(ctx context.Context, userID string) ([]ProjectGroup, error) {
|
||||||
rows, err := db.QueryContext(ctx,
|
rows, err := db.QueryContext(ctx,
|
||||||
`SELECT id, owner_id, name, collapsed, sort_order, created_at, updated_at
|
`SELECT id, owner_id, name, color, description, collapsed, sort_order, created_at, updated_at
|
||||||
FROM project_groups WHERE owner_id = ?
|
FROM project_groups WHERE owner_id = ?
|
||||||
ORDER BY sort_order, created_at`, userID)
|
ORDER BY sort_order, created_at`, userID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -39,8 +44,8 @@ func (db *DB) ListProjectGroups(ctx context.Context, userID string) ([]ProjectGr
|
|||||||
var g ProjectGroup
|
var g ProjectGroup
|
||||||
var collapsed int
|
var collapsed int
|
||||||
var created, updated int64
|
var created, updated int64
|
||||||
if err := rows.Scan(&g.ID, &g.OwnerID, &g.Name, &collapsed, &g.SortOrder,
|
if err := rows.Scan(&g.ID, &g.OwnerID, &g.Name, &g.Color, &g.Description, &collapsed,
|
||||||
&created, &updated); err != nil {
|
&g.SortOrder, &created, &updated); err != nil {
|
||||||
return nil, err
|
return nil, err
|
||||||
}
|
}
|
||||||
g.Collapsed = collapsed == 1
|
g.Collapsed = collapsed == 1
|
||||||
@@ -59,9 +64,10 @@ func (db *DB) GetProjectGroup(ctx context.Context, groupID, userID string) (*Pro
|
|||||||
var collapsed int
|
var collapsed int
|
||||||
var created, updated int64
|
var created, updated int64
|
||||||
err := db.QueryRowContext(ctx,
|
err := db.QueryRowContext(ctx,
|
||||||
`SELECT id, owner_id, name, collapsed, sort_order, created_at, updated_at
|
`SELECT id, owner_id, name, color, description, collapsed, sort_order, created_at, updated_at
|
||||||
FROM project_groups WHERE id = ? AND owner_id = ?`, groupID, userID).
|
FROM project_groups WHERE id = ? AND owner_id = ?`, groupID, userID).
|
||||||
Scan(&g.ID, &g.OwnerID, &g.Name, &collapsed, &g.SortOrder, &created, &updated)
|
Scan(&g.ID, &g.OwnerID, &g.Name, &g.Color, &g.Description, &collapsed, &g.SortOrder,
|
||||||
|
&created, &updated)
|
||||||
if errors.Is(err, sql.ErrNoRows) {
|
if errors.Is(err, sql.ErrNoRows) {
|
||||||
return nil, ErrNotFound
|
return nil, ErrNotFound
|
||||||
}
|
}
|
||||||
@@ -80,6 +86,9 @@ func (db *DB) CreateProjectGroup(ctx context.Context, g *ProjectGroup) error {
|
|||||||
}
|
}
|
||||||
now := time.Now().UTC()
|
now := time.Now().UTC()
|
||||||
g.CreatedAt, g.UpdatedAt = now, now
|
g.CreatedAt, g.UpdatedAt = now, now
|
||||||
|
if g.Color == "" {
|
||||||
|
g.Color = DefaultColor
|
||||||
|
}
|
||||||
if g.SortOrder == 0 {
|
if g.SortOrder == 0 {
|
||||||
var max sql.NullFloat64
|
var max sql.NullFloat64
|
||||||
if err := db.QueryRowContext(ctx,
|
if err := db.QueryRowContext(ctx,
|
||||||
@@ -90,23 +99,27 @@ func (db *DB) CreateProjectGroup(ctx context.Context, g *ProjectGroup) error {
|
|||||||
g.SortOrder = max.Float64 + 1024
|
g.SortOrder = max.Float64 + 1024
|
||||||
}
|
}
|
||||||
_, err := db.ExecContext(ctx,
|
_, err := db.ExecContext(ctx,
|
||||||
`INSERT INTO project_groups (id, owner_id, name, collapsed, sort_order, created_at, updated_at)
|
`INSERT INTO project_groups (id, owner_id, name, color, collapsed, sort_order, created_at, updated_at)
|
||||||
VALUES (?, ?, ?, ?, ?, ?, ?)`,
|
VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
|
||||||
g.ID, g.OwnerID, g.Name, boolToInt(g.Collapsed), g.SortOrder, now.Unix(), now.Unix())
|
g.ID, g.OwnerID, g.Name, g.Color, boolToInt(g.Collapsed), g.SortOrder, now.Unix(), now.Unix())
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
|
|
||||||
type ProjectGroupUpdate struct {
|
type ProjectGroupUpdate struct {
|
||||||
Name *string
|
Name *string
|
||||||
Collapsed *bool
|
Color *string
|
||||||
SortOrder *float64
|
Description *string
|
||||||
|
Collapsed *bool
|
||||||
|
SortOrder *float64
|
||||||
}
|
}
|
||||||
|
|
||||||
func (db *DB) UpdateProjectGroup(ctx context.Context, groupID, userID string, u ProjectGroupUpdate) error {
|
func (db *DB) UpdateProjectGroup(ctx context.Context, groupID, userID string, u ProjectGroupUpdate) error {
|
||||||
set, args := buildUpdate(map[string]any{
|
set, args := buildUpdate(map[string]any{
|
||||||
"name": u.Name,
|
"name": u.Name,
|
||||||
"collapsed": u.Collapsed,
|
"color": u.Color,
|
||||||
"sort_order": u.SortOrder,
|
"description": u.Description,
|
||||||
|
"collapsed": u.Collapsed,
|
||||||
|
"sort_order": u.SortOrder,
|
||||||
})
|
})
|
||||||
if len(set) == 0 {
|
if len(set) == 0 {
|
||||||
return nil
|
return nil
|
||||||
@@ -203,3 +216,37 @@ func (db *DB) SetProjectGroup(ctx context.Context, projectID, groupID, userID st
|
|||||||
}
|
}
|
||||||
return nil
|
return nil
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// OpenTaskCounts is how much is left in each project of a group.
|
||||||
|
//
|
||||||
|
// One query rather than one per project: the group's page draws a list, and a
|
||||||
|
// count per row would be a query per row.
|
||||||
|
//
|
||||||
|
// Open, not total. "12" beside a project you finished last year is a number that
|
||||||
|
// means nothing; the question a list of projects answers is what is still on it.
|
||||||
|
// Sub-tasks are excluded for the same reason the project view nests them — they
|
||||||
|
// are part of their parent, not another thing to do.
|
||||||
|
func (db *DB) OpenTaskCounts(ctx context.Context, groupID, userID string) (map[string]int, error) {
|
||||||
|
rows, err := db.QueryContext(ctx, `
|
||||||
|
SELECT p.id, count(t.id)
|
||||||
|
FROM projects p
|
||||||
|
LEFT JOIN tasks t ON t.project_id = p.id
|
||||||
|
AND t.deleted_at IS NULL AND t.completed_at IS NULL AND t.parent_id IS NULL
|
||||||
|
WHERE p.group_id = ? AND p.owner_id = ? AND p.deleted_at IS NULL
|
||||||
|
GROUP BY p.id`, groupID, userID)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
defer rows.Close()
|
||||||
|
|
||||||
|
counts := map[string]int{}
|
||||||
|
for rows.Next() {
|
||||||
|
var id string
|
||||||
|
var n int
|
||||||
|
if err := rows.Scan(&id, &n); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
counts[id] = n
|
||||||
|
}
|
||||||
|
return counts, rows.Err()
|
||||||
|
}
|
||||||
|
|||||||
@@ -389,6 +389,33 @@ func (db *DB) AddMember(ctx context.Context, projectID, userID string, role Role
|
|||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// SetMemberRole changes what an existing member may do.
|
||||||
|
//
|
||||||
|
// An UPDATE rather than the upsert AddMember does, and the difference is the
|
||||||
|
// point: this is a PATCH against a membership that exists. Somebody who is not a
|
||||||
|
// member is not silently made one — that is an invite, it belongs to the invite
|
||||||
|
// flow, and doing it here would let a typo in a user id add a stranger to a
|
||||||
|
// project without anybody being asked.
|
||||||
|
//
|
||||||
|
// Owner is refused for the same reason AddMember refuses it: ownership is
|
||||||
|
// transferred, not granted, and two owners is a state with no way to settle a
|
||||||
|
// disagreement about who may remove whom.
|
||||||
|
func (db *DB) SetMemberRole(ctx context.Context, projectID, userID string, role Role) error {
|
||||||
|
if !role.Valid() || role == RoleOwner {
|
||||||
|
return errors.New("store: members may be editor or viewer")
|
||||||
|
}
|
||||||
|
res, err := db.ExecContext(ctx,
|
||||||
|
`UPDATE project_members SET role = ? WHERE project_id = ? AND user_id = ?`,
|
||||||
|
string(role), projectID, userID)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
if n, _ := res.RowsAffected(); n == 0 {
|
||||||
|
return ErrNotFound
|
||||||
|
}
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
func (db *DB) RemoveMember(ctx context.Context, projectID, userID string) error {
|
func (db *DB) RemoveMember(ctx context.Context, projectID, userID string) error {
|
||||||
return db.Tx(ctx, func(tx *sql.Tx) error {
|
return db.Tx(ctx, func(tx *sql.Tx) error {
|
||||||
// Anything assigned to them is unassigned rather than left pointing at
|
// Anything assigned to them is unassigned rather than left pointing at
|
||||||
@@ -603,3 +630,36 @@ func (db *DB) ReorderProjects(ctx context.Context, userID string, ids []string)
|
|||||||
return nil
|
return nil
|
||||||
})
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// SectionByName resolves a "/name" from quick add within one project.
|
||||||
|
//
|
||||||
|
// Case-insensitive, and scoped to the project the task is landing in — a section
|
||||||
|
// belongs to exactly one project, so the name cannot be looked up before that is
|
||||||
|
// decided. Two projects may both have a "Produktion" and they are different
|
||||||
|
// sections; asking without the project would be asking the wrong question.
|
||||||
|
func (db *DB) SectionByName(ctx context.Context, projectID, name string) (string, error) {
|
||||||
|
var id string
|
||||||
|
err := db.QueryRowContext(ctx, `
|
||||||
|
SELECT id FROM sections
|
||||||
|
WHERE project_id = ? AND lower(name) = lower(?) AND deleted_at IS NULL
|
||||||
|
ORDER BY sort_order
|
||||||
|
LIMIT 1`, projectID, name).Scan(&id)
|
||||||
|
if errors.Is(err, sql.ErrNoRows) {
|
||||||
|
return "", ErrNotFound
|
||||||
|
}
|
||||||
|
return id, err
|
||||||
|
}
|
||||||
|
|
||||||
|
// SectionInProject reports whether a section id belongs to the given project.
|
||||||
|
//
|
||||||
|
// Quick add takes a section id from the client — the field at the foot of a
|
||||||
|
// section passes the one it sits in — and a "#project" in the same line can move
|
||||||
|
// the task somewhere else entirely. Without this the id would follow it, and the
|
||||||
|
// task would land in a section belonging to a project it is not in.
|
||||||
|
func (db *DB) SectionInProject(ctx context.Context, sectionID, projectID string) (bool, error) {
|
||||||
|
var n int
|
||||||
|
err := db.QueryRowContext(ctx,
|
||||||
|
`SELECT count(*) FROM sections WHERE id = ? AND project_id = ? AND deleted_at IS NULL`,
|
||||||
|
sectionID, projectID).Scan(&n)
|
||||||
|
return n == 1, err
|
||||||
|
}
|
||||||
|
|||||||
@@ -25,15 +25,18 @@ type DB struct {
|
|||||||
path string
|
path string
|
||||||
}
|
}
|
||||||
|
|
||||||
// Open prepares the database at path and brings the schema up to date.
|
// dsn is the connection string.
|
||||||
//
|
//
|
||||||
// SQLite is a single file, but it is being driven by an HTTP server with concurrent
|
// SQLite is a single file, but it is being driven by an HTTP server with concurrent
|
||||||
// readers and a WebSocket fan-out, so the pragmas below matter more than usual:
|
// readers and a WebSocket fan-out, so the pragmas below matter more than usual:
|
||||||
// WAL lets readers run while a write is in flight, busy_timeout turns the "database
|
// WAL lets readers run while a write is in flight, busy_timeout turns the "database
|
||||||
// is locked" race into a short wait, and foreign_keys is off by default in SQLite
|
// is locked" race into a short wait, and foreign_keys is off by default in SQLite
|
||||||
// and has to be asked for on every connection.
|
// and has to be asked for on every connection.
|
||||||
func Open(path string) (*DB, error) {
|
//
|
||||||
dsn := "file:" + filepath.ToSlash(path) + "?" + strings.Join([]string{
|
// Its own function so the migration tests can open a database with exactly the
|
||||||
|
// pragmas production runs with.
|
||||||
|
func dsn(path string) string {
|
||||||
|
return "file:" + filepath.ToSlash(path) + "?" + strings.Join([]string{
|
||||||
"_pragma=journal_mode(WAL)",
|
"_pragma=journal_mode(WAL)",
|
||||||
"_pragma=busy_timeout(5000)",
|
"_pragma=busy_timeout(5000)",
|
||||||
"_pragma=foreign_keys(ON)",
|
"_pragma=foreign_keys(ON)",
|
||||||
@@ -56,8 +59,11 @@ func Open(path string) (*DB, error) {
|
|||||||
// spilling them into the data volume.
|
// spilling them into the data volume.
|
||||||
"_pragma=temp_store(MEMORY)",
|
"_pragma=temp_store(MEMORY)",
|
||||||
}, "&")
|
}, "&")
|
||||||
|
}
|
||||||
|
|
||||||
sqlDB, err := sql.Open("sqlite", dsn)
|
// Open prepares the database at path and brings the schema up to date.
|
||||||
|
func Open(path string) (*DB, error) {
|
||||||
|
sqlDB, err := sql.Open("sqlite", dsn(path))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return nil, fmt.Errorf("open sqlite: %w", err)
|
return nil, fmt.Errorf("open sqlite: %w", err)
|
||||||
}
|
}
|
||||||
@@ -91,11 +97,36 @@ func Open(path string) (*DB, error) {
|
|||||||
|
|
||||||
func (db *DB) Path() string { return db.path }
|
func (db *DB) Path() string { return db.path }
|
||||||
|
|
||||||
|
// rebuildMarker opts a migration out of foreign key enforcement for the length of
|
||||||
|
// its transaction.
|
||||||
|
//
|
||||||
|
// SQLite cannot alter a column's foreign key action, so changing one means
|
||||||
|
// rebuilding the table: copy it, drop the original, rename the copy back. With
|
||||||
|
// foreign keys on, the drop is a cascading delete — every row in every table that
|
||||||
|
// references `tasks` would go with it, which is the opposite of what a migration
|
||||||
|
// that exists to *stop* losing rows should do. `PRAGMA foreign_keys` is a no-op
|
||||||
|
// inside a transaction, so it has to be set on the connection before BEGIN; that
|
||||||
|
// is why migrations run on a connection of their own rather than on the pool.
|
||||||
|
//
|
||||||
|
// `PRAGMA foreign_key_check` runs before the commit, so a rebuild that leaves a
|
||||||
|
// dangling reference fails the migration instead of writing it.
|
||||||
|
const rebuildMarker = "-- verdande:rebuild-tables"
|
||||||
|
|
||||||
// migrate applies every embedded migration that has not run yet, in filename order,
|
// migrate applies every embedded migration that has not run yet, in filename order,
|
||||||
// each inside its own transaction. A migration that fails leaves the schema at the
|
// each inside its own transaction. A migration that fails leaves the schema at the
|
||||||
// last version that succeeded rather than half-applied.
|
// last version that succeeded rather than half-applied.
|
||||||
|
//
|
||||||
|
// Everything here runs on one connection: a migration marked with rebuildMarker
|
||||||
|
// needs a pragma to hold across its transaction, and a pragma only applies to the
|
||||||
|
// connection it was issued on.
|
||||||
func (db *DB) migrate(ctx context.Context) error {
|
func (db *DB) migrate(ctx context.Context) error {
|
||||||
if _, err := db.ExecContext(ctx, `
|
conn, err := db.Conn(ctx)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
defer conn.Close()
|
||||||
|
|
||||||
|
if _, err := conn.ExecContext(ctx, `
|
||||||
CREATE TABLE IF NOT EXISTS schema_migrations (
|
CREATE TABLE IF NOT EXISTS schema_migrations (
|
||||||
name TEXT PRIMARY KEY,
|
name TEXT PRIMARY KEY,
|
||||||
applied_at INTEGER NOT NULL
|
applied_at INTEGER NOT NULL
|
||||||
@@ -104,7 +135,7 @@ func (db *DB) migrate(ctx context.Context) error {
|
|||||||
}
|
}
|
||||||
|
|
||||||
applied := map[string]bool{}
|
applied := map[string]bool{}
|
||||||
rows, err := db.QueryContext(ctx, `SELECT name FROM schema_migrations`)
|
rows, err := conn.QueryContext(ctx, `SELECT name FROM schema_migrations`)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return fmt.Errorf("read schema_migrations: %w", err)
|
return fmt.Errorf("read schema_migrations: %w", err)
|
||||||
}
|
}
|
||||||
@@ -136,27 +167,69 @@ func (db *DB) migrate(ctx context.Context) error {
|
|||||||
if err != nil {
|
if err != nil {
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
|
if err := db.applyMigration(ctx, conn, name, string(body)); err != nil {
|
||||||
tx, err := db.BeginTx(ctx, nil)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
if _, err := tx.ExecContext(ctx, string(body)); err != nil {
|
|
||||||
tx.Rollback()
|
|
||||||
return fmt.Errorf("migration %s: %w", name, err)
|
|
||||||
}
|
|
||||||
if _, err := tx.ExecContext(ctx,
|
|
||||||
`INSERT INTO schema_migrations (name, applied_at) VALUES (?, unixepoch())`, name); err != nil {
|
|
||||||
tx.Rollback()
|
|
||||||
return fmt.Errorf("record migration %s: %w", name, err)
|
|
||||||
}
|
|
||||||
if err := tx.Commit(); err != nil {
|
|
||||||
return fmt.Errorf("commit migration %s: %w", name, err)
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
return nil
|
return nil
|
||||||
}
|
}
|
||||||
|
|
||||||
|
func (db *DB) applyMigration(ctx context.Context, conn *sql.Conn, name, body string) error {
|
||||||
|
if strings.Contains(body, rebuildMarker) {
|
||||||
|
if _, err := conn.ExecContext(ctx, `PRAGMA foreign_keys = OFF`); err != nil {
|
||||||
|
return fmt.Errorf("migration %s: disable foreign keys: %w", name, err)
|
||||||
|
}
|
||||||
|
// Back on whatever happens below: this connection goes back to the pool.
|
||||||
|
defer conn.ExecContext(ctx, `PRAGMA foreign_keys = ON`)
|
||||||
|
}
|
||||||
|
|
||||||
|
tx, err := conn.BeginTx(ctx, nil)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
if _, err := tx.ExecContext(ctx, body); err != nil {
|
||||||
|
tx.Rollback()
|
||||||
|
return fmt.Errorf("migration %s: %w", name, err)
|
||||||
|
}
|
||||||
|
if strings.Contains(body, rebuildMarker) {
|
||||||
|
if err := foreignKeyCheck(ctx, tx); err != nil {
|
||||||
|
tx.Rollback()
|
||||||
|
return fmt.Errorf("migration %s: %w", name, err)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if _, err := tx.ExecContext(ctx,
|
||||||
|
`INSERT INTO schema_migrations (name, applied_at) VALUES (?, unixepoch())`, name); err != nil {
|
||||||
|
tx.Rollback()
|
||||||
|
return fmt.Errorf("record migration %s: %w", name, err)
|
||||||
|
}
|
||||||
|
if err := tx.Commit(); err != nil {
|
||||||
|
return fmt.Errorf("commit migration %s: %w", name, err)
|
||||||
|
}
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// foreignKeyCheck reports the first row that references something that is not
|
||||||
|
// there. It names the table and the rowid, because a rebuild that drops rows on the
|
||||||
|
// floor is otherwise indistinguishable from one that worked.
|
||||||
|
func foreignKeyCheck(ctx context.Context, tx *sql.Tx) error {
|
||||||
|
rows, err := tx.QueryContext(ctx, `PRAGMA foreign_key_check`)
|
||||||
|
if err != nil {
|
||||||
|
return fmt.Errorf("foreign key check: %w", err)
|
||||||
|
}
|
||||||
|
defer rows.Close()
|
||||||
|
if rows.Next() {
|
||||||
|
var table, parent string
|
||||||
|
var rowid sql.NullInt64
|
||||||
|
var fkid int
|
||||||
|
if err := rows.Scan(&table, &rowid, &parent, &fkid); err != nil {
|
||||||
|
return fmt.Errorf("foreign key check: %w", err)
|
||||||
|
}
|
||||||
|
return fmt.Errorf("foreign key check: %s row %d references a missing %s",
|
||||||
|
table, rowid.Int64, parent)
|
||||||
|
}
|
||||||
|
return rows.Err()
|
||||||
|
}
|
||||||
|
|
||||||
// Tx runs fn inside a transaction, rolling back on error or panic.
|
// Tx runs fn inside a transaction, rolling back on error or panic.
|
||||||
func (db *DB) Tx(ctx context.Context, fn func(*sql.Tx) error) error {
|
func (db *DB) Tx(ctx context.Context, fn func(*sql.Tx) error) error {
|
||||||
tx, err := db.BeginTx(ctx, nil)
|
tx, err := db.BeginTx(ctx, nil)
|
||||||
|
|||||||
@@ -2,9 +2,13 @@ package store
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"context"
|
"context"
|
||||||
|
"database/sql"
|
||||||
"fmt"
|
"fmt"
|
||||||
|
"io/fs"
|
||||||
"path/filepath"
|
"path/filepath"
|
||||||
|
"sort"
|
||||||
"testing"
|
"testing"
|
||||||
|
"time"
|
||||||
)
|
)
|
||||||
|
|
||||||
// openTest gives each test its own database file. In-memory SQLite would be faster,
|
// openTest gives each test its own database file. In-memory SQLite would be faster,
|
||||||
@@ -410,3 +414,213 @@ func ftsCount(t *testing.T, db *DB, query string) int {
|
|||||||
}
|
}
|
||||||
return n
|
return n
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// The rebuild in 0008 is the one migration that does not just add: it copies the
|
||||||
|
// tasks table, drops the original and renames the copy back. Every test above this
|
||||||
|
// one starts from an empty database, where a rebuild that loses rows looks exactly
|
||||||
|
// like a rebuild that works — so this one carries data across it.
|
||||||
|
//
|
||||||
|
// What can go wrong, in the order it would: the drop cascades and takes the child
|
||||||
|
// rows with it; the copy misses a column; the FTS index is left keyed on rowids the
|
||||||
|
// rebuilt table no longer hands out; and finally the thing the migration is for,
|
||||||
|
// which is that deleting an account stops deleting other people's work.
|
||||||
|
func TestTheTasksRebuildCarriesTheDataAcross(t *testing.T) {
|
||||||
|
ctx := context.Background()
|
||||||
|
path := filepath.Join(t.TempDir(), "upgrade.db")
|
||||||
|
|
||||||
|
// A database at 0007: the schema as it shipped in v0.10.2.
|
||||||
|
sqlDB, err := sql.Open("sqlite", dsn(path))
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("open: %v", err)
|
||||||
|
}
|
||||||
|
defer sqlDB.Close()
|
||||||
|
if _, err := sqlDB.ExecContext(ctx, `
|
||||||
|
CREATE TABLE IF NOT EXISTS schema_migrations (
|
||||||
|
name TEXT PRIMARY KEY,
|
||||||
|
applied_at INTEGER NOT NULL
|
||||||
|
)`); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
entries, err := fs.Glob(migrationFS, "migrations/*.sql")
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
sort.Strings(entries)
|
||||||
|
for _, entry := range entries {
|
||||||
|
name := filepath.Base(entry)
|
||||||
|
if name >= "0008" {
|
||||||
|
break
|
||||||
|
}
|
||||||
|
body, err := migrationFS.ReadFile(entry)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if _, err := sqlDB.ExecContext(ctx, string(body)); err != nil {
|
||||||
|
t.Fatalf("apply %s: %v", name, err)
|
||||||
|
}
|
||||||
|
if _, err := sqlDB.ExecContext(ctx,
|
||||||
|
`INSERT INTO schema_migrations (name, applied_at) VALUES (?, unixepoch())`, name); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Two people, one project each, and a task in each project written by the
|
||||||
|
// other — which is the shape the migration exists for. Plus a label, a comment
|
||||||
|
// and a sub-task, so the child tables have something to lose.
|
||||||
|
now := time.Now().Unix()
|
||||||
|
for _, stmt := range []string{
|
||||||
|
`INSERT INTO users (id, email, name, password_hash, avatar_color, is_admin, created_at, updated_at)
|
||||||
|
VALUES ('u1', 'en@example.dk', 'En', 'x', 'graphite', 1, ` + fmt.Sprint(now) + `, ` + fmt.Sprint(now) + `),
|
||||||
|
('u2', 'to@example.dk', 'To', 'x', 'graphite', 0, ` + fmt.Sprint(now) + `, ` + fmt.Sprint(now) + `)`,
|
||||||
|
`INSERT INTO projects (id, owner_id, name, color, created_at, updated_at)
|
||||||
|
VALUES ('p1', 'u1', 'Ens', 'graphite', ` + fmt.Sprint(now) + `, ` + fmt.Sprint(now) + `),
|
||||||
|
('p2', 'u2', 'Tos', 'graphite', ` + fmt.Sprint(now) + `, ` + fmt.Sprint(now) + `)`,
|
||||||
|
`INSERT INTO tasks (id, project_id, content, description, created_by, priority, sort_order, created_at, updated_at)
|
||||||
|
VALUES ('t1', 'p1', 'grøn hæk', 'i ens eget', 'u1', 2, 1.0, ` + fmt.Sprint(now) + `, ` + fmt.Sprint(now) + `),
|
||||||
|
('t2', 'p2', 'skrevet af en anden', '', 'u1', 4, 2.0, ` + fmt.Sprint(now) + `, ` + fmt.Sprint(now) + `)`,
|
||||||
|
`INSERT INTO tasks (id, project_id, parent_id, content, created_by, sort_order, created_at, updated_at)
|
||||||
|
VALUES ('t3', 'p1', 't1', 'undertask', 'u1', 3.0, ` + fmt.Sprint(now) + `, ` + fmt.Sprint(now) + `)`,
|
||||||
|
`INSERT INTO labels (id, user_id, name, created_at) VALUES ('l1', 'u1', 'have', ` + fmt.Sprint(now) + `)`,
|
||||||
|
`INSERT INTO task_labels (task_id, label_id) VALUES ('t1', 'l1')`,
|
||||||
|
`INSERT INTO comments (id, task_id, user_id, body, created_at, updated_at)
|
||||||
|
VALUES ('c1', 't1', 'u1', 'en kommentar', ` + fmt.Sprint(now) + `, ` + fmt.Sprint(now) + `)`,
|
||||||
|
// 0009 rebuilds activity and 0012 rebuilds attachments, so both need rows
|
||||||
|
// here: a rebuild that drops them looks exactly like one that works.
|
||||||
|
`INSERT INTO activity (id, project_id, task_id, user_id, event, payload_json, created_at)
|
||||||
|
VALUES ('a1', 'p1', 't1', 'u1', 'task.created', '{}', ` + fmt.Sprint(now) + `),
|
||||||
|
('a2', 'p2', NULL, 'u1', 'project.created', '{}', ` + fmt.Sprint(now) + `)`,
|
||||||
|
`INSERT INTO attachments (id, task_id, filename, mime_type, size, path, uploaded_by, created_at)
|
||||||
|
VALUES ('f1', 't1', 'tegning.pdf', 'application/pdf', 1024, 'ab/cd/abcd', 'u1', ` + fmt.Sprint(now) + `)`,
|
||||||
|
`INSERT INTO project_groups (id, owner_id, name, color, collapsed, sort_order, created_at, updated_at)
|
||||||
|
VALUES ('g1', 'u1', 'Arbejde', 'graphite', 0, 1024, ` + fmt.Sprint(now) + `, ` + fmt.Sprint(now) + `)`,
|
||||||
|
} {
|
||||||
|
if _, err := sqlDB.ExecContext(ctx, stmt); err != nil {
|
||||||
|
t.Fatalf("seed: %v\n%s", err, stmt)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
sqlDB.Close()
|
||||||
|
|
||||||
|
// Now the upgrade, through the real runner.
|
||||||
|
db, err := Open(path)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("upgrade: %v", err)
|
||||||
|
}
|
||||||
|
defer db.Close()
|
||||||
|
|
||||||
|
var tasks, labels, comments int
|
||||||
|
if err := db.QueryRow(`SELECT count(*) FROM tasks`).Scan(&tasks); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if err := db.QueryRow(`SELECT count(*) FROM task_labels`).Scan(&labels); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if err := db.QueryRow(`SELECT count(*) FROM comments`).Scan(&comments); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if tasks != 3 || labels != 1 || comments != 1 {
|
||||||
|
t.Fatalf("after the rebuild: %d tasks, %d labels, %d comments — want 3, 1, 1. "+
|
||||||
|
"A drop that cascaded would look exactly like this", tasks, labels, comments)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 0009 and 0012 rebuild activity and attachments by the same machinery. They
|
||||||
|
// run against a live database on the next restart, and the thing that goes
|
||||||
|
// wrong in a rebuild is rows quietly not arriving.
|
||||||
|
var activity, attachments, groups int
|
||||||
|
if err := db.QueryRow(`SELECT count(*) FROM activity`).Scan(&activity); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if err := db.QueryRow(`SELECT count(*) FROM attachments`).Scan(&attachments); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if err := db.QueryRow(`SELECT count(*) FROM project_groups`).Scan(&groups); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if activity != 2 || attachments != 1 || groups != 1 {
|
||||||
|
t.Fatalf("after 0009 and 0012: %d activity rows, %d attachments, %d groups — want 2, 1, 1",
|
||||||
|
activity, attachments, groups)
|
||||||
|
}
|
||||||
|
|
||||||
|
// The attachment kept its parent and its bytes. A rebuild that lost the task_id
|
||||||
|
// leaves a row nothing can reach, which is worse than losing it outright.
|
||||||
|
var fileParent, filename string
|
||||||
|
if err := db.QueryRow(
|
||||||
|
`SELECT task_id, filename FROM attachments WHERE id = 'f1'`).Scan(&fileParent, &filename); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if fileParent != "t1" || filename != "tegning.pdf" {
|
||||||
|
t.Errorf("the attachment came across as %q on %q", filename, fileParent)
|
||||||
|
}
|
||||||
|
|
||||||
|
// And the new columns arrived with their defaults rather than as NULL, which is
|
||||||
|
// what an ALTER that forgot NOT NULL DEFAULT would give.
|
||||||
|
var groupAbout, sidebar string
|
||||||
|
if err := db.QueryRow(`SELECT description FROM project_groups WHERE id = 'g1'`).Scan(&groupAbout); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if err := db.QueryRow(`SELECT sidebar_collapsed FROM users WHERE id = 'u1'`).Scan(&sidebar); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if groupAbout != "" || sidebar != "[]" {
|
||||||
|
t.Errorf("new columns on existing rows: description %q, sidebar_collapsed %q", groupAbout, sidebar)
|
||||||
|
}
|
||||||
|
|
||||||
|
// Every column came across, including the generated one and the sub-task's
|
||||||
|
// self-reference.
|
||||||
|
var content, description, parent string
|
||||||
|
var priority int
|
||||||
|
if err := db.QueryRow(
|
||||||
|
`SELECT content, description, priority FROM tasks WHERE id = 't1'`).
|
||||||
|
Scan(&content, &description, &priority); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if content != "grøn hæk" || description != "i ens eget" || priority != 2 {
|
||||||
|
t.Errorf("t1 came across as %q/%q/%d", content, description, priority)
|
||||||
|
}
|
||||||
|
if err := db.QueryRow(`SELECT parent_id FROM tasks WHERE id = 't3'`).Scan(&parent); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if parent != "t1" {
|
||||||
|
t.Errorf("the sub-task lost its parent: %q", parent)
|
||||||
|
}
|
||||||
|
|
||||||
|
// The FTS index was rebuilt against the new rowids. Searching the fold column
|
||||||
|
// is the sharpest check: it is generated, so a copy that skipped it would still
|
||||||
|
// have the row and not the index entry.
|
||||||
|
for _, q := range []string{"grøn", "gron", "haek"} {
|
||||||
|
var n int
|
||||||
|
if err := db.QueryRow(`SELECT count(*) FROM tasks_fts WHERE tasks_fts MATCH ?`, q).Scan(&n); err != nil {
|
||||||
|
t.Fatalf("search %q: %v", q, err)
|
||||||
|
}
|
||||||
|
if n != 1 {
|
||||||
|
t.Errorf("search for %q found %d rows, want 1 — the index is keyed on rowids "+
|
||||||
|
"the rebuilt table no longer hands out", q, n)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// And the point of the whole thing.
|
||||||
|
if err := db.DeleteUser(ctx, "u1"); err != nil {
|
||||||
|
t.Fatalf("delete user: %v", err)
|
||||||
|
}
|
||||||
|
var survived int
|
||||||
|
if err := db.QueryRow(`SELECT count(*) FROM tasks WHERE id = 't2'`).Scan(&survived); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if survived != 1 {
|
||||||
|
t.Fatal("a task written in somebody else's project went with the account")
|
||||||
|
}
|
||||||
|
var author sql.NullString
|
||||||
|
if err := db.QueryRow(`SELECT created_by FROM tasks WHERE id = 't2'`).Scan(&author); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if author.Valid {
|
||||||
|
t.Errorf("created_by = %q, want null", author.String)
|
||||||
|
}
|
||||||
|
// Their own project still goes, and everything in it with it.
|
||||||
|
var own int
|
||||||
|
if err := db.QueryRow(`SELECT count(*) FROM tasks WHERE project_id = 'p1'`).Scan(&own); err != nil {
|
||||||
|
t.Fatal(err)
|
||||||
|
}
|
||||||
|
if own != 0 {
|
||||||
|
t.Errorf("%d tasks survived in the deleted account's own project", own)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
@@ -29,11 +29,23 @@ type Task struct {
|
|||||||
AssigneeID string
|
AssigneeID string
|
||||||
CompletedAt *time.Time
|
CompletedAt *time.Time
|
||||||
CompletedBy string
|
CompletedBy string
|
||||||
CreatedBy string
|
// CreatedBy is empty when the author's account has been deleted: `created_by`
|
||||||
SortOrder float64
|
// is ON DELETE SET NULL so the task survives the person who wrote it.
|
||||||
Labels []string
|
CreatedBy string
|
||||||
CreatedAt time.Time
|
SortOrder float64
|
||||||
UpdatedAt time.Time
|
// SubtaskCount and SubtaskDone are what a row can say without being opened:
|
||||||
|
// that there is something underneath it, and how much of it is left. Counted
|
||||||
|
// for every task in a list, in the same query — a hundred extra lookups to draw
|
||||||
|
// a badge is not a badge worth having.
|
||||||
|
SubtaskCount int
|
||||||
|
SubtaskDone int
|
||||||
|
// AttachmentCount is the same idea for files. A task with a drawing on it looks
|
||||||
|
// exactly like one without, and the whole reason to attach something is that
|
||||||
|
// somebody should find it.
|
||||||
|
AttachmentCount int
|
||||||
|
Labels []string
|
||||||
|
CreatedAt time.Time
|
||||||
|
UpdatedAt time.Time
|
||||||
}
|
}
|
||||||
|
|
||||||
func (t *Task) Completed() bool { return t.CompletedAt != nil }
|
func (t *Task) Completed() bool { return t.CompletedAt != nil }
|
||||||
@@ -173,11 +185,11 @@ func (db *DB) ListTasks(ctx context.Context, userID string, f TaskFilter) ([]Tas
|
|||||||
SELECT t.id, t.project_id, t.section_id, t.parent_id, t.content, t.description,
|
SELECT t.id, t.project_id, t.section_id, t.parent_id, t.content, t.description,
|
||||||
t.priority, t.due_date, t.due_datetime, t.due_timezone, t.duration_min,
|
t.priority, t.due_date, t.due_datetime, t.due_timezone, t.duration_min,
|
||||||
t.recurrence_rule, t.assignee_id, t.completed_at, t.completed_by,
|
t.recurrence_rule, t.assignee_id, t.completed_at, t.completed_by,
|
||||||
t.created_by, t.sort_order, t.created_at, t.updated_at
|
t.created_by, t.sort_order, t.created_at, t.updated_at,` + taskCounts + `
|
||||||
FROM tasks t
|
FROM tasks t
|
||||||
JOIN projects p ON p.id = t.project_id
|
JOIN projects p ON p.id = t.project_id
|
||||||
WHERE ` + strings.Join(where, " AND ") + `
|
WHERE ` + strings.Join(where, " AND ") + `
|
||||||
ORDER BY t.due_date IS NULL, t.due_date, t.priority, t.sort_order, t.created_at`
|
ORDER BY ` + order(f)
|
||||||
|
|
||||||
if f.Limit > 0 {
|
if f.Limit > 0 {
|
||||||
query += ` LIMIT ?`
|
query += ` LIMIT ?`
|
||||||
@@ -264,11 +276,11 @@ func (db *DB) GetTask(ctx context.Context, taskID, userID string) (*Task, error)
|
|||||||
return nil, err
|
return nil, err
|
||||||
}
|
}
|
||||||
rows, err := db.QueryContext(ctx, `
|
rows, err := db.QueryContext(ctx, `
|
||||||
SELECT id, project_id, section_id, parent_id, content, description,
|
SELECT t.id, t.project_id, t.section_id, t.parent_id, t.content, t.description,
|
||||||
priority, due_date, due_datetime, due_timezone, duration_min,
|
t.priority, t.due_date, t.due_datetime, t.due_timezone, t.duration_min,
|
||||||
recurrence_rule, assignee_id, completed_at, completed_by,
|
t.recurrence_rule, t.assignee_id, t.completed_at, t.completed_by,
|
||||||
created_by, sort_order, created_at, updated_at
|
t.created_by, t.sort_order, t.created_at, t.updated_at,`+taskCounts+`
|
||||||
FROM tasks WHERE id = ? AND deleted_at IS NULL`, taskID)
|
FROM tasks t WHERE t.id = ? AND t.deleted_at IS NULL`, taskID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return nil, err
|
return nil, err
|
||||||
}
|
}
|
||||||
@@ -317,9 +329,42 @@ func (db *DB) taskLabels(ctx context.Context, taskID string) ([]string, error) {
|
|||||||
return out, rows.Err()
|
return out, rows.Err()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// taskCounts are what a row can say about itself without being opened.
|
||||||
|
//
|
||||||
|
// Correlated subqueries rather than a second round of lookups: a list of fifty
|
||||||
|
// tasks would otherwise be a hundred more queries, and the whole point is that a
|
||||||
|
// row shows this without anybody asking for it. `idx_tasks_parent` covers the
|
||||||
|
// first two; the attachment count is a small table with a task_id on it.
|
||||||
|
//
|
||||||
|
// Sub-tasks are counted whether they are open or closed, and the finished ones
|
||||||
|
// again separately, because "3" and "1 of 3" are different sentences and only the
|
||||||
|
// second one says whether there is anything left to do.
|
||||||
|
const taskCounts = `
|
||||||
|
(SELECT count(*) FROM tasks c
|
||||||
|
WHERE c.parent_id = t.id AND c.deleted_at IS NULL),
|
||||||
|
(SELECT count(*) FROM tasks c
|
||||||
|
WHERE c.parent_id = t.id AND c.deleted_at IS NULL AND c.completed_at IS NOT NULL),
|
||||||
|
(SELECT count(*) FROM attachments a WHERE a.task_id = t.id)`
|
||||||
|
|
||||||
|
// order is how a list of tasks is sorted, which depends on what the list is for.
|
||||||
|
//
|
||||||
|
// A plan is read by when it is due and how urgent it is. A record of what has been
|
||||||
|
// finished is read backwards from now — "what did I just do" and "what did I close
|
||||||
|
// by mistake" are both questions about the most recent thing, and neither is
|
||||||
|
// answered by a due date the task no longer has.
|
||||||
|
func order(f TaskFilter) string {
|
||||||
|
if f.CompletedOnly {
|
||||||
|
return "t.completed_at DESC, t.id DESC"
|
||||||
|
}
|
||||||
|
return "t.due_date IS NULL, t.due_date, t.priority, t.sort_order, t.created_at"
|
||||||
|
}
|
||||||
|
|
||||||
func scanTask(rows *sql.Rows) (Task, error) {
|
func scanTask(rows *sql.Rows) (Task, error) {
|
||||||
var t Task
|
var t Task
|
||||||
var sectionID, parentID, dueDate, dueTZ, recurrence, assignee, completedBy sql.NullString
|
var sectionID, parentID, dueDate, dueTZ, recurrence, assignee, completedBy sql.NullString
|
||||||
|
// createdBy is null on a task whose author's account has been deleted. The work
|
||||||
|
// stays; it loses its author.
|
||||||
|
var createdBy sql.NullString
|
||||||
var dueDatetime, completedAt sql.NullInt64
|
var dueDatetime, completedAt sql.NullInt64
|
||||||
var duration sql.NullInt64
|
var duration sql.NullInt64
|
||||||
var created, updated int64
|
var created, updated int64
|
||||||
@@ -327,13 +372,15 @@ func scanTask(rows *sql.Rows) (Task, error) {
|
|||||||
err := rows.Scan(&t.ID, &t.ProjectID, §ionID, &parentID, &t.Content, &t.Description,
|
err := rows.Scan(&t.ID, &t.ProjectID, §ionID, &parentID, &t.Content, &t.Description,
|
||||||
&t.Priority, &dueDate, &dueDatetime, &dueTZ, &duration,
|
&t.Priority, &dueDate, &dueDatetime, &dueTZ, &duration,
|
||||||
&recurrence, &assignee, &completedAt, &completedBy,
|
&recurrence, &assignee, &completedAt, &completedBy,
|
||||||
&t.CreatedBy, &t.SortOrder, &created, &updated)
|
&createdBy, &t.SortOrder, &created, &updated,
|
||||||
|
&t.SubtaskCount, &t.SubtaskDone, &t.AttachmentCount)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return t, err
|
return t, err
|
||||||
}
|
}
|
||||||
|
|
||||||
t.SectionID = sectionID.String
|
t.SectionID = sectionID.String
|
||||||
t.ParentID = parentID.String
|
t.ParentID = parentID.String
|
||||||
|
t.CreatedBy = createdBy.String
|
||||||
t.DueDate = dueDate.String
|
t.DueDate = dueDate.String
|
||||||
t.DueTimezone = dueTZ.String
|
t.DueTimezone = dueTZ.String
|
||||||
t.RecurrenceRule = recurrence.String
|
t.RecurrenceRule = recurrence.String
|
||||||
@@ -384,7 +431,7 @@ func (db *DB) CreateTask(ctx context.Context, t *Task, labelNames []string) erro
|
|||||||
t.ID, t.ProjectID, nullString(t.SectionID), nullString(t.ParentID),
|
t.ID, t.ProjectID, nullString(t.SectionID), nullString(t.ParentID),
|
||||||
t.Content, t.Description, t.Priority, nullString(t.DueDate),
|
t.Content, t.Description, t.Priority, nullString(t.DueDate),
|
||||||
nullTime(t.DueDatetime), nullString(t.DueTimezone), nullInt(t.DurationMin),
|
nullTime(t.DueDatetime), nullString(t.DueTimezone), nullInt(t.DurationMin),
|
||||||
nullString(t.RecurrenceRule), nullString(t.AssigneeID), t.CreatedBy,
|
nullString(t.RecurrenceRule), nullString(t.AssigneeID), nullString(t.CreatedBy),
|
||||||
t.SortOrder, now.Unix(), now.Unix())
|
t.SortOrder, now.Unix(), now.Unix())
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return err
|
return err
|
||||||
|
|||||||
@@ -3,6 +3,7 @@ package store
|
|||||||
import (
|
import (
|
||||||
"context"
|
"context"
|
||||||
"database/sql"
|
"database/sql"
|
||||||
|
"encoding/json"
|
||||||
"errors"
|
"errors"
|
||||||
"fmt"
|
"fmt"
|
||||||
"strings"
|
"strings"
|
||||||
@@ -28,8 +29,15 @@ type User struct {
|
|||||||
Timezone string
|
Timezone string
|
||||||
Locale string
|
Locale string
|
||||||
IsAdmin bool
|
IsAdmin bool
|
||||||
CreatedAt time.Time
|
// SidebarCollapsed is the sidebar headings this person has folded away, by
|
||||||
UpdatedAt time.Time
|
// key. On the account rather than in localStorage, for the same reason a
|
||||||
|
// project group carries `collapsed` on its row: folding a heading is a
|
||||||
|
// statement about the work — "I am not in Etiketter at the moment" — and that
|
||||||
|
// is as true on the laptop as on the desktop. The sidebar's *width* is the
|
||||||
|
// opposite case and is stored per browser.
|
||||||
|
SidebarCollapsed []string
|
||||||
|
CreatedAt time.Time
|
||||||
|
UpdatedAt time.Time
|
||||||
}
|
}
|
||||||
|
|
||||||
// NormalizeEmail is the one place an address is canonicalised. Addresses arrive
|
// NormalizeEmail is the one place an address is canonicalised. Addresses arrive
|
||||||
@@ -96,7 +104,7 @@ func (db *DB) UserByID(ctx context.Context, id string) (*User, error) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
const userColumns = `id, email, name, password_hash, totp_secret, totp_enabled,
|
const userColumns = `id, email, name, password_hash, totp_secret, totp_enabled,
|
||||||
avatar_color, timezone, locale, is_admin, created_at, updated_at`
|
avatar_color, timezone, locale, is_admin, sidebar_collapsed, created_at, updated_at`
|
||||||
|
|
||||||
func (db *DB) scanUser(ctx context.Context, query string, args ...any) (*User, error) {
|
func (db *DB) scanUser(ctx context.Context, query string, args ...any) (*User, error) {
|
||||||
var u User
|
var u User
|
||||||
@@ -104,9 +112,11 @@ func (db *DB) scanUser(ctx context.Context, query string, args ...any) (*User, e
|
|||||||
var totpEnabled, isAdmin int
|
var totpEnabled, isAdmin int
|
||||||
var created, updated int64
|
var created, updated int64
|
||||||
|
|
||||||
|
var collapsed string
|
||||||
|
|
||||||
err := db.QueryRowContext(ctx, query, args...).Scan(
|
err := db.QueryRowContext(ctx, query, args...).Scan(
|
||||||
&u.ID, &u.Email, &u.Name, &u.PasswordHash, &secret, &totpEnabled,
|
&u.ID, &u.Email, &u.Name, &u.PasswordHash, &secret, &totpEnabled,
|
||||||
&u.AvatarColor, &u.Timezone, &u.Locale, &isAdmin, &created, &updated)
|
&u.AvatarColor, &u.Timezone, &u.Locale, &isAdmin, &collapsed, &created, &updated)
|
||||||
if errors.Is(err, sql.ErrNoRows) {
|
if errors.Is(err, sql.ErrNoRows) {
|
||||||
return nil, ErrNotFound
|
return nil, ErrNotFound
|
||||||
}
|
}
|
||||||
@@ -117,11 +127,41 @@ func (db *DB) scanUser(ctx context.Context, query string, args ...any) (*User, e
|
|||||||
u.TOTPSecret = secret.String
|
u.TOTPSecret = secret.String
|
||||||
u.TOTPEnabled = totpEnabled == 1
|
u.TOTPEnabled = totpEnabled == 1
|
||||||
u.IsAdmin = isAdmin == 1
|
u.IsAdmin = isAdmin == 1
|
||||||
|
// A malformed value is read as "nothing folded" rather than as an error: the
|
||||||
|
// worst case is a sidebar that opens fully, which is the state it shipped in.
|
||||||
|
u.SidebarCollapsed = []string{}
|
||||||
|
_ = json.Unmarshal([]byte(collapsed), &u.SidebarCollapsed)
|
||||||
u.CreatedAt = time.Unix(created, 0).UTC()
|
u.CreatedAt = time.Unix(created, 0).UTC()
|
||||||
u.UpdatedAt = time.Unix(updated, 0).UTC()
|
u.UpdatedAt = time.Unix(updated, 0).UTC()
|
||||||
return &u, nil
|
return &u, nil
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// SetSidebarCollapsed records which sidebar headings are folded.
|
||||||
|
//
|
||||||
|
// Its own method rather than a field on UpdateProfile: that one backs a form with
|
||||||
|
// a save button and validates three fields together, and this is a toggle that
|
||||||
|
// writes on every click. Sharing the path would mean a fold sending a name and a
|
||||||
|
// timezone it was never asked to change.
|
||||||
|
func (db *DB) SetSidebarCollapsed(ctx context.Context, userID string, sections []string) error {
|
||||||
|
if sections == nil {
|
||||||
|
sections = []string{}
|
||||||
|
}
|
||||||
|
raw, err := json.Marshal(sections)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
res, err := db.ExecContext(ctx,
|
||||||
|
`UPDATE users SET sidebar_collapsed = ?, updated_at = ? WHERE id = ?`,
|
||||||
|
string(raw), time.Now().Unix(), userID)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
if n, _ := res.RowsAffected(); n == 0 {
|
||||||
|
return ErrNotFound
|
||||||
|
}
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
// Person is the public half of a user: what somebody else is allowed to see when
|
// Person is the public half of a user: what somebody else is allowed to see when
|
||||||
// their name has to appear next to a task. No address, no hash, no timezone.
|
// their name has to appear next to a task. No address, no hash, no timezone.
|
||||||
type Person struct {
|
type Person struct {
|
||||||
@@ -175,12 +215,17 @@ type UserSummary struct {
|
|||||||
// ProjectCount excludes the Inbox: every account has one, so counting it would
|
// ProjectCount excludes the Inbox: every account has one, so counting it would
|
||||||
// make "1 project" mean "nothing".
|
// make "1 project" mean "nothing".
|
||||||
ProjectCount int
|
ProjectCount int
|
||||||
// TaskCount is everything a delete would destroy, which is not the same as
|
// TaskCount is everything a delete would destroy: the tasks in the projects
|
||||||
// "their tasks": it is the tasks in projects they own *plus* every task they
|
// they own, which go with those projects. Tasks they merely *wrote* in
|
||||||
// wrote anywhere, because tasks.created_by cascades. A number that counted
|
// somebody else's project are not counted, because they no longer go —
|
||||||
// only the first would understate the damage in exactly the case that matters
|
// `created_by` is ON DELETE SET NULL, so that work stays and loses its author.
|
||||||
// — a colleague leaving a shared project.
|
|
||||||
TaskCount int
|
TaskCount int
|
||||||
|
// AuthoredElsewhere is what a delete leaves behind unattributed: tasks they
|
||||||
|
// wrote in projects other people own. Separate from TaskCount because it is a
|
||||||
|
// different sentence — "this much disappears" and "this much stays without a
|
||||||
|
// name on it" — and running them together was what made the old number sound
|
||||||
|
// like a threat it no longer is.
|
||||||
|
AuthoredElsewhere int
|
||||||
}
|
}
|
||||||
|
|
||||||
// ListUsers returns every account on the instance. Administrators only — this is
|
// ListUsers returns every account on the instance. Administrators only — this is
|
||||||
@@ -192,8 +237,9 @@ func (db *DB) ListUsers(ctx context.Context) ([]UserSummary, error) {
|
|||||||
(SELECT count(*) FROM projects p
|
(SELECT count(*) FROM projects p
|
||||||
WHERE p.owner_id = u.id AND p.is_inbox = 0 AND p.deleted_at IS NULL),
|
WHERE p.owner_id = u.id AND p.is_inbox = 0 AND p.deleted_at IS NULL),
|
||||||
(SELECT count(*) FROM tasks t JOIN projects p ON p.id = t.project_id
|
(SELECT count(*) FROM tasks t JOIN projects p ON p.id = t.project_id
|
||||||
WHERE t.deleted_at IS NULL
|
WHERE t.deleted_at IS NULL AND p.owner_id = u.id),
|
||||||
AND (p.owner_id = u.id OR t.created_by = u.id))
|
(SELECT count(*) FROM tasks t JOIN projects p ON p.id = t.project_id
|
||||||
|
WHERE t.deleted_at IS NULL AND t.created_by = u.id AND p.owner_id <> u.id)
|
||||||
FROM users u
|
FROM users u
|
||||||
ORDER BY u.is_admin DESC, u.name`)
|
ORDER BY u.is_admin DESC, u.name`)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -207,7 +253,7 @@ func (db *DB) ListUsers(ctx context.Context) ([]UserSummary, error) {
|
|||||||
var isAdmin int
|
var isAdmin int
|
||||||
var created, lastSeen int64
|
var created, lastSeen int64
|
||||||
if err := rows.Scan(&s.ID, &s.Email, &s.Name, &s.AvatarColor, &isAdmin, &created,
|
if err := rows.Scan(&s.ID, &s.Email, &s.Name, &s.AvatarColor, &isAdmin, &created,
|
||||||
&lastSeen, &s.ProjectCount, &s.TaskCount); err != nil {
|
&lastSeen, &s.ProjectCount, &s.TaskCount, &s.AuthoredElsewhere); err != nil {
|
||||||
return nil, err
|
return nil, err
|
||||||
}
|
}
|
||||||
s.IsAdmin = isAdmin == 1
|
s.IsAdmin = isAdmin == 1
|
||||||
@@ -249,20 +295,18 @@ func (db *DB) SetUserAdmin(ctx context.Context, userID string, admin bool) error
|
|||||||
// there is no way back — which is why the handler sends the counts to the
|
// there is no way back — which is why the handler sends the counts to the
|
||||||
// interface first.
|
// interface first.
|
||||||
//
|
//
|
||||||
// What goes is wider than it looks. `projects.owner_id` cascades, so their
|
// What goes: `projects.owner_id` cascades, so their projects go and every task in
|
||||||
// projects go and every task in them goes too. But `tasks.created_by` cascades as
|
// them goes too. That is the whole of it, and the handler sends the count to the
|
||||||
// well, so **every task they ever wrote goes, including in projects somebody else
|
// interface first.
|
||||||
// owns**. Retiring a colleague's account therefore removes their contributions
|
|
||||||
// from shared projects rather than leaving them behind unattributed.
|
|
||||||
//
|
//
|
||||||
// That is the schema as it stands rather than a decision made here. Changing it —
|
// What stays: everything they wrote in somebody else's project. `tasks.created_by`
|
||||||
// `created_by` as ON DELETE SET NULL, so the work stays and loses its author —
|
// used to cascade as well, which meant retiring a colleague's account removed
|
||||||
// means rebuilding the tasks table, which carries the FTS triggers with it. Worth
|
// their contributions from shared work — see migration 0008, which rebuilt the
|
||||||
// doing; not worth doing quietly as part of adding a screen.
|
// table to make it ON DELETE SET NULL. The task survives and loses its author,
|
||||||
|
// which is the honest record of what happened.
|
||||||
//
|
//
|
||||||
// What survives: tasks merely *assigned* to them, which are unassigned by
|
// Tasks merely *assigned* to them are unassigned by `assignee_id ON DELETE SET
|
||||||
// `assignee_id ON DELETE SET NULL`, and completions, by the same rule on
|
// NULL`, and completions by the same rule on `completed_by`.
|
||||||
// `completed_by`.
|
|
||||||
func (db *DB) DeleteUser(ctx context.Context, userID string) error {
|
func (db *DB) DeleteUser(ctx context.Context, userID string) error {
|
||||||
res, err := db.ExecContext(ctx, `DELETE FROM users WHERE id = ?`, userID)
|
res, err := db.ExecContext(ctx, `DELETE FROM users WHERE id = ?`, userID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -274,6 +318,50 @@ func (db *DB) DeleteUser(ctx context.Context, userID string) error {
|
|||||||
return nil
|
return nil
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// ListPeople returns everybody the caller shares at least one project with, plus
|
||||||
|
// the caller.
|
||||||
|
//
|
||||||
|
// The set the interface needs to put a name on an `assignee_id` — in a task row,
|
||||||
|
// in a filter, anywhere a person appears next to work. Fetched once rather than
|
||||||
|
// looked up per row, and deliberately *not* the instance's user list: that is the
|
||||||
|
// administrator's page, and a task list has no business enumerating everybody with
|
||||||
|
// an account here.
|
||||||
|
//
|
||||||
|
// Themselves included, because a client comparing "is this me" against the same
|
||||||
|
// list it draws from has one source rather than two.
|
||||||
|
func (db *DB) ListPeople(ctx context.Context, userID string) ([]Person, error) {
|
||||||
|
rows, err := db.QueryContext(ctx, `
|
||||||
|
SELECT DISTINCT u.id, u.name, u.avatar_color
|
||||||
|
FROM users u
|
||||||
|
WHERE u.id = ?
|
||||||
|
-- the owners of projects the caller is a member of
|
||||||
|
OR u.id IN (SELECT p.owner_id FROM projects p
|
||||||
|
JOIN project_members m ON m.project_id = p.id
|
||||||
|
WHERE m.user_id = ? AND p.deleted_at IS NULL)
|
||||||
|
-- and the members of every project the caller can see
|
||||||
|
OR u.id IN (SELECT m2.user_id FROM project_members m2
|
||||||
|
JOIN projects p2 ON p2.id = m2.project_id
|
||||||
|
WHERE p2.deleted_at IS NULL
|
||||||
|
AND (p2.owner_id = ?
|
||||||
|
OR EXISTS (SELECT 1 FROM project_members m3
|
||||||
|
WHERE m3.project_id = p2.id AND m3.user_id = ?)))
|
||||||
|
ORDER BY u.name`, userID, userID, userID, userID)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
defer rows.Close()
|
||||||
|
|
||||||
|
people := []Person{}
|
||||||
|
for rows.Next() {
|
||||||
|
var p Person
|
||||||
|
if err := rows.Scan(&p.ID, &p.Name, &p.AvatarColor); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
people = append(people, p)
|
||||||
|
}
|
||||||
|
return people, rows.Err()
|
||||||
|
}
|
||||||
|
|
||||||
// UserCount is what decides whether the instance still needs its first admin.
|
// UserCount is what decides whether the instance still needs its first admin.
|
||||||
func (db *DB) UserCount(ctx context.Context) (int, error) {
|
func (db *DB) UserCount(ctx context.Context) (int, error) {
|
||||||
var n int
|
var n int
|
||||||
|
|||||||
@@ -78,6 +78,24 @@ gameskill:
|
|||||||
type: bool
|
type: bool
|
||||||
default: false
|
default: false
|
||||||
|
|
||||||
|
# Restarting from verdande's own settings, which is also how it picks up a new
|
||||||
|
# version: a container cannot replace its own image, so the panel recreates it
|
||||||
|
# and pulls :latest on the way. All three are needed together; the page names
|
||||||
|
# whichever are missing.
|
||||||
|
- key: VERDANDE_PANEL_URL
|
||||||
|
name: "Panel address, so verdande can ask to be restarted from its own settings"
|
||||||
|
type: string
|
||||||
|
default: ""
|
||||||
|
- key: VERDANDE_PANEL_TOKEN
|
||||||
|
name: "Panel API token — from an account with control of this server"
|
||||||
|
type: string
|
||||||
|
secret: true
|
||||||
|
default: ""
|
||||||
|
- key: VERDANDE_PANEL_SERVER_ID
|
||||||
|
name: "This server's id in the panel (the one in its URL)"
|
||||||
|
type: string
|
||||||
|
default: ""
|
||||||
|
|
||||||
install:
|
install:
|
||||||
# The image has no shell, so the install step borrows one. It only has to make
|
# The image has no shell, so the install step borrows one. It only has to make
|
||||||
# the directory layout exist; verdande creates and migrates its own database on
|
# the directory layout exist; verdande creates and migrates its own database on
|
||||||
|
|||||||
@@ -466,6 +466,46 @@
|
|||||||
/>
|
/>
|
||||||
<figcaption>The light theme.</figcaption>
|
<figcaption>The light theme.</figcaption>
|
||||||
</figure>
|
</figure>
|
||||||
|
<figure class="shot">
|
||||||
|
<img
|
||||||
|
src="screenshots/week.png"
|
||||||
|
alt="Upcoming as a single week: seven columns of days, each holding the tasks due that day."
|
||||||
|
width="1400"
|
||||||
|
height="900"
|
||||||
|
loading="lazy"
|
||||||
|
/>
|
||||||
|
<figcaption>A week at a time — so a task can be dragged across a month boundary.</figcaption>
|
||||||
|
</figure>
|
||||||
|
<figure class="shot">
|
||||||
|
<img
|
||||||
|
src="screenshots/detail.png"
|
||||||
|
alt="A task open in the detail drawer, with its description, due date, labels, sub-tasks and comments."
|
||||||
|
width="1400"
|
||||||
|
height="900"
|
||||||
|
loading="lazy"
|
||||||
|
/>
|
||||||
|
<figcaption>A task, opened.</figcaption>
|
||||||
|
</figure>
|
||||||
|
<figure class="shot">
|
||||||
|
<img
|
||||||
|
src="screenshots/themes.png"
|
||||||
|
alt="The settings page showing the five themes as swatches."
|
||||||
|
width="1400"
|
||||||
|
height="900"
|
||||||
|
loading="lazy"
|
||||||
|
/>
|
||||||
|
<figcaption>Five themes, all of them measured for contrast.</figcaption>
|
||||||
|
</figure>
|
||||||
|
<figure class="shot">
|
||||||
|
<img
|
||||||
|
src="screenshots/history.png"
|
||||||
|
alt="The instance-wide history page: who did what, in which project, filtered by person and event."
|
||||||
|
width="1400"
|
||||||
|
height="900"
|
||||||
|
loading="lazy"
|
||||||
|
/>
|
||||||
|
<figcaption>What has been done on the server, across every project.</figcaption>
|
||||||
|
</figure>
|
||||||
</div>
|
</div>
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
|
|||||||
|
After Width: | Height: | Size: 166 KiB |
|
Before Width: | Height: | Size: 56 KiB After Width: | Height: | Size: 181 KiB |
|
After Width: | Height: | Size: 91 KiB |
|
After Width: | Height: | Size: 228 KiB |
|
After Width: | Height: | Size: 243 KiB |
|
After Width: | Height: | Size: 176 KiB |
|
After Width: | Height: | Size: 230 KiB |
|
After Width: | Height: | Size: 199 KiB |
|
Before Width: | Height: | Size: 42 KiB After Width: | Height: | Size: 154 KiB |
|
Before Width: | Height: | Size: 42 KiB After Width: | Height: | Size: 153 KiB |
|
Before Width: | Height: | Size: 58 KiB After Width: | Height: | Size: 188 KiB |
|
After Width: | Height: | Size: 167 KiB |