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

package/dist/jobs/ui/jobsTable.js

@@ -0,0 +1,321 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Admin → Operations → Jobs: the DataTable column contract (issue #266, epic #254;
+ * moved into `@marinoscar/platform-web/jobs` by #854 from the reference app's
+ * `pages/Admin/jobsTable.tsx`, columns unchanged).
+ *
+ * A sibling module rather than columns inlined in `JobsPage.tsx`, for the
+ * reason every table in this repo follows (`buildUserColumns` of `@marinoscar/platform-web/identity/ui`
+ * is the model): the column list is the table's PUBLIC shape — what a test, a
+ * CSV export and both renderers read — while the page is the state that feeds
+ * it. Keeping them apart lets a test assert the contract without mounting a
+ * page and mocking its fetch layer.
+ *
+ * =============================================================================
+ * WHAT `GET /api/admin/jobs` ACTUALLY HONOURS
+ * =============================================================================
+ *
+ * `sortable` and `filterable` are declared ONLY where the endpoint can serve
+ * them. Read off `jobListQuerySchema` (`@marinoscar/platform-contract/jobs`) and
+ * `job-admin.service.ts`'s `buildListWhere`:
+ *
+ *   | query param       | accepts                            | column here        |
+ *   | ----------------- | ---------------------------------- | ------------------ |
+ *   | `status`          | pending/running/succeeded/failed    | `status`, `is`     |
+ *   | `type`            | one machine type key                | `type`, `is`       |
+ *   | `scheduled`       | `'true'` (overrides `status`)       | `scheduled`, `is`  |
+ *   | `processedWithin` | 4h/24h/7d/30d/all                   | `processedWithin`  |
+ *   | `subjectType`     | one string                          | — (see below)      |
+ *   | `subjectId`       | one string                          | — (see below)      |
+ *   | `orgId`           | one organization id (#734)          | — (`useJobs` only) |
+ *   | `page`/`pageSize` | 1-based, pageSize max 100           | pagination         |
+ *
+ * NO COLUMN IS `sortable`, AND THAT IS NOT AN OVERSIGHT. The endpoint orders
+ * by `createdAt DESC` and offers no `sortBy` at all — `job-admin.service.ts`
+ * says why: a sortable column set needs an index per column to stay usable at
+ * the sizes a queue reaches. A sortable header the server cannot honour would
+ * either silently do nothing or 400, and both are worse than a table that is
+ * honestly newest-first. `createdAt` is therefore a plain column, and the page
+ * says "newest first" where the user can read it.
+ *
+ * NO QUICK SEARCH EITHER: there is no free-text parameter. `subjectType` and
+ * `subjectId` are exact-match, and an exact-match box that looks like a search
+ * field is the same lie in a different control, so they are left off this
+ * table entirely until something in the app can supply a subject to filter by.
+ *
+ * =============================================================================
+ * `scheduled` AND `processedWithin` ARE `filterOnly`
+ * =============================================================================
+ *
+ * Both are query parameters with no cell worth printing.
+ *
+ *   * `scheduled` is a predicate over TWO fields (`status = 'pending'` AND
+ *     `scheduledFor > now`), not a stored boolean, and the fact it selects is
+ *     already visible in the `scheduledFor` column of the rows it returns.
+ *   * `processedWithin` is a window over `COALESCE(finishedAt, createdAt)` —
+ *     a bound on the query, not a property of a row. Printing "24h" on every
+ *     row would say nothing.
+ *
+ * This is exactly the case `DataTableColumn.filterOnly` documents: a real
+ * endpoint's query parameters are not always a subset of its response's
+ * columns, and the alternatives are a bespoke control beside the table (which
+ * the shared filter bar exists to delete) or a decorative column whose cells
+ * repeat one word.
+ *
+ * `scheduled` offers ONE enum value, not two. `scheduled=false` is defined by
+ * the API to mean the same as omitting the parameter, so a "No" option would
+ * be a control that changes nothing — and removing the filter already
+ * expresses it.
+ */
+import { Chip, Stack, Tooltip, Typography } from '@mui/material';
+import { JOB_STATUSES } from '@marinoscar/platform-contract/jobs';
+import { formatDateTime, shortId } from '../headless/index.js';
+/**
+ * Persistence key for `user_settings.dataTables`. A constant, never derived
+ * from the route or the heading: it is a storage key and must survive a rename.
+ */
+export const TABLE_ID = 'admin-jobs';
+/** Column ids the page reads filters out of. Named so a typo cannot drift. */
+export const STATUS_COLUMN_ID = 'status';
+export const TYPE_COLUMN_ID = 'type';
+export const SCHEDULED_COLUMN_ID = 'scheduled';
+export const PROCESSED_WITHIN_COLUMN_ID = 'processedWithin';
+/** The single value the `scheduled` filter offers — see the module header. */
+export const SCHEDULED_FILTER_VALUE = 'true';
+const STATUS_ENUM_VALUES = [
+    { value: 'pending', label: 'Pending' },
+    { value: 'running', label: 'Running' },
+    { value: 'succeeded', label: 'Succeeded' },
+    { value: 'failed', label: 'Failed' },
+];
+/**
+ * `all` is deliberately absent: it is the API's default, and the page sends
+ * nothing when the filter is absent. An "All time" option would be a chip
+ * describing a constraint that is not applied.
+ */
+const PROCESSED_WITHIN_ENUM_VALUES = [
+    { value: '4h', label: 'Last 4 hours' },
+    { value: '24h', label: 'Last 24 hours' },
+    { value: '7d', label: 'Last 7 days' },
+    { value: '30d', label: 'Last 30 days' },
+];
+/** MUI `Chip` colours per status. `default` for pending — it is not a state to alarm anyone. */
+const STATUS_CHIP_COLOR = {
+    pending: 'default',
+    running: 'info',
+    succeeded: 'success',
+    failed: 'error',
+};
+// =============================================================================
+// Reading the filter model
+// =============================================================================
+/**
+ * Read a single-operand `is` filter out of the model as a plain STRING.
+ *
+ * Returning a scalar (not the filter object) is what lets a refetch effect
+ * depend on it directly — an effect keyed on the filter array would refetch
+ * forever, since the array is rebuilt on every change.
+ */
+export function readIsFilter(filters, columnId) {
+    const found = filters.find((filter) => filter.columnId === columnId && filter.operator === 'is');
+    return typeof found?.value === 'string' && found.value ? found.value : undefined;
+}
+/** Narrow a stored/URL-supplied filter value to a status the endpoint accepts. */
+export function asJobStatus(value) {
+    return JOB_STATUSES.find((candidate) => candidate === value);
+}
+/** Narrow a filter value to a `processedWithin` the endpoint accepts. */
+export function asProcessedWithin(value) {
+    return PROCESSED_WITHIN_ENUM_VALUES.map((entry) => entry.value).find((candidate) => candidate === value);
+}
+/**
+ * Keep `scheduled` and `status` mutually exclusive, favouring whichever the
+ * user just added.
+ *
+ * THE SERVER ALREADY RESOLVES THE CONTRADICTION — `scheduled=true` overrides
+ * `status` outright (`buildListWhere`) — so this is not about preventing a bad
+ * request. It is about not LYING in the filter bar: with both chips up, a user
+ * filtering "failed" and "in backoff" would read a chip saying
+ * `Status is Failed` above a table containing nothing but pending rows, and would
+ * reasonably conclude the table is broken. Only one of the two constraints was
+ * ever applied; only one of them may be displayed.
+ *
+ * The one that survives is the one just added, because that is the user's most
+ * recent statement of intent — silently discarding the new filter and keeping
+ * the old one is the version of this that feels like a broken control.
+ *
+ * A pure function over (next, previous) so the rule is asserted directly by a
+ * test rather than through a rendered filter menu.
+ */
+export function enforceExclusiveJobFilters(next, previous) {
+    const has = (model, columnId) => model.some((filter) => filter.columnId === columnId);
+    const nextHasScheduled = has(next, SCHEDULED_COLUMN_ID);
+    const nextHasStatus = has(next, STATUS_COLUMN_ID);
+    if (!nextHasScheduled || !nextHasStatus)
+        return next;
+    // Both present: drop whichever was ALREADY there before this change.
+    const scheduledIsNew = !has(previous, SCHEDULED_COLUMN_ID);
+    const dropColumnId = scheduledIsNew ? STATUS_COLUMN_ID : SCHEDULED_COLUMN_ID;
+    return next.filter((filter) => filter.columnId !== dropColumnId);
+}
+// =============================================================================
+// The columns
+// =============================================================================
+/**
+ * @param typeOptions - the job types this deployment actually has rows for,
+ * taken from `GET /stats`'s `byType` (machine `type` as the value, the API's
+ * own `label` as the label). Derived from the data rather than hardcoded: the
+ * handler registry is a server-side concern, and a hardcoded list here would
+ * offer filters for types that have never run and omit the ones that have.
+ */
+export function buildJobColumns(typeOptions) {
+    return [
+        {
+            /**
+             * The row-unique `primary` column, and therefore the row's ACCESSIBLE
+             * NAME: `rowAccessibleName()` takes the first visible `primary` column's
+             * scalar and names every row-action button and every card after it.
+             *
+             * The scalar carries the short id alongside the label FOR THAT REASON. A
+             * queue routinely holds dozens of rows of one type, so a scalar of
+             * `"Thumbnail"` alone would name a whole screen of buttons "Retry
+             * Thumbnail" with no way to tell which one. `hideable: false` for the
+             * same reason: hiding this column would rename every control on the page
+             * after whichever column happened to be `primary` next.
+             */
+            id: TYPE_COLUMN_ID,
+            label: 'Job',
+            priority: 'primary',
+            hideable: false,
+            filterable: ['is'], // ?type=<machine key>
+            filterType: 'enum',
+            enumValues: typeOptions,
+            minWidth: 220,
+            flex: 1.2,
+            value: (job) => `${job.typeLabel} (${shortId(job.id)})`,
+            render: (job) => (_jsxs(Stack, { sx: { minWidth: 0 }, children: [_jsx(Typography, { variant: "body2", noWrap: true, children: job.typeLabel }), _jsx(Typography, { variant: "caption", color: "text.secondary", noWrap: true, children: shortId(job.id) })] })),
+        },
+        {
+            id: STATUS_COLUMN_ID,
+            label: 'Status',
+            priority: 'primary',
+            filterable: ['is'], // ?status=
+            filterType: 'enum',
+            enumValues: STATUS_ENUM_VALUES,
+            width: 130,
+            value: (job) => job.status,
+            render: (job) => (_jsx(Chip, { label: job.status, size: "small", color: STATUS_CHIP_COLOR[job.status] })),
+        },
+        {
+            // See the module header: a query bound, not a row property.
+            id: SCHEDULED_COLUMN_ID,
+            label: 'Backoff',
+            priority: 'detail',
+            filterOnly: true,
+            filterable: ['is'], // ?scheduled=true
+            filterType: 'enum',
+            enumValues: [{ value: SCHEDULED_FILTER_VALUE, label: 'Waiting out a backoff' }],
+        },
+        {
+            id: PROCESSED_WITHIN_COLUMN_ID,
+            label: 'Last activity',
+            priority: 'detail',
+            filterOnly: true,
+            filterable: ['is'], // ?processedWithin=
+            filterType: 'enum',
+            enumValues: PROCESSED_WITHIN_ENUM_VALUES,
+        },
+        {
+            /**
+             * Attempts STARTED, charged at claim time — so a running job on its
+             * first attempt already reads `1`, and a pending one reads `0`. Rendered
+             * as the raw number the API sends rather than "0 of 3": the maximum is a
+             * per-handler setting this response does not carry, and inventing a
+             * denominator would be the UI stating a limit it cannot know.
+             */
+            id: 'attempts',
+            label: 'Attempts',
+            priority: 'secondary',
+            align: 'right',
+            width: 110,
+            value: (job) => job.attempts,
+        },
+        {
+            id: 'createdAt',
+            label: 'Created',
+            priority: 'secondary',
+            minWidth: 180,
+            value: (job) => formatDateTime(job.createdAt),
+        },
+        {
+            /**
+             * Only ever set on a `pending` row in backoff, which is precisely what
+             * the `scheduled` filter selects — so this column is where that filter's
+             * result becomes visible, and why the filter needs no cell of its own.
+             */
+            id: 'scheduledFor',
+            label: 'Runs after',
+            priority: 'secondary',
+            minWidth: 180,
+            value: (job) => formatDateTime(job.scheduledFor),
+        },
+        {
+            id: 'startedAt',
+            label: 'Started',
+            priority: 'detail',
+            minWidth: 180,
+            value: (job) => formatDateTime(job.startedAt),
+        },
+        {
+            id: 'finishedAt',
+            label: 'Finished',
+            priority: 'detail',
+            minWidth: 180,
+            value: (job) => formatDateTime(job.finishedAt),
+        },
+        {
+            /**
+             * `truncate`, because a stack trace tail runs to hundreds of characters
+             * and wrapping it would make one failed row taller than the rest of the
+             * page. The full text is in the tooltip and in the CSV.
+             */
+            id: 'lastError',
+            label: 'Last error',
+            priority: 'detail',
+            truncate: true,
+            minWidth: 240,
+            value: (job) => job.lastError ?? '',
+        },
+        {
+            /**
+             * The two subject fields as ONE column. They are meaningless apart — an
+             * id with no type does not say what it identifies — and the endpoint
+             * treats them as a pair too.
+             */
+            id: 'subject',
+            label: 'Subject',
+            priority: 'detail',
+            minWidth: 200,
+            value: (job) => job.subjectType && job.subjectId
+                ? `${job.subjectType}:${job.subjectId}`
+                : (job.subjectType ?? job.subjectId ?? ''),
+        },
+        {
+            id: 'executor',
+            label: 'Executor',
+            priority: 'detail',
+            minWidth: 160,
+            value: (job) => job.executor ?? '',
+            render: (job) => job.executor ? (_jsx(Tooltip, { title: job.leaseExpiresAt ? `Lease until ${formatDateTime(job.leaseExpiresAt)}` : '', children: _jsx(Typography, { variant: "body2", noWrap: true, children: job.executor }) })) : (_jsx(Typography, { variant: "body2", color: "text.secondary", children: "\u2014" })),
+        },
+        {
+            id: 'id',
+            label: 'ID',
+            priority: 'detail',
+            truncate: true,
+            minWidth: 200,
+            value: (job) => job.id,
+        },
+    ];
+}
+//# sourceMappingURL=jobsTable.js.map

package/dist/jobs/ui/jobsTable.js.map

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

package/dist/jobs/ui/settings.d.ts

@@ -0,0 +1,33 @@
+import type { PlatformSettingsPage } from '../../core/index.js';
+/**
+ * One jobs registry card: the `PlatformSettingsPage` card shape plus its
+ * icon, structurally a `SettingsCardDef` of the reference app. Never
+ * feature-gated, so it is assignable to any app's card type.
+ *
+ * @stability experimental
+ */
+export type JobsSettingsCard = PlatformSettingsPage<never>['card'] & {
+    /** The card and rail icon (an MUI SvgIcon). */
+    Icon: PlatformSettingsPage['Icon'];
+};
+/**
+ * The jobs admin cards, by the admin section they belong to:
+ *
+ * - `operations`: `Jobs` (`/admin/settings/jobs`, `jobs:read`), `Job Insights`
+ *   (`/admin/settings/jobs/insights`, `jobs:read`) and `Worker Nodes`
+ *   (`/admin/settings/workers`, `nodes:read`), in that order.
+ *
+ * @example
+ * ```tsx
+ * // apps/web/src/config/adminSections.tsx
+ * { label: 'Operations', cards: [...jobsAdminSections.operations, dbBackupCard, broadcastsCard] },
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare const jobsAdminSections: {
+    /** The Operations section's cards. */
+    readonly operations: readonly JobsSettingsCard[];
+};
+//# sourceMappingURL=settings.d.ts.map

