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

package/dist/db-backup/ui/table.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// The table the db-backup run list renders through (issue #740): the app's table from
+// the jobs adapters when it handed one in (the reference app's responsive
+// `DataTable`), else a plain MUI table with paging and the row actions (the
+// identity slice's fallback is the model). The fallback offers no filter menu:
+// a `filterOnly` column is skipped, and the page's filters still apply through
+// the query. Slice-internal: a copy of the jobs slice's own, which that slice
+// does not export, over `DbBackupWebAdaptersProvider`'s table.
+import { useState } from 'react';
+import { Box, Button, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, IconButton, Table, TableBody, TableCell, TableHead, TablePagination, TableRow, TextField, Tooltip, } from '@mui/material';
+import { useDbBackupWebAdapters } from '../headless/adapters.js';
+/**
+ * The app's table, or the fallback.
+ *
+ * @stability experimental
+ */
+export function DbBackupTable(props) {
+    const { DataTable } = useDbBackupWebAdapters();
+    if (DataTable)
+        return _jsx(DataTable, { ...props });
+    return _jsx(FallbackTable, { ...props });
+}
+function FallbackTable(props) {
+    const { columns, rows, rowId, loading, emptyState, pagination, quickSearch, rowActions = [] } = props;
+    const [search, setSearch] = useState(quickSearch?.value ?? '');
+    const visible = columns.filter((column) => !column.filterOnly);
+    // A destructive action that asks first (deleting a job, revoking a
+    // credential) still asks in the fallback.
+    const [pending, setPending] = useState(null);
+    const confirm = pending && typeof pending.action.confirm === 'object' ? pending.action.confirm : undefined;
+    const rawDescription = confirm?.description;
+    let description;
+    if (typeof rawDescription === 'function')
+        description = pending ? rawDescription(pending.row) : undefined;
+    else
+        description = rawDescription;
+    const run = (action, row) => {
+        if (action.confirm)
+            setPending({ action, row });
+        else
+            action.onClick(row);
+    };
+    return (_jsxs(Box, { "data-testid": props['data-testid'], children: [quickSearch && (_jsx(TextField, { size: "small", value: search, placeholder: quickSearch.placeholder, slotProps: { htmlInput: { 'aria-label': quickSearch.ariaLabel ?? quickSearch.placeholder } }, onChange: (event) => {
+                    setSearch(event.target.value);
+                    quickSearch.onChange(event.target.value);
+                }, sx: { mb: 2 } })), _jsxs(Table, { size: "small", "aria-label": props.ariaLabel, "aria-busy": loading || undefined, children: [_jsx(TableHead, { children: _jsxs(TableRow, { children: [visible.map((column) => (_jsx(TableCell, { align: column.align, children: column.label }, column.id))), rowActions.length > 0 && _jsx(TableCell, { "aria-label": "Actions" })] }) }), _jsx(TableBody, { children: rows.length === 0 && !loading ? (_jsx(TableRow, { children: _jsx(TableCell, { colSpan: visible.length + (rowActions.length > 0 ? 1 : 0), children: emptyState }) })) : (rows.map((row) => (_jsxs(TableRow, { children: [visible.map((column) => (_jsx(TableCell, { align: column.align, children: column.render ? column.render(row) : column.value?.(row) }, column.id))), rowActions.length > 0 && (_jsx(TableCell, { align: "right", children: rowActions.map((action) => (_jsx(Tooltip, { title: action.label, children: _jsx("span", { children: _jsx(IconButton, { size: "small", "aria-label": action.label, disabled: action.disabled?.(row) ?? false, onClick: () => run(action, row), children: action.icon ?? action.label }) }) }, action.id))) }))] }, rowId(row))))) })] }), _jsxs(Dialog, { open: pending !== null, onClose: () => setPending(null), children: [_jsx(DialogTitle, { children: confirm?.title ?? pending?.action.label }), description && (_jsx(DialogContent, { children: _jsx(DialogContentText, { children: description }) })), _jsxs(DialogActions, { children: [_jsx(Button, { onClick: () => setPending(null), children: confirm?.cancelLabel ?? 'Cancel' }), _jsx(Button, { color: pending?.action.destructive ? 'error' : 'primary', variant: "contained", onClick: () => {
+                                    if (pending)
+                                        pending.action.onClick(pending.row);
+                                    setPending(null);
+                                }, children: confirm?.confirmLabel ?? 'Confirm' })] })] }), pagination && (_jsx(TablePagination, { component: "div", count: pagination.total, page: pagination.page, rowsPerPage: pagination.pageSize, rowsPerPageOptions: pagination.pageSizeOptions ?? [pagination.pageSize], onPageChange: (_, page) => pagination.onPaginationChange({ page, pageSize: pagination.pageSize }), onRowsPerPageChange: (event) => pagination.onPaginationChange({ page: 0, pageSize: Number(event.target.value) }) }))] }));
+}
+//# sourceMappingURL=table.js.map

