@prenta/admin 2.6.1 → 2.8.0

package/dist/views/Jobs/focus.js

@@ -0,0 +1,64 @@
+'use client';
+import { useRef } from 'react';
+/** The id of a row's open button, for returning focus to the row. */
+export function jobOpenButtonId(id) {
+    return `job-open-${id}`;
+}
+/** Focus was dropped: on the body, or on an element that's left the page. */
+export function focusLost() {
+    const current = document.activeElement;
+    return !current || current === document.body || !current.isConnected;
+}
+/**
+ * Focus somewhere stable on the Jobs screen: the first row's open button, or
+ * the selected filter tab when the current filter has no rows.
+ */
+export function focusJobsFallback() {
+    const target = document.querySelector('[data-job-open]') ??
+        document.querySelector('[data-jobs-filters] [role="tab"][aria-selected="true"]');
+    target?.focus();
+}
+/** Focus a row's open button; when that row has left the list, the fallback above. */
+export function focusJobRow(id) {
+    const button = document.getElementById(jobOpenButtonId(id));
+    if (button)
+        button.focus();
+    else
+        focusJobsFallback();
+}
+/**
+ * Focus the open drawer's tab panel, where the job's new state shows, when a
+ * footer action's button went away (a cancel, a retry). The row is behind the
+ * drawer, which keeps focus inside itself.
+ */
+export function focusJobDrawer() {
+    const drawer = document.querySelector('[data-job-drawer]');
+    const target = drawer?.querySelector('[role="tabpanel"]') ?? drawer;
+    target?.focus();
+}
+/**
+ * Focus return for the Jobs dialogs. Radix's modal Dialog only returns focus
+ * to a `Dialog.Trigger`, and these open from several controls, so the control
+ * that had focus is remembered on open and focused again on close. When it's
+ * gone (a cancel removes the Cancel button) or was never focused (Safari
+ * doesn't focus a clicked button), `fallback` places focus instead.
+ */
+export function useReturnFocus(fallback) {
+    const opener = useRef(null);
+    return {
+        onOpenAutoFocus: () => {
+            const current = document.activeElement;
+            opener.current = current instanceof HTMLElement && current !== document.body ? current : null;
+        },
+        onCloseAutoFocus: (event) => {
+            event.preventDefault();
+            const back = opener.current;
+            opener.current = null;
+            if (back?.isConnected)
+                back.focus();
+            else
+                fallback();
+        },
+    };
+}
+//# sourceMappingURL=focus.js.map

package/dist/views/Jobs/focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.js","sourceRoot":"","sources":["../../../src/views/Jobs/focus.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAE9B,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,YAAY,EAAE,EAAE,CAAA;AACzB,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAA;IACtC,OAAO,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,CAAA;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GACV,QAAQ,CAAC,aAAa,CAAc,iBAAiB,CAAC;QACtD,QAAQ,CAAC,aAAa,CAAc,wDAAwD,CAAC,CAAA;IAC/F,MAAM,EAAE,KAAK,EAAE,CAAA;AACjB,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAA;IAC3D,IAAI,MAAM;QAAE,MAAM,CAAC,KAAK,EAAE,CAAA;;QACrB,iBAAiB,EAAE,CAAA;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAc,mBAAmB,CAAC,CAAA;IACvE,MAAM,MAAM,GAAG,MAAM,EAAE,aAAa,CAAc,mBAAmB,CAAC,IAAI,MAAM,CAAA;IAChF,MAAM,EAAE,KAAK,EAAE,CAAA;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,QAAoB;IACjD,MAAM,MAAM,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAA;IAC/C,OAAO;QACL,eAAe,EAAE,GAAG,EAAE;YACpB,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAA;YACtC,MAAM,CAAC,OAAO,GAAG,OAAO,YAAY,WAAW,IAAI,OAAO,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;QAC/F,CAAC;QACD,gBAAgB,EAAE,CAAC,KAAY,EAAE,EAAE;YACjC,KAAK,CAAC,cAAc,EAAE,CAAA;YACtB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAA;YAC3B,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;YACrB,IAAI,IAAI,EAAE,WAAW;gBAAE,IAAI,CAAC,KAAK,EAAE,CAAA;;gBAC9B,QAAQ,EAAE,CAAA;QACjB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/views/Jobs/icons.d.ts

