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

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

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

package/dist/host/headless/contract.js

@@ -0,0 +1,12 @@
+// =============================================================================
+// The host slice's wire shapes (issues #258, #401; packaged by #891)
+// =============================================================================
+//
+// The web mirror of `GET`/`PUT /api/admin/maintenance`
+// (`platform-api/src/host/maintenance/dto/update-maintenance.dto.ts`) and of
+// `GET /api/admin/about` (`platform-api/src/host/about/dto/about-response.dto.ts`).
+// Mirrored rather than imported because the API's DTOs are Nest classes; a
+// contract slice for them is a follow-up.
+// =============================================================================
+export {};
+//# sourceMappingURL=contract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../src/host/headless/contract.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,qEAAqE;AACrE,gFAAgF;AAChF,EAAE;AACF,uDAAuD;AACvD,6EAA6E;AAC7E,oFAAoF;AACpF,2EAA2E;AAC3E,0CAA0C;AAC1C,gFAAgF"}

package/dist/host/headless/host-client.d.ts

@@ -0,0 +1,31 @@
+import type { PlatformApiClient } from '../../core/index.js';
+import type { AboutResponse, MaintenanceStatus, UpdateMaintenanceInput } from './contract.js';
+/**
+ * The host slice's calls.
+ *
+ * @stability experimental
+ */
+export interface HostApi {
+    /** The effective maintenance state, plus each contributing layer. */
+    getMaintenanceStatus(): Promise<MaintenanceStatus>;
+    /** Open or close a window. See {@link UpdateMaintenanceInput} for what is not settable. */
+    updateMaintenance(input: UpdateMaintenanceInput): Promise<MaintenanceStatus>;
+    /** What is deployed here: API version, deploy document, database liveness. */
+    getAbout(): Promise<AboutResponse>;
+}
+/**
+ * The host slice's calls over the platform host's transport.
+ *
+ * @param api - the app's transport (`usePlatformApi()`).
+ * @returns the {@link HostApi}.
+ *
+ * @example
+ * ```ts
+ * const hostApi = createHostApi(usePlatformApi());
+ * const about = await hostApi.getAbout();
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function createHostApi(api: PlatformApiClient): HostApi;
+//# sourceMappingURL=host-client.d.ts.map

package/dist/host/headless/host-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-client.d.ts","sourceRoot":"","sources":["../../../src/host/headless/host-client.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE9F;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,qEAAqE;IACrE,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnD,2FAA2F;IAC3F,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC7E,8EAA8E;IAC9E,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAM7D"}

package/dist/host/headless/host-client.js

@@ -0,0 +1,42 @@
+// =============================================================================
+// The host slice's API calls (issues #258, #401; packaged by #891)
+// =============================================================================
+//
+// Three routes over the platform host's transport, so a call inherits the
+// app's token refresh, its 401 retry and its maintenance interception like
+// every other call in the app:
+//
+//   - `GET /admin/maintenance`: the effective state plus every layer;
+//   - `PUT /admin/maintenance`: open or close a window;
+//   - `GET /admin/about`: what is deployed here.
+//
+// ⚠ `getAbout` NEVER REJECTS FOR A MISSING OR BROKEN DEPLOY DOCUMENT. The API
+// answers 200 for every authorized caller: `deployInfoStatus` carries `absent`
+// or `invalid`, and a database that did not answer arrives as `database: null`
+// with a `databaseError` string. A rejection means the request itself failed (a
+// 401, a 403, a network error or a maintenance window) and nothing else. The
+// API reads the document from disk on every request, so a rewritten document
+// needs no restart and this call always reports the current file.
+// =============================================================================
+/**
+ * The host slice's calls over the platform host's transport.
+ *
+ * @param api - the app's transport (`usePlatformApi()`).
+ * @returns the {@link HostApi}.
+ *
+ * @example
+ * ```ts
+ * const hostApi = createHostApi(usePlatformApi());
+ * const about = await hostApi.getAbout();
+ * ```
+ *
+ * @stability experimental
+ */
+export function createHostApi(api) {
+    return {
+        getMaintenanceStatus: () => api.get('/admin/maintenance'),
+        updateMaintenance: (input) => api.put('/admin/maintenance', input),
+        getAbout: () => api.get('/admin/about'),
+    };
+}
+//# sourceMappingURL=host-client.js.map

