@marinoscar/platform-web 0.0.0-stage → 0.1.0-next.4

package/dist/doctor/ui/doctor-page.js

@@ -0,0 +1,156 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+// =============================================================================
+// The Doctor page (issue #634; packaged by #696)
+// =============================================================================
+//
+// The question it answers: is every capability configured, reachable and
+// healthy? One row per check, grouped by category, with the remedy and a link
+// to the settings page that fixes it.
+//
+// ⚠ A FAILING CHECK IS NOT A PAGE ERROR. The endpoint answers 200 with a
+// `fail` verdict; that renders as the verdict Alert and the rows below it. The
+// page-level error Alert is reserved for a request that actually failed.
+//
+// THE PAGE DOES NOT CHECK PERMISSIONS: the app's route gate does
+// (`doctorSettingsPage.card.permission`). It never imports app context, layout
+// or navigation; everything comes from `usePlatformHost()`, and links use
+// react-router's `Link`.
+//
+// Deliberately NOT feature-gated: the page reports on AI and telemetry while
+// they are switched off (as `skip`), which is precisely when an admin asks
+// why a capability is missing.
+// =============================================================================
+import { useMemo, useState } from 'react';
+import { Accordion, AccordionDetails, AccordionSummary, Alert, AlertTitle, Box, Button, Chip, CircularProgress, Container, FormControlLabel, Skeleton, Stack, Switch, Typography, } from '@mui/material';
+import ExpandMoreIcon from '@mui/icons-material/ExpandMore';
+import RefreshIcon from '@mui/icons-material/Refresh';
+import { DOCTOR_STATUS_RANK } from '@marinoscar/platform-contract/doctor';
+import { useOptionalPlatformHost } from '../../core/index.js';
+import { PLATFORM_DOCTOR_CATEGORY_LABELS, categoryLabel, useDoctor, } from '../headless/index.js';
+import { formatRelativeTime as fallbackRelativeTime } from '../internal/relative-time.js';
+import { CheckRow, STATUS_LABELS, StatusIcon, statusChipSx } from './check-row.js';
+import { DOCTOR_PAGE_DESCRIPTION, DOCTOR_PAGE_TITLE } from './copy.js';
+import { SupportBundleButton } from './support-bundle-button.js';
+function isProblem(status) {
+    return status === 'warn' || status === 'fail';
+}
+function worstStatus(checks) {
+    let worst = 'pass';
+    for (const check of checks) {
+        if (DOCTOR_STATUS_RANK[check.status] > DOCTOR_STATUS_RANK[worst]) {
+            worst = check.status;
+        }
+    }
+    return worst;
+}
+/** Known categories in display order, then unknown ones in the order the API sent them. */
+function groupByCategory(checks, labels) {
+    const byKey = new Map();
+    for (const check of checks) {
+        const list = byKey.get(check.category);
+        if (list)
+            list.push(check);
+        else
+            byKey.set(check.category, [check]);
+    }
+    const knownKeys = labels.map((category) => category.key);
+    const ordered = [
+        ...knownKeys.filter((key) => byKey.has(key)),
+        ...[...byKey.keys()].filter((key) => !knownKeys.includes(key)),
+    ];
+    return ordered.map((key) => ({ key, label: categoryLabel(key, labels), checks: byKey.get(key) ?? [] }));
+}
+function countByStatus(checks) {
+    const counts = { pass: 0, skip: 0, warn: 0, fail: 0 };
+    for (const check of checks)
+        counts[check.status] += 1;
+    return counts;
+}
+function verdictSeverity(verdict) {
+    switch (verdict) {
+        case 'fail':
+            return 'error';
+        case 'warn':
+            return 'warning';
+        case 'skip':
+            return 'info';
+        default:
+            return 'success';
+    }
+}
+function verdictTitle(report, counts) {
+    const problems = counts.warn + counts.fail;
+    if (problems > 0) {
+        return problems === 1 ? '1 problem needs attention' : `${problems} problems need attention`;
+    }
+    if (counts.skip > 0 || report.verdict === 'skip') {
+        return 'No problems found; some checks were skipped';
+    }
+    return 'All checks passed';
+}
+function formatReportDuration(ms) {
+    if (!Number.isFinite(ms) || ms < 0)
+        return '—';
+    if (ms < 1000)
+        return `${Math.round(ms)} ms`;
+    return `${(ms / 1000).toFixed(1)} s`;
+}
+function DefaultHeader({ title, description }) {
+    return (_jsxs(_Fragment, { children: [_jsx(Typography, { variant: "h4", component: "h1", gutterBottom: true, children: title }), _jsx(Typography, { color: "text.secondary", sx: { mb: 3 }, children: description })] }));
+}
+function LoadingSkeleton() {
+    return (_jsxs(Stack, { spacing: 2, "data-testid": "doctor-loading", "aria-busy": "true", "aria-label": "Running checks", children: [_jsx(Skeleton, { variant: "rounded", height: 72 }), _jsx(Skeleton, { variant: "rounded", height: 32, width: "60%" }), [0, 1, 2].map((index) => (_jsx(Skeleton, { variant: "rounded", height: 56 }, index)))] }));
+}
+/**
+ * The admin Doctor page: runs the checks, shows the verdict, the counts by
+ * status, one accordion per category (problems expanded) and a "Problems only"
+ * filter. Reads the app through `usePlatformHost()`; the app's route gates it.
+ *
+ * @param props - see {@link DoctorPageProps}.
+ * @returns the page.
+ *
+ * @example
+ * ```tsx
+ * <Route path={doctorSettingsPage.card.path} element={<DoctorPage />} />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function DoctorPage(props = {}) {
+    const { categories = PLATFORM_DOCTOR_CATEGORY_LABELS, sx, slots } = props;
+    const host = useOptionalPlatformHost();
+    const formatRelativeTime = host?.formatRelativeTime ?? fallbackRelativeTime;
+    const Header = slots?.Header ?? DefaultHeader;
+    const BeforeContent = slots?.BeforeContent;
+    const Sections = slots?.Sections;
+    const AfterContent = slots?.AfterContent;
+    const CheckRowActions = slots?.CheckRowActions;
+    const { report, isLoading, error, rerun } = useDoctor();
+    const [problemsOnly, setProblemsOnly] = useState(false);
+    // Only the categories the admin has toggled; the rest follow the default
+    // (expanded when they contain a problem), which re-derives on each run.
+    const [expandedOverrides, setExpandedOverrides] = useState({});
+    const checks = useMemo(() => report?.checks ?? [], [report]);
+    const counts = useMemo(() => countByStatus(checks), [checks]);
+    // Grouped from ALL checks so each category's summary stays truthful; the
+    // "Problems only" filter is applied per category below.
+    const groups = useMemo(() => groupByCategory(checks, categories)
+        .map((group) => ({
+        ...group,
+        visible: problemsOnly ? group.checks.filter((check) => isProblem(check.status)) : group.checks,
+    }))
+        .filter((group) => group.visible.length > 0), [checks, categories, problemsOnly]);
+    const handleRerun = () => {
+        setExpandedOverrides({});
+        void rerun();
+    };
+    return (_jsx(Container, { maxWidth: "lg", children: _jsxs(Box, { sx: [{ py: { xs: 2, sm: 4 } }, ...(Array.isArray(sx) ? sx : sx ? [sx] : [])], "data-testid": "doctor-page", children: [_jsx(Header, { title: DOCTOR_PAGE_TITLE, description: DOCTOR_PAGE_DESCRIPTION, actions: null }), BeforeContent && _jsx(BeforeContent, {}), Sections && _jsx(Sections, { position: "top" }), _jsxs(Stack, { direction: { xs: 'column', sm: 'row' }, spacing: { xs: 1, sm: 2 }, sx: { mb: 3, alignItems: { xs: 'stretch', sm: 'flex-start' } }, children: [_jsx(Button, { variant: "contained", onClick: handleRerun, disabled: isLoading, startIcon: isLoading ? _jsx(CircularProgress, { size: 16, color: "inherit" }) : _jsx(RefreshIcon, {}), children: isLoading ? 'Running checks…' : 'Run again' }), _jsx(SupportBundleButton, {}), report && (_jsxs(Typography, { variant: "body2", color: "text.secondary", sx: { pt: { sm: 1 } }, "data-testid": "doctor-generated", children: ["Generated ", formatRelativeTime(report.generatedAt), " \u00B7 took ", formatReportDuration(report.durationMs)] }))] }), error && (_jsx(Alert, { severity: "error", sx: { mb: 3 }, "data-testid": "doctor-request-error", action: _jsx(Button, { color: "inherit", size: "small", onClick: handleRerun, disabled: isLoading, children: "Retry" }), children: error })), isLoading && !report && _jsx(LoadingSkeleton, {}), report && (_jsxs(Stack, { spacing: 3, children: [_jsx(Alert, { severity: verdictSeverity(report.verdict), role: "status", "aria-live": "polite", "data-testid": "doctor-verdict", children: _jsx(AlertTitle, { sx: { mb: 0 }, children: verdictTitle(report, counts) }) }), _jsxs(Stack, { direction: { xs: 'column', sm: 'row' }, spacing: { xs: 1, sm: 2 }, sx: { alignItems: { xs: 'flex-start', sm: 'center' }, justifyContent: 'space-between' }, children: [_jsx(Stack, { direction: "row", spacing: 1, useFlexGap: true, sx: { flexWrap: 'wrap' }, "aria-label": "Checks by status", "data-testid": "doctor-summary", children: ['pass', 'warn', 'fail', 'skip'].map((status) => (_jsx(Chip, { size: "small", variant: "outlined", icon: _jsx(StatusIcon, { status: status }), sx: statusChipSx(status), label: `${STATUS_LABELS[status]}: ${counts[status]}`, "data-testid": `doctor-count-${status}` }, status))) }), _jsx(FormControlLabel, { control: _jsx(Switch, { checked: problemsOnly, onChange: (event) => setProblemsOnly(event.target.checked) }), label: "Problems only" })] }), groups.length === 0 && (_jsx(Typography, { color: "text.secondary", "data-testid": "doctor-empty", children: problemsOnly ? 'No warnings or failures.' : 'No checks were reported.' })), _jsx(Box, { children: groups.map((group) => {
+                                const worst = worstStatus(group.checks);
+                                const expanded = expandedOverrides[group.key] ?? isProblem(worst);
+                                const headingId = `doctor-category-${group.key}-heading`;
+                                const groupCounts = countByStatus(group.checks);
+                                return (_jsxs(Accordion, { expanded: expanded, onChange: (_event, isExpanded) => setExpandedOverrides((previous) => ({ ...previous, [group.key]: isExpanded })), disableGutters: true, "data-testid": `doctor-category-${group.key}`, children: [_jsx(AccordionSummary, { expandIcon: _jsx(ExpandMoreIcon, {}), "aria-controls": `doctor-category-${group.key}-content`, id: headingId, children: _jsxs(Stack, { direction: "row", spacing: 1.5, useFlexGap: true, sx: { alignItems: 'center', flexWrap: 'wrap', minWidth: 0 }, children: [_jsx(StatusIcon, { status: worst }), _jsx(Typography, { variant: "subtitle1", component: "h2", children: group.label }), _jsxs(Typography, { variant: "body2", color: "text.secondary", children: [groupCounts.pass, "/", group.checks.length, " passed"] })] }) }), _jsx(AccordionDetails, { id: `doctor-category-${group.key}-content`, children: _jsx(Stack, { component: "ul", spacing: 2, sx: { m: 0, p: 0 }, children: group.visible.map((check) => (_jsx(CheckRow, { check: check, Actions: CheckRowActions }, check.id))) }) })] }, group.key));
+                            }) })] })), Sections && _jsx(Sections, { position: "bottom" }), AfterContent && _jsx(AfterContent, {})] }) }));
+}
+//# sourceMappingURL=doctor-page.js.map

package/dist/doctor/ui/doctor-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-page.js","sourceRoot":"","sources":["../../../src/doctor/ui/doctor-page.tsx"],"names":[],"mappings":"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"}

package/dist/doctor/ui/index.d.ts

@@ -0,0 +1,8 @@
+export { DoctorPage } from './doctor-page.js';
+export type { DoctorPageHeaderProps, DoctorPageProps, DoctorPageSlots } from './doctor-page.js';
+export { CheckRow, STATUS_CHIP_COLORS, STATUS_LABELS, StatusIcon } from './check-row.js';
+export type { CheckRowProps, DoctorCheckActionsSlotProps } from './check-row.js';
+export { doctorSettingsPage } from './settings-page.js';
+export { SUPPORT_BUNDLE_HELPER_TEXT, SupportBundleButton } from './support-bundle-button.js';
+export type { SupportBundleButtonProps } from './support-bundle-button.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/doctor/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/doctor/ui/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACzF,YAAY,EAAE,aAAa,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,YAAY,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/doctor/ui/index.js

@@ -0,0 +1,7 @@
+// `@marinoscar/platform-web/doctor/ui`: the Doctor page, its parts and its
+// settings-page descriptor (issue #696). Documented in ../README.md.
+export { DoctorPage } from './doctor-page.js';
+export { CheckRow, STATUS_CHIP_COLORS, STATUS_LABELS, StatusIcon } from './check-row.js';
+export { doctorSettingsPage } from './settings-page.js';
+export { SUPPORT_BUNDLE_HELPER_TEXT, SupportBundleButton } from './support-bundle-button.js';
+//# sourceMappingURL=index.js.map

package/dist/doctor/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/doctor/ui/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,qEAAqE;AAErE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/doctor/ui/settings-page.d.ts

@@ -0,0 +1,20 @@
+import type { PlatformSettingsPage } from '../../core/index.js';
+/**
+ * The Doctor as a packaged settings page: the app appends
+ * `{ ...doctorSettingsPage.card, Icon: doctorSettingsPage.Icon }` to its admin
+ * registry and routes `card.path` to `Page` behind its permission gate for
+ * `card.permission` (`system_settings:read`, the exact string
+ * `@marinoscar/platform-api/doctor` enforces by default). No `feature`: the
+ * Doctor reports on AI and telemetry while they are off.
+ *
+ * @example
+ * ```tsx
+ * // apps/web/src/config/adminSections.tsx (Observability, last card)
+ * { ...doctorSettingsPage.card, Icon: doctorSettingsPage.Icon },
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare const doctorSettingsPage: PlatformSettingsPage<never>;
+//# sourceMappingURL=settings-page.d.ts.map

package/dist/doctor/ui/settings-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-page.d.ts","sourceRoot":"","sources":["../../../src/doctor/ui/settings-page.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAIhE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,EAAE,oBAAoB,CAAC,KAAK,CAU1D,CAAC"}

package/dist/doctor/ui/settings-page.js

@@ -0,0 +1,32 @@
+import HealthAndSafetyOutlinedIcon from '@mui/icons-material/HealthAndSafetyOutlined';
+import { DOCTOR_PAGE_DESCRIPTION, DOCTOR_PAGE_TITLE } from './copy.js';
+import { DoctorPage } from './doctor-page.js';
+/**
+ * The Doctor as a packaged settings page: the app appends
+ * `{ ...doctorSettingsPage.card, Icon: doctorSettingsPage.Icon }` to its admin
+ * registry and routes `card.path` to `Page` behind its permission gate for
+ * `card.permission` (`system_settings:read`, the exact string
+ * `@marinoscar/platform-api/doctor` enforces by default). No `feature`: the
+ * Doctor reports on AI and telemetry while they are off.
+ *
+ * @example
+ * ```tsx
+ * // apps/web/src/config/adminSections.tsx (Observability, last card)
+ * { ...doctorSettingsPage.card, Icon: doctorSettingsPage.Icon },
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export const doctorSettingsPage = {
+    id: 'doctor',
+    card: {
+        title: DOCTOR_PAGE_TITLE,
+        description: DOCTOR_PAGE_DESCRIPTION,
+        path: '/admin/settings/doctor',
+        permission: 'system_settings:read',
+    },
+    Icon: HealthAndSafetyOutlinedIcon,
+    Page: DoctorPage,
+};
+//# sourceMappingURL=settings-page.js.map

package/dist/doctor/ui/settings-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-page.js","sourceRoot":"","sources":["../../../src/doctor/ui/settings-page.ts"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,MAAM,6CAA6C,CAAC;AAGtF,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE;QACJ,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,uBAAuB;QACpC,IAAI,EAAE,wBAAwB;QAC9B,UAAU,EAAE,sBAAsB;KACnC;IACD,IAAI,EAAE,2BAA2B;IACjC,IAAI,EAAE,UAAU;CACjB,CAAC"}

package/dist/doctor/ui/support-bundle-button.d.ts

@@ -0,0 +1,37 @@
+import type { SxProps, Theme } from '@mui/material';
+import type { ReactElement } from 'react';
+import type { UseSupportBundleDownloadOptions } from '../headless/index.js';
+/**
+ * The helper text under the button.
+ *
+ * @stability experimental
+ */
+export declare const SUPPORT_BUNDLE_HELPER_TEXT = "Includes the doctor report, versions and a 24-hour telemetry summary. Secrets and personal data are removed.";
+/**
+ * The props of {@link SupportBundleButton}.
+ *
+ * @stability experimental
+ */
+export interface SupportBundleButtonProps {
+    /** Passed to `useSupportBundleDownload` (transport, route, save function). */
+    options?: UseSupportBundleDownloadOptions;
+    /** Styles for the outer stack. */
+    sx?: SxProps<Theme>;
+}
+/**
+ * A "Download support bundle" button with its helper text and, after a
+ * failed download, the reason.
+ *
+ * @param props - see {@link SupportBundleButtonProps}.
+ * @returns the button, its helper text and its error line.
+ *
+ * @example
+ * ```tsx
+ * <SupportBundleButton />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function SupportBundleButton(props?: SupportBundleButtonProps): ReactElement;
+//# sourceMappingURL=support-bundle-button.d.ts.map

package/dist/doctor/ui/support-bundle-button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-bundle-button.d.ts","sourceRoot":"","sources":["../../../src/doctor/ui/support-bundle-button.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AAE5E;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,iHACyE,CAAC;AAEjH;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,+BAA+B,CAAC;IAC1C,kCAAkC;IAClC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,GAAE,wBAA6B,GAAG,YAAY,CAyBtF"}

package/dist/doctor/ui/support-bundle-button.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// "Download support bundle" (issue #772): the Doctor page's second header
+// action, next to "Run again". Visible to anyone who can see the page (the
+// route needs the Doctor's own permission, `system_settings:read`); a section
+// the viewer may not read (telemetry without `telemetry:query`) is omitted by
+// the API, not hidden here.
+//
+// The download is a file; nothing here parses or renders the bundle.
+import { Button, CircularProgress, Stack, Typography } from '@mui/material';
+import DownloadIcon from '@mui/icons-material/Download';
+import { useId } from 'react';
+import { useSupportBundleDownload } from '../headless/index.js';
+/**
+ * The helper text under the button.
+ *
+ * @stability experimental
+ */
+export const SUPPORT_BUNDLE_HELPER_TEXT = 'Includes the doctor report, versions and a 24-hour telemetry summary. Secrets and personal data are removed.';
+/**
+ * A "Download support bundle" button with its helper text and, after a
+ * failed download, the reason.
+ *
+ * @param props - see {@link SupportBundleButtonProps}.
+ * @returns the button, its helper text and its error line.
+ *
+ * @example
+ * ```tsx
+ * <SupportBundleButton />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function SupportBundleButton(props = {}) {
+    const { download, isDownloading, error } = useSupportBundleDownload(props.options);
+    const helperId = useId();
+    return (_jsxs(Stack, { spacing: 0.5, sx: props.sx, "data-testid": "doctor-support-bundle", children: [_jsx(Button, { variant: "outlined", onClick: () => void download(), disabled: isDownloading, "aria-describedby": helperId, startIcon: isDownloading ? _jsx(CircularProgress, { size: 16, color: "inherit" }) : _jsx(DownloadIcon, {}), children: isDownloading ? 'Preparing bundle…' : 'Download support bundle' }), _jsx(Typography, { id: helperId, variant: "caption", color: "text.secondary", sx: { maxWidth: 360 }, children: SUPPORT_BUNDLE_HELPER_TEXT }), error && (_jsx(Typography, { variant: "caption", color: "error", role: "alert", "data-testid": "doctor-support-bundle-error", children: error }))] }));
+}
+//# sourceMappingURL=support-bundle-button.js.map

package/dist/doctor/ui/support-bundle-button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-bundle-button.js","sourceRoot":"","sources":["../../../src/doctor/ui/support-bundle-button.tsx"],"names":[],"mappings":";AAAA,0EAA0E;AAC1E,2EAA2E;AAC3E,8EAA8E;AAC9E,8EAA8E;AAC9E,4BAA4B;AAC5B,EAAE;AACF,qEAAqE;AAErE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,YAAY,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAG9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAGhE;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GACrC,8GAA8G,CAAC;AAcjH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAkC,EAAE;IACtE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC;IAEzB,OAAO,CACL,MAAC,KAAK,IAAC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,iBAAc,uBAAuB,aACpE,KAAC,MAAM,IACL,OAAO,EAAC,UAAU,EAClB,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,EAC9B,QAAQ,EAAE,aAAa,sBACL,QAAQ,EAC1B,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,KAAC,gBAAgB,IAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAC,SAAS,GAAG,CAAC,CAAC,CAAC,KAAC,YAAY,KAAG,YAE3F,aAAa,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,yBAAyB,GACzD,EACT,KAAC,UAAU,IAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAC,SAAS,EAAC,KAAK,EAAC,gBAAgB,EAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,YACrF,0BAA0B,GAChB,EACZ,KAAK,IAAI,CACR,KAAC,UAAU,IAAC,OAAO,EAAC,SAAS,EAAC,KAAK,EAAC,OAAO,EAAC,IAAI,EAAC,OAAO,iBAAa,6BAA6B,YAC/F,KAAK,GACK,CACd,IACK,CACT,CAAC;AACJ,CAAC"}

package/dist/email/headless/index.d.ts

@@ -0,0 +1,5 @@
+export { useEmailSettings } from './use-email-settings.js';
+export type { EmailProviderKind, EmailSettings, EmailSettingsInput, EmailTestResult, SmtpPasswordStatus, UseEmailSettingsOptions, UseEmailSettingsReturn, } from './use-email-settings.js';
+export { withTransportDefaults } from './normalize-email-settings.js';
+export type { EmailSettingsWire } from './normalize-email-settings.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/email/headless/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/email/headless/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/email/headless/index.js

@@ -0,0 +1,5 @@
+// `@marinoscar/platform-web/email/headless`: the email settings hook and its
+// types (issue #737, PP-8.4), with no component. Documented in ../README.md.
+export { useEmailSettings } from './use-email-settings.js';
+export { withTransportDefaults } from './normalize-email-settings.js';
+//# sourceMappingURL=index.js.map

package/dist/email/headless/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/email/headless/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAU3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/email/headless/normalize-email-settings.d.ts

@@ -0,0 +1,18 @@
+import type { EmailSettingsResponse } from '@marinoscar/platform-contract/email';
+/**
+ * A response, possibly from an API that predates pluggable transports.
+ *
+ * @stability experimental
+ */
+export type EmailSettingsWire = Omit<EmailSettingsResponse, 'transports' | 'descriptors' | 'secretStatuses'> & Partial<Pick<EmailSettingsResponse, 'transports' | 'descriptors' | 'secretStatuses'>>;
+/**
+ * The response with `transports`, `descriptors` and `secretStatuses` filled in
+ * from the flat fields and the two legacy statuses when the API sent none.
+ *
+ * @param settings - the response.
+ * @returns the same object when it already carries the three fields; otherwise a copy that does.
+ *
+ * @stability experimental
+ */
+export declare function withTransportDefaults(settings: EmailSettingsWire): EmailSettingsResponse;
+//# sourceMappingURL=normalize-email-settings.d.ts.map

