@prenta/admin 2.6.0 → 2.7.0

package/dist/lib/job-view.js

@@ -0,0 +1,363 @@
+/** jobs-data.jsx `TYPES`. */
+export const JOB_TYPES = {
+    'seo-scan': {
+        label: 'SEO scan',
+        unit: 'pages',
+        who: 'Weekly cron',
+        when: 'Mon 04:00 UTC',
+        slice: 'Audits the next batch of pages. Sends the SEO digest when the run finishes.',
+        perSlice: 100,
+    },
+    'content-health': {
+        label: 'Content health',
+        unit: 'documents',
+        who: 'Nightly cron',
+        when: 'Daily 02:30 UTC',
+        slice: 'Scans 25 documents, then resolves issues that are gone.',
+        perSlice: 25,
+    },
+    'batch-ai': {
+        label: 'Batch AI',
+        unit: 'documents',
+        who: 'Started by an editor',
+        when: 'On demand',
+        slice: 'Applies the operation to one document.',
+        perSlice: 1,
+    },
+};
+function isKnownJobType(type) {
+    return Object.hasOwn(JOB_TYPES, type);
+}
+/** A type the kit doesn't know still gets a row (CONFLICTS.md §4: generic tile). */
+export function jobType(type) {
+    return isKnownJobType(type)
+        ? JOB_TYPES[type]
+        : { label: type, unit: 'documents', who: 'System', when: '', slice: '', perSlice: 0 };
+}
+/** jobs-data.jsx `OPS`: the batch AI operations, with the wizard's copy. */
+export const JOB_OPS = [
+    {
+        id: 'meta',
+        label: 'Rewrite meta descriptions',
+        d: 'Writes a description under 155 characters from the page content.',
+        field: 'Meta description',
+        filter: 'Missing or over 160 characters',
+    },
+    {
+        id: 'alt',
+        label: 'Generate image alt text',
+        d: 'Describes each image for screen readers and search.',
+        field: 'Alt text',
+        filter: 'No alt text',
+    },
+    {
+        id: 'titles',
+        label: 'Shorten long titles',
+        d: 'Keeps the meaning, trims SEO titles to 60 characters.',
+        field: 'SEO title',
+        filter: 'Over 60 characters',
+    },
+    {
+        id: 'excerpt',
+        label: 'Write excerpts',
+        d: 'A two-sentence summary for cards and feeds.',
+        field: 'Excerpt',
+        filter: 'No excerpt',
+    },
+    {
+        id: 'links',
+        label: 'Add internal links',
+        d: 'Suggests up to 3 links to related pages in the body.',
+        field: 'Body links',
+        filter: 'Fewer than 2 internal links',
+    },
+    {
+        id: 'custom',
+        label: 'Custom instruction',
+        d: 'Describe the change in your own words.',
+        field: 'Field you choose',
+        filter: 'Any',
+    },
+];
+/**
+ * jobs-data.jsx `view()`, copied. Two edits: attempts read the job's
+ * `maxAttempts` (always 3 today) instead of a literal 3, and a cancel with no
+ * known canceller leaves the sub-line empty instead of "by undefined".
+ */
+export function view(j) {
+    if (j.cancelling)
+        return { k: 'cancelling', l: 'Cancelling', t: 'warn', sub: 'Stops after this slice' };
+    if (j.state === 'running')
+        return {
+            k: 'running',
+            l: 'Running',
+            t: 'acc',
+            sub: `Slice ${(j.done || 0) + 1} · ${jobType(j.type).unit === 'pages' ? 'auditing' : 'working'}`,
+        };
+    if (j.state === 'queued' && j.error)
+        return {
+            k: 'retry',
+            l: 'Retrying',
+            t: 'warn',
+            sub: `Attempt ${j.attempts + 1} of ${j.maxAttempts} · in ${j.retryIn}s`,
+        };
+    if (j.state === 'queued' && j.done > 0)
+        return { k: 'between', l: 'In progress', t: 'acc', sub: 'Waiting for the next slice' };
+    if (j.state === 'queued')
+        return {
+            k: 'queued',
+            l: 'Queued',
+            t: 'mute',
+            sub: j.queuePos
+                ? `Behind ${j.queuePos} job${j.queuePos > 1 ? 's' : ''}`
+                : 'Waiting for the worker',
+        };
+    if (j.state === 'dead')
+        return { k: 'dead', l: 'Failed', t: 'err', sub: `After ${j.maxAttempts} attempts` };
+    if (j.state === 'cancelled')
+        return {
+            k: 'cancelled',
+            l: 'Cancelled',
+            t: 'mute',
+            sub: j.cancelledBy ? `by ${j.cancelledBy}` : '',
+        };
+    if (j.type === 'batch-ai' && j.pending > 0)
+        return {
+            k: 'review',
+            l: 'Needs review',
+            t: 'rev',
+            sub: `${j.pending} change${j.pending > 1 ? 's' : ''} waiting`,
+        };
+    return { k: 'ok', l: 'Succeeded', t: 'suc', sub: j.took ? `Took ${j.took}` : '' };
+}
+/** jobs-data.jsx `active()`: the worker still has work to do on it. */
+export function active(j) {
+    return j.state === 'queued' || j.state === 'running';
+}
+/** jobs-view.jsx `FILTERS`. */
+export const JOB_FILTERS = [
+    { id: 'all', label: 'All' },
+    { id: 'active', label: 'Active' },
+    { id: 'review', label: 'Needs review' },
+    { id: 'ok', label: 'Succeeded' },
+    { id: 'dead', label: 'Failed' },
+    { id: 'cancelled', label: 'Cancelled' },
+];
+/** jobs-view.jsx `match()`. */
+export function matchJob(j, f) {
+    const v = view(j);
+    if (f === 'all')
+        return true;
+    if (f === 'active')
+        return active(j);
+    if (f === 'review')
+        return v.k === 'review' || (j.type === 'batch-ai' && j.pending > 0 && j.state !== 'cancelled');
+    if (f === 'ok')
+        return j.state === 'succeeded';
+    if (f === 'dead')
+        return j.state === 'dead';
+    return j.state === 'cancelled';
+}
+/** Counts per filter, over the rows the type select leaves (jobs-view.jsx `counts`). */
+export function countJobs(rows) {
+    const counts = {};
+    for (const { id } of JOB_FILTERS)
+        counts[id] = rows.filter((row) => matchJob(row, id)).length;
+    return counts;
+}
+/** Whether the row shows a Review button (jobs-view.jsx row actions). */
+export function hasReviewAction(j) {
+    return view(j).k === 'review' || (j.items && j.pending > 0);
+}
+/** A running job whose lock is older than this crashed mid-slice (JOBS.md). */
+const STALE_LOCK_MS = 10 * 60_000;
+/** The worker cron runs once a minute. */
+const TICK_MS = 60_000;
+const WEEKDAYS = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+const MONTHS = [
+    'Jan',
+    'Feb',
+    'Mar',
+    'Apr',
+    'May',
+    'Jun',
+    'Jul',
+    'Aug',
+    'Sep',
+    'Oct',
+    'Nov',
+    'Dec',
+];
+function pad(value) {
+    return String(value).padStart(2, '0');
+}
+function clock(date) {
+    return `${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+/** Calendar days from `from` to `to`, in local time. */
+function dayDiff(to, from) {
+    const start = (date) => new Date(date.getFullYear(), date.getMonth(), date.getDate());
+    return Math.round((start(to).getTime() - start(from).getTime()) / 86_400_000);
+}
+/** "now", "34 min ago", "Today 02:30", "Yesterday 16:04", "Mon 04:00", then "12 Oct". */
+export function formatCreated(iso, now) {
+    const at = new Date(iso);
+    const ms = now - at.getTime();
+    if (ms < 60_000)
+        return 'now';
+    if (ms < 3_600_000)
+        return `${Math.floor(ms / 60_000)} min ago`;
+    const days = dayDiff(new Date(now), at);
+    if (days === 0)
+        return `Today ${clock(at)}`;
+    if (days === 1)
+        return `Yesterday ${clock(at)}`;
+    if (days < 7)
+        return `${WEEKDAYS[at.getDay()]} ${clock(at)}`;
+    const year = at.getFullYear() === new Date(now).getFullYear() ? '' : ` ${at.getFullYear()}`;
+    return `${at.getDate()} ${MONTHS[at.getMonth()]}${year}`;
+}
+/** "today 14:00", "tomorrow 00:00", then "Sun 1 Nov 00:00": a time still to come, in local time. */
+export function formatLater(at, now) {
+    const date = new Date(at);
+    const days = dayDiff(date, new Date(now));
+    if (days <= 0)
+        return `today ${clock(date)}`;
+    if (days === 1)
+        return `tomorrow ${clock(date)}`;
+    return `${WEEKDAYS[date.getDay()]} ${date.getDate()} ${MONTHS[date.getMonth()]} ${clock(date)}`;
+}
+/** "12s", "17 min", "1h 52m". */
+export function formatDuration(ms) {
+    const seconds = Math.max(0, Math.round(ms / 1000));
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.round(seconds / 60);
+    if (minutes < 60)
+        return `${minutes} min`;
+    return `${Math.floor(minutes / 60)}h ${minutes % 60}m`;
+}
+/** "24s", "3 min", "5h", "2 days": how long ago the worker last ran. */
+export function formatSince(ms) {
+    const seconds = Math.max(0, Math.floor(ms / 1000));
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes} min`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 48)
+        return `${hours}h`;
+    return `${Math.floor(hours / 24)} days`;
+}
+/** "Mon 04:00 UTC" or "Daily 02:30 UTC" from a weekly or daily cron; anything else as written. */
+export function scheduleLabel(cron) {
+    const [minute, hour, dayOfMonth, month, weekday, ...rest] = cron.trim().split(/\s+/);
+    const simple = rest.length === 0 &&
+        /^\d{1,2}$/.test(minute ?? '') &&
+        /^\d{1,2}$/.test(hour ?? '') &&
+        dayOfMonth === '*' &&
+        month === '*';
+    if (!simple)
+        return cron;
+    const time = `${pad(Number(hour))}:${pad(Number(minute))} UTC`;
+    if (weekday === '*')
+        return `Daily ${time}`;
+    if (weekday !== undefined && /^[0-6]$/.test(weekday))
+        return `${WEEKDAYS[Number(weekday)]} ${time}`;
+    return cron;
+}
+/**
+ * "next tonight", "next today", "next tomorrow" or "next Mon 19 Oct". In UTC,
+ * like the schedule it follows ("Mon 04:00 UTC · next Mon 26 Oct"), so the
+ * weekday never disagrees with the label.
+ */
+export function formatNextRun(iso, now) {
+    const at = new Date(iso);
+    const utcDay = (date) => Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate());
+    const days = Math.round((utcDay(at) - utcDay(new Date(now))) / 86_400_000);
+    const night = at.getUTCHours() >= 18 || at.getUTCHours() < 6;
+    if (at.getTime() - now < 86_400_000 && night && days <= 1)
+        return 'next tonight';
+    if (days <= 0)
+        return 'next today';
+    if (days === 1)
+        return 'next tomorrow';
+    return `next ${WEEKDAYS[at.getUTCDay()]} ${at.getUTCDate()} ${MONTHS[at.getUTCMonth()]}`;
+}
+/**
+ * Seconds until a retry runs: the first worker tick at or after its backoff.
+ * Without a tick ahead (the worker hasn't run, or is late) it's the backoff alone.
+ */
+function retryInSeconds(runAt, now, nextTickAt) {
+    let at = runAt;
+    if (nextTickAt !== null && nextTickAt > now) {
+        at = nextTickAt + Math.max(0, Math.ceil((runAt - nextTickAt) / TICK_MS)) * TICK_MS;
+    }
+    return Math.max(0, Math.ceil((at - now) / 1000));
+}
+function who(job) {
+    const by = job.createdBy;
+    if (!by)
+        return jobType(job.type).who;
+    if ('kind' in by)
+        return by.schedule === 'weekly-seo' ? 'Weekly cron' : 'Nightly cron';
+    return by.name;
+}
+/** Claim order (`claimNext`): earliest `runAt`, then oldest. */
+function claimsBefore(a, b) {
+    const runA = Date.parse(a.runAt);
+    const runB = Date.parse(b.runAt);
+    if (runA !== runB)
+        return runA < runB;
+    return Date.parse(a.createdAt) < Date.parse(b.createdAt);
+}
+/**
+ * API jobs in the kit's row shape. `now` is when the list was fetched, so the
+ * retry countdown and "34 min ago" move with each poll. `worker` aligns the
+ * retry countdown with the once-a-minute worker.
+ */
+export function toJobRows(jobs, now, worker) {
+    const nextTickAt = worker?.nextTickAt ? Date.parse(worker.nextTickAt) : null;
+    const isActive = (job) => job.status === 'queued' || job.status === 'running';
+    return jobs.map((job) => {
+        const stale = job.status === 'running' &&
+            job.lockedAt !== null &&
+            now - Date.parse(job.lockedAt) > STALE_LOCK_MS;
+        // A stale lock is handled as a failed slice on the next tick (JOBS.md).
+        const state = stale ? 'queued' : job.status;
+        const error = stale ? 'Worker stopped mid-slice' : job.lastError;
+        const finished = state === 'succeeded' ? (job.finishedAt ?? job.updatedAt) : null;
+        const review = job.review;
+        return {
+            id: job.id,
+            type: job.type,
+            title: job.title,
+            scope: job.scope,
+            state,
+            status: job.status,
+            cancelling: !!job.cancelRequestedAt && isActive(job),
+            done: job.progress.done,
+            total: job.progress.total,
+            attempts: job.attempts,
+            maxAttempts: job.maxAttempts,
+            error,
+            retryIn: state === 'queued' && error
+                ? retryInSeconds(stale ? now : Date.parse(job.runAt), now, nextTickAt)
+                : 0,
+            queuePos: state === 'queued' && !error
+                ? jobs.filter((other) => other.id !== job.id &&
+                    isActive(other) &&
+                    (other.status === 'running' || claimsBefore(other, job))).length
+                : 0,
+            cancelledBy: job.cancelledBy?.name ?? null,
+            pending: review?.pending ?? 0,
+            items: !!review && review.pending + review.approved + review.rejected > 0,
+            review: job.type === 'batch-ai' && 'review' in job.payload ? job.payload.review : null,
+            took: finished ? formatDuration(Date.parse(finished) - Date.parse(job.createdAt)) : null,
+            by: who(job),
+            created: formatCreated(job.createdAt, now),
+        };
+    });
+}
+//# sourceMappingURL=job-view.js.map

