Endpoints (alle Pfade aus app-manifest.json):
- POST /api/v1/share/receive — User-JWT-Auth, ShareEnvelope-Strict-
Validation (cross-user-forbidden), Recipient-Match, Type-Accept-
Lookup über Manifest, Payload-Schema-Validation, Handler-Dispatch
- POST /api/v1/tools/:name — User-JWT, dispatch nach `cards.create`
und `cards.search` mit Tool-Schemas aus @cards/domain
- GET /api/v1/search — User-JWT, ILIKE auf cards.fields jsonb +
decks.name, baut SearchResultEnvelope für mana-search-Aggregator
- GET /api/v1/dsgvo/export?user_id=… — Service-Key, voll-Bundle aller
Cards-Daten des Users (decks, cards, reviews, study_sessions, tags,
media_refs, import_jobs)
- POST /api/v1/dsgvo/delete — Service-Key, kaskadiert via FK-Cascade
decks → cards → reviews/media_refs/card_tags/tags/study_sessions
plus separates Cleanup von import_jobs
Share-Handlers (apps/api/src/share-handlers/):
- create_card_from_quote (mana/quote → front=text, back=source)
- save_link_as_card (mana/url → front=title, back=url+description)
- create_card_from_text (mana/text → front=erste-zeile, back=rest)
Alle landen via ensureInboxDeck() in einem auto-erstellten "Inbox"-Deck
pro User, inklusive automatischer FSRS-Reviews-Init in Transaktion.
Lokales Protocol-Mirror in @cards/domain/src/protocol/ (envelope,
payloads, search): TEMPORARY-Markierung mit Swap-Plan auf
@mana/shared-share-protocol via Verdaccio sobald NPM_AUTH_TOKEN da ist.
Spec-strict — UUID für user_id, ULID für share_id, Crockford-Base32.
Service-Key-Middleware mit constant-time-Compare gegen
process.env.CARDS_DSGVO_SERVICE_KEY (Phase F-1: ersetzt durch
mana-auth.app_service_keys-Lookup).
Tests:
- 70 Vitest-Tests grün (27 cards-domain + 43 apps/api):
- share.test.ts: Auth-Gate, Cross-User-Sperre, User-Mismatch (403),
Wrong-Recipient (422), Unknown-Type (422), Invalid-Payload (422),
Wrapped { envelope, delivery_token }-Body akzeptiert
- tools.test.ts: Auth, Unknown-Tool (404), cards.create-Validation,
cards.search-Envelope-Shape
- search.test.ts: Auth, Missing-Query (422), Query-too-long (422),
Envelope-Version 0.1 + envelope-Felder
- dsgvo.test.ts: Service-Key-Gate (401), Missing-User-ID (400),
Export-Bundle-Shape, Delete-Counts, Key-not-configured (500)
- pnpm run type-check ✅ 4/4 packages
- E2E-Smoke gegen Postgres: Quote-Share→Inbox-Deck→Karte→Search-Hit→
DSGVO-Export+Delete-Roundtrip clean (alle 3 Tabellen 0 nach delete)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
110 lines
3.5 KiB
TypeScript
110 lines
3.5 KiB
TypeScript
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
|
|
import { Hono } from 'hono';
|
|
|
|
import { dsgvoRouter } from '../src/routes/dsgvo.ts';
|
|
import type { CardsDb } from '../src/db/connection.ts';
|
|
|
|
const ORIG_ENV = process.env.CARDS_DSGVO_SERVICE_KEY;
|
|
const TEST_KEY = 'msk_test_dsgvo_key_42';
|
|
|
|
beforeEach(() => {
|
|
process.env.CARDS_DSGVO_SERVICE_KEY = TEST_KEY;
|
|
});
|
|
|
|
afterEach(() => {
|
|
if (ORIG_ENV === undefined) {
|
|
delete process.env.CARDS_DSGVO_SERVICE_KEY;
|
|
} else {
|
|
process.env.CARDS_DSGVO_SERVICE_KEY = ORIG_ENV;
|
|
}
|
|
});
|
|
|
|
function buildApp() {
|
|
const stub = {
|
|
select: () => ({ from: () => ({ where: () => [] as never[] }) }),
|
|
delete: () => ({ where: () => ({ returning: async () => [] }) }),
|
|
transaction: async (fn: (tx: unknown) => unknown) =>
|
|
fn({
|
|
delete: () => ({ where: () => ({ returning: async () => [] }) }),
|
|
}),
|
|
};
|
|
const app = new Hono();
|
|
app.route('/api/v1/dsgvo', dsgvoRouter({ db: stub as unknown as CardsDb }));
|
|
return { app };
|
|
}
|
|
|
|
describe('dsgvoRouter — Service-Key-Gate', () => {
|
|
it('GET /export ohne Service-Key ist 401', async () => {
|
|
const { app } = buildApp();
|
|
const res = await app.request('/api/v1/dsgvo/export?user_id=u-1');
|
|
expect(res.status).toBe(401);
|
|
});
|
|
|
|
it('POST /delete mit falschem Key ist 401', async () => {
|
|
const { app } = buildApp();
|
|
const res = await app.request('/api/v1/dsgvo/delete', {
|
|
method: 'POST',
|
|
headers: { 'X-Service-Key': 'wrong', 'Content-Type': 'application/json' },
|
|
body: JSON.stringify({ user_id: 'u-1' }),
|
|
});
|
|
expect(res.status).toBe(401);
|
|
});
|
|
|
|
it('GET /export mit Key + ohne user_id ist 400', async () => {
|
|
const { app } = buildApp();
|
|
const res = await app.request('/api/v1/dsgvo/export', {
|
|
headers: { 'X-Service-Key': TEST_KEY },
|
|
});
|
|
expect(res.status).toBe(400);
|
|
});
|
|
|
|
it('GET /export mit Key + user_id liefert JSON-Bundle', async () => {
|
|
const { app } = buildApp();
|
|
const res = await app.request('/api/v1/dsgvo/export?user_id=u-1', {
|
|
headers: { 'X-Service-Key': TEST_KEY },
|
|
});
|
|
expect(res.status).toBe(200);
|
|
const body = (await res.json()) as {
|
|
user_id: string;
|
|
app: string;
|
|
data: { decks: unknown[]; cards: unknown[]; reviews: unknown[] };
|
|
};
|
|
expect(body.user_id).toBe('u-1');
|
|
expect(body.app).toBe('cards');
|
|
expect(Array.isArray(body.data.decks)).toBe(true);
|
|
expect(Array.isArray(body.data.cards)).toBe(true);
|
|
expect(Array.isArray(body.data.reviews)).toBe(true);
|
|
});
|
|
|
|
it('POST /delete mit Key + user_id liefert counts', async () => {
|
|
const { app } = buildApp();
|
|
const res = await app.request('/api/v1/dsgvo/delete', {
|
|
method: 'POST',
|
|
headers: { 'X-Service-Key': TEST_KEY, 'Content-Type': 'application/json' },
|
|
body: JSON.stringify({ user_id: 'u-1' }),
|
|
});
|
|
expect(res.status).toBe(200);
|
|
const body = (await res.json()) as {
|
|
deleted: boolean;
|
|
user_id: string;
|
|
counts: { decks: number; import_jobs: number };
|
|
};
|
|
expect(body.deleted).toBe(true);
|
|
expect(body.user_id).toBe('u-1');
|
|
expect(body.counts.decks).toBe(0);
|
|
expect(body.counts.import_jobs).toBe(0);
|
|
});
|
|
});
|
|
|
|
describe('dsgvoRouter — Key-not-configured Pfad', () => {
|
|
it('Wenn ENV fehlt → 500 service_key_not_configured', async () => {
|
|
delete process.env.CARDS_DSGVO_SERVICE_KEY;
|
|
const { app } = buildApp();
|
|
const res = await app.request('/api/v1/dsgvo/export?user_id=u-1', {
|
|
headers: { 'X-Service-Key': 'whatever' },
|
|
});
|
|
expect(res.status).toBe(500);
|
|
const body = (await res.json()) as { error: string };
|
|
expect(body.error).toBe('service_key_not_configured');
|
|
});
|
|
});
|