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

package/dist/nodes/headless/node-vitals.js

@@ -0,0 +1,129 @@
+// =============================================================================
+// App-defined node vitals: how the fleet page words a number a node reports
+// =============================================================================
+//
+// A node's heartbeat can carry `vitals.extra`, a bounded bag of `key -> number`
+// that an executor or the node's app fills (`@marinoscar/platform-contract/nodes`:
+// at most 16 keys, each a lower-case dotted identifier). The API stores it; this
+// registry tells the vitals dialog what each key MEANS: a label an operator can
+// read ("Transcode frames per second") and a unit, so `29.97` is not a bare
+// number. An UNREGISTERED key is still shown, by its key and as a plain number:
+// a node must never report something the page hides.
+//
+// Display only, like every vital: nothing here schedules on a self-reported
+// number, and a number is never turned into a verdict.
+//
+// A module-level registry in the headless entry (the same shape as
+// `registerFeatureNotice`): register at module scope, before the page renders.
+// =============================================================================
+import { NODE_VITALS_EXTRA_KEY_PATTERN } from '@marinoscar/platform-contract/nodes';
+import { formatBytes } from '../internal/format-bytes.js';
+import { formatDuration } from './format.js';
+const vitals = new Map();
+/**
+ * Registers (or, for an existing key, replaces) how an app-defined node vital
+ * reads in the vitals dialog. Call it at module scope, before the page renders.
+ *
+ * @param def - the key, its label and its unit.
+ * @throws Error when the key does not match `NODE_VITALS_EXTRA_KEY_PATTERN` or the label or unit is blank.
+ *
+ * @example
+ * ```ts
+ * registerNodeVital({ key: 'transcode.fps', label: 'Transcode frames per second', unit: 'frames/s' });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export function registerNodeVital(def) {
+    if (typeof def.key !== 'string' || !NODE_VITALS_EXTRA_KEY_PATTERN.test(def.key)) {
+        throw new Error(`registerNodeVital: "${String(def.key)}" is not a vital key (${NODE_VITALS_EXTRA_KEY_PATTERN}).`);
+    }
+    for (const field of ['label', 'unit']) {
+        if (typeof def[field] !== 'string' || def[field].trim() === '')
+            throw new Error(`registerNodeVital: ${field} is required`);
+    }
+    vitals.set(def.key, Object.freeze({ key: def.key, label: def.label, unit: def.unit }));
+}
+/**
+ * The registration for `key`, or `undefined`.
+ *
+ * @param key - a `vitals.extra` key.
+ * @returns the definition.
+ *
+ * @stability experimental
+ */
+export function nodeVitalFor(key) {
+    return vitals.get(key);
+}
+/**
+ * Every registered vital, in registration order.
+ *
+ * @returns the definitions.
+ *
+ * @stability experimental
+ */
+export function registeredNodeVitals() {
+    return [...vitals.values()];
+}
+function plain(value) {
+    return value.toLocaleString(undefined, { maximumFractionDigits: 2 });
+}
+/**
+ * One reported number in its registered unit: `87%`, `1.5 GB`, `29.97 frames/s`.
+ * Total: a non-finite value reads as an em dash, an unregistered key as the bare
+ * number.
+ *
+ * @param value - the reported number.
+ * @param def - the key's registration, if any.
+ * @returns the text to print.
+ *
+ * @stability experimental
+ */
+export function formatNodeVital(value, def) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return '—';
+    if (def === undefined)
+        return plain(value);
+    switch (def.unit) {
+        case 'count':
+            return Math.round(value).toLocaleString();
+        case 'percent':
+            return `${plain(value)}%`;
+        case 'bytes':
+            return formatBytes(value);
+        case 'milliseconds':
+            return formatDuration(value);
+        case 'seconds':
+            return formatDuration(value * 1000);
+        default:
+            return `${plain(value)} ${def.unit}`;
+    }
+}
+/**
+ * The `vitals.extra` of a snapshot as rows to print: registered keys first (in
+ * registration order), then the rest by key. At most 16, because the API refuses
+ * more; a snapshot read from an older row is bounded here as well, and only
+ * finite numbers survive.
+ *
+ * @param extra - the snapshot's `extra`, if any.
+ * @returns label and text per key; empty when there is nothing to show.
+ *
+ * @stability experimental
+ */
+export function nodeVitalRows(extra) {
+    if (extra === undefined || extra === null || typeof extra !== 'object')
+        return [];
+    const entries = Object.entries(extra).filter(([, value]) => typeof value === 'number' && Number.isFinite(value)).slice(0, 16);
+    const order = [...vitals.keys()];
+    const rank = (key) => {
+        const at = order.indexOf(key);
+        return at === -1 ? Number.MAX_SAFE_INTEGER : at;
+    };
+    entries.sort(([a], [b]) => rank(a) - rank(b) || (a < b ? -1 : a > b ? 1 : 0));
+    return entries.map(([key, value]) => {
+        const def = vitals.get(key);
+        return { key, label: def?.label ?? key, text: formatNodeVital(value, def) };
+    });
+}
+//# sourceMappingURL=node-vitals.js.map

