@prenta/core 8.9.2 → 8.10.0

package/dist/jobs/contract.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Jobs API shapes from the October 2026 handoff (docs/design/prenta/DATA_CONTRACTS.md §1).
+ *
+ * Storage keeps its own format (progress as `{completed,total,message}`, batch
+ * AI payloads as `items`). `serialize.ts` maps rows to these shapes at the
+ * edge. See CONFLICTS.md §4.
+ */
+import type { JobEventKind, JobStatus } from './types.js';
+export type { JobEventKind, JobStatus };
+export type JobType = 'seo-scan' | 'content-health' | 'batch-ai';
+export interface UserRef {
+    id: string;
+    name: string;
+    initials: string;
+}
+/** `createdBy` for a job a cron queued. */
+export interface CronRef {
+    kind: 'cron';
+    schedule: 'weekly-seo' | 'nightly-health';
+}
+export interface JobProgressView {
+    done: number;
+    total: number;
+    unit: 'pages' | 'documents';
+    /** Where the handler continues from: the scan offset, document cursor or batch index. */
+    cursor: string | null;
+    /** The stored count, the same as `done`. Kept for screens that read it. */
+    completed: number;
+    /** The stored progress note, such as "Scanned 40 of 120 pages". */
+    message?: string;
+}
+export interface BatchAiPayload {
+    operation: 'meta' | 'alt' | 'titles' | 'excerpt' | 'links' | 'custom';
+    instruction: string | null;
+    /** Post type key. */
+    source: string;
+    statusFilter: 'published' | 'all';
+    /** Resolved when queued, then never changed. */
+    documentIds: string[];
+    /** `auto` requires the admin role. */
+    review: 'review' | 'auto';
+    onApprove: 'draft' | 'publish';
+    /** Custom instruction only: the field it rewrites. Not in the kit's contract. */
+    field?: BatchAiTextField;
+}
+/** The document fields a custom instruction can rewrite. */
+export type BatchAiTextField = 'metaDescription' | 'seoTitle' | 'excerpt';
+/** Which documents a batch runs on, beyond `source` and `statusFilter`. */
+export interface BatchAiFilter {
+    /**
+     * Run on these documents (or images) only, as picked in a list's bulk
+     * actions. Without them, the operation's preset picks, such as "missing or
+     * over 160 characters".
+     */
+    documentIds?: string[];
+}
+/**
+ * Body of `POST /jobs/batch-ai` and `POST /jobs/batch-ai/preview`. The query of
+ * `GET /jobs/batch-ai/estimate` carries the same fields, with `documentIds`
+ * comma-separated.
+ */
+export type BatchAiRequest = Omit<BatchAiPayload, 'documentIds'> & {
+    filter?: BatchAiFilter;
+};
+export interface BatchAiEstimate {
+    count: number;
+    sample: {
+        title: string;
+        url: string;
+    }[];
+    /** About 900 per document. */
+    tokens: number;
+    /** About one per document. */
+    minutes: number;
+    /** Null when Settings → AI sets no monthly limit. */
+    pctOfMonthlyLimit: number | null;
+}
+export interface BatchAiPreviewItem {
+    documentId: string;
+    title: string;
+    after: string;
+}
+export interface ScanPayload {
+    trigger: 'cron' | 'manual';
+}
+export interface ScanResults {
+    score?: number;
+    prevScore?: number;
+    /** SEO: issues found. Content health: new issues. */
+    found: number;
+    /** SEO: issues fixed since the last scan. Content health: resolved issues. */
+    resolved: number;
+    categories: {
+        key: string;
+        label: string;
+        count: number;
+        href: string;
+    }[];
+    digest?: {
+        sentAt: string;
+        recipients: number;
+    } | null;
+}
+export interface Job {
+    id: string;
+    /** A {@link JobType}, or an unknown type the screen shows as a generic tile. */
+    type: string;
+    status: JobStatus;
+    title: string;
+    scope: string;
+    /** Next eligible run. While retrying, the end of the backoff. */
+    runAt: string;
+    /** Failures counted against `maxAttempts`. Yields don't count. */
+    attempts: number;
+    maxAttempts: number;
+    progress: JobProgressView;
+    /**
+     * One summary line. The detail sends the full message and stack (up to 4 KB),
+     * but only to a caller who could retry or cancel the job.
+     */
+    lastError: string | null;
+    explain: string | null;
+    summary: string | null;
+    lockedAt: string | null;
+    cancelRequestedAt: string | null;
+    cancelledBy: UserRef | null;
+    /** Null only for a job of an unknown type queued without a user. */
+    createdBy: UserRef | CronRef | null;
+    createdAt: string;
+    updatedAt: string;
+    finishedAt: string | null;
+    usage: {
+        tokensIn: number;
+        tokensOut: number;
+    };
+    /** Empty for an unknown type. */
+    payload: BatchAiPayload | ScanPayload | Record<string, never>;
+    /** Scans only, in the detail response. */
+    results?: ScanResults;
+    /** Batch AI only. Counted from the job's review items. */
+    review?: {
+        pending: number;
+        approved: number;
+        rejected: number;
+    };
+}
+export interface JobReviewItem {
+    id: string;
+    jobId: string;
+    documentId: string;
+    documentTitle: string;
+    url: string;
+    field: 'metaDescription' | 'altText' | 'seoTitle' | 'excerpt' | 'body' | (string & {});
+    before: string;
+    after: string;
+    editedAfter: string | null;
+    status: 'pending' | 'approved' | 'rejected';
+    decidedBy: UserRef | null;
+    decidedAt: string | null;
+    /** The document history revision created when the change was applied. */
+    appliedRevisionId: string | null;
+}
+export interface JobEvent {
+    at: string;
+    kind: JobEventKind;
+    message: string;
+    detail?: string;
+    durationMs?: number;
+    tokens?: number;
+}
+export interface JobWorkerSchedule {
+    type: 'seo-scan' | 'content-health';
+    cron: string;
+    nextAt: string;
+    /** The queued or running job of this type. "Run now" opens it instead of adding one. */
+    activeJobId: string | null;
+}
+export interface JobWorkerStatus {
+    /** Null until the worker has run once since 0026. */
+    lastTickAt: string | null;
+    lastTickMs: number | null;
+    nextTickAt: string | null;
+    budgetMs: number;
+    schedules: JobWorkerSchedule[];
+}
+//# sourceMappingURL=contract.d.ts.map

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

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

package/dist/jobs/contract.js

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

package/dist/jobs/contract.js.map

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

package/dist/jobs/error-text.d.ts

@@ -0,0 +1,23 @@
+/** How the queue records a thrown value. */
+export interface ErrorDescription {
+    /** For `lastError`: the message and stack, cut to 4 KB keeping the message's end. */
+    text: string;
+    /** For the job list and the activity log, taken from the uncut message. */
+    summary: string | null;
+}
+/**
+ * What the queue stores for a thrown value: its stack, which starts with the
+ * name and message, cut to 4 KB so the end of a long message (where Prisma puts
+ * the cause) survives. The summary comes from the uncut message.
+ */
+export declare function describeError(err: unknown): ErrorDescription;
+/** Cut a stored error string to 4 KB, keeping its start and its end. */
+export declare function clipError(text: string): string;
+/**
+ * One line that says what went wrong, or null when there is nothing to say.
+ * Stack frames and blank lines are skipped, so a message that starts with a
+ * newline still has a summary. For a Prisma error that is the last line,
+ * otherwise the first.
+ */
+export declare function errorSummary(text: string | null | undefined): string | null;
+//# sourceMappingURL=error-text.d.ts.map

package/dist/jobs/error-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-text.d.ts","sourceRoot":"","sources":["../../src/jobs/error-text.ts"],"names":[],"mappings":"AAeA,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAA;IACZ,2EAA2E;IAC3E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AA8DD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAM5D;AAED,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAS3E"}

package/dist/jobs/error-text.js

@@ -0,0 +1,110 @@
+/** DATA_CONTRACTS §1: `lastError` is the full message and stack, trimmed to 4 KB. */
+const LAST_ERROR_MAX = 4096;
+/** Stack frames keep at least this much room when a long message is cut. */
+const FRAMES_MIN = 1024;
+/** How much of a long message's end is kept, so the cause on its last lines survives. */
+const TAIL_MAX = 1024;
+const CUT_MARKER = '\n…\n';
+/** The one-line form in the job list and the activity log. */
+const SUMMARY_MAX = 300;
+/** V8 frames: `at fn (file:1:2)`, `at file:1:2`, `at <anonymous>`, `at async Promise.all (index 0)`. */
+const STACK_FRAME = /^at\s.*(:\d+(:\d+)?\)?|<anonymous>\)?|\(native\)|\(index \d+\))$/;
+/** Prisma prints the call site first and the cause on the last line. */
+const PRISMA_INVOCATION = /Invalid `[^`]+` invocation/;
+/** Whole lines from the start of `text`, up to `max` characters. */
+function leadingLines(text, max) {
+    if (text.length <= max)
+        return text;
+    const kept = [];
+    let length = 0;
+    for (const line of text.split('\n')) {
+        const next = length + (kept.length > 0 ? 1 : 0) + line.length;
+        if (next > max)
+            break;
+        kept.push(line);
+        length = next;
+    }
+    return kept.join('\n');
+}
+/** The start and the end of `text`, with a marker between, in `max` characters. */
+function headAndTail(text, max) {
+    if (text.length <= max)
+        return text;
+    const room = max - CUT_MARKER.length;
+    let tail = text.slice(-Math.min(TAIL_MAX, Math.floor(room / 2)));
+    // Start the tail on a whole line when there is one to start on.
+    const lineStart = tail.indexOf('\n');
+    if (lineStart >= 0 && lineStart < tail.length - 1)
+        tail = tail.slice(lineStart + 1);
+    return `${text.slice(0, room - tail.length)}${CUT_MARKER}${tail}`;
+}
+/**
+ * Fit a message and its stack frames into 4 KB. The frames get what the message
+ * leaves, but at least {@link FRAMES_MIN}. A message that is still too long
+ * keeps its start and its end.
+ */
+function fitError(message, frames) {
+    if (message.length + (frames ? frames.length + 1 : 0) <= LAST_ERROR_MAX) {
+        return frames ? `${message}\n${frames}` : message;
+    }
+    const keptFrames = frames
+        ? leadingLines(frames, Math.max(FRAMES_MIN, LAST_ERROR_MAX - message.length - 1))
+        : '';
+    const kept = headAndTail(message, LAST_ERROR_MAX - (keptFrames ? keptFrames.length + 1 : 0));
+    return keptFrames ? `${kept}\n${keptFrames}` : kept;
+}
+/** Split a thrown value into its name and message, and its stack frames. */
+function errorParts(err) {
+    if (!(err instanceof Error))
+        return { message: String(err), frames: '' };
+    const stack = typeof err.stack === 'string' ? err.stack : '';
+    if (!err.message) {
+        // The stack's first line is just the name.
+        const lineEnd = stack.indexOf('\n');
+        if (lineEnd < 0)
+            return { message: stack || err.name, frames: '' };
+        return { message: stack.slice(0, lineEnd), frames: stack.slice(lineEnd + 1) };
+    }
+    const at = stack.indexOf(err.message);
+    if (at >= 0) {
+        const end = at + err.message.length;
+        return { message: stack.slice(0, end), frames: stack.slice(end).replace(/^\n/, '') };
+    }
+    // No stack, or a message changed after the stack was formatted: keep both.
+    return { message: err.message, frames: stack };
+}
+/**
+ * What the queue stores for a thrown value: its stack, which starts with the
+ * name and message, cut to 4 KB so the end of a long message (where Prisma puts
+ * the cause) survives. The summary comes from the uncut message.
+ */
+export function describeError(err) {
+    const { message, frames } = errorParts(err);
+    return {
+        text: fitError(message, frames),
+        summary: errorSummary(frames ? `${message}\n${frames}` : message),
+    };
+}
+/** Cut a stored error string to 4 KB, keeping its start and its end. */
+export function clipError(text) {
+    return fitError(text, '');
+}
+/**
+ * One line that says what went wrong, or null when there is nothing to say.
+ * Stack frames and blank lines are skipped, so a message that starts with a
+ * newline still has a summary. For a Prisma error that is the last line,
+ * otherwise the first.
+ */
+export function errorSummary(text) {
+    if (!text)
+        return null;
+    const lines = text
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !STACK_FRAME.test(line));
+    const line = PRISMA_INVOCATION.test(text) ? lines.at(-1) : lines[0];
+    if (!line)
+        return null;
+    return line.length > SUMMARY_MAX ? `${line.slice(0, SUMMARY_MAX - 1)}…` : line;
+}
+//# sourceMappingURL=error-text.js.map

package/dist/jobs/error-text.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/jobs/handlers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAQrD,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,YAAY,CAAA;AAgBzD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAkG1E"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/jobs/handlers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAUrD,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,YAAY,CAAA;AAgBnE,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAwI1E"}

package/dist/jobs/handlers.js

@@ -1,8 +1,11 @@
-import { applyBatchAiItem, readBatchAiItem } from '../ai/batch-list.js';
+import { linkTargetLoader } from '../ai/batch-links.js';
+import { AiCapRefusal, applyBatchAiItem, readBatchAiItem } from '../ai/batch-list.js';
 import { processContentHealthScan, resolveUnseenContentIssues } from '../content-health/cron.js';
 import { getPrentaConfig } from '../config/runtime.js';
 import { maybeSendSeoDigest } from '../seo/digest.js';
 import { AUDIT_QUEUE_SLICE, frontEndContentCollectionTypes, runAuditSlice, sweepStaleAuditRuns, } from '../seo/audit-runner.js';
+import { contentHealthResults, seoScanResults } from './outcomes.js';
+import { recordReviewSuggestion } from './review.js';
 /** Documents per content-health slice. Small enough to finish inside the worker budget. */
 const CONTENT_HEALTH_SLICE = 25;
 function siteOrigin() {
@@ -15,6 +18,8 @@ function stringList(value) {
         : [];
 }
 export function createJobHandlers(db) {
+    // The pages a `links` batch can link to, shared by every slice for a few minutes.
+    const linkTargets = linkTargetLoader(db);
     return {
         'seo-scan': async (job) => {
             const skip = typeof job.payload.skip === 'number' ? job.payload.skip : 0;
@@ -45,13 +50,19 @@ export function createJobHandlers(db) {
                     payload: { ...job.payload, runId: slice.runId, skip: slice.pagesScanned },
                 };
             }
-            if (!slice.skipped)
-                await maybeSendSeoDigest(db).catch(() => ({ sent: false }));
-            return { done: true, progress };
+            // Another audit was already running, so this job has no run of its own to report.
+            if (slice.skipped)
+                return { done: true, progress };
+            // Rule 3: send the digest, then save the results, which record it. The
+            // queue writes the AI summary after the success is saved.
+            const digest = await maybeSendSeoDigest(db).catch(() => ({ sent: false }));
+            const results = await seoScanResults(db, slice.runId, digest, new Date());
+            return { done: true, progress, ...(results ? { results } : {}) };
         },
         'content-health': async (job) => {
             const seen = new Set(stringList(job.payload.seen));
             const scannedBefore = typeof job.payload.scanned === 'number' ? job.payload.scanned : 0;
+            const foundBefore = typeof job.payload.found === 'number' ? job.payload.found : 0;
             const cursor = typeof job.payload.cursor === 'string' ? job.payload.cursor : undefined;
             const result = await processContentHealthScan(db, {
                 maxDocuments: CONTENT_HEALTH_SLICE,
@@ -61,6 +72,7 @@ export function createJobHandlers(db) {
                 siteOrigin: siteOrigin(),
             });
             const scanned = scannedBefore + result.scanned;
+            const found = foundBefore + result.inserted;
             const progress = {
                 completed: scanned,
                 total: result.truncated ? scanned + 1 : scanned,
@@ -77,16 +89,19 @@ export function createJobHandlers(db) {
                         cursor: result.cursor,
                         seen: result.seenKeys,
                         scanned,
+                        found,
                     },
                 };
             }
             const resolved = await resolveUnseenContentIssues(db, result.seenKeys);
+            const results = await contentHealthResults(db, { found, resolved });
             return {
                 done: true,
                 progress: {
                     ...progress,
                     message: `Scanned ${scanned} documents, resolved ${resolved}`,
                 },
+                ...(results ? { results } : {}),
             };
         },
         'batch-ai': async (job) => {
@@ -99,8 +114,33 @@ export function createJobHandlers(db) {
                 };
             }
             const current = readBatchAiItem(items[index]);
-            if (current)
-                await applyBatchAiItem(db, current);
+            let usage;
+            if (current) {
+                try {
+                    // Review mode stores a suggestion; anything else (including rows queued
+                    // by /ai/batch, which have no mode) writes the document now.
+                    const options = {
+                        field: typeof job.payload.field === 'string' ? job.payload.field : null,
+                        instruction: typeof job.payload.instruction === 'string' ? job.payload.instruction : null,
+                        linkTargets,
+                    };
+                    usage =
+                        job.payload.review === 'review'
+                            ? await recordReviewSuggestion(db, job.id, current, options)
+                            : (await applyBatchAiItem(db, current, options)).usage;
+                }
+                catch (err) {
+                    if (!(err instanceof AiCapRefusal))
+                        throw err;
+                    // A spent cap isn't a failure: wait for it to reset, then retry this document.
+                    return {
+                        done: false,
+                        progress: { completed: index, total: items.length, message: err.message },
+                        wait: { until: err.resetsAt, reason: err.message },
+                        usage: err.usage,
+                    };
+                }
+            }
             const next = index + 1;
             const progress = {
                 completed: next,
@@ -108,11 +148,12 @@ export function createJobHandlers(db) {
                 message: `Processed ${next} of ${items.length}`,
             };
             if (next >= items.length)
-                return { done: true, progress };
+                return { done: true, progress, usage };
             return {
                 done: false,
                 progress,
                 payload: { ...job.payload, index: next },
+                usage,
             };
         },
     };

package/dist/jobs/handlers.js.map

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

package/dist/jobs/memory-store.d.ts

@@ -1,13 +1,37 @@
-import type { JobRecord, JobStore } from './types.js';
+import type { JobEventRecord, JobListFilter, JobNote, JobRecord, JobStore, JobUsage, PruneLimit } from './types.js';
 /** In-process store for the queue tests. Production uses {@link PrismaJobStore}. */
 export declare class MemoryJobStore implements JobStore {
+    private readonly reviewItems;
     private readonly jobs;
+    private readonly events;
+    /**
+     * @param reviewItems The live `job_review_items` rows (`jobId`, `status`,
+     *   `decidedAt`) of a test that drives review items, so retention keeps a
+     *   job for them like the Prisma store does, and deletes them with it.
+     */
+    constructor(reviewItems?: () => Array<Record<string, unknown>>);
     insert(job: JobRecord): Promise<void>;
     findActive(type: string): Promise<JobRecord | null>;
     claimNext(now: Date): Promise<JobRecord | null>;
     findStaleRunning(cutoff: Date): Promise<JobRecord[]>;
+    /** Keeps the stored cancel fields and creator, like {@link PrismaJobStore.save}. */
     save(job: JobRecord): Promise<void>;
-    list(limit: number): Promise<JobRecord[]>;
+    requestCancel(id: string, at: Date, byId: string | null): Promise<boolean>;
+    finishCancel(job: JobRecord): Promise<boolean>;
+    findPendingNotes(since: Date, summaryTypes: readonly string[], limit: number): Promise<JobRecord[]>;
+    claimNote(id: string, note: JobNote, finishedAt: Date): Promise<boolean>;
+    writeNote(id: string, note: JobNote, finishedAt: Date, text: string, usage?: JobUsage): Promise<boolean>;
+    retry(id: string, now: Date): Promise<boolean>;
+    get(id: string): Promise<JobRecord | null>;
+    findCancelRequested(): Promise<JobRecord[]>;
+    pruneFinished(cutoff: Date, limit: PruneLimit): Promise<number>;
+    list(limit: number, filter?: JobListFilter): Promise<JobRecord[]>;
+    addEvent(event: JobEventRecord): Promise<void>;
+    listEvents(jobId: string, limit: number): Promise<JobEventRecord[]>;
+    trimEvents(jobId: string, keep: number): Promise<number>;
+    private removeEvents;
+    /** The stored job if it is still the finish a note belongs to. */
+    private sameFinish;
     private clone;
 }
 //# sourceMappingURL=memory-store.d.ts.map

package/dist/jobs/memory-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/jobs/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErD,oFAAoF;AACpF,qBAAa,cAAe,YAAW,QAAQ;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IAE9C,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IASnD,SAAS,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAe/C,gBAAgB,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAWpD,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAO/C,OAAO,CAAC,KAAK;CAWd"}
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/jobs/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,OAAO,EACP,SAAS,EAET,QAAQ,EACR,QAAQ,EACR,UAAU,EACX,MAAM,YAAY,CAAA;AAKnB,oFAAoF;AACpF,qBAAa,cAAe,YAAW,QAAQ;IASjC,OAAO,CAAC,QAAQ,CAAC,WAAW;IARxC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAE9C;;;;OAIG;gBAC0B,WAAW,GAAE,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAY;IAEnF,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IASnD,SAAS,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAe/C,gBAAgB,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAW1D,oFAAoF;IAC9E,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnC,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAU1E,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAS9C,gBAAgB,CACpB,KAAK,EAAE,IAAI,EACX,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,EAAE,CAAC;IAajB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAOxE,SAAS,CACb,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;IAYb,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB9C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAK1C,mBAAmB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAM3C,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAoC/D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IASrE,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAQnE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO9D,OAAO,CAAC,YAAY;IAKpB,kEAAkE;IAClE,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,KAAK;CAad"}