@marinoscar/platform-web 0.1.0-next.3 → 0.1.0-next.4

package/dist/email/ui/SmtpTransportPanel.js

@@ -0,0 +1,111 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * The SMTP block of `/admin/settings/email` (issue #124; a panel since PP-14.8).
+ *
+ * MOVED VERBATIM out of `EmailSettingsPage`: the markup, the copy and the
+ * helper-text rules are the page's own as they were before the transports
+ * became pluggable, and `test/email/EmailSettingsPage.builtin-dom.test.tsx`
+ * proves the rendered DOM did not move. The page hands it the transport's
+ * settings (`host`, `port`, `useTls`, `username`), the typed write-only
+ * `password` and its masked status, and it reports edits back.
+ *
+ * `port` is edited as TEXT (`toForm` / `toInput` below convert), because a
+ * number-typed control cannot hold the intermediate empty value a user passes
+ * through while retyping a port: binding it to a `number` makes the field
+ * impossible to clear, which reads as a broken input.
+ */
+import { Divider, FormControlLabel, Grid, Switch, TextField, Typography } from '@mui/material';
+const DEFAULT_SMTP_PORT = 587;
+const text = (value) => (typeof value === 'string' ? value : '');
+/**
+ * The port as the API wants it: a number, or `''` for "not configured".
+ *
+ * `Number('')` is 0 and `Number('abc')` is NaN, and both would reach the wire
+ * as something wrong — 0 is below the schema's minimum, and NaN JSON-serialises
+ * to `null`. Anything that is not a whole number in range becomes the explicit
+ * empty box instead; `validate` is what stops a bad value being submitted while
+ * it actually matters.
+ */
+function toPortValue(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return '';
+    const port = Number(trimmed);
+    return Number.isInteger(port) && port >= 1 && port <= 65535 ? port : '';
+}
+/**
+ * What to say about the stored SMTP password. `hint` is the credential store's
+ * own mask (`••••` plus at most the last four characters), derived on write by
+ * the code that held the plaintext. It beats a fixed placeholder outright: an
+ * admin who has just rotated a credential can see WHICH one is live, not merely
+ * that one exists. It can still be null, so the sentence is assembled to read
+ * correctly without it.
+ */
+function smtpPasswordHelperText(status) {
+    if (!status.configured) {
+        return 'No password is saved yet. Leave blank if this server does not need one.';
+    }
+    const which = status.hint ? ` (${status.hint})` : '';
+    const when = status.updatedAt ? `, last changed ${new Date(status.updatedAt).toLocaleDateString()}` : '';
+    return `A password is saved${which}${when}. Leave this blank to keep it, or type a new one to replace it.`;
+}
+const NOT_SAVED = { configured: false, hint: null, updatedAt: null, updatedByUserId: null };
+/**
+ * Client-side checks of the SMTP settings. The FORMAT rule runs whether or not
+ * email is switched on, because the API's does; the REQUIRED rules run only
+ * when mail is actually being sent: a deployment that has turned email off must
+ * not be blocked from saving that fact by an empty host it will never use.
+ */
+export const validateSmtpSettings = (value, { enabled }) => {
+    const errors = {};
+    const port = text(value.port).trim();
+    if (port && toPortValue(port) === '') {
+        errors.port = 'Port must be a whole number between 1 and 65535.';
+    }
+    if (!enabled)
+        return errors;
+    if (!text(value.host).trim())
+        errors.host = 'A host is required.';
+    if (!port)
+        errors.port = 'A port is required.';
+    return errors;
+};
+/** The settings the API stored, in the shape the panel edits: the port as text. An absent port renders as the STARTTLS default. */
+export const smtpSettingsToForm = (settings) => ({
+    host: text(settings.host),
+    port: typeof settings.port === 'number' ? String(settings.port) : String(DEFAULT_SMTP_PORT),
+    // ABSENT MEANS TRUE, matching the transport (`useTls ?? true`). Defaulting
+    // the toggle to off here would show every unconfigured deployment a screen
+    // claiming TLS is not required when in fact it is.
+    useTls: typeof settings.useTls === 'boolean' ? settings.useTls : true,
+    username: text(settings.username),
+});
+/** The settings the API stores for `smtp`: text trimmed, the port a number (the default when left blank). */
+export const smtpSettingsToInput = (value) => ({
+    host: text(value.host).trim(),
+    port: toPortValue(text(value.port)) || DEFAULT_SMTP_PORT,
+    useTls: value.useTls !== false,
+    username: text(value.username).trim(),
+});
+/**
+ * The panel the admin email page draws for the `smtp` transport.
+ *
+ * @param props - see {@link EmailTransportPanelProps}.
+ * @returns the panel.
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function SmtpTransportPanel({ value, onChange, secrets, onSecretChange, secretStatuses, errors, canWrite }) {
+    const status = secretStatuses.password ?? NOT_SAVED;
+    return (_jsxs(_Fragment, { children: [_jsx(Divider, { sx: { my: 3 } }), _jsx(Typography, { variant: "h6", gutterBottom: true, children: "SMTP" }), _jsxs(Grid, { container: true, spacing: 2, children: [_jsx(Grid, { size: { xs: 12, sm: 8 }, children: _jsx(TextField, { fullWidth: true, label: "Host", value: text(value.host), onChange: (e) => onChange('host', e.target.value), disabled: !canWrite, error: !!errors.host, helperText: errors.host ?? 'e.g. smtp.example.com' }) }), _jsx(Grid, { size: { xs: 12, sm: 4 }, children: _jsx(TextField, { fullWidth: true, label: "Port", 
+                            // `inputMode` rather than `type="number"`: a number
+                            // input adds spinners nobody wants on a port and lets
+                            // the browser hand back an empty string for "1e5",
+                            // which validates as blank rather than as invalid.
+                            slotProps: { htmlInput: { inputMode: 'numeric', pattern: '[0-9]*' } }, value: text(value.port), onChange: (e) => onChange('port', e.target.value), disabled: !canWrite, error: !!errors.port, helperText: errors.port ?? '587 for STARTTLS, 465 for implicit TLS.' }) }), _jsxs(Grid, { size: { xs: 12 }, children: [_jsx(FormControlLabel, { control: _jsx(Switch, { checked: value.useTls !== false, onChange: (e) => onChange('useTls', e.target.checked), disabled: !canWrite }), label: "Require TLS" }), _jsx(Typography, { variant: "body2", color: "text.secondary", sx: { ml: 6, mt: -0.5 }, children: "On by default, and refuses to send over an unencrypted connection: port 465 is TLS from the first byte, every other port must complete STARTTLS. Turn this off only for a legacy relay that cannot do either." })] }), _jsx(Grid, { size: { xs: 12, sm: 6 }, children: _jsx(TextField, { fullWidth: true, label: "Username", value: text(value.username), onChange: (e) => onChange('username', e.target.value), disabled: !canWrite, autoComplete: "off", helperText: "Leave blank for a relay that authorises by source IP." }) }), _jsx(Grid, { size: { xs: 12, sm: 6 }, children: _jsx(TextField, { fullWidth: true, type: "password", label: "Password", value: secrets.password ?? '', onChange: (e) => onSecretChange('password', e.target.value), disabled: !canWrite, 
+                            // A password manager filling this box would silently
+                            // re-send a credential the admin never typed.
+                            autoComplete: "new-password", placeholder: status.configured ? (status.hint ?? '••••••••') : '', helperText: smtpPasswordHelperText(status) }) })] })] }));
+}
+//# sourceMappingURL=SmtpTransportPanel.js.map

package/dist/email/ui/SmtpTransportPanel.js.map

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

package/dist/email/ui/builtinEmailTransportPanels.d.ts

@@ -0,0 +1,5 @@
+/** The ids of the transports whose bespoke panel ships with the slice. */
+export declare const BUILTIN_EMAIL_TRANSPORT_PANEL_IDS: readonly ["ses", "smtp"];
+/** Registers the bespoke panel of each built-in transport. Idempotent. */
+export declare function registerBuiltinEmailTransportPanels(): void;
+//# sourceMappingURL=builtinEmailTransportPanels.d.ts.map

package/dist/email/ui/builtinEmailTransportPanels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtinEmailTransportPanels.d.ts","sourceRoot":"","sources":["../../../src/email/ui/builtinEmailTransportPanels.ts"],"names":[],"mappings":"AAUA,0EAA0E;AAC1E,eAAO,MAAM,iCAAiC,0BAA2B,CAAC;AAE1E,0EAA0E;AAC1E,wBAAgB,mCAAmC,IAAI,IAAI,CAO1D"}

package/dist/email/ui/builtinEmailTransportPanels.js

@@ -0,0 +1,20 @@
+// The two built-in transports' bespoke panels, registered through the same
+// registry an app uses (PP-14.8). The admin email page calls this at module
+// scope; the components are the ones that have always drawn them, so their
+// markup is unchanged. A call, not a bare side-effect import: the package is
+// `sideEffects: false`.
+import { SesTransportPanel, sesSettingsToInput, validateSesSettings } from './SesTransportPanel.js';
+import { SmtpTransportPanel, smtpSettingsToForm, smtpSettingsToInput, validateSmtpSettings } from './SmtpTransportPanel.js';
+import { registerBuiltinEmailTransportPanel } from './emailTransportPanelRegistry.js';
+/** The ids of the transports whose bespoke panel ships with the slice. */
+export const BUILTIN_EMAIL_TRANSPORT_PANEL_IDS = ['ses', 'smtp'];
+/** Registers the bespoke panel of each built-in transport. Idempotent. */
+export function registerBuiltinEmailTransportPanels() {
+    registerBuiltinEmailTransportPanel('ses', SesTransportPanel, { validate: validateSesSettings, toInput: sesSettingsToInput });
+    registerBuiltinEmailTransportPanel('smtp', SmtpTransportPanel, {
+        validate: validateSmtpSettings,
+        toForm: smtpSettingsToForm,
+        toInput: smtpSettingsToInput,
+    });
+}
+//# sourceMappingURL=builtinEmailTransportPanels.js.map

package/dist/email/ui/builtinEmailTransportPanels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtinEmailTransportPanels.js","sourceRoot":"","sources":["../../../src/email/ui/builtinEmailTransportPanels.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4EAA4E;AAC5E,2EAA2E;AAC3E,6EAA6E;AAC7E,wBAAwB;AAExB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC5H,OAAO,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AAEtF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AAE1E,0EAA0E;AAC1E,MAAM,UAAU,mCAAmC;IACjD,kCAAkC,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,mBAAmB,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC7H,kCAAkC,CAAC,MAAM,EAAE,kBAAkB,EAAE;QAC7D,QAAQ,EAAE,oBAAoB;QAC9B,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,mBAAmB;KAC7B,CAAC,CAAC;AACL,CAAC"}

package/dist/email/ui/emailTransportPanelRegistry.d.ts

@@ -0,0 +1,126 @@
+import type { EmailCredentialStatusDto } from '@marinoscar/platform-contract/email';
+import type { PluggableDescriptor } from '@marinoscar/platform-contract/settings';
+import type { ComponentType } from 'react';
+import type { EmailSettings } from '../headless/index.js';
+/**
+ * What an email transport panel receives. The page owns the state and the
+ * save; a panel only presents and collects, exactly as `PluggableConfigForm`
+ * does.
+ *
+ * @extensionPoint slot
+ * @stability experimental
+ */
+export interface EmailTransportPanelProps {
+    /** The transport's id (a panel shared by several transports reads which one it draws). */
+    transport: string;
+    /** The transport as the API described it: its label, and a field per setting and secret. */
+    descriptor: PluggableDescriptor;
+    /** The stored configuration, for read-only facts. */
+    settings: EmailSettings;
+    /** The transport's non-secret settings as edited so far (the shape `toForm` returned). */
+    value: Readonly<Record<string, unknown>>;
+    /** Reports one changed setting; `undefined` removes it (a cleared string is sent as `''`). */
+    onChange: (name: string, next: unknown) => void;
+    /** The typed replacement of each declared secret, by name; `''` keeps the stored one. Never seeded from the server. */
+    secrets: Readonly<Record<string, string>>;
+    /** Reports one typed secret. */
+    onSecretChange: (name: string, next: string) => void;
+    /** The masked status of each declared secret, by name: whether one is stored, its hint, and when it last changed. Never the value. */
+    secretStatuses: Readonly<Record<string, EmailCredentialStatusDto>>;
+    /** Field errors from the registered `validate`, by setting name. */
+    errors: Readonly<Record<string, string>>;
+    /** Whether the viewer may change the configuration; every control is disabled without it. */
+    canWrite: boolean;
+}
+/**
+ * A component that draws one email transport's form on the admin email page.
+ * It receives {@link EmailTransportPanelProps}.
+ *
+ * @stability experimental
+ */
+export type EmailTransportPanelComponent = ComponentType<EmailTransportPanelProps>;
+/**
+ * Options of {@link registerEmailTransportPanel}.
+ *
+ * @stability experimental
+ */
+export interface EmailTransportPanelOptions {
+    /**
+     * Cheap, client-side checks of the SELECTED transport's settings, by setting
+     * name. `enabled` is whether email is switched on (the required-field rules
+     * apply only then). A non-empty result disables Save and is handed to the
+     * panel as `errors`. The API is the validator; this only stops an obvious
+     * typo round-tripping.
+     */
+    validate?: (value: Readonly<Record<string, unknown>>, context: {
+        enabled: boolean;
+    }) => Record<string, string>;
+    /**
+     * Turns the settings the API stored into the shape the panel edits (the SMTP
+     * panel edits the port as text). Default: the settings as they are.
+     */
+    toForm?: (settings: Readonly<Record<string, unknown>>) => Record<string, unknown>;
+    /**
+     * Turns the edited value back into the settings the API stores (the port as
+     * a number). Default: the value, with a text setting nobody filled in sent
+     * as `''` (the API merges over the stored settings, so an absent key would
+     * keep the old value).
+     */
+    toInput?: (value: Readonly<Record<string, unknown>>) => Record<string, unknown>;
+}
+/**
+ * Registers the component that draws email transport `id`'s form on the admin
+ * email page, replacing the generated form (and an earlier registration for the
+ * same id, so a hot module reload that re-runs the registering module works).
+ * Call it at module scope, before the page renders. An app's registration wins
+ * over a built-in's whichever module loads first.
+ *
+ * Needed only for a bespoke form: a transport registered with
+ * `registerEmailTransport` is drawn from its descriptor without it (its
+ * settings, and a write-only field per declared secret).
+ *
+ * @param id - the transport id the panel is for (`'sendgrid'`).
+ * @param Component - the panel; see {@link EmailTransportPanelProps} for its props.
+ * @param options - optional client-side validation and value conversion.
+ *
+ * @example
+ * ```tsx
+ * import { registerEmailTransportPanel } from '@marinoscar/platform-web/email/ui/transport-panels';
+ *
+ * registerEmailTransportPanel('sendgrid', SendgridPanel);
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function registerEmailTransportPanel(id: string, Component: EmailTransportPanelComponent, options?: EmailTransportPanelOptions): void;
+/**
+ * Registers a built-in transport's bespoke panel. Never replaces an app's
+ * registration for the same id, so the result does not depend on which module
+ * loaded first.
+ *
+ * @internal
+ */
+export declare function registerBuiltinEmailTransportPanel(id: string, Component: EmailTransportPanelComponent, options?: EmailTransportPanelOptions): void;
+/**
+ * The component registered for `id`, or `undefined` (the page then draws the
+ * generated form).
+ *
+ * @param id - the transport id.
+ * @stability experimental
+ */
+export declare function getEmailTransportPanel(id: string): EmailTransportPanelComponent | undefined;
+/**
+ * The options registered with `id`'s panel (`{}` when it has none).
+ *
+ * @param id - the transport id.
+ * @stability experimental
+ */
+export declare function getEmailTransportPanelOptions(id: string): EmailTransportPanelOptions;
+/**
+ * Forgets every app registration (tests only). The built-in panels stay.
+ *
+ * @internal
+ */
+export declare function resetEmailTransportPanelsForTests(): void;
+//# sourceMappingURL=emailTransportPanelRegistry.d.ts.map

package/dist/email/ui/emailTransportPanelRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emailTransportPanelRegistry.d.ts","sourceRoot":"","sources":["../../../src/email/ui/emailTransportPanelRegistry.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,0FAA0F;IAC1F,SAAS,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,UAAU,EAAE,mBAAmB,CAAC;IAChC,qDAAqD;IACrD,QAAQ,EAAE,aAAa,CAAC;IACxB,0FAA0F;IAC1F,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,8FAA8F;IAC9F,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,uHAAuH;IACvH,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,gCAAgC;IAChC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,sIAAsI;IACtI,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC;IACnE,oEAAoE;IACpE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,6FAA6F;IAC7F,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,aAAa,CAAC,wBAAwB,CAAC,CAAC;AAEnF;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/G;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClF;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjF;AAUD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,4BAA4B,EACvC,OAAO,GAAE,0BAA+B,GACvC,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAChD,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,4BAA4B,EACvC,OAAO,GAAE,0BAA+B,GACvC,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,4BAA4B,GAAG,SAAS,CAE3F;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,MAAM,GAAG,0BAA0B,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,IAAI,IAAI,CAExD"}

package/dist/email/ui/emailTransportPanelRegistry.js

@@ -0,0 +1,91 @@
+// =============================================================================
+// The email transport panel registry (PP-14.8)
+// =============================================================================
+//
+// The admin email page (`/admin/settings/email`) lists one radio per email
+// transport the API describes (`GET /api/email-settings`, `descriptors`) and
+// draws the selected transport's form below it. WHICH component draws that form
+// is decided here, by transport id:
+//
+//   - a transport with a REGISTERED panel gets that component. The two
+//     built-ins (`ses`, `smtp`) register their bespoke panel
+//     (`./builtinEmailTransportPanels.ts`), so their markup is exactly what it
+//     was before this registry existed;
+//   - every other transport gets `EmailGenericTransportPanel`, a form generated
+//     from the descriptor the API serves for it. An app that adds a transport
+//     with `registerEmailTransport` (`@marinoscar/platform-api/email`) therefore
+//     needs no web code at all, and registers a panel here only to replace the
+//     generated one.
+//
+// A registered panel is a presentation choice; it enforces nothing. The API
+// validates every save (`EMAIL_TRANSPORT_SETTINGS_INVALID`, ...), and a secret
+// is write-only whatever the panel does.
+// =============================================================================
+const panels = new Map();
+const builtinPanels = new Map();
+/**
+ * Registers the component that draws email transport `id`'s form on the admin
+ * email page, replacing the generated form (and an earlier registration for the
+ * same id, so a hot module reload that re-runs the registering module works).
+ * Call it at module scope, before the page renders. An app's registration wins
+ * over a built-in's whichever module loads first.
+ *
+ * Needed only for a bespoke form: a transport registered with
+ * `registerEmailTransport` is drawn from its descriptor without it (its
+ * settings, and a write-only field per declared secret).
+ *
+ * @param id - the transport id the panel is for (`'sendgrid'`).
+ * @param Component - the panel; see {@link EmailTransportPanelProps} for its props.
+ * @param options - optional client-side validation and value conversion.
+ *
+ * @example
+ * ```tsx
+ * import { registerEmailTransportPanel } from '@marinoscar/platform-web/email/ui/transport-panels';
+ *
+ * registerEmailTransportPanel('sendgrid', SendgridPanel);
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export function registerEmailTransportPanel(id, Component, options = {}) {
+    panels.set(id, { Component, options });
+}
+/**
+ * Registers a built-in transport's bespoke panel. Never replaces an app's
+ * registration for the same id, so the result does not depend on which module
+ * loaded first.
+ *
+ * @internal
+ */
+export function registerBuiltinEmailTransportPanel(id, Component, options = {}) {
+    builtinPanels.set(id, { Component, options });
+}
+/**
+ * The component registered for `id`, or `undefined` (the page then draws the
+ * generated form).
+ *
+ * @param id - the transport id.
+ * @stability experimental
+ */
+export function getEmailTransportPanel(id) {
+    return (panels.get(id) ?? builtinPanels.get(id))?.Component;
+}
+/**
+ * The options registered with `id`'s panel (`{}` when it has none).
+ *
+ * @param id - the transport id.
+ * @stability experimental
+ */
+export function getEmailTransportPanelOptions(id) {
+    return (panels.get(id) ?? builtinPanels.get(id))?.options ?? {};
+}
+/**
+ * Forgets every app registration (tests only). The built-in panels stay.
+ *
+ * @internal
+ */
+export function resetEmailTransportPanelsForTests() {
+    panels.clear();
+}
+//# sourceMappingURL=emailTransportPanelRegistry.js.map

package/dist/email/ui/emailTransportPanelRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emailTransportPanelRegistry.js","sourceRoot":"","sources":["../../../src/email/ui/emailTransportPanelRegistry.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,+CAA+C;AAC/C,gFAAgF;AAChF,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,gFAAgF;AAChF,oCAAoC;AACpC,EAAE;AACF,uEAAuE;AACvE,6DAA6D;AAC7D,+EAA+E;AAC/E,wCAAwC;AACxC,gFAAgF;AAChF,8EAA8E;AAC9E,iFAAiF;AACjF,+EAA+E;AAC/E,qBAAqB;AACrB,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,yCAAyC;AACzC,gFAAgF;AAgFhF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;AAC7C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAsB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,2BAA2B,CACzC,EAAU,EACV,SAAuC,EACvC,UAAsC,EAAE;IAExC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kCAAkC,CAChD,EAAU,EACV,SAAuC,EACvC,UAAsC,EAAE;IAExC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAU;IAC/C,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,EAAU;IACtD,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iCAAiC;IAC/C,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,5 @@
+export { default, default as EmailSettingsPage } from './EmailSettingsPage.js';
+export type { EmailSettingsPageProps, EmailSettingsPageSlots } from './EmailSettingsPage.js';
+export { EmailGenericTransportPanel, getEmailTransportPanel, registerEmailTransportPanel, } from './transport-panels.js';
+export type { EmailTransportPanelComponent, EmailTransportPanelOptions, EmailTransportPanelProps, } from './transport-panels.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/email/ui/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,4BAA4B,EAC5B,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,uBAAuB,CAAC"}

package/dist/email/ui/index.js

@@ -0,0 +1,9 @@
+// `@marinoscar/platform-web/email/ui`: the `/admin/settings/email` page
+// (issue #737, PP-8.4), as a default and a named export, so the app keeps
+// `lazy(() => import('@marinoscar/platform-web/email/ui'))` and the page stays
+// in a chunk of its own. Also the email transport panel registry (PP-14.8):
+// `registerEmailTransportPanel`, and the generic panel it falls back to.
+// Documented in ../README.md.
+export { default, default as EmailSettingsPage } from './EmailSettingsPage.js';
+export { EmailGenericTransportPanel, getEmailTransportPanel, registerEmailTransportPanel, } from './transport-panels.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/email/ui/index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0EAA0E;AAC1E,+EAA+E;AAC/E,4EAA4E;AAC5E,yEAAyE;AACzE,8BAA8B;AAE9B,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC"}

package/dist/email/ui/transport-panels.d.ts

@@ -0,0 +1,4 @@
+export { registerEmailTransportPanel, getEmailTransportPanel } from './emailTransportPanelRegistry.js';
+export type { EmailTransportPanelComponent, EmailTransportPanelOptions, EmailTransportPanelProps, } from './emailTransportPanelRegistry.js';
+export { EmailGenericTransportPanel } from './EmailGenericTransportPanel.js';
+//# sourceMappingURL=transport-panels.d.ts.map

package/dist/email/ui/transport-panels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-panels.d.ts","sourceRoot":"","sources":["../../../src/email/ui/transport-panels.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AACvG,YAAY,EACV,4BAA4B,EAC5B,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/email/ui/transport-panels.js

@@ -0,0 +1,7 @@
+// `@marinoscar/platform-web/email/ui/transport-panels`: the email transport
+// panel registry (PP-14.8), alone, so an app registers a panel from its main
+// chunk without pulling the email page in. Also exported by `/email/ui`.
+// Documented in ../README.md.
+export { registerEmailTransportPanel, getEmailTransportPanel } from './emailTransportPanelRegistry.js';
+export { EmailGenericTransportPanel } from './EmailGenericTransportPanel.js';
+//# sourceMappingURL=transport-panels.js.map

package/dist/email/ui/transport-panels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-panels.js","sourceRoot":"","sources":["../../../src/email/ui/transport-panels.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,yEAAyE;AACzE,8BAA8B;AAE9B,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAMvG,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC"}

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

@@ -0,0 +1,61 @@
+import type { CreateExportInput, ExportListResponse, ExportSourcesResponse, ExportView } from '@marinoscar/platform-contract/exports';
+import type { PlatformApiClient } from '../../core/index.js';
+/**
+ * The export API calls (`/api/exports`).
+ *
+ * @stability experimental
+ */
+export interface ExportsClient {
+    /** `GET /exports/sources`: the sources and formats the caller may use. */
+    sources(): Promise<ExportSourcesResponse>;
+    /** `GET /exports`: the caller's recent exports, without download URLs. */
+    list(): Promise<ExportListResponse>;
+    /** `GET /exports/:id`: one export, with a fresh signed `download` while ready. */
+    get(id: string): Promise<ExportView>;
+    /** `POST /exports`: queues an export; resolves with it, `pending`. */
+    create(input: CreateExportInput): Promise<ExportView>;
+}
+/**
+ * The exports client over the app's transport.
+ *
+ * @param api - the app's transport (`usePlatformApi()`).
+ * @returns the client.
+ *
+ * @example
+ * ```ts
+ * const client = createExportsClient(usePlatformApi());
+ * const view = await client.create({ source: 'user-data', format: 'json' });
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function createExportsClient(api: PlatformApiClient): ExportsClient;
+/**
+ * Whether an export may still change on its own (`pending`, `running`).
+ *
+ * @param view - an export.
+ * @returns `true` while the job has not settled.
+ *
+ * @stability experimental
+ */
+export declare function isExportInProgress(view: Pick<ExportView, 'status'>): boolean;
+/**
+ * An export's status in words (never a colour alone).
+ *
+ * @param status - the derived status.
+ * @returns the label.
+ *
+ * @stability experimental
+ */
+export declare function exportStatusLabel(status: ExportView['status']): string;
+/**
+ * Bytes as a short human size (`1.5 MB`).
+ *
+ * @param bytes - the size, or `null`.
+ * @returns the text, or an empty string for `null`.
+ *
+ * @stability experimental
+ */
+export declare function formatExportSize(bytes: number | null): string;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/exports/headless/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,EACX,MAAM,uCAAuC,CAAC;AAE/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,OAAO,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC1C,0EAA0E;IAC1E,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpC,kFAAkF;IAClF,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,sEAAsE;IACtE,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,iBAAiB,GAAG,aAAa,CAOzE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,OAAO,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,MAAM,CAatE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAW7D"}

package/dist/exports/headless/client.js

@@ -0,0 +1,80 @@
+import { EXPORTS_PATH, EXPORTS_SOURCES_PATH } from '@marinoscar/platform-contract/exports';
+/**
+ * The exports client over the app's transport.
+ *
+ * @param api - the app's transport (`usePlatformApi()`).
+ * @returns the client.
+ *
+ * @example
+ * ```ts
+ * const client = createExportsClient(usePlatformApi());
+ * const view = await client.create({ source: 'user-data', format: 'json' });
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export function createExportsClient(api) {
+    return {
+        sources: () => api.get(EXPORTS_SOURCES_PATH),
+        list: () => api.get(EXPORTS_PATH),
+        get: (id) => api.get(`${EXPORTS_PATH}/${encodeURIComponent(id)}`),
+        create: (input) => api.post(EXPORTS_PATH, input),
+    };
+}
+/**
+ * Whether an export may still change on its own (`pending`, `running`).
+ *
+ * @param view - an export.
+ * @returns `true` while the job has not settled.
+ *
+ * @stability experimental
+ */
+export function isExportInProgress(view) {
+    return view.status === 'pending' || view.status === 'running';
+}
+/**
+ * An export's status in words (never a colour alone).
+ *
+ * @param status - the derived status.
+ * @returns the label.
+ *
+ * @stability experimental
+ */
+export function exportStatusLabel(status) {
+    switch (status) {
+        case 'pending':
+            return 'Queued';
+        case 'running':
+            return 'Preparing';
+        case 'ready':
+            return 'Ready to download';
+        case 'expired':
+            return 'Expired';
+        case 'failed':
+            return 'Failed';
+    }
+}
+/**
+ * Bytes as a short human size (`1.5 MB`).
+ *
+ * @param bytes - the size, or `null`.
+ * @returns the text, or an empty string for `null`.
+ *
+ * @stability experimental
+ */
+export function formatExportSize(bytes) {
+    if (bytes === null)
+        return '';
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const units = ['KB', 'MB', 'GB', 'TB'];
+    let value = bytes / 1024;
+    let unit = 0;
+    while (value >= 1024 && unit < units.length - 1) {
+        value /= 1024;
+        unit += 1;
+    }
+    return `${value >= 10 ? value.toFixed(0) : value.toFixed(1)} ${units[unit]}`;
+}
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/exports/headless/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AA0B3F;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAsB;IACxD,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAwB,oBAAoB,CAAC;QACnE,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAqB,YAAY,CAAC;QACrD,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAa,GAAG,YAAY,IAAI,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7E,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAa,YAAY,EAAE,KAAK,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAgC;IACjE,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;AAChE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA4B;IAC5D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC;QACrB,KAAK,OAAO;YACV,OAAO,mBAAmB,CAAC;QAC7B,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;IACzB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,KAAK,IAAI,IAAI,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,KAAK,IAAI,IAAI,CAAC;QACd,IAAI,IAAI,CAAC,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;AAC/E,CAAC"}