@broberg/app-shell 0.5.0 → 0.7.1

package/dist/preact.d.cts

@@ -153,6 +153,84 @@ declare function createFetchAccountAdapter(opts?: {
     fetch?: typeof fetch;
     credentials?: RequestCredentials;
 }): AccountAdapter;
+interface AnalyticsDay {
+    /** YYYY-MM-DD on the Europe/Copenhagen calendar (Upmetrics' own day key). */
+    day: string;
+    visitors: number;
+    pageviews: number;
+}
+interface AnalyticsData {
+    totals: {
+        visitors: number;
+        pageviews: number;
+    };
+    /** The same-length period just before this one. */
+    prev: {
+        visitors: number;
+        pageviews: number;
+    };
+    /** Only days that had visits — use fillDays() to draw the whole period. */
+    series: AnalyticsDay[];
+    topPages: {
+        value: string;
+        count: number;
+    }[];
+}
+interface AnalyticsAdapter {
+    load(days: number): Promise<AnalyticsData>;
+}
+/** A failed analytics call: HTTP status (0 = no answer) and the server's `error` code. */
+declare class AnalyticsError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    constructor(status: number, code?: string | undefined);
+}
+/** "unconfigured" only for the backend's explicit 503 analytics_unconfigured; anything else is "unavailable". */
+declare function analyticsErrorKind(err: unknown): "unconfigured" | "unavailable";
+/**
+ * The default adapter: `GET {url}?days=N` on the app's own backend (default
+ * /api/analytics, where `@upmetrics/sdk/hono`'s analyticsRoutes() answers).
+ * A non-2xx, an unreadable body or no answer at all THROWS — never zeros that
+ * look like a real, quiet month.
+ */
+declare function createFetchAnalyticsAdapter(opts?: {
+    url?: string;
+    fetch?: typeof fetch;
+    credentials?: RequestCredentials;
+}): AnalyticsAdapter;
+/** Today's YYYY-MM-DD on the Copenhagen calendar — the calendar Upmetrics buckets on. */
+declare function copenhagenDay(at?: Date): string;
+/**
+ * Exactly `days` entries ending today (Copenhagen calendar), with Upmetrics'
+ * values where it sent a day and zeros where it did not — Upmetrics only sends
+ * days that had visits. Calendar arithmetic, so a DST change never skips or
+ * repeats a day.
+ */
+declare function fillDays(series: AnalyticsDay[], days: number, now?: Date): AnalyticsDay[];
+/** Whole-percent change against the previous period, or null when there is nothing to compare with. */
+declare function changePct(now: number, before: number): number | null;
+interface TenantMembershipRow {
+    tenant: {
+        id: string;
+        slug: string;
+        name: string;
+        status?: "active" | "suspended";
+    };
+    role: string;
+}
+interface TenantAdapter {
+    load(): Promise<TenantMembershipRow[]>;
+}
+declare class TenantLoadError extends Error {
+    readonly status: number;
+    constructor(status: number);
+}
+/** GET {url} (default /api/me/memberships) → the user's memberships. Non-2xx or a bad body THROWS. */
+declare function createFetchTenantAdapter(opts?: {
+    url?: string;
+    fetch?: typeof fetch;
+    credentials?: RequestCredentials;
+}): TenantAdapter;
 declare const TEXT: {
     readonly da: {
         readonly openMenu: "Åbn menu";
@@ -201,6 +279,26 @@ declare const TEXT: {
         readonly pictureTooLarge: "Billedet er for stort — højst 2 MB.";
         readonly pictureWrongType: "Vælg et PNG-, JPEG- eller WebP-billede.";
         readonly bidSecurity: "Sikkerhed i Broberg ID";
+        readonly analyticsPeriod: "Periode";
+        readonly analyticsDays: "{n} dage";
+        readonly analyticsVisitors: "Besøgende";
+        readonly analyticsPageviews: "Sidevisninger";
+        readonly analyticsVsPrev: "{pct} % mod forrige periode";
+        readonly analyticsNoPrev: "Ingen sammenligning";
+        readonly analyticsOverTime: "Sidevisninger pr. dag";
+        readonly analyticsTopPages: "Mest besøgte sider";
+        readonly analyticsDay: "Dag";
+        readonly analyticsPage: "Side";
+        readonly analyticsEmpty: "Ingen besøg i perioden.";
+        readonly analyticsLoading: "Henter tal…";
+        readonly analyticsUnconfigured: "Analytics er ikke sat op for denne app.";
+        readonly analyticsUnavailable: "Upmetrics svarer ikke lige nu. Prøv igen om lidt.";
+        readonly tenantSwitch: "Skift organisation";
+        readonly tenantLoadFailed: "Kunne ikke hente dine organisationer.";
+        readonly tenantSwitchFailed: "Kunne ikke skifte organisation. Du er stadig i {name}.";
+        readonly tenantRetry: "Prøv igen";
+        readonly tenantSuspended: "lukket";
+        readonly tenantActive: "aktiv";
     };
     readonly en: {
         readonly openMenu: "Open menu";
@@ -249,6 +347,26 @@ declare const TEXT: {
         readonly pictureTooLarge: "The picture is too large — 2 MB at most.";
         readonly pictureWrongType: "Choose a PNG, JPEG or WebP image.";
         readonly bidSecurity: "Security in Broberg ID";
+        readonly analyticsPeriod: "Period";
+        readonly analyticsDays: "{n} days";
+        readonly analyticsVisitors: "Visitors";
+        readonly analyticsPageviews: "Page views";
+        readonly analyticsVsPrev: "{pct}% vs previous period";
+        readonly analyticsNoPrev: "No comparison";
+        readonly analyticsOverTime: "Page views per day";
+        readonly analyticsTopPages: "Most visited pages";
+        readonly analyticsDay: "Day";
+        readonly analyticsPage: "Page";
+        readonly analyticsEmpty: "No visits in this period.";
+        readonly analyticsLoading: "Loading figures…";
+        readonly analyticsUnconfigured: "Analytics is not set up for this app.";
+        readonly analyticsUnavailable: "Upmetrics is not answering right now. Try again shortly.";
+        readonly tenantSwitch: "Switch organisation";
+        readonly tenantLoadFailed: "Could not load your organisations.";
+        readonly tenantSwitchFailed: "Could not switch organisation. You are still in {name}.";
+        readonly tenantRetry: "Try again";
+        readonly tenantSuspended: "suspended";
+        readonly tenantActive: "active";
     };
 };
 type Lang = keyof typeof TEXT;
@@ -463,5 +581,40 @@ declare function defaultReauthHref(): string;
  * typed text, so nothing is lost and the error says why.
  */
 declare function AccountPage({ lang, adapter, reauthHref, onProfileChange }: AccountPageProps): JSX.Element;
+interface AnalyticsPageProps {
+    lang: Lang;
+    /** Default: `createFetchAnalyticsAdapter()` → GET /api/analytics?days=N (@upmetrics/sdk/hono analyticsRoutes). */
+    adapter?: AnalyticsAdapter;
+    /** The period buttons, in days. Default 7 / 30 / 90. */
+    periods?: number[];
+    /** The period shown first. Default 30 (or the first of `periods` when 30 is not one of them). */
+    initialDays?: number;
+}
+/**
+ * The app's own visitors, page views, page views per day and most visited
+ * pages, from Upmetrics through the app's backend (F097.1). A backend that is
+ * not set up or does not answer says so — it never shows zeros that would read
+ * as a quiet month.
+ */
+declare function AnalyticsPage({ lang, adapter, periods, initialDays }: AnalyticsPageProps): JSX.Element;
+interface TenantSwitcherProps {
+    lang: Lang;
+    /** The slug the app is in right now — the app knows it (from tenantMiddleware). */
+    activeSlug: string;
+    /** Default: `createFetchTenantAdapter()` → GET /api/me/memberships (@broberg/tenant/hono tenantRoutes). */
+    adapter?: TenantAdapter;
+    /**
+     * Switch through the APP's own route — navigate to `/t/<slug>/…`, or set the
+     * preference and reload. A rejection keeps the current organisation and shows
+     * why; the switcher never pretends a switch happened.
+     */
+    onSwitch: (slug: string) => Promise<void> | void;
+}
+/**
+ * The user's own organisations, the active one marked, and a switch. Only the
+ * memberships the backend returns are listed — never a typed or guessed slug.
+ * With one organisation it is a plain label, not a menu.
+ */
+declare function TenantSwitcher({ lang, activeSlug, adapter, onSwitch }: TenantSwitcherProps): JSX.Element;
 
-export { AVATAR_MAX_BYTES, AVATAR_TYPES, type AccountAdapter, AccountError, AccountPage, type AccountPageProps, type AccountProfile, AppShell, type AppShellProps, Avatar, type Lang, type NavGroup, type NavItem, type Navigate, NotificationBell, type NotificationBellProps, type NotificationSource, PageHeader, type PageTab, PageTabs, type PreactNavGroup, type PreactNavItem, type ShellUser, Sidebar, type SidebarProps, TEXT, TopBar, type TopBarProps, UserMenu, type UserMenuItem, type UserMenuProps, accountErrorKind, activeNavLabel, badgeLabel, checkAvatarFile, createFetchAccountAdapter, createFetchNotificationSource, createMemoryNotificationSource, defaultReauthHref, initials, isActivePath, isExternal, readFlag, readSet, relativeTime, safeNavigate, useIsMobile, writeFlag, writeSet };
+export { AVATAR_MAX_BYTES, AVATAR_TYPES, type AccountAdapter, AccountError, AccountPage, type AccountPageProps, type AccountProfile, type AnalyticsAdapter, type AnalyticsData, type AnalyticsDay, AnalyticsError, AnalyticsPage, type AnalyticsPageProps, AppShell, type AppShellProps, Avatar, type Lang, type NavGroup, type NavItem, type Navigate, NotificationBell, type NotificationBellProps, type NotificationSource, PageHeader, type PageTab, PageTabs, type PreactNavGroup, type PreactNavItem, type ShellUser, Sidebar, type SidebarProps, TEXT, type TenantAdapter, TenantLoadError, type TenantMembershipRow, TenantSwitcher, type TenantSwitcherProps, TopBar, type TopBarProps, UserMenu, type UserMenuItem, type UserMenuProps, accountErrorKind, activeNavLabel, analyticsErrorKind, badgeLabel, changePct, checkAvatarFile, copenhagenDay, createFetchAccountAdapter, createFetchAnalyticsAdapter, createFetchNotificationSource, createFetchTenantAdapter, createMemoryNotificationSource, defaultReauthHref, fillDays, initials, isActivePath, isExternal, readFlag, readSet, relativeTime, safeNavigate, useIsMobile, writeFlag, writeSet };

package/dist/preact.d.ts

@@ -153,6 +153,84 @@ declare function createFetchAccountAdapter(opts?: {
     fetch?: typeof fetch;
     credentials?: RequestCredentials;
 }): AccountAdapter;
+interface AnalyticsDay {
+    /** YYYY-MM-DD on the Europe/Copenhagen calendar (Upmetrics' own day key). */
+    day: string;
+    visitors: number;
+    pageviews: number;
+}
+interface AnalyticsData {
+    totals: {
+        visitors: number;
+        pageviews: number;
+    };
+    /** The same-length period just before this one. */
+    prev: {
+        visitors: number;
+        pageviews: number;
+    };
+    /** Only days that had visits — use fillDays() to draw the whole period. */
+    series: AnalyticsDay[];
+    topPages: {
+        value: string;
+        count: number;
+    }[];
+}
+interface AnalyticsAdapter {
+    load(days: number): Promise<AnalyticsData>;
+}
+/** A failed analytics call: HTTP status (0 = no answer) and the server's `error` code. */
+declare class AnalyticsError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    constructor(status: number, code?: string | undefined);
+}
+/** "unconfigured" only for the backend's explicit 503 analytics_unconfigured; anything else is "unavailable". */
+declare function analyticsErrorKind(err: unknown): "unconfigured" | "unavailable";
+/**
+ * The default adapter: `GET {url}?days=N` on the app's own backend (default
+ * /api/analytics, where `@upmetrics/sdk/hono`'s analyticsRoutes() answers).
+ * A non-2xx, an unreadable body or no answer at all THROWS — never zeros that
+ * look like a real, quiet month.
+ */
+declare function createFetchAnalyticsAdapter(opts?: {
+    url?: string;
+    fetch?: typeof fetch;
+    credentials?: RequestCredentials;
+}): AnalyticsAdapter;
+/** Today's YYYY-MM-DD on the Copenhagen calendar — the calendar Upmetrics buckets on. */
+declare function copenhagenDay(at?: Date): string;
+/**
+ * Exactly `days` entries ending today (Copenhagen calendar), with Upmetrics'
+ * values where it sent a day and zeros where it did not — Upmetrics only sends
+ * days that had visits. Calendar arithmetic, so a DST change never skips or
+ * repeats a day.
+ */
+declare function fillDays(series: AnalyticsDay[], days: number, now?: Date): AnalyticsDay[];
+/** Whole-percent change against the previous period, or null when there is nothing to compare with. */
+declare function changePct(now: number, before: number): number | null;
+interface TenantMembershipRow {
+    tenant: {
+        id: string;
+        slug: string;
+        name: string;
+        status?: "active" | "suspended";
+    };
+    role: string;
+}
+interface TenantAdapter {
+    load(): Promise<TenantMembershipRow[]>;
+}
+declare class TenantLoadError extends Error {
+    readonly status: number;
+    constructor(status: number);
+}
+/** GET {url} (default /api/me/memberships) → the user's memberships. Non-2xx or a bad body THROWS. */
+declare function createFetchTenantAdapter(opts?: {
+    url?: string;
+    fetch?: typeof fetch;
+    credentials?: RequestCredentials;
+}): TenantAdapter;
 declare const TEXT: {
     readonly da: {
         readonly openMenu: "Åbn menu";
@@ -201,6 +279,26 @@ declare const TEXT: {
         readonly pictureTooLarge: "Billedet er for stort — højst 2 MB.";
         readonly pictureWrongType: "Vælg et PNG-, JPEG- eller WebP-billede.";
         readonly bidSecurity: "Sikkerhed i Broberg ID";
+        readonly analyticsPeriod: "Periode";
+        readonly analyticsDays: "{n} dage";
+        readonly analyticsVisitors: "Besøgende";
+        readonly analyticsPageviews: "Sidevisninger";
+        readonly analyticsVsPrev: "{pct} % mod forrige periode";
+        readonly analyticsNoPrev: "Ingen sammenligning";
+        readonly analyticsOverTime: "Sidevisninger pr. dag";
+        readonly analyticsTopPages: "Mest besøgte sider";
+        readonly analyticsDay: "Dag";
+        readonly analyticsPage: "Side";
+        readonly analyticsEmpty: "Ingen besøg i perioden.";
+        readonly analyticsLoading: "Henter tal…";
+        readonly analyticsUnconfigured: "Analytics er ikke sat op for denne app.";
+        readonly analyticsUnavailable: "Upmetrics svarer ikke lige nu. Prøv igen om lidt.";
+        readonly tenantSwitch: "Skift organisation";
+        readonly tenantLoadFailed: "Kunne ikke hente dine organisationer.";
+        readonly tenantSwitchFailed: "Kunne ikke skifte organisation. Du er stadig i {name}.";
+        readonly tenantRetry: "Prøv igen";
+        readonly tenantSuspended: "lukket";
+        readonly tenantActive: "aktiv";
     };
     readonly en: {
         readonly openMenu: "Open menu";
@@ -249,6 +347,26 @@ declare const TEXT: {
         readonly pictureTooLarge: "The picture is too large — 2 MB at most.";
         readonly pictureWrongType: "Choose a PNG, JPEG or WebP image.";
         readonly bidSecurity: "Security in Broberg ID";
+        readonly analyticsPeriod: "Period";
+        readonly analyticsDays: "{n} days";
+        readonly analyticsVisitors: "Visitors";
+        readonly analyticsPageviews: "Page views";
+        readonly analyticsVsPrev: "{pct}% vs previous period";
+        readonly analyticsNoPrev: "No comparison";
+        readonly analyticsOverTime: "Page views per day";
+        readonly analyticsTopPages: "Most visited pages";
+        readonly analyticsDay: "Day";
+        readonly analyticsPage: "Page";
+        readonly analyticsEmpty: "No visits in this period.";
+        readonly analyticsLoading: "Loading figures…";
+        readonly analyticsUnconfigured: "Analytics is not set up for this app.";
+        readonly analyticsUnavailable: "Upmetrics is not answering right now. Try again shortly.";
+        readonly tenantSwitch: "Switch organisation";
+        readonly tenantLoadFailed: "Could not load your organisations.";
+        readonly tenantSwitchFailed: "Could not switch organisation. You are still in {name}.";
+        readonly tenantRetry: "Try again";
+        readonly tenantSuspended: "suspended";
+        readonly tenantActive: "active";
     };
 };
 type Lang = keyof typeof TEXT;
@@ -463,5 +581,40 @@ declare function defaultReauthHref(): string;
  * typed text, so nothing is lost and the error says why.
  */
 declare function AccountPage({ lang, adapter, reauthHref, onProfileChange }: AccountPageProps): JSX.Element;
+interface AnalyticsPageProps {
+    lang: Lang;
+    /** Default: `createFetchAnalyticsAdapter()` → GET /api/analytics?days=N (@upmetrics/sdk/hono analyticsRoutes). */
+    adapter?: AnalyticsAdapter;
+    /** The period buttons, in days. Default 7 / 30 / 90. */
+    periods?: number[];
+    /** The period shown first. Default 30 (or the first of `periods` when 30 is not one of them). */
+    initialDays?: number;
+}
+/**
+ * The app's own visitors, page views, page views per day and most visited
+ * pages, from Upmetrics through the app's backend (F097.1). A backend that is
+ * not set up or does not answer says so — it never shows zeros that would read
+ * as a quiet month.
+ */
+declare function AnalyticsPage({ lang, adapter, periods, initialDays }: AnalyticsPageProps): JSX.Element;
+interface TenantSwitcherProps {
+    lang: Lang;
+    /** The slug the app is in right now — the app knows it (from tenantMiddleware). */
+    activeSlug: string;
+    /** Default: `createFetchTenantAdapter()` → GET /api/me/memberships (@broberg/tenant/hono tenantRoutes). */
+    adapter?: TenantAdapter;
+    /**
+     * Switch through the APP's own route — navigate to `/t/<slug>/…`, or set the
+     * preference and reload. A rejection keeps the current organisation and shows
+     * why; the switcher never pretends a switch happened.
+     */
+    onSwitch: (slug: string) => Promise<void> | void;
+}
+/**
+ * The user's own organisations, the active one marked, and a switch. Only the
+ * memberships the backend returns are listed — never a typed or guessed slug.
+ * With one organisation it is a plain label, not a menu.
+ */
+declare function TenantSwitcher({ lang, activeSlug, adapter, onSwitch }: TenantSwitcherProps): JSX.Element;
 
-export { AVATAR_MAX_BYTES, AVATAR_TYPES, type AccountAdapter, AccountError, AccountPage, type AccountPageProps, type AccountProfile, AppShell, type AppShellProps, Avatar, type Lang, type NavGroup, type NavItem, type Navigate, NotificationBell, type NotificationBellProps, type NotificationSource, PageHeader, type PageTab, PageTabs, type PreactNavGroup, type PreactNavItem, type ShellUser, Sidebar, type SidebarProps, TEXT, TopBar, type TopBarProps, UserMenu, type UserMenuItem, type UserMenuProps, accountErrorKind, activeNavLabel, badgeLabel, checkAvatarFile, createFetchAccountAdapter, createFetchNotificationSource, createMemoryNotificationSource, defaultReauthHref, initials, isActivePath, isExternal, readFlag, readSet, relativeTime, safeNavigate, useIsMobile, writeFlag, writeSet };
+export { AVATAR_MAX_BYTES, AVATAR_TYPES, type AccountAdapter, AccountError, AccountPage, type AccountPageProps, type AccountProfile, type AnalyticsAdapter, type AnalyticsData, type AnalyticsDay, AnalyticsError, AnalyticsPage, type AnalyticsPageProps, AppShell, type AppShellProps, Avatar, type Lang, type NavGroup, type NavItem, type Navigate, NotificationBell, type NotificationBellProps, type NotificationSource, PageHeader, type PageTab, PageTabs, type PreactNavGroup, type PreactNavItem, type ShellUser, Sidebar, type SidebarProps, TEXT, type TenantAdapter, TenantLoadError, type TenantMembershipRow, TenantSwitcher, type TenantSwitcherProps, TopBar, type TopBarProps, UserMenu, type UserMenuItem, type UserMenuProps, accountErrorKind, activeNavLabel, analyticsErrorKind, badgeLabel, changePct, checkAvatarFile, copenhagenDay, createFetchAccountAdapter, createFetchAnalyticsAdapter, createFetchNotificationSource, createFetchTenantAdapter, createMemoryNotificationSource, defaultReauthHref, fillDays, initials, isActivePath, isExternal, readFlag, readSet, relativeTime, safeNavigate, useIsMobile, writeFlag, writeSet };