@prenta/core 8.9.2 → 8.11.0

package/dist/jobs/serialize.js

@@ -0,0 +1,275 @@
+import { initialsFor } from '../auth/team.js';
+import { errorSummary } from './error-text.js';
+const NO_REFS = { users: new Map(), review: new Map() };
+const SCANS = {
+    'seo-scan': {
+        title: 'SEO scan',
+        scope: 'All indexable pages',
+        schedule: 'weekly-seo',
+    },
+    'content-health': {
+        title: 'Content health',
+        scope: 'All published documents',
+        schedule: 'nightly-health',
+    },
+};
+/** Operation names as `/ai/batch` stores them, plus the kit's names unchanged. */
+const BATCH_OPERATIONS = {
+    meta: 'meta',
+    'alt-text': 'alt',
+    summarize: 'excerpt',
+    alt: 'alt',
+    titles: 'titles',
+    excerpt: 'excerpt',
+    links: 'links',
+    custom: 'custom',
+};
+const OPERATION_TITLES = {
+    meta: 'Rewrite meta descriptions',
+    alt: 'Generate alt text',
+    titles: 'Shorten long titles',
+    excerpt: 'Write excerpts',
+    links: 'Add internal links',
+    custom: 'Custom instruction',
+};
+function isScan(type) {
+    return type in SCANS;
+}
+function str(value) {
+    return typeof value === 'string' && value.length > 0 ? value : null;
+}
+/** The rows `/ai/batch` stores, one per document. */
+function batchItems(job) {
+    const items = job.payload.items;
+    if (!Array.isArray(items))
+        return [];
+    return items.filter((item) => !!item && typeof item === 'object');
+}
+/**
+ * The kit's payload. Rows queued by `/ai/batch` keep their operation and
+ * collection per item and apply directly, so they read as "Apply automatically".
+ * They store no review mode, which `origin` keeps visible: unlike a stored
+ * `auto`, they aren't admin-only to retry ({@link batchAiWriter}).
+ */
+function batchPayload(job) {
+    const payload = job.payload;
+    const items = batchItems(job);
+    const operation = str(payload.operation) ?? str(items[0]?.operation) ?? '';
+    const documentIds = Array.isArray(payload.documentIds)
+        ? payload.documentIds.filter((id) => typeof id === 'string')
+        : items.map((item) => str(item.documentId)).filter((id) => id !== null);
+    return {
+        operation: BATCH_OPERATIONS[operation] ?? 'custom',
+        instruction: str(payload.instruction),
+        source: str(payload.source) ?? str(items[0]?.collection) ?? '',
+        statusFilter: payload.statusFilter === 'published' ? 'published' : 'all',
+        documentIds,
+        review: payload.review === 'review' ? 'review' : 'auto',
+        onApprove: payload.onApprove === 'publish' ? 'publish' : 'draft',
+        ...(isTextField(payload.field) ? { field: payload.field } : {}),
+        ...(payload.review !== 'review' && payload.review !== 'auto'
+            ? { origin: 'ai-batch' }
+            : {}),
+    };
+}
+function isTextField(value) {
+    return value === 'metaDescription' || value === 'seoTitle' || value === 'excerpt';
+}
+function scanPayload(job) {
+    return { trigger: job.payload.trigger === 'manual' || job.createdById ? 'manual' : 'cron' };
+}
+/** Who queued it. Older batch AI rows have no `createdById`, so their first item says. */
+function creatorId(job) {
+    if (job.createdById)
+        return job.createdById;
+    if (job.type === 'batch-ai')
+        return str(batchItems(job)[0]?.userId);
+    return null;
+}
+/**
+ * Who a batch AI job writes as, and where, for permission checks. Each item
+ * stores the user and role it was queued with, and the worker writes with them.
+ * `autoApply` is true only for a stored `review: 'auto'`. Rows from `/ai/batch`
+ * have no review mode: any editor could queue them.
+ */
+export function batchAiWriter(job) {
+    const items = batchItems(job);
+    const roles = items.map((item) => str(item.role)).filter((role) => role !== null);
+    const collections = [str(job.payload.source), ...items.map((item) => str(item.collection))];
+    return {
+        creatorId: creatorId(job),
+        roles: [...new Set(roles)],
+        collections: [...new Set(collections.filter((slug) => slug !== null))],
+        autoApply: job.payload.review === 'auto',
+    };
+}
+function userRef(id, users) {
+    return users.get(id) ?? { id, name: 'Unknown user', initials: '?' };
+}
+function createdBy(job, refs) {
+    const id = creatorId(job);
+    if (id)
+        return userRef(id, refs.users);
+    if (isScan(job.type))
+        return { kind: 'cron', schedule: SCANS[job.type].schedule };
+    return null;
+}
+function title(job) {
+    if (job.title)
+        return job.title;
+    if (isScan(job.type))
+        return SCANS[job.type].title;
+    if (job.type === 'batch-ai')
+        return OPERATION_TITLES[batchPayload(job).operation];
+    return job.type;
+}
+function scope(job) {
+    if (job.scope)
+        return job.scope;
+    if (isScan(job.type))
+        return SCANS[job.type].scope;
+    if (job.type === 'batch-ai') {
+        const count = batchPayload(job).documentIds.length;
+        return `${count} ${count === 1 ? 'document' : 'documents'}`;
+    }
+    return '';
+}
+/** seo-scan saves `skip`, content-health `cursor`, batch AI `index`. */
+function cursor(payload) {
+    if (typeof payload.cursor === 'string')
+        return payload.cursor;
+    if (typeof payload.skip === 'number' && payload.skip > 0)
+        return String(payload.skip);
+    if (typeof payload.index === 'number' && payload.index > 0)
+        return String(payload.index);
+    return null;
+}
+function payloadView(job) {
+    if (job.type === 'batch-ai')
+        return batchPayload(job);
+    if (isScan(job.type))
+        return scanPayload(job);
+    return {};
+}
+/**
+ * The stored row in the contract shape (DATA_CONTRACTS §1). `lastError` is one
+ * summary line unless `fullError` is set, because the full text has the stack,
+ * with server paths and query text. `detail` adds scan results.
+ */
+export function serializeJob(job, refs = NO_REFS, options = {}) {
+    const { completed, total, message } = job.progress;
+    const serialized = {
+        id: job.id,
+        type: job.type,
+        status: job.status,
+        title: title(job),
+        scope: scope(job),
+        runAt: job.runAt.toISOString(),
+        attempts: job.attempts,
+        maxAttempts: job.maxAttempts,
+        progress: {
+            done: completed,
+            total,
+            unit: job.type === 'seo-scan' ? 'pages' : 'documents',
+            cursor: cursor(job.payload),
+            completed,
+            ...(message !== undefined ? { message } : {}),
+        },
+        lastError: options.fullError ? job.lastError : errorSummary(job.lastError),
+        // '' marks a note claimed but not (or never) written.
+        explain: job.explain || null,
+        summary: job.summary || null,
+        lockedAt: job.lockedAt?.toISOString() ?? null,
+        cancelRequestedAt: job.cancelRequestedAt?.toISOString() ?? null,
+        cancelledBy: job.cancelledById ? userRef(job.cancelledById, refs.users) : null,
+        createdBy: createdBy(job, refs),
+        createdAt: job.createdAt.toISOString(),
+        updatedAt: job.updatedAt.toISOString(),
+        finishedAt: job.finishedAt?.toISOString() ?? null,
+        usage: { tokensIn: job.tokensIn ?? 0, tokensOut: job.tokensOut ?? 0 },
+        payload: payloadView(job),
+    };
+    if (options.detail && isScan(job.type) && job.results) {
+        serialized.results = job.results;
+    }
+    if (job.type === 'batch-ai') {
+        serialized.review = refs.review.get(job.id) ?? { pending: 0, approved: 0, rejected: 0 };
+    }
+    return serialized;
+}
+export function serializeJobEvent(event) {
+    return {
+        at: event.at.toISOString(),
+        kind: event.kind,
+        message: event.message,
+        ...(event.detail ? { detail: event.detail } : {}),
+        ...(typeof event.durationMs === 'number' ? { durationMs: event.durationMs } : {}),
+        ...(typeof event.tokens === 'number' ? { tokens: event.tokens } : {}),
+    };
+}
+/** People by id, one query. An id with no user is left out; {@link userRef} fills it in. */
+export async function loadUserRefs(db, ids) {
+    const unique = [...new Set(ids)];
+    const refs = new Map();
+    if (unique.length === 0)
+        return refs;
+    const users = await db.user.findMany({
+        where: { id: { in: unique } },
+        select: { id: true, name: true, email: true },
+    });
+    for (const user of users) {
+        const name = user.name || user.email;
+        refs.set(user.id, { id: user.id, name, initials: initialsFor(user.name, user.email) });
+    }
+    return refs;
+}
+/** One query for the people on these jobs and one for batch AI review counts. */
+export async function loadJobRefs(db, jobs) {
+    const userIds = new Set();
+    for (const job of jobs) {
+        const creator = creatorId(job);
+        if (creator)
+            userIds.add(creator);
+        if (job.cancelledById)
+            userIds.add(job.cancelledById);
+    }
+    const batchIds = jobs.filter((job) => job.type === 'batch-ai').map((job) => job.id);
+    const [users, counts] = await Promise.all([
+        loadUserRefs(db, userIds),
+        batchIds.length > 0
+            ? db.jobReviewItem.groupBy({
+                by: ['jobId', 'status'],
+                where: { jobId: { in: batchIds } },
+                _count: { _all: true },
+            })
+            : [],
+    ]);
+    const review = new Map();
+    for (const row of counts) {
+        const tally = review.get(row.jobId) ?? { pending: 0, approved: 0, rejected: 0 };
+        if (row.status === 'pending' || row.status === 'approved' || row.status === 'rejected') {
+            tally[row.status] += row._count._all;
+        }
+        review.set(row.jobId, tally);
+    }
+    return { users, review };
+}
+/** A review item in the contract shape, with who decided it. */
+export function serializeReviewItem(item, users) {
+    return {
+        id: item.id,
+        jobId: item.jobId,
+        documentId: item.documentId,
+        documentTitle: item.documentTitle,
+        url: item.url,
+        field: item.field,
+        before: item.before,
+        after: item.after,
+        editedAfter: item.editedAfter,
+        status: item.status,
+        decidedBy: item.decidedById ? userRef(item.decidedById, users) : null,
+        decidedAt: item.decidedAt?.toISOString() ?? null,
+        appliedRevisionId: item.appliedRevisionId,
+    };
+}
+//# sourceMappingURL=serialize.js.map