package/dist/nodes/headless/node-vitals.js.map

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

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

@@ -0,0 +1,229 @@
+import type { ReactElement, ReactNode } from 'react';
+/**
+ * Where a column shows on a narrow screen: always (`primary`), on the card
+ * (`secondary`) or only in the detail view (`detail`).
+ *
+ * @stability experimental
+ */
+export type NodesTableColumnPriority = 'primary' | 'secondary' | 'detail';
+/**
+ * The filter operators the node lists use (`is` on an enum column).
+ *
+ * @stability experimental
+ */
+export type NodesTableFilterOperator = 'is';
+/**
+ * One choice of an enum filter.
+ *
+ * @stability experimental
+ */
+export interface NodesTableEnumValue {
+    /** The filter value. */
+    value: string;
+    /** What the filter shows. */
+    label: string;
+}
+/**
+ * One column of a node list.
+ *
+ * @typeParam Row - the row type.
+ * @stability experimental
+ */
+export interface NodesTableColumn<Row> {
+    /** Stable id (also the sort field for a sortable column). */
+    id: string;
+    /** Header text. */
+    label: string;
+    /** Cell content; defaults to `value`. */
+    render?: (row: Row) => ReactNode;
+    /** The plain value (search, export, the fallback cell). */
+    value?: (row: Row) => string | number | null;
+    /** Cell and header alignment; default left. */
+    align?: 'left' | 'center' | 'right';
+    /** Narrow-screen placement. */
+    priority: NodesTableColumnPriority;
+    /** The API can sort by it. */
+    sortable?: boolean;
+    /** The API can filter by it, with these operators. */
+    filterable?: boolean | NodesTableFilterOperator[];
+    /** The filter's input type. */
+    filterType?: 'enum';
+    /** The choices of an enum filter. */
+    enumValues?: NodesTableEnumValue[];
+    /**
+     * A query parameter with no cell: offered in the filter menu, never drawn
+     * as a column (the job list's backoff and activity-window filters).
+     */
+    filterOnly?: boolean;
+    /** Covered by the quick search. */
+    searchable?: boolean;
+    /** Included in a CSV export. */
+    exportable?: boolean;
+    /** The viewer may hide it. */
+    hideable?: boolean;
+    /** Truncate long values with an ellipsis. */
+    truncate?: boolean;
+    /** Fixed width in pixels. */
+    width?: number;
+    /** Minimum width in pixels. */
+    minWidth?: number;
+    /** Flex grow factor. */
+    flex?: number;
+}
+/**
+ * A per-row action (a menu item or an icon button).
+ *
+ * @typeParam Row - the row type.
+ * @stability experimental
+ */
+export interface NodesTableRowAction<Row> {
+    /** Stable id. */
+    id: string;
+    /** Text and accessible name. */
+    label: string;
+    /** Optional icon. */
+    icon?: ReactNode;
+    /** Runs the action. */
+    onClick: (row: Row) => void;
+    /** Disables it for a row. */
+    disabled?: (row: Row) => boolean;
+    /** Why it is disabled, for a tooltip. */
+    disabledReason?: (row: Row) => string | undefined;
+    /** Styled as destructive. */
+    destructive?: boolean;
+    /** Ask for confirmation first. */
+    confirm?: boolean | {
+        /** Dialog title. */
+        title?: string;
+        /** Dialog text. */
+        description?: string | ((row: Row) => string);
+        /** Confirm button text. */
+        confirmLabel?: string;
+        /** Cancel button text. */
+        cancelLabel?: string;
+    };
+}
+/**
+ * The current sort.
+ *
+ * @stability experimental
+ */
+export interface NodesTableSortState {
+    /** The sorted column's id. */
+    field: string;
+    /** The direction. */
+    direction: 'asc' | 'desc';
+}
+/**
+ * Every operator a table's filter model may hold (the node lists only
+ * read `is`). The same union as the reference app's `DataTable`, so its
+ * filter model is assignable here and back.
+ *
+ * @stability experimental
+ */
+export type NodesTableFilterModelOperator = 'equals' | 'contains' | 'startsWith' | 'endsWith' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'before' | 'after' | 'is' | 'isNot' | 'isAnyOf' | 'in' | 'isEmpty' | 'isNotEmpty' | (string & {});
+/**
+ * One active filter.
+ *
+ * @stability experimental
+ */
+export interface NodesTableFilter {
+    /** The filtered column's id. */
+    columnId: string;
+    /** The operator. */
+    operator: NodesTableFilterModelOperator;
+    /** The value. */
+    value: string | number | boolean | (string | number)[] | null;
+}
+/**
+ * The props a node list passes to the table.
+ *
+ * @typeParam Row - the row type.
+ * @stability experimental
+ */
+export interface NodesDataTableProps<Row> {
+    /** The columns, in order. */
+    columns: NodesTableColumn<Row>[];
+    /** This page's rows. */
+    rows: Row[];
+    /** A row's stable id. */
+    rowId: (row: Row) => string;
+    /** A request is in flight. */
+    loading?: boolean;
+    /** Shown when there are no rows. */
+    emptyState?: ReactNode;
+    /** Server-side paging. */
+    pagination?: {
+        /** The page, zero-based. */
+        page: number;
+        /** The page size. */
+        pageSize: number;
+        /** Rows across all pages. */
+        total: number;
+        /** Called with the next page and size. */
+        onPaginationChange: (next: {
+            page: number;
+            pageSize: number;
+        }) => void;
+        /** The page sizes offered. */
+        pageSizeOptions?: number[];
+    };
+    /** Server-side sorting. */
+    sort?: {
+        /** The current sort, or `null`. */
+        sort: NodesTableSortState | null;
+        /** Called with the next sort. */
+        onSortChange: (next: NodesTableSortState | null) => void;
+    };
+    /** Row selection. */
+    selection?: {
+        /** The selected row ids. */
+        selectedIds: Set<string>;
+        /** Called with the next selection. */
+        onSelectionChange: (next: Set<string>) => void;
+    };
+    /** The active filters. */
+    filters?: NodesTableFilter[];
+    /** Called with the next filters. */
+    onFiltersChange?: (next: NodesTableFilter[]) => void;
+    /** The quick search box. */
+    quickSearch?: {
+        /** The current text. */
+        value: string;
+        /** Called with the next text. */
+        onChange: (next: string) => void;
+        /** Placeholder text. */
+        placeholder?: string;
+        /** Accessible name. */
+        ariaLabel?: string;
+    };
+    /** Per-row actions. */
+    rowActions?: NodesTableRowAction<Row>[];
+    /** CSV export of every page. */
+    csvExport?: {
+        /** File name without extension. */
+        filename?: string;
+        /** Reads one page of every row for the export (zero-based page). */
+        fetchAllRows?: (params: {
+            page: number;
+            pageSize: number;
+            signal?: AbortSignal;
+        }) => Promise<Row[]>;
+    };
+    /** Persisted layout key (column visibility, density). */
+    tableId?: string;
+    /** Row density. */
+    density?: 'compact' | 'standard' | 'comfortable';
+    /** Accessible name of the table. */
+    ariaLabel?: string;
+    /** Test id. */
+    'data-testid'?: string;
+}
+/**
+ * The table component an app hands the nodes pages: any component
+ * accepting {@link NodesDataTableProps} for every row type.
+ *
+ * @stability experimental
+ */
+export type NodesDataTableComponent = <Row>(props: NodesDataTableProps<Row>) => ReactElement | null;
+//# sourceMappingURL=table.d.ts.map

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

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

