Files
AirCardIOS/deploy/api/appwrite.test.js
T
ClaudeandClaude Sonnet 5.5 dd1597862a feat(api): aircard-api für Veröffentlichen, Melden und Admin
Neuer abhängigkeitsfreier Node-22-Dienst in deploy/api/ (appwrite.js, app.js,
server.js), der alle Galerie-Schreibzugriffe mit dem Appwrite-Server-Key
ausführt: POST /api/veroeffentlichen, /zurueckziehen, /melden (Rate-Limit
10/h je Melder, IPv6 auf /64, Auto-Ausblenden ab 3), /admin/sichtbarkeit und
GET /api/gesundheit.

- JWT-Prüfung über GET /account (Header X-Aircard-Jwt), Admin = Label admin
- IDs per Muster geprüft, Pfadsegmente kodiert, "." und ".." abgelehnt
- deterministische Zeilen-IDs (Galerie, Meldung): Appwrite-409 ersetzt jede
  Doppelt-Prüfung; Sperre je Karte gegen verlorene Zählerstände
- Dateiprüfung: Bucket, delete("user:<ich>"), PNG/WebP, höchstens 5 MiB
- Appwrite-Aufrufe mit 10-s-Zeitlimit, Logs ohne Key, Salz, JWT und IPs
- Tests gegen einen Fake-Appwrite im Speicher (70 Tests), Compose-Service
  aircard-api (Router aircard-gallery-api) und README ergänzt

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-04 14:09:30 +00:00

212 lines
9.5 KiB
JavaScript