@@ -0,0 +1,22 @@
+interface IconProps {
+    size?: number;
+}
+export declare const JobIcons: {
+    search: ({ size }: IconProps) => import("react/jsx-runtime").JSX.Element;
+    pulse: ({ size }: IconProps) => import("react/jsx-runtime").JSX.Element;
+    spark: ({ size }: IconProps) => import("react/jsx-runtime").JSX.Element;
+    retry: ({ size }: IconProps) => import("react/jsx-runtime").JSX.Element;
+    play: ({ size }: IconProps) => import("react/jsx-runtime").JSX.Element;
+    stop: ({ size }: IconProps) => import("react/jsx-runtime").JSX.Element;
+    alert: ({ size }: IconProps) => import("react/jsx-runtime").JSX.Element;
+    clock: ({ size }: IconProps) => import("react/jsx-runtime").JSX.Element;
+    chev: ({ size }: IconProps) => import("react/jsx-runtime").JSX.Element;
+    /** The approve menu's opener: `chev` turned down. */
+    chevDown: ({ size }: IconProps) => import("react/jsx-runtime").JSX.Element;
+    x: ({ size }: IconProps) => import("react/jsx-runtime").JSX.Element;
+    check: ({ size }: IconProps) => import("react/jsx-runtime").JSX.Element;
+    edit: ({ size }: IconProps) => import("react/jsx-runtime").JSX.Element;
+    list: ({ size }: IconProps) => import("react/jsx-runtime").JSX.Element;
+};
+export {};
+//# sourceMappingURL=icons.d.ts.map

package/dist/views/Jobs/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../../src/views/Jobs/icons.tsx"],"names":[],"mappings":"AAsBA,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,QAAQ;uBACA,SAAS;sBAMV,SAAS;sBAKT,SAAS;sBAMT,SAAS;qBAMV,SAAS;qBAKT,SAAS;sBAKR,SAAS;sBAOT,SAAS;qBAMV,SAAS;IAK1B,qDAAqD;yBAChC,SAAS;kBAKhB,SAAS;sBAML,SAAS;qBAKV,SAAS;qBAMT,SAAS;CAS3B,CAAA"}

