@micha.bigler/ui-core-micha 2.5.0 → 2.6.1

package/.github/workflows/publish.yml

@@ -105,6 +105,10 @@ jobs:
         if: steps.version_check.outputs.should_publish == 'true'
         run: pnpm install --frozen-lockfile
 
+      - name: Run tests
+        if: steps.version_check.outputs.should_publish == 'true'
+        run: pnpm run test
+
       - name: Build
         if: steps.version_check.outputs.should_publish == 'true'
         run: pnpm run build

package/dist/i18n/notificationsTranslations.js

@@ -0,0 +1,17 @@
+export const notificationsTranslations = {
+    'NotificationSettings.TITLE': { de: 'Benachrichtigungen', fr: 'Notifications', en: 'Notifications', sw: 'Arifa' },
+    'NotificationSettings.SUBTITLE': { de: 'Lege fest, wie du informiert werden möchtest.', fr: 'Choisissez comment vous souhaitez être informé.', en: 'Choose how you want to be notified.', sw: 'Chagua jinsi unavyotaka kuarifiwa.' },
+    'NotificationSettings.LOAD_ERROR': { de: 'Benachrichtigungseinstellungen konnten nicht geladen werden.', fr: 'Impossible de charger les paramètres de notification.', en: 'Notification settings could not be loaded.', sw: 'Mipangilio ya arifa haikuweza kupakiwa.' },
+    'NotificationSettings.SAVE_ERROR': { de: 'Benachrichtigungseinstellungen konnten nicht gespeichert werden.', fr: 'Impossible d’enregistrer les paramètres de notification.', en: 'Notification settings could not be saved.', sw: 'Mipangilio ya arifa haikuweza kuhifadhiwa.' },
+    'NotificationSettings.EMAIL_LABEL': { de: 'E-Mail-Benachrichtigungen', fr: 'Notifications par e-mail', en: 'Email notifications', sw: 'Arifa za barua pepe' },
+    'NotificationSettings.EMAIL_HINT': { de: 'Erhalte wichtige Informationen per E-Mail.', fr: 'Recevez les informations importantes par e-mail.', en: 'Receive important information by email.', sw: 'Pokea taarifa muhimu kwa barua pepe.' },
+    'NotificationSettings.PUSH_LABEL': { de: 'Push-Benachrichtigungen', fr: 'Notifications push', en: 'Push notifications', sw: 'Arifa za push' },
+    'NotificationSettings.PUSH_HINT': { de: 'Aktiviere Benachrichtigungen für dieses Gerät.', fr: 'Activez les notifications pour cet appareil.', en: 'Enable notifications for this device.', sw: 'Washa arifa kwa kifaa hiki.' },
+    'NotificationSettings.PUSH_ENABLE': { de: 'Push aktivieren', fr: 'Activer les notifications push', en: 'Enable push', sw: 'Washa push' },
+    'NotificationSettings.PUSH_DISABLE': { de: 'Push auf diesem Gerät deaktivieren', fr: 'Désactiver les notifications push sur cet appareil', en: 'Disable push on this device', sw: 'Zima push kwenye kifaa hiki' },
+    'NotificationSettings.PUSH_DENIED': { de: 'Die Browserberechtigung für Push-Benachrichtigungen wurde verweigert.', fr: 'L’autorisation du navigateur pour les notifications push a été refusée.', en: 'Browser permission for push notifications was denied.', sw: 'Ruhusa ya kivinjari kwa arifa za push imekataliwa.' },
+    'NotificationSettings.PUSH_ERROR': { de: 'Push-Benachrichtigungen konnten nicht aktualisiert werden.', fr: 'Impossible de mettre à jour les notifications push.', en: 'Push notifications could not be updated.', sw: 'Arifa za push hazikuweza kusasishwa.' },
+    'NotificationSettings.PUSH_CONFLICT': { de: 'Dieses Gerät ist bereits mit einem anderen Konto für Push-Benachrichtigungen verbunden.', fr: 'Cet appareil est déjà associé à un autre compte pour les notifications push.', en: 'This device is already associated with another account for push notifications.', sw: 'Kifaa hiki tayari kimeunganishwa na akaunti nyingine kwa arifa za push.' },
+    'NotificationSettings.PUSH_NOT_SUPPORTED': { de: 'Push-Benachrichtigungen werden von diesem Browser nicht unterstützt.', fr: 'Les notifications push ne sont pas prises en charge par ce navigateur.', en: 'Push notifications are not supported by this browser.', sw: 'Arifa za push hazitumiki na kivinjari hiki.' },
+    'NotificationSettings.IOS_HINT': { de: 'Füge diese App zuerst zum Home-Bildschirm hinzu, um Push-Benachrichtigungen zu aktivieren.', fr: 'Ajoutez d’abord cette application à l’écran d’accueil pour activer les notifications push.', en: 'Add this app to your home screen first to enable push notifications.', sw: 'Ongeza programu hii kwenye skrini yako ya mwanzo kwanza ili kuwasha arifa za push.' },
+};

