@prenta/core 8.0.0 → 8.1.0

package/dist/jobs/seo-scan-tick.js

@@ -0,0 +1,41 @@
+import { AuditAlreadyRunningError, frontEndContentCollectionTypes, runAndPersistAudit, sweepStaleAuditRuns, } from '../seo/audit-runner.js';
+import { maybeSendSeoDigest } from '../seo/digest.js';
+import { getPrentaConfig } from '../config/runtime.js';
+/**
+ * One SEO audit + digest attempt. Failures stay in the result so a retry
+ * policy can see them, and a thrown audit error does not discard the digest.
+ */
+export async function runSeoScanTick(db) {
+    let swept = 0;
+    try {
+        swept = await sweepStaleAuditRuns(db);
+    }
+    catch {
+        // Sweep is best-effort hygiene — never blocks the audit.
+    }
+    let audit;
+    try {
+        const collectionTypes = frontEndContentCollectionTypes(getPrentaConfig());
+        const run = await runAndPersistAudit(db, { startedById: null, collectionTypes });
+        audit = {
+            runId: run.id,
+            status: run.status,
+            siteScore: run.siteScoreAfter,
+            issuesFound: run.issuesFound,
+            pagesScanned: run.pagesScanned,
+        };
+    }
+    catch (err) {
+        const message = String(err instanceof Error ? err.message : err);
+        audit = err instanceof AuditAlreadyRunningError ? { skipped: message } : { error: message };
+    }
+    let digest;
+    try {
+        digest = await maybeSendSeoDigest(db);
+    }
+    catch (err) {
+        digest = { sent: false, error: String(err instanceof Error ? err.message : err) };
+    }
+    return { swept, audit, digest };
+}
+//# sourceMappingURL=seo-scan-tick.js.map

package/dist/jobs/seo-scan-tick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-scan-tick.js","sourceRoot":"","sources":["../../src/jobs/seo-scan-tick.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,kBAAkB,EAAyB,MAAM,kBAAkB,CAAA;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAGtD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EAAY;IAK/C,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,mBAAmB,CAAC,EAAE,CAAC,CAAA;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;IAED,IAAI,KAA8B,CAAA;IAClC,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,8BAA8B,CAAC,eAAe,EAAE,CAAC,CAAA;QACzE,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAA;QAChF,KAAK,GAAG;YACN,KAAK,EAAE,GAAG,CAAC,EAAE;YACb,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,SAAS,EAAE,GAAG,CAAC,cAAc;YAC7B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,YAAY,EAAE,GAAG,CAAC,YAAY;SAC/B,CAAA;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAChE,KAAK,GAAG,GAAG,YAAY,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;IAC7F,CAAC;IAED,IAAI,MAAwB,CAAA;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,kBAAkB,CAAC,EAAE,CAAC,CAAA;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAA;IACnF,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;AACjC,CAAC"}

package/dist/jobs/types.d.ts

@@ -0,0 +1,52 @@
+export type JobStatus = 'queued' | 'running' | 'succeeded' | 'dead';
+export interface JobProgress {
+    completed: number;
+    total: number;
+    message?: string;
+}
+export interface JobRecord {
+    id: string;
+    type: string;
+    payload: Record<string, unknown>;
+    status: JobStatus;
+    attempts: number;
+    maxAttempts: number;
+    runAt: Date;
+    lockedAt: Date | null;
+    lastError: string | null;
+    progress: JobProgress;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface JobHandlerContext {
+    now: Date;
+    deadline: Date;
+}
+type JobHandlerResult = {
+    done: true;
+    progress?: JobProgress;
+} | {
+    done: false;
+    progress: JobProgress;
+    payload?: Record<string, unknown>;
+};
+export type JobHandler = (job: JobRecord, ctx: JobHandlerContext) => Promise<JobHandlerResult>;
+export interface JobStore {
+    insert(job: JobRecord): Promise<void>;
+    /** A queued or running job of this type, if one exists. */
+    findActive(type: string): Promise<JobRecord | null>;
+    /** Oldest queued job whose runAt has passed. Marks it running. */
+    claimNext(now: Date): Promise<JobRecord | null>;
+    /** Running jobs locked before `cutoff` (the worker was killed mid-slice). */
+    findStaleRunning(cutoff: Date): Promise<JobRecord[]>;
+    save(job: JobRecord): Promise<void>;
+    list(limit: number): Promise<JobRecord[]>;
+}
+export interface QueueTickResult {
+    succeeded: number;
+    continued: number;
+    retried: number;
+    dead: number;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/dist/jobs/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/jobs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/jobs/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prenta/core",
-  "version": "8.0.0",
+  "version": "8.1.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/prisma/migrations/0022_jobs/migration.sql

@@ -0,0 +1,20 @@
+-- Job queue for SEO audit, content health, and batch AI (#444).
+
+CREATE TABLE "prenta_jobs" (
+    "id" TEXT NOT NULL,
+    "type" TEXT NOT NULL,
+    "payload" JSONB NOT NULL,
+    "status" TEXT NOT NULL,
+    "attempts" INTEGER NOT NULL DEFAULT 0,
+    "maxAttempts" INTEGER NOT NULL DEFAULT 3,
+    "runAt" TIMESTAMP(3) NOT NULL,
+    "lockedAt" TIMESTAMP(3),
+    "lastError" TEXT,
+    "progress" JSONB NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "prenta_jobs_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX "prenta_jobs_status_runAt_idx" ON "prenta_jobs"("status", "runAt");

package/prisma/schema.prisma

@@ -1116,3 +1116,25 @@ model DocumentNotification {
   @@index([commentId])
   @@map("prenta_document_notifications")
 }
+
+/// Background work for SEO audit, content health, and batch AI.
+/// `status` is queued | running | succeeded | dead. A dead row is the
+/// dead-letter: it is not claimed again. Ids are minted by the queue so a
+/// stub database that ignores `create` still returns a job id.
+model Job {
+  id          String    @id
+  type        String
+  payload     Json
+  status      String
+  attempts    Int       @default(0)
+  maxAttempts Int       @default(3)
+  runAt       DateTime
+  lockedAt    DateTime?
+  lastError   String?
+  progress    Json
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
+
+  @@index([status, runAt])
+  @@map("prenta_jobs")
+}