package/dist/db-backup/ui/table.js.map

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

package/dist/doctor/headless/categories.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A category key and its display label.
+ *
+ * @stability stable
+ */
+export interface DoctorCategoryLabel {
+    /** The category key the API reports (`storage`). */
+    key: string;
+    /** What the page shows (`Object storage`). */
+    label: string;
+}
+/**
+ * The shipped categories, in display order, with their labels. The default of
+ * `DoctorPage`'s `categories` prop; a category an app adds renders after these,
+ * title-cased, unless the app passes its own list.
+ *
+ * @stability stable
+ */
+export declare const PLATFORM_DOCTOR_CATEGORY_LABELS: readonly DoctorCategoryLabel[];
+/**
+ * The label of a category: from `labels` when listed, otherwise the key
+ * title-cased (`fork_widgets` becomes `Fork Widgets`).
+ *
+ * @param key - the category key.
+ * @param labels - the known labels. Default {@link PLATFORM_DOCTOR_CATEGORY_LABELS}.
+ * @returns the label.
+ *
+ * @stability stable
+ */
+export declare function categoryLabel(key: string, labels?: readonly DoctorCategoryLabel[]): string;
+//# sourceMappingURL=categories.d.ts.map

package/dist/doctor/headless/categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../../src/doctor/headless/categories.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,EAAE,SAAS,mBAAmB,EAYzE,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,SAAS,mBAAmB,EAAoC,GACvE,MAAM,CAQR"}

package/dist/doctor/headless/categories.js