package/dist/email/headless/normalize-email-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-email-settings.d.ts","sourceRoot":"","sources":["../../../src/email/headless/normalize-email-settings.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAA4B,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AA+B3G;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,qBAAqB,EAAE,YAAY,GAAG,aAAa,GAAG,gBAAgB,CAAC,GAC1G,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,YAAY,GAAG,aAAa,GAAG,gBAAgB,CAAC,CAAC,CAAC;AAExF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,qBAAqB,CAoBxF"}

package/dist/email/headless/normalize-email-settings.js

@@ -0,0 +1,71 @@
+// =============================================================================
+// Reading a response from an API older than the transports (PP-14.8)
+// =============================================================================
+//
+// `GET /api/email-settings` describes every registered transport (`descriptors`),
+// carries each one's settings (`transports`) and the masked status of each of
+// its secrets (`secretStatuses`). A response from a deployment whose API is
+// older than that carries only the flat `ses*`/`smtp*` fields and the two
+// legacy secret statuses. The page must still draw the two built-in forms for
+// it (the web assets and the API are deployed together, but a rolling update or
+// a cached bundle meets the other version for a while), so this fills in what
+// the old response lacked from what it had. A response that carries the new
+// fields is returned untouched.
+// =============================================================================
+const NO_SECRET = { configured: false, hint: null, updatedAt: null, updatedByUserId: null };
+/** The built-in transports' descriptors, for a response that carried none. */
+const BUILTIN_DESCRIPTORS = [
+    {
+        kind: 'email-transport',
+        id: 'ses',
+        label: 'Amazon SES',
+        fields: [
+            { kind: 'string', name: 'region', label: 'Region' },
+            { kind: 'string', name: 'accessKeyId', label: 'Access Key ID' },
+            { kind: 'secret', name: 'secretAccessKey', label: 'Secret Access Key', hasValue: false, required: true },
+        ],
+    },
+    {
+        kind: 'email-transport',
+        id: 'smtp',
+        label: 'SMTP',
+        fields: [
+            { kind: 'string', name: 'host', label: 'Host' },
+            { kind: 'number', name: 'port', label: 'Port', min: 1, max: 65535, integer: true },
+            { kind: 'boolean', name: 'useTls', label: 'Require TLS' },
+            { kind: 'string', name: 'username', label: 'Username' },
+            { kind: 'secret', name: 'password', label: 'Password', hasValue: false, required: false },
+        ],
+    },
+];
+/**
+ * The response with `transports`, `descriptors` and `secretStatuses` filled in
+ * from the flat fields and the two legacy statuses when the API sent none.
+ *
+ * @param settings - the response.
+ * @returns the same object when it already carries the three fields; otherwise a copy that does.
+ *
+ * @stability experimental
+ */
+export function withTransportDefaults(settings) {
+    if (settings.transports && settings.descriptors && settings.secretStatuses)
+        return settings;
+    return {
+        ...settings,
+        transports: settings.transports ?? {
+            ses: { region: settings.sesRegion ?? '', accessKeyId: settings.sesAccessKeyId ?? '' },
+            smtp: {
+                host: settings.smtpHost ?? '',
+                port: settings.smtpPort ?? 587,
+                useTls: settings.smtpUseTls ?? true,
+                username: settings.smtpUsername ?? '',
+            },
+        },
+        descriptors: settings.descriptors && settings.descriptors.length > 0 ? settings.descriptors : [...BUILTIN_DESCRIPTORS],
+        secretStatuses: settings.secretStatuses ?? {
+            ses: { secretAccessKey: settings.sesSecretAccessKeyStatus ?? NO_SECRET },
+            smtp: { password: settings.smtpPasswordStatus ?? NO_SECRET },
+        },
+    };
+}
+//# sourceMappingURL=normalize-email-settings.js.map