package/dist/nodes/headless/table.js

@@ -0,0 +1,15 @@
+// The table the worker-node page renders its lists in (issue #881; same shape as
+// the jobs slice's, which cannot be imported: the slices stay independent).
+//
+// "Packages own behaviour, apps own appearance": the job list, the per-type
+// insights, the fleet and the credential list decide their columns, paging,
+// filters and row actions; the TABLE that draws them is the app's (the
+// reference app hands its responsive `DataTable` in through the nodes
+// adapters). These types are the subset of that table's props the nodes page
+// uses, written so an app's richer table component is assignable to
+// `NodesDataTableComponent` without a cast. Without an app table the pages fall
+// back to a plain MUI table. The identity slice's table types are the model;
+// these add `align` and `filterOnly` (the job list's `scheduled` and
+// `processedWithin` filters have no cell worth printing).
+export {};
+//# sourceMappingURL=table.js.map

package/dist/nodes/headless/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../../src/nodes/headless/table.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,4EAA4E;AAC5E,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,uEAAuE;AACvE,sEAAsE;AACtE,6EAA6E;AAC7E,oEAAoE;AACpE,gFAAgF;AAChF,6EAA6E;AAC7E,qEAAqE;AACrE,0DAA0D"}

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

@@ -0,0 +1,46 @@
+import type { z } from 'zod';
+import type { AdminNode, AdminNodeCredential, NodeCredentialCreated, NodeHealth, NodeJobCounts, NodeOwner, NodeStatus, NodeVitals, NodeVitalsCounters, createNodeCredentialSchema } from '@marinoscar/platform-contract/nodes';
+export { MAX_NODE_CREDENTIAL_DAYS, MAX_NODE_CREDENTIAL_NAME_LENGTH, NODE_HEALTHS, NODE_STATUSES, } from '@marinoscar/platform-contract/nodes';
+export type { NodeCredentialCreated, NodeHealth, NodeJobCounts, NodeOwner, NodeStatus, NodeVitals, NodeVitalsCounters, };
+/**
+ * One node as `GET /api/admin/nodes` returns it (`AdminNodeDto`,
+ * `adminNodeSchema`).
+ *
+ * @stability experimental
+ */
+export type WorkerNode = AdminNode;
+/**
+ * One credential as `GET /api/admin/nodes/credentials` returns it
+ * (`AdminNodeCredentialDto`, `adminNodeCredentialSchema`). No `token`, no hash;
+ * revoked credentials are included, carrying `revokedAt` (the audit trail).
+ *
+ * @stability experimental
+ */
+export type NodeCredential = AdminNodeCredential;
+/**
+ * The body `POST /api/node-credentials` accepts (`createNodeCredentialSchema`).
+ * Omitting `expiresInDays` is a real choice meaning "never expires".
+ *
+ * @stability experimental
+ */
+export type CreateNodeCredentialInput = z.input<typeof createNodeCredentialSchema>;
+/**
+ * A credential's live-ness: `active`, `expired` or `revoked`.
+ *
+ * @stability experimental
+ */
+export type NodeCredentialStatus = 'active' | 'expired' | 'revoked';
+/**
+ * Whether a credential can still authenticate a node right now.
+ *
+ * A MIRROR of `validateToken`'s two checks (`node-credential.service.ts`):
+ * revoked wins, then expiry, and a `null` expiry is not an expiry at all.
+ *
+ * @param credential - the row (its `expiresAt` and `revokedAt`).
+ * @param now - the instant to judge expiry against.
+ * @returns the credential's status.
+ *
+ * @stability experimental
+ */
+export declare function nodeCredentialStatus(credential: Pick<NodeCredential, 'expiresAt' | 'revokedAt'>, now?: Date): NodeCredentialStatus;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/nodes/headless/types.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,SAAS,EACT,mBAAmB,EACnB,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,0BAA0B,EAC3B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,YAAY,EACZ,aAAa,GACd,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,EACV,kBAAkB,GACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEnF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,WAAW,CAAC,EAC3D,GAAG,GAAE,IAAiB,GACrB,oBAAoB,CAStB"}