'use strict';
// Tests für deploy/api/appwrite.js gegen einen Fake-Appwrite im Speicher (fake-appwrite.js).
// Aufruf: node --test "deploy/api/*.test.js"
const { test, afterEach } = require('node:test');
const assert = require('node:assert/strict');
const { createAppwrite, AppwriteError, queryEqual, queryLimit } = require('./appwrite.js');
const { startFakeAppwrite } = require('./fake-appwrite.js');
const fakes = [];
afterEach(async () => {
for (const fake of fakes.splice(0)) await fake.close();
});
async function setup(options = {}) {
const fake = await startFakeAppwrite();
fakes.push(fake);
const appwrite = createAppwrite({ endpoint: fake.endpoint, project: fake.project, key: fake.key, ...options });
return { fake, appwrite };
}
const lastCall = (fake) => fake.calls[fake.calls.length - 1];
test('Zeilen: anlegen, lesen, ändern, löschen mit Projekt- und Key-Header', async () => {
const { fake, appwrite } = await setup();
const created = await appwrite.createRow('gallery', 'row1', { title: 'T', imageFileId: 'i', previewFileId: 'p', ownerId: 'o' }, ['read("any")']);
assert.equal(created.$id, 'row1');
assert.equal(lastCall(fake).method, 'POST');
assert.equal(lastCall(fake).path, '/v1/tablesdb/aircard/tables/gallery/rows');
assert.deepEqual(lastCall(fake).body, {
rowId: 'row1',
data: { title: 'T', imageFileId: 'i', previewFileId: 'p', ownerId: 'o' },
permissions: ['read("any")'],
});
assert.equal(lastCall(fake).headers['x-appwrite-project'], fake.project);
assert.equal(lastCall(fake).headers['x-appwrite-key'], fake.key);
assert.match(lastCall(fake).headers['content-type'], /^application\/json/);
assert.equal((await appwrite.getRow('gallery', 'row1')).title, 'T');
assert.equal(lastCall(fake).path, '/v1/tablesdb/aircard/tables/gallery/rows/row1');
await appwrite.updateRow('gallery', 'row1', { hidden: true });
assert.equal(lastCall(fake).method, 'PATCH');
assert.deepEqual(lastCall(fake).body, { data: { hidden: true } }, 'ohne permissions-Feld, wenn keine übergeben werden');
assert.deepEqual(fake.row('gallery', 'row1').$permissions, ['read("any")']);
await appwrite.updateRow('gallery', 'row1', { reportCount: 3 }, ['read("user:o")']);
assert.deepEqual(lastCall(fake).body, { data: { reportCount: 3 }, permissions: ['read("user:o")'] });
assert.deepEqual(fake.row('gallery', 'row1').$permissions, ['read("user:o")']);
assert.equal(await appwrite.deleteRow('gallery', 'row1'), true);
assert.equal(fake.row('gallery', 'row1'), null);
});
test('Fehlende Zeile/Datei: getRow und getFile liefern null, deleteRow/deleteFile/updateFilePermissions sind tolerant', async () => {
const { appwrite } = await setup();
assert.equal(await appwrite.getRow('gallery', 'nope'), null);
assert.equal(await appwrite.getFile('gallery-images', 'nope'), null);
assert.equal(await appwrite.deleteRow('gallery', 'nope'), false);
assert.equal(await appwrite.deleteFile('gallery-images', 'nope'), false);
assert.equal(await appwrite.updateFilePermissions('gallery-images', 'nope', ['read("any")']), null);
});
test('Doppelte Zeilen-ID wirft AppwriteError mit Status 409 und Typ row_already_exists', async () => {
const { appwrite } = await setup();
const data = { galleryId: 'g', reason: 'spam', reporterHash: 'h' };
await appwrite.createRow('reports', 'r1', data, []);
await assert.rejects(
() => appwrite.createRow('reports', 'r1', data, []),
(err) => err instanceof AppwriteError && err.status === 409 && err.type === 'row_already_exists',
);
});
test('Andere Fehler (400, 401, 500) werden als AppwriteError geworfen', async () => {
const { fake, appwrite } = await setup();
await assert.rejects(
() => appwrite.createRow('gallery', 'x', { title: 'x'.repeat(61), imageFileId: 'i', previewFileId: 'p', ownerId: 'o' }, []),
(err) => err instanceof AppwriteError && err.status === 400 && err.type === 'document_invalid_structure',
);
fake.failNext((call) => call.method === 'GET', { status: 500, type: 'general_server_error' });
await assert.rejects(
() => appwrite.getRow('gallery', 'x'),
(err) => err instanceof AppwriteError && err.status === 500,
);
const wrongKey = createAppwrite({ endpoint: fake.endpoint, project: fake.project, key: 'falscher-key' });
await assert.rejects(
() => wrongKey.getRow('gallery', 'x'),
(err) => err instanceof AppwriteError && err.status === 401,
);
});
test('listRows schickt die Queries als queries[]-Parameter und liefert die Zeilen', async () => {
const { fake, appwrite } = await setup();
for (const id of ['a', 'b', 'c']) {
await appwrite.createRow('reports', id, { galleryId: id === 'c' ? 'other' : 'g1', reason: 'spam', reporterHash: id }, []);
}
const rows = await appwrite.listRows('reports', [queryEqual('galleryId', ['g1']), queryLimit(100)]);
assert.deepEqual(rows.map((row) => row.$id).sort(), ['a', 'b']);
const { search } = lastCall(fake);
const params = search.split('&').map((part) => decodeURIComponent(part));
assert.deepEqual(params, [
'queries[]={"method":"equal","attribute":"galleryId","values":["g1"]}',
'queries[]={"method":"limit","values":[100]}',
]);
assert.equal(lastCall(fake).headers['x-appwrite-key'], fake.key);
});
test('queryEqual und queryLimit liefern Appwrite-JSON-Strings', () => {
assert.equal(queryEqual('galleryId', ['x']), '{"method":"equal","attribute":"galleryId","values":["x"]}');
assert.equal(queryLimit(100), '{"method":"limit","values":[100]}');
});
test('Dateien: lesen, Rechte setzen, löschen', async () => {
const { fake, appwrite } = await setup();
fake.addFile({ id: 'f1', owner: 'u1', mimeType: 'image/webp', size: 1234 });
const file = await appwrite.getFile('gallery-images', 'f1');
assert.equal(file.mimeType, 'image/webp');
assert.equal(file.sizeOriginal, 1234);
assert.equal(file.bucketId, 'gallery-images');
assert.deepEqual(file.$permissions, ['read("any")', 'delete("user:u1")']);
assert.equal(lastCall(fake).path, '/v1/storage/buckets/gallery-images/files/f1');
await appwrite.updateFilePermissions('gallery-images', 'f1', ['read("user:u1")']);
assert.equal(lastCall(fake).method, 'PUT');
assert.deepEqual(lastCall(fake).body, { permissions: ['read("user:u1")'] });
assert.deepEqual(fake.file('f1').$permissions, ['read("user:u1")']);
assert.equal(await appwrite.deleteFile('gallery-images', 'f1'), true);
assert.equal(fake.file('f1'), null);
});
test('accountFromJwt: JWT-Header ohne Key; 401 gibt null, andere Fehler werfen', async () => {
const { fake, appwrite } = await setup();
fake.addUser('aaa.bbb.ccc', { id: 'u1', labels: ['admin'] });
const user = await appwrite.accountFromJwt('aaa.bbb.ccc');
assert.equal(user.$id, 'u1');
assert.deepEqual(user.labels, ['admin']);
const call = lastCall(fake);
assert.equal(call.path, '/v1/account');
assert.equal(call.headers['x-appwrite-jwt'], 'aaa.bbb.ccc');
assert.equal(call.headers['x-appwrite-project'], fake.project);
assert.equal(call.headers['x-appwrite-key'], undefined, 'das Konto wird nie mit dem Server-Key abgefragt');
assert.equal(await appwrite.accountFromJwt('xxx.yyy.zzz'), null);
fake.failNext((c) => c.path === '/v1/account', { status: 500 });
await assert.rejects(() => appwrite.accountFromJwt('aaa.bbb.ccc'), (err) => err instanceof AppwriteError && err.status === 500);
});
test('Pfadsegmente: jede ID wird kodiert, "." und ".." werden abgelehnt, bevor eine Anfrage rausgeht', async () => {
const { fake, appwrite } = await setup();
await appwrite.getRow('gallery', '../x');
assert.equal(lastCall(fake).path, '/v1/tablesdb/aircard/tables/gallery/rows/..%2Fx');
await appwrite.getFile('gallery-images', 'a b/c');
assert.equal(lastCall(fake).path, '/v1/storage/buckets/gallery-images/files/a%20b%2Fc');
const before = fake.calls.length;
for (const bad of ['..', '.', '', 42, null, undefined]) {
await assert.rejects(() => appwrite.getRow('gallery', bad), /Pfadsegment/);
await assert.rejects(() => appwrite.deleteFile('gallery-images', bad), /Pfadsegment/);
}
await assert.rejects(() => appwrite.getRow('..', 'x'), /Pfadsegment/);
assert.equal(fake.calls.length, before, 'es ging keine Anfrage raus');
});
test('Zeitlimit: Appwrite-Aufrufe tragen standardmäßig AbortSignal.timeout(10000)', async () => {
let seenSignal = null;
const appwrite = createAppwrite({
endpoint: 'http://appwrite.invalid/v1',
project: 'p',
key: 'k',
fetchImpl: async (url, init) => {
seenSignal = init.signal;
return new Response(JSON.stringify({ $id: 'x' }), { status: 200, headers: { 'Content-Type': 'application/json' } });
},
});
await appwrite.getRow('gallery', 'x');
assert.ok(seenSignal instanceof AbortSignal);
assert.equal(seenSignal.aborted, false);
});
test('Zeitlimit: hängender Appwrite-Aufruf endet mit AppwriteError (timeout)', async () => {
const { fake, appwrite } = await setup({ timeoutMs: 80 });
fake.hangNext((call) => call.path.endsWith('/rows/slow'));
await assert.rejects(
() => appwrite.getRow('gallery', 'slow'),
(err) => err instanceof AppwriteError && err.type === 'timeout' && err.status === 0,
);
});
test('Netzfehler: AppwriteError (unreachable) ohne Key im Text', async () => {
const appwrite = createAppwrite({
endpoint: 'http://appwrite.invalid/v1',
project: 'p',
key: 'GEHEIMER-KEY-123',
fetchImpl: async () => {
throw new TypeError('fetch failed GEHEIMER-KEY-123');
},
});
await assert.rejects(
() => appwrite.getRow('gallery', 'x'),
(err) => err instanceof AppwriteError && err.type === 'unreachable' && !String(err.message).includes('GEHEIMER-KEY-123'),
);
});