package/dist/host/headless/host-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-client.js","sourceRoot":"","sources":["../../../src/host/headless/host-client.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,mEAAmE;AACnE,gFAAgF;AAChF,EAAE;AACF,0EAA0E;AAC1E,2EAA2E;AAC3E,+BAA+B;AAC/B,EAAE;AACF,sEAAsE;AACtE,wDAAwD;AACxD,iDAAiD;AACjD,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,6EAA6E;AAC7E,kEAAkE;AAClE,gFAAgF;AAmBhF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,GAAsB;IAClD,OAAO;QACL,oBAAoB,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAoB,oBAAoB,CAAC;QAC5E,iBAAiB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAoB,oBAAoB,EAAE,KAAK,CAAC;QACrF,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAgB,cAAc,CAAC;KACvD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,12 @@
+export { MAINTENANCE_ADMIN_PATH, MAINTENANCE_ERROR_MARKER, MAINTENANCE_FALLBACK_MESSAGE, MAINTENANCE_RETRY_AFTER_SECONDS, clearMaintenanceBlock, getMaintenanceBlock, isDecidingLayer, readMaintenanceBlock, reportMaintenanceBlock, subscribeToMaintenanceBlock, } from './maintenance-block.js';
+/** @stability experimental */
+export type { MaintenanceBlock } from './maintenance-block.js';
+export { createHostApi } from './host-client.js';
+export type { HostApi } from './host-client.js';
+export { MAINTENANCE_POLL_INTERVAL_MS, useMaintenance, useMaintenanceBlock } from './use-maintenance.js';
+export type { UseMaintenanceBlockReturn, UseMaintenanceOptions, UseMaintenanceReturn } from './use-maintenance.js';
+export { useAbout } from './use-about.js';
+export type { UseAboutReturn } from './use-about.js';
+/** @stability experimental */
+export type { AboutApi, AboutApp, AboutDatabase, AboutDeployedBy, AboutExtra, AboutHistoryEntry, AboutHost, AboutProxy, AboutRemote, AboutResponse, AboutRun, AboutRuntime, DeployCommand, DeployInfoStatus, MaintenanceOverride, MaintenancePolicy, MaintenanceSource, MaintenanceStatus, UpdateMaintenanceInput, } from './contract.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/headless/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,EAC5B,+BAA+B,EAC/B,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAChC,8BAA8B;AAC9B,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,4BAA4B,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACzG,YAAY,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACnH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,8BAA8B;AAC9B,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,eAAe,CAAC"}

package/dist/host/headless/index.js

@@ -0,0 +1,8 @@
+// `@marinoscar/platform-web/host/headless`: the host slice's wire shapes, API
+// calls, maintenance-block store and hooks, with no component (issue #891).
+// Documented in ../README.md.
+export { MAINTENANCE_ADMIN_PATH, MAINTENANCE_ERROR_MARKER, MAINTENANCE_FALLBACK_MESSAGE, MAINTENANCE_RETRY_AFTER_SECONDS, clearMaintenanceBlock, getMaintenanceBlock, isDecidingLayer, readMaintenanceBlock, reportMaintenanceBlock, subscribeToMaintenanceBlock, } from './maintenance-block.js';
+export { createHostApi } from './host-client.js';
+export { MAINTENANCE_POLL_INTERVAL_MS, useMaintenance, useMaintenanceBlock } from './use-maintenance.js';
+export { useAbout } from './use-about.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/host/headless/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4EAA4E;AAC5E,8BAA8B;AAE9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,EAC5B,+BAA+B,EAC/B,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,4BAA4B,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEzG,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/host/headless/maintenance-block.d.ts