package/dist/jobs/ui/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../src/jobs/ui/settings.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAShE;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG;IACnE,+CAA+C;IAC/C,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;CACpC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,EAAE;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAqBjD,CAAC"}

package/dist/jobs/ui/settings.js

@@ -0,0 +1,65 @@
+// The jobs slice's settings registry entries (issue #854). DATA, not a new
+// registry: the reference app keeps declaring every card in its own
+// `ADMIN_SECTIONS` (apps/web/src/config/adminSections.tsx) and spreads these
+// entries where its literal cards were, in the same order and position, so the
+// hub, the Console rail and the AppBar title resolver see exactly what they saw
+// before. No component is referenced here, so importing the cards never pulls a
+// page into the app's main chunk.
+//
+// Every `permission` is the exact string the packaged controller enforces
+// (`@marinoscar/platform-api/jobs` and `/nodes`):
+//   - `jobs:read`  -> jobs/job-admin.controller.ts (`PERMISSIONS.JOBS_READ`),
+//                     both Jobs cards: the list, the stats and the insights.
+//                     The writes need `jobs:write`, gated inside the pages.
+//   - `nodes:read` -> nodes/nodes-admin.controller.ts (`PERMISSIONS.NODES_READ`):
+//                     the fleet, the node detail and the credential list.
+//                     DELIBERATELY NOT `jobs:read`: the two are split, so a
+//                     Workers card on `jobs:read` would advertise a permission
+//                     that controller never checks. Deleting a node and
+//                     creating or revoking a credential need `nodes:write`,
+//                     gated inside the page.
+//
+// `Job Insights` nests UNDER the Jobs path; the app's `settingsPageTitle`
+// longest-prefix rule keeps the compact AppBar titling it "Job Insights".
+import QueryStatsIcon from '@mui/icons-material/QueryStats';
+import WorkHistoryOutlinedIcon from '@mui/icons-material/WorkHistoryOutlined';
+import { nodesAdminSections } from '../../nodes/index.js';
+import { JOB_INSIGHTS_PAGE_DESCRIPTION, JOB_INSIGHTS_PAGE_TITLE, JOBS_PAGE_DESCRIPTION, JOBS_PAGE_TITLE, } from './copy.js';
+/**
+ * The jobs admin cards, by the admin section they belong to:
+ *
+ * - `operations`: `Jobs` (`/admin/settings/jobs`, `jobs:read`), `Job Insights`
+ *   (`/admin/settings/jobs/insights`, `jobs:read`) and `Worker Nodes`
+ *   (`/admin/settings/workers`, `nodes:read`), in that order.
+ *
+ * @example
+ * ```tsx
+ * // apps/web/src/config/adminSections.tsx
+ * { label: 'Operations', cards: [...jobsAdminSections.operations, dbBackupCard, broadcastsCard] },
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export const jobsAdminSections = Object.freeze({
+    operations: Object.freeze([
+        {
+            title: JOBS_PAGE_TITLE,
+            description: JOBS_PAGE_DESCRIPTION,
+            Icon: WorkHistoryOutlinedIcon,
+            path: '/admin/settings/jobs',
+            permission: 'jobs:read',
+        },
+        {
+            title: JOB_INSIGHTS_PAGE_TITLE,
+            description: JOB_INSIGHTS_PAGE_DESCRIPTION,
+            Icon: QueryStatsIcon,
+            path: '/admin/settings/jobs/insights',
+            permission: 'jobs:read',
+        },
+        // The Worker Nodes card (`/admin/settings/workers`, `nodes:read`) is the
+        // nodes slice's (#881); it stays last so the order is unchanged.
+        ...nodesAdminSections.operations,
+    ]),
+});
+//# sourceMappingURL=settings.js.map

package/dist/jobs/ui/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../src/jobs/ui/settings.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,oEAAoE;AACpE,6EAA6E;AAC7E,+EAA+E;AAC/E,gFAAgF;AAChF,gFAAgF;AAChF,kCAAkC;AAClC,EAAE;AACF,0EAA0E;AAC1E,kDAAkD;AAClD,8EAA8E;AAC9E,6EAA6E;AAC7E,4EAA4E;AAC5E,kFAAkF;AAClF,0EAA0E;AAC1E,4EAA4E;AAC5E,+EAA+E;AAC/E,wEAAwE;AACxE,4EAA4E;AAC5E,6CAA6C;AAC7C,EAAE;AACF,0EAA0E;AAC1E,0EAA0E;AAE1E,OAAO,cAAc,MAAM,gCAAgC,CAAC;AAC5D,OAAO,uBAAuB,MAAM,yCAAyC,CAAC;AAG9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,GAChB,MAAM,WAAW,CAAC;AAcnB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAG1B,MAAM,CAAC,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;QACxB;YACE,KAAK,EAAE,eAAe;YACtB,WAAW,EAAE,qBAAqB;YAClC,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,sBAAsB;YAC5B,UAAU,EAAE,WAAW;SACxB;QACD;YACE,KAAK,EAAE,uBAAuB;YAC9B,WAAW,EAAE,6BAA6B;YAC1C,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,+BAA+B;YACrC,UAAU,EAAE,WAAW;SACxB;QACD,yEAAyE;QACzE,iEAAiE;QACjE,GAAG,kBAAkB,CAAC,UAAU;KACjC,CAAC;CACH,CAAC,CAAC"}

package/dist/jobs/ui/spinner.d.ts

@@ -0,0 +1,3 @@
+import type { ReactElement } from 'react';
+export declare function JobsSpinner(): ReactElement;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/jobs/ui/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../../src/jobs/ui/spinner.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAK1C,wBAAgB,WAAW,IAAI,YAAY,CAQ1C"}

package/dist/jobs/ui/spinner.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Box, CircularProgress } from '@mui/material';
+import { useJobsWebAdapters } from '../headless/index.js';
+export function JobsSpinner() {
+    const { Spinner } = useJobsWebAdapters();
+    if (Spinner)
+        return _jsx(Spinner, {});
+    return (_jsx(Box, { sx: { display: 'flex', justifyContent: 'center', alignItems: 'center', py: 4 }, children: _jsx(CircularProgress, { size: 40 }) }));
+}
+//# sourceMappingURL=spinner.js.map

package/dist/jobs/ui/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../../src/jobs/ui/spinner.tsx"],"names":[],"mappings":";AAKA,OAAO,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,UAAU,WAAW;IACzB,MAAM,EAAE,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACzC,IAAI,OAAO;QAAE,OAAO,KAAC,OAAO,KAAG,CAAC;IAChC,OAAO,CACL,KAAC,GAAG,IAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,EAAE,YACjF,KAAC,gBAAgB,IAAC,IAAI,EAAE,EAAE,GAAI,GAC1B,CACP,CAAC;AACJ,CAAC"}

package/dist/jobs/ui/table.d.ts

@@ -0,0 +1,5 @@
+import type { ReactElement } from 'react';
+import type { JobsDataTableProps } from '../headless/index.js';
+/** The app's table, or the fallback. */
+export declare function JobsTable<Row>(props: JobsDataTableProps<Row>): ReactElement | null;
+//# sourceMappingURL=table.d.ts.map

