@happyvertical/smrt-jobs 0.30.0

package/dist/svelte/types.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Types for background job UI components
+ */
+import type { Snippet } from 'svelte';
+export type JobStatus = 'pending' | 'ready' | 'running' | 'completed' | 'failed' | 'cancelled';
+export type JobPriority = 'low' | 'normal' | 'high' | 'critical';
+export type TimeoutBehavior = 'fail' | 'kill' | 'warn';
+/**
+ * Job data structure for display
+ */
+export interface JobData {
+    id: string;
+    queue: string;
+    objectType: string;
+    objectId: string | null;
+    method: string;
+    args: Record<string, unknown>;
+    status: JobStatus;
+    priority: number;
+    attempts: number;
+    maxAttempts: number;
+    timeout: number;
+    timeoutBehavior: TimeoutBehavior;
+    runAt: Date | string;
+    startedAt: Date | string | null;
+    completedAt: Date | string | null;
+    lastError: string | null;
+    resultPointer: string | null;
+    workerId: string | null;
+    createdAt: Date | string;
+    updatedAt: Date | string;
+}
+/**
+ * Job statistics for dashboard
+ */
+export interface JobStats {
+    total: number;
+    pending: number;
+    ready: number;
+    running: number;
+    completed: number;
+    failed: number;
+    cancelled: number;
+    avgDuration: number | null;
+    successRate: number | null;
+}
+/**
+ * Queue statistics
+ */
+export interface QueueStats {
+    name: string;
+    pending: number;
+    running: number;
+    completed24h: number;
+    failed24h: number;
+    avgDuration: number | null;
+}
+/**
+ * Filter options for job list
+ */
+export interface JobFilter {
+    status?: JobStatus | JobStatus[] | 'all';
+    queue?: string;
+    objectType?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Sort options for job list
+ */
+export interface JobSort {
+    field: 'createdAt' | 'runAt' | 'priority' | 'status';
+    direction: 'asc' | 'desc';
+}
+/**
+ * JobList component props
+ */
+export interface JobListProps {
+    /** Jobs to display */
+    jobs: JobData[];
+    /** Loading state */
+    loading?: boolean;
+    /** Filter state */
+    filter?: JobFilter;
+    /** Sort state */
+    sort?: JobSort;
+    /** Selectable rows */
+    selectable?: boolean;
+    /** Selected job IDs */
+    selected?: Set<string>;
+    /** Callback when selection changes */
+    onSelectionChange?: (selected: Set<string>) => void;
+    /** Callback when job is clicked */
+    onJobClick?: (job: JobData) => void;
+    /** Callback when retry is clicked */
+    onRetry?: (job: JobData) => void;
+    /** Callback when cancel is clicked */
+    onCancel?: (job: JobData) => void;
+    /** Empty state snippet */
+    empty?: Snippet;
+}
+/**
+ * JobDetail component props
+ */
+export interface JobDetailProps {
+    /** Job to display */
+    job: JobData;
+    /** Show result data */
+    showResult?: boolean;
+    /** Callback when retry is clicked */
+    onRetry?: (job: JobData) => void;
+    /** Callback when cancel is clicked */
+    onCancel?: (job: JobData) => void;
+    /** Callback when delete is clicked */
+    onDelete?: (job: JobData) => void;
+}
+/**
+ * JobStats component props
+ */
+export interface JobStatsProps {
+    /** Statistics data */
+    stats: JobStats;
+    /** Queue breakdown */
+    queues?: QueueStats[];
+    /** Loading state */
+    loading?: boolean;
+    /** Auto-refresh interval (ms, 0 = disabled) */
+    refreshInterval?: number;
+}
+/**
+ * JobActions component props
+ */
+export interface JobActionsProps {
+    /** Job to perform actions on */
+    job: JobData;
+    /** Show retry button */
+    showRetry?: boolean;
+    /** Show cancel button */
+    showCancel?: boolean;
+    /** Show delete button */
+    showDelete?: boolean;
+    /** Callback when retry is clicked */
+    onRetry?: (job: JobData) => void;
+    /** Callback when cancel is clicked */
+    onCancel?: (job: JobData) => void;
+    /** Callback when delete is clicked */
+    onDelete?: (job: JobData) => void;
+    /** Compact mode */
+    compact?: boolean;
+}
+/**
+ * JobDashboard component props
+ */
+export interface JobDashboardProps {
+    /** Statistics data */
+    stats: JobStats;
+    /** Queue breakdown */
+    queues?: QueueStats[];
+    /** Recent jobs */
+    recentJobs?: JobData[];
+    /** Failed jobs */
+    failedJobs?: JobData[];
+    /** Loading state */
+    loading?: boolean;
+    /** Callback when job is clicked */
+    onJobClick?: (job: JobData) => void;
+    /** Callback when retry is clicked */
+    onRetry?: (job: JobData) => void;
+}
+/**
+ * Helper function to get status variant for Badge
+ */
+export declare function getStatusVariant(status: JobStatus): 'default' | 'primary' | 'success' | 'warning' | 'error' | 'info';
+/**
+ * Helper function to format duration
+ */
+export declare function formatDuration(ms: number | null): string;
+/**
+ * Helper function to format relative time
+ */
+export declare function formatRelativeTime(date: Date | string | null): string;
+/**
+ * Helper function to get priority label
+ */
+export declare function getPriorityLabel(priority: number): string;
+/**
+ * Helper function to get priority color class
+ */
+export declare function getPriorityClass(priority: number): string;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/svelte/types.js

@@ -0,0 +1,87 @@
+/**
+ * Helper function to get status variant for Badge
+ */
+export function getStatusVariant(status) {
+    switch (status) {
+        case 'pending':
+            return 'default';
+        case 'ready':
+            return 'info';
+        case 'running':
+            return 'primary';
+        case 'completed':
+            return 'success';
+        case 'failed':
+            return 'error';
+        case 'cancelled':
+            return 'warning';
+        default:
+            return 'default';
+    }
+}
+/**
+ * Helper function to format duration
+ */
+export function formatDuration(ms) {
+    if (ms === null || ms === undefined)
+        return '-';
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    if (ms < 3600000)
+        return `${(ms / 60000).toFixed(1)}m`;
+    return `${(ms / 3600000).toFixed(1)}h`;
+}
+/**
+ * Helper function to format relative time
+ */
+export function formatRelativeTime(date) {
+    if (!date)
+        return '-';
+    const d = typeof date === 'string' ? new Date(date) : date;
+    const now = new Date();
+    const diff = now.getTime() - d.getTime();
+    if (diff < 0) {
+        // Future
+        const absDiff = Math.abs(diff);
+        if (absDiff < 60000)
+            return 'in a moment';
+        if (absDiff < 3600000)
+            return `in ${Math.round(absDiff / 60000)}m`;
+        if (absDiff < 86400000)
+            return `in ${Math.round(absDiff / 3600000)}h`;
+        return `in ${Math.round(absDiff / 86400000)}d`;
+    }
+    if (diff < 60000)
+        return 'just now';
+    if (diff < 3600000)
+        return `${Math.round(diff / 60000)}m ago`;
+    if (diff < 86400000)
+        return `${Math.round(diff / 3600000)}h ago`;
+    return `${Math.round(diff / 86400000)}d ago`;
+}
+/**
+ * Helper function to get priority label
+ */
+export function getPriorityLabel(priority) {
+    if (priority >= 90)
+        return 'Critical';
+    if (priority >= 75)
+        return 'High';
+    if (priority >= 25)
+        return 'Normal';
+    return 'Low';
+}
+/**
+ * Helper function to get priority color class
+ */
+export function getPriorityClass(priority) {
+    if (priority >= 90)
+        return 'priority-critical';
+    if (priority >= 75)
+        return 'priority-high';
+    if (priority >= 25)
+        return 'priority-normal';
+    return 'priority-low';
+}

package/dist/ui.d.ts

@@ -0,0 +1,10 @@
+import { ModuleUISlot, SmrtModuleMeta } from '@happyvertical/smrt-types';
+/**
+ * Jobs module UI slots
+ */
+export declare const JOBS_UI_SLOTS: Record<string, ModuleUISlot>;
+/**
+ * Jobs module metadata
+ */
+export declare const JOBS_MODULE_META: SmrtModuleMeta;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAuDtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAO9B,CAAC"}

package/dist/ui.js

@@ -0,0 +1,69 @@
+const JOBS_UI_SLOTS = {
+  "job-dashboard": {
+    id: "job-dashboard",
+    label: "Job Dashboard",
+    description: "Combined overview panel for background jobs",
+    icon: "briefcase",
+    category: "admin",
+    order: 1,
+    propsInterface: "JobDashboardProps"
+  },
+  "job-list": {
+    id: "job-list",
+    label: "Job List",
+    description: "Filterable, sortable list of background jobs",
+    icon: "list",
+    category: "list",
+    order: 2,
+    propsInterface: "JobListProps"
+  },
+  "job-detail": {
+    id: "job-detail",
+    label: "Job Detail",
+    description: "Detailed view of a single job",
+    icon: "file-text",
+    category: "detail",
+    order: 3,
+    propsInterface: "JobDetailProps"
+  },
+  "job-stats": {
+    id: "job-stats",
+    label: "Job Stats",
+    description: "Statistics dashboard for job queues",
+    icon: "bar-chart",
+    category: "display",
+    order: 4,
+    propsInterface: "JobStatsProps"
+  },
+  "job-actions": {
+    id: "job-actions",
+    label: "Job Actions",
+    description: "Action buttons for job operations",
+    icon: "more-horizontal",
+    category: "action",
+    order: 5,
+    propsInterface: "JobActionsProps"
+  },
+  "job-status-badge": {
+    id: "job-status-badge",
+    label: "Job Status Badge",
+    description: "Status indicator for job states",
+    icon: "tag",
+    category: "display",
+    order: 6,
+    propsInterface: "JobStatusBadgeProps"
+  }
+};
+const JOBS_MODULE_META = {
+  name: "@happyvertical/smrt-jobs",
+  displayName: "Jobs",
+  description: "Background job processing with persistence and scheduling",
+  uiSlots: JOBS_UI_SLOTS,
+  models: ["Job", "JobQueue"],
+  collections: ["JobCollection", "JobQueueCollection"]
+};
+export {
+  JOBS_MODULE_META,
+  JOBS_UI_SLOTS
+};
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sources":["../src/ui.ts"],"sourcesContent":["/**\n * Jobs Module UI Slot Declarations\n *\n * This file defines the UI extension points for the jobs module.\n * UI components are implemented in the ./svelte subpath.\n */\n\nimport type { ModuleUISlot, SmrtModuleMeta } from '@happyvertical/smrt-types';\n\n/**\n * Jobs module UI slots\n */\nexport const JOBS_UI_SLOTS: Record<string, ModuleUISlot> = {\n  'job-dashboard': {\n    id: 'job-dashboard',\n    label: 'Job Dashboard',\n    description: 'Combined overview panel for background jobs',\n    icon: 'briefcase',\n    category: 'admin',\n    order: 1,\n    propsInterface: 'JobDashboardProps',\n  },\n  'job-list': {\n    id: 'job-list',\n    label: 'Job List',\n    description: 'Filterable, sortable list of background jobs',\n    icon: 'list',\n    category: 'list',\n    order: 2,\n    propsInterface: 'JobListProps',\n  },\n  'job-detail': {\n    id: 'job-detail',\n    label: 'Job Detail',\n    description: 'Detailed view of a single job',\n    icon: 'file-text',\n    category: 'detail',\n    order: 3,\n    propsInterface: 'JobDetailProps',\n  },\n  'job-stats': {\n    id: 'job-stats',\n    label: 'Job Stats',\n    description: 'Statistics dashboard for job queues',\n    icon: 'bar-chart',\n    category: 'display',\n    order: 4,\n    propsInterface: 'JobStatsProps',\n  },\n  'job-actions': {\n    id: 'job-actions',\n    label: 'Job Actions',\n    description: 'Action buttons for job operations',\n    icon: 'more-horizontal',\n    category: 'action',\n    order: 5,\n    propsInterface: 'JobActionsProps',\n  },\n  'job-status-badge': {\n    id: 'job-status-badge',\n    label: 'Job Status Badge',\n    description: 'Status indicator for job states',\n    icon: 'tag',\n    category: 'display',\n    order: 6,\n    propsInterface: 'JobStatusBadgeProps',\n  },\n};\n\n/**\n * Jobs module metadata\n */\nexport const JOBS_MODULE_META: SmrtModuleMeta = {\n  name: '@happyvertical/smrt-jobs',\n  displayName: 'Jobs',\n  description: 'Background job processing with persistence and scheduling',\n  uiSlots: JOBS_UI_SLOTS,\n  models: ['Job', 'JobQueue'],\n  collections: ['JobCollection', 'JobQueueCollection'],\n};\n"],"names":[],"mappings":"AAYO,MAAM,gBAA8C;AAAA,EACzD,iBAAiB;AAAA,IACf,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,IACN,UAAU;AAAA,IACV,OAAO;AAAA,IACP,gBAAgB;AAAA,EAAA;AAAA,EAElB,YAAY;AAAA,IACV,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,IACN,UAAU;AAAA,IACV,OAAO;AAAA,IACP,gBAAgB;AAAA,EAAA;AAAA,EAElB,cAAc;AAAA,IACZ,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,IACN,UAAU;AAAA,IACV,OAAO;AAAA,IACP,gBAAgB;AAAA,EAAA;AAAA,EAElB,aAAa;AAAA,IACX,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,IACN,UAAU;AAAA,IACV,OAAO;AAAA,IACP,gBAAgB;AAAA,EAAA;AAAA,EAElB,eAAe;AAAA,IACb,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,IACN,UAAU;AAAA,IACV,OAAO;AAAA,IACP,gBAAgB;AAAA,EAAA;AAAA,EAElB,oBAAoB;AAAA,IAClB,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,IACN,UAAU;AAAA,IACV,OAAO;AAAA,IACP,gBAAgB;AAAA,EAAA;AAEpB;AAKO,MAAM,mBAAmC;AAAA,EAC9C,MAAM;AAAA,EACN,aAAa;AAAA,EACb,aAAa;AAAA,EACb,SAAS;AAAA,EACT,QAAQ,CAAC,OAAO,UAAU;AAAA,EAC1B,aAAa,CAAC,iBAAiB,oBAAoB;AACrD;"}

package/dist/worker-liveness-thread.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker-liveness-thread.d.ts.map

package/dist/worker-liveness-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-liveness-thread.d.ts","sourceRoot":"","sources":["../src/worker-liveness-thread.ts"],"names":[],"mappings":""}

package/dist/worker-liveness-thread.js

@@ -0,0 +1,66 @@
+import { parentPort, workerData } from "node:worker_threads";
+import { getDatabase } from "@happyvertical/sql";
+import { t as tuneSqliteForConcurrency } from "./chunks/worker-liveness-DOTjoIjr.js";
+async function runLivenessTicker(options) {
+  const db = await getDatabase({
+    url: options.url,
+    type: options.type
+  });
+  const looksSqlite = (options.type ?? "").toLowerCase() === "sqlite" || !options.type && /^file:|\.(db|sqlite)\b|:memory:/i.test(options.url);
+  if (looksSqlite) await tuneSqliteForConcurrency(db);
+  const renew = async () => {
+    const now = /* @__PURE__ */ new Date();
+    const expiresAt = new Date(
+      now.getTime() + options.leaseTtlMs
+    ).toISOString();
+    await db.query(
+      `UPDATE _smrt_workers
+          SET lease_expires_at = ?,
+              heartbeat_at = ?
+        WHERE worker_id = ?`,
+      expiresAt,
+      now.toISOString(),
+      options.workerKey
+    );
+  };
+  try {
+    await renew();
+  } catch (error) {
+    await db.close?.().catch(() => {
+    });
+    throw error;
+  }
+  const timer = setInterval(() => {
+    renew().catch(() => {
+    });
+  }, options.leaseTickMs);
+  let stopped = false;
+  return {
+    stop: async () => {
+      if (stopped) return;
+      stopped = true;
+      clearInterval(timer);
+      try {
+        await db.close?.();
+      } catch {
+      }
+    }
+  };
+}
+async function main() {
+  const ticker = await runLivenessTicker(workerData);
+  parentPort?.on("message", async (message) => {
+    if (message === "stop") {
+      await ticker.stop();
+      parentPort?.postMessage("stopped");
+    }
+  });
+  parentPort?.postMessage("ready");
+}
+main().catch((error) => {
+  parentPort?.postMessage({
+    type: "error",
+    message: error instanceof Error ? error.message : String(error)
+  });
+});
+//# sourceMappingURL=worker-liveness-thread.js.map

package/dist/worker-liveness-thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-liveness-thread.js","sources":["../src/worker-liveness-ticker.ts","../src/worker-liveness-thread.ts"],"sourcesContent":["import { getDatabase } from '@happyvertical/sql';\nimport { tuneSqliteForConcurrency } from './worker-liveness.js';\n\n/**\n * Configuration for an off-loop liveness ticker (passed via `workerData`).\n */\nexport interface LivenessTickerOptions {\n  /** Database URL the owning runner is using. */\n  url: string;\n  /** Optional explicit engine/type hint. */\n  type?: string;\n  /** This runner incarnation's worker key (the `_smrt_workers.worker_id`). */\n  workerKey: string;\n  /** Lease time-to-live in milliseconds. */\n  leaseTtlMs: number;\n  /** Renewal cadence in milliseconds. */\n  leaseTickMs: number;\n}\n\nexport interface LivenessTicker {\n  /** Stop renewing and close the connection. */\n  stop: () => Promise<void>;\n}\n\n/**\n * Renew a worker's liveness lease from *outside* the handler event loop.\n *\n * Runs on a `node:worker_threads` thread (or, in tests, directly) with its own\n * database connection, so a CPU-bound synchronous handler on the main thread\n * cannot starve the renewal — the failure mode that made the old heartbeat\n * false-recover running jobs (#1474). A dead process stops renewing and the\n * lease expires within its TTL, which is how recovery detects death.\n */\nexport async function runLivenessTicker(\n  options: LivenessTickerOptions,\n): Promise<LivenessTicker> {\n  const db = await getDatabase({\n    url: options.url,\n    type: options.type as 'sqlite' | 'postgres' | 'duckdb' | undefined,\n  });\n\n  // The ticker's connection shares the SQLite file with the runner's main\n  // connection; enable WAL + a busy timeout so renewals don't lose a lock race.\n  const looksSqlite =\n    (options.type ?? '').toLowerCase() === 'sqlite' ||\n    (!options.type && /^file:|\\.(db|sqlite)\\b|:memory:/i.test(options.url));\n  if (looksSqlite) await tuneSqliteForConcurrency(db);\n\n  const renew = async (): Promise<void> => {\n    const now = new Date();\n    const expiresAt = new Date(\n      now.getTime() + options.leaseTtlMs,\n    ).toISOString();\n    await db.query(\n      `UPDATE _smrt_workers\n          SET lease_expires_at = ?,\n              heartbeat_at = ?\n        WHERE worker_id = ?`,\n      expiresAt,\n      now.toISOString(),\n      options.workerKey,\n    );\n  };\n\n  try {\n    // Renew immediately so the lease is fresh the moment the ticker starts.\n    await renew();\n  } catch (error) {\n    // Don't leak the connection if the very first renewal fails.\n    await db.close?.().catch(() => {});\n    throw error;\n  }\n\n  const timer = setInterval(() => {\n    renew().catch(() => {\n      // Transient renewal failures are tolerated; the next tick retries and\n      // the lease TTL absorbs a missed beat (TTL >= 3x tick).\n    });\n  }, options.leaseTickMs);\n\n  let stopped = false;\n  return {\n    stop: async () => {\n      if (stopped) return;\n      stopped = true;\n      clearInterval(timer);\n      try {\n        await db.close?.();\n      } catch {\n        // Best-effort connection teardown.\n      }\n    },\n  };\n}\n","/**\n * Worker-thread entry for the off-loop liveness ticker.\n *\n * Thin shell: read {@link LivenessTickerOptions} from `workerData`, start the\n * ticker, and stop it on a `'stop'` message from the parent. All real logic\n * lives in {@link runLivenessTicker} so it can be unit-tested without spawning\n * a thread. Keep this file decorator-free so Node type-stripping can run the\n * `.ts` directly under vitest.\n */\nimport { parentPort, workerData } from 'node:worker_threads';\nimport {\n  type LivenessTickerOptions,\n  runLivenessTicker,\n} from './worker-liveness-ticker.js';\n\nasync function main(): Promise<void> {\n  const ticker = await runLivenessTicker(workerData as LivenessTickerOptions);\n\n  parentPort?.on('message', async (message) => {\n    if (message === 'stop') {\n      await ticker.stop();\n      parentPort?.postMessage('stopped');\n    }\n  });\n\n  // Signal the parent that the lease is seeded and renewal is running.\n  parentPort?.postMessage('ready');\n}\n\nmain().catch((error) => {\n  // Surface startup failure to the parent so the runner can fall back to\n  // main-loop renewal rather than silently losing its lease.\n  parentPort?.postMessage({\n    type: 'error',\n    message: error instanceof Error ? error.message : String(error),\n  });\n});\n"],"names":[],"mappings":";;;AAiCA,eAAsB,kBACpB,SACyB;AACzB,QAAM,KAAK,MAAM,YAAY;AAAA,IAC3B,KAAK,QAAQ;AAAA,IACb,MAAM,QAAQ;AAAA,EAAA,CACf;AAID,QAAM,eACH,QAAQ,QAAQ,IAAI,YAAA,MAAkB,YACtC,CAAC,QAAQ,QAAQ,mCAAmC,KAAK,QAAQ,GAAG;AACvE,MAAI,YAAa,OAAM,yBAAyB,EAAE;AAElD,QAAM,QAAQ,YAA2B;AACvC,UAAM,0BAAU,KAAA;AAChB,UAAM,YAAY,IAAI;AAAA,MACpB,IAAI,QAAA,IAAY,QAAQ;AAAA,IAAA,EACxB,YAAA;AACF,UAAM,GAAG;AAAA,MACP;AAAA;AAAA;AAAA;AAAA,MAIA;AAAA,MACA,IAAI,YAAA;AAAA,MACJ,QAAQ;AAAA,IAAA;AAAA,EAEZ;AAEA,MAAI;AAEF,UAAM,MAAA;AAAA,EACR,SAAS,OAAO;AAEd,UAAM,GAAG,UAAU,MAAM,MAAM;AAAA,IAAC,CAAC;AACjC,UAAM;AAAA,EACR;AAEA,QAAM,QAAQ,YAAY,MAAM;AAC9B,UAAA,EAAQ,MAAM,MAAM;AAAA,IAGpB,CAAC;AAAA,EACH,GAAG,QAAQ,WAAW;AAEtB,MAAI,UAAU;AACd,SAAO;AAAA,IACL,MAAM,YAAY;AAChB,UAAI,QAAS;AACb,gBAAU;AACV,oBAAc,KAAK;AACnB,UAAI;AACF,cAAM,GAAG,QAAA;AAAA,MACX,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EAAA;AAEJ;AC9EA,eAAe,OAAsB;AACnC,QAAM,SAAS,MAAM,kBAAkB,UAAmC;AAE1E,cAAY,GAAG,WAAW,OAAO,YAAY;AAC3C,QAAI,YAAY,QAAQ;AACtB,YAAM,OAAO,KAAA;AACb,kBAAY,YAAY,SAAS;AAAA,IACnC;AAAA,EACF,CAAC;AAGD,cAAY,YAAY,OAAO;AACjC;AAEA,OAAO,MAAM,CAAC,UAAU;AAGtB,cAAY,YAAY;AAAA,IACtB,MAAM;AAAA,IACN,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,EAAA,CAC/D;AACH,CAAC;"}

package/dist/worker-liveness-ticker.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Configuration for an off-loop liveness ticker (passed via `workerData`).
+ */
+export interface LivenessTickerOptions {
+    /** Database URL the owning runner is using. */
+    url: string;
+    /** Optional explicit engine/type hint. */
+    type?: string;
+    /** This runner incarnation's worker key (the `_smrt_workers.worker_id`). */
+    workerKey: string;
+    /** Lease time-to-live in milliseconds. */
+    leaseTtlMs: number;
+    /** Renewal cadence in milliseconds. */
+    leaseTickMs: number;
+}
+export interface LivenessTicker {
+    /** Stop renewing and close the connection. */
+    stop: () => Promise<void>;
+}
+/**
+ * Renew a worker's liveness lease from *outside* the handler event loop.
+ *
+ * Runs on a `node:worker_threads` thread (or, in tests, directly) with its own
+ * database connection, so a CPU-bound synchronous handler on the main thread
+ * cannot starve the renewal — the failure mode that made the old heartbeat
+ * false-recover running jobs (#1474). A dead process stops renewing and the
+ * lease expires within its TTL, which is how recovery detects death.
+ */
+export declare function runLivenessTicker(options: LivenessTickerOptions): Promise<LivenessTicker>;
+//# sourceMappingURL=worker-liveness-ticker.d.ts.map

package/dist/worker-liveness-ticker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-liveness-ticker.d.ts","sourceRoot":"","sources":["../src/worker-liveness-ticker.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,cAAc,CAAC,CA0DzB"}

package/dist/worker-liveness.d.ts

@@ -0,0 +1,71 @@
+import { detectEngine } from '@happyvertical/smrt-core';
+import { DatabaseInterface } from '@happyvertical/sql';
+type DatabaseEngine = ReturnType<typeof detectEngine>;
+/** Mark a worker key as live in this process. */
+export declare function registerLiveWorker(workerKey: string): void;
+/** Remove a worker key from this process's live set. */
+export declare function unregisterLiveWorker(workerKey: string): void;
+/** Whether a worker key is live in this process. */
+export declare function isLiveWorker(workerKey: string): boolean;
+/** Snapshot of every worker key live in this process. */
+export declare function liveWorkerKeys(): Set<string>;
+/**
+ * Whether a worker is alive: live in *this* process (synchronous truth, never
+ * starved), or holding a fresh database lease in some process. `null`/unknown
+ * worker keys are never alive.
+ */
+export declare function isWorkerAlive(workerKey: string | null | undefined, freshLeaseKeys: Set<string>): boolean;
+/**
+ * Build a per-incarnation-unique worker key.
+ *
+ * Recovery treats a worker key as the unit of liveness, so the key must be
+ * unique per process incarnation: a runner that crashes and restarts under the
+ * same configured `id` must get a *new* key, otherwise its orphaned `running`
+ * jobs would look owned by the live restart and never be recovered. We append
+ * a random token to the (optional) configured id, which also keeps the
+ * human-facing runner id stable for logs/events.
+ */
+export declare function createWorkerKey(baseId: string): string;
+/**
+ * The connection URL, honoring adapters that leave `db.url` empty and carry the
+ * real URL on `db.config.url`. Used consistently for engine detection, the
+ * in-memory check, and the URL handed to the off-loop thread so they never
+ * disagree.
+ */
+export declare function resolveUrl(db: DatabaseInterface): string;
+/**
+ * Tune a SQLite connection for the off-loop liveness topology.
+ *
+ * The runner's main connection and the off-loop ticker's connection both touch
+ * the same file. Stock libsql/SQLite opens in rollback-journal mode with no busy
+ * timeout, so the instant two connections contend it returns `SQLITE_BUSY` —
+ * surfacing as a flaky "Failed to execute raw query" under CI load. WAL lets
+ * readers run concurrently with the single writer, and `busy_timeout` makes a
+ * contended writer wait for the lock instead of failing immediately. Both are
+ * idempotent and file-level (WAL persists for every connection to the file).
+ *
+ * Best-effort: a PRAGMA failure must never break startup — the in-process live
+ * set keeps same-process recovery correct regardless. Callers gate this on a
+ * SQLite engine so it is never issued to Postgres.
+ */
+export declare function tuneSqliteForConcurrency(db: DatabaseInterface): Promise<void>;
+/** Resolve the database engine for a connection. */
+export declare function resolveEngine(db: DatabaseInterface): DatabaseEngine;
+/**
+ * Whether a connection points at an in-memory SQLite database. In-memory
+ * databases are single-process (nothing to recover cross-process) and a second
+ * connection cannot see the same data, so the off-loop liveness thread is
+ * skipped for them.
+ */
+export declare function isInMemory(db: DatabaseInterface): boolean;
+/**
+ * Whether the off-loop liveness thread can run against this connection.
+ *
+ * Requires a second independent connection to the same data: true for Postgres
+ * and file-backed SQLite. In-memory SQLite cannot be reached from another
+ * connection, and DuckDB is single-writer per file — both fall back to
+ * main-loop lease renewal + the in-process live set.
+ */
+export declare function offLoopEligible(db: DatabaseInterface): boolean;
+export {};
+//# sourceMappingURL=worker-liveness.d.ts.map

package/dist/worker-liveness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-liveness.d.ts","sourceRoot":"","sources":["../src/worker-liveness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AAgDtD,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,yDAAyD;AACzD,wBAAgB,cAAc,IAAI,GAAG,CAAC,MAAM,CAAC,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,OAAO,CAGT;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,iBAAiB,GAAG,MAAM,CAGxD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,iBAAiB,GACpB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,EAAE,EAAE,iBAAiB,GAAG,cAAc,CAOnE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAOzD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAK9D"}