package/dist/nodes/headless/types.js

@@ -0,0 +1,46 @@
+// =============================================================================
+// The nodes slice's wire types, as the browser sees them (issue #881)
+// =============================================================================
+//
+// Every admin fleet shape is the OUTPUT type of a `@marinoscar/platform-contract/nodes`
+// schema (`admin-schemas.ts`) that the API's Swagger classes `implements`, so a
+// field the API adds or makes nullable reaches this slice as a compile error,
+// not as a silent `undefined`. (They were structural mirrors in the jobs slice
+// until #881.)
+//
+// `NodeCredential` HAS NO `token` FIELD, not even an optional one: the raw
+// token exists on the create response (`NodeCredentialCreated`) and nowhere
+// else, and a `token?: string` would let the first `credential.token ?? '-'`
+// compile while asking for a value the server can never produce. Its
+// `expiresAt` is `string | null`, and `null` means "never expires", a real
+// answer for an unattended worker.
+//
+// `WorkerNode.health` is SERVER-DERIVED (`deriveNodeHealth` compares the last
+// heartbeat against the `nodes.staleHeartbeatSeconds` system setting, which
+// the browser does not read), so nothing in this slice recomputes it.
+// =============================================================================
+export { MAX_NODE_CREDENTIAL_DAYS, MAX_NODE_CREDENTIAL_NAME_LENGTH, NODE_HEALTHS, NODE_STATUSES, } from '@marinoscar/platform-contract/nodes';
+/**
+ * Whether a credential can still authenticate a node right now.
+ *
+ * A MIRROR of `validateToken`'s two checks (`node-credential.service.ts`):
+ * revoked wins, then expiry, and a `null` expiry is not an expiry at all.
+ *
+ * @param credential - the row (its `expiresAt` and `revokedAt`).
+ * @param now - the instant to judge expiry against.
+ * @returns the credential's status.
+ *
+ * @stability experimental
+ */
+export function nodeCredentialStatus(credential, now = new Date()) {
+    if (credential.revokedAt)
+        return 'revoked';
+    // `null` is "never expires", so it must be checked BEFORE the comparison:
+    // `new Date(null)` is the epoch, which would read as expired in 1970 and
+    // mark every unattended worker credential dead.
+    if (credential.expiresAt && new Date(credential.expiresAt).getTime() <= now.getTime()) {
+        return 'expired';
+    }
+    return 'active';
+}
+//# sourceMappingURL=types.js.map

