managarten/packages/feedback/src/createPublicFeedbackService.ts
Till JS ee5bb2871c feat(community): Phase 3.C — Identität (Avatar + Klarname-Toggle + Karma + Eulen-Profil)
Macht aus den Pseudonymen echte Charaktere ohne Klarnamen-Zwang.

Pixel-Identicon-Avatar (3.C.2):
- generateAvatarSvg(displayHash) — pure-function, deterministisch.
  5×5 left-mirrored Identicon mit HSL-Foreground/Background aus dem
  Hash. Inline-SVG, kein Storage, kein img-load-Flicker.
- <EulenAvatar> Component im Package, in ItemCard neben dem Pseudonym.

Klarname-Toggle (3.C.1):
- auth.users + community_show_real_name boolean (default off, opt-in).
- PATCH /api/v1/me/profile akzeptiert communityShowRealName.
- mana-analytics LEFT JOINs auth.users → bei opt-in liefert auth-
  required /public + /me/reacted Endpoints zusätzlich realName.
- Anonymous /api/v1/public/feedback/* zeigt realName NIE — auch nicht
  wenn opted-in. Public-Mirror bleibt für SEO + Privacy safe.
- Migration 008_community_identity.sql lokal + prod eingespielt.

Karma-System (3.C.3):
- auth.users + community_karma int. toggleReaction increment/decrement
  am Author-User (Self-Reactions zählen nicht — kein Self-Farming).
- KARMA_THRESHOLDS + tierFromKarma() im Package: Bronze (0-9) /
  Silver (10-49) / Gold (50-199) / Platin (200+).
- ItemCard zeigt Tier-Dot neben dem Pseudonym, Title-Tooltip mit
  Karma-Zahl. Floor-clamped at 0.

Eulen-Profil (3.C.4):
- GET /api/v1/public/feedback/eule/{hash} — alle public-Posts dieser
  Eule + aggregiertes Karma. SHA256-Format-Validation.
- /community/eule/[hash] Public-SSR-Route mit Avatar-Hero, Tier-Badge,
  Karma-Counter, Post-Liste. Author-Klick im ItemCard navigiert hin.
- publicFeedbackService.getEulenProfile() im Package.

PublicFeedbackItem erweitert um displayHash (public Pseudonym-ID,
SHA256 ist one-way → safe to expose) + karma + optional realName.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-27 15:15:16 +02:00

57 lines
2.2 KiB
TypeScript

/**
* Public, anonymous feedback service — for SSR / unauthenticated reads
* of the community feed (e.g. /community route, embeddable widget).
*
* No auth, no submit, no react. If you need write access, instantiate
* `createFeedbackService()` instead and pass a getAuthToken callback.
*/
import type {
PublicFeedListResponse,
PublicItemResponse,
EulenProfileResponse,
FeedbackQueryParams,
} from './api';
import type { PublicFeedbackItem } from './feedback';
import type { PublicFeedbackServiceConfig } from './types';
export function createPublicFeedbackService(config: PublicFeedbackServiceConfig) {
const { apiUrl, appId, publicEndpoint = '/api/v1/public/feedback' } = config;
const baseUrl = apiUrl.replace(/\/$/, '');
async function fetchPublic<T>(endpoint: string): Promise<T> {
const res = await fetch(`${baseUrl}${endpoint}`);
if (!res.ok) throw new Error(`HTTP ${res.status}: ${res.statusText}`);
return res.json();
}
function feedQueryString(query?: FeedbackQueryParams): string {
const params = new URLSearchParams();
const effectiveAppId = query?.appId ?? appId;
if (effectiveAppId) params.set('appId', effectiveAppId);
if (query?.moduleContext) params.set('moduleContext', query.moduleContext);
if (query?.status) params.set('status', query.status);
if (query?.category) params.set('category', query.category);
if (query?.limit) params.set('limit', String(query.limit));
if (query?.offset) params.set('offset', String(query.offset));
return params.toString();
}
async function getFeed(query?: FeedbackQueryParams): Promise<PublicFeedbackItem[]> {
const qs = feedQueryString(query);
const res = await fetchPublic<PublicFeedListResponse>(`${publicEndpoint}/feed?${qs}`);
return res.items;
}
async function getItem(id: string): Promise<PublicItemResponse> {
return fetchPublic<PublicItemResponse>(`${publicEndpoint}/${id}`);
}
async function getEulenProfile(displayHash: string): Promise<EulenProfileResponse> {
return fetchPublic<EulenProfileResponse>(`${publicEndpoint}/eule/${displayHash}`);
}
return { getFeed, getItem, getEulenProfile };
}
export type PublicFeedbackService = ReturnType<typeof createPublicFeedbackService>;