package/dist/i18n/onboardingTranslations.js

@@ -0,0 +1,17 @@
+export const onboardingTranslations = {
+    'Onboarding.SETUP': { de: 'Einrichtung', fr: 'Configuration', en: 'Setup', sw: 'Usanidi' },
+    'Onboarding.STEP_COUNTER': { de: 'Schritt {{current}} von {{total}}', fr: 'Étape {{current}} sur {{total}}', en: 'Step {{current}} of {{total}}', sw: 'Hatua ya {{current}} kati ya {{total}}' },
+    'Onboarding.COOKIE_CONSENT_TITLE': { de: 'Cookie-Einstellungen', fr: 'Préférences des cookies', en: 'Cookie preferences', sw: 'Mapendeleo ya vidakuzi' },
+    'Onboarding.COOKIE_CONSENT_BODY': { de: 'Diese App verwendet optionale Cookies, um deine Einstellungen und Präferenzen zu speichern. Möchtest du diese aktivieren?', fr: 'Cette application utilise des cookies facultatifs pour enregistrer vos réglages et préférences. Souhaitez-vous les activer ?', en: 'This app uses optional cookies to save your settings and preferences. Would you like to enable them?', sw: 'Programu hii hutumia vidakuzi vya hiari kuhifadhi mipangilio na mapendeleo yako. Je, ungependa kuviwasha?' },
+    'Onboarding.COOKIE_CONSENT_ACCEPT': { de: 'Akzeptieren', fr: 'Accepter', en: 'Accept', sw: 'Kubali' },
+    'Onboarding.COOKIE_CONSENT_ERROR': { de: 'Die Cookie-Einstellung konnte nicht gespeichert werden. Bitte versuche es erneut.', fr: 'Impossible d’enregistrer votre préférence de cookies. Veuillez réessayer.', en: 'Your cookie preference could not be saved. Please try again.', sw: 'Upendeleo wako wa vidakuzi haukuweza kuhifadhiwa. Tafadhali jaribu tena.' },
+    'Onboarding.COMPLETE_NAME_TITLE': { de: 'Dein Name', fr: 'Votre nom', en: 'Your name', sw: 'Jina lako' },
+    'Onboarding.COMPLETE_NAME_BODY': { de: 'Bitte gib deinen Vor- und Nachnamen an, damit andere dich erkennen.', fr: 'Veuillez indiquer votre prénom et votre nom afin que les autres puissent vous reconnaître.', en: 'Please provide your first and last name so others can recognise you.', sw: 'Tafadhali weka jina lako la kwanza na la mwisho ili wengine wakutambue.' },
+    'Onboarding.FIRST_NAME_LABEL': { de: 'Vorname', fr: 'Prénom', en: 'First name', sw: 'Jina la kwanza' },
+    'Onboarding.LAST_NAME_LABEL': { de: 'Nachname', fr: 'Nom', en: 'Last name', sw: 'Jina la mwisho' },
+    'Onboarding.SAVE': { de: 'Speichern', fr: 'Enregistrer', en: 'Save', sw: 'Hifadhi' },
+    'Onboarding.COMPLETE_NAME_ERROR': { de: 'Der Name konnte nicht gespeichert werden. Bitte versuche es erneut.', fr: 'Impossible d’enregistrer votre nom. Veuillez réessayer.', en: 'Your name could not be saved. Please try again.', sw: 'Jina lako halikuweza kuhifadhiwa. Tafadhali jaribu tena.' },
+    'Onboarding.BROWSER_PUSH_TITLE': { de: 'Push-Benachrichtigungen', fr: 'Notifications push', en: 'Push notifications', sw: 'Arifa za push' },
+    'Onboarding.BROWSER_PUSH_BODY': { de: 'Erhalte Benachrichtigungen direkt im Browser, auch wenn die App nicht geöffnet ist.', fr: 'Recevez des notifications directement dans votre navigateur, même lorsque l’application est fermée.', en: 'Receive notifications directly in your browser, even when the app is not open.', sw: 'Pokea arifa moja kwa moja kwenye kivinjari chako, hata programu haijafunguliwa.' },
+    'Onboarding.SKIP': { de: 'Überspringen', fr: 'Passer', en: 'Skip', sw: 'Ruka' },
+};

package/dist/index.js

@@ -29,3 +29,17 @@ export { AccessCodeSingleUseToggle } from './components/AccessCodeSingleUseToggl
 export { QrSignupManager } from './components/QrSignupManager';
 // --- 6. Translations ---
 export { authTranslations } from './i18n/authTranslations';