package/dist/nodes/headless/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/nodes/headless/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,sEAAsE;AACtE,gFAAgF;AAChF,EAAE;AACF,wFAAwF;AACxF,gFAAgF;AAChF,8EAA8E;AAC9E,+EAA+E;AAC/E,eAAe;AACf,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,6EAA6E;AAC7E,qEAAqE;AACrE,2EAA2E;AAC3E,mCAAmC;AACnC,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,sEAAsE;AACtE,gFAAgF;AAgBhF,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,YAAY,EACZ,aAAa,GACd,MAAM,qCAAqC,CAAC;AA2C7C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAA2D,EAC3D,MAAY,IAAI,IAAI,EAAE;IAEtB,IAAI,UAAU,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,0EAA0E;IAC1E,yEAAyE;IACzE,gDAAgD;IAChD,IAAI,UAAU,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QACtF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/nodes/headless/use-visible-polling.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `useVisiblePolling` — an interval that stops with the tab.
+ *
+ * Introduced by issue #266 for the jobs page and EXTRACTED here by #271, when
+ * the worker-fleet page needed the same behaviour. Extracted rather than
+ * copied, and the distinction is the whole point of this file existing: two
+ * implementations of "poll, but not in a background tab" would be two places
+ * the `visibilitychange` teardown could be got subtly wrong, and the second
+ * one would be discovered the way the first would have been — by a dashboard
+ * left open overnight, months later, in somebody's database load graph.
+ *
+ * Copied into `@marinoscar/platform-web/nodes` by #881 (the jobs slice keeps its
+ * own; slices stay independent). The Worker Nodes page takes this one from the
+ * headless entry, so a page test that mocks that entry still intercepts the
+ * poll.
+ *
+ * =============================================================================
+ * WHY THE INTERVAL STOPS WITH THE TAB
+ * =============================================================================
+ *
+ * These pages poll because their contents change with nobody touching them: a
+ * queue drains, a worker stops heartbeating. An operator watching either needs
+ * the numbers to move, and a manual refresh button turns "is it recovering"
+ * into a clicking exercise.
+ *
+ * A bare `setInterval` keeps firing in a background tab, and that is not a
+ * micro-optimisation to skip. A dashboard left open on a second monitor
+ * overnight is ~2,900 requests at a 10-second poll — each one a real query
+ * against the same database the workers are competing for — and every response
+ * is discarded, because nobody is looking. Browsers throttle background timers
+ * but do not stop them, and the throttling is neither uniform nor something a
+ * server capacity plan can rely on.
+ *
+ * So the interval is torn down on `visibilitychange` to hidden and rebuilt on
+ * the way back, with ONE IMMEDIATE FETCH on return. The immediate fetch is the
+ * half that makes the pause invisible to the operator: without it, a tab
+ * restored after an hour would show hour-old numbers for up to a full interval,
+ * which is worse than not pausing at all — stale data that looks live.
+ */
+/**
+ * Call `callback` every `intervalMs` — but only while the document is visible.
+ *
+ * `callback` is held in a ref rather than being an effect dependency: a page
+ * naturally passes a fresh closure on every render (it reads the current
+ * filters), and depending on it directly would tear down and rebuild the
+ * interval on every keystroke, so the timer would never actually reach its
+ * period. The ref is updated on each render, so a tick always calls the
+ * LATEST closure while the timer itself survives.
+ *
+ * `intervalMs <= 0` disables polling entirely, which is what a test — or a
+ * caller with no reason to poll — passes.
+ *
+ * @param callback - what each tick runs (the latest closure is always used).
+ * @param intervalMs - the period; `0` or less disables polling.
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function useVisiblePolling(callback: () => void, intervalMs: number): void;
+//# sourceMappingURL=use-visible-polling.d.ts.map

package/dist/nodes/headless/use-visible-polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-visible-polling.d.ts","sourceRoot":"","sources":["../../../src/nodes/headless/use-visible-polling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CA4ChF"}

package/dist/nodes/headless/use-visible-polling.js

@@ -0,0 +1,101 @@
+/**
+ * `useVisiblePolling` — an interval that stops with the tab.
+ *
+ * Introduced by issue #266 for the jobs page and EXTRACTED here by #271, when
+ * the worker-fleet page needed the same behaviour. Extracted rather than
+ * copied, and the distinction is the whole point of this file existing: two
+ * implementations of "poll, but not in a background tab" would be two places
+ * the `visibilitychange` teardown could be got subtly wrong, and the second
+ * one would be discovered the way the first would have been — by a dashboard
+ * left open overnight, months later, in somebody's database load graph.
+ *
+ * Copied into `@marinoscar/platform-web/nodes` by #881 (the jobs slice keeps its
+ * own; slices stay independent). The Worker Nodes page takes this one from the
+ * headless entry, so a page test that mocks that entry still intercepts the
+ * poll.
+ *
+ * =============================================================================
+ * WHY THE INTERVAL STOPS WITH THE TAB
+ * =============================================================================
+ *
+ * These pages poll because their contents change with nobody touching them: a
+ * queue drains, a worker stops heartbeating. An operator watching either needs
+ * the numbers to move, and a manual refresh button turns "is it recovering"
+ * into a clicking exercise.
+ *
+ * A bare `setInterval` keeps firing in a background tab, and that is not a
+ * micro-optimisation to skip. A dashboard left open on a second monitor
+ * overnight is ~2,900 requests at a 10-second poll — each one a real query
+ * against the same database the workers are competing for — and every response
+ * is discarded, because nobody is looking. Browsers throttle background timers
+ * but do not stop them, and the throttling is neither uniform nor something a
+ * server capacity plan can rely on.
+ *
+ * So the interval is torn down on `visibilitychange` to hidden and rebuilt on
+ * the way back, with ONE IMMEDIATE FETCH on return. The immediate fetch is the
+ * half that makes the pause invisible to the operator: without it, a tab
+ * restored after an hour would show hour-old numbers for up to a full interval,
+ * which is worse than not pausing at all — stale data that looks live.
+ */
+import { useEffect, useRef } from 'react';
+/**
+ * Call `callback` every `intervalMs` — but only while the document is visible.
+ *
+ * `callback` is held in a ref rather than being an effect dependency: a page
+ * naturally passes a fresh closure on every render (it reads the current
+ * filters), and depending on it directly would tear down and rebuild the
+ * interval on every keystroke, so the timer would never actually reach its
+ * period. The ref is updated on each render, so a tick always calls the
+ * LATEST closure while the timer itself survives.
+ *
+ * `intervalMs <= 0` disables polling entirely, which is what a test — or a
+ * caller with no reason to poll — passes.
+ *
+ * @param callback - what each tick runs (the latest closure is always used).
+ * @param intervalMs - the period; `0` or less disables polling.
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export function useVisiblePolling(callback, intervalMs) {
+    const callbackRef = useRef(callback);
+    callbackRef.current = callback;
+    useEffect(() => {
+        if (intervalMs <= 0)
+            return;
+        let timer = null;
+        const stop = () => {
+            if (timer !== null) {
+                clearInterval(timer);
+                timer = null;
+            }
+        };
+        const start = () => {
+            // Guarded rather than assumed: `visibilitychange` can fire more than
+            // once for the same effective state, and an unguarded `setInterval`
+            // would leak a second timer and double the request rate.
+            if (timer !== null)
+                return;
+            timer = setInterval(() => callbackRef.current(), intervalMs);
+        };
+        const onVisibilityChange = () => {
+            if (document.hidden) {
+                stop();
+                return;
+            }
+            // Catch up FIRST, then resume — see the file header on why a resumed
+            // poll that waits out a full interval is worse than never pausing.
+            callbackRef.current();
+            start();
+        };
+        // A tab that is already hidden at mount never starts one.
+        if (!document.hidden)
+            start();
+        document.addEventListener('visibilitychange', onVisibilityChange);
+        return () => {
+            stop();
+            document.removeEventListener('visibilitychange', onVisibilityChange);
+        };
+    }, [intervalMs]);
+}
+//# sourceMappingURL=use-visible-polling.js.map