dorfteich/apps/api/src
Claude Opus 4.8 621aa47244
Some checks failed
CI / Auth e2e pack (push) Waiting to run
CI / Import/export fidelity gate (push) Waiting to run
CI / Build container images (push) Waiting to run
CD / Build and push images (push) Failing after 1m33s
CD / Deploy to Test (push) Has been skipped
CD / Smoke tests against Test (push) Has been skipped
CD / Promote to Int (push) Has been skipped
CI / Lint, typecheck, test (push) Has been cancelled
Add plugin storage, install API, and directory watcher (#71)
Backend for installing plugin ZIPs (ADR 0008, plugin-architecture.md
§Lifecycle, security.md §Plugins). Consumes the #70 SDK for validation.

- Schema: `plugins` (id, name, version, apiVersion, kind, mode, manifest
  jsonb, removedAt soft-delete) + `pond_plugins` (per-pond activation) +
  `PluginInstanceMode` enum; migration 20260710130000_plugins.
- `PluginPackageService`: pure, stateless ZIP → validated package via
  fflate — structure check, manifest validation (SDK), apiVersion gate,
  kind/bundle/styles rules, CSS sanitation (no @import / external url() /
  expression()), zip-slip and unpacked-size guards. Each failure carries a
  stable PluginErrorCode; manifest issues travel as ApiError details.
- `PluginStorageService`: on-disk layout `<PLUGINS_DIR>/<id>/<version>/`;
  atomic writeVersion (staging dir + rename, no 404 window mid-update),
  removeVersion/removePlugin, traversal-safe asset resolution, dropzone +
  quarantine dirs.
- `PluginsService`: install/update (update only to a strictly higher
  version, preserving the admin's instance mode; files land before the
  metadata pointer flips) / uninstall (refused while required; soft-delete
  + files removed + pond activations dropped) / list / get.
- `POST/GET/DELETE /admin/plugins` (SiteAdminGuard, multer memory upload),
  error→HTTP-status mapping. Public version-pinned static serving at
  `GET /plugins/:id/:version/*rest` with immutable cache + nosniff, only for
  the installed current version.
- `PluginWatcherService`: watches `<PLUGINS_DIR>/_dropzone/`, runs the same
  validation, installs valid drops and quarantines invalid ones with the
  error logged; inert under NODE_ENV=test (tests drive processDropped).
- SDK: `compareVersions`/`isHigherVersion`. shared: `PluginView`,
  `PluginInstanceMode`, `PLUGIN_ERROR_CODES`, `PLUGINS_DIR` env, plugin
  error i18n (de+en). Compose: `plugins` volume + `PLUGINS_DIR`.
- Tests: package unit test (valid + each invalid class) and an e2e DB test
  (GUI install + immutable serving, non-admin 403, invalid-manifest details,
  dropzone install + quarantine, atomic higher-only update, required-guarded
  uninstall that removes files and tombstones metadata).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EwZ4jR4KFAPvpjWevfUGX1
2026-07-10 16:55:26 +02:00
..
admin Add Site-Admin user management (#59) 2026-07-10 00:31:41 +02:00
auth Add Site-Admin user management (#59) 2026-07-10 00:31:41 +02:00
common Add page trash: soft delete, restore, and purge job (#31) 2026-07-08 12:48:17 +02:00
compaction Fix compaction test Bytes typing for strict typecheck (#40) 2026-07-09 08:23:55 +02:00
config Add NestJS API skeleton with config, logging, and /healthz 2026-07-04 19:10:07 +02:00
files Add pond ZIP + per-page docx/odt export (#65) 2026-07-10 10:31:19 +02:00
grants Add effective-permissions inspector (#57) 2026-07-10 00:00:27 +02:00
health Add PDF export via Gotenberg (#67) 2026-07-10 12:11:12 +02:00
i18n Add mail outbox with SMTP delivery worker and templates 2026-07-05 00:46:12 +02:00
import-export Add import/export fidelity gate to CI (#69) 2026-07-10 13:59:10 +02:00
inspector Add effective-permissions inspector (#57) 2026-07-10 00:00:27 +02:00
labels Wire real permissions into collab tokens and revocation (#53) 2026-07-09 18:48:42 +02:00
links Enforce permissions in API guards and retire interim access (#52) 2026-07-09 16:31:41 +02:00
mail Add mail outbox with SMTP delivery worker and templates 2026-07-05 00:46:12 +02:00
members Add pond member management UI (#54) 2026-07-09 20:22:52 +02:00
pages Import .docx and .odt documents as new pages (#63) 2026-07-10 07:34:43 +02:00
permissions Wire real permissions into collab tokens and revocation (#53) 2026-07-09 18:48:42 +02:00
plugins Add plugin storage, install API, and directory watcher (#71) 2026-07-10 16:55:26 +02:00
ponds Add per-pond fonts: catalog, build, application, and admin UI (#66) 2026-07-10 11:16:29 +02:00
prisma Add Prisma with PostgreSQL, automatic migrations, and /readyz 2026-07-04 19:16:44 +02:00
public Add public read access and server-rendered page HTML (#56) 2026-07-09 23:46:25 +02:00
quotas Quota foundation: overrides, resolution, race-safe consumption (#22) 2026-07-05 20:55:59 +02:00
rate-limit Add DB-backed rate limiting with guard and decorator 2026-07-05 00:43:54 +02:00
scheduler Add page trash: soft delete, restore, and purge job (#31) 2026-07-08 12:48:17 +02:00
search Enforce permissions in API guards and retire interim access (#52) 2026-07-09 16:31:41 +02:00
settings Add non-image attachments with allowlist, SVG policy, and file managers (#61) 2026-07-10 02:52:40 +02:00
testing Add plugin storage, install API, and directory watcher (#71) 2026-07-10 16:55:26 +02:00
trash Enforce permissions in API guards and retire interim access (#52) 2026-07-09 16:31:41 +02:00
users Enforce permissions in API guards and retire interim access (#52) 2026-07-09 16:31:41 +02:00
versions Enforce permissions in API guards and retire interim access (#52) 2026-07-09 16:31:41 +02:00
app.module.ts Add plugin storage, install API, and directory watcher (#71) 2026-07-10 16:55:26 +02:00
main.ts Add page CRUD and Yjs state persistence (#23) 2026-07-05 22:25:41 +02:00