Files
familienarchiv/frontend/src/lib/shared
Marcel d0fc8ce995 feat(geschichte): allow journey items on STORY-type Geschichten (#795)
Delete the JOURNEY-only type guard in JourneyItemService.append() so the
existing item endpoints serve both Geschichte types. GeschichteType has
exactly two constants, so an allowlist replacement would be unreachable
dead code. Fix the not-found messages that claimed "Journey", and remove
the now-orphaned GESCHICHTE_TYPE_MISMATCH error code end to end
(ErrorCode, errors.ts union + mapping, i18n keys in de/en/es).

Tests: three STORY append unit tests written red against the guard, plus
end-to-end STORY coverage (append+retrieve, V72-style position-gap rows
incl. removal, dangling document-deleted item). The two STORY-rejection
tests die with the guard — no third enum value exists to feed it.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 12:21:33 +02:00
..
2026-06-11 08:31:17 +02:00

shared (frontend)

Cross-domain utilities and UI primitives. Any file here is consumed by two or more domain folders and has no domain identity of its own.

Admission criteria (what belongs here)

A file belongs in shared/ if it meets all three conditions:

  1. No domain identity — it does not represent a Document, Person, Tag, etc.
  2. Consumed by ≥ 2 domain folders — or is framework infrastructure that every domain depends on.
  3. Generic — could work in a different SvelteKit project with zero business-logic changes.

If any condition fails, the file belongs in the domain folder of its primary consumer.

What this folder owns

Sub-folder / file Purpose
api.server.ts Typed openapi-fetch client factory — the standard entry point for all backend API calls in server-side load functions and actions
errors.ts Mirror of the backend ErrorCode enum + getErrorMessage() → Paraglide i18n key mapping
types.ts Cross-domain TypeScript interfaces
utils.ts Pure utility functions (date formatting, sorting, debounce)
relativeTime.ts Human-relative time formatting ("2 days ago")
primitives/ Generic UI components: BackButton.svelte, form inputs, pagination, layout shells
discussion/ Comment/mention editor shared by document/ and geschichte/
dashboard/ Family Pulse widget and recent-activity components assembled in the / route
hooks/ Svelte 5 reactive hooks: useTypeahead, useUnsavedWarning
services/ Generic client-side service helpers
actions/ Shared SvelteKit form action utilities
server/ Server-only shared utilities (load function helpers)
help/ Coach marks and empty-state components used across multiple domains

What does NOT belong here

  • Components owned by one domain — move to that domain's folder.
  • Domain-specific business logic — even if shared, it belongs in the owning domain's public surface.

Adding to shared/

If you need to add a file here, confirm it meets all three admission criteria. If it's domain-adjacent, check whether the owning domain should export it as part of its public surface instead.