package/dist/jobs/ui/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../src/jobs/ui/table.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAqB1C,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,sBAAsB,CAAC;AAEnF,wCAAwC;AACxC,wBAAgB,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAAG,YAAY,GAAG,IAAI,CAIlF"}

package/dist/jobs/ui/table.js

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

package/dist/jobs/ui/table.js.map

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

package/dist/nodes/headless/adapters.d.ts

@@ -0,0 +1,76 @@
+import type { ComponentType, ReactElement, ReactNode } from 'react';
+import type { NodesApi } from './api.js';
+import type { NodesDataTableComponent } from './table.js';
+/**
+ * What {@link NodesWebAdapters.Spinner} takes.
+ *
+ * @stability experimental
+ */
+export interface NodesSpinnerProps {
+    /** A whole-page wait. The nodes page never asks for one. */
+    fullScreen?: boolean;
+}
+/**
+ * What the Worker Nodes page takes from the app. Every member is optional; keep the
+ * object a module constant.
+ *
+ * @example
+ * ```ts
+ * // apps/web/src/platform/nodesAdapters.ts
+ * export const appNodesAdapters: NodesWebAdapters = {
+ *   Spinner: LoadingSpinner,
+ *   DataTable,
+ *   api: createNodesApi(appPlatformApi),
+ * };
+ * ```
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export interface NodesWebAdapters {
+    /** The app's loading spinner. Default an MUI `CircularProgress`. */
+    Spinner?: ComponentType<NodesSpinnerProps>;
+    /** The app's table for the fleet and credential lists. Default a plain MUI table. */
+    DataTable?: NodesDataTableComponent;
+    /** The nodes calls. Default `createNodesApi(usePlatformApi())`. */
+    api?: NodesApi;
+}
+/**
+ * Hands the app's {@link NodesWebAdapters} to the Worker Nodes page below it. Mount
+ * it once, around the signed-in shell.
+ *
+ * @param props - `adapters`: the app's adapters (a module constant); `children`: the routed tree.
+ * @returns the provider element.
+ *
+ * @example
+ * ```tsx
+ * <NodesWebAdaptersProvider adapters={appNodesAdapters}>{shell}</NodesWebAdaptersProvider>
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function NodesWebAdaptersProvider(props: {
+    adapters: NodesWebAdapters;
+    children: ReactNode;
+}): ReactElement;
+/**
+ * The adapters in context (an empty object without a provider).
+ *
+ * @returns the app's nodes adapters.
+ *
+ * @stability experimental
+ */
+export declare function useNodesWebAdapters(): NodesWebAdapters;
+/**
+ * The nodes client the hooks use: `explicit` when given, else the adapters'
+ * `api`, else `createNodesApi` over the platform host's transport.
+ *
+ * @param explicit - a client to use instead (keep its identity stable).
+ * @returns the client.
+ * @throws Error when none of the three is available.
+ *
+ * @stability experimental
+ */
+export declare function useNodesApi(explicit?: NodesApi): NodesApi;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/nodes/headless/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../src/nodes/headless/adapters.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,OAAO,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC3C,qFAAqF;IACrF,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,mEAAmE;IACnE,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAOD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,gBAAgB,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,GAAG,YAAY,CAEjH;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAEtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAYzD"}