mcp-scraper 0.88.2 → 0.89.0

package/dist/chunk-EQGTEHLZ.js

@@ -1,592 +0,0 @@
-import {
-  getDb
-} from "./chunk-YXNDOQXN.js";
-
-// src/api/lead-list-enrichment-repository.ts
-import { createHash, randomUUID } from "crypto";
-var EVENT_NAME = "mcp-scraper/lead-list-enrichment.requested";
-var TERMINAL_JOB_STATUSES = /* @__PURE__ */ new Set(["complete", "partial", "empty", "failed", "cancelled"]);
-var TERMINAL_ROW_STATUSES = /* @__PURE__ */ new Set(["complete", "failed", "cancelled"]);
-var LEAD_LIST_MAX_DISPATCH_ATTEMPTS = 10;
-var LEAD_LIST_START_DEADLINE_MINUTES = 6 * 60;
-var LEAD_LIST_RUNNING_STALE_MINUTES = 60;
-var schemaDb = null;
-var schemaPromise = null;
-function requiredBoundedString(value, field, max) {
-  const trimmed = value.trim();
-  if (!trimmed || trimmed.length > max) throw new Error(`${field} is required and must be ${max} characters or fewer`);
-  return trimmed;
-}
-function nonNegativeSafeInteger(value, field) {
-  if (!Number.isSafeInteger(value) || value < 0) throw new Error(`${field} must be a non-negative safe integer`);
-  return value;
-}
-function parseJson(value) {
-  if (value == null) return null;
-  try {
-    return JSON.parse(String(value));
-  } catch {
-    return null;
-  }
-}
-function stableCanonicalJson(value) {
-  const seen = /* @__PURE__ */ new WeakSet();
-  const normalize = (input) => {
-    if (input === null || typeof input === "string" || typeof input === "boolean") return input;
-    if (typeof input === "number") {
-      if (!Number.isFinite(input)) throw new Error("canonical fingerprint input must contain finite numbers");
-      return Object.is(input, -0) ? 0 : input;
-    }
-    if (Array.isArray(input)) return input.map(normalize);
-    if (typeof input === "object") {
-      if (seen.has(input)) throw new Error("canonical fingerprint input must not be cyclic");
-      seen.add(input);
-      const out = {};
-      for (const key of Object.keys(input).sort()) {
-        const child = input[key];
-        if (child !== void 0) out[key] = normalize(child);
-      }
-      seen.delete(input);
-      return out;
-    }
-    throw new Error(`canonical fingerprint input contains unsupported ${typeof input}`);
-  };
-  return JSON.stringify(normalize(value));
-}
-function leadListEnrichmentFingerprint(input) {
-  return createHash("sha256").update(stableCanonicalJson(input)).digest("hex");
-}
-function leadListRowInputDigest(row) {
-  return createHash("sha256").update(stableCanonicalJson(row)).digest("hex");
-}
-function emptyUsage() {
-  return { mapsAttempts: 0, pageAttempts: 0, pageSuccesses: 0, serpSearches: 0 };
-}
-function rowToJob(row) {
-  const input = parseJson(row.input_json);
-  if (!input) throw new Error(`lead list enrichment job ${String(row.id ?? "")} has invalid durable input`);
-  return {
-    id: String(row.id),
-    userId: Number(row.user_id),
-    idempotencyKey: String(row.idempotency_key),
-    requestFingerprint: String(row.request_fingerprint),
-    input,
-    status: String(row.status),
-    totalRows: Number(row.total_rows ?? 0),
-    doneRows: Number(row.done_rows ?? 0),
-    failedRows: Number(row.failed_rows ?? 0),
-    cancelledRows: Number(row.cancelled_rows ?? 0),
-    usage: {
-      mapsAttempts: Number(row.maps_attempts ?? 0),
-      pageAttempts: Number(row.page_attempts ?? 0),
-      pageSuccesses: Number(row.page_successes ?? 0),
-      serpSearches: Number(row.serp_searches ?? 0)
-    },
-    concurrencyLockId: row.concurrency_lock_id == null ? null : String(row.concurrency_lock_id),
-    debitKey: String(row.debit_key),
-    holdMc: Number(row.hold_mc ?? 0),
-    billedMc: row.billed_mc == null ? null : Number(row.billed_mc),
-    result: parseJson(row.result_json),
-    csvArtifact: parseJson(row.csv_artifact_json),
-    xlsxArtifact: parseJson(row.xlsx_artifact_json),
-    warnings: parseJson(row.warnings_json) ?? [],
-    cancelRequestedAt: row.cancel_requested_at == null ? null : String(row.cancel_requested_at),
-    errorCode: row.error_code == null ? null : String(row.error_code),
-    errorMessage: row.error_message == null ? null : String(row.error_message),
-    retryable: row.retryable == null ? null : Number(row.retryable) === 1,
-    createdAt: String(row.created_at ?? ""),
-    startedAt: row.started_at == null ? null : String(row.started_at),
-    completedAt: row.completed_at == null ? null : String(row.completed_at),
-    updatedAt: String(row.updated_at ?? "")
-  };
-}
-function rowToCheckpoint(row) {
-  return {
-    jobId: String(row.job_id),
-    ordinal: Number(row.ordinal),
-    inputDigest: String(row.input_digest),
-    status: String(row.status),
-    result: parseJson(row.result_json),
-    usage: {
-      mapsAttempts: Number(row.maps_attempts ?? 0),
-      pageAttempts: Number(row.page_attempts ?? 0),
-      pageSuccesses: Number(row.page_successes ?? 0),
-      serpSearches: Number(row.serp_searches ?? 0)
-    },
-    errorCode: row.error_code == null ? null : String(row.error_code),
-    errorMessage: row.error_message == null ? null : String(row.error_message),
-    retryable: Number(row.retryable ?? 0) === 1,
-    durationMs: Number(row.duration_ms ?? 0),
-    startedAt: row.started_at == null ? null : String(row.started_at),
-    completedAt: row.completed_at == null ? null : String(row.completed_at),
-    updatedAt: String(row.updated_at ?? "")
-  };
-}
-function rowToOutbox(row) {
-  return {
-    id: String(row.id),
-    jobId: String(row.job_id),
-    eventName: EVENT_NAME,
-    status: String(row.status),
-    attempts: Number(row.attempts ?? 0),
-    claimToken: row.locked_by == null ? null : String(row.locked_by),
-    lockedUntil: row.locked_until == null ? null : String(row.locked_until),
-    nextAttemptAt: row.next_attempt_at == null ? null : String(row.next_attempt_at),
-    lastError: row.last_error == null ? null : String(row.last_error),
-    createdAt: String(row.created_at ?? ""),
-    dispatchedAt: row.dispatched_at == null ? null : String(row.dispatched_at),
-    updatedAt: String(row.updated_at ?? "")
-  };
-}
-async function ensureLeadListEnrichmentRepositorySchema() {
-  const db = getDb();
-  if (schemaDb !== db) {
-    schemaDb = db;
-    schemaPromise = null;
-  }
-  if (!schemaPromise) schemaPromise = (async () => {
-    await db.execute(`CREATE TABLE IF NOT EXISTS lead_list_enrichment_jobs (
-      id TEXT PRIMARY KEY, user_id INTEGER NOT NULL REFERENCES users(id), idempotency_key TEXT NOT NULL,
-      request_fingerprint TEXT NOT NULL, input_json TEXT NOT NULL, status TEXT NOT NULL DEFAULT 'initializing',
-      total_rows INTEGER NOT NULL DEFAULT 0, done_rows INTEGER NOT NULL DEFAULT 0,
-      failed_rows INTEGER NOT NULL DEFAULT 0, cancelled_rows INTEGER NOT NULL DEFAULT 0,
-      maps_attempts INTEGER NOT NULL DEFAULT 0, page_attempts INTEGER NOT NULL DEFAULT 0,
-      page_successes INTEGER NOT NULL DEFAULT 0, serp_searches INTEGER NOT NULL DEFAULT 0,
-      concurrency_lock_id TEXT, debit_key TEXT NOT NULL,
-      hold_mc INTEGER NOT NULL DEFAULT 0, billed_mc INTEGER, result_json TEXT,
-      csv_artifact_json TEXT, xlsx_artifact_json TEXT, warnings_json TEXT NOT NULL DEFAULT '[]',
-      cancel_requested_at TEXT, error_code TEXT, error_message TEXT, retryable INTEGER,
-      created_at TEXT NOT NULL DEFAULT (datetime('now')), started_at TEXT, completed_at TEXT,
-      updated_at TEXT NOT NULL DEFAULT (datetime('now')), UNIQUE(user_id, idempotency_key)
-    )`);
-    try {
-      await db.execute("ALTER TABLE lead_list_enrichment_jobs ADD COLUMN serp_searches INTEGER NOT NULL DEFAULT 0");
-    } catch {
-    }
-    await db.execute("CREATE INDEX IF NOT EXISTS lead_list_enrichment_jobs_user_created ON lead_list_enrichment_jobs(user_id, created_at DESC)");
-    await db.execute("CREATE INDEX IF NOT EXISTS lead_list_enrichment_jobs_status ON lead_list_enrichment_jobs(status, updated_at)");
-    await db.execute(`CREATE TABLE IF NOT EXISTS lead_list_enrichment_rows (
-      job_id TEXT NOT NULL REFERENCES lead_list_enrichment_jobs(id) ON DELETE CASCADE,
-      ordinal INTEGER NOT NULL, input_digest TEXT NOT NULL, status TEXT NOT NULL DEFAULT 'pending',
-      result_json TEXT, maps_attempts INTEGER NOT NULL DEFAULT 0, page_attempts INTEGER NOT NULL DEFAULT 0,
-      page_successes INTEGER NOT NULL DEFAULT 0, serp_searches INTEGER NOT NULL DEFAULT 0,
-      error_code TEXT, error_message TEXT,
-      retryable INTEGER NOT NULL DEFAULT 0, duration_ms INTEGER NOT NULL DEFAULT 0,
-      started_at TEXT, completed_at TEXT, updated_at TEXT NOT NULL DEFAULT (datetime('now')),
-      PRIMARY KEY(job_id, ordinal)
-    )`);
-    try {
-      await db.execute("ALTER TABLE lead_list_enrichment_rows ADD COLUMN serp_searches INTEGER NOT NULL DEFAULT 0");
-    } catch {
-    }
-    await db.execute("CREATE INDEX IF NOT EXISTS lead_list_enrichment_rows_job_status ON lead_list_enrichment_rows(job_id, status, ordinal)");
-    await db.execute(`CREATE TABLE IF NOT EXISTS lead_list_enrichment_outbox (
-      id TEXT PRIMARY KEY, job_id TEXT NOT NULL UNIQUE REFERENCES lead_list_enrichment_jobs(id) ON DELETE CASCADE,
-      event_name TEXT NOT NULL, status TEXT NOT NULL DEFAULT 'held', attempts INTEGER NOT NULL DEFAULT 0,
-      locked_by TEXT, locked_until TEXT, next_attempt_at TEXT, last_error TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now')), dispatched_at TEXT,
-      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
-    )`);
-    await db.execute("CREATE INDEX IF NOT EXISTS lead_list_enrichment_outbox_dispatch ON lead_list_enrichment_outbox(status, next_attempt_at, locked_until, created_at)");
-  })();
-  return schemaPromise;
-}
-async function getLeadListEnrichmentJob(id, userId) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const result = userId == null ? await getDb().execute({ sql: "SELECT * FROM lead_list_enrichment_jobs WHERE id = ? LIMIT 1", args: [id] }) : await getDb().execute({ sql: "SELECT * FROM lead_list_enrichment_jobs WHERE id = ? AND user_id = ? LIMIT 1", args: [id, userId] });
-  return result.rows[0] ? rowToJob(result.rows[0]) : null;
-}
-async function getLeadListEnrichmentJobByIdempotencyKey(userId, idempotencyKey) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const result = await getDb().execute({
-    sql: "SELECT * FROM lead_list_enrichment_jobs WHERE user_id = ? AND idempotency_key = ? LIMIT 1",
-    args: [userId, idempotencyKey]
-  });
-  return result.rows[0] ? rowToJob(result.rows[0]) : null;
-}
-async function createOrGetLeadListEnrichmentJob(input) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const id = requiredBoundedString(input.id, "job id", 200);
-  const idempotencyKey = requiredBoundedString(input.idempotencyKey, "idempotency key", 200);
-  const requestFingerprint = input.requestFingerprint ?? leadListEnrichmentFingerprint(input.input);
-  requiredBoundedString(requestFingerprint, "request fingerprint", 200);
-  const debitKey = requiredBoundedString(input.debitKey, "debit key", 500);
-  const holdMc = nonNegativeSafeInteger(input.holdMc, "holdMc");
-  if (input.input.rows.length < 1 || input.input.rows.length > 250) throw new Error("lead list job must contain 1 to 250 rows");
-  const commands = [{
-    sql: `INSERT OR IGNORE INTO lead_list_enrichment_jobs (
-      id,user_id,idempotency_key,request_fingerprint,input_json,total_rows,concurrency_lock_id,debit_key,hold_mc
-    ) VALUES (?,?,?,?,?,?,?,?,?)`,
-    args: [
-      id,
-      input.userId,
-      idempotencyKey,
-      requestFingerprint,
-      JSON.stringify(input.input),
-      input.input.rows.length,
-      input.concurrencyLockId ?? null,
-      debitKey,
-      holdMc
-    ]
-  }, {
-    sql: `INSERT OR IGNORE INTO lead_list_enrichment_outbox(id,job_id,event_name,status)
-      SELECT 'lead-list-enrichment:' || id,id,?,'held' FROM lead_list_enrichment_jobs
-      WHERE user_id=? AND idempotency_key=? AND request_fingerprint=?`,
-    args: [EVENT_NAME, input.userId, idempotencyKey, requestFingerprint]
-  }];
-  input.input.rows.forEach((row, ordinal) => commands.push({
-    sql: `INSERT OR IGNORE INTO lead_list_enrichment_rows(job_id,ordinal,input_digest)
-      SELECT id,?,? FROM lead_list_enrichment_jobs
-      WHERE user_id=? AND idempotency_key=? AND request_fingerprint=?`,
-    args: [ordinal, leadListRowInputDigest(row), input.userId, idempotencyKey, requestFingerprint]
-  }));
-  const results = await getDb().batch(commands, "write");
-  const job = await getLeadListEnrichmentJobByIdempotencyKey(input.userId, idempotencyKey);
-  if (!job) throw new Error("lead list enrichment job could not be created");
-  return { job, created: Number(results[0]?.rowsAffected ?? 0) > 0, conflict: job.requestFingerprint !== requestFingerprint };
-}
-async function setInitializingLeadListEnrichmentConcurrencyLock(jobId, concurrencyLockId) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  await getDb().execute({
-    sql: `UPDATE lead_list_enrichment_jobs SET concurrency_lock_id=?, updated_at=datetime('now') WHERE id=? AND status='initializing'`,
-    args: [concurrencyLockId, jobId]
-  });
-  return getLeadListEnrichmentJob(jobId);
-}
-async function markLeadListEnrichmentJobQueued(jobId) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  await getDb().batch([{
-    sql: `UPDATE lead_list_enrichment_jobs SET status='queued',updated_at=datetime('now') WHERE id=? AND status='initializing'`,
-    args: [jobId]
-  }, {
-    sql: `UPDATE lead_list_enrichment_outbox SET status='pending',next_attempt_at=NULL,updated_at=datetime('now')
-      WHERE job_id=? AND status='held' AND EXISTS(SELECT 1 FROM lead_list_enrichment_jobs WHERE id=? AND status='queued')`,
-    args: [jobId, jobId]
-  }], "write");
-  return getLeadListEnrichmentJob(jobId);
-}
-async function markLeadListEnrichmentJobRunning(jobId) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  await getDb().execute({
-    sql: `UPDATE lead_list_enrichment_jobs SET status='running',started_at=COALESCE(started_at,datetime('now')),
-      updated_at=datetime('now') WHERE id=? AND status IN ('queued','running') AND cancel_requested_at IS NULL`,
-    args: [jobId]
-  });
-  const job = await getLeadListEnrichmentJob(jobId);
-  return job?.status === "running" ? job : null;
-}
-async function claimLeadListEnrichmentRow(jobId, ordinal) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  nonNegativeSafeInteger(ordinal, "row ordinal");
-  await getDb().execute({
-    sql: `UPDATE lead_list_enrichment_rows SET status='running',started_at=COALESCE(started_at,datetime('now')),
-      updated_at=datetime('now') WHERE job_id=? AND ordinal=? AND status IN ('pending','running')
-      AND EXISTS(SELECT 1 FROM lead_list_enrichment_jobs WHERE id=? AND status='running' AND cancel_requested_at IS NULL)`,
-    args: [jobId, ordinal, jobId]
-  });
-  return getLeadListEnrichmentRow(jobId, ordinal);
-}
-async function getLeadListEnrichmentRow(jobId, ordinal) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const result = await getDb().execute({ sql: "SELECT * FROM lead_list_enrichment_rows WHERE job_id=? AND ordinal=? LIMIT 1", args: [jobId, ordinal] });
-  return result.rows[0] ? rowToCheckpoint(result.rows[0]) : null;
-}
-async function listLeadListEnrichmentRows(jobId) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const result = await getDb().execute({ sql: "SELECT * FROM lead_list_enrichment_rows WHERE job_id=? ORDER BY ordinal ASC", args: [jobId] });
-  return result.rows.map((row) => rowToCheckpoint(row));
-}
-async function saveLeadListEnrichmentRowResult(input) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const usage = input.result.usage ?? emptyUsage();
-  const rowStatus = input.result.rowStatus === "failed" ? "failed" : "complete";
-  const existing = await getLeadListEnrichmentRow(input.jobId, input.ordinal);
-  if (existing && TERMINAL_ROW_STATUSES.has(existing.status)) return existing;
-  await getDb().batch([{
-    sql: `UPDATE lead_list_enrichment_rows SET status=?,result_json=?,maps_attempts=?,page_attempts=?,page_successes=?,serp_searches=?,
-      error_code=?,error_message=?,retryable=?,duration_ms=?,completed_at=datetime('now'),updated_at=datetime('now')
-      WHERE job_id=? AND ordinal=? AND status IN ('pending','running')
-      AND EXISTS(SELECT 1 FROM lead_list_enrichment_jobs WHERE id=? AND status='running')`,
-    args: [
-      rowStatus,
-      JSON.stringify(input.result),
-      nonNegativeSafeInteger(usage.mapsAttempts, "mapsAttempts"),
-      nonNegativeSafeInteger(usage.pageAttempts, "pageAttempts"),
-      nonNegativeSafeInteger(usage.pageSuccesses, "pageSuccesses"),
-      nonNegativeSafeInteger(usage.serpSearches, "serpSearches"),
-      input.result.error?.code ?? null,
-      input.result.error?.message ?? null,
-      input.result.error ? 1 : 0,
-      nonNegativeSafeInteger(input.durationMs ?? 0, "durationMs"),
-      input.jobId,
-      input.ordinal,
-      input.jobId
-    ]
-  }, {
-    sql: `UPDATE lead_list_enrichment_jobs SET
-      done_rows=(SELECT COUNT(*) FROM lead_list_enrichment_rows WHERE job_id=? AND status IN ('complete','failed','cancelled')),
-      failed_rows=(SELECT COUNT(*) FROM lead_list_enrichment_rows WHERE job_id=? AND status='failed'),
-      cancelled_rows=(SELECT COUNT(*) FROM lead_list_enrichment_rows WHERE job_id=? AND status='cancelled'),
-      maps_attempts=(SELECT COALESCE(SUM(maps_attempts),0) FROM lead_list_enrichment_rows WHERE job_id=?),
-      page_attempts=(SELECT COALESCE(SUM(page_attempts),0) FROM lead_list_enrichment_rows WHERE job_id=?),
-      page_successes=(SELECT COALESCE(SUM(page_successes),0) FROM lead_list_enrichment_rows WHERE job_id=?),
-      serp_searches=(SELECT COALESCE(SUM(serp_searches),0) FROM lead_list_enrichment_rows WHERE job_id=?),
-      updated_at=datetime('now') WHERE id=? AND status='running'`,
-    args: [input.jobId, input.jobId, input.jobId, input.jobId, input.jobId, input.jobId, input.jobId, input.jobId]
-  }], "write");
-  return getLeadListEnrichmentRow(input.jobId, input.ordinal);
-}
-async function requestLeadListEnrichmentCancellation(jobId, userId) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const ownerClause = userId == null ? "" : " AND user_id=?";
-  const args = [jobId];
-  if (userId != null) args.push(userId);
-  await getDb().batch([{
-    sql: `UPDATE lead_list_enrichment_jobs SET cancel_requested_at=COALESCE(cancel_requested_at,datetime('now')),
-      status=CASE WHEN status IN ('initializing','queued') THEN 'settling' ELSE status END,updated_at=datetime('now')
-      WHERE id=?${ownerClause} AND status IN ('initializing','queued','running')`,
-    args
-  }, {
-    sql: `UPDATE lead_list_enrichment_outbox SET status='exhausted',locked_by=NULL,locked_until=NULL,next_attempt_at=NULL,
-      last_error='Lead list enrichment was cancelled before execution.',updated_at=datetime('now')
-      WHERE job_id=? AND EXISTS(SELECT 1 FROM lead_list_enrichment_jobs WHERE id=? AND cancel_requested_at IS NOT NULL AND status='settling')`,
-    args: [jobId, jobId]
-  }], "write");
-  return getLeadListEnrichmentJob(jobId, userId);
-}
-async function cancelPendingLeadListEnrichmentRows(jobId) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const results = await getDb().batch([{
-    sql: `UPDATE lead_list_enrichment_rows SET status='cancelled',completed_at=datetime('now'),updated_at=datetime('now')
-      WHERE job_id=? AND status='pending' AND EXISTS(SELECT 1 FROM lead_list_enrichment_jobs WHERE id=? AND cancel_requested_at IS NOT NULL)`,
-    args: [jobId, jobId]
-  }, {
-    sql: `UPDATE lead_list_enrichment_jobs SET
-      done_rows=(SELECT COUNT(*) FROM lead_list_enrichment_rows WHERE job_id=? AND status IN ('complete','failed','cancelled')),
-      failed_rows=(SELECT COUNT(*) FROM lead_list_enrichment_rows WHERE job_id=? AND status='failed'),
-      cancelled_rows=(SELECT COUNT(*) FROM lead_list_enrichment_rows WHERE job_id=? AND status='cancelled'),
-      status=CASE WHEN status='running' THEN 'settling' ELSE status END,updated_at=datetime('now')
-      WHERE id=? AND cancel_requested_at IS NOT NULL`,
-    args: [jobId, jobId, jobId, jobId]
-  }], "write");
-  return Number(results[0]?.rowsAffected ?? 0);
-}
-async function saveLeadListEnrichmentDeliverable(input) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  await getDb().execute({
-    sql: `UPDATE lead_list_enrichment_jobs SET status='settling',result_json=?,csv_artifact_json=?,xlsx_artifact_json=?,
-      warnings_json=?,updated_at=datetime('now') WHERE id=? AND status IN ('running','settling')`,
-    args: [
-      JSON.stringify(input.result),
-      input.csvArtifact == null ? null : JSON.stringify(input.csvArtifact),
-      input.xlsxArtifact == null ? null : JSON.stringify(input.xlsxArtifact),
-      JSON.stringify(input.warnings ?? input.result.warnings),
-      input.jobId
-    ]
-  });
-  return getLeadListEnrichmentJob(input.jobId);
-}
-async function completeLeadListEnrichmentJob(input) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const current = await getLeadListEnrichmentJob(input.jobId);
-  if (!current) throw new Error("lead list enrichment job not found");
-  const billedMc = nonNegativeSafeInteger(input.billedMc, "billedMc");
-  if (billedMc > current.holdMc) throw new Error("billedMc cannot exceed the lead list enrichment hold");
-  if (TERMINAL_JOB_STATUSES.has(current.status)) {
-    if (current.status === input.status && current.billedMc === billedMc) return current;
-    throw new Error("lead list enrichment job already has a conflicting terminal result");
-  }
-  await getDb().execute({
-    sql: `UPDATE lead_list_enrichment_jobs SET status=?,billed_mc=?,result_json=COALESCE(?,result_json),
-      csv_artifact_json=CASE WHEN ?=1 THEN ? ELSE csv_artifact_json END,
-      xlsx_artifact_json=CASE WHEN ?=1 THEN ? ELSE xlsx_artifact_json END,
-      warnings_json=CASE WHEN ?=1 THEN ? ELSE warnings_json END,error_code=NULL,error_message=NULL,retryable=NULL,
-      completed_at=datetime('now'),updated_at=datetime('now') WHERE id=? AND status NOT IN ('complete','partial','empty','failed','cancelled')`,
-    args: [
-      input.status,
-      billedMc,
-      input.result === void 0 ? null : JSON.stringify(input.result),
-      input.csvArtifact === void 0 ? 0 : 1,
-      input.csvArtifact == null ? null : JSON.stringify(input.csvArtifact),
-      input.xlsxArtifact === void 0 ? 0 : 1,
-      input.xlsxArtifact == null ? null : JSON.stringify(input.xlsxArtifact),
-      input.warnings === void 0 ? 0 : 1,
-      JSON.stringify(input.warnings ?? []),
-      input.jobId
-    ]
-  });
-  const completed = await getLeadListEnrichmentJob(input.jobId);
-  if (!completed || completed.status !== input.status || completed.billedMc !== billedMc) throw new Error("lead list enrichment job completion conflicted");
-  return completed;
-}
-async function failLeadListEnrichmentJob(input) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const current = await getLeadListEnrichmentJob(input.jobId);
-  if (!current) throw new Error("lead list enrichment job not found");
-  if (current.status !== "failed" && TERMINAL_JOB_STATUSES.has(current.status)) throw new Error("completed lead list enrichment job cannot be failed");
-  if (current.status === "failed") return current;
-  const billedMc = input.billedMc == null ? null : nonNegativeSafeInteger(input.billedMc, "billedMc");
-  if (billedMc != null && billedMc > current.holdMc) throw new Error("billedMc cannot exceed the lead list enrichment hold");
-  await getDb().execute({
-    sql: `UPDATE lead_list_enrichment_jobs SET status='failed',billed_mc=COALESCE(?,billed_mc),error_code=?,error_message=?,retryable=?,
-      completed_at=datetime('now'),updated_at=datetime('now') WHERE id=? AND status NOT IN ('complete','partial','empty','failed','cancelled')`,
-    args: [
-      billedMc,
-      requiredBoundedString(input.errorCode, "error code", 200),
-      requiredBoundedString(input.errorMessage, "error message", 2e3),
-      input.retryable ? 1 : 0,
-      input.jobId
-    ]
-  });
-  const failed = await getLeadListEnrichmentJob(input.jobId);
-  if (!failed || failed.status !== "failed") throw new Error("lead list enrichment job failure conflicted");
-  return failed;
-}
-async function recordLeadListEnrichmentSettlement(jobId, billedMc) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const current = await getLeadListEnrichmentJob(jobId);
-  if (!current) throw new Error("lead list enrichment job not found");
-  const amount = nonNegativeSafeInteger(billedMc, "billedMc");
-  if (amount > current.holdMc) throw new Error("billedMc cannot exceed the lead list enrichment hold");
-  await getDb().execute({
-    sql: `UPDATE lead_list_enrichment_jobs SET billed_mc=COALESCE(billed_mc,?),updated_at=datetime('now')
-      WHERE id=? AND status IN ('settling','failed','cancelled')`,
-    args: [amount, jobId]
-  });
-  const updated = await getLeadListEnrichmentJob(jobId);
-  if (!updated || updated.billedMc !== amount) throw new Error("lead list enrichment settlement conflicts with durable amount");
-  return updated;
-}
-async function listLeadListEnrichmentJobsNeedingSettlement(limit = 25) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const result = await getDb().execute({
-    sql: `SELECT * FROM lead_list_enrichment_jobs WHERE status='settling' OR (status IN ('failed','cancelled') AND billed_mc IS NULL)
-      ORDER BY updated_at ASC LIMIT ?`,
-    args: [Math.max(1, Math.min(100, Math.trunc(limit)))]
-  });
-  return result.rows.map((row) => rowToJob(row));
-}
-async function listExpiredLeadListEnrichmentStarts(limit = 25, maxAttempts = LEAD_LIST_MAX_DISPATCH_ATTEMPTS, maxAgeMinutes = LEAD_LIST_START_DEADLINE_MINUTES) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const result = await getDb().execute({
-    sql: `SELECT j.* FROM lead_list_enrichment_jobs j JOIN lead_list_enrichment_outbox o ON o.job_id=j.id
-      WHERE j.status IN ('initializing','queued') AND j.billed_mc IS NULL AND (o.attempts>=? OR j.created_at<=datetime('now',?))
-      AND (o.status IN ('held','pending','failed','dispatched') OR (o.status='dispatching' AND o.locked_until<=datetime('now')))
-      ORDER BY j.updated_at ASC LIMIT ?`,
-    args: [Math.max(1, Math.trunc(maxAttempts)), `-${Math.max(15, Math.trunc(maxAgeMinutes))} minutes`, Math.max(1, Math.min(100, Math.trunc(limit)))]
-  });
-  return result.rows.map((row) => rowToJob(row));
-}
-async function failExpiredLeadListEnrichmentStart(jobId, maxAttempts = LEAD_LIST_MAX_DISPATCH_ATTEMPTS, maxAgeMinutes = LEAD_LIST_START_DEADLINE_MINUTES) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const results = await getDb().batch([{
-    sql: `UPDATE lead_list_enrichment_jobs SET status='failed',billed_mc=CASE
-      WHEN EXISTS(SELECT 1 FROM billing_debits d WHERE d.idempotency_key=lead_list_enrichment_jobs.debit_key
-        AND d.user_id=lead_list_enrichment_jobs.user_id AND d.status IN ('applied','settled')) THEN NULL ELSE 0 END,
-      error_code='lead_list_dispatch_expired',
-      error_message='Lead list enrichment did not start before its dispatch deadline; the unused hold will be refunded.',retryable=1,
-      completed_at=datetime('now'),updated_at=datetime('now') WHERE id=? AND status IN ('initializing','queued') AND billed_mc IS NULL
-      AND EXISTS(SELECT 1 FROM lead_list_enrichment_outbox o WHERE o.job_id=lead_list_enrichment_jobs.id AND
-      (o.attempts>=? OR lead_list_enrichment_jobs.created_at<=datetime('now',?)))`,
-    args: [jobId, Math.max(1, Math.trunc(maxAttempts)), `-${Math.max(15, Math.trunc(maxAgeMinutes))} minutes`]
-  }, {
-    sql: `UPDATE lead_list_enrichment_outbox SET status='exhausted',locked_by=NULL,locked_until=NULL,next_attempt_at=NULL,
-      last_error='Lead list enrichment dispatch deadline exhausted.',updated_at=datetime('now') WHERE job_id=?
-      AND EXISTS(SELECT 1 FROM lead_list_enrichment_jobs WHERE id=? AND error_code='lead_list_dispatch_expired')`,
-    args: [jobId, jobId]
-  }], "write");
-  return Number(results[0]?.rowsAffected ?? 0) === 1 ? getLeadListEnrichmentJob(jobId) : null;
-}
-async function listStaleRunningLeadListEnrichmentJobs(limit = 25, staleMinutes = LEAD_LIST_RUNNING_STALE_MINUTES) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const result = await getDb().execute({ sql: `SELECT * FROM lead_list_enrichment_jobs WHERE status='running' AND billed_mc IS NULL
-    AND updated_at<=datetime('now',?) ORDER BY updated_at ASC LIMIT ?`, args: [`-${Math.max(15, Math.trunc(staleMinutes))} minutes`, Math.max(1, Math.min(100, Math.trunc(limit)))] });
-  return result.rows.map((row) => rowToJob(row));
-}
-async function failStaleRunningLeadListEnrichmentJob(jobId, staleMinutes = LEAD_LIST_RUNNING_STALE_MINUTES) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const results = await getDb().batch([{
-    sql: `UPDATE lead_list_enrichment_jobs SET
-      status=CASE WHEN cancel_requested_at IS NULL THEN 'failed' ELSE 'settling' END,
-      error_code=CASE WHEN cancel_requested_at IS NULL THEN 'lead_list_worker_stale' ELSE NULL END,
-      error_message=CASE WHEN cancel_requested_at IS NULL
-        THEN 'Lead list enrichment stopped without a heartbeat; completed row checkpoints were preserved.' ELSE NULL END,
-      retryable=CASE WHEN cancel_requested_at IS NULL THEN 1 ELSE NULL END,
-      completed_at=CASE WHEN cancel_requested_at IS NULL THEN datetime('now') ELSE NULL END,updated_at=datetime('now')
-      WHERE id=? AND status='running' AND billed_mc IS NULL
-      AND updated_at<=datetime('now',?)`,
-    args: [jobId, `-${Math.max(15, Math.trunc(staleMinutes))} minutes`]
-  }, {
-    sql: `UPDATE lead_list_enrichment_outbox SET status='exhausted',locked_by=NULL,locked_until=NULL,next_attempt_at=NULL,
-      last_error='Lead list enrichment worker heartbeat expired.',updated_at=datetime('now') WHERE job_id=?
-      AND EXISTS(SELECT 1 FROM lead_list_enrichment_jobs WHERE id=? AND (error_code='lead_list_worker_stale'
-        OR (status='settling' AND cancel_requested_at IS NOT NULL)))`,
-    args: [jobId, jobId]
-  }], "write");
-  return Number(results[0]?.rowsAffected ?? 0) === 1 ? getLeadListEnrichmentJob(jobId) : null;
-}
-async function claimLeadListEnrichmentOutbox(input) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const workerId = requiredBoundedString(input.workerId, "outbox worker id", 160);
-  const limit = Math.max(1, Math.min(100, Math.trunc(input.limit ?? 25)));
-  const leaseSeconds = Math.max(30, Math.min(3600, Math.trunc(input.leaseSeconds ?? 120)));
-  const claimToken = `${workerId}:${randomUUID()}`;
-  const results = await getDb().batch([{
-    sql: `UPDATE lead_list_enrichment_outbox SET status='dispatching',attempts=attempts+1,locked_by=?,
-      locked_until=datetime('now',?),updated_at=datetime('now') WHERE id IN (SELECT id FROM lead_list_enrichment_outbox
-      WHERE attempts<${LEAD_LIST_MAX_DISPATCH_ATTEMPTS} AND created_at>datetime('now','-${LEAD_LIST_START_DEADLINE_MINUTES} minutes')
-      AND (status='pending' OR (status='failed' AND (next_attempt_at IS NULL OR next_attempt_at<=datetime('now')))
-      OR (status='dispatching' AND locked_until<=datetime('now'))) ORDER BY created_at ASC LIMIT ?)`,
-    args: [claimToken, `+${leaseSeconds} seconds`, limit]
-  }, { sql: `SELECT * FROM lead_list_enrichment_outbox WHERE locked_by=? AND status='dispatching' ORDER BY created_at ASC`, args: [claimToken] }], "write");
-  return results[1]?.rows.map((row) => rowToOutbox(row)) ?? [];
-}
-async function markLeadListEnrichmentOutboxDispatched(id, claimToken) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const result = await getDb().execute({ sql: `UPDATE lead_list_enrichment_outbox SET status='dispatched',locked_by=NULL,
-    locked_until=NULL,next_attempt_at=NULL,last_error=NULL,dispatched_at=datetime('now'),updated_at=datetime('now')
-    WHERE id=? AND status='dispatching' AND locked_by=?`, args: [id, claimToken] });
-  return Number(result.rowsAffected ?? 0) > 0;
-}
-async function markLeadListEnrichmentOutboxFailed(input) {
-  await ensureLeadListEnrichmentRepositorySchema();
-  const retryAfterSeconds = Math.max(1, Math.min(86400, Math.trunc(input.retryAfterSeconds ?? 30)));
-  const result = await getDb().execute({ sql: `UPDATE lead_list_enrichment_outbox SET status='failed',locked_by=NULL,
-    locked_until=NULL,next_attempt_at=datetime('now',?),last_error=?,updated_at=datetime('now')
-    WHERE id=? AND status='dispatching' AND locked_by=?`, args: [`+${retryAfterSeconds} seconds`, String(input.error).slice(0, 2e3), input.id, input.claimToken] });
-  return Number(result.rowsAffected ?? 0) > 0;
-}
-
-export {
-  LEAD_LIST_MAX_DISPATCH_ATTEMPTS,
-  LEAD_LIST_START_DEADLINE_MINUTES,
-  LEAD_LIST_RUNNING_STALE_MINUTES,
-  stableCanonicalJson,
-  leadListEnrichmentFingerprint,
-  leadListRowInputDigest,
-  ensureLeadListEnrichmentRepositorySchema,
-  getLeadListEnrichmentJob,
-  getLeadListEnrichmentJobByIdempotencyKey,
-  createOrGetLeadListEnrichmentJob,
-  setInitializingLeadListEnrichmentConcurrencyLock,
-  markLeadListEnrichmentJobQueued,
-  markLeadListEnrichmentJobRunning,
-  claimLeadListEnrichmentRow,
-  getLeadListEnrichmentRow,
-  listLeadListEnrichmentRows,
-  saveLeadListEnrichmentRowResult,
-  requestLeadListEnrichmentCancellation,
-  cancelPendingLeadListEnrichmentRows,
-  saveLeadListEnrichmentDeliverable,
-  completeLeadListEnrichmentJob,
-  failLeadListEnrichmentJob,
-  recordLeadListEnrichmentSettlement,
-  listLeadListEnrichmentJobsNeedingSettlement,
-  listExpiredLeadListEnrichmentStarts,
-  failExpiredLeadListEnrichmentStart,
-  listStaleRunningLeadListEnrichmentJobs,
-  failStaleRunningLeadListEnrichmentJob,
-  claimLeadListEnrichmentOutbox,
-  markLeadListEnrichmentOutboxDispatched,
-  markLeadListEnrichmentOutboxFailed
-};