package/dist/lib/job-view.js.map

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

package/dist/lib/jobs-service.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Jobs service: a typed client over the cms-core Jobs endpoints
+ * (DATA_CONTRACTS.md §1, envelopes in CONFLICTS.md §4). The Jobs screen calls
+ * these, never `cmsApi` directly.
+ *
+ * Every call returns an outcome rather than throwing, so a screen can tell a
+ * failed request from an empty list and show the server's message (a
+ * viewer's 403, a 409 for a job that can't be retried).
+ */
+import type { Job, JobEvent, JobReviewItem, JobWorkerStatus } from '@prenta/core';
+export type JobsOutcome<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: string;
+    status: number;
+};
+/**
+ * A polled read. It also carries the server's clock (the `Date` header) and,
+ * on a 429, how long the server asked the client to wait (`Retry-After`).
+ */
+export type PollOutcome<T> = {
+    ok: true;
+    value: T;
+    serverTime: number | null;
+} | {
+    ok: false;
+    error: string;
+    status: number;
+    serverTime: number | null;
+    retryAfterMs: number | null;
+};
+/** The screen lists the newest 50 jobs (JOBS.md). */
+export declare const JOBS_LIST_LIMIT = 50;
+/** The job types "Run now" can start. Batch AI starts from a set of documents instead. */
+export type RunnableJobType = 'seo-scan' | 'content-health';
+/** `GET /jobs`: newest first. */
+export declare function listJobs(limit?: number, signal?: AbortSignal): Promise<PollOutcome<Job[]>>;
+/** `GET /jobs/worker`: the last tick and the scan schedules, for the worker strip. */
+export declare function getJobWorker(signal?: AbortSignal): Promise<PollOutcome<JobWorkerStatus>>;
+/**
+ * `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 declare function runJobNow(type: RunnableJobType): Promise<JobsOutcome<{
+    job: Job;
+    reused: boolean;
+}>>;
+/** `POST /jobs/:id/retry`: a failed job, or one waiting to retry. Anything else is a 409. */
+export declare function retryJob(id: string): Promise<JobsOutcome<Job>>;
+/**
+ * `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 declare function cancelJob(id: string): Promise<JobsOutcome<Job>>;
+/**
+ * `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 declare function getJob(id: string, signal?: AbortSignal): Promise<JobsOutcome<Job>>;
+/** `GET /jobs/:id/events`: the job's newest 50 events. */
+export declare function listJobEvents(id: string, signal?: AbortSignal): Promise<JobsOutcome<JobEvent[]>>;
+/** The drawer loads a job's suggested changes 20 at a time (TRACKING P-18). */
+export declare const REVIEW_PAGE_SIZE = 20;
+/** The most `GET /jobs/:id/review` returns in one page. */
+export declare const REVIEW_PAGE_MAX = 100;
+export interface ReviewPage {
+    items: JobReviewItem[];
+    /** Pass back as `cursor` for the next page; null on the last one. */
+    nextCursor: string | null;
+}
+/**
+ * `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 declare function listReviewItems(id: string, page?: {
+    cursor?: string | null;
+    limit?: number;
+}, signal?: AbortSignal): Promise<JobsOutcome<ReviewPage>>;
+/**
+ * "Save as draft" (which keeps a published document's status, so its change
+ * stays in review) or "Publish" (CONFLICTS.md §4).
+ */
+export type OnApprove = 'draft' | 'publish';
+export type ReviewAction = {
+    action: 'approve';
+    onApprove?: OnApprove;
+    after?: string;
+} | {
+    action: 'reject';
+} | {
+    action: 'undo';
+};
+export interface ReviewDecision {
+    item: JobReviewItem;
+    /** The document's status after the decision, such as `PUBLISHED`. Null for an image. */
+    documentStatus: string | null;
+    /** Set when an undo left the document published, now showing the previous text. */
+    notice: string | null;
+}
+/** `POST /jobs/:id/review/:itemId`: approve, reject or undo one change. */
+export declare function decideReviewItem(jobId: string, itemId: string, decision: ReviewAction): Promise<JobsOutcome<ReviewDecision>>;
+export interface ApproveAllOutcome {
+    approved: number;
+    /** Changes this call couldn't apply. They stay pending. */
+    skipped: number;
+    /** Pending changes left, skipped ones included. */
+    remaining: number;
+}
+/**
+ * `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 declare function approveAllReviewItems(jobId: string): Promise<JobsOutcome<ApproveAllOutcome>>;
+/**
+ * Why a review decision was refused with a 409, read from the server's
+ * message (cms-core `jobs/review.ts`), which the drawer shows as it is:
+ * - `published`: approved without Publish on a published document, so the
+ *   change stays in review;
+ * - `changed`: the document changed while the change was being saved, or its
+ *   publish state moved since it was read, and nothing was written;
+ * - `link-gone`: the page a link points to isn't published at that address;
+ * - `decided`: someone else decided the change first;
+ * - `gone`: the change or its document no longer exists.
+ * Null for any other refusal.
+ */
+export type ReviewConflict = 'published' | 'changed' | 'link-gone' | 'decided' | 'gone';
+export declare function reviewConflict(status: number, error: string): ReviewConflict | null;
+//# sourceMappingURL=jobs-service.d.ts.map

package/dist/lib/jobs-service.d.ts.map

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