+// --- 7. Notifications ---
+export { NotificationSettings } from './notifications/NotificationSettings';
+export * from './notifications/api';
+// --- 8. Onboarding ---
+export * from './onboarding/api';
+export { selectActiveSteps } from './onboarding/stepSelection';
+export { OnboardingContext, OnboardingProvider, UNIVERSAL_STEP_DESCRIPTORS, useOnboarding, } from './onboarding/OnboardingProvider';
+export { OnboardingWizard } from './onboarding/OnboardingWizard';
+export { CookieConsentStep } from './onboarding/steps/CookieConsentStep';
+export { CompleteNameStep } from './onboarding/steps/CompleteNameStep';
+export { BrowserPushStep } from './onboarding/steps/BrowserPushStep';
+// --- 9. Translations ---
+export { notificationsTranslations } from './i18n/notificationsTranslations';
+export { onboardingTranslations } from './i18n/onboardingTranslations';

package/dist/notifications/NotificationSettings.js

@@ -0,0 +1,148 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React, { useEffect, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import Alert from '@mui/material/Alert';
+import Box from '@mui/material/Box';
+import Button from '@mui/material/Button';
+import CircularProgress from '@mui/material/CircularProgress';
+import Divider from '@mui/material/Divider';
+import FormControlLabel from '@mui/material/FormControlLabel';
+import Switch from '@mui/material/Switch';
+import Typography from '@mui/material/Typography';
+import NotificationsIcon from '@mui/icons-material/Notifications';
+import { getNotificationPreferences, getVapidPublicKey, patchNotificationPreferences, removePushSubscription, savePushSubscription, urlBase64ToUint8Array, } from './api';
+function getPushSupport() {
+    return typeof navigator !== 'undefined'
+        && typeof window !== 'undefined'
+        && 'serviceWorker' in navigator
+        && 'PushManager' in window;
+}
+function getIosInstallState() {
+    var _a;
+    if (typeof navigator === 'undefined' || typeof window === 'undefined')
+        return false;
+    const isIos = /iphone|ipad|ipod/i.test(navigator.userAgent || '');
+    const standalone = ((_a = window.matchMedia) === null || _a === void 0 ? void 0 : _a.call(window, '(display-mode: standalone)').matches)
+        || window.navigator.standalone === true;
+    return isIos && !standalone;
+}
+export function NotificationSettings() {
+    const { t } = useTranslation();
+    const [preferences, setPreferences] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const [savingEmail, setSavingEmail] = useState(false);
+    const [savingPush, setSavingPush] = useState(false);
+    const [pushSubscribed, setPushSubscribed] = useState(false);
+    const [error, setError] = useState('');
+    const [conflict, setConflict] = useState('');
+    const pushSupported = getPushSupport();
+    const iosNeedsInstall = getIosInstallState();
+    useEffect(() => {
+        let cancelled = false;
+        getNotificationPreferences()
+            .then((data) => {
+            if (!cancelled)
+                setPreferences(data);
+        })
+            .catch(() => {
+            if (!cancelled)
+                setError(t('NotificationSettings.LOAD_ERROR'));
+        })
+            .finally(() => {
+            if (!cancelled)
+                setLoading(false);
+        });
+        return () => { cancelled = true; };
+    }, [t]);
+    useEffect(() => {
+        let cancelled = false;
+        if (!pushSupported)
+            return undefined;
+        navigator.serviceWorker.ready
+            .then((registration) => registration.pushManager.getSubscription())
+            .then((subscription) => {
+            if (!cancelled)
+                setPushSubscribed(Boolean(subscription));
+        })
+            .catch(() => {
+            if (!cancelled)
+                setPushSubscribed(false);
+        });
+        return () => { cancelled = true; };
+    }, [pushSupported]);
+    const handleEmailToggle = async (event) => {
+        const email_opt_in = event.target.checked;
+        setSavingEmail(true);
+        setError('');
+        try {
+            const updated = await patchNotificationPreferences({ email_opt_in });
+            setPreferences(updated);
+        }
+        catch (_a) {
+            setError(t('NotificationSettings.SAVE_ERROR'));
+        }
+        finally {
+            setSavingEmail(false);
+        }
+    };
+    const handleEnablePush = async () => {
+        var _a;
+        setSavingPush(true);
+        setError('');
+        setConflict('');
+        try {
+            const permission = await Notification.requestPermission();
+            if (permission !== 'granted') {
+                setError(t('NotificationSettings.PUSH_DENIED'));
+                return;
+            }
+            const vapidPublicKey = await getVapidPublicKey();
+            const registration = await navigator.serviceWorker.ready;
+            const subscription = await registration.pushManager.subscribe({
+                userVisibleOnly: true,
+                applicationServerKey: urlBase64ToUint8Array(vapidPublicKey),
+            });
+            await savePushSubscription(subscription.toJSON(), navigator.userAgent);
+            const updated = await patchNotificationPreferences({ push_opt_in: true });
+            setPreferences(updated);
+            setPushSubscribed(true);
+        }
+        catch (requestError) {
+            if (((_a = requestError === null || requestError === void 0 ? void 0 : requestError.response) === null || _a === void 0 ? void 0 : _a.status) === 409) {
+                setConflict(t('NotificationSettings.PUSH_CONFLICT'));
+            }
+            else {
+                setError(t('NotificationSettings.PUSH_ERROR'));
+            }
+        }
+        finally {
+            setSavingPush(false);
+        }
+    };
+    const handleDisablePush = async () => {
+        setSavingPush(true);
+        setError('');
+        setConflict('');
+        try {
+            const registration = await navigator.serviceWorker.ready;
+            const subscription = await registration.pushManager.getSubscription();
+            if (subscription) {
+                const endpoint = subscription.endpoint;
+                await subscription.unsubscribe();
+                await removePushSubscription({ endpoint });
+            }
+            setPushSubscribed(false);
+        }
+        catch (_a) {
+            setError(t('NotificationSettings.PUSH_ERROR'));
+        }
+        finally {
+            setSavingPush(false);
+        }
+    };
+    if (loading) {
+        return _jsx(Box, { sx: { display: 'flex', justifyContent: 'center', py: 4 }, children: _jsx(CircularProgress, {}) });
+    }
+    return (_jsxs(Box, { sx: { maxWidth: 520 }, children: [_jsxs(Typography, { variant: "h6", gutterBottom: true, sx: { display: 'flex', alignItems: 'center', gap: 1 }, children: [_jsx(NotificationsIcon, {}), t('NotificationSettings.TITLE')] }), _jsx(Typography, { variant: "body2", color: "text.secondary", gutterBottom: true, children: t('NotificationSettings.SUBTITLE') }), error && _jsx(Alert, { severity: "error", sx: { mb: 2 }, onClose: () => setError(''), children: error }), conflict && _jsx(Alert, { severity: "warning", sx: { mb: 2 }, onClose: () => setConflict(''), children: conflict }), _jsx(Box, { sx: { py: 2 }, children: _jsx(FormControlLabel, { control: _jsx(Switch, { checked: Boolean(preferences === null || preferences === void 0 ? void 0 : preferences.email_opt_in), onChange: handleEmailToggle, disabled: savingEmail }), label: _jsxs(Box, { children: [_jsx(Typography, { variant: "body1", children: t('NotificationSettings.EMAIL_LABEL') }), _jsx(Typography, { variant: "caption", color: "text.secondary", children: t('NotificationSettings.EMAIL_HINT') })] }), labelPlacement: "end", sx: { alignItems: 'flex-start', ml: 0 } }) }), _jsx(Divider, {}), _jsxs(Box, { sx: { py: 2 }, children: [_jsx(Typography, { variant: "body1", gutterBottom: true, children: t('NotificationSettings.PUSH_LABEL') }), _jsx(Typography, { variant: "caption", color: "text.secondary", display: "block", sx: { mb: 1.5 }, children: t('NotificationSettings.PUSH_HINT') }), iosNeedsInstall && _jsx(Alert, { severity: "info", sx: { mb: 1.5 }, children: t('NotificationSettings.IOS_HINT') }), !pushSupported && !iosNeedsInstall && _jsx(Alert, { severity: "warning", children: t('NotificationSettings.PUSH_NOT_SUPPORTED') }), pushSupported && !iosNeedsInstall && (pushSubscribed ? (_jsx(Button, { variant: "outlined", color: "error", onClick: handleDisablePush, disabled: savingPush, startIcon: savingPush ? _jsx(CircularProgress, { size: 16 }) : undefined, children: t('NotificationSettings.PUSH_DISABLE') })) : (_jsx(Button, { variant: "contained", onClick: handleEnablePush, disabled: savingPush, startIcon: savingPush ? _jsx(CircularProgress, { size: 16 }) : undefined, children: t('NotificationSettings.PUSH_ENABLE') })))] })] }));
+}
+export default NotificationSettings;

package/dist/notifications/api.js

@@ -0,0 +1,41 @@
+import apiClient from '../auth/apiClient';
+const PREFERENCES_URL = '/api/notifications/preferences/';
+const PUSH_SUBSCRIPTION_URL = `${PREFERENCES_URL}push-subscription/`;
+export async function getNotificationPreferences() {
+    const response = await apiClient.get(PREFERENCES_URL);
+    return response.data;
+}
+export async function patchNotificationPreferences(patch) {
+    const response = await apiClient.patch(PREFERENCES_URL, patch);
+    return response.data;
+}
+export async function getVapidPublicKey() {
+    var _a;
+    const response = await apiClient.get(`${PREFERENCES_URL}vapid-public-key/`);
+    return (_a = response.data) === null || _a === void 0 ? void 0 : _a.vapidPublicKey;
+}
+export async function listPushSubscriptions() {
+    const response = await apiClient.get(PUSH_SUBSCRIPTION_URL);
+    return response.data;
+}
+export async function savePushSubscription(subscription, ua) {
+    const response = await apiClient.post(PUSH_SUBSCRIPTION_URL, { subscription, ua });
+    return response.data;
+}
+export async function removePushSubscription(subscriptionIdentifier) {
+    const response = await apiClient.delete(PUSH_SUBSCRIPTION_URL, { data: subscriptionIdentifier });
+    return response.data;
+}
+export function urlBase64ToUint8Array(base64String) {
+    const padding = '='.repeat((4 - (base64String.length % 4)) % 4);
+    const base64 = (base64String + padding).replace(/-/g, '+').replace(/_/g, '/');
+    const decoder = typeof window !== 'undefined' && typeof window.atob === 'function'
+        ? window.atob
+        : typeof atob === 'function'
+            ? atob
+            : null;
+    if (!decoder)
+        throw new Error('Base64 decoding is unavailable in this environment.');
+    const raw = decoder(base64);
+    return Uint8Array.from([...raw].map((character) => character.charCodeAt(0)));
+}

package/dist/notifications/serviceWorker/sw.js

@@ -0,0 +1,49 @@
+"use strict";
+/*
+ * Canonical service-worker source. Copy this file verbatim to each consuming
+ * application's public/sw.js so it is served from that application's origin root.
+ */
+const resolveSameOriginUrl = (url) => {
+    try {
+        const resolvedUrl = new URL(url || '/', self.location.origin);
+        if (resolvedUrl.origin !== self.location.origin)
+            return '/';
+        return `${resolvedUrl.pathname}${resolvedUrl.search}${resolvedUrl.hash}`;
+    }
+    catch (_a) {
+        return '/';
+    }
+};
+self.addEventListener('push', (event) => {
+    if (!event.data)
+        return;
+    let payload;
+    try {
+        payload = event.data.json();
+    }
+    catch (_a) {
+        payload = { body: event.data.text() };
+    }
+    const options = {
+        body: payload.body || '',
+        data: { url: resolveSameOriginUrl(payload.url) },
+    };
+    if (payload.icon)
+        options.icon = payload.icon;
+    if (payload.badge)
+        options.badge = payload.badge;
+    event.waitUntil(self.registration.showNotification(payload.title || 'Notification', options));
+});
+self.addEventListener('notificationclick', (event) => {
+    var _a;
+    event.notification.close();
+    const url = resolveSameOriginUrl((_a = event.notification.data) === null || _a === void 0 ? void 0 : _a.url);
+    event.waitUntil(clients.matchAll({ type: 'window', includeUncontrolled: true }).then((clientList) => {
+        for (const client of clientList) {
+            if (client.url.includes(self.location.origin) && 'focus' in client) {
+                return Promise.resolve(client.navigate(url)).then(() => client.focus());
+            }
+        }
+        return clients.openWindow ? clients.openWindow(url) : undefined;
+    }));
+});

package/dist/onboarding/OnboardingProvider.js

@@ -0,0 +1,133 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { createContext, useCallback, useContext, useEffect, useMemo, useState, } from 'react';
+import { AuthContext } from '../auth/AuthContext';
+import { getOnboardingStepConfig } from './api';
+import { selectActiveSteps } from './stepSelection';
+import CookieConsentStep from './steps/CookieConsentStep';
+import CompleteNameStep from './steps/CompleteNameStep';
+import BrowserPushStep from './steps/BrowserPushStep';
+export const UNIVERSAL_STEP_DESCRIPTORS = [
+    {
+        id: 'cookie_consent',
+        condition: (ctx) => Boolean(ctx.user && !ctx.user.accepted_convenience_cookies),
+        blocking: true,
+        skipable: false,
+        persistDismissed: false,
+        titleKey: 'Onboarding.COOKIE_CONSENT_TITLE',
+        Component: CookieConsentStep,
+    },
+    {
+        id: 'complete_name',
+        condition: (ctx) => { var _a, _b; return Boolean(ctx.user && (!((_a = ctx.user.first_name) === null || _a === void 0 ? void 0 : _a.trim()) || !((_b = ctx.user.last_name) === null || _b === void 0 ? void 0 : _b.trim()))); },
+        blocking: true,
+        skipable: false,
+        persistDismissed: false,
+        titleKey: 'Onboarding.COMPLETE_NAME_TITLE',
+        Component: CompleteNameStep,
+    },
+    {
+        id: 'browser_push',
+        condition: (ctx) => { var _a; return Boolean(((_a = ctx.pushState) === null || _a === void 0 ? void 0 : _a.supported) && !ctx.pushState.subscribed); },
+        blocking: false,
+        skipable: true,
+        persistDismissed: true,
+        titleKey: 'Onboarding.BROWSER_PUSH_TITLE',
+        Component: BrowserPushStep,
+    },
+];
+export const OnboardingContext = createContext(null);
+export function useOnboarding() {
+    return useContext(OnboardingContext);
+}
+function loadDismissedSteps() {
+    if (typeof window === 'undefined')
+        return new Set();
+    try {
+        return new Set(JSON.parse(window.localStorage.getItem('onboarding_dismissed')) || []);
+    }
+    catch (_a) {
+        return new Set();
+    }
+}
+function getInitialPushState() {
+    const supported = typeof navigator !== 'undefined'
+        && typeof window !== 'undefined'
+        && 'serviceWorker' in navigator
+        && 'PushManager' in window;
+    return supported ? null : { supported: false, subscribed: false };
+}
+export function OnboardingProvider({ children, extraSteps = [] }) {
+    const { user } = useContext(AuthContext);
+    const [configMap, setConfigMap] = useState({});
+    const [configLoaded, setConfigLoaded] = useState(false);
+    const [pushState, setPushState] = useState(getInitialPushState);
+    const [dismissedSet, setDismissedSet] = useState(loadDismissedSteps);
+    const descriptors = useMemo(() => [...UNIVERSAL_STEP_DESCRIPTORS, ...extraSteps], [extraSteps]);
+    useEffect(() => {
+        let cancelled = false;
+        if (!user) {
+            setConfigMap({});
+            setConfigLoaded(false);
+            return undefined;
+        }
+        getOnboardingStepConfig()
+            .then((data) => {
+            if (cancelled)
+                return;
+            const nextConfigMap = {};
+            (data || []).forEach((item) => { nextConfigMap[item.key] = item.enabled; });
+            setConfigMap(nextConfigMap);
+        })
+            .catch(() => {
+            if (!cancelled)
+                setConfigMap({});
+        })
+            .finally(() => {
+            if (!cancelled)
+                setConfigLoaded(true);
+        });
+        return () => { cancelled = true; };
+    }, [user]);
+    useEffect(() => {
+        let cancelled = false;
+        if (typeof navigator === 'undefined' || typeof window === 'undefined'
+            || !('serviceWorker' in navigator) || !('PushManager' in window)) {
+            setPushState({ supported: false, subscribed: false });
+            return undefined;
+        }
+        navigator.serviceWorker.ready
+            .then((registration) => registration.pushManager.getSubscription())
+            .then((subscription) => {
+            if (!cancelled)
+                setPushState({ supported: true, subscribed: Boolean(subscription) });
+        })
+            .catch(() => {
+            if (!cancelled)
+                setPushState({ supported: true, subscribed: false });
+        });
+        return () => { cancelled = true; };
+    }, []);
+    const dismissStep = useCallback((id) => {
+        setDismissedSet((previous) => {
+            const next = new Set(previous);
+            next.add(id);
+            if (typeof window !== 'undefined') {
+                try {
+                    window.localStorage.setItem('onboarding_dismissed', JSON.stringify([...next]));
+                }
+                catch (_a) {
+                    // Persistence is optional; the in-memory dismissal still applies.
+                }
+            }
+            return next;
+        });
+    }, []);
+    const ctx = useMemo(() => ({ user, pushState }), [user, pushState]);
+    const activeSteps = useMemo(() => {
+        if (!configLoaded || !user)
+            return [];
+        return selectActiveSteps(descriptors, configMap, ctx, dismissedSet);
+    }, [configLoaded, user, descriptors, configMap, ctx, dismissedSet]);
+    const value = useMemo(() => ({ activeSteps, dismissStep, ctx, configMap, setConfigMap }), [activeSteps, dismissStep, ctx, configMap]);
+    return _jsx(OnboardingContext.Provider, { value: value, children: children });
+}

package/dist/onboarding/OnboardingWizard.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React, { useEffect, useRef, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import Box from '@mui/material/Box';
+import Dialog from '@mui/material/Dialog';
+import DialogContent from '@mui/material/DialogContent';
+import DialogTitle from '@mui/material/DialogTitle';
+import LinearProgress from '@mui/material/LinearProgress';
+import Typography from '@mui/material/Typography';
+import { useOnboarding } from './OnboardingProvider';
+export function OnboardingWizard() {
+    const { t } = useTranslation();
+    const onboarding = useOnboarding();
+    const [sessionDismissed, setSessionDismissed] = useState(() => new Set());
+    const totalRef = useRef(null);
+    const [completed, setCompleted] = useState(0);
+    const activeSteps = (onboarding === null || onboarding === void 0 ? void 0 : onboarding.activeSteps) || [];
+    const visibleSteps = activeSteps.filter((step) => !sessionDismissed.has(step.id));
+    useEffect(() => {
+        if (visibleSteps.length > 0 && totalRef.current === null) {
+            totalRef.current = visibleSteps.length;
+            setCompleted(0);
+        }
+        if (visibleSteps.length === 0) {
+            totalRef.current = null;
+            setCompleted(0);
+        }
+    }, [visibleSteps.length]);
+    if (!onboarding || visibleSteps.length === 0)
+        return null;
+    const { dismissStep, ctx } = onboarding;
+    const currentStep = visibleSteps[0];
+    const total = totalRef.current || visibleSteps.length;
+    const progress = total > 1 ? Math.round((completed / total) * 100) : 0;
+    const StepComponent = currentStep.Component;
+    const completeCurrentStep = () => {
+        setSessionDismissed((previous) => new Set([...previous, currentStep.id]));
+        setCompleted((count) => count + 1);
+    };
+    const dismissCurrentStep = () => {
+        if (currentStep.persistDismissed)
+            dismissStep(currentStep.id);
+        completeCurrentStep();
+    };
+    return (_jsxs(Dialog, { open: true, fullWidth: true, maxWidth: "sm", disableEscapeKeyDown: currentStep.blocking, onClose: currentStep.blocking ? undefined : dismissCurrentStep, children: [_jsxs(DialogTitle, { sx: { pb: 0 }, children: [_jsx(Box, { sx: { display: 'flex', alignItems: 'center', justifyContent: 'space-between' }, children: _jsx(Typography, { variant: "subtitle2", color: "text.secondary", children: total > 1 ? t('Onboarding.STEP_COUNTER', { current: completed + 1, total }) : t('Onboarding.SETUP') }) }), total > 1 && _jsx(LinearProgress, { variant: "determinate", value: progress, sx: { mt: 1, borderRadius: 1 } })] }), _jsx(DialogContent, { sx: { pt: 2 }, children: _jsx(StepComponent, { onComplete: completeCurrentStep, onDismiss: dismissCurrentStep, ctx: ctx }) })] }));
+}
+export default OnboardingWizard;

package/dist/onboarding/api.js

@@ -0,0 +1,10 @@
+import apiClient from '../auth/apiClient';
+const STEP_CONFIG_URL = '/api/onboarding/step-config/';
+export async function getOnboardingStepConfig() {
+    const response = await apiClient.get(STEP_CONFIG_URL);
+    return response.data;
+}
+export async function patchOnboardingStepConfig(payload) {
+    const response = await apiClient.patch(STEP_CONFIG_URL, payload);
+    return response.data;
+}

package/dist/onboarding/stepSelection.js

@@ -0,0 +1,18 @@
+/**
+ * Pure onboarding step selection.
+ *
+ * @param {Array} descriptors Step descriptors in display order.
+ * @param {Object} configMap Enabled state keyed by dcm onboarding step key.
+ * @param {Object} ctx Runtime context supplied to each step condition.
+ * @param {Set} dismissedSet Persistently dismissed step ids.
+ * @returns {Array} Steps that should be shown.
+ */
+export function selectActiveSteps(descriptors, configMap, ctx, dismissedSet = new Set()) {
+    return descriptors.filter((step) => {
+        if (configMap[step.id] === false)
+            return false;
+        if (step.persistDismissed && dismissedSet.has(step.id))
+            return false;
+        return step.condition(ctx);
+    });
+}

package/dist/onboarding/steps/BrowserPushStep.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React, { useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import Alert from '@mui/material/Alert';
+import Box from '@mui/material/Box';
+import Button from '@mui/material/Button';
+import CircularProgress from '@mui/material/CircularProgress';
+import Typography from '@mui/material/Typography';
+import NotificationsIcon from '@mui/icons-material/Notifications';
+import { getVapidPublicKey, patchNotificationPreferences, savePushSubscription, urlBase64ToUint8Array, } from '../../notifications/api';
+export function BrowserPushStep({ onComplete, onDismiss }) {
+    const { t } = useTranslation();
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState('');
+    const enable = async () => {
+        var _a;
+        setLoading(true);
+        setError('');
+        try {
+            const permission = await Notification.requestPermission();
+            if (permission !== 'granted') {
+                setError(t('NotificationSettings.PUSH_DENIED'));
+                return;
+            }
+            const vapidPublicKey = await getVapidPublicKey();
+            const registration = await navigator.serviceWorker.ready;
+            const subscription = await registration.pushManager.subscribe({
+                userVisibleOnly: true,
+                applicationServerKey: urlBase64ToUint8Array(vapidPublicKey),
+            });
+            await savePushSubscription(subscription.toJSON(), navigator.userAgent);
+            await patchNotificationPreferences({ push_opt_in: true });
+            onComplete();
+        }
+        catch (requestError) {
+            if (((_a = requestError === null || requestError === void 0 ? void 0 : requestError.response) === null || _a === void 0 ? void 0 : _a.status) === 409) {
+                setError(t('NotificationSettings.PUSH_CONFLICT'));
+            }
+            else {
+                setError(t('NotificationSettings.PUSH_ERROR'));
+            }
+        }
+        finally {
+            setLoading(false);
+        }
+    };
+    return (_jsxs(Box, { sx: { display: 'flex', flexDirection: 'column', gap: 2 }, children: [_jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 1 }, children: [_jsx(NotificationsIcon, { color: "primary" }), _jsx(Typography, { variant: "h6", children: t('Onboarding.BROWSER_PUSH_TITLE') })] }), _jsx(Typography, { variant: "body2", color: "text.secondary", children: t('Onboarding.BROWSER_PUSH_BODY') }), error && _jsx(Alert, { severity: "warning", onClose: () => setError(''), children: error }), _jsxs(Box, { sx: { display: 'flex', justifyContent: 'flex-end', gap: 1 }, children: [_jsx(Button, { variant: "text", onClick: onDismiss, disabled: loading, children: t('Onboarding.SKIP') }), _jsx(Button, { variant: "contained", onClick: enable, disabled: loading, startIcon: loading ? _jsx(CircularProgress, { size: 16 }) : undefined, children: t('NotificationSettings.PUSH_ENABLE') })] })] }));
+}
+export default BrowserPushStep;