@@ -0,0 +1,205 @@
+/**
+ * The client half of the maintenance wire contract — issue #258, epic #254.
+ *
+ * =============================================================================
+ * WHAT THIS FILE IS FOR
+ * =============================================================================
+ *
+ * A `503` is also what a crashed API, an exhausted connection pool, an upstream
+ * that failed to boot, and a reverse proxy with no healthy backend all produce.
+ * The whole point of #257's marker is that a client can tell a DELIBERATE
+ * maintenance window apart from a broken deployment — and therefore dares to
+ * show the operator's message and a retry, instead of showing that message the
+ * next time the API simply falls over.
+ *
+ * So this file holds exactly two things:
+ *
+ *   1. THE MIRRORED CONSTANTS AND THE RECOGNISER. `MAINTENANCE_ERROR_MARKER`
+ *      is the same string `packages/platform-api/src/host/maintenance/maintenance.guard.ts`
+ *      exports, and `readMaintenanceBlock` is the ONE place in the web app that
+ *      decides whether a failed response is a maintenance window. Changing
+ *      either is a wire-contract change on both sides.
+ *
+ *   2. A TINY MODULE-LEVEL STORE for the block, so the app's HTTP client (its `onErrorResponse` hook) can report
+ *      one from inside a `fetch` handler — a plain async function with no React
+ *      in scope — and the app's maintenance gate can render it.
+ *
+ * =============================================================================
+ * WHY THE STORE LIVES HERE AND NOT IN A REACT CONTEXT
+ * =============================================================================
+ *
+ * Because the producer is not a component. The interception happens centrally
+ * in the app's HTTP client (`onErrorResponse`) precisely so that every
+ * existing call site inherits it with no change; that method is called from
+ * hooks, from event handlers, and from module-scope helpers, and none of those
+ * can reach a context value. A context would force each of ~30 call sites to
+ * hand the error to a provider — which is the per-call-site change this design
+ * exists to avoid.
+ *
+ * `useSyncExternalStore` (`use-maintenance.ts`) is the supported bridge
+ * back into React, so subscribers still re-render correctly, including under
+ * concurrent rendering.
+ *
+ * =============================================================================
+ * WHERE THE REST CALLS ARE
+ * =============================================================================
+ *
+ * The two `/admin/maintenance` REST calls are NOT here: they are in
+ * `host-client.ts` (`createHostApi`), over the platform host's transport. This
+ * module imports nothing from the transport, so the app's HTTP client can
+ * import the recogniser without a cycle.
+ */
+import type { MaintenanceStatus } from './contract.js';
+/**
+ * The stable marker on a maintenance `503`'s body, at `details.reason`.
+ *
+ * MIRRORED FROM `MAINTENANCE_ERROR_MARKER` in
+ * `packages/platform-api/src/host/maintenance/maintenance.guard.ts`. It lives under
+ * `details` rather than at the top level because the API's exception filter
+ * rebuilds every error body from a fixed key allowlist and would silently strip
+ * a custom top-level field — so `details.reason` is not a stylistic choice on
+ * either side, and reading it from anywhere else would never match.
+ *
+ * @stability experimental
+ */
+export declare const MAINTENANCE_ERROR_MARKER = "MAINTENANCE_MODE";
+/**
+ * The `Retry-After` the API promises, in seconds. Mirrors
+ * `MAINTENANCE_RETRY_AFTER_SECONDS`.
+ *
+ * Used only as the FALLBACK when a response somehow carries the marker without
+ * `details.retryAfterSeconds`. The number on the wire wins whenever it is
+ * there, so a future server that lengthens the delay is honoured by a client
+ * built before the change.
+ *
+ * @stability experimental
+ */
+export declare const MAINTENANCE_RETRY_AFTER_SECONDS = 30;
+/**
+ * The admin page that closes a window (`ui/maintenance-page.tsx`).
+ *
+ * THE CLIENT MIRROR OF `@AllowDuringMaintenance()`. On the API, the maintenance
+ * controller is exempt from its own guard for the obvious reason — the switch
+ * that ends a window has to be reachable while the window is open. The same
+ * reasoning applies to the screen in front of it: `MaintenanceGate` lets this
+ * one route through, so an administrator blocked by an `allowAdmins: false`
+ * window is not also locked out of the page that would undo it.
+ *
+ * The literal is repeated in `config/adminSections.tsx` and `App.tsx` (both of
+ * which spell every route out, and the second of which is parsed as TEXT by
+ * `__tests__/config/destinations.test.ts`), so
+ * `test/host/maintenance-block.test.ts` asserts this constant equals the
+ * card's declared path rather than leaving the three to drift.
+ *
+ * @stability experimental
+ */
+export declare const MAINTENANCE_ADMIN_PATH = "/admin/settings/maintenance";
+/**
+ * What a blocked caller learned from the 503 — the whole of what the
+ * maintenance screen has to work with.
+ *
+ * @stability experimental
+ */
+export interface MaintenanceBlock {
+    /** The operator's own copy. Rendered verbatim; it is the only thing that explains the window. */
+    message: string;
+    /** How long the API asked us to wait. */
+    retryAfterSeconds: number;
+    /**
+     * Whether an admin bearer would have been let through.
+     *
+     * Told to the blocked caller by the API on purpose: it is the difference
+     * between "come back later" and "sign in as an administrator and carry on",
+     * and the maintenance screen says something different in each case.
+     */
+    allowAdmins: boolean;
+}
+/**
+ * The default shown when a window is open but the operator supplied no copy.
+ *
+ * The API's own schema requires a non-empty message and seeds one, so this
+ * should be unreachable against a healthy deployment. It exists because the
+ * alternative — rendering a maintenance screen with an empty body — is the one
+ * outcome that would leave a user with no information at all.
+ *
+ * @stability experimental
+ */
+export declare const MAINTENANCE_FALLBACK_MESSAGE = "The application is temporarily unavailable for scheduled maintenance.";
+/**
+ * Decide whether a failed response is a maintenance window, and extract what
+ * the screen needs.
+ *
+ * THE TWO CONDITIONS ARE BOTH REQUIRED, and that conjunction is the feature:
+ *
+ *   * `status === 503` — a marker on any other status is not a window.
+ *   * `details.reason === MAINTENANCE_ERROR_MARKER` — a 503 WITHOUT it is an
+ *     ordinary upstream failure and keeps its existing behaviour exactly, all
+ *     the way down to the `ApiError` its call site already catches.
+ *
+ * Returns `null` for everything else, which is what the caller in `api.ts`
+ * branches on. Nothing here throws: it runs on the error path of every failed
+ * request in the application, and an exception raised while classifying an
+ * error would replace a useful failure with a useless one.
+ *
+ * @stability experimental
+ */
+export declare function readMaintenanceBlock(status: number, body: unknown): MaintenanceBlock | null;
+/**
+ * The current block, or `null`.
+ *
+ * IDENTITY IS STABLE between changes — `useSyncExternalStore` calls this on
+ * every render and compares with `Object.is`, so returning a freshly built
+ * object here would loop forever. The stored reference is handed back as-is and
+ * only replaced when the block actually changes.
+ *
+ * @stability experimental
+ */
+export declare function getMaintenanceBlock(): MaintenanceBlock | null;
+/**
+ * Subscribe to block changes. Returns the unsubscribe function.
+ *
+ * @stability experimental
+ */
+export declare function subscribeToMaintenanceBlock(listener: () => void): () => void;
+/**
+ * Record that the API answered with a maintenance 503. Called from exactly one
+ * place — the app's HTTP client — and not meant for pages.
+ *
+ * A REPEAT REPORT WITH THE SAME CONTENT IS A NO-OP. Every in-flight request of
+ * a blocked page reports independently (a settings page, the notification bell
+ * and the rail's preferences fetch will all fail together), and re-emitting per
+ * failure would re-render the maintenance screen once per request for nothing.
+ *
+ * @stability experimental
+ */
+export declare function reportMaintenanceBlock(block: MaintenanceBlock): void;
+/**
+ * Drop the block, so the gate renders the application again.
+ *
+ * DELIBERATELY NOT AUTOMATIC ON A SUCCESSFUL RESPONSE. Several routes stay
+ * reachable during a window by design (`/api/auth/me`, `/api/auth/refresh`, the
+ * maintenance endpoints themselves), so "some request succeeded" does not mean
+ * the window closed — clearing on it would drop the screen, let the next
+ * blocked call raise it again, and leave the user watching the application
+ * flicker in and out of service.
+ *
+ * The two callers that DO know something changed are the retry button on the
+ * maintenance screen and a save that turned the window off
+ * (`hooks/useMaintenance.ts`).
+ *
+ * @stability experimental
+ */
+export declare function clearMaintenanceBlock(): void;
+/**
+ * Whether a `MaintenanceStatus` names `layer` as the one deciding `enabled`.
+ *
+ * A one-line helper rather than `status.source === layer` written out three
+ * times in the admin page's layer list: the "which layer wins" badge is the
+ * single thing an operator debugging "why is it still on" is looking for, and
+ * it is worth having exactly one expression of it — including one place for a
+ * test to pin.
+ *
+ * @stability experimental
+ */
+export declare function isDecidingLayer(status: MaintenanceStatus, layer: MaintenanceStatus['source']): boolean;
+//# sourceMappingURL=maintenance-block.d.ts.map