package/dist/views/Jobs/icons.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** The kit's Jobs icon set (jobs-data.jsx `Ic`): 24px grid, 1.8 stroke, decorative. */
+function Icon({ size = 14, children }) {
+    return (_jsx("svg", { width: size, height: size, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", className: "shrink-0", children: children }));
+}
+export const JobIcons = {
+    search: ({ size }) => (_jsxs(Icon, { size: size, children: [_jsx("circle", { cx: "11", cy: "11", r: "7" }), _jsx("line", { x1: "21", y1: "21", x2: "16.5", y2: "16.5" })] })),
+    pulse: ({ size }) => (_jsx(Icon, { size: size, children: _jsx("polyline", { points: "22 12 18 12 15 21 9 3 6 12 2 12" }) })),
+    spark: ({ size }) => (_jsxs(Icon, { size: size, children: [_jsx("path", { d: "M12 3l1.9 5.1L19 10l-5.1 1.9L12 17l-1.9-5.1L5 10l5.1-1.9z" }), _jsx("path", { d: "M19 15l.8 2.2L22 18l-2.2.8L19 21l-.8-2.2L16 18l2.2-.8z" })] })),
+    retry: ({ size }) => (_jsxs(Icon, { size: size, children: [_jsx("polyline", { points: "1 4 1 10 7 10" }), _jsx("path", { d: "M3.5 15a9 9 0 1 0 2.1-9.4L1 10" })] })),
+    play: ({ size }) => (_jsx(Icon, { size: size, children: _jsx("polygon", { points: "6 4 20 12 6 20 6 4" }) })),
+    stop: ({ size }) => (_jsx(Icon, { size: size, children: _jsx("rect", { x: "5", y: "5", width: "14", height: "14", rx: "2" }) })),
+    alert: ({ size }) => (_jsxs(Icon, { size: size, children: [_jsx("circle", { cx: "12", cy: "12", r: "9" }), _jsx("line", { x1: "12", y1: "8", x2: "12", y2: "12.5" }), _jsx("line", { x1: "12", y1: "16", x2: "12", y2: "16" })] })),
+    clock: ({ size }) => (_jsxs(Icon, { size: size, children: [_jsx("circle", { cx: "12", cy: "12", r: "9" }), _jsx("polyline", { points: "12 7 12 12 15 14" })] })),
+    chev: ({ size }) => (_jsx(Icon, { size: size, children: _jsx("polyline", { points: "9 18 15 12 9 6" }) })),
+    /** The approve menu's opener: `chev` turned down. */
+    chevDown: ({ size }) => (_jsx(Icon, { size: size, children: _jsx("polyline", { points: "6 9 12 15 18 9" }) })),
+    x: ({ size }) => (_jsxs(Icon, { size: size, children: [_jsx("line", { x1: "18", y1: "6", x2: "6", y2: "18" }), _jsx("line", { x1: "6", y1: "6", x2: "18", y2: "18" })] })),
+    check: ({ size }) => (_jsx(Icon, { size: size, children: _jsx("polyline", { points: "20 6 9 17 4 12" }) })),
+    edit: ({ size }) => (_jsxs(Icon, { size: size, children: [_jsx("path", { d: "M12 20h9" }), _jsx("path", { d: "M16.5 3.5a2.1 2.1 0 0 1 3 3L7 19l-4 1 1-4z" })] })),
+    list: ({ size }) => (_jsxs(Icon, { size: size, children: [_jsx("path", { d: "m3 17 2 2 4-4" }), _jsx("path", { d: "m3 7 2 2 4-4" }), _jsx("path", { d: "M13 6h8" }), _jsx("path", { d: "M13 12h8" }), _jsx("path", { d: "M13 18h8" })] })),
+};
+//# sourceMappingURL=icons.js.map

package/dist/views/Jobs/icons.js.map

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

package/dist/views/Jobs/useJobDetail.d.ts

@@ -0,0 +1,21 @@
+import type { Job, JobEvent } from '@prenta/core';
+export interface JobDetailState {
+    /** `GET /jobs/:id`, once it has answered. */
+    detail: Job | null;
+    /** Why the last read failed. */
+    error: string | null;
+}
+/**
+ * The job as `GET /jobs/:id` sends it: the scan `results`, and for someone who
+ * could retry or cancel it, the full error with its stack.
+ */
+export declare function useJobDetail(id: string, version: string): JobDetailState;
+export interface JobEventsState {
+    events: JobEvent[];
+    status: 'loading' | 'ready' | 'error';
+    /** Why the last read failed. With `ready`, the last events are still shown. */
+    error: string | null;
+}
+/** `GET /jobs/:id/events` while the Activity tab is open. */
+export declare function useJobEvents(id: string, version: string, enabled: boolean): JobEventsState;
+//# sourceMappingURL=useJobDetail.d.ts.map

package/dist/views/Jobs/useJobDetail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useJobDetail.d.ts","sourceRoot":"","sources":["../../../src/views/Jobs/useJobDetail.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAUjD,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,MAAM,EAAE,GAAG,GAAG,IAAI,CAAA;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAaxE;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;IACrC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAgB1F"}

package/dist/views/Jobs/useJobDetail.js

@@ -0,0 +1,39 @@
+'use client';
+import { useEffect, useState } from 'react';
+import { getJob, listJobEvents } from '../../lib/jobs-service.js';
+/**
+ * The job as `GET /jobs/:id` sends it: the scan `results`, and for someone who
+ * could retry or cancel it, the full error with its stack.
+ */
+export function useJobDetail(id, version) {
+    const [state, setState] = useState({ detail: null, error: null });
+    useEffect(() => {
+        const controller = new AbortController();
+        void getJob(id, controller.signal).then((res) => {
+            if (controller.signal.aborted)
+                return;
+            setState((prev) => res.ok ? { detail: res.value, error: null } : { detail: prev.detail, error: res.error });
+        });
+        return () => controller.abort();
+    }, [id, version]);
+    return state;
+}
+/** `GET /jobs/:id/events` while the Activity tab is open. */
+export function useJobEvents(id, version, enabled) {
+    const [state, setState] = useState({ events: [], status: 'loading', error: null });
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const controller = new AbortController();
+        void listJobEvents(id, controller.signal).then((res) => {
+            if (controller.signal.aborted)
+                return;
+            setState((prev) => res.ok
+                ? { events: res.value, status: 'ready', error: null }
+                : { ...prev, status: prev.status === 'ready' ? 'ready' : 'error', error: res.error });
+        });
+        return () => controller.abort();
+    }, [id, version, enabled]);
+    return state;
+}
+//# sourceMappingURL=useJobDetail.js.map

package/dist/views/Jobs/useJobDetail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useJobDetail.js","sourceRoot":"","sources":["../../../src/views/Jobs/useJobDetail.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE3C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAgBjE;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,OAAe;IACtD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAiB,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACjF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,KAAK,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YAC9C,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAM;YACrC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAChB,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CACxF,CAAA;QACH,CAAC,CAAC,CAAA;QACF,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;IACjC,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;IACjB,OAAO,KAAK,CAAA;AACd,CAAC;AASD,6DAA6D;AAC7D,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,OAAe,EAAE,OAAgB;IACxE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAiB,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAClG,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,KAAK,aAAa,CAAC,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YACrD,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAM;YACrC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAChB,GAAG,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE;gBACrD,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CACvF,CAAA;QACH,CAAC,CAAC,CAAA;QACF,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;IACjC,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;IAC1B,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/views/Jobs/useJobsFeed.d.ts

@@ -0,0 +1,35 @@
+import type { Job, JobWorkerStatus } from '@prenta/core';
+interface FeedState {
+    jobs: Job[];
+    worker: JobWorkerStatus | null;
+    /** When `jobs` was fetched, on the server's clock. Relative times are measured from it. */
+    fetchedAt: number;
+    /** The server's clock minus the browser's, when they differ by more than 2s. */
+    skewMs: number;
+    /** `error` only until the first list arrives; after that a failed refresh keeps the rows. */
+    status: 'loading' | 'ready' | 'error';
+    /** Why the last list refresh failed, or null when it worked. */
+    error: string | null;
+    /** Why the last worker status request failed. The strip shows it; the list doesn't. */
+    workerError: string | null;
+}
+export interface JobsFeed extends FeedState {
+    reload: () => Promise<void>;
+    /** Show a job the server just returned (from run, retry or cancel) before the next refresh. */
+    upsert: (job: Job) => void;
+}
+/** `document.visibilityState`, as state. */
+export declare function usePageVisible(): boolean;
+/** `Date.now()`, updated every `intervalMs` while `running`; frozen otherwise. */
+export declare function useNow(running: boolean, intervalMs?: number): number;
+/**
+ * The newest 50 jobs and the worker status, loaded on mount and refreshed
+ * every 5 seconds while `polling` is true. Coming back from paused or hidden
+ * refreshes at once. Failed refreshes back off (10s, 20s, 40s, then every
+ * minute, or longer when a 429 says so) and a success returns to 5 seconds.
+ * A request times out after 10 seconds, and a response older than one
+ * already shown is dropped.
+ */
+export declare function useJobsFeed(polling: boolean): JobsFeed;
+export {};
+//# sourceMappingURL=useJobsFeed.d.ts.map

package/dist/views/Jobs/useJobsFeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useJobsFeed.d.ts","sourceRoot":"","sources":["../../../src/views/Jobs/useJobsFeed.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAuBxD,UAAU,SAAS;IACjB,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,MAAM,EAAE,eAAe,GAAG,IAAI,CAAA;IAC9B,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAA;IACjB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAA;IACd,6FAA6F;IAC7F,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;IACrC,gEAAgE;IAChE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,uFAAuF;IACvF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,WAAW,QAAS,SAAQ,SAAS;IACzC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,+FAA+F;IAC/F,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAA;CAC3B;AAED,4CAA4C;AAC5C,wBAAgB,cAAc,IAAI,OAAO,CAUxC;AAED,kFAAkF;AAClF,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,SAAO,GAAG,MAAM,CASlE;AAWD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CA+JtD"}

package/dist/views/Jobs/useJobsFeed.js

@@ -0,0 +1,231 @@
+'use client';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { JOBS_LIST_LIMIT, getJobWorker, listJobs } from '../../lib/jobs-service.js';
+/** The list refreshes every 5 seconds while Live is on and the tab is visible (JOBS.md). */
+const POLL_MS = 5000;
+/** The longest a failing refresh waits before trying again. */
+const MAX_BACKOFF_MS = 60_000;
+/** The longest a `Retry-After` is honoured, so a bad header can't stop the list for good. */
+const MAX_RETRY_AFTER_MS = 5 * 60_000;
+/** A refresh with no answer by then is abandoned and counts as a failure. */
+const REQUEST_TIMEOUT_MS = 10_000;
+/**
+ * The worker status changes once a minute, when a tick ends, so it isn't
+ * fetched with every list refresh: once a few seconds after the tick it
+ * expects, again every 30s while that tick is late, and at least once a
+ * minute. All admin requests share one 100-a-minute budget per IP.
+ */
+const WORKER_MAX_AGE_MS = 60_000;
+const WORKER_AFTER_TICK_MS = 5_000;
+const WORKER_LATE_RETRY_MS = 30_000;
+/** The `Date` header has whole seconds; smaller clock differences are noise. */
+const SKEW_THRESHOLD_MS = 2_000;
+/** `document.visibilityState`, as state. */
+export function usePageVisible() {
+    const [visible, setVisible] = useState(() => typeof document === 'undefined' || document.visibilityState !== 'hidden');
+    useEffect(() => {
+        const onChange = () => setVisible(document.visibilityState !== 'hidden');
+        document.addEventListener('visibilitychange', onChange);
+        return () => document.removeEventListener('visibilitychange', onChange);
+    }, []);
+    return visible;
+}
+/** `Date.now()`, updated every `intervalMs` while `running`; frozen otherwise. */
+export function useNow(running, intervalMs = 1000) {
+    const [now, setNow] = useState(() => Date.now());
+    useEffect(() => {
+        if (!running)
+            return;
+        setNow(Date.now());
+        const timer = window.setInterval(() => setNow(Date.now()), intervalMs);
+        return () => window.clearInterval(timer);
+    }, [running, intervalMs]);
+    return now;
+}
+/** The wait before the next refresh, after `failures` failed ones in a row. */
+function nextDelay(failures, retryAfterMs) {
+    if (failures === 0)
+        return POLL_MS;
+    const backoff = Math.min(POLL_MS * 2 ** failures, MAX_BACKOFF_MS);
+    return retryAfterMs === null
+        ? backoff
+        : Math.max(backoff, Math.min(retryAfterMs, MAX_RETRY_AFTER_MS));
+}
+/**
+ * The newest 50 jobs and the worker status, loaded on mount and refreshed
+ * every 5 seconds while `polling` is true. Coming back from paused or hidden
+ * refreshes at once. Failed refreshes back off (10s, 20s, 40s, then every
+ * minute, or longer when a 429 says so) and a success returns to 5 seconds.
+ * A request times out after 10 seconds, and a response older than one
+ * already shown is dropped.
+ */
+export function useJobsFeed(polling) {
+    const [state, setState] = useState(() => ({
+        jobs: [],
+        worker: null,
+        fetchedAt: Date.now(),
+        skewMs: 0,
+        status: 'loading',
+        error: null,
+        workerError: null,
+    }));
+    const mounted = useRef(false);
+    const issued = useRef(0);
+    /** Responses to requests issued before this id are stale. */
+    const oldestFresh = useRef(0);
+    const inFlight = useRef(0);
+    const controllers = useRef(new Set());
+    const timer = useRef(null);
+    const pollingRef = useRef(polling);
+    const failures = useRef(0);
+    const skew = useRef(0);
+    const worker = useRef(null);
+    /** When the worker status was last asked for, on the browser's clock. */
+    const workerAskedAt = useRef(null);
+    useEffect(() => {
+        mounted.current = true;
+        const pending = controllers.current;
+        return () => {
+            mounted.current = false;
+            for (const controller of pending)
+                controller.abort();
+            // An aborted request never delivered the worker status; a remount asks again.
+            workerAskedAt.current = null;
+            if (timer.current !== null)
+                window.clearTimeout(timer.current);
+            timer.current = null;
+        };
+    }, []);
+    const workerDue = useCallback((now) => {
+        const asked = workerAskedAt.current;
+        if (asked === null || now - asked >= WORKER_MAX_AGE_MS)
+            return true;
+        const nextTick = worker.current?.nextTickAt;
+        if (!nextTick)
+            return false;
+        const after = Date.parse(nextTick) - skew.current + WORKER_AFTER_TICK_MS;
+        return now >= after && (asked < after || now - asked >= WORKER_LATE_RETRY_MS);
+    }, []);
+    // `schedule` and `reload` call each other, so the timer callback reads `reload` from a ref.
+    const reloadRef = useRef(async () => { });
+    const schedule = useCallback((delay) => {
+        if (timer.current !== null)
+            window.clearTimeout(timer.current);
+        timer.current = null;
+        if (!mounted.current || !pollingRef.current)
+            return;
+        timer.current = window.setTimeout(() => {
+            timer.current = null;
+            if (inFlight.current > 0)
+                schedule(POLL_MS);
+            else
+                void reloadRef.current();
+        }, delay);
+    }, []);
+    const reload = useCallback(async () => {
+        const id = ++issued.current;
+        inFlight.current += 1;
+        const controller = new AbortController();
+        controllers.current.add(controller);
+        let timedOut = false;
+        const timeout = window.setTimeout(() => {
+            timedOut = true;
+            controller.abort();
+        }, REQUEST_TIMEOUT_MS);
+        const startedAt = Date.now();
+        const askWorker = workerDue(startedAt);
+        const askedBefore = workerAskedAt.current;
+        if (askWorker)
+            workerAskedAt.current = startedAt;
+        // A dropped response never showed its worker status, so the next refresh asks again.
+        const drop = () => {
+            if (askWorker && workerAskedAt.current === startedAt)
+                workerAskedAt.current = askedBefore;
+        };
+        try {
+            const [jobs, workerRes] = await Promise.all([
+                listJobs(JOBS_LIST_LIMIT, controller.signal),
+                askWorker ? getJobWorker(controller.signal) : Promise.resolve(null),
+            ]);
+            // Aborted by unmount (or React's development remount), not by the timeout.
+            if ((controller.signal.aborted && !timedOut) || !mounted.current)
+                return drop();
+            if (id < oldestFresh.current)
+                return drop();
+            oldestFresh.current = id;
+            const receivedAt = Date.now();
+            if (jobs.ok && jobs.serverTime !== null) {
+                // Whole seconds, so the middle of that second, against the middle of the request.
+                const measured = jobs.serverTime + 500 - (startedAt + receivedAt) / 2;
+                if (Math.abs(measured - skew.current) > SKEW_THRESHOLD_MS)
+                    skew.current = measured;
+            }
+            if (workerRes?.ok)
+                worker.current = workerRes.value;
+            const workerError = workerRes === null ? undefined : workerRes.ok ? null : workerRes.error;
+            let retryAfter = null;
+            if (jobs.ok) {
+                failures.current = 0;
+            }
+            else {
+                failures.current += 1;
+                retryAfter = jobs.retryAfterMs;
+            }
+            const listError = jobs.ok
+                ? null
+                : timedOut
+                    ? `The server didn’t answer within ${REQUEST_TIMEOUT_MS / 1000} seconds`
+                    : jobs.error;
+            setState((prev) => ({
+                jobs: jobs.ok ? jobs.value : prev.jobs,
+                worker: worker.current,
+                fetchedAt: jobs.ok ? receivedAt + skew.current : prev.fetchedAt,
+                skewMs: skew.current,
+                status: jobs.ok || prev.status === 'ready' ? 'ready' : 'error',
+                error: listError,
+                workerError: workerError === undefined ? prev.workerError : workerError,
+            }));
+            schedule(nextDelay(failures.current, retryAfter));
+        }
+        finally {
+            window.clearTimeout(timeout);
+            controllers.current.delete(controller);
+            inFlight.current -= 1;
+        }
+    }, [schedule, workerDue]);
+    useEffect(() => {
+        reloadRef.current = reload;
+    }, [reload]);
+    const upsert = useCallback((job) => {
+        // A refresh already on its way was read before this change.
+        oldestFresh.current = issued.current + 1;
+        setState((prev) => ({
+            ...prev,
+            jobs: prev.jobs.some((row) => row.id === job.id)
+                ? prev.jobs.map((row) => (row.id === job.id ? job : row))
+                : [job, ...prev.jobs].slice(0, JOBS_LIST_LIMIT),
+        }));
+    }, []);
+    useEffect(() => {
+        void reload();
+    }, [reload]);
+    const wasPolling = useRef(null);
+    useEffect(() => {
+        pollingRef.current = polling;
+        const resumed = wasPolling.current === false;
+        wasPolling.current = polling;
+        if (!polling)
+            return;
+        if (resumed)
+            void reload();
+        else if (timer.current === null && inFlight.current === 0)
+            schedule(POLL_MS);
+        return () => {
+            if (timer.current !== null)
+                window.clearTimeout(timer.current);
+            timer.current = null;
+        };
+    }, [polling, reload, schedule]);
+    return { ...state, reload, upsert };
+}
+//# sourceMappingURL=useJobsFeed.js.map

package/dist/views/Jobs/useJobsFeed.js.map

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

package/dist/views/Jobs/useReviewItems.d.ts

@@ -0,0 +1,39 @@
+import type { JobReviewItem } from '@prenta/core';
+interface ReviewItemsState {
+    items: JobReviewItem[];
+    nextCursor: string | null;
+    /** `denied`: a 403, because this person can't read the suggested changes. */
+    status: 'loading' | 'ready' | 'error' | 'denied';
+    /** Why the last read failed. With `ready`, the loaded changes stay. */
+    error: string | null;
+    loadingMore: boolean;
+}
+export interface ReviewItems extends ReviewItemsState {
+    /** The next 20 changes. */
+    loadMore: () => void;
+    /**
+     * Read the loaded changes again, plus new ones up to the end of their page.
+     * Resolves once the read is shown (or failed).
+     */
+    refresh: () => Promise<void>;
+    /** Show the copy of a change a decision just returned. */
+    replace: (item: JobReviewItem) => void;
+}
+/**
+ * A batch job's suggested changes for the drawer's Review tab, 20 at a time
+ * (TRACKING P-18). The first page loads as soon as the drawer opens, so a
+ * 403 hides the tab before anyone picks it. While `watching` (the tab is
+ * open), the loaded changes are read again whenever `version` changes: the
+ * job's `updatedAt` and its number of changes, so new suggestions show up as
+ * the job runs. Reads run one at a time.
+ *
+ * Edits in progress live with the drawer, not here, so a read never touches
+ * them. A change decided here after a read started keeps the decision's copy.
+ */
+export declare function useReviewItems(jobId: string, options: {
+    enabled: boolean;
+    watching: boolean;
+    version: string;
+}): ReviewItems;
+export {};
+//# sourceMappingURL=useReviewItems.d.ts.map

package/dist/views/Jobs/useReviewItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReviewItems.d.ts","sourceRoot":"","sources":["../../../src/views/Jobs/useReviewItems.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAUjD,UAAU,gBAAgB;IACxB,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,6EAA6E;IAC7E,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;IAChD,uEAAuE;IACvE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACnD,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB;;;OAGG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,0DAA0D;IAC1D,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;CACvC;AAmCD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChE,WAAW,CAwGb"}