@triagepilot/db 1.1.0

package/dist/heartbeat.d.ts

@@ -0,0 +1,11 @@
+import type { Kysely } from "kysely";
+import type { Database } from "./kysely.js";
+export interface WorkerHeartbeat {
+    workerId: string;
+    heartbeatAt: Date;
+}
+export declare function updateWorkerHeartbeat(db: Kysely<Database>, input: {
+    workerId: string;
+    now: Date;
+}): Promise<void>;
+export declare function readWorkerHeartbeat(db: Kysely<Database>): Promise<WorkerHeartbeat | null>;

package/dist/heartbeat.js

@@ -0,0 +1,11 @@
+export async function updateWorkerHeartbeat(db, input) {
+    await db
+        .insertInto("worker_heartbeat")
+        .values({ worker_id: input.workerId, heartbeat_at: input.now })
+        .onConflict((conflict) => conflict.column("id").doUpdateSet({ worker_id: input.workerId, heartbeat_at: input.now }))
+        .execute();
+}
+export async function readWorkerHeartbeat(db) {
+    const row = await db.selectFrom("worker_heartbeat").select(["worker_id", "heartbeat_at"]).executeTakeFirst();
+    return row ? { workerId: row.worker_id, heartbeatAt: row.heartbeat_at } : null;
+}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { buildNextRunAt, createJobClaimer, createWorkspaceJobQueue, prepareClaimedReviewerMutationIntent, runClaimedReviewerProviderMutation, type EnqueueJobInput, type JobKind, type JobLease, type JobClaimer, type JobRecord, type JobRecovery, type JobStatus, type JobTransitionResult, ReviewerMutationLeaseUnavailableError, type WorkspaceJobQueue, recoverStaleJobs, } from "./jobs.js";
+export { createDatabase } from "./database.js";
+export { findReviewerReplacementCandidates, markActionFailed, markActionSucceeded, findLatestHumanReviewPolicyDecision, persistDecision, persistDecisionWithEvent, recordPolicyCheck, updatePolicyCheckState, type DecisionInput, type HumanReviewPolicyDecision, type PersistedDecision, type PersistedDecisionEventContext, type ReviewerReplacementCandidateDecision, } from "./decisions.js";
+export { ProviderConnectionUnavailableError, ReviewerAbsenceConflictError, ReviewerAbsenceRevisionError, ReviewerAvailabilityValidationError, createWorkspaceReviewerAvailability, prepareMutationIntentTransaction, type CancelAbsenceInput, type PersistReviewerReplacementInput, type PersistReviewerReplacementResult, type PrepareReviewerMutationIntentInput, type ReviewerAbsence, type ReviewerAbsenceActivation, type ReviewerAbsenceWindow, type ReviewerReplacement, type ReviewerMutationIntent, type ReviewerMutationIntentKey, type ReviewerReplacementState, type ReviseAbsenceInput, type ScheduleAbsenceInput, type WorkspaceOperationalSettings, type WorkspaceReviewerAvailability, } from "./availability.js";
+export { claimPlatformEvents, createPlatformOutboxRepository, markPlatformEventPublished, publishPlatformOutbox, stagePlatformEvent, type PlatformOutboxRecord, type PlatformOutboxRepository, } from "./outbox.js";
+export { acceptHumanReviewPolicyDelivery, acceptRoutingDelivery, type HumanReviewPolicyDeliveryInput, type RoutingDeliveryInput, } from "./deliveries.js";
+export { readWorkerHeartbeat, updateWorkerHeartbeat, type WorkerHeartbeat } from "./heartbeat.js";
+export { createWorkspaceRoutingRecoveryRepository, enqueueRoutingRecovery, findActiveExternalConnectionId, findActiveRecoveryRepository, findRoutingRecoveryTarget, type RoutingRecoveryEnqueueInput, type RoutingRecoveryTarget, type RoutingRecoveryTargetRequest, type WorkspaceRoutingRecoveryRepository, } from "./routing-recovery.js";
+export { findRepositoryConfigurationTarget, readOperationsOverview, type ActionFailureOverview, type DecisionOverview, type JobFailureOverview, type OperationsOverview, type RepositoryConfigurationTarget, type ReadOperationsOverviewInput, type RepositoryOverview, } from "./operations.js";
+export { activateConfiguredProviderConnection, cleanupRevokedProviderConnections, replaceProviderConnectionRepositories, revokeConfiguredProviderConnection, suspendConfiguredProviderConnection, updateProviderConnectionRepositories, upsertConfiguredProviderConnection, type ConfiguredProviderConnectionInput, type ProviderConnectionMetadata, type ProviderConnectionRepositoryUpdateInput, type ProviderRepositoryMetadata, } from "./provider-connections.js";
+export { applyFixedRetention, DECISION_AND_FAILURE_DAYS, RECEIPT_AND_COMPLETED_JOB_DAYS, } from "./retention.js";
+export { runMigrations } from "./migrate.js";
+export type { Database, DecisionOutboxTable, WorkerHeartbeatTable } from "./kysely.js";
+export { createWorkspaceRepositories, ensureLocalWorkspace, LOCAL_WORKSPACE_EXTERNAL_KEY, type WorkspaceRepositories, } from "./workspaces.js";

package/dist/index.js