package/dist/host/headless/maintenance-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance-block.d.ts","sourceRoot":"","sources":["../../../src/host/headless/maintenance-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,sBAAsB,gCAAgC,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iGAAiG;IACjG,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;;;;OAMG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAeD;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,0EACgC,CAAC;AAE1E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,GACZ,gBAAgB,GAAG,IAAI,CA6BzB;AAaD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAK5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAWpE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GACjC,OAAO,CAET"}

package/dist/host/headless/maintenance-block.js

@@ -0,0 +1,243 @@
+/**
+ * The client half of the maintenance wire contract — issue #258, epic #254.
+ *
+ * =============================================================================
+ * WHAT THIS FILE IS FOR
+ * =============================================================================
+ *
+ * A `503` is also what a crashed API, an exhausted connection pool, an upstream
+ * that failed to boot, and a reverse proxy with no healthy backend all produce.
+ * The whole point of #257's marker is that a client can tell a DELIBERATE
+ * maintenance window apart from a broken deployment — and therefore dares to
+ * show the operator's message and a retry, instead of showing that message the
+ * next time the API simply falls over.
+ *
+ * So this file holds exactly two things:
+ *
+ *   1. THE MIRRORED CONSTANTS AND THE RECOGNISER. `MAINTENANCE_ERROR_MARKER`
+ *      is the same string `packages/platform-api/src/host/maintenance/maintenance.guard.ts`
+ *      exports, and `readMaintenanceBlock` is the ONE place in the web app that
+ *      decides whether a failed response is a maintenance window. Changing
+ *      either is a wire-contract change on both sides.
+ *
+ *   2. A TINY MODULE-LEVEL STORE for the block, so the app's HTTP client (its `onErrorResponse` hook) can report
+ *      one from inside a `fetch` handler — a plain async function with no React
+ *      in scope — and the app's maintenance gate can render it.
+ *
+ * =============================================================================
+ * WHY THE STORE LIVES HERE AND NOT IN A REACT CONTEXT
+ * =============================================================================
+ *
+ * Because the producer is not a component. The interception happens centrally
+ * in the app's HTTP client (`onErrorResponse`) precisely so that every
+ * existing call site inherits it with no change; that method is called from
+ * hooks, from event handlers, and from module-scope helpers, and none of those
+ * can reach a context value. A context would force each of ~30 call sites to
+ * hand the error to a provider — which is the per-call-site change this design
+ * exists to avoid.
+ *
+ * `useSyncExternalStore` (`use-maintenance.ts`) is the supported bridge
+ * back into React, so subscribers still re-render correctly, including under
+ * concurrent rendering.
+ *
+ * =============================================================================
+ * WHERE THE REST CALLS ARE
+ * =============================================================================
+ *
+ * The two `/admin/maintenance` REST calls are NOT here: they are in
+ * `host-client.ts` (`createHostApi`), over the platform host's transport. This
+ * module imports nothing from the transport, so the app's HTTP client can
+ * import the recogniser without a cycle.
+ */
+/**
+ * The stable marker on a maintenance `503`'s body, at `details.reason`.
+ *
+ * MIRRORED FROM `MAINTENANCE_ERROR_MARKER` in
+ * `packages/platform-api/src/host/maintenance/maintenance.guard.ts`. It lives under
+ * `details` rather than at the top level because the API's exception filter
+ * rebuilds every error body from a fixed key allowlist and would silently strip
+ * a custom top-level field — so `details.reason` is not a stylistic choice on
+ * either side, and reading it from anywhere else would never match.
+ *
+ * @stability experimental
+ */
+export const MAINTENANCE_ERROR_MARKER = 'MAINTENANCE_MODE';
+/**
+ * The `Retry-After` the API promises, in seconds. Mirrors
+ * `MAINTENANCE_RETRY_AFTER_SECONDS`.
+ *
+ * Used only as the FALLBACK when a response somehow carries the marker without
+ * `details.retryAfterSeconds`. The number on the wire wins whenever it is
+ * there, so a future server that lengthens the delay is honoured by a client
+ * built before the change.
+ *
+ * @stability experimental
+ */
+export const MAINTENANCE_RETRY_AFTER_SECONDS = 30;
+/**
+ * The admin page that closes a window (`ui/maintenance-page.tsx`).
+ *
+ * THE CLIENT MIRROR OF `@AllowDuringMaintenance()`. On the API, the maintenance
+ * controller is exempt from its own guard for the obvious reason — the switch
+ * that ends a window has to be reachable while the window is open. The same
+ * reasoning applies to the screen in front of it: `MaintenanceGate` lets this
+ * one route through, so an administrator blocked by an `allowAdmins: false`
+ * window is not also locked out of the page that would undo it.
+ *
+ * The literal is repeated in `config/adminSections.tsx` and `App.tsx` (both of
+ * which spell every route out, and the second of which is parsed as TEXT by
+ * `__tests__/config/destinations.test.ts`), so
+ * `test/host/maintenance-block.test.ts` asserts this constant equals the
+ * card's declared path rather than leaving the three to drift.
+ *
+ * @stability experimental
+ */
+export const MAINTENANCE_ADMIN_PATH = '/admin/settings/maintenance';
+/**
+ * The default shown when a window is open but the operator supplied no copy.
+ *
+ * The API's own schema requires a non-empty message and seeds one, so this
+ * should be unreachable against a healthy deployment. It exists because the
+ * alternative — rendering a maintenance screen with an empty body — is the one
+ * outcome that would leave a user with no information at all.
+ *
+ * @stability experimental
+ */
+export const MAINTENANCE_FALLBACK_MESSAGE = 'The application is temporarily unavailable for scheduled maintenance.';
+/**
+ * Decide whether a failed response is a maintenance window, and extract what
+ * the screen needs.
+ *
+ * THE TWO CONDITIONS ARE BOTH REQUIRED, and that conjunction is the feature:
+ *
+ *   * `status === 503` — a marker on any other status is not a window.
+ *   * `details.reason === MAINTENANCE_ERROR_MARKER` — a 503 WITHOUT it is an
+ *     ordinary upstream failure and keeps its existing behaviour exactly, all
+ *     the way down to the `ApiError` its call site already catches.
+ *
+ * Returns `null` for everything else, which is what the caller in `api.ts`
+ * branches on. Nothing here throws: it runs on the error path of every failed
+ * request in the application, and an exception raised while classifying an
+ * error would replace a useful failure with a useless one.
+ *
+ * @stability experimental
+ */
+export function readMaintenanceBlock(status, body) {
+    if (status !== 503)
+        return null;
+    if (typeof body !== 'object' || body === null)
+        return null;
+    const details = body.details;
+    if (typeof details !== 'object' || details === null)
+        return null;
+    const { reason, retryAfterSeconds, allowAdmins } = details;
+    if (reason !== MAINTENANCE_ERROR_MARKER)
+        return null;
+    const message = body.message;
+    return {
+        message: typeof message === 'string' && message.trim()
+            ? message
+            : MAINTENANCE_FALLBACK_MESSAGE,
+        // `Number.isFinite` and not a truthiness check: a server that sent `0`
+        // means "retry immediately", which is a real answer, whereas `undefined`
+        // and `null` are not.
+        retryAfterSeconds: typeof retryAfterSeconds === 'number' && Number.isFinite(retryAfterSeconds)
+            ? retryAfterSeconds
+            : MAINTENANCE_RETRY_AFTER_SECONDS,
+        // Defaults to `false`, the more restrictive reading. A client that assumed
+        // `true` from a missing field would tell a user to sign in as an
+        // administrator on a window that locks administrators out too.
+        allowAdmins: allowAdmins === true,
+    };
+}
+// -----------------------------------------------------------------------------
+// The block store
+// -----------------------------------------------------------------------------
+let currentBlock = null;
+const listeners = new Set();
+function emit() {
+    for (const listener of listeners)
+        listener();
+}
+/**
+ * The current block, or `null`.
+ *
+ * IDENTITY IS STABLE between changes — `useSyncExternalStore` calls this on
+ * every render and compares with `Object.is`, so returning a freshly built
+ * object here would loop forever. The stored reference is handed back as-is and
+ * only replaced when the block actually changes.
+ *
+ * @stability experimental
+ */
+export function getMaintenanceBlock() {
+    return currentBlock;
+}
+/**
+ * Subscribe to block changes. Returns the unsubscribe function.
+ *
+ * @stability experimental
+ */
+export function subscribeToMaintenanceBlock(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+/**
+ * Record that the API answered with a maintenance 503. Called from exactly one
+ * place — the app's HTTP client — and not meant for pages.
+ *
+ * A REPEAT REPORT WITH THE SAME CONTENT IS A NO-OP. Every in-flight request of
+ * a blocked page reports independently (a settings page, the notification bell
+ * and the rail's preferences fetch will all fail together), and re-emitting per
+ * failure would re-render the maintenance screen once per request for nothing.
+ *
+ * @stability experimental
+ */
+export function reportMaintenanceBlock(block) {
+    if (currentBlock &&
+        currentBlock.message === block.message &&
+        currentBlock.retryAfterSeconds === block.retryAfterSeconds &&
+        currentBlock.allowAdmins === block.allowAdmins) {
+        return;
+    }
+    currentBlock = block;
+    emit();
+}
+/**
+ * Drop the block, so the gate renders the application again.
+ *
+ * DELIBERATELY NOT AUTOMATIC ON A SUCCESSFUL RESPONSE. Several routes stay
+ * reachable during a window by design (`/api/auth/me`, `/api/auth/refresh`, the
+ * maintenance endpoints themselves), so "some request succeeded" does not mean
+ * the window closed — clearing on it would drop the screen, let the next
+ * blocked call raise it again, and leave the user watching the application
+ * flicker in and out of service.
+ *
+ * The two callers that DO know something changed are the retry button on the
+ * maintenance screen and a save that turned the window off
+ * (`hooks/useMaintenance.ts`).
+ *
+ * @stability experimental
+ */
+export function clearMaintenanceBlock() {
+    if (currentBlock === null)
+        return;
+    currentBlock = null;
+    emit();
+}
+/**
+ * Whether a `MaintenanceStatus` names `layer` as the one deciding `enabled`.
+ *
+ * A one-line helper rather than `status.source === layer` written out three
+ * times in the admin page's layer list: the "which layer wins" badge is the
+ * single thing an operator debugging "why is it still on" is looking for, and
+ * it is worth having exactly one expression of it — including one place for a
+ * test to pin.
+ *
+ * @stability experimental
+ */
+export function isDecidingLayer(status, layer) {
+    return status.source === layer;
+}
+//# sourceMappingURL=maintenance-block.js.map

package/dist/host/headless/maintenance-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance-block.js","sourceRoot":"","sources":["../../../src/host/headless/maintenance-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAIH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AAoCpE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,4BAA4B,GACvC,uEAAuE,CAAC;AAE1E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,IAAa;IAEb,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAE3D,MAAM,OAAO,GAAI,IAA2B,CAAC,OAAO,CAAC;IACrD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEjE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,GAAG,OAAkC,CAAC;IACtF,IAAI,MAAM,KAAK,wBAAwB;QAAE,OAAO,IAAI,CAAC;IAErD,MAAM,OAAO,GAAI,IAA2B,CAAC,OAAO,CAAC;IAErD,OAAO;QACL,OAAO,EACL,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE;YAC3C,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,4BAA4B;QAClC,uEAAuE;QACvE,yEAAyE;QACzE,sBAAsB;QACtB,iBAAiB,EACf,OAAO,iBAAiB,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YACzE,CAAC,CAAC,iBAAiB;YACnB,CAAC,CAAC,+BAA+B;QACrC,2EAA2E;QAC3E,iEAAiE;QACjE,+DAA+D;QAC/D,WAAW,EAAE,WAAW,KAAK,IAAI;KAClC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,IAAI,YAAY,GAA4B,IAAI,CAAC;AACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;AAExC,SAAS,IAAI;IACX,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,QAAoB;IAC9D,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAuB;IAC5D,IACE,YAAY;QACZ,YAAY,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;QACtC,YAAY,CAAC,iBAAiB,KAAK,KAAK,CAAC,iBAAiB;QAC1D,YAAY,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,EAC9C,CAAC;QACD,OAAO;IACT,CAAC;IACD,YAAY,GAAG,KAAK,CAAC;IACrB,IAAI,EAAE,CAAC;AACT,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,YAAY,KAAK,IAAI;QAAE,OAAO;IAClC,YAAY,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,CAAC;AACT,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAyB,EACzB,KAAkC;IAElC,OAAO,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC;AACjC,CAAC"}