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

package/dist/testing/test-platform-host.js

@@ -0,0 +1,115 @@
+// A platform host for PACKAGE tests (issue #696). It answers API calls from a
+// table of canned responses and records every request, so a packaged page can
+// be tested without the app, its transport or a mock server.
+/**
+ * A rejection value shaped like the app adapter's errors.
+ *
+ * @param status - the HTTP status.
+ * @param message - the API's message.
+ * @param code - the API's error code.
+ * @param details - the error envelope's `details` (e.g. `{ reason: 'LAST_GROUP_ADMIN' }`).
+ * @returns an `Error` that is also a {@link PlatformApiError}.
+ *
+ * @stability experimental
+ */
+export function createTestApiError(status, message, code, details) {
+    return Object.assign(new Error(message), {
+        name: 'PlatformApiError',
+        status,
+        ...(code === undefined ? {} : { code }),
+        ...(details === undefined ? {} : { details }),
+    });
+}
+/**
+ * A canned download for {@link PlatformApiClient.getBlob}: a body and response headers.
+ *
+ * @param body - the file's text.
+ * @param headers - response headers, e.g. `{ 'Content-Disposition': 'attachment; filename="x.json"' }`.
+ * @returns the blob response.
+ *
+ * @stability experimental
+ */
+export function createTestBlobResponse(body, headers = {}) {
+    const lower = new Map(Object.entries(headers).map(([name, value]) => [name.toLowerCase(), value]));
+    return {
+        blob: new Blob([body], { type: lower.get('content-type') ?? 'application/octet-stream' }),
+        headers: { get: (name) => lower.get(name.toLowerCase()) ?? null },
+    };
+}
+/**
+ * Builds a host for package tests: canned API responses, a viewer with the
+ * given permissions and features, and a log of every request.
+ *
+ * @param options - see {@link TestPlatformHostOptions}.
+ * @returns the host; pass it to `PlatformHostProvider`.
+ *
+ * @example
+ * ```tsx
+ * const host = createTestPlatformHost({
+ *   permissions: ['system_settings:read'],
+ *   responses: { 'GET /admin/doctor': report },
+ * });
+ * render(<PlatformHostProvider host={host}><DoctorPage /></PlatformHostProvider>);
+ * ```
+ *
+ * @stability experimental
+ */
+export function createTestPlatformHost(options = {}) {
+    const requests = [];
+    const responses = options.responses ?? {};
+    const permissions = new Set(options.permissions ?? []);
+    const features = options.features ?? {};
+    const call = async (request) => {
+        requests.push(request);
+        const bare = request.path.split('?')[0] ?? request.path;
+        const keys = [`${request.method} ${request.path}`, `${request.method} ${bare}`, bare];
+        const key = keys.find((k) => Object.prototype.hasOwnProperty.call(responses, k));
+        if (key === undefined) {
+            throw createTestApiError(404, `No test response for ${request.method} ${request.path}`);
+        }
+        const response = responses[key];
+        return (await (typeof response === 'function' ? response(request) : response));
+    };
+    const withIfMatch = (options) => ({
+        ...(options?.ifMatch === undefined ? {} : { ifMatch: options.ifMatch }),
+        ...withHeaders(options),
+    });
+    const withHeaders = (options) => options?.headers === undefined ? {} : { headers: options.headers };
+    const api = {
+        get: (path, getOptions) => call({ method: 'GET', path, ...withHeaders(getOptions) }),
+        post: (path, body, postOptions) => call({ method: 'POST', path, body, ...withHeaders(postOptions) }),
+        put: (path, body, putOptions) => call({ method: 'PUT', path, body, ...withIfMatch(putOptions) }),
+        patch: (path, body, patchOptions) => call({ method: 'PATCH', path, body, ...withIfMatch(patchOptions) }),
+        delete: (path, deleteOptions) => call({ method: 'DELETE', path, ...withIfMatch(deleteOptions) }),
+        // Downloads answer from the same table (`'GET <path>'`, `'POST <path>'`);
+        // the canned value is a `PlatformBlobResponse`, e.g. from `createTestBlobResponse`.
+        getBlob: (path) => call({ method: 'GET', path }),
+        postBlob: (path, body) => call({ method: 'POST', path, body }),
+        // A multipart upload answers from `'POST <path>'`; the request's `body` is the FormData.
+        postFormData: (path, body) => call({ method: 'POST', path, body }),
+        // A stream answers with an array of frames; anything else delivers none.
+        postSse: async (path, body, sseOptions) => {
+            const frames = await call({ method: 'POST', path, body });
+            if (!Array.isArray(frames))
+                return;
+            for (const frame of frames) {
+                if (sseOptions.signal?.aborted)
+                    return;
+                sseOptions.onFrame(frame.event, frame.data);
+            }
+        },
+    };
+    return {
+        api,
+        viewer: {
+            userId: options.userId === undefined ? 'test-user' : options.userId,
+            hasPermission: (permission) => permissions.has(permission),
+            isFeatureEnabled: (feature) => features[feature] === true,
+        },
+        ...(options.formatRelativeTime ? { formatRelativeTime: options.formatRelativeTime } : {}),
+        ...(options.applyTheme ? { applyTheme: options.applyTheme } : {}),
+        ...(options.extensions ? { extensions: options.extensions } : {}),
+        requests,
+    };
+}
+//# sourceMappingURL=test-platform-host.js.map