package/dist/onboarding/steps/CompleteNameStep.js

@@ -0,0 +1,37 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React, { useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import Alert from '@mui/material/Alert';
+import Box from '@mui/material/Box';
+import Button from '@mui/material/Button';
+import CircularProgress from '@mui/material/CircularProgress';
+import TextField from '@mui/material/TextField';
+import Typography from '@mui/material/Typography';
+import PersonIcon from '@mui/icons-material/Person';
+import { updateUserProfile } from '../../auth/authApi';
+export function CompleteNameStep({ onComplete }) {
+    const { t } = useTranslation();
+    const [firstName, setFirstName] = useState('');
+    const [lastName, setLastName] = useState('');
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState('');
+    const submit = async (event) => {
+        event.preventDefault();
+        if (!firstName.trim() || !lastName.trim())
+            return;
+        setLoading(true);
+        setError('');
+        try {
+            await updateUserProfile({ first_name: firstName.trim(), last_name: lastName.trim() });
+            onComplete();
+        }
+        catch (_a) {
+            setError(t('Onboarding.COMPLETE_NAME_ERROR'));
+        }
+        finally {
+            setLoading(false);
+        }
+    };
+    return (_jsxs(Box, { component: "form", onSubmit: submit, sx: { display: 'flex', flexDirection: 'column', gap: 2 }, children: [_jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 1 }, children: [_jsx(PersonIcon, { color: "primary" }), _jsx(Typography, { variant: "h6", children: t('Onboarding.COMPLETE_NAME_TITLE') })] }), _jsx(Typography, { variant: "body2", color: "text.secondary", children: t('Onboarding.COMPLETE_NAME_BODY') }), error && _jsx(Alert, { severity: "error", onClose: () => setError(''), children: error }), _jsx(TextField, { label: t('Onboarding.FIRST_NAME_LABEL'), value: firstName, onChange: (event) => setFirstName(event.target.value), required: true, fullWidth: true, size: "small" }), _jsx(TextField, { label: t('Onboarding.LAST_NAME_LABEL'), value: lastName, onChange: (event) => setLastName(event.target.value), required: true, fullWidth: true, size: "small" }), _jsx(Box, { sx: { display: 'flex', justifyContent: 'flex-end' }, children: _jsx(Button, { variant: "contained", type: "submit", disabled: loading || !firstName.trim() || !lastName.trim(), startIcon: loading ? _jsx(CircularProgress, { size: 16 }) : undefined, children: t('Onboarding.SAVE') }) })] }));
+}
+export default CompleteNameStep;

package/dist/onboarding/steps/CookieConsentStep.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React, { useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import Alert from '@mui/material/Alert';
+import Box from '@mui/material/Box';
+import Button from '@mui/material/Button';
+import CircularProgress from '@mui/material/CircularProgress';
+import Typography from '@mui/material/Typography';
+import CookieIcon from '@mui/icons-material/Cookie';
+import { updateUserProfile } from '../../auth/authApi';
+export function CookieConsentStep({ onComplete }) {
+    const { t } = useTranslation();
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState('');
+    const accept = async () => {
+        setLoading(true);
+        setError('');
+        try {
+            await updateUserProfile({ accepted_convenience_cookies: true });
+            onComplete();
+        }
+        catch (_a) {
+            setError(t('Onboarding.COOKIE_CONSENT_ERROR'));
+        }
+        finally {
+            setLoading(false);
+        }
+    };
+    return (_jsxs(Box, { sx: { display: 'flex', flexDirection: 'column', gap: 2 }, children: [_jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 1 }, children: [_jsx(CookieIcon, { color: "primary" }), _jsx(Typography, { variant: "h6", children: t('Onboarding.COOKIE_CONSENT_TITLE') })] }), _jsx(Typography, { variant: "body2", color: "text.secondary", children: t('Onboarding.COOKIE_CONSENT_BODY') }), error && _jsx(Alert, { severity: "error", onClose: () => setError(''), children: error }), _jsx(Box, { sx: { display: 'flex', justifyContent: 'flex-end' }, children: _jsx(Button, { variant: "contained", onClick: accept, disabled: loading, startIcon: loading ? _jsx(CircularProgress, { size: 16 }) : undefined, children: t('Onboarding.COOKIE_CONSENT_ACCEPT') }) })] }));
+}
+export default CookieConsentStep;