@@ -0,0 +1,41 @@
+/**
+ * The shipped categories, in display order, with their labels. The default of
+ * `DoctorPage`'s `categories` prop; a category an app adds renders after these,
+ * title-cased, unless the app passes its own list.
+ *
+ * @stability stable
+ */
+export const PLATFORM_DOCTOR_CATEGORY_LABELS = [
+    { key: 'core', label: 'Core' },
+    { key: 'auth', label: 'Authentication' },
+    { key: 'maintenance', label: 'Maintenance' },
+    { key: 'storage', label: 'Object storage' },
+    { key: 'email', label: 'Email' },
+    { key: 'push', label: 'Web Push' },
+    { key: 'ai', label: 'AI' },
+    { key: 'jobs', label: 'Job queue' },
+    { key: 'nodes', label: 'Worker nodes' },
+    { key: 'backup', label: 'Database backup' },
+    { key: 'telemetry', label: 'Telemetry' },
+];
+/**
+ * The label of a category: from `labels` when listed, otherwise the key
+ * title-cased (`fork_widgets` becomes `Fork Widgets`).
+ *
+ * @param key - the category key.
+ * @param labels - the known labels. Default {@link PLATFORM_DOCTOR_CATEGORY_LABELS}.
+ * @returns the label.
+ *
+ * @stability stable
+ */
+export function categoryLabel(key, labels = PLATFORM_DOCTOR_CATEGORY_LABELS) {
+    const known = labels.find((category) => category.key === key);
+    if (known)
+        return known.label;
+    return key
+        .split(/[-_\s]+/)
+        .filter(Boolean)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=categories.js.map

package/dist/doctor/headless/categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../../src/doctor/headless/categories.ts"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAmC;IAC7E,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;IAC9B,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE;IACxC,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;IAC5C,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,EAAE;IAC3C,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAChC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE;IAClC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;IAC1B,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE;IACnC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE;IACvC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAE;IAC3C,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;CACzC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAW,EACX,SAAyC,+BAA+B;IAExE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IAC9D,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IAC9B,OAAO,GAAG;SACP,KAAK,CAAC,SAAS,CAAC;SAChB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/doctor/headless/check-renderers.d.ts

@@ -0,0 +1,57 @@
+import type { ComponentType } from 'react';
+import type { DoctorCheckReport } from '@marinoscar/platform-contract/doctor';
+/**
+ * What a registered check renderer receives: the report row of its check.
+ * `check.data` is `null` when the check reported no facts.
+ *
+ * @extensionPoint slot
+ * @stability experimental
+ */
+export interface DoctorCheckRendererProps {
+    /** The check as the report returned it. */
+    check: DoctorCheckReport;
+}
+/**
+ * A component that draws one check's facts inside its row on the Doctor page.
+ * It receives {@link DoctorCheckRendererProps}.
+ *
+ * @stability experimental
+ */
+export type DoctorCheckRenderer = ComponentType<DoctorCheckRendererProps>;
+/**
+ * Registers the component that draws the check `checkId` inside its row on the
+ * Doctor page (its `check.data`, a chart of its history, a link to its runbook).
+ * A second registration for the same id replaces the first, so a hot module
+ * reload that re-runs the registering module works. Call it at module scope,
+ * before the page renders (the page reads the registry when it renders a row).
+ *
+ * Match is by the exact check id (`'storage.bucket'`). A check with no
+ * renderer is drawn as it always was.
+ *
+ * @param checkId - the id of the check as the API reports it.
+ * @param Component - the renderer; see {@link DoctorCheckRendererProps}.
+ * @returns a function that removes this registration (it removes nothing if a
+ *   later registration replaced it).
+ *
+ * @example
+ * ```tsx
+ * import { registerDoctorCheckRenderer } from '@marinoscar/platform-web/doctor/headless';
+ *
+ * registerDoctorCheckRenderer('example.capability', ({ check }) => (
+ *   <p>{check.data?.configured ? 'Configured' : 'Not configured'}</p>
+ * ));
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function registerDoctorCheckRenderer(checkId: string, Component: DoctorCheckRenderer): () => void;
+/**
+ * The renderer registered for `checkId`, or `undefined` (the row is then drawn
+ * as it always was).
+ *
+ * @param checkId - the id of the check.
+ * @stability experimental
+ */
+export declare function getDoctorCheckRenderer(checkId: string): DoctorCheckRenderer | undefined;
+//# sourceMappingURL=check-renderers.d.ts.map

package/dist/doctor/headless/check-renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-renderers.d.ts","sourceRoot":"","sources":["../../../src/doctor/headless/check-renderers.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,2CAA2C;IAC3C,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,wBAAwB,CAAC,CAAC;AAI1E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAKvG;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAEvF"}

package/dist/doctor/headless/check-renderers.js

@@ -0,0 +1,69 @@
+// =============================================================================
+// The Doctor check renderer registry (PP-14.23)
+// =============================================================================
+//
+// A Doctor check reports a status, a detail line, a remedy, an error and, when
+// it has them, `data`: small scalar facts (counts, versions, latencies). The
+// page prints the first four and leaves `data` out, because what a count means
+// is the check's own business. An app (or a package that registers a check on
+// the API) draws the facts of ITS check by registering a component here, keyed
+// by the check's id:
+//
+//   registerDoctorCheckRenderer('example.capability', CapabilityFacts);
+//
+// The component is drawn INSIDE the check's row, after the remedy and the
+// error and before the "Open settings" link. A check with no registered
+// renderer renders exactly as it always did.
+//
+// The registry lives in the headless entry, not beside the page, so an app can
+// register at module scope without importing the page (and MUI) into its main
+// chunk; the page reads it at render time, so register before the page renders.
+// A renderer is presentation only: it receives the report row (data, never an
+// API client) and enforces nothing; the report is the API's.
+// =============================================================================
+const renderers = new Map();
+/**
+ * Registers the component that draws the check `checkId` inside its row on the
+ * Doctor page (its `check.data`, a chart of its history, a link to its runbook).
+ * A second registration for the same id replaces the first, so a hot module
+ * reload that re-runs the registering module works. Call it at module scope,
+ * before the page renders (the page reads the registry when it renders a row).
+ *
+ * Match is by the exact check id (`'storage.bucket'`). A check with no
+ * renderer is drawn as it always was.
+ *
+ * @param checkId - the id of the check as the API reports it.
+ * @param Component - the renderer; see {@link DoctorCheckRendererProps}.
+ * @returns a function that removes this registration (it removes nothing if a
+ *   later registration replaced it).
+ *
+ * @example
+ * ```tsx
+ * import { registerDoctorCheckRenderer } from '@marinoscar/platform-web/doctor/headless';
+ *
+ * registerDoctorCheckRenderer('example.capability', ({ check }) => (
+ *   <p>{check.data?.configured ? 'Configured' : 'Not configured'}</p>
+ * ));
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export function registerDoctorCheckRenderer(checkId, Component) {
+    renderers.set(checkId, Component);
+    return () => {
+        if (renderers.get(checkId) === Component)
+            renderers.delete(checkId);
+    };
+}
+/**
+ * The renderer registered for `checkId`, or `undefined` (the row is then drawn
+ * as it always was).
+ *
+ * @param checkId - the id of the check.
+ * @stability experimental
+ */
+export function getDoctorCheckRenderer(checkId) {
+    return renderers.get(checkId);
+}
+//# sourceMappingURL=check-renderers.js.map

package/dist/doctor/headless/check-renderers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-renderers.js","sourceRoot":"","sources":["../../../src/doctor/headless/check-renderers.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,gDAAgD;AAChD,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAC/E,8EAA8E;AAC9E,+EAA+E;AAC/E,qBAAqB;AACrB,EAAE;AACF,wEAAwE;AACxE,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,6CAA6C;AAC7C,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,6DAA6D;AAC7D,gFAAgF;AAyBhF,MAAM,SAAS,GAAG,IAAI,GAAG,EAA+B,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAe,EAAE,SAA8B;IACzF,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAClC,OAAO,GAAG,EAAE;QACV,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,SAAS;YAAE,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtE,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/doctor/headless/client.d.ts

@@ -0,0 +1,33 @@
+import type { DoctorReport, DoctorReportQueryInput } from '@marinoscar/platform-contract/doctor';
+import type { PlatformApiClient } from '../../core/index.js';
+/**
+ * The Doctor's API calls.
+ *
+ * @stability stable
+ */
+export interface DoctorClient {
+    /**
+     * `GET /admin/doctor`. Rejects only when the CALL fails (403, 500, the
+     * connection dropped); a failing check is a resolved report.
+     */
+    getReport(query?: DoctorReportQueryInput): Promise<DoctorReport>;
+}
+/**
+ * The Doctor client over the app's transport.
+ *
+ * @param api - the app's transport (`usePlatformApi()`).
+ * @param path - the route, relative to the API base. Default `'/admin/doctor'`;
+ *   pass the app's own when `DoctorModule.forRoot({ path })` moved it.
+ * @returns the client.
+ *
+ * @example
+ * ```ts
+ * const client = createDoctorClient(usePlatformApi());
+ * const report = await client.getReport({ refresh: true });
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability stable
+ */
+export declare function createDoctorClient(api: PlatformApiClient, path?: string): DoctorClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/doctor/headless/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/doctor/headless/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAEjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,SAAS,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAClE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,SAAkB,GAAG,YAAY,CAU/F"}

package/dist/doctor/headless/client.js

@@ -0,0 +1,31 @@
+/**
+ * The Doctor client over the app's transport.
+ *
+ * @param api - the app's transport (`usePlatformApi()`).
+ * @param path - the route, relative to the API base. Default `'/admin/doctor'`;
+ *   pass the app's own when `DoctorModule.forRoot({ path })` moved it.
+ * @returns the client.
+ *
+ * @example
+ * ```ts
+ * const client = createDoctorClient(usePlatformApi());
+ * const report = await client.getReport({ refresh: true });
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability stable
+ */
+export function createDoctorClient(api, path = '/admin/doctor') {
+    return {
+        getReport(query = {}) {
+            const params = new URLSearchParams();
+            if (query.category)
+                params.set('category', query.category);
+            if (query.refresh)
+                params.set('refresh', 'true');
+            const qs = params.toString();
+            return api.get(qs ? `${path}?${qs}` : path);
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/doctor/headless/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/doctor/headless/client.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAsB,EAAE,IAAI,GAAG,eAAe;IAC/E,OAAO;QACL,SAAS,CAAC,QAAgC,EAAE;YAC1C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YACrC,IAAI,KAAK,CAAC,QAAQ;gBAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC3D,IAAI,KAAK,CAAC,OAAO;gBAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACjD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC7B,OAAO,GAAG,CAAC,GAAG,CAAe,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/doctor/headless/contract.d.ts

@@ -0,0 +1,18 @@
+import type { DoctorReportQueryInput, DoctorStatus } from '@marinoscar/platform-contract/doctor';
+/**
+ * Every status, lowest severity first (`pass < skip < warn < fail`).
+ *
+ * @deprecated Use `DOCTOR_STATUSES` from `@marinoscar/platform-contract/doctor`
+ *   (same values, same order), or `DOCTOR_STATUS_RANK` to compare two statuses.
+ * @stability stable
+ */
+export declare const DOCTOR_STATUS_ORDER: readonly DoctorStatus[];
+/**
+ * What a report request may ask for: one `category`, or `refresh` to bypass the
+ * server-side cache.
+ *
+ * @deprecated Use `DoctorReportQueryInput` from `@marinoscar/platform-contract/doctor`.
+ * @stability stable
+ */
+export type DoctorReportQuery = DoctorReportQueryInput;
+//# sourceMappingURL=contract.d.ts.map

package/dist/doctor/headless/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/doctor/headless/contract.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEjG;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,YAAY,EAAoB,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,CAAC"}

package/dist/doctor/headless/contract.js

@@ -0,0 +1,15 @@
+// The Doctor's wire types come from `@marinoscar/platform-contract/doctor`
+// (#701), the same schemas the API validates with. Type-only imports plus the
+// zod-free constants module, so the web bundle never carries zod for them.
+// This file keeps the two names the headless entry exported before the
+// contract existed.
+import { DOCTOR_STATUSES } from '@marinoscar/platform-contract/doctor';
+/**
+ * Every status, lowest severity first (`pass < skip < warn < fail`).
+ *
+ * @deprecated Use `DOCTOR_STATUSES` from `@marinoscar/platform-contract/doctor`
+ *   (same values, same order), or `DOCTOR_STATUS_RANK` to compare two statuses.
+ * @stability stable
+ */
+export const DOCTOR_STATUS_ORDER = DOCTOR_STATUSES;
+//# sourceMappingURL=contract.js.map

package/dist/doctor/headless/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../src/doctor/headless/contract.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,8EAA8E;AAC9E,2EAA2E;AAC3E,uEAAuE;AACvE,oBAAoB;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAGvE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA4B,eAAe,CAAC"}

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

@@ -0,0 +1,14 @@
+export { DOCTOR_STATUS_ORDER } from './contract.js';
+export type { DoctorReportQuery } from './contract.js';
+export type { DoctorCheckReport, DoctorReport, DoctorStatus } from '@marinoscar/platform-contract/doctor';
+export { createDoctorClient } from './client.js';
+export type { DoctorClient } from './client.js';
+export { useDoctor } from './use-doctor.js';
+export type { UseDoctorReturn } from './use-doctor.js';
+export { PLATFORM_DOCTOR_CATEGORY_LABELS, categoryLabel } from './categories.js';
+export type { DoctorCategoryLabel } from './categories.js';
+export { SUPPORT_BUNDLE_PATH, filenameFromContentDisposition, useSupportBundleDownload, } from './use-support-bundle-download.js';
+export type { UseSupportBundleDownloadOptions, UseSupportBundleDownloadReturn, } from './use-support-bundle-download.js';
+export { getDoctorCheckRenderer, registerDoctorCheckRenderer } from './check-renderers.js';
+export type { DoctorCheckRenderer, DoctorCheckRendererProps } from './check-renderers.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/doctor/headless/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAC1G,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,+BAA+B,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,wBAAwB,GACzB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAC3F,YAAY,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/doctor/headless/index.js

@@ -0,0 +1,10 @@
+// `@marinoscar/platform-web/doctor/headless`: the Doctor's types, client, hook
+// and category labels, with no component (issue #696). Documented in ../README.md.
+export { DOCTOR_STATUS_ORDER } from './contract.js';
+export { createDoctorClient } from './client.js';
+export { useDoctor } from './use-doctor.js';
+export { PLATFORM_DOCTOR_CATEGORY_LABELS, categoryLabel } from './categories.js';
+export { SUPPORT_BUNDLE_PATH, filenameFromContentDisposition, useSupportBundleDownload, } from './use-support-bundle-download.js';
+// The per-check renderer registry (PP-14.23): draws a check's `data` inside its row.
+export { getDoctorCheckRenderer, registerDoctorCheckRenderer } from './check-renderers.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/doctor/headless/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mFAAmF;AAEnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAKpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,+BAA+B,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEjF,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,wBAAwB,GACzB,MAAM,kCAAkC,CAAC;AAK1C,qFAAqF;AACrF,OAAO,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/doctor/headless/use-doctor.d.ts

@@ -0,0 +1,36 @@
+import type { DoctorReport } from '@marinoscar/platform-contract/doctor';
+import type { DoctorClient } from './client.js';
+/**
+ * What {@link useDoctor} returns.
+ *
+ * @stability stable
+ */
+export interface UseDoctorReturn {
+    /** `null` until the first run resolves. Never a signal about the deployment itself. */
+    report: DoctorReport | null;
+    /** A run is in flight. The previous report stays while a rerun runs. */
+    isLoading: boolean;
+    /** The REQUEST failed (403, network, maintenance). Never a failing check. */
+    error: string | null;
+    /** Run every check again, bypassing any cache (`refresh=true`). */
+    rerun: () => Promise<void>;
+}
+/**
+ * Loads the Doctor report on mount (possibly from the API's short cache);
+ * `rerun` sends `refresh=true` so every probe runs again.
+ *
+ * @param client - the client to use. Default: `createDoctorClient(usePlatformApi())`.
+ *   Pass one (and keep its identity stable) to use the hook without a host.
+ * @returns the report, the loading flag, the request error and `rerun`.
+ * @throws Error when no `client` is given and no `PlatformHostProvider` is mounted.
+ *
+ * @example
+ * ```tsx
+ * const { report, isLoading, error, rerun } = useDoctor();
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability stable
+ */
+export declare function useDoctor(client?: DoctorClient): UseDoctorReturn;
+//# sourceMappingURL=use-doctor.d.ts.map

package/dist/doctor/headless/use-doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-doctor.d.ts","sourceRoot":"","sources":["../../../src/doctor/headless/use-doctor.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAMzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAYhD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,mEAAmE;IACnE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,eAAe,CA0ChE"}

package/dist/doctor/headless/use-doctor.js

@@ -0,0 +1,80 @@
+// Run the admin Doctor (`GET /admin/doctor`), issue #634; packaged by #696.
+//
+// The house fetch-hook contract:
+//   - a mounted guard on every `setState` past an `await`;
+//   - an API error becomes its message, with 403 named explicitly;
+//   - `rerun` RESOLVES rather than throwing: the caller is a click handler and
+//     the error has already been captured for rendering.
+//
+// ⚠ `error` MEANS THE REQUEST FAILED. A report whose verdict is `fail` is a
+// successful read and lands in `report`.
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { isPlatformApiError, useOptionalPlatformHost } from '../../core/index.js';
+import { useIsMounted } from '../internal/use-is-mounted.js';
+import { createDoctorClient } from './client.js';
+function messageFor(err) {
+    if (isPlatformApiError(err)) {
+        if (err.status === 403) {
+            return 'You do not have permission to run the Doctor';
+        }
+        return err.message || 'Failed to run the Doctor checks';
+    }
+    return 'Failed to run the Doctor checks';
+}
+/**
+ * Loads the Doctor report on mount (possibly from the API's short cache);
+ * `rerun` sends `refresh=true` so every probe runs again.
+ *
+ * @param client - the client to use. Default: `createDoctorClient(usePlatformApi())`.
+ *   Pass one (and keep its identity stable) to use the hook without a host.
+ * @returns the report, the loading flag, the request error and `rerun`.
+ * @throws Error when no `client` is given and no `PlatformHostProvider` is mounted.
+ *
+ * @example
+ * ```tsx
+ * const { report, isLoading, error, rerun } = useDoctor();
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability stable
+ */
+export function useDoctor(client) {
+    const host = useOptionalPlatformHost();
+    const api = host?.api;
+    const resolved = useMemo(() => {
+        if (client)
+            return client;
+        if (!api) {
+            throw new Error('useDoctor: no PlatformHostProvider above this component and no client was passed. ' +
+                'Mount PlatformHostProvider (from @marinoscar/platform-web/core) or pass createDoctorClient(api).');
+        }
+        return createDoctorClient(api);
+    }, [client, api]);
+    const [report, setReport] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const isMounted = useIsMounted();
+    const run = useCallback(async (refresh) => {
+        try {
+            setIsLoading(true);
+            setError(null);
+            const response = await resolved.getReport(refresh ? { refresh: true } : {});
+            if (isMounted())
+                setReport(response);
+        }
+        catch (err) {
+            if (isMounted())
+                setError(messageFor(err));
+        }
+        finally {
+            if (isMounted())
+                setIsLoading(false);
+        }
+    }, [resolved, isMounted]);
+    useEffect(() => {
+        void run(false);
+    }, [run]);
+    const rerun = useCallback(() => run(true), [run]);
+    return { report, isLoading, error, rerun };
+}
+//# sourceMappingURL=use-doctor.js.map

package/dist/doctor/headless/use-doctor.js.map

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

package/dist/doctor/headless/use-support-bundle-download.d.ts

@@ -0,0 +1,68 @@
+import type { PlatformApiClient } from '../../core/index.js';
+/**
+ * The route, relative to the API base, unless `DoctorModule.forRoot({ path })` moved it.
+ *
+ * @stability experimental
+ */
+export declare const SUPPORT_BUNDLE_PATH = "/admin/doctor/support-bundle";
+/**
+ * What {@link useSupportBundleDownload} takes.
+ *
+ * @stability experimental
+ */
+export interface UseSupportBundleDownloadOptions {
+    /** The transport. Default: the host's (`usePlatformApi()`). */
+    api?: PlatformApiClient;
+    /** The route. Default {@link SUPPORT_BUNDLE_PATH}. */
+    path?: string;
+    /**
+     * Hands the file to the browser. Default: an object URL clicked through a
+     * hidden anchor. Replace it to save elsewhere, or in a test.
+     */
+    save?: (blob: Blob, filename: string) => void;
+}
+/**
+ * What {@link useSupportBundleDownload} returns.
+ *
+ * @stability experimental
+ */
+export interface UseSupportBundleDownloadReturn {
+    /** Fetch the bundle and save it. Resolves even when it fails (see `error`). */
+    download: () => Promise<void>;
+    /** A download is in flight. */
+    isDownloading: boolean;
+    /** Why the last download failed, or `null`. */
+    error: string | null;
+    /** The name of the last file saved, or `null`. */
+    filename: string | null;
+}
+/**
+ * The filename from a `Content-Disposition` header (`filename*=UTF-8''…`,
+ * `filename="…"` or `filename=…`), or `null`. Path separators are replaced.
+ *
+ * @param header - the header value, or `null`.
+ * @returns the filename, or `null`.
+ *
+ * @stability experimental
+ */
+export declare function filenameFromContentDisposition(header: string | null): string | null;
+/**
+ * Downloads the support bundle (the doctor report, versions and a 24-hour
+ * telemetry summary, redacted by the API) and saves it under the server's
+ * filename (`support-bundle-<slug>-<timestamp>.json`).
+ *
+ * @param options - the transport, route and save function; every one optional.
+ * @returns `download`, the in-flight flag, the last error and the last filename.
+ * @throws Error when no `api` is given and no `PlatformHostProvider` is mounted.
+ *
+ * @example
+ * ```tsx
+ * const { download, isDownloading, error } = useSupportBundleDownload();
+ * <Button onClick={() => void download()} disabled={isDownloading}>Download support bundle</Button>
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function useSupportBundleDownload(options?: UseSupportBundleDownloadOptions): UseSupportBundleDownloadReturn;
+//# sourceMappingURL=use-support-bundle-download.d.ts.map