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

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/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,12 @@
+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';
+//# 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"}

package/dist/doctor/headless/index.js

@@ -0,0 +1,8 @@
+// `@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';
+//# 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"}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-support-bundle-download.d.ts","sourceRoot":"","sources":["../../../src/doctor/headless/use-support-bundle-download.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C,+DAA+D;IAC/D,GAAG,CAAC,EAAE,iBAAiB,CAAC;IACxB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC7C,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,+BAA+B;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAiBnF;AA8BD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,+BAAoC,GAAG,8BAA8B,CAoCtH"}

package/dist/doctor/headless/use-support-bundle-download.js

@@ -0,0 +1,135 @@
+// Download the support bundle (`GET /admin/doctor/support-bundle`), issue #772.
+//
+// The house fetch-hook contract (see use-doctor.ts): a mounted guard on every
+// `setState` past an `await`, an API error becomes its message (403 named
+// explicitly), and `download` RESOLVES rather than throwing: the caller is a
+// click handler and the error has already been captured for rendering.
+//
+// The file is fetched through the app's transport (`PlatformApiClient.getBlob`,
+// so the bearer token, the refresh and the maintenance handling stay the
+// app's) and handed to the browser under the name the server chose in
+// `Content-Disposition`.
+import { useCallback, useState } from 'react';
+import { isPlatformApiError, useOptionalPlatformHost } from '../../core/index.js';
+import { useIsMounted } from '../internal/use-is-mounted.js';
+/**
+ * The route, relative to the API base, unless `DoctorModule.forRoot({ path })` moved it.
+ *
+ * @stability experimental
+ */
+export const SUPPORT_BUNDLE_PATH = '/admin/doctor/support-bundle';
+/**
+ * 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 function filenameFromContentDisposition(header) {
+    if (!header)
+        return null;
+    let name = null;
+    const extended = /filename\*\s*=\s*(?:UTF-8|utf-8)''([^;]+)/.exec(header);
+    if (extended?.[1]) {
+        try {
+            name = decodeURIComponent(extended[1].trim().replace(/^"|"$/g, ''));
+        }
+        catch {
+            name = null;
+        }
+    }
+    if (!name) {
+        const plain = /filename\s*=\s*("([^"]*)"|[^;]+)/i.exec(header);
+        name = plain ? (plain[2] ?? plain[1] ?? '').trim() : null;
+    }
+    const safe = name?.replace(/[/\\]/g, '_').trim();
+    return safe ? safe : null;
+}
+/** The default `save`: an object URL clicked through a hidden anchor, revoked afterwards. */
+function saveWithAnchor(blob, filename) {
+    if (typeof document === 'undefined' || typeof URL.createObjectURL !== 'function')
+        return;
+    const url = URL.createObjectURL(blob);
+    try {
+        const anchor = document.createElement('a');
+        anchor.href = url;
+        anchor.download = filename;
+        anchor.rel = 'noopener';
+        anchor.style.display = 'none';
+        document.body.appendChild(anchor);
+        anchor.click();
+        anchor.remove();
+    }
+    finally {
+        // Deferred: revoking synchronously can cancel the download in some browsers.
+        setTimeout(() => URL.revokeObjectURL(url), 0);
+    }
+}
+function messageFor(err) {
+    if (isPlatformApiError(err)) {
+        if (err.status === 403)
+            return 'You do not have permission to download the support bundle';
+        return err.message || 'Failed to download the support bundle';
+    }
+    if (err instanceof Error && err.message)
+        return err.message;
+    return 'Failed to download the support bundle';
+}
+/**
+ * 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 function useSupportBundleDownload(options = {}) {
+    const host = useOptionalPlatformHost();
+    const api = options.api ?? host?.api;
+    if (!api) {
+        throw new Error('useSupportBundleDownload: no PlatformHostProvider above this component and no api was passed. ' +
+            'Mount PlatformHostProvider (from @marinoscar/platform-web/core) or pass { api }.');
+    }
+    const path = options.path ?? SUPPORT_BUNDLE_PATH;
+    const save = options.save ?? saveWithAnchor;
+    const [isDownloading, setIsDownloading] = useState(false);
+    const [error, setError] = useState(null);
+    const [filename, setFilename] = useState(null);
+    const isMounted = useIsMounted();
+    const download = useCallback(async () => {
+        try {
+            setIsDownloading(true);
+            setError(null);
+            if (typeof api.getBlob !== 'function') {
+                throw new Error("This app's transport cannot download files (PlatformApiClient.getBlob is missing)");
+            }
+            const { blob, headers } = await api.getBlob(path);
+            const name = filenameFromContentDisposition(headers.get('Content-Disposition')) ?? 'support-bundle.json';
+            save(blob, name);
+            if (isMounted())
+                setFilename(name);
+        }
+        catch (err) {
+            if (isMounted())
+                setError(messageFor(err));
+        }
+        finally {
+            if (isMounted())
+                setIsDownloading(false);
+        }
+    }, [api, path, save, isMounted]);
+    return { download, isDownloading, error, filename };
+}
+//# sourceMappingURL=use-support-bundle-download.js.map

package/dist/doctor/headless/use-support-bundle-download.js.map

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

package/dist/doctor/internal/relative-time.d.ts

@@ -0,0 +1,2 @@
+export declare function formatRelativeTime(iso: string, now?: Date): string;
+//# sourceMappingURL=relative-time.d.ts.map

package/dist/doctor/internal/relative-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-time.d.ts","sourceRoot":"","sources":["../../../src/doctor/internal/relative-time.ts"],"names":[],"mappings":"AAiBA,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAY9E"}

package/dist/doctor/internal/relative-time.js

@@ -0,0 +1,29 @@
+// The fallback "3 minutes ago" formatter, used when the host supplies no
+// `formatRelativeTime`. Same rules as the reference app's
+// `utils/relativeTime.ts`: Intl.RelativeTimeFormat, "Just now" under 45 s (a
+// clock-skew guard), the ISO string on an unparseable input. Not exported.
+const UNITS = [
+    { limit: 60_000, ms: 1_000, unit: 'second' },
+    { limit: 3_600_000, ms: 60_000, unit: 'minute' },
+    { limit: 86_400_000, ms: 3_600_000, unit: 'hour' },
+    { limit: 604_800_000, ms: 86_400_000, unit: 'day' },
+    { limit: 2_629_800_000, ms: 604_800_000, unit: 'week' },
+    { limit: 31_557_600_000, ms: 2_629_800_000, unit: 'month' },
+    { limit: Infinity, ms: 31_557_600_000, unit: 'year' },
+];
+const JUST_NOW_MS = 45_000;
+export function formatRelativeTime(iso, now = new Date()) {
+    const time = new Date(iso).getTime();
+    if (Number.isNaN(time))
+        return iso;
+    const elapsed = now.getTime() - time;
+    if (elapsed < JUST_NOW_MS)
+        return 'Just now';
+    const formatter = new Intl.RelativeTimeFormat(undefined, { numeric: 'auto' });
+    for (const { limit, ms, unit } of UNITS) {
+        if (elapsed < limit)
+            return formatter.format(-Math.floor(elapsed / ms), unit);
+    }
+    return iso;
+}
+//# sourceMappingURL=relative-time.js.map

package/dist/doctor/internal/relative-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-time.js","sourceRoot":"","sources":["../../../src/doctor/internal/relative-time.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,0DAA0D;AAC1D,6EAA6E;AAC7E,2EAA2E;AAE3E,MAAM,KAAK,GAAuE;IAChF,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC5C,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;IAChD,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE;IAClD,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;IACnD,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE;IACvD,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE;IAC3D,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE;CACtD,CAAC;AAEF,MAAM,WAAW,GAAG,MAAM,CAAC;AAE3B,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,MAAY,IAAI,IAAI,EAAE;IACpE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IACrC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAEnC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IACrC,IAAI,OAAO,GAAG,WAAW;QAAE,OAAO,UAAU,CAAC;IAE7C,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9E,KAAK,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QACxC,IAAI,OAAO,GAAG,KAAK;YAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/doctor/internal/status-colors.d.ts

@@ -0,0 +1,5 @@
+import type { Theme } from '@mui/material/styles';
+import type { DoctorStatus } from '@marinoscar/platform-contract/doctor';
+/** The colour of `status` in `theme`: its `palette.status` token, else the token's default. */
+export declare function statusColor(theme: Theme, status: DoctorStatus): string;
+//# sourceMappingURL=status-colors.d.ts.map

