Files
Calendar_Frontend/lib/types.ts
T
PaddyandClaude Opus 5.5 61e0393f01
Test and deploy / test (pull_request) Successful in 2m18s
Test and deploy / deploy (pull_request) Skipped
Support the read-only calendar role, show "Vorstand", fix link buttons
- Read-only role: /admin/me's permissions decide via canEditCalendar
  (lib/permissions.ts, mirrors the API's canWrite: only `access` writes).
  Read-only accounts see everything but get no "Neuer Termin", no "+", no
  "Veröffentlichen"; an event opens as "Termin ansehen" with locked fields.
  A "Nur lesen" badge in the header explains why. The API refuses their
  writes regardless.
- The management calendar is labelled "Vorstand"; the slug stays
  `management` for the API, URLs and iCal links.
- The subscription dialog's Apple/Google links are plain anchors styled with
  buttonVariants instead of Base UI Buttons rendering an <a>, which warned in
  dev and would have given them role="button".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-08 22:15:31 +01:00

94 lines
2.9 KiB
TypeScript

/**
* Shapes on the wire and in the app.
*
* `ApiEvent` is what `GET /calendar/events/:calendar/json` actually returns,
* which is looser than the API's own `Event` interface claims: the service maps
* raw MariaDB rows straight through (`toEvent` in events.service.ts), so
* `wholeDay` arrives as whatever the driver produced for the column (1/0 rather
* than true/false is the likely case), and a deleted event's latest version is
* a row with only `status` set - every other version column is null. `status`
* is missing entirely from the anonymous public listing.
*
* `CalendarEvent` is the parsed, trustworthy form everything else in the app
* works with. Parsing happens once, in `parseApiEvent`.
*/
export type EventStatus = "PUBLIC" | "PRIVATE" | "DRAFT" | "DELETED";
export interface ApiEvent {
eventId: number;
calendarId: number;
uuid: string;
name: string | null;
description: string | null;
startDateTime: string | null;
endDateTime: string | null;
createdDate: string | null;
lastModifiedDate?: string | null;
location: string | null;
createdBy?: string | null;
lastModifiedBy?: string | null;
url: string | null;
wholeDay: boolean | number | null;
repeatFrequency: string | null;
status?: string | null;
}
export interface CalendarEvent {
eventId: number;
calendarId: number;
uuid: string;
name: string;
description: string;
/** Instants. Wall-clock meaning is always Europe/Berlin, see lib/dates.ts. */
start: Date;
end: Date;
created: Date | null;
lastModified: Date | null;
location: string;
createdBy: string;
lastModifiedBy: string;
url: string;
wholeDay: boolean;
/** "" when the event does not repeat. Sent to iCal verbatim as RRULE:FREQ=… */
repeatFrequency: string;
status: EventStatus;
}
/**
* The body of POST /calendar/events, PUT /calendar/events/:id and
* PUT /calendar/events/move/:id.
*
* Every field is required here on purpose. PUT replaces the whole version and
* defaults whatever is missing - `repeatFrequency ?? ''`, `status ?? 'PUBLIC'`
* (events.router.ts) - so a partial body silently drops a birthday's
* recurrence or publishes a draft.
*/
export interface EventPayload {
calendarId: number;
name: string;
description: string;
startDateTime: string;
endDateTime: string;
location: string;
url: string;
wholeDay: boolean;
repeatFrequency: string;
status: EventStatus;
}
/** GET /admin/me - the signed-in account, shared by all Nachklang apps. */
export interface AdminUser {
id: string;
email: string;
fullName: string;
/** The distinct apps the account may open at all, whatever the role. */
apps: string[];
/**
* The full (app, role) grants: `access` = may change things, `read` = may only
* look. Missing on an API from before the read-only role (2026-10-29).
* See lib/permissions.ts.
*/
permissions?: { app: string; role: string }[];
}