package/dist/jobs/serialize.js.map

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

package/dist/jobs/types.d.ts

@@ -1,4 +1,5 @@
-export type JobStatus = 'queued' | 'running' | 'succeeded' | 'dead';
+import type { ScanResults } from './contract.js';
+export type JobStatus = 'queued' | 'running' | 'succeeded' | 'dead' | 'cancelled';
 export interface JobProgress {
     completed: number;
     total: number;
@@ -17,6 +18,30 @@ export interface JobRecord {
     progress: JobProgress;
     createdAt: Date;
     updatedAt: Date;
+    /** Set while a running job should stop after the current slice. */
+    cancelRequestedAt?: Date | null;
+    cancelledById?: string | null;
+    /** Who queued the job. Null for cron jobs. Written once, on insert. */
+    createdById?: string | null;
+    title?: string | null;
+    scope?: string | null;
+    tokensIn?: number;
+    tokensOut?: number;
+    /**
+     * The AI notes (worker rules 3 and 4): `explain` on a dead job, `summary` on
+     * a finished scan. Null until the worker claims the note, then `''` until
+     * its text lands. `''` stays when the AI had nothing to say.
+     */
+    explain?: string | null;
+    summary?: string | null;
+    /** Scan results in the contract's `ScanResults` shape, written when a scan finishes. */
+    results?: ScanResults | null;
+    finishedAt?: Date | null;
+}
+/** AI tokens one slice used. The queue adds them to the job's running totals. */
+export interface JobUsage {
+    tokensIn: number;
+    tokensOut: number;
 }
 interface JobHandlerContext {
     now: Date;
@@ -25,12 +50,47 @@ interface JobHandlerContext {
 type JobHandlerResult = {
     done: true;
     progress?: JobProgress;
+    usage?: JobUsage;
+    /** Worker rule 3: a scan's results, saved with the success. The AI summary follows later. */
+    results?: ScanResults;
 } | {
     done: false;
     progress: JobProgress;
     payload?: Record<string, unknown>;
+    usage?: JobUsage;
+    /**
+     * Yield until `until` instead of running again at once, for example when
+     * an AI usage cap is spent. Attempts stay put: waiting is not a failure.
+     */
+    wait?: {
+        until: Date;
+        reason: string;
+    };
 };
 export type JobHandler = (job: JobRecord, ctx: JobHandlerContext) => Promise<JobHandlerResult>;
+export type JobEventKind = 'queued' | 'claimed' | 'slice_ok' | 'slice_failed' | 'yielded' | 'retry_scheduled' | 'dead' | 'cancel_requested' | 'cancelled' | 'finished' | 'stale_lock';
+export interface JobEventRecord {
+    jobId: string;
+    at: Date;
+    kind: JobEventKind;
+    message: string;
+    detail?: string | null;
+    durationMs?: number | null;
+    tokens?: number | null;
+}
+/** Which AI note: `explain` on a dead job, `summary` on a finished scan. */
+export type JobNote = 'explain' | 'summary';
+export interface JobListFilter {
+    type?: string;
+    statuses?: JobStatus[];
+}
+/** How much one retention run may delete. */
+export interface PruneLimit {
+    /** Jobs, at most. */
+    jobs: number;
+    /** Events and review items deleted with them, at most, past the first job. */
+    rows: number;
+}
 export interface JobStore {
     insert(job: JobRecord): Promise<void>;
     /** A queued or running job of this type, if one exists. */
@@ -39,14 +99,93 @@ export interface JobStore {
     claimNext(now: Date): Promise<JobRecord | null>;
     /** Running jobs locked before `cutoff` (the worker was killed mid-slice). */
     findStaleRunning(cutoff: Date): Promise<JobRecord[]>;
+    /**
+     * Writes the row except the cancel fields and `createdById`, so a slice saving
+     * a copy it read earlier can never clear a cancel. Only
+     * {@link JobStore.requestCancel} sets the cancel fields and only
+     * {@link JobStore.retry} clears them.
+     */
     save(job: JobRecord): Promise<void>;
-    list(limit: number): Promise<JobRecord[]>;
+    /**
+     * Sets the cancel fields and `updatedAt` only, as one conditional write. It does
+     * nothing when a cancel was already requested or the job is no longer queued or
+     * running, so a cancel that loses a race with the job finishing leaves no trace.
+     * Returns whether this call set the flag.
+     */
+    requestCancel(id: string, at: Date, byId: string | null): Promise<boolean>;
+    /**
+     * Writes `job` (already marked cancelled) like {@link JobStore.save}, but only
+     * while the stored row is still queued or running and still waits on the same
+     * cancel: its `cancelRequestedAt` equals `job.cancelRequestedAt`. So a stale
+     * copy can't undo a retry that cleared the flag, end a job twice, or finish a
+     * newer cancel requested after a retry with fields from before it. Returns
+     * whether it applied.
+     */
+    finishCancel(job: JobRecord): Promise<boolean>;
+    /**
+     * Puts a dead job, or a queued job waiting out a failure, back in the queue
+     * now, as one conditional write. Resets attempts and clears `lastError`,
+     * `explain`, `finishedAt` and the cancel fields. Payload and progress are kept,
+     * so the handler continues from its saved cursor. Returns whether it applied.
+     */
+    retry(id: string, now: Date): Promise<boolean>;
+    /**
+     * Finished jobs whose AI note nobody has claimed: dead jobs with `explain`
+     * null, and succeeded jobs of `summaryTypes` with `summary` null, that
+     * finished at or after `since`. Oldest first, at most `limit`.
+     */
+    findPendingNotes(since: Date, summaryTypes: readonly string[], limit: number): Promise<JobRecord[]>;
+    /**
+     * Claims a finished job's AI note as one conditional write: sets it from null
+     * to `''` while the job is still the same finish (dead for `explain`,
+     * succeeded for `summary`, same `finishedAt`). Only the caller that gets
+     * true asks the AI, so each finish gets at most one call, even from two
+     * overlapping ticks. A retry clears `explain` back to null.
+     */
+    claimNote(id: string, note: JobNote, finishedAt: Date): Promise<boolean>;
+    /**
+     * Adds the note's tokens to the job, then writes its text while the note is
+     * still claimed (`''`) for the same finish, so an answer can't land on a job
+     * that was retried since. The tokens are added either way. Returns whether
+     * the text was written.
+     */
+    writeNote(id: string, note: JobNote, finishedAt: Date, text: string, usage?: JobUsage): Promise<boolean>;
+    /** Newest first. */
+    list(limit: number, filter?: JobListFilter): Promise<JobRecord[]>;
+    get(id: string): Promise<JobRecord | null>;
+    /**
+     * Queued jobs whose cancel flag was set. The worker finalises these at the
+     * start of each tick: a cancel can land just before a slice yields, and a job
+     * waiting out a usage cap may not be claimed again for weeks. Running jobs are
+     * left to the tick that holds their lock, which finalises the cancel at its
+     * slice boundary with that slice's work, or to the stale-lock path once the
+     * lock is older than 10 minutes.
+     */
+    findCancelRequested(): Promise<JobRecord[]>;
+    /**
+     * Retention: deletes finished jobs (succeeded, dead or cancelled) that
+     * finished before `cutoff`, oldest first, with their events and review items,
+     * within `limit`. A row with no `finishedAt` (finished before 0025) counts
+     * from `updatedAt`. Queued and running jobs are never deleted, and neither is
+     * a job with a change waiting for review or decided since `cutoff`, so a
+     * decision can be undone for the whole window. Returns how many it deleted.
+     */
+    pruneFinished(cutoff: Date, limit: PruneLimit): Promise<number>;
+    addEvent(event: JobEventRecord): Promise<void>;
+    /** Newest first. */
+    listEvents(jobId: string, limit: number): Promise<JobEventRecord[]>;
+    /**
+     * Deletes all but a job's newest `keep` events, in {@link JobStore.listEvents}
+     * order. Returns how many it deleted.
+     */
+    trimEvents(jobId: string, keep: number): Promise<number>;
 }
 export interface QueueTickResult {
     succeeded: number;
     continued: number;
     retried: number;
     dead: number;
+    cancelled: number;
 }
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/jobs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/jobs/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAA;AAEnE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,MAAM,EAAE,SAAS,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,IAAI,CAAA;IACX,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,WAAW,CAAA;IACrB,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;CAChB;AAED,UAAU,iBAAiB;IACzB,GAAG,EAAE,IAAI,CAAA;IACT,QAAQ,EAAE,IAAI,CAAA;CACf;AAED,KAAK,gBAAgB,GACjB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,WAAW,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAA;AAE7E,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAE9F,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,2DAA2D;IAC3D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IACnD,kEAAkE;IAClE,SAAS,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAC/C,6EAA6E;IAC7E,gBAAgB,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IACpD,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/jobs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,CAAA;AAEjF,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,MAAM,EAAE,SAAS,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,IAAI,CAAA;IACX,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,WAAW,CAAA;IACrB,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;IACf,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,wFAAwF;IACxF,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IAC5B,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CACzB;AAED,iFAAiF;AACjF,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,UAAU,iBAAiB;IACzB,GAAG,EAAE,IAAI,CAAA;IACT,QAAQ,EAAE,IAAI,CAAA;CACf;AAED,KAAK,gBAAgB,GACjB;IACE,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB,GACD;IACE,IAAI,EAAE,KAAK,CAAA;IACX,QAAQ,EAAE,WAAW,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CACvC,CAAA;AAEL,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAE9F,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,SAAS,GACT,UAAU,GACV,cAAc,GACd,SAAS,GACT,iBAAiB,GACjB,MAAM,GACN,kBAAkB,GAClB,WAAW,GACX,UAAU,GACV,YAAY,CAAA;AAEhB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,IAAI,CAAA;IACR,IAAI,EAAE,YAAY,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,4EAA4E;AAC5E,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;AAE3C,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAA;CACvB;AAED,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,2DAA2D;IAC3D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IACnD,kEAAkE;IAClE,SAAS,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAC/C,6EAA6E;IAC7E,gBAAgB,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IACpD;;;;;OAKG;IACH,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1E;;;;;;;OAOG;IACH,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9C;;;;;OAKG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9C;;;;OAIG;IACH,gBAAgB,CACd,KAAK,EAAE,IAAI,EACX,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IACvB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACxE;;;;;OAKG;IACH,SAAS,CACP,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,IAAI,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,QAAQ,GACf,OAAO,CAAC,OAAO,CAAC,CAAA;IACnB,oBAAoB;IACpB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IACjE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAC1C;;;;;;;OAOG;IACH,mBAAmB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IAC3C;;;;;;;OAOG;IACH,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC/D,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,oBAAoB;IACpB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IACnE;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACzD;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/dist/jobs/worker-status.d.ts

@@ -0,0 +1,27 @@
+import type { PrentaDB } from '../db/client-types.js';
+import type { JobWorkerSchedule, JobWorkerStatus } from './contract.js';
+import type { JobStore } from './types.js';
+/** Time one worker tick may spend running slices. */
+export declare const WORKER_BUDGET_MS = 20000;
+interface ScanSchedule {
+    type: JobWorkerSchedule['type'];
+    cron: string;
+    /** UTC day of the week, 0 = Sunday. Null runs every day. */
+    weekday: number | null;
+    hour: number;
+    minute: number;
+}
+/** The first time after `now` that a daily or weekly UTC schedule fires. */
+export declare function nextScheduledRun(schedule: Pick<ScanSchedule, 'weekday' | 'hour' | 'minute'>, now: Date): Date;
+/**
+ * Stamp a finished worker tick: when it started and how long it ran. A settings
+ * row, so no job or user is needed.
+ */
+export declare function recordWorkerTick(db: PrentaDB, tick: {
+    at: Date;
+    ms: number;
+}): Promise<void>;
+/** `GET /jobs/worker`: the worker strip on the Jobs screen. */
+export declare function getWorkerStatus(db: PrentaDB, store: JobStore, now: Date): Promise<JobWorkerStatus>;
+export {};
+//# sourceMappingURL=worker-status.d.ts.map

package/dist/jobs/worker-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-status.d.ts","sourceRoot":"","sources":["../../src/jobs/worker-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAM1C,qDAAqD;AACrD,eAAO,MAAM,gBAAgB,QAAS,CAAA;AAEtC,UAAU,YAAY;IACpB,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAQD,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC,EAC3D,GAAG,EAAE,IAAI,GACR,IAAI,CAeN;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,IAAI,CAAC,CAOf;AAWD,+DAA+D;AAC/D,wBAAsB,eAAe,CACnC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,eAAe,CAAC,CAsB1B"}

package/dist/jobs/worker-status.js

@@ -0,0 +1,66 @@
+/** `prenta_system_settings` key for the worker's last tick. */
+const WORKER_TICK_KEY = 'jobs.worker';
+/** The worker cron (`/cron/jobs`) runs once a minute. */
+const TICK_INTERVAL_MS = 60_000;
+/** Time one worker tick may spend running slices. */
+export const WORKER_BUDGET_MS = 20_000;
+/** The scan crons as create-prenta schedules them, in UTC. */
+const SCAN_SCHEDULES = [
+    { type: 'seo-scan', cron: '0 4 * * 1', weekday: 1, hour: 4, minute: 0 },
+    { type: 'content-health', cron: '30 2 * * *', weekday: null, hour: 2, minute: 30 },
+];
+/** The first time after `now` that a daily or weekly UTC schedule fires. */
+export function nextScheduledRun(schedule, now) {
+    const next = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate(), schedule.hour, schedule.minute));
+    if (next.getTime() <= now.getTime())
+        next.setUTCDate(next.getUTCDate() + 1);
+    while (schedule.weekday !== null && next.getUTCDay() !== schedule.weekday) {
+        next.setUTCDate(next.getUTCDate() + 1);
+    }
+    return next;
+}
+/**
+ * Stamp a finished worker tick: when it started and how long it ran. A settings
+ * row, so no job or user is needed.
+ */
+export async function recordWorkerTick(db, tick) {
+    const value = { lastTickAt: tick.at.toISOString(), lastTickMs: tick.ms };
+    await db.systemSetting.upsert({
+        where: { key: WORKER_TICK_KEY },
+        create: { key: WORKER_TICK_KEY, value },
+        update: { value },
+    });
+}
+async function readWorkerTick(db) {
+    const row = await db.systemSetting.findUnique({ where: { key: WORKER_TICK_KEY } });
+    const value = row?.value;
+    if (typeof value?.lastTickAt !== 'string')
+        return null;
+    const at = new Date(value.lastTickAt);
+    if (Number.isNaN(at.getTime()))
+        return null;
+    return { at, ms: typeof value.lastTickMs === 'number' ? value.lastTickMs : null };
+}
+/** `GET /jobs/worker`: the worker strip on the Jobs screen. */
+export async function getWorkerStatus(db, store, now) {
+    const [tick, schedules] = await Promise.all([
+        readWorkerTick(db),
+        Promise.all(SCAN_SCHEDULES.map(async (schedule) => {
+            const active = await store.findActive(schedule.type);
+            return {
+                type: schedule.type,
+                cron: schedule.cron,
+                nextAt: nextScheduledRun(schedule, now).toISOString(),
+                activeJobId: active?.id ?? null,
+            };
+        })),
+    ]);
+    return {
+        lastTickAt: tick?.at.toISOString() ?? null,
+        lastTickMs: tick?.ms ?? null,
+        nextTickAt: tick ? new Date(tick.at.getTime() + TICK_INTERVAL_MS).toISOString() : null,
+        budgetMs: WORKER_BUDGET_MS,
+        schedules,
+    };
+}
+//# sourceMappingURL=worker-status.js.map

package/dist/jobs/worker-status.js.map

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

package/dist/media/optimize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"optimize.d.ts","sourceRoot":"","sources":["../../src/media/optimize.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED,oFAAoF;AACpF,eAAO,MAAM,mCAAmC,QAAQ,CAAA;AACxD,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB,KAAK,CAAA;AACtC,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,KAAK,CAAA;AA+D5C;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GACvC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW7B;AAcD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,EACxC,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAyF7B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU;;;;;;;UAmB9E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD"}
+{"version":3,"file":"optimize.d.ts","sourceRoot":"","sources":["../../src/media/optimize.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED,oFAAoF;AACpF,eAAO,MAAM,mCAAmC,QAAQ,CAAA;AACxD,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB,KAAK,CAAA;AACtC,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,KAAK,CAAA;AA+D5C;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GACvC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW7B;AAcD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,EACxC,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CA2F7B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU;;;;;;;UAmB9E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD"}

package/dist/media/optimize.js

@@ -134,10 +134,12 @@ export async function optimizeImage(input, originalFilename, mimeType, opts = {}
         })
             .toBuffer();
     const optimizedSize = optimizedBuffer.length;
-    // If WebP is not smaller, keep the original bytes — no pointless re-encode.
+    // If lossy WebP is not smaller, keep the original bytes — no pointless
+    // re-encode. A requested lossless WebP is kept even when it grows: a JPEG
+    // screenshot would otherwise stay a JPEG, and the caller asked for WebP.
     // Still attach dimensions + blur so a later /optimize or backfill can heal
     // rows that were stored without metadata when sharp was missing.
-    if (optimizedSize >= originalSize) {
+    if (!useLossless && optimizedSize >= originalSize) {
         return {
             ...unchangedResult(inputBuffer, originalSize, mimeType, originalFilename, metadata.width ?? 0, metadata.height ?? 0),
             blurHash: await tryBlurHash(sharp, inputBuffer),