@prenta/admin 2.6.0 → 2.7.0

package/dist/lib/jobs-service.js

@@ -0,0 +1,179 @@
+import { cmsApi, getApiBase } from './api.js';
+/** The screen lists the newest 50 jobs (JOBS.md). */
+export const JOBS_LIST_LIMIT = 50;
+async function call(endpoint, init) {
+    const res = await cmsApi(endpoint, init);
+    if (res.error !== undefined || res.data === undefined) {
+        return {
+            ok: false,
+            error: res.error ?? 'The server sent an empty response',
+            status: res.status,
+        };
+    }
+    return { ok: true, value: res.data };
+}
+function headerTime(value) {
+    if (!value)
+        return null;
+    const at = Date.parse(value);
+    return Number.isNaN(at) ? null : at;
+}
+/** `Retry-After` is either seconds or an HTTP date. */
+function retryAfterMs(value, serverTime) {
+    if (!value)
+        return null;
+    const seconds = Number(value);
+    if (Number.isFinite(seconds))
+        return Math.max(0, seconds * 1000);
+    const at = headerTime(value);
+    return at === null ? null : Math.max(0, at - (serverTime ?? Date.now()));
+}
+/**
+ * A GET for the 5-second refresh. It calls `fetch` itself, as
+ * `downloadEntriesExport` does, because the refresh needs two response
+ * headers `cmsApi` doesn't pass on: `Date`, to correct for a wrong browser
+ * clock, and `Retry-After`, to back off when rate-limited. A GET needs no
+ * CSRF token. `signal` lets the caller time the request out.
+ */
+async function pollGet(endpoint, signal) {
+    let res;
+    try {
+        res = await fetch(`${getApiBase()}${endpoint}`, {
+            credentials: 'include',
+            headers: { Accept: 'application/json' },
+            signal,
+        });
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : 'Network error';
+        return { ok: false, error, status: 0, serverTime: null, retryAfterMs: null };
+    }
+    const serverTime = headerTime(res.headers.get('date'));
+    const json = (await res.json().catch(() => ({})));
+    if (!res.ok) {
+        return {
+            ok: false,
+            error: json.error || `Request failed (${res.status})`,
+            status: res.status,
+            serverTime,
+            retryAfterMs: res.status === 429 ? retryAfterMs(res.headers.get('retry-after'), serverTime) : null,
+        };
+    }
+    if (json.data === undefined) {
+        return {
+            ok: false,
+            error: 'The server sent an empty response',
+            status: res.status,
+            serverTime,
+            retryAfterMs: null,
+        };
+    }
+    return { ok: true, value: json.data, serverTime };
+}
+/** `GET /jobs`: newest first. */
+export async function listJobs(limit = JOBS_LIST_LIMIT, signal) {
+    const res = await pollGet(`/jobs?limit=${limit}`, signal);
+    return res.ok ? { ...res, value: res.value.jobs ?? [] } : res;
+}
+/** `GET /jobs/worker`: the last tick and the scan schedules, for the worker strip. */
+export function getJobWorker(signal) {
+    return pollGet('/jobs/worker', signal);
+}
+/**
+ * `POST /jobs/run`. When a job of that type is already queued or running the
+ * server returns it with `reused: true` instead of adding one.
+ */
+export function runJobNow(type) {
+    return call('/jobs/run', { method: 'POST', body: JSON.stringify({ type }) });
+}
+/** `POST /jobs/:id/retry`: a failed job, or one waiting to retry. Anything else is a 409. */
+export function retryJob(id) {
+    return call(`/jobs/${encodeURIComponent(id)}/retry`, { method: 'POST' });
+}
+/**
+ * `POST /jobs/:id/cancel`. A queued job comes back cancelled; a running one
+ * comes back with `cancelRequestedAt` set and stops after its slice. A job
+ * that already finished comes back unchanged.
+ */
+export function cancelJob(id) {
+    return call(`/jobs/${encodeURIComponent(id)}/cancel`, { method: 'POST' });
+}
+function jobPath(id) {
+    return `/jobs/${encodeURIComponent(id)}`;
+}
+/**
+ * `GET /jobs/:id`: the job with its scan `results`. A caller who could retry
+ * or cancel it also gets the full `lastError` with its stack; others get the
+ * one line the list shows.
+ */
+export function getJob(id, signal) {
+    return call(jobPath(id), { signal });
+}
+/** `GET /jobs/:id/events`: the job's newest 50 events. */
+export async function listJobEvents(id, signal) {
+    const res = await call(`${jobPath(id)}/events`, { signal });
+    return res.ok ? { ok: true, value: res.value.events ?? [] } : res;
+}
+/** The drawer loads a job's suggested changes 20 at a time (TRACKING P-18). */
+export const REVIEW_PAGE_SIZE = 20;
+/** The most `GET /jobs/:id/review` returns in one page. */
+export const REVIEW_PAGE_MAX = 100;
+/**
+ * `GET /jobs/:id/review`: the job's changes, pending and decided, in the
+ * order they were suggested. A caller who can't edit content, or can't read
+ * one of the collections the job writes, gets a 403.
+ */
+export async function listReviewItems(id, page = {}, signal) {
+    const params = new URLSearchParams({ limit: String(page.limit ?? REVIEW_PAGE_SIZE) });
+    if (page.cursor)
+        params.set('cursor', page.cursor);
+    const res = await call(`${jobPath(id)}/review?${params}`, { signal });
+    return res.ok
+        ? {
+            ok: true,
+            value: { items: res.value.items ?? [], nextCursor: res.value.nextCursor ?? null },
+        }
+        : res;
+}
+/** `POST /jobs/:id/review/:itemId`: approve, reject or undo one change. */
+export async function decideReviewItem(jobId, itemId, decision) {
+    const res = await cmsApi(`${jobPath(jobId)}/review/${encodeURIComponent(itemId)}`, { method: 'POST', body: JSON.stringify(decision) });
+    if (res.error !== undefined || res.data === undefined) {
+        return {
+            ok: false,
+            error: res.error ?? 'The server sent an empty response',
+            status: res.status,
+        };
+    }
+    // `documentStatus` and `notice` sit beside `data` in the envelope.
+    const envelope = (res.body ?? {});
+    return {
+        ok: true,
+        value: {
+            item: res.data,
+            documentStatus: typeof envelope.documentStatus === 'string' ? envelope.documentStatus : null,
+            notice: typeof envelope.notice === 'string' ? envelope.notice : null,
+        },
+    };
+}
+/**
+ * `POST /jobs/:id/review/approve-all`, with the job's own "When a change is
+ * approved". The server stops starting changes after 20 seconds, so a caller
+ * asks again while `remaining` is more than `skipped`.
+ */
+export function approveAllReviewItems(jobId) {
+    return call(`${jobPath(jobId)}/review/approve-all`, { method: 'POST', body: '{}' });
+}
+const REVIEW_CONFLICTS = [
+    ['published', /\bis published, so the change stays in review\b/i],
+    ['changed', /\bchanged while this was being saved\b/i],
+    ['link-gone', /\bisn[’']t published at that address any more\b/i],
+    ['decided', /\bwas already decided\b/i],
+    ['gone', /\bno longer exists\b/i],
+];
+export function reviewConflict(status, error) {
+    if (status !== 409)
+        return null;
+    return REVIEW_CONFLICTS.find(([, pattern]) => pattern.test(error))?.[0] ?? null;
+}
+//# sourceMappingURL=jobs-service.js.map

package/dist/lib/jobs-service.js.map

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

package/dist/lib/sheet-focus.d.ts

@@ -0,0 +1,24 @@
+import { type RefObject } from 'react';
+/**
+ * Where focus goes back to when a sheet closes. Usually the element that had
+ * focus when it opened. A tap on a row's plain text (a table cell) leaves focus
+ * on `<body>`, so the tapped row's own control stands in: the control that was
+ * tapped, else the row's title control, else its first control.
+ */
+export declare function returnTarget(active: Element | null, tapped: EventTarget | null): HTMLElement | null;
+/**
+ * Below 769px an open side pane is a sheet that hides the list it was opened
+ * from (`[data-inspector-open]` in responsive.css), so the row that opened it
+ * leaves the screen. Focus moves into the sheet when it opens and back to that
+ * row when it closes. Wider screens keep the list beside the pane and leave
+ * focus alone.
+ *
+ * `restore` runs first on close, for a list that must put itself back (Media's
+ * virtualised grid returns at the top once shown again); `fallback` is focused
+ * when the opener can't take focus (Media's grid cards aren't focusable).
+ */
+export declare function useSheetFocus(open: boolean, sheetRef: RefObject<HTMLElement | null>, options?: {
+    restore?: () => void;
+    fallback?: () => HTMLElement | null;
+}): void;
+//# sourceMappingURL=sheet-focus.d.ts.map

package/dist/lib/sheet-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet-focus.d.ts","sourceRoot":"","sources":["../../src/lib/sheet-focus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAMzD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,OAAO,GAAG,IAAI,EACtB,MAAM,EAAE,WAAW,GAAG,IAAI,GACzB,WAAW,GAAG,IAAI,CAWpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACvC,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;CAAO,GAC1E,IAAI,CA2BN"}

package/dist/lib/sheet-focus.js

@@ -0,0 +1,61 @@
+import { useEffect, useRef } from 'react';
+import { TIER_MEDIA } from './tiers.js';
+const FOCUSABLE = 'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])';
+/**
+ * Where focus goes back to when a sheet closes. Usually the element that had
+ * focus when it opened. A tap on a row's plain text (a table cell) leaves focus
+ * on `<body>`, so the tapped row's own control stands in: the control that was
+ * tapped, else the row's title control, else its first control.
+ */
+export function returnTarget(active, tapped) {
+    if (active instanceof HTMLElement && active !== active.ownerDocument.body)
+        return active;
+    if (!(tapped instanceof Element))
+        return null;
+    const own = tapped.closest(FOCUSABLE);
+    if (own)
+        return own;
+    const row = tapped.closest('tr, [role="row"]');
+    return (row?.querySelector(`[data-role="title"] :is(${FOCUSABLE})`) ??
+        row?.querySelector(FOCUSABLE) ??
+        null);
+}
+/**
+ * Below 769px an open side pane is a sheet that hides the list it was opened
+ * from (`[data-inspector-open]` in responsive.css), so the row that opened it
+ * leaves the screen. Focus moves into the sheet when it opens and back to that
+ * row when it closes. Wider screens keep the list beside the pane and leave
+ * focus alone.
+ *
+ * `restore` runs first on close, for a list that must put itself back (Media's
+ * virtualised grid returns at the top once shown again); `fallback` is focused
+ * when the opener can't take focus (Media's grid cards aren't focusable).
+ */
+export function useSheetFocus(open, sheetRef, options = {}) {
+    const tapped = useRef(null);
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    useEffect(() => {
+        const onPointerDown = (event) => {
+            tapped.current = event.target;
+        };
+        document.addEventListener('pointerdown', onPointerDown, true);
+        return () => document.removeEventListener('pointerdown', onPointerDown, true);
+    }, []);
+    useEffect(() => {
+        if (!open || typeof window.matchMedia !== 'function')
+            return;
+        if (!window.matchMedia(TIER_MEDIA.mobile).matches)
+            return;
+        const opener = returnTarget(document.activeElement, tapped.current);
+        sheetRef.current?.focus();
+        return () => {
+            optionsRef.current.restore?.();
+            const target = opener?.isConnected && opener.getClientRects().length > 0
+                ? opener
+                : (optionsRef.current.fallback?.() ?? null);
+            target?.focus();
+        };
+    }, [open, sheetRef]);
+}
+//# sourceMappingURL=sheet-focus.js.map

package/dist/lib/sheet-focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet-focus.js","sourceRoot":"","sources":["../../src/lib/sheet-focus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAkB,MAAM,OAAO,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,MAAM,SAAS,GACb,2IAA2I,CAAA;AAE7I;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAsB,EACtB,MAA0B;IAE1B,IAAI,MAAM,YAAY,WAAW,IAAI,MAAM,KAAK,MAAM,CAAC,aAAa,CAAC,IAAI;QAAE,OAAO,MAAM,CAAA;IACxF,IAAI,CAAC,CAAC,MAAM,YAAY,OAAO,CAAC;QAAE,OAAO,IAAI,CAAA;IAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAc,SAAS,CAAC,CAAA;IAClD,IAAI,GAAG;QAAE,OAAO,GAAG,CAAA;IACnB,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC9C,OAAO,CACL,GAAG,EAAE,aAAa,CAAc,2BAA2B,SAAS,GAAG,CAAC;QACxE,GAAG,EAAE,aAAa,CAAc,SAAS,CAAC;QAC1C,IAAI,CACL,CAAA;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAa,EACb,QAAuC,EACvC,UAAyE,EAAE;IAE3E,MAAM,MAAM,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAA;IAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAClC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAA;IAE5B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,aAAa,GAAG,CAAC,KAAmB,EAAE,EAAE;YAC5C,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAA;QAC/B,CAAC,CAAA;QACD,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC,CAAA;QAC7D,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC,CAAA;IAC/E,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU;YAAE,OAAM;QAC5D,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO;YAAE,OAAM;QACzD,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QACnE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAA;QACzB,OAAO,GAAG,EAAE;YACV,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAA;YAC9B,MAAM,MAAM,GACV,MAAM,EAAE,WAAW,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC,MAAM,GAAG,CAAC;gBACvD,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,IAAI,CAAC,CAAA;YAC/C,MAAM,EAAE,KAAK,EAAE,CAAA;QACjB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAA;AACtB,CAAC"}

package/dist/lib/tiers.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Layout tiers (SHELL.md §8) as media queries, for `matchMedia`. The CSS side
+ * is the `@custom-variant` block at the top of `styles/theme.css`
+ * (`mobile:`, `tablet:` …); `tiers.test.ts` checks the two say the same thing.
+ *
+ * Half-open ranges: every width, fractional ones included (768.5px at a zoom
+ * level), falls in exactly one of mobile, tablet, laptop, wide and 4k.
+ */
+export declare const TIER_MEDIA: {
+    /** Tablet and mobile together: ≤1024px. */
+    readonly narrow: "(width < 1025px)";
+    /** ≤768px: bottom tab bar, FAB, cards, sheets. */
+    readonly mobile: "(width < 769px)";
+    /** 769–1024px: icon rail, header actions as icons. */
+    readonly tablet: "(769px <= width < 1025px)";
+    /** 1025–1440px: the baseline. */
+    readonly laptop: "(1025px <= width < 1441px)";
+    /** 1441–2199px. */
+    readonly wide: "(1441px <= width < 2200px)";
+    /** ≥2200px. */
+    readonly '4k': "(width >= 2200px)";
+};
+/**
+ * Whether a media query matches, following changes. Starts `false` and
+ * corrects after mount, so a server render and the first client render agree.
+ * Prefer the CSS variants; use this only where behaviour (not style) differs
+ * by tier.
+ */
+export declare function useMediaQuery(query: string): boolean;
+//# sourceMappingURL=tiers.d.ts.map

package/dist/lib/tiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiers.d.ts","sourceRoot":"","sources":["../../src/lib/tiers.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU;IACrB,2CAA2C;;IAE3C,kDAAkD;;IAElD,sDAAsD;;IAEtD,iCAAiC;;IAEjC,mBAAmB;;IAEnB,eAAe;;CAEP,CAAA;AAEV;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAWpD"}

package/dist/lib/tiers.js

@@ -0,0 +1,43 @@
+import { useEffect, useState } from 'react';
+/**
+ * Layout tiers (SHELL.md §8) as media queries, for `matchMedia`. The CSS side
+ * is the `@custom-variant` block at the top of `styles/theme.css`
+ * (`mobile:`, `tablet:` …); `tiers.test.ts` checks the two say the same thing.
+ *
+ * Half-open ranges: every width, fractional ones included (768.5px at a zoom
+ * level), falls in exactly one of mobile, tablet, laptop, wide and 4k.
+ */
+export const TIER_MEDIA = {
+    /** Tablet and mobile together: ≤1024px. */
+    narrow: '(width < 1025px)',
+    /** ≤768px: bottom tab bar, FAB, cards, sheets. */
+    mobile: '(width < 769px)',
+    /** 769–1024px: icon rail, header actions as icons. */
+    tablet: '(769px <= width < 1025px)',
+    /** 1025–1440px: the baseline. */
+    laptop: '(1025px <= width < 1441px)',
+    /** 1441–2199px. */
+    wide: '(1441px <= width < 2200px)',
+    /** ≥2200px. */
+    '4k': '(width >= 2200px)',
+};
+/**
+ * Whether a media query matches, following changes. Starts `false` and
+ * corrects after mount, so a server render and the first client render agree.
+ * Prefer the CSS variants; use this only where behaviour (not style) differs
+ * by tier.
+ */
+export function useMediaQuery(query) {
+    const [matches, setMatches] = useState(false);
+    useEffect(() => {
+        if (typeof window.matchMedia !== 'function')
+            return;
+        const mq = window.matchMedia(query);
+        const apply = () => setMatches(mq.matches);
+        apply();
+        mq.addEventListener?.('change', apply);
+        return () => mq.removeEventListener?.('change', apply);
+    }, [query]);
+    return matches;
+}
+//# sourceMappingURL=tiers.js.map

package/dist/lib/tiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiers.js","sourceRoot":"","sources":["../../src/lib/tiers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE3C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,2CAA2C;IAC3C,MAAM,EAAE,kBAAkB;IAC1B,kDAAkD;IAClD,MAAM,EAAE,iBAAiB;IACzB,sDAAsD;IACtD,MAAM,EAAE,2BAA2B;IACnC,iCAAiC;IACjC,MAAM,EAAE,4BAA4B;IACpC,mBAAmB;IACnB,IAAI,EAAE,4BAA4B;IAClC,eAAe;IACf,IAAI,EAAE,mBAAmB;CACjB,CAAA;AAEV;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC7C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU;YAAE,OAAM;QACnD,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;QACnC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,CAAA;QAC1C,KAAK,EAAE,CAAA;QACP,EAAE,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QACtC,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IACxD,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IACX,OAAO,OAAO,CAAA;AAChB,CAAC"}