package/dist/doctor/internal/status-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-colors.d.ts","sourceRoot":"","sources":["../../../src/doctor/internal/status-colors.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAWzE,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAetE"}

package/dist/doctor/internal/status-colors.js

@@ -0,0 +1,29 @@
+// The Doctor's status colours come from the theme-token contract
+// `palette.status.{ok,warn,crit,neutral}` (issue #686, PP-1.15): packages own
+// structure, apps own appearance. An app restyles the Doctor by setting those
+// tokens in its theme; a theme that sets none falls back to the MUI palette
+// roles the tokens default to, so it looks as it always did. Not exported.
+const TOKEN_OF = {
+    pass: 'ok',
+    warn: 'warn',
+    fail: 'crit',
+    skip: 'neutral',
+};
+/** The colour of `status` in `theme`: its `palette.status` token, else the token's default. */
+export function statusColor(theme, status) {
+    const token = TOKEN_OF[status];
+    const own = theme.palette.status?.[token];
+    if (typeof own === 'string' && own !== '')
+        return own;
+    switch (token) {
+        case 'ok':
+            return theme.palette.success.main;
+        case 'warn':
+            return theme.palette.warning.main;
+        case 'crit':
+            return theme.palette.error.main;
+        default:
+            return theme.palette.grey[500];
+    }
+}
+//# sourceMappingURL=status-colors.js.map

package/dist/doctor/internal/status-colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-colors.js","sourceRoot":"","sources":["../../../src/doctor/internal/status-colors.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAC5E,2EAA2E;AAO3E,MAAM,QAAQ,GAAsC;IAClD,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,SAAS;CAChB,CAAC;AAEF,+FAA+F;AAC/F,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,MAAoB;IAC5D,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAI,KAAK,CAAC,OAAyE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;IAC7G,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IAEtD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,IAAI;YACP,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QACpC,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QACpC,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QAClC;YACE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/doctor/internal/use-is-mounted.d.ts

@@ -0,0 +1,2 @@
+export declare function useIsMounted(): () => boolean;
+//# sourceMappingURL=use-is-mounted.d.ts.map

package/dist/doctor/internal/use-is-mounted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-is-mounted.d.ts","sourceRoot":"","sources":["../../../src/doctor/internal/use-is-mounted.ts"],"names":[],"mappings":"AAMA,wBAAgB,YAAY,IAAI,MAAM,OAAO,CAW5C"}