package/dist/email/headless/normalize-email-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-email-settings.js","sourceRoot":"","sources":["../../../src/email/headless/normalize-email-settings.ts"],"names":[],"mappings":"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"}

package/dist/email/headless/use-email-settings.d.ts

@@ -0,0 +1,95 @@
+import type { EmailProviderKind, EmailSettingsResponse, TestEmailResult, UpdateEmailSettingsInput } from '@marinoscar/platform-contract/email';
+import type { PlatformApiClient } from '../../core/index.js';
+/**
+ * The stored email configuration as `GET /api/email-settings` returns it: the
+ * settings, the masked status of both secrets, the repair message and the row
+ * version.
+ *
+ * @stability experimental
+ */
+export type EmailSettings = EmailSettingsResponse;
+/**
+ * The `PUT /api/email-settings` body. A blank or absent `smtpPassword` /
+ * `sesSecretAccessKey` keeps the stored secret.
+ *
+ * @stability experimental
+ */
+export type EmailSettingsInput = UpdateEmailSettingsInput;
+/**
+ * The last test attempt. A real response carries every field; the hook builds
+ * a partial one (`success: false` and the API's message) when the CALL itself
+ * failed (403, 500, a dropped connection), so both land in the same place.
+ *
+ * @stability experimental
+ */
+export type EmailTestResult = Partial<Omit<TestEmailResult, 'success'>> & {
+    /** Whether the provider accepted the message. */
+    success: boolean;
+};
+/**
+ * The masked status of a stored secret.
+ *
+ * @stability experimental
+ */
+export type SmtpPasswordStatus = EmailSettingsResponse['smtpPasswordStatus'];
+export type { EmailProviderKind };
+/**
+ * Options of {@link useEmailSettings}.
+ *
+ * @stability experimental
+ */
+export interface UseEmailSettingsOptions {
+    /** The transport. Default: the `PlatformHostProvider`'s (keep its identity stable). */
+    api?: PlatformApiClient;
+}
+/**
+ * What {@link useEmailSettings} returns.
+ *
+ * @stability experimental
+ */
+export interface UseEmailSettingsReturn {
+    /** The stored configuration, or `null` until loaded. */
+    settings: EmailSettings | null;
+    /** Whether a load is in flight. */
+    isLoading: boolean;
+    /** Failure to LOAD. Distinct from `saveError`: one means "nothing to edit", the other "your edit did not stick". */
+    loadError: string | null;
+    /** Whether a save is in flight. */
+    isSaving: boolean;
+    /** Why the last save did not land, or `null`. */
+    saveError: string | null;
+    /** Whether a test send is in flight. */
+    isTesting: boolean;
+    /** The last test attempt, success or failure, until the page clears it. */
+    testResult: EmailTestResult | null;
+    /** Resolves `true` when the save landed, `false` when it did not — never throws. */
+    save: (input: EmailSettingsInput) => Promise<boolean>;
+    /** Sends the test message to the viewer; the outcome lands in `testResult`, never throws. */
+    sendTest: () => Promise<void>;
+    /** Clears `testResult`. */
+    clearTestResult: () => void;
+    /** Clears `saveError`. */
+    clearSaveError: () => void;
+    /** Reloads the configuration. */
+    refresh: () => Promise<void>;
+}
+/**
+ * Load, save and test-send the deployment's email configuration
+ * (`system_settings:read` to load, `system_settings:write` to save and send).
+ * Save is a PUT with the loaded version as `If-Match`; a 409 reloads the form
+ * and says so. A failed test send is a result, never a rejected promise.
+ *
+ * @param options - the transport, when the hook runs outside the host provider.
+ * @returns the settings, the flags and the three actions.
+ * @throws Error when there is neither a host nor an `api` option.
+ *
+ * @example
+ * ```tsx
+ * const { settings, save, sendTest, testResult } = useEmailSettings();
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function useEmailSettings(options?: UseEmailSettingsOptions): UseEmailSettingsReturn;
+//# sourceMappingURL=use-email-settings.d.ts.map

package/dist/email/headless/use-email-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-email-settings.d.ts","sourceRoot":"","sources":["../../../src/email/headless/use-email-settings.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,wBAAwB,EACzB,MAAM,qCAAqC,CAAC;AAI7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC,GAAG;IACxE,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,oBAAoB,CAAC,CAAC;AAE7E,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,uFAAuF;IACvF,GAAG,CAAC,EAAE,iBAAiB,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,oHAAoH;IACpH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,oFAAoF;IACpF,IAAI,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,6FAA6F;IAC7F,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,2BAA2B;IAC3B,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,0BAA0B;IAC1B,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,iCAAiC;IACjC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAcD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,sBAAsB,CA6J9F"}