package/dist/testing/test-platform-host.js.map

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

package/dist/user-data/headless/client.d.ts

@@ -0,0 +1,63 @@
+import type { FactoryResetStatus, FactoryResetSummary, OrgOffboardingRequest, OrgOffboardingStatus, OrgOffboardingSummary, UserDataDeletionStatus, UserDataJobStarted, UserDataSummary } from '@marinoscar/platform-contract/user-data';
+import type { PlatformApiClient } from '../../core/index.js';
+/**
+ * The per-user deletion routes.
+ *
+ * @stability experimental
+ */
+export interface UserDataClient {
+    /** `GET /user-data/summary`. */
+    summary(): Promise<UserDataSummary>;
+    /** `POST /user-data/deletions`. */
+    requestDeletion(scope: string, confirmation: string): Promise<UserDataJobStarted>;
+    /** `GET /user-data/deletions/:jobId`. */
+    deletionStatus(jobId: string): Promise<UserDataDeletionStatus>;
+}
+/**
+ * The factory reset routes.
+ *
+ * @stability experimental
+ */
+export interface FactoryResetClient {
+    /** `GET /admin/factory-reset/summary`. */
+    summary(): Promise<FactoryResetSummary>;
+    /** `POST /admin/factory-reset`. */
+    request(confirmation: string): Promise<UserDataJobStarted>;
+    /** `GET /admin/factory-reset/:jobId`. */
+    status(jobId: string): Promise<FactoryResetStatus>;
+}
+/**
+ * The organization offboarding routes.
+ *
+ * @stability experimental
+ */
+export interface OrgOffboardingClient {
+    /** `GET /admin/orgs/:orgId/offboarding/summary`. */
+    summary(orgId: string): Promise<OrgOffboardingSummary>;
+    /** `POST /admin/orgs/:orgId/offboarding`. */
+    request(orgId: string, body: OrgOffboardingRequest): Promise<UserDataJobStarted>;
+    /** `GET /admin/orgs/:orgId/offboarding/:jobId`. */
+    status(orgId: string, jobId: string): Promise<OrgOffboardingStatus>;
+}
+/**
+ * The per-user deletion client.
+ *
+ * @param api - the app's transport (`usePlatformApi()`).
+ * @stability experimental
+ */
+export declare function createUserDataClient(api: PlatformApiClient): UserDataClient;
+/**
+ * The factory reset client.
+ *
+ * @param api - the app's transport.
+ * @stability experimental
+ */
+export declare function createFactoryResetClient(api: PlatformApiClient): FactoryResetClient;
+/**
+ * The organization offboarding client.
+ *
+ * @param api - the app's transport.
+ * @stability experimental
+ */
+export declare function createOrgOffboardingClient(api: PlatformApiClient): OrgOffboardingClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/user-data/headless/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/user-data/headless/client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EAChB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACpC,mCAAmC;IACnC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAClF,yCAAyC;IACzC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAChE;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACxC,mCAAmC;IACnC,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3D,yCAAyC;IACzC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACpD;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACvD,6CAA6C;IAC7C,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjF,mDAAmD;IACnD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACrE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,cAAc,CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,iBAAiB,GAAG,kBAAkB,CAOnF;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,iBAAiB,GAAG,oBAAoB,CAMvF"}

package/dist/user-data/headless/client.js

@@ -0,0 +1,44 @@
+// The user-data API calls over the app's transport (issue #743, PP-9.1).
+// Routes: `@marinoscar/platform-contract/user-data` (`USER_DATA_PATHS`).
+import { USER_DATA_PATHS } from '@marinoscar/platform-contract/user-data';
+/**
+ * The per-user deletion client.
+ *
+ * @param api - the app's transport (`usePlatformApi()`).
+ * @stability experimental
+ */
+export function createUserDataClient(api) {
+    return {
+        summary: () => api.get(USER_DATA_PATHS.summary),
+        requestDeletion: (scope, confirmation) => api.post(USER_DATA_PATHS.deletions, { scope, confirmation }),
+        deletionStatus: (jobId) => api.get(`${USER_DATA_PATHS.deletions}/${encodeURIComponent(jobId)}`),
+    };
+}
+/**
+ * The factory reset client.
+ *
+ * @param api - the app's transport.
+ * @stability experimental
+ */
+export function createFactoryResetClient(api) {
+    const base = USER_DATA_PATHS.factoryReset;
+    return {
+        summary: () => api.get(`${base}/summary`),
+        request: (confirmation) => api.post(base, { confirmation }),
+        status: (jobId) => api.get(`${base}/${encodeURIComponent(jobId)}`),
+    };
+}
+/**
+ * The organization offboarding client.
+ *
+ * @param api - the app's transport.
+ * @stability experimental
+ */
+export function createOrgOffboardingClient(api) {
+    return {
+        summary: (orgId) => api.get(`${USER_DATA_PATHS.offboarding(orgId)}/summary`),
+        request: (orgId, body) => api.post(USER_DATA_PATHS.offboarding(orgId), body),
+        status: (orgId, jobId) => api.get(`${USER_DATA_PATHS.offboarding(orgId)}/${encodeURIComponent(jobId)}`),
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/user-data/headless/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/user-data/headless/client.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,yEAAyE;AAEzE,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAwD1E;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAsB;IACzD,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAkB,eAAe,CAAC,OAAO,CAAC;QAChE,eAAe,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAqB,eAAe,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QAC1H,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAyB,GAAG,eAAe,CAAC,SAAS,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;KACxH,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAsB;IAC7D,MAAM,IAAI,GAAG,eAAe,CAAC,YAAY,CAAC;IAC1C,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAsB,GAAG,IAAI,UAAU,CAAC;QAC9D,OAAO,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAqB,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC;QAC/E,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAqB,GAAG,IAAI,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;KACvF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAsB;IAC/D,OAAO;QACL,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAwB,GAAG,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC;QACnG,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAqB,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;QAChG,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAuB,GAAG,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;KAC9H,CAAC;AACJ,CAAC"}

package/dist/user-data/headless/index.d.ts

@@ -0,0 +1,7 @@
+export { createFactoryResetClient, createOrgOffboardingClient, createUserDataClient } from './client.js';
+export type { FactoryResetClient, OrgOffboardingClient, UserDataClient } from './client.js';
+export { useCompletionHandler, useDestructiveJob } from './use-destructive-job.js';
+export type { DestructiveJobPhase, DestructiveJobStatus, UseDestructiveJobOptions, UseDestructiveJobReturn, } from './use-destructive-job.js';
+export { DANGER_ZONE_GROUP_LABEL, dangerZoneLastViolations } from './sections.js';
+export type { SettingsCardLike, SettingsSectionLike, SettingsSectionsLike } from './sections.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/user-data/headless/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/user-data/headless/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACzG,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACnF,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAClF,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/user-data/headless/index.js

@@ -0,0 +1,7 @@
+// `@marinoscar/platform-web/user-data/headless`: the user-data slice's
+// clients, the destructive-job hook and the Danger-Zone-last check, with no
+// component (issue #743, PP-9.1). Documented in ../README.md.
+export { createFactoryResetClient, createOrgOffboardingClient, createUserDataClient } from './client.js';
+export { useCompletionHandler, useDestructiveJob } from './use-destructive-job.js';
+export { DANGER_ZONE_GROUP_LABEL, dangerZoneLastViolations } from './sections.js';
+//# sourceMappingURL=index.js.map

package/dist/user-data/headless/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/user-data/headless/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,4EAA4E;AAC5E,8DAA8D;AAE9D,OAAO,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEzG,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAOnF,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}

package/dist/user-data/headless/sections.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The label of the Danger Zone group, in both registries.
+ *
+ * @stability experimental
+ */
+export declare const DANGER_ZONE_GROUP_LABEL = "Danger Zone";
+/**
+ * One card of a settings group, as the check reads it.
+ *
+ * @stability experimental
+ */
+export interface SettingsCardLike {
+    /** The route the card opens. */
+    readonly path?: string;
+}
+/**
+ * One settings group, as the check reads it.
+ *
+ * @stability experimental
+ */
+export interface SettingsSectionLike {
+    /** The group label. */
+    readonly label: string;
+    /** Its cards. */
+    readonly cards: readonly SettingsCardLike[];
+}
+/**
+ * The structural shape of a settings registry the check reads.
+ *
+ * @stability experimental
+ */
+export interface SettingsSectionsLike {
+    /** The number of groups. */
+    readonly length: number;
+    /** Each group, in hub order. */
+    readonly [index: number]: SettingsSectionLike;
+}
+/**
+ * Why a registry breaks the Danger-Zone-last rule: no Danger Zone group, more
+ * than one, not last, or missing the expected card path.
+ *
+ * @param sections - `ADMIN_SECTIONS` or `USER_SETTINGS_SECTIONS`.
+ * @param expectedPath - the card the group must hold (`/settings/danger-zone`, `/admin/settings/factory-reset`).
+ * @returns one message per problem; empty when the registry conforms.
+ *
+ * @stability experimental
+ * @extensionPoint hook
+ * @example
+ * ```ts
+ * expect(dangerZoneLastViolations(USER_SETTINGS_SECTIONS, '/settings/danger-zone')).toEqual([]);
+ * ```
+ */
+export declare function dangerZoneLastViolations(sections: SettingsSectionsLike, expectedPath: string): string[];
+//# sourceMappingURL=sections.d.ts.map

package/dist/user-data/headless/sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../../src/user-data/headless/sections.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,gBAAgB,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAAC;CAC/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAYvG"}

package/dist/user-data/headless/sections.js

@@ -0,0 +1,43 @@
+// The Danger Zone groups of the settings registries (issue #743, PP-9.1).
+//
+// Both registries pin their `Danger Zone` group LAST: the one documented
+// exception to append-only (docs/specs/settings-ui.md). A group added later is
+// inserted before it. `dangerZoneLastViolations` is the web conformance check.
+/**
+ * The label of the Danger Zone group, in both registries.
+ *
+ * @stability experimental
+ */
+export const DANGER_ZONE_GROUP_LABEL = 'Danger Zone';
+/**
+ * Why a registry breaks the Danger-Zone-last rule: no Danger Zone group, more
+ * than one, not last, or missing the expected card path.
+ *
+ * @param sections - `ADMIN_SECTIONS` or `USER_SETTINGS_SECTIONS`.
+ * @param expectedPath - the card the group must hold (`/settings/danger-zone`, `/admin/settings/factory-reset`).
+ * @returns one message per problem; empty when the registry conforms.
+ *
+ * @stability experimental
+ * @extensionPoint hook
+ * @example
+ * ```ts
+ * expect(dangerZoneLastViolations(USER_SETTINGS_SECTIONS, '/settings/danger-zone')).toEqual([]);
+ * ```
+ */
+export function dangerZoneLastViolations(sections, expectedPath) {
+    const labels = Array.from({ length: sections.length }, (_, i) => sections[i].label);
+    const indexes = labels.flatMap((label, i) => (label === DANGER_ZONE_GROUP_LABEL ? [i] : []));
+    if (indexes.length === 0)
+        return [`no "${DANGER_ZONE_GROUP_LABEL}" group`];
+    const problems = [];
+    if (indexes.length > 1)
+        problems.push(`${indexes.length} "${DANGER_ZONE_GROUP_LABEL}" groups; there must be one`);
+    if (indexes[indexes.length - 1] !== sections.length - 1) {
+        problems.push(`"${DANGER_ZONE_GROUP_LABEL}" is not the last group (last is "${labels[labels.length - 1]}"); insert new groups before it`);
+    }
+    const group = sections[indexes[0]];
+    if (!group.cards.some((card) => card.path === expectedPath))
+        problems.push(`"${DANGER_ZONE_GROUP_LABEL}" has no card for ${expectedPath}`);
+    return problems;
+}
+//# sourceMappingURL=sections.js.map

package/dist/user-data/headless/sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.js","sourceRoot":"","sources":["../../../src/user-data/headless/sections.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,yEAAyE;AACzE,+EAA+E;AAC/E,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAAC;AAoCrD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAA8B,EAAE,YAAoB;IAC3F,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,OAAO,uBAAuB,SAAS,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,KAAK,uBAAuB,6BAA6B,CAAC,CAAC;IAClH,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,QAAQ,CAAC,IAAI,CAAC,IAAI,uBAAuB,qCAAqC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,iCAAiC,CAAC,CAAC;IAC5I,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAE,CAAE,CAAC;IACrC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,uBAAuB,qBAAqB,YAAY,EAAE,CAAC,CAAC;IAC3I,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/user-data/headless/use-destructive-job.d.ts

@@ -0,0 +1,84 @@
+import type { UserDataJobStarted, UserDataJobStatus } from '@marinoscar/platform-contract/user-data';
+/**
+ * Where a destructive job is: `idle` (not started), `running` (requested,
+ * pending or running), `succeeded` or `failed`.
+ *
+ * @stability experimental
+ */
+export type DestructiveJobPhase = 'idle' | 'running' | 'succeeded' | 'failed';
+/**
+ * What a status route answers, as the hook needs it.
+ *
+ * @stability experimental
+ */
+export interface DestructiveJobStatus<TResult> {
+    /** The job status. */
+    status: UserDataJobStatus;
+    /** The result, once succeeded. */
+    result: TResult | null;
+    /** The failure, once failed. */
+    error: string | null;
+}
+/**
+ * Options of {@link useDestructiveJob}.
+ *
+ * @stability experimental
+ */
+export interface UseDestructiveJobOptions<TResult> {
+    /** Requests the job. */
+    start(): Promise<UserDataJobStarted>;
+    /** Reads its status. */
+    poll(jobId: string): Promise<DestructiveJobStatus<TResult>>;
+    /** Poll interval in milliseconds. Default 1500. */
+    intervalMs?: number;
+    /** Called once when the job succeeds (clear caches, refetch the profile). */
+    onSucceeded?(result: TResult | null): void;
+}
+/**
+ * The state {@link useDestructiveJob} returns.
+ *
+ * @stability experimental
+ */
+export interface UseDestructiveJobReturn<TResult> {
+    /** See {@link DestructiveJobPhase}. */
+    phase: DestructiveJobPhase;
+    /** The job id, once requested. */
+    jobId: string | null;
+    /** The result, once succeeded. */
+    result: TResult | null;
+    /** The request or job failure, for display. */
+    error: string | null;
+    /** Requests the job and starts polling. */
+    run(): Promise<void>;
+    /** Back to `idle` (after a failure, to retry; after success, to close). */
+    reset(): void;
+}
+/**
+ * Starts a destructive job (`POST`) and polls its status route until it
+ * succeeds or fails. A request error (a wrong phrase is a 400) lands in
+ * `error` with phase `failed`.
+ *
+ * @param options - see {@link UseDestructiveJobOptions}.
+ * @returns see {@link UseDestructiveJobReturn}.
+ *
+ * @stability experimental
+ * @example
+ * ```tsx
+ * const job = useDestructiveJob({ start: () => client.request('FACTORY RESET'), poll: client.status });
+ * ```
+ */
+export declare function useDestructiveJob<TResult>(options: UseDestructiveJobOptions<TResult>): UseDestructiveJobReturn<TResult>;
+/**
+ * Wraps a page's `onCompleted` so the viewer is re-read afterwards. A
+ * deletion or a factory reset changes the signed-in user's own account
+ * (display name, avatar), so the page asks the host's `viewer.refresh` (when
+ * the app supplies one) after calling the app's own callback. A refresh that
+ * rejects is swallowed: the action already succeeded.
+ *
+ * @param onCompleted - the page's optional callback.
+ * @returns a stable-per-render callback to hand to {@link useDestructiveJob}.
+ *
+ * @stability experimental
+ */
+export declare function useCompletionHandler<TResult>(onCompleted: ((result: TResult | null) => void) | undefined): (result: TResult | null) => void;
+//# sourceMappingURL=use-destructive-job.d.ts.map

package/dist/user-data/headless/use-destructive-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-destructive-job.d.ts","sourceRoot":"","sources":["../../../src/user-data/headless/use-destructive-job.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAIrG;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9E;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,OAAO;IAC3C,sBAAsB;IACtB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,kCAAkC;IAClC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,gCAAgC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB,CAAC,OAAO;IAC/C,wBAAwB;IACxB,KAAK,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,wBAAwB;IACxB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,WAAW,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;CAC5C;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB,CAAC,OAAO;IAC9C,uCAAuC;IACvC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,kCAAkC;IAClC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,kCAAkC;IAClC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2CAA2C;IAC3C,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,2EAA2E;IAC3E,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAqEvH;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,GAC1D,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CASlC"}

package/dist/user-data/headless/use-destructive-job.js

@@ -0,0 +1,110 @@
+// Start one destructive job and poll it until it settles (issue #743).
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { isPlatformApiError, useOptionalPlatformHost } from '../../core/index.js';
+/**
+ * Starts a destructive job (`POST`) and polls its status route until it
+ * succeeds or fails. A request error (a wrong phrase is a 400) lands in
+ * `error` with phase `failed`.
+ *
+ * @param options - see {@link UseDestructiveJobOptions}.
+ * @returns see {@link UseDestructiveJobReturn}.
+ *
+ * @stability experimental
+ * @example
+ * ```tsx
+ * const job = useDestructiveJob({ start: () => client.request('FACTORY RESET'), poll: client.status });
+ * ```
+ */
+export function useDestructiveJob(options) {
+    const [phase, setPhase] = useState('idle');
+    const [jobId, setJobId] = useState(null);
+    const [result, setResult] = useState(null);
+    const [error, setError] = useState(null);
+    const latest = useRef(options);
+    latest.current = options;
+    const timer = useRef(null);
+    const alive = useRef(true);
+    useEffect(() => {
+        alive.current = true;
+        return () => {
+            alive.current = false;
+            if (timer.current)
+                clearTimeout(timer.current);
+        };
+    }, []);
+    const pollOnce = useCallback(async (id) => {
+        try {
+            const status = await latest.current.poll(id);
+            if (!alive.current)
+                return;
+            if (status.status === 'succeeded') {
+                setResult(status.result);
+                setPhase('succeeded');
+                latest.current.onSucceeded?.(status.result);
+                return;
+            }
+            if (status.status === 'failed') {
+                setError(status.error ?? 'The job failed');
+                setPhase('failed');
+                return;
+            }
+        }
+        catch (err) {
+            // A transient read failure: keep polling, the job keeps running.
+            if (isPlatformApiError(err) && err.status === 404) {
+                setError(err.message);
+                setPhase('failed');
+                return;
+            }
+        }
+        timer.current = setTimeout(() => void pollOnce(id), latest.current.intervalMs ?? 1500);
+    }, []);
+    const run = useCallback(async () => {
+        setError(null);
+        setResult(null);
+        setPhase('running');
+        try {
+            const started = await latest.current.start();
+            if (!alive.current)
+                return;
+            setJobId(started.jobId);
+            await pollOnce(started.jobId);
+        }
+        catch (err) {
+            if (!alive.current)
+                return;
+            setError(err instanceof Error || isPlatformApiError(err) ? err.message : 'The request failed');
+            setPhase('failed');
+        }
+    }, [pollOnce]);
+    const reset = useCallback(() => {
+        if (timer.current)
+            clearTimeout(timer.current);
+        setPhase('idle');
+        setJobId(null);
+        setResult(null);
+        setError(null);
+    }, []);
+    return { phase, jobId, result, error, run, reset };
+}
+/**
+ * Wraps a page's `onCompleted` so the viewer is re-read afterwards. A
+ * deletion or a factory reset changes the signed-in user's own account
+ * (display name, avatar), so the page asks the host's `viewer.refresh` (when
+ * the app supplies one) after calling the app's own callback. A refresh that
+ * rejects is swallowed: the action already succeeded.
+ *
+ * @param onCompleted - the page's optional callback.
+ * @returns a stable-per-render callback to hand to {@link useDestructiveJob}.
+ *
+ * @stability experimental
+ */
+export function useCompletionHandler(onCompleted) {
+    const refresh = useOptionalPlatformHost()?.viewer.refresh;
+    return useCallback((result) => {
+        onCompleted?.(result);
+        if (refresh)
+            void refresh().catch(() => undefined);
+    }, [onCompleted, refresh]);
+}
+//# sourceMappingURL=use-destructive-job.js.map

package/dist/user-data/headless/use-destructive-job.js.map

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

package/dist/user-data/ui/FactoryResetPage.d.ts

@@ -0,0 +1,66 @@
+import type { ReactElement, ReactNode } from 'react';
+import { type FactoryResetResult } from '@marinoscar/platform-contract/user-data';
+import type { PageSlotsBase } from '../../core/index.js';
+/**
+ * Props of {@link FactoryResetPage}.
+ *
+ * @stability experimental
+ */
+export interface FactoryResetPageProps {
+    /**
+     * Called after the reset succeeds: clear client caches. The viewer itself is
+     * re-read by the page (the host's `viewer.refresh`).
+     */
+    onCompleted?(result: FactoryResetResult | null): void;
+    /** Poll interval of the job status, in milliseconds. Default 1500. */
+    pollIntervalMs?: number;
+    /** Optional extension slots; omitted, the page renders exactly as it always did. */
+    slots?: FactoryResetPageSlots;
+    /** The page's words, each optional; omitted, the platform wording. */
+    copy?: FactoryResetPageCopy;
+}
+/**
+ * The slots of {@link FactoryResetPage}: the page-slot contract. `Sections` is
+ * drawn at both ends of the body, around the warning, the lists and the button.
+ * The "Deleted" and "Kept" lists themselves come from the summary route: an app
+ * adds a line by registering a factory reset step or a kept model with a
+ * `summary` on the API, not by a slot.
+ *
+ * @example
+ * ```tsx
+ * <FactoryResetPage slots={{ BeforeContent: () => <Alert severity="warning">Announce the reset first.</Alert> }} />
+ * ```
+ *
+ * @extensionPoint slot
+ * @stability experimental
+ */
+export type FactoryResetPageSlots = PageSlotsBase;
+/**
+ * The words of {@link FactoryResetPage}, each optional.
+ *
+ * @stability experimental
+ */
+export interface FactoryResetPageCopy {
+    /** The `h1`. Default "Factory reset". */
+    title?: string;
+    /** The bold sentence in the red-bordered warning. Default "This erases the whole application for everyone and cannot be undone." */
+    warning?: ReactNode;
+    /** The heading of the left column. Default "Deleted". */
+    deletedHeading?: string;
+    /** The heading of the right column. Default "Kept". */
+    keptHeading?: string;
+}
+/**
+ * The `/admin/settings/factory-reset` page. See the file header.
+ *
+ * @param props - see {@link FactoryResetPageProps}.
+ *
+ * @stability experimental
+ * @extensionPoint component
+ * @example
+ * ```tsx
+ * <Route path="/admin/settings/factory-reset" element={<FactoryResetPage />} />
+ * ```
+ */
+export declare function FactoryResetPage(props: FactoryResetPageProps): ReactElement;
+//# sourceMappingURL=FactoryResetPage.d.ts.map