feat: Umbenennen, Fivemanage-Sprache, Freigabe-Links, sichtbare Zahlen

UMBENENNEN gab es gar nicht -- verschieben ja, umbenennen nirgends. Jetzt fuer
Datei und Ordner. Die WARNUNG ist dabei der eigentliche Teil: beim Verschieben
wandert eine Datei, beim Umbenennen aendert sich IHRE ADRESSE, und die steht
womoeglich in einem Skript, das niemand mehr im Kopf hat. Der Dialog zeigt
deshalb die Abrufzahl und beim Ordner die Zahl der betroffenen Dateien, BEVOR
gedrueckt wird -- eine Datei mit viertausend Abrufen umzubenennen ist etwas
anderes als eine mit null, und der Dienst ist die einzige Stelle, die den
Unterschied kennt.

Am echten Fall geprueft, dem Kollisionsfund: items/coiloverss.png (hielt die
+-Fassung) -> items/coiloverss-plus.png, alte Adresse 404, neue 200 mit 4375 B,
Vorschau mitgewandert. Ordner: probe -> beispiele, 5 Dateien, alle Pfade in
einer Transaktion umgeschrieben.

Ein Fallstrick dabei: thumbPath haengt ".webp" an. Fuer eine Datei richtig, fuer
einen ORDNER Unsinn -- der Vorschauordner heisst thumbs/vehicles und nicht
thumbs/vehicles.webp. Dafuer gibt es jetzt moveFolder.

DIE 93 KOLLISIONEN SIND ERLEDIGT. tools/kollisionen.ps1 rechnet dieselbe
Zaehmung auf der Quelle nach und zeigt, was zusammenfaellt -- es aendert nichts,
damit die Entscheidung auf Zahlen steht. Ergebnis: 91 von 93 sind dieselbe Datei
zweimal (WEAPON_SMG.png und weapon_smg.png, byteweise gleich gross), da fehlte
nichts. Echt verloren waren ZWEI, beide mit + im Namen. Beide nachgeholt.

FIVEMANAGE-SPRACHE. POST /api/image|video|audio (v1) und POST /api/v3/file (v3),
Schluessel nackt im Authorization-Kopf. Auf einem laufenden Server stecken die
Fivemanage-Aufrufe in einem Dutzend fremder Ressourcen; sie alle umzuschreiben
tut niemand, und deshalb bliebe dieser Dienst ungenutzt daneben stehen. So ist
der Umzug eine Zeile je Skript: die Adresse.

Beide Formen sind AUS ECHTEM CODE abgelesen und nicht geraten -- fivemanage/sdk
fuer v3, Awleks/Devm-Camera fuer den aelteren Weg ueber screenshot-basic.
Gemessen: v1 -> {url,id,path}, v3 -> {status:"ok",data:{id,url}}, ohne
Schluessel 401, ein Video an /api/image -> 415 mit Grund.

Dabei bin ich in eine Falle gelaufen, vor der im eigenen Repo ein Kommentar
warnt: die Token-Wache hing an use('*'), und der Einhaengepunkt ist /api -- also
galt sie auch fuer /api/dash daneben. Das Dashboard bekam 401 auf die ANMELDUNG.
Wortwoertlich derselbe Fehler steht in upload.ts als Kommentar, weil er dort
schon einmal passiert ist. Gemerkt hat es der Gegentest, nicht der Kopf.

FREIGABE-LINKS. /s/<schluessel> zeigt einen Ordner ohne Anmeldung. Was dabei
ausdruecklich dabeisteht, in der Karte und in der Rueckfrage vor dem
Zurueckziehen: FREIGEGEBEN WIRD DIE LISTE, NICHT DER INHALT. Die Dateien sind
ohnehin oeffentlich; ein zurueckgezogener Link macht sie nicht wieder privat, er
nimmt nur die Uebersicht weg. Ohne diesen Satz zieht jemand einen Link zurueck
und glaubt, etwas sei verschwunden.

Die Antwort ist abgemessen: Name, Groesse, Art, Adresse, Laenge. NICHT Hash,
Token, Zeitpunkte, Abrufzahlen, IDs -- nichts davon braucht, wer einen Katalog
ansieht, und jedes davon waere eine Auskunft ueber den Betrieb. Ein unbekannter
Schluessel und ein zurueckgezogener geben dieselbe Antwort.

ZAHLEN, DIE SCHON DA WAREN. Sortieren nach Abrufen und nach "zuletzt geholt";
die Kachel zeigt dann auch diese Zahl statt Groesse und Datum, denn nach etwas
zu ordnen, das man nirgends sieht, ist eine Reihenfolge ohne Begruendung. Und je
Token, was damit abgelegt wurde: media.token_id wird seit dem ersten Tag
geschrieben und war NIRGENDS zu sehen. Gemessen: d4rk_photostudio haelt 810
Dateien / 99,5 MB, 3640 liegen ohne Token da.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-11 22:53:22 +02:00
co-authored by Claude Opus 5
parent d125c6bf72
commit 44ad7dc6b3
22 changed files with 1843 additions and 19 deletions
+13 -3
View File
@@ -85,12 +85,22 @@ export function tokenHash(token: string): string {
* bekommt. */
export function tokenFromHeader(header: string | undefined): Token | null {
if (!header) return null
const match = /^Bearer\s+(.+)$/i.exec(header.trim())
if (!match?.[1]) return null
// "Bearer xyz" ODER nur "xyz" -- und das zweite ist nicht Bequemlichkeit,
// sondern Vertraeglichkeit: Fivemanage nimmt den Schluessel NACKT im
// Authorization-Kopf entgegen, und genau so steht er in jedem FiveM-Skript,
// das dorthin hochlaedt (nachgesehen im SDK und in Devm-Camera). Wer von
// dort umzieht, soll nur die Adresse tauschen muessen.
//
// Ein Risiko ist das keines: geprueft wird ohnehin der Hash gegen die
// Tabelle. Ein Kopf, der zu keinem Token gehoert, faellt so oder so durch.
const roh = header.trim()
const wert = /^Bearer\s+(.+)$/i.exec(roh)?.[1] ?? roh
if (!wert) return null
const row = db
.prepare('SELECT * FROM tokens WHERE hash = ?')
.get(tokenHash(match[1])) as Token | undefined
.get(tokenHash(wert)) as Token | undefined
if (!row) return null
db.prepare('UPDATE tokens SET last_used_at = ? WHERE id = ?').run(now(), row.id)
+34
View File
@@ -121,6 +121,30 @@ CREATE TABLE IF NOT EXISTS papierkorb (
);
CREATE INDEX IF NOT EXISTS papierkorb_zeit ON papierkorb(geloescht DESC);
-- Freigaben: ein Ordner, den man ohne Anmeldung ansehen kann.
--
-- WOZU. Die Dateien selbst sind ohnehin oeffentlich -- wer die Adresse kennt,
-- bekommt das Bild. Was NICHT oeffentlich ist, ist die LISTE: welche Bilder es
-- gibt. Genau die will man manchmal zeigen (ein Fahrzeugkatalog fuer Spieler)
-- und sonst nicht.
--
-- Der Schluessel ist eine Zufallszeichenkette in der Adresse und kein Passwort:
-- wer den Link hat, sieht die Liste. Das ist dieselbe Zusicherung wie bei einem
-- Nextcloud-Freigabelink, und sie steht so auch im Dashboard -- damit niemand
-- glaubt, hier haenge eine Anmeldung dran.
CREATE TABLE IF NOT EXISTS freigaben (
id INTEGER PRIMARY KEY,
schluessel TEXT NOT NULL UNIQUE,
ordner TEXT NOT NULL,
titel TEXT NOT NULL DEFAULT '',
created_at INTEGER NOT NULL,
-- Nicht "wie oft geoeffnet" als Selbstzweck: es beantwortet die Frage, ob
-- ein alter Link noch benutzt wird, bevor man ihn wegwirft.
aufrufe INTEGER NOT NULL DEFAULT 0,
zuletzt INTEGER
);
CREATE INDEX IF NOT EXISTS freigaben_ordner ON freigaben(ordner);
CREATE TABLE IF NOT EXISTS settings (
key TEXT PRIMARY KEY,
value TEXT NOT NULL,
@@ -284,6 +308,16 @@ export type Media = {
dauer: number | null
}
export type Freigabe = {
id: number
schluessel: string
ordner: string
titel: string
created_at: number
aufrufe: number
zuletzt: number | null
}
export type PapierkorbEintrag = {
id: number
path: string
+11
View File
@@ -32,6 +32,8 @@ import { pruneSessions, schreibeAbrufe, zaehleAbruf } from './db.js'
import { pruefeSicherung } from './meldung.js'
import { absolutePath, checkPath, lohntWebp, mimeFor, thumbPath, webpPfad } from './storage.js'
import { uploadRoutes } from './routes/upload.js'
import { fivemanageRoutes } from './routes/fivemanage.js'
import { freigabeRoutes } from './routes/freigabe.js'
import { dashRoutes, papierkorbAusleeren } from './routes/dash.js'
const app = new Hono()
@@ -209,8 +211,17 @@ app.use('*', async (c, next) => {
app.get('/health', (c) => c.json({ ok: true }))
app.route('/api', uploadRoutes)
// NACH uploadRoutes: unsere eigenen Wege haben Vorrang, falls je ein Name
// zusammenfaellt. Derzeit tut er das nicht (/upload, /exists, /media gegen
// /image, /video, /audio, /file, /v3/file), aber die Reihenfolge sagt, was
// gelten soll, wenn es einmal so kommt.
app.route('/api', fivemanageRoutes)
app.route('/api/dash', dashRoutes)
// Die Freigaben. OHNE Anmeldung und mit Absicht kurz: /s/<schluessel> laesst
// sich vorlesen und abtippen.
app.route('/api/s', freigabeRoutes)
app.get('/f/*', (c) => serveFile(c, c.req.path.slice(3)))
/** Die Vorschaubilder, unter /t/.
+233
View File
@@ -18,6 +18,7 @@ import {
pruneEvents,
pruneSessions,
type Media,
type Freigabe,
type MediaEvent,
type PapierkorbEintrag,
type Token,
@@ -49,6 +50,7 @@ import {
} from '../settings.js'
import { discordRoutes, redirectUri } from './discord.js'
import { MELDUNG_KEYS, meldungConfig, testMeldung } from '../meldung.js'
import { neuerSchluessel } from './freigabe.js'
import {
absolutePath,
checkPath,
@@ -60,6 +62,7 @@ import {
lohntWebp,
mimeFor,
moveFile,
moveFolder,
publicUrlFor,
safeFilename,
sha256,
@@ -362,6 +365,11 @@ dashRoutes.get('/media', (c) => {
angelegt: 'created_at',
pfad: 'path',
groesse: 'size',
// Gezaehlt wurde laengst, sortieren konnte man danach nicht -- eine
// Zahl, die man nicht ordnen kann, beantwortet die Frage "was wird
// eigentlich gebraucht" nur fuer die zehn im Speicherbericht.
abrufe: 'abrufe',
geholt: 'zuletzt_abgerufen',
}
const sortSpalte = SPALTEN[c.req.query('sort') ?? ''] ?? 'updated_at'
const richtung = c.req.query('dir') === 'auf' ? 'ASC' : 'DESC'
@@ -1413,6 +1421,138 @@ dashRoutes.post('/media/move', async (c) => {
return c.json({ verschoben: gut, fehlgeschlagen: ergebnisse.length - gut, ergebnisse })
})
/** Eine Datei umbenennen.
*
* Verschieben gab es, Umbenennen nicht -- und das ist genau derselbe Vorgang
* mit einem anderen letzten Stueck. Getrennt gehalten wird es trotzdem, weil
* die WARNUNG eine andere ist: beim Verschieben wandert eine Datei, beim
* Umbenennen aendert sich IHRE ADRESSE, und die steht womoeglich in einem
* Skript, das wir nicht sehen.
*
* DESHALB SAGT DIE ANTWORT, WAS DIE ALTE ADRESSE WAR und wie oft sie geholt
* wurde. Eine Datei mit 4000 Abrufen umzubenennen ist etwas anderes als eine
* mit null -- und der Dienst ist die einzige Stelle, die das weiss.
*
* Nur der NAME wird geaendert, nicht der Ordner. Wer beides will, benennt um
* und verschiebt; zwei sichtbare Schritte sind hier besser als einer, der
* beides kann und dabei unklar wird. */
dashRoutes.post('/media/umbenennen', async (c) => {
const body = await jsonBody<{ id?: number; name?: string }>(c)
if (!body) return c.json(KEIN_JSON, 400)
if (!body.id || !body.name?.trim()) return c.json({ error: 'id und name noetig' }, 400)
const row = db.prepare('SELECT * FROM media WHERE id = ?').get(body.id) as Media | undefined
if (!row) return c.json({ error: 'nicht gefunden' }, 404)
// Der Name kommt aus einem Formular und wird NICHT gezaehmt, sondern
// geprueft: wer hier umbenennt, weiss, welche Adresse er will. Ein
// stillschweigend zurechtgebogener Name waere schlimmer als eine
// Fehlermeldung -- man merkte es erst, wenn das Bild fehlt.
const name = body.name.trim()
if (name.includes('/')) {
return c.json({ error: 'Der Name darf keinen Schraegstrich enthalten — zum Verschieben gibt es "Verschieben".' }, 400)
}
const ordner = row.path.split('/').slice(0, -1).join('/')
let neu: string
try {
neu = checkPath(ordner ? `${ordner}/${name}` : name)
} catch (err) {
if (err instanceof PathError) return c.json({ error: err.message }, 400)
throw err
}
if (neu === row.path) return c.json({ error: 'heisst schon so' }, 400)
if (db.prepare('SELECT 1 FROM media WHERE path = ?').get(neu)) {
return c.json({ error: `${neu} ist belegt` }, 409)
}
await moveFile(row.path, neu)
db.prepare('UPDATE media SET path = ?, updated_at = ? WHERE id = ?').run(neu, now(), row.id)
logEvent('move', neu, row.size, 'user', c.get('user').username, row.path)
return c.json({ alt: row.path, neu, url: publicUrlFor(neu), abrufe: row.abrufe })
})
/** Einen Ordner umbenennen -- mit allem, was darin liegt.
*
* DAS IST DER GROSSE HEBEL und deshalb der vorsichtigere Weg: hier aendern
* sich auf einen Schlag hunderte Adressen. "items" nach "gegenstaende" zu
* benennen macht 3576 URLs ungueltig, und keine davon meldet sich.
*
* Die Datenbank wird in EINER Transaktion umgeschrieben. Nicht aus Eile: wenn
* auf halbem Weg etwas schiefgeht, zeigt sonst die Haelfte der Eintraege auf
* einen Ordner, den es nicht mehr gibt. Das Verschieben auf der Platte ist ein
* einziges `rename` und damit ohnehin unteilbar. */
dashRoutes.post('/folders/umbenennen', async (c) => {
const body = await jsonBody<{ pfad?: string; name?: string }>(c)
if (!body) return c.json(KEIN_JSON, 400)
if (!body.pfad?.trim() || !body.name?.trim()) {
return c.json({ error: 'pfad und name noetig' }, 400)
}
const name = body.name.trim()
if (name.includes('/')) {
return c.json({ error: 'Der Name darf keinen Schraegstrich enthalten' }, 400)
}
let alt: string
let neu: string
try {
alt = checkPath(body.pfad.trim().replace(/^\/+|\/+$/g, ''))
const oben = alt.split('/').slice(0, -1).join('/')
neu = checkPath(oben ? `${oben}/${name}` : name)
} catch (err) {
if (err instanceof PathError) return c.json({ error: err.message }, 400)
throw err
}
if (neu === alt) return c.json({ error: 'heisst schon so' }, 400)
// Der Zielordner darf nicht schon belegt sein -- weder in der Datenbank
// noch auf der Platte. Sonst schoebe `rename` den einen IN den anderen
// hinein, was etwas voellig anderes ist als umbenennen.
const maskiert = (s: string) => s.replace(/[\\%_]/g, (z) => `\\${z}`)
const drin = db
.prepare(`SELECT COUNT(*) AS n FROM media WHERE path LIKE ? ESCAPE '\\'`)
.get(`${maskiert(neu)}/%`) as { n: number }
if (drin.n > 0) return c.json({ error: `"${neu}" gibt es schon (${drin.n} Dateien)` }, 409)
try {
await stat(join(config.filesDir, neu))
return c.json({ error: `"${neu}" gibt es schon` }, 409)
} catch {
/* frei — weiter */
}
const betroffen = db
.prepare(`SELECT id, path, size FROM media WHERE path LIKE ? ESCAPE '\\'`)
.all(`${maskiert(alt)}/%`) as { id: number; path: string; size: number }[]
try {
await moveFolder(alt, neu)
} catch (err) {
return c.json(
{ error: `Verschieben fehlgeschlagen: ${err instanceof Error ? err.message : 'unbekannt'}` },
500,
)
}
const wer = c.get('user').username
const zeit = now()
const schreiben = db.prepare('UPDATE media SET path = ?, updated_at = ? WHERE id = ?')
db.transaction(() => {
for (const r of betroffen) {
schreiben.run(neu + r.path.slice(alt.length), zeit, r.id)
}
})()
// EIN Eintrag im Verlauf und nicht 3576. Wer nachliest, was passiert ist,
// will "items -> gegenstaende" lesen und nicht dreitausend Zeilen davon.
logEvent('move', neu, 0, 'user', wer, alt)
return c.json({ alt, neu, dateien: betroffen.length })
})
/** Einen leeren Ordner anlegen.
*
* Ordner entstehen hier sonst NEBENBEI: sie sind der Teil eines Pfades vor
@@ -1701,6 +1841,64 @@ dashRoutes.post('/papierkorb/leeren', async (c) => {
return c.json({ geleert: weg })
})
// ------------------------------------------------------------- Freigaben
//
// Was hier verwaltet wird, ist die LISTE eines Ordners -- die Dateien selbst
// sind ohnehin oeffentlich. Das steht auch in der Oberflaeche, damit niemand
// glaubt, eine Freigabe zu widerrufen mache seine Bilder wieder privat.
dashRoutes.get('/freigaben', (c) => {
const items = (
db.prepare('SELECT * FROM freigaben ORDER BY created_at DESC').all() as Freigabe[]
).map((f) => ({ ...f, url: `${config.publicUrl}/s/${f.schluessel}` }))
return c.json({ items })
})
dashRoutes.post('/freigaben', async (c) => {
const body = await jsonBody<{ ordner?: string; titel?: string }>(c)
if (!body?.ordner?.trim()) return c.json({ error: 'kein Ordner' }, 400)
let ordner: string
try {
ordner = checkPath(body.ordner.trim().replace(/^\/+|\/+$/g, ''))
} catch (err) {
if (err instanceof PathError) return c.json({ error: err.message }, 400)
throw err
}
// Einen Link auf einen Ordner anzulegen, den es nicht gibt, ergibt eine
// leere Seite und die Frage, woran es liegt. Lieber hier ablehnen.
const maskiert = ordner.replace(/[\\%_]/g, (z) => `\\${z}`)
const drin = db
.prepare(`SELECT COUNT(*) AS n FROM media WHERE path LIKE ? ESCAPE '\\'`)
.get(`${maskiert}/%`) as { n: number }
if (drin.n === 0) return c.json({ error: `In "${ordner}" liegt nichts.` }, 400)
const schluessel = neuerSchluessel()
const eintrag = db
.prepare(
`INSERT INTO freigaben (schluessel, ordner, titel, created_at)
VALUES (?, ?, ?, ?)`,
)
.run(schluessel, ordner, (body.titel ?? '').trim(), now())
logEvent('upload', ordner, 0, 'user', c.get('user').username)
return c.json({
id: Number(eintrag.lastInsertRowid),
schluessel,
ordner,
dateien: drin.n,
url: `${config.publicUrl}/s/${schluessel}`,
})
})
dashRoutes.delete('/freigaben/:id', (c) => {
const r = db.prepare('DELETE FROM freigaben WHERE id = ?').run(Number(c.req.param('id')))
if (r.changes === 0) return c.json({ error: 'nicht gefunden' }, 404)
return c.json({ ok: true })
})
dashRoutes.get('/speicher', (c) => {
const nachArt = Object.entries(ARTEN).map(([name, bedingung]) => {
const z = db
@@ -1783,6 +1981,26 @@ dashRoutes.get('/stats', (c) => {
// ------------------------------------------------------------------- Tokens
/** Was mit einem Token abgelegt wurde.
*
* `media.token_id` wird seit dem ersten Tag geschrieben und war bis hierhin
* NIRGENDS zu sehen. Dabei ist es die Auskunft, die vor dem Loeschen eines
* Tokens zaehlt: "dieser Token haelt 3576 Dateien" ist etwas anderes als
* "dieser Token ist ungenutzt".
*
* Der Dashboard-Upload traegt bewusst KEINEN Token (dort gibt es eine
* Sitzung), diese Dateien stehen deshalb unter `ohneToken`. */
function tokenNutzung(): Map<number, { dateien: number; bytes: number; letzte: number | null }> {
const zeilen = db
.prepare(
`SELECT token_id, COUNT(*) AS dateien, COALESCE(SUM(size),0) AS bytes,
MAX(created_at) AS letzte
FROM media WHERE token_id IS NOT NULL GROUP BY token_id`,
)
.all() as { token_id: number; dateien: number; bytes: number; letzte: number }[]
return new Map(zeilen.map((z) => [z.token_id, z]))
}
dashRoutes.get('/tokens', (c) => {
const rows = db
.prepare(
@@ -1791,6 +2009,14 @@ dashRoutes.get('/tokens', (c) => {
FROM tokens ORDER BY created_at DESC`,
)
.all() as Omit<Token, 'hash'>[]
const nutzung = tokenNutzung()
const ohneToken = db
.prepare(
'SELECT COUNT(*) AS dateien, COALESCE(SUM(size),0) AS bytes FROM media WHERE token_id IS NULL',
)
.get() as { dateien: number; bytes: number }
return c.json({
items: rows.map((r) => ({
...r,
@@ -1798,7 +2024,14 @@ dashRoutes.get('/tokens', (c) => {
// Oberflaeche: sonst steht in zwei Ansichten zweimal dieselbe
// Bedingung, und eine davon ist irgendwann falsch.
abgelaufen: Boolean(r.expires_at && r.expires_at < now()),
dateien: nutzung.get(r.id)?.dateien ?? 0,
bytes: nutzung.get(r.id)?.bytes ?? 0,
// `last_used_at` sagt, wann zuletzt jemand mit diesem Token
// ANGEKLOPFT hat -- auch bei einem Loeschversuch oder einem
// Fehlschlag. Das hier sagt, wann zuletzt etwas dabei HERAUSKAM.
zuletztAbgelegt: nutzung.get(r.id)?.letzte ?? null,
})),
ohneToken,
})
})
+337
View File
@@ -0,0 +1,337 @@
// Der Umzugsweg: sprechen wie Fivemanage.
//
// WOZU. Auf einem laufenden Server stecken die Fivemanage-Aufrufe in einem
// Dutzend Ressourcen -- Kamera, Handy, MDT, Fahrzeugstudio, jede mit ihrem
// eigenen Autor und ihrer eigenen Fassung. Sie alle auf unsere Schnittstelle
// umzuschreiben heisst: ein Dutzend fremde Skripte anfassen, jedes davon
// beim naechsten Update wieder. Das tut niemand, und deshalb bliebe der
// Dienst ungenutzt neben dem alten stehen.
//
// SPRICHT DER DIENST DAGEGEN IHRE SPRACHE, ist der Umzug EINE Zeile je Skript:
// die Adresse. Der Schluessel bleibt derselbe Kopf, die Antwort dieselbe Form.
//
// NACHGESEHEN, NICHT GERATEN. Beide Formen stammen aus echtem Code:
//
// v1 github.com/Awleks/Devm-Camera, client/client.lua:
// requestScreenshotUpload('https://api.fivemanage.com/api/image',
// 'image', { headers = { Authorization = apiKey } })
// -> die Antwort wird als resp.url gelesen
//
// v3 github.com/fivemanage/sdk, features/images/server/main.ts:
// POST https://api.fivemanage.com/api/v3/file
// Felder: file, metadata?, path?, filename?, retentionExempt?
// -> { status, data: { id, url } }
//
// Der Schluessel steht bei beiden NACKT im Authorization-Kopf, ohne "Bearer".
// Das nimmt tokenFromHeader inzwischen an.
import { Hono } from 'hono'
import type { Context, Next } from 'hono'
import { config } from '../config.js'
import { db, logEvent, now, type Media, type Token } from '../db.js'
import { tokenAllows, tokenFromHeader } from '../auth.js'
import {
checkPath,
kannBewegtVorschau,
kannVorschau,
lohntWebp,
mimeFor,
publicUrlFor,
safeFilename,
sha256,
writeBewegtThumb,
writeFileAtomic,
writeThumb,
writeWebp,
} from '../storage.js'
type Vars = { token: Token }
export const fivemanageRoutes = new Hono<{ Variables: Vars }>()
const wache = async (c: Context<{ Variables: Vars }>, next: Next) => {
const token = tokenFromHeader(c.req.header('authorization'))
if (!token) {
// Die Form der FEHLERANTWORT ist auch Teil der Vertraeglichkeit: ein
// Skript, das auf `status` prueft, soll hier nicht ins Leere greifen.
return c.json({ status: 'error', message: 'Token fehlt oder ist unbekannt' }, 401)
}
if (token.expires_at && token.expires_at < now()) {
return c.json({ status: 'error', message: 'Token ist abgelaufen' }, 401)
}
c.set('token', token)
await next()
}
// AN DIE EIGENEN PFADE, NICHT AN '*'.
//
// Mit '*' galt die Wache fuer alles unterhalb des Einhaengepunkts -- und der
// ist /api, also auch fuer /api/dash daneben. Das Dashboard bekam daraufhin
// 401 auf die ANMELDUNG, obwohl es nie einen Token haben kann.
//
// Wortwoertlich derselbe Fehler steht in upload.ts als Kommentar, weil er dort
// schon einmal passiert ist. Ich bin trotzdem hineingelaufen; gemerkt hat es
// der Gegentest, nicht der Kopf.
for (const weg of ['/image', '/video', '/audio', '/file', '/v3/file']) {
fivemanageRoutes.use(weg, wache)
}
/** Wo eine Datei landet, wenn der Aufrufer nichts sagt.
*
* UND SIE UEBERSCHREIBT NIE. Das ist der Unterschied zu /api/upload, wo der
* Pfad die Absicht ist: hier kommen Bildschirmfotos, die alle "screenshot.png"
* heissen. Ohne einen eigenen Namen je Aufruf ueberschriebe das zweite Foto
* das erste, und niemand merkte es -- der Aufrufer bekaeme sogar eine gueltige
* Adresse zurueck.
*
* Der Hash macht den Namen: gleicher Inhalt ergibt denselben Namen (zweimal
* dasselbe Bild kostet keinen zweiten Platz), verschiedener Inhalt einen
* anderen. Genau die Eigenschaft, die Fivemanages ID auch hat. */
function pfadFuer(token: Token, mime: string, digest: string, name?: string): string {
const basis = token.prefix ? token.prefix.replace(/\/+$/, '') : 'uploads'
const kurz = digest.slice(0, 12)
if (name) {
const sauber = safeFilename(name, kurz)
const punkt = sauber.lastIndexOf('.')
const stamm = punkt > 0 ? sauber.slice(0, punkt) : sauber
const endung = punkt > 0 ? sauber.slice(punkt + 1) : endungFuer(mime)
return `${basis}/${stamm}-${kurz}.${endung}`
}
return `${basis}/${kurz}.${endungFuer(mime)}`
}
const ENDUNGEN: Record<string, string> = {
'image/png': 'png',
'image/jpeg': 'jpg',
'image/webp': 'webp',
'image/gif': 'gif',
'video/mp4': 'mp4',
'video/webm': 'webm',
'audio/mpeg': 'mp3',
'audio/ogg': 'ogg',
'audio/wav': 'wav',
}
const endungFuer = (mime: string) => ENDUNGEN[mime.split(';')[0]?.trim().toLowerCase() ?? ''] ?? 'bin'
/** Die Datei aus dem Formular holen.
*
* DER FELDNAME IST NICHT FEST. screenshot-basic bekommt ihn als Argument
* uebergeben ('image' bei Devm-Camera), das SDK schickt 'file', und andere
* Skripte nehmen 'video' oder 'audio'. Ein Dienst, der nur eines davon
* annimmt, lehnt die Haelfte der Aufrufer mit "Feld fehlt" ab -- und der
* Aufrufer sucht den Fehler bei sich. */
const FELDER = ['file', 'image', 'video', 'audio', 'data', 'media'] as const
async function dateiAus(
c: Context<{ Variables: Vars }>,
): Promise<{ datei: File; pfad?: string; name?: string }> {
const typ = c.req.header('content-type') ?? ''
if (!typ.includes('multipart/form-data')) {
throw new Error('Erwartet wird multipart/form-data')
}
// parseBody und NICHT c.req.raw.formData(): letzteres nimmt Hono den Rumpf
// weg, und beim Aufraeumen schliesst dann jemand einen Strom, der schon zu
// ist. Das hat diesen Dienst schon einmal in eine Neustartschleife
// geschickt (siehe dash.ts).
const roh = await c.req.parseBody()
for (const feld of FELDER) {
const wert = roh[feld]
if (wert && typeof wert !== 'string') {
return {
datei: wert as unknown as File,
pfad: typeof roh['path'] === 'string' ? roh['path'] : undefined,
name: typeof roh['filename'] === 'string' ? roh['filename'] : undefined,
}
}
}
throw new Error(`Keine Datei dabei — erwartet wird eines der Felder: ${FELDER.join(', ')}`)
}
/** Was beim Ablegen herauskam: entweder die fertige Adresse, oder eine
* Antwort, die der Aufrufer so bekommen soll.
*
* Ein Entweder-Oder und kein "hat das Ergebnis ein status-Feld?" -- die
* Unterscheidung gehoert in den Typ und nicht in eine Ratefunktion. */
type Abgelegt =
| { ok: true; path: string; url: string; id: string }
| { ok: false; antwort: Response }
/** Der gemeinsame Weg. `art` schraenkt ein, was durchgeht -- /api/image nimmt
* eben nur Bilder, so wie es dort auch heisst. */
async function ablegen(
c: Context<{ Variables: Vars }>,
art?: 'image' | 'video' | 'audio',
): Promise<Abgelegt> {
const token = c.get('token')
let gefunden: Awaited<ReturnType<typeof dateiAus>>
try {
gefunden = await dateiAus(c)
} catch (err) {
return {
ok: false,
antwort: c.json(
{
status: 'error',
message: err instanceof Error ? err.message : 'Rumpf unlesbar',
},
400,
),
}
}
const { datei } = gefunden
const grenze = Math.min(config.maxUploadBytes, token.max_bytes ?? Number.MAX_SAFE_INTEGER)
if (datei.size > grenze) {
return {
ok: false,
antwort: c.json(
{ status: 'error', message: `zu gross: ${datei.size} > ${grenze} Bytes` },
413,
),
}
}
const data = Buffer.from(await datei.arrayBuffer())
if (data.length === 0) {
return { ok: false, antwort: c.json({ status: 'error', message: 'leere Datei' }, 400) }
}
const digest = sha256(data)
const gemeldet = (datei.type || '').split(';')[0]?.trim().toLowerCase() ?? ''
// Der Name entscheidet, wenn der Absender nur mit den Schultern zuckt --
// dieselbe Regel wie beim Dashboard-Upload.
const mime =
gemeldet && gemeldet !== 'application/octet-stream'
? gemeldet
: mimeFor(gefunden.name ?? datei.name ?? '')
if (art && !mime.startsWith(`${art}/`)) {
return {
ok: false,
antwort: c.json(
{
status: 'error',
message: `Hier gehen nur ${art}-Dateien hinein, das hier ist ${mime}`,
},
415,
),
}
}
// Ein ausdruecklicher Pfad (v3 kennt das Feld) hat Vorrang -- aber er wird
// geprueft wie jeder andere, nicht zurechtgebogen.
let path: string
try {
path = gefunden.pfad
? checkPath(gefunden.pfad.replace(/^\/+|\/+$/g, ''))
: checkPath(pfadFuer(token, mime, digest, gefunden.name ?? datei.name))
} catch (err) {
return {
ok: false,
antwort: c.json({ status: 'error', message: (err as Error).message }, 400),
}
}
if (!tokenAllows(token, path)) {
return {
ok: false,
antwort: c.json(
{
status: 'error',
message: `dieser Token darf nur unter "${token.prefix}/" schreiben`,
},
403,
),
}
}
if (token.arten) {
const erlaubt = token.arten.split(',').map((a) => a.trim()).filter(Boolean)
const meine = mime.startsWith('image/')
? 'bild'
: mime.startsWith('video/')
? 'video'
: mime.startsWith('audio/')
? 'ton'
: 'andere'
if (!erlaubt.includes(meine)) {
return {
ok: false,
antwort: c.json(
{
status: 'error',
message: `Dieser Token darf nur ${erlaubt.join(', ')} hochladen`,
},
403,
),
}
}
}
const vorhanden = db.prepare('SELECT * FROM media WHERE path = ?').get(path) as
| Media
| undefined
await writeFileAtomic(path, data)
if (kannVorschau(mime)) await writeThumb(path, data)
if (lohntWebp(mime)) await writeWebp(path, data)
let dauer: number | null = null
if (kannBewegtVorschau(mime)) dauer = (await writeBewegtThumb(path, mime)).dauer
const zeit = now()
if (vorhanden) {
db.prepare(
`UPDATE media SET size = ?, sha256 = ?, mime = ?, dauer = ?, token_id = ?, updated_at = ?
WHERE id = ?`,
).run(data.length, digest, mime, dauer, token.id, zeit, vorhanden.id)
} else {
db.prepare(
`INSERT INTO media (path, size, sha256, mime, dauer, token_id, created_at, updated_at)
VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
).run(path, data.length, digest, mime, dauer, token.id, zeit, zeit)
}
logEvent(vorhanden ? 'replace' : 'upload', path, data.length, 'token', token.name)
return { ok: true, path, url: publicUrlFor(path), id: digest.slice(0, 12) }
}
// ------------------------------------------------------------------ Die Wege
//
// v1: eine Adresse je Art, Antwort NUR { url, id }. Genau das liest
// Devm-Camera (resp.url), und genau das lesen die meisten aelteren
// Skripte. Zusaetzliche Felder schaden nicht, fehlende schon.
for (const [weg, art] of [
['/image', 'image'],
['/video', 'video'],
['/audio', 'audio'],
] as const) {
fivemanageRoutes.post(weg, async (c) => {
const r = await ablegen(c, art)
if (!r.ok) return r.antwort
return c.json({ url: r.url, id: r.id, path: r.path })
})
}
/** Ohne Einschraenkung der Art -- der Sammelweg. */
fivemanageRoutes.post('/file', async (c) => {
const r = await ablegen(c)
if (!r.ok) return r.antwort
return c.json({ url: r.url, id: r.id, path: r.path })
})
/** v3: dieselbe Arbeit, andere Verpackung.
*
* { status: "ok", data: { id, url } } -- so prueft es das SDK mit valibot,
* und ein fehlendes Feld laesst es die Antwort verwerfen. */
fivemanageRoutes.post('/v3/file', async (c) => {
const r = await ablegen(c)
if (!r.ok) return r.antwort
return c.json({ status: 'ok', data: { id: r.id, url: r.url } })
})
+83
View File
@@ -0,0 +1,83 @@
// Freigaben: einen Ordner ansehen, ohne sich anzumelden.
//
// WAS HIER WIRKLICH FREIGEGEBEN WIRD -- und das ist der Satz, den das Dashboard
// auch anzeigt: die DATEIEN sind ohnehin oeffentlich. Wer die Adresse eines
// Bildes kennt, bekommt es, mit oder ohne Freigabe. Neu ist die LISTE: welche
// Bilder es in einem Ordner gibt. Die war bisher nur hinter der Anmeldung zu
// haben.
//
// Der Schluessel in der Adresse ist KEIN Passwort. Wer den Link hat, sieht die
// Liste -- dieselbe Zusicherung wie bei einem Nextcloud-Freigabelink. Was hier
// NICHT geht: hochladen, loeschen, umbenennen, einen anderen Ordner sehen.
//
// Und was hier bewusst FEHLT: eine eigene Oberflaeche mit eigenem Aufbau. Die
// Freigabe liefert JSON, und die gebaute Oberflaeche zeigt es an -- eine zweite
// Galerie waere eine zweite, die beim naechsten Mal anders aussieht.
import { randomBytes } from 'node:crypto'
import { Hono } from 'hono'
import { db, now, type Freigabe, type Media } from '../db.js'
import { config } from '../config.js'
import { publicUrlFor } from '../storage.js'
export const freigabeRoutes = new Hono()
/** Der Schluessel: 16 Zeichen aus 32 moeglichen, also rund 80 Bit.
*
* Zu viel, um ihn zu raten, und kurz genug, um ihn vorzulesen. Ohne i, l, o
* und die Null -- ein Link, den jemand aus einem Bildschirmfoto abtippt, soll
* nicht an einer Verwechslung scheitern. */
const ZEICHEN = 'abcdefghjkmnpqrstuvwxyz23456789'
export function neuerSchluessel(): string {
const roh = randomBytes(16)
return Array.from(roh, (b) => ZEICHEN[b % ZEICHEN.length]).join('')
}
/** Die Liste eines freigegebenen Ordners.
*
* OHNE ANMELDUNG, und deshalb wird hier genau abgemessen, was hinausgeht:
* Pfad, Groesse, Art, Adresse, Laenge. NICHT: Hash, Token, Zeitpunkte,
* Abrufzahlen, IDs. Nichts davon braucht jemand, der einen Katalog ansieht,
* und jedes davon waere eine Auskunft ueber den Betrieb dieses Dienstes. */
freigabeRoutes.get('/:schluessel', (c) => {
const eintrag = db
.prepare('SELECT * FROM freigaben WHERE schluessel = ?')
.get(c.req.param('schluessel')) as Freigabe | undefined
// Dieselbe Antwort fuer "gibt es nicht" und "gab es mal": ein Unterschied
// waere eine Auskunft an jemanden, der Schluessel durchprobiert.
if (!eintrag) return c.json({ error: 'nicht gefunden' }, 404)
db.prepare('UPDATE freigaben SET aufrufe = aufrufe + 1, zuletzt = ? WHERE id = ?').run(
now(),
eintrag.id,
)
const maskiert = eintrag.ordner.replace(/[\\%_]/g, (z) => `\\${z}`)
const zeilen = db
.prepare(
`SELECT path, size, mime, dauer FROM media
WHERE path LIKE ? ESCAPE '\\' ORDER BY path COLLATE NOCASE LIMIT 2000`,
)
.all(`${maskiert}/%`) as Pick<Media, 'path' | 'size' | 'mime' | 'dauer'>[]
return c.json({
titel: eintrag.titel || eintrag.ordner,
ordner: eintrag.ordner,
// Der Praefix, den die Oberflaeche abschneidet -- damit dort
// "adder.webp" steht und nicht "vehicles/adder.webp". Wer den ganzen
// Pfad sehen will, sieht ihn in der Adresse.
anzahl: zeilen.length,
items: zeilen.map((r) => ({
name: r.path.slice(eintrag.ordner.length + 1),
size: r.size,
mime: r.mime,
dauer: r.dauer,
url: publicUrlFor(r.path),
// Die Vorschau liegt unter /t/ und braucht keine Anmeldung -- das
// war schon vorher so, sonst zeigte das Dashboard keine Kacheln.
thumb: `${config.publicUrl}/t/${r.path}`,
})),
})
})
+27
View File
@@ -505,6 +505,33 @@ export async function writeWebp(path: string, data: Buffer): Promise<number | nu
}
}
/** Einen ganzen Ordner an einen anderen Platz legen.
*
* NICHT dasselbe wie moveFile mit einem Ordner darin, und das ist ein
* Fallstrick, der beim Schreiben fast durchgerutscht waere: `thumbPath` haengt
* ".webp" an. Fuer eine Datei ist das richtig (vehicles/adder.png ->
* thumbs/vehicles/adder.png.webp), fuer einen ORDNER waere es Unsinn -- der
* Vorschauordner heisst thumbs/vehicles und nicht thumbs/vehicles.webp.
*
* Deshalb hier die Ordnerfassung: dieselben drei Baeume, aber ohne Endung. */
export async function moveFolder(von: string, nach: string): Promise<void> {
await mkdir(dirname(join(config.filesDir, nach)), { recursive: true })
await rename(join(config.filesDir, von), join(config.filesDir, nach))
for (const ordner of ['thumbs', 'webp']) {
try {
await mkdir(dirname(join(config.dataDir, ordner, nach)), { recursive: true })
await rename(
join(config.dataDir, ordner, von),
join(config.dataDir, ordner, nach),
)
} catch {
// Gibt es nicht — kein Fehler. Beides ist abgeleitet und laesst
// sich mit einem Knopf neu rechnen.
}
}
}
export async function deleteFile(path: string): Promise<void> {
await rm(absolutePath(path), { force: true })
// Vorschau und sparsame Fassung gehen mit. Sonst bleiben sie liegen, und