@@ -0,0 +1,13 @@
+export { buildNextRunAt, createJobClaimer, createWorkspaceJobQueue, prepareClaimedReviewerMutationIntent, runClaimedReviewerProviderMutation, ReviewerMutationLeaseUnavailableError, recoverStaleJobs, } from "./jobs.js";
+export { createDatabase } from "./database.js";
+export { findReviewerReplacementCandidates, markActionFailed, markActionSucceeded, findLatestHumanReviewPolicyDecision, persistDecision, persistDecisionWithEvent, recordPolicyCheck, updatePolicyCheckState, } from "./decisions.js";
+export { ProviderConnectionUnavailableError, ReviewerAbsenceConflictError, ReviewerAbsenceRevisionError, ReviewerAvailabilityValidationError, createWorkspaceReviewerAvailability, prepareMutationIntentTransaction, } from "./availability.js";
+export { claimPlatformEvents, createPlatformOutboxRepository, markPlatformEventPublished, publishPlatformOutbox, stagePlatformEvent, } from "./outbox.js";
+export { acceptHumanReviewPolicyDelivery, acceptRoutingDelivery, } from "./deliveries.js";
+export { readWorkerHeartbeat, updateWorkerHeartbeat } from "./heartbeat.js";
+export { createWorkspaceRoutingRecoveryRepository, enqueueRoutingRecovery, findActiveExternalConnectionId, findActiveRecoveryRepository, findRoutingRecoveryTarget, } from "./routing-recovery.js";
+export { findRepositoryConfigurationTarget, readOperationsOverview, } from "./operations.js";
+export { activateConfiguredProviderConnection, cleanupRevokedProviderConnections, replaceProviderConnectionRepositories, revokeConfiguredProviderConnection, suspendConfiguredProviderConnection, updateProviderConnectionRepositories, upsertConfiguredProviderConnection, } from "./provider-connections.js";
+export { applyFixedRetention, DECISION_AND_FAILURE_DAYS, RECEIPT_AND_COMPLETED_JOB_DAYS, } from "./retention.js";
+export { runMigrations } from "./migrate.js";
+export { createWorkspaceRepositories, ensureLocalWorkspace, LOCAL_WORKSPACE_EXTERNAL_KEY, } from "./workspaces.js";

package/dist/jobs.d.ts

@@ -0,0 +1,86 @@
+import { type Kysely } from "kysely";
+import type { ProviderConnectionId, ProviderKind, WorkspaceId } from "@triagepilot/contracts";
+import type { Database } from "./kysely.js";
+import { type PrepareReviewerMutationIntentInput, type ReviewerMutationIntent } from "./availability.js";
+export type JobKind = "process_pull_request" | "evaluate_human_review_policy" | "activate_reviewer_absence";
+export type JobStatus = "queued" | "running" | "succeeded" | "failed";
+export interface JobRecord {
+    id: string;
+    workspaceId: WorkspaceId;
+    provider: ProviderKind;
+    providerConnectionId: ProviderConnectionId;
+    kind: JobKind;
+    status: JobStatus;
+    payload: unknown;
+    idempotencyKey: string;
+    attemptCount: number;
+    maxAttempts: number;
+    runAt: Date;
+    lockedAt: Date | null;
+    lockedBy: string | null;
+    lastError: string | null;
+}
+export interface EnqueueJobInput {
+    provider: ProviderKind;
+    providerConnectionId: ProviderConnectionId;
+    kind: JobKind;
+    payload: unknown;
+    idempotencyKey: string;
+    runAt?: Date;
+    maxAttempts?: number;
+}
+export interface JobLease {
+    jobId: string;
+    workspaceId: WorkspaceId;
+    provider: ProviderKind;
+    providerConnectionId: ProviderConnectionId;
+    lockedBy: string;
+    lockedAt: Date;
+    attemptCount: number;
+    maxAttempts: number;
+}
+export type JobTransitionResult = {
+    updated: true;
+} | {
+    updated: false;
+    reason: "stale_lease";
+};
+export declare class ReviewerMutationLeaseUnavailableError extends Error {
+}
+export interface ReviewerMutationAuthority {
+    signal: AbortSignal;
+    assertActive(): Promise<void>;
+}
+export interface JobRecovery {
+    payload: unknown;
+    maxAttempts: number;
+}
+export interface WorkspaceJobQueue {
+    enqueue(input: EnqueueJobInput): Promise<{
+        inserted: boolean;
+        jobId: string;
+    }>;
+    markSucceeded(lease: JobLease, now: Date): Promise<JobTransitionResult>;
+    markFailed(lease: JobLease, error: string, now: Date, options: {
+        retryable: boolean;
+        recovery?: JobRecovery;
+    }): Promise<JobTransitionResult>;
+    exhaustReviewerAbsenceActivation(lease: JobLease, error: string, now: Date): Promise<JobTransitionResult>;
+}
+export interface JobClaimer {
+    claimNext(workerId: string, now: Date): Promise<JobRecord | null>;
+}
+export declare function buildNextRunAt(now: Date, attemptCount: number): Date;
+export declare function prepareClaimedReviewerMutationIntent(db: Kysely<Database>, lease: JobLease, input: PrepareReviewerMutationIntentInput): Promise<ReviewerMutationIntent>;
+export declare function runClaimedReviewerProviderMutation<T>(db: Kysely<Database>, lease: JobLease, scope: {
+    workspaceId: WorkspaceId;
+    provider: ProviderKind;
+    providerConnectionId: ProviderConnectionId;
+    absenceId: string;
+    absenceRevision: number;
+}, mutation: (authority: ReviewerMutationAuthority) => Promise<T>, options?: {
+    timeoutMs?: number;
+}): Promise<T>;
+export declare function recoverStaleJobs(db: Kysely<Database>, workspaceId: WorkspaceId, now: Date, staleAfterMs?: number): Promise<void>;
+export declare function createJobClaimer(db: Kysely<Database>): JobClaimer;
+export declare function createWorkspaceJobQueue(db: Kysely<Database>, workspaceId: WorkspaceId): WorkspaceJobQueue;