commit 93cff389f7dbaf42541a2389281c9bd68338bcb9 · dunkirk.sh/thistle

+201

src/lib/errors.ts

···

       1
       1
       +
       // Structured error codes for API responses

     

       2
       2
       +
       

     

       3
       3
       +
       export enum ErrorCode {

     

       4
       4
       +
       	// Authentication errors

     

       5
       5
       +
       	AUTH_REQUIRED = "AUTH_REQUIRED",

     

       6
       6
       +
       	INVALID_SESSION = "INVALID_SESSION",

     

       7
       7
       +
       	INVALID_CREDENTIALS = "INVALID_CREDENTIALS",

     

       8
       8
       +
       	EMAIL_ALREADY_EXISTS = "EMAIL_ALREADY_EXISTS",

     

       9
       9
       +
       

     

       10
       10
       +
       	// Validation errors

     

       11
       11
       +
       	VALIDATION_FAILED = "VALIDATION_FAILED",

     

       12
       12
       +
       	MISSING_FIELD = "MISSING_FIELD",

     

       13
       13
       +
       	INVALID_FORMAT = "INVALID_FORMAT",

     

       14
       14
       +
       	FILE_TOO_LARGE = "FILE_TOO_LARGE",

     

       15
       15
       +
       	UNSUPPORTED_FILE_TYPE = "UNSUPPORTED_FILE_TYPE",

     

       16
       16
       +
       

     

       17
       17
       +
       	// Transcription errors

     

       18
       18
       +
       	TRANSCRIPTION_NOT_FOUND = "TRANSCRIPTION_NOT_FOUND",

     

       19
       19
       +
       	TRANSCRIPTION_FAILED = "TRANSCRIPTION_FAILED",

     

       20
       20
       +
       	WHISPER_SERVICE_UNAVAILABLE = "WHISPER_SERVICE_UNAVAILABLE",

     

       21
       21
       +
       	WHISPER_SERVICE_ERROR = "WHISPER_SERVICE_ERROR",

     

       22
       22
       +
       	UPLOAD_FAILED = "UPLOAD_FAILED",

     

       23
       23
       +
       

     

       24
       24
       +
       	// Session errors

     

       25
       25
       +
       	SESSION_NOT_FOUND = "SESSION_NOT_FOUND",

     

       26
       26
       +
       	SESSION_REVOKE_FAILED = "SESSION_REVOKE_FAILED",

     

       27
       27
       +
       

     

       28
       28
       +
       	// User errors

     

       29
       29
       +
       	USER_UPDATE_FAILED = "USER_UPDATE_FAILED",

     

       30
       30
       +
       	USER_DELETE_FAILED = "USER_DELETE_FAILED",

     

       31
       31
       +
       

     

       32
       32
       +
       	// Generic errors

     

       33
       33
       +
       	INTERNAL_ERROR = "INTERNAL_ERROR",

     

       34
       34
       +
       	NOT_FOUND = "NOT_FOUND",

     

       35
       35
       +
       }

     

       36
       36
       +
       

     

       37
       37
       +
       export interface ApiError {

     

       38
       38
       +
       	error: string;

     

       39
       39
       +
       	code: ErrorCode;

     

       40
       40
       +
       	details?: string;

     

       41
       41
       +
       	field?: string;

     

       42
       42
       +
       }

     

       43
       43
       +
       

     

       44
       44
       +
       export class AppError extends Error {

     

       45
       45
       +
       	constructor(

     

       46
       46
       +
       		public code: ErrorCode,

     

       47
       47
       +
       		message: string,

     

       48
       48
       +
       		public statusCode: number = 500,

     

       49
       49
       +
       		public details?: string,

     

       50
       50
       +
       		public field?: string,

     

       51
       51
       +
       	) {

     

       52
       52
       +
       		super(message);

     

       53
       53
       +
       		this.name = "AppError";

     

       54
       54
       +
       	}

     

       55
       55
       +
       

     

       56
       56
       +
       	toJSON(): ApiError {

     

       57
       57
       +
       		return {

     

       58
       58
       +
       			error: this.message,

     

       59
       59
       +
       			code: this.code,

     

       60
       60
       +
       			details: this.details,

     

       61
       61
       +
       			field: this.field,

     

       62
       62
       +
       		};

     

       63
       63
       +
       	}

     

       64
       64
       +
       

     

       65
       65
       +
       	toResponse(): Response {

     

       66
       66
       +
       		return Response.json(this.toJSON(), { status: this.statusCode });

     

       67
       67
       +
       	}

     

       68
       68
       +
       }

     

       69
       69
       +
       

     

       70
       70
       +
       // Helper functions for common errors

     

       71
       71
       +
       export const AuthErrors = {

     

       72
       72
       +
       	required: () =>

     

       73
       73
       +
       		new AppError(ErrorCode.AUTH_REQUIRED, "Authentication required", 401),

     

       74
       74
       +
       	invalidSession: () =>

     

       75
       75
       +
       		new AppError(ErrorCode.INVALID_SESSION, "Invalid or expired session", 401),

     

       76
       76
       +
       	invalidCredentials: () =>

     

       77
       77
       +
       		new AppError(

     

       78
       78
       +
       			ErrorCode.INVALID_CREDENTIALS,

     

       79
       79
       +
       			"Invalid email or password",

     

       80
       80
       +
       			401,

     

       81
       81
       +
       		),

     

       82
       82
       +
       	emailExists: () =>

     

       83
       83
       +
       		new AppError(

     

       84
       84
       +
       			ErrorCode.EMAIL_ALREADY_EXISTS,

     

       85
       85
       +
       			"Email already registered",

     

       86
       86
       +
       			400,

     

       87
       87
       +
       		),

     

       88
       88
       +
       };

     

       89
       89
       +
       

     

       90
       90
       +
       export const ValidationErrors = {

     

       91
       91
       +
       	missingField: (field: string) =>

     

       92
       92
       +
       		new AppError(

     

       93
       93
       +
       			ErrorCode.MISSING_FIELD,

     

       94
       94
       +
       			`${field} is required`,

     

       95
       95
       +
       			400,

     

       96
       96
       +
       			undefined,

     

       97
       97
       +
       			field,

     

       98
       98
       +
       		),

     

       99
       99
       +
       	invalidFormat: (field: string, details?: string) =>

     

       100
       100
       +
       		new AppError(

     

       101
       101
       +
       			ErrorCode.INVALID_FORMAT,

     

       102
       102
       +
       			`Invalid ${field} format`,

     

       103
       103
       +
       			400,

     

       104
       104
       +
       			details,

     

       105
       105
       +
       			field,

     

       106
       106
       +
       		),

     

       107
       107
       +
       	fileTooLarge: (maxSize: string) =>

     

       108
       108
       +
       		new AppError(

     

       109
       109
       +
       			ErrorCode.FILE_TOO_LARGE,

     

       110
       110
       +
       			`File size must be less than ${maxSize}`,

     

       111
       111
       +
       			400,

     

       112
       112
       +
       		),

     

       113
       113
       +
       	unsupportedFileType: (supportedTypes: string) =>

     

       114
       114
       +
       		new AppError(

     

       115
       115
       +
       			ErrorCode.UNSUPPORTED_FILE_TYPE,

     

       116
       116
       +
       			`Unsupported file type. Supported: ${supportedTypes}`,

     

       117
       117
       +
       			400,

     

       118
       118
       +
       		),

     

       119
       119
       +
       };

     

       120
       120
       +
       

     

       121
       121
       +
       export const TranscriptionErrors = {

     

       122
       122
       +
       	notFound: () =>

     

       123
       123
       +
       		new AppError(

     

       124
       124
       +
       			ErrorCode.TRANSCRIPTION_NOT_FOUND,

     

       125
       125
       +
       			"Transcription not found",

     

       126
       126
       +
       			404,

     

       127
       127
       +
       		),

     

       128
       128
       +
       	failed: (details?: string) =>

     

       129
       129
       +
       		new AppError(

     

       130
       130
       +
       			ErrorCode.TRANSCRIPTION_FAILED,

     

       131
       131
       +
       			"Transcription failed",

     

       132
       132
       +
       			500,

     

       133
       133
       +
       			details,

     

       134
       134
       +
       		),

     

       135
       135
       +
       	serviceUnavailable: () =>

     

       136
       136
       +
       		new AppError(

     

       137
       137
       +
       			ErrorCode.WHISPER_SERVICE_UNAVAILABLE,

     

       138
       138
       +
       			"Transcription service unavailable",

     

       139
       139
       +
       			503,

     

       140
       140
       +
       			"The Whisper transcription service is not responding. Please try again later.",

     

       141
       141
       +
       		),

     

       142
       142
       +
       	serviceError: (details: string) =>

     

       143
       143
       +
       		new AppError(

     

       144
       144
       +
       			ErrorCode.WHISPER_SERVICE_ERROR,

     

       145
       145
       +
       			"Transcription service error",

     

       146
       146
       +
       			502,

     

       147
       147
       +
       			details,

     

       148
       148
       +
       		),

     

       149
       149
       +
       	uploadFailed: (details?: string) =>

     

       150
       150
       +
       		new AppError(ErrorCode.UPLOAD_FAILED, "Upload failed", 500, details),

     

       151
       151
       +
       };

     

       152
       152
       +
       

     

       153
       153
       +
       export const SessionErrors = {

     

       154
       154
       +
       	notFound: () =>

     

       155
       155
       +
       		new AppError(ErrorCode.SESSION_NOT_FOUND, "Session not found", 404),

     

       156
       156
       +
       	revokeFailed: () =>

     

       157
       157
       +
       		new AppError(

     

       158
       158
       +
       			ErrorCode.SESSION_REVOKE_FAILED,

     

       159
       159
       +
       			"Failed to revoke session",

     

       160
       160
       +
       			500,

     

       161
       161
       +
       		),

     

       162
       162
       +
       };

     

       163
       163
       +
       

     

       164
       164
       +
       export const UserErrors = {

     

       165
       165
       +
       	updateFailed: (field: string, details?: string) =>

     

       166
       166
       +
       		new AppError(

     

       167
       167
       +
       			ErrorCode.USER_UPDATE_FAILED,

     

       168
       168
       +
       			`Failed to update ${field}`,

     

       169
       169
       +
       			500,

     

       170
       170
       +
       			details,

     

       171
       171
       +
       		),

     

       172
       172
       +
       	deleteFailed: () =>

     

       173
       173
       +
       		new AppError(ErrorCode.USER_DELETE_FAILED, "Failed to delete user", 500),

     

       174
       174
       +
       };

     

       175
       175
       +
       

     

       176
       176
       +
       // Generic error handler

     

       177
       177
       +
       export function handleError(error: unknown): Response {

     

       178
       178
       +
       	if (error instanceof AppError) {

     

       179
       179
       +
       		return error.toResponse();

     

       180
       180
       +
       	}

     

       181
       181
       +
       

     

       182
       182
       +
       	// Handle database unique constraint errors

     

       183
       183
       +
       	if (

     

       184
       184
       +
       		error instanceof Error &&

     

       185
       185
       +
       		error.message?.includes("UNIQUE constraint failed")

     

       186
       186
       +
       	) {

     

       187
       187
       +
       		if (error.message.includes("email")) {

     

       188
       188
       +
       			return AuthErrors.emailExists().toResponse();

     

       189
       189
       +
       		}

     

       190
       190
       +
       	}

     

       191
       191
       +
       

     

       192
       192
       +
       	// Log unexpected errors

     

       193
       193
       +
       	console.error("Unexpected error:", error);

     

       194
       194
       +
       

     

       195
       195
       +
       	// Return generic error

     

       196
       196
       +
       	return new AppError(

     

       197
       197
       +
       		ErrorCode.INTERNAL_ERROR,

     

       198
       198
       +
       		"An unexpected error occurred",

     

       199
       199
       +
       		500,

     

       200
       200
       +
       	).toResponse();

     

       201
       201
       +
       }

+23

src/lib/middleware.ts

···

       1
       1
       +
       // Helper functions for route authentication and error handling

     

       2
       2
       +
       

     

       3
       3
       +
       import type { User } from "./auth";

     

       4
       4
       +
       import { getSessionFromRequest, getUserBySession } from "./auth";

     

       5
       5
       +
       import { AuthErrors } from "./errors";

     

       6
       6
       +
       

     

       7
       7
       +
       export interface AuthenticatedRequest extends Request {

     

       8
       8
       +
       	user: User;

     

       9
       9
       +
       }

     

       10
       10
       +
       

     

       11
       11
       +
       export function requireAuth(req: Request): User {

     

       12
       12
       +
       	const sessionId = getSessionFromRequest(req);

     

       13
       13
       +
       	if (!sessionId) {

     

       14
       14
       +
       		throw AuthErrors.required();

     

       15
       15
       +
       	}

     

       16
       16
       +
       

     

       17
       17
       +
       	const user = getUserBySession(sessionId);

     

       18
       18
       +
       	if (!user) {

     

       19
       19
       +
       		throw AuthErrors.invalidSession();

     

       20
       20
       +
       	}

     

       21
       21
       +
       

     

       22
       22
       +
       	return user;

     

       23
       23
       +
       }

+510

src/lib/transcription.ts

···

       1
       1
       +
       import type { Database } from "bun:sqlite";

     

       2
       2
       +
       import { createEventSource } from "eventsource-client";

     

       3
       3
       +
       import { ErrorCode } from "./errors";

     

       4
       4
       +
       

     

       5
       5
       +
       // Constants

     

       6
       6
       +
       export const MAX_FILE_SIZE = 25 * 1024 * 1024; // 25MB

     

       7
       7
       +
       export const MAX_TRANSCRIPT_LENGTH = 50000;

     

       8
       8
       +
       export const MAX_ERROR_LENGTH = 255;

     

       9
       9
       +
       

     

       10
       10
       +
       // Types

     

       11
       11
       +
       export type TranscriptionStatus =

     

       12
       12
       +
       	| "uploading"

     

       13
       13
       +
       	| "processing"

     

       14
       14
       +
       	| "completed"

     

       15
       15
       +
       	| "failed";

     

       16
       16
       +
       

     

       17
       17
       +
       export interface TranscriptionUpdate {

     

       18
       18
       +
       	status: TranscriptionStatus;

     

       19
       19
       +
       	progress: number;

     

       20
       20
       +
       	transcript?: string;

     

       21
       21
       +
       	error_message?: string;

     

       22
       22
       +
       	error_code?: string;

     

       23
       23
       +
       }

     

       24
       24
       +
       

     

       25
       25
       +
       export interface WhisperJob {

     

       26
       26
       +
       	id: string;

     

       27
       27
       +
       	status: string;

     

       28
       28
       +
       	progress?: number;

     

       29
       29
       +
       	transcript?: string;

     

       30
       30
       +
       	error_message?: string;

     

       31
       31
       +
       }

     

       32
       32
       +
       

     

       33
       33
       +
       // Event emitter for real-time transcription updates with automatic cleanup

     

       34
       34
       +
       export class TranscriptionEventEmitter {

     

       35
       35
       +
       	private listeners = new Map<

     

       36
       36
       +
       		string,

     

       37
       37
       +
       		Set<(data: TranscriptionUpdate) => void>

     

       38
       38
       +
       	>();

     

       39
       39
       +
       	private cleanupTimers = new Map<string, NodeJS.Timeout>();

     

       40
       40
       +
       

     

       41
       41
       +
       	on(transcriptionId: string, callback: (data: TranscriptionUpdate) => void) {

     

       42
       42
       +
       		if (!this.listeners.has(transcriptionId)) {

     

       43
       43
       +
       			this.listeners.set(transcriptionId, new Set());

     

       44
       44
       +
       		}

     

       45
       45
       +
       		this.listeners.get(transcriptionId)?.add(callback);

     

       46
       46
       +
       

     

       47
       47
       +
       		// Clear any pending cleanup for this transcription

     

       48
       48
       +
       		const timer = this.cleanupTimers.get(transcriptionId);

     

       49
       49
       +
       		if (timer) {

     

       50
       50
       +
       			clearTimeout(timer);

     

       51
       51
       +
       			this.cleanupTimers.delete(transcriptionId);

     

       52
       52
       +
       		}

     

       53
       53
       +
       	}

     

       54
       54
       +
       

     

       55
       55
       +
       	off(transcriptionId: string, callback: (data: TranscriptionUpdate) => void) {

     

       56
       56
       +
       		this.listeners.get(transcriptionId)?.delete(callback);

     

       57
       57
       +
       

     

       58
       58
       +
       		// Schedule cleanup if no listeners remain

     

       59
       59
       +
       		if (this.listeners.get(transcriptionId)?.size === 0) {

     

       60
       60
       +
       			this.scheduleCleanup(transcriptionId);

     

       61
       61
       +
       		}

     

       62
       62
       +
       	}

     

       63
       63
       +
       

     

       64
       64
       +
       	emit(transcriptionId: string, data: TranscriptionUpdate) {

     

       65
       65
       +
       		const callbacks = this.listeners.get(transcriptionId);

     

       66
       66
       +
       		if (callbacks) {

     

       67
       67
       +
       			for (const callback of callbacks) {

     

       68
       68
       +
       				callback(data);

     

       69
       69
       +
       			}

     

       70
       70
       +
       		}

     

       71
       71
       +
       

     

       72
       72
       +
       		// Auto-cleanup completed/failed jobs after emission

     

       73
       73
       +
       		if (data.status === "completed" || data.status === "failed") {

     

       74
       74
       +
       			this.scheduleCleanup(transcriptionId);

     

       75
       75
       +
       		}

     

       76
       76
       +
       	}

     

       77
       77
       +
       

     

       78
       78
       +
       	hasListeners(transcriptionId: string): boolean {

     

       79
       79
       +
       		return (this.listeners.get(transcriptionId)?.size ?? 0) > 0;

     

       80
       80
       +
       	}

     

       81
       81
       +
       

     

       82
       82
       +
       	private scheduleCleanup(transcriptionId: string) {

     

       83
       83
       +
       		// Clean up listeners after 5 minutes of inactivity

     

       84
       84
       +
       		const timer = setTimeout(

     

       85
       85
       +
       			() => {

     

       86
       86
       +
       				this.listeners.delete(transcriptionId);

     

       87
       87
       +
       				this.cleanupTimers.delete(transcriptionId);

     

       88
       88
       +
       			},

     

       89
       89
       +
       			5 * 60 * 1000,

     

       90
       90
       +
       		);

     

       91
       91
       +
       

     

       92
       92
       +
       		this.cleanupTimers.set(transcriptionId, timer);

     

       93
       93
       +
       	}

     

       94
       94
       +
       }

     

       95
       95
       +
       

     

       96
       96
       +
       // Whisper service manager

     

       97
       97
       +
       export class WhisperServiceManager {

     

       98
       98
       +
       	private activeStreams = new Map<

     

       99
       99
       +
       		string,

     

       100
       100
       +
       		ReturnType<typeof createEventSource>

     

       101
       101
       +
       	>();

     

       102
       102
       +
       	private streamLocks = new Set<string>();

     

       103
       103
       +
       

     

       104
       104
       +
       	constructor(

     

       105
       105
       +
       		private serviceUrl: string,

     

       106
       106
       +
       		private db: Database,

     

       107
       107
       +
       		private events: TranscriptionEventEmitter,

     

       108
       108
       +
       	) {}

     

       109
       109
       +
       

     

       110
       110
       +
       	async startTranscription(

     

       111
       111
       +
       		transcriptionId: string,

     

       112
       112
       +
       		filename: string,

     

       113
       113
       +
       	): Promise<void> {

     

       114
       114
       +
       		try {

     

       115
       115
       +
       			// Update status to processing

     

       116
       116
       +
       			this.updateTranscription(transcriptionId, {

     

       117
       117
       +
       				status: "processing",

     

       118
       118
       +
       				progress: 10,

     

       119
       119
       +
       			});

     

       120
       120
       +
       

     

       121
       121
       +
       			// Read file from disk

     

       122
       122
       +
       			const filePath = `./uploads/${filename}`;

     

       123
       123
       +
       			const fileBuffer = await Bun.file(filePath).arrayBuffer();

     

       124
       124
       +
       

     

       125
       125
       +
       			// Create form data for the faster-whisper server

     

       126
       126
       +
       			const formData = new FormData();

     

       127
       127
       +
       			const file = new File([fileBuffer], filename, { type: "audio/mpeg" });

     

       128
       128
       +
       			formData.append("file", file);

     

       129
       129
       +
       

     

       130
       130
       +
       			// Call the faster-whisper server to start transcription

     

       131
       131
       +
       			const response = await fetch(`${this.serviceUrl}/transcribe`, {

     

       132
       132
       +
       				method: "POST",

     

       133
       133
       +
       				body: formData,

     

       134
       134
       +
       			});

     

       135
       135
       +
       

     

       136
       136
       +
       			if (!response.ok) {

     

       137
       137
       +
       				const errorText = await response.text().catch(() => "Unknown error");

     

       138
       138
       +
       				throw new Error(

     

       139
       139
       +
       					`Whisper service returned ${response.status}: ${errorText}`,

     

       140
       140
       +
       				);

     

       141
       141
       +
       			}

     

       142
       142
       +
       

     

       143
       143
       +
       			const { job_id } = await response.json();

     

       144
       144
       +
       			console.log(

     

       145
       145
       +
       				`[Transcription] Created Whisper job ${job_id} for ${transcriptionId}`,

     

       146
       146
       +
       			);

     

       147
       147
       +
       

     

       148
       148
       +
       			// Connect to SSE stream from Whisper

     

       149
       149
       +
       			this.streamWhisperJob(transcriptionId, job_id, filePath);

     

       150
       150
       +
       		} catch (error) {

     

       151
       151
       +
       			console.error(

     

       152
       152
       +
       				`[Transcription] Failed to start ${transcriptionId}:`,

     

       153
       153
       +
       				error,

     

       154
       154
       +
       			);

     

       155
       155
       +
       			const errorMessage =

     

       156
       156
       +
       				error instanceof Error ? error.message : "Unknown error";

     

       157
       157
       +
       			const errorCode =

     

       158
       158
       +
       				error instanceof Error && error.message.includes("Whisper service")

     

       159
       159
       +
       					? ErrorCode.WHISPER_SERVICE_ERROR

     

       160
       160
       +
       					: ErrorCode.TRANSCRIPTION_FAILED;

     

       161
       161
       +
       

     

       162
       162
       +
       			this.updateTranscription(transcriptionId, {

     

       163
       163
       +
       				status: "failed",

     

       164
       164
       +
       				error_message: errorMessage,

     

       165
       165
       +
       			});

     

       166
       166
       +
       

     

       167
       167
       +
       			this.events.emit(transcriptionId, {

     

       168
       168
       +
       				status: "failed",

     

       169
       169
       +
       				progress: 0,

     

       170
       170
       +
       				error_message: errorMessage,

     

       171
       171
       +
       				error_code: errorCode,

     

       172
       172
       +
       			});

     

       173
       173
       +
       		}

     

       174
       174
       +
       	}

     

       175
       175
       +
       

     

       176
       176
       +
       	private streamWhisperJob(

     

       177
       177
       +
       		transcriptionId: string,

     

       178
       178
       +
       		jobId: string,

     

       179
       179
       +
       		filePath: string,

     

       180
       180
       +
       	) {

     

       181
       181
       +
       		// Prevent duplicate streams using locks

     

       182
       182
       +
       		if (this.streamLocks.has(transcriptionId)) {

     

       183
       183
       +
       			console.log(`[Stream] Already streaming ${transcriptionId}, skipping`);

     

       184
       184
       +
       			return;

     

       185
       185
       +
       		}

     

       186
       186
       +
       

     

       187
       187
       +
       		this.streamLocks.add(transcriptionId);

     

       188
       188
       +
       

     

       189
       189
       +
       		const es = createEventSource({

     

       190
       190
       +
       			url: `${this.serviceUrl}/transcribe/${jobId}/stream`,

     

       191
       191
       +
       			onMessage: ({ data }) => {

     

       192
       192
       +
       				try {

     

       193
       193
       +
       					const update = JSON.parse(data) as WhisperJob;

     

       194
       194
       +
       					this.handleWhisperUpdate(transcriptionId, jobId, filePath, update);

     

       195
       195
       +
       				} catch (err) {

     

       196
       196
       +
       					console.error(

     

       197
       197
       +
       						`[Stream] Error processing update for ${transcriptionId}:`,

     

       198
       198
       +
       						err,

     

       199
       199
       +
       					);

     

       200
       200
       +
       				}

     

       201
       201
       +
       			},

     

       202
       202
       +
       		});

     

       203
       203
       +
       

     

       204
       204
       +
       		this.activeStreams.set(transcriptionId, es);

     

       205
       205
       +
       	}

     

       206
       206
       +
       

     

       207
       207
       +
       	private handleWhisperUpdate(

     

       208
       208
       +
       		transcriptionId: string,

     

       209
       209
       +
       		jobId: string,

     

       210
       210
       +
       		filePath: string,

     

       211
       211
       +
       		update: WhisperJob,

     

       212
       212
       +
       	) {

     

       213
       213
       +
       		if (update.status === "processing") {

     

       214
       214
       +
       			const progress = Math.max(10, Math.min(95, update.progress ?? 0));

     

       215
       215
       +
       			this.updateTranscription(transcriptionId, { progress });

     

       216
       216
       +
       

     

       217
       217
       +
       			this.events.emit(transcriptionId, {

     

       218
       218
       +
       				status: "processing",

     

       219
       219
       +
       				progress,

     

       220
       220
       +
       			});

     

       221
       221
       +
       		} else if (update.status === "completed") {

     

       222
       222
       +
       			const transcript = (update.transcript ?? "").substring(

     

       223
       223
       +
       				0,

     

       224
       224
       +
       				MAX_TRANSCRIPT_LENGTH,

     

       225
       225
       +
       			);

     

       226
       226
       +
       

     

       227
       227
       +
       			this.updateTranscription(transcriptionId, {

     

       228
       228
       +
       				status: "completed",

     

       229
       229
       +
       				progress: 100,

     

       230
       230
       +
       				transcript,

     

       231
       231
       +
       			});

     

       232
       232
       +
       

     

       233
       233
       +
       			this.events.emit(transcriptionId, {

     

       234
       234
       +
       				status: "completed",

     

       235
       235
       +
       				progress: 100,

     

       236
       236
       +
       				transcript,

     

       237
       237
       +
       			});

     

       238
       238
       +
       

     

       239
       239
       +
       			// Clean up

     

       240
       240
       +
       			this.cleanupJob(transcriptionId, jobId, filePath);

     

       241
       241
       +
       		} else if (update.status === "failed") {

     

       242
       242
       +
       			const errorMessage = (

     

       243
       243
       +
       				update.error_message ?? "Transcription failed"

     

       244
       244
       +
       			).substring(0, MAX_ERROR_LENGTH);

     

       245
       245
       +
       

     

       246
       246
       +
       			this.updateTranscription(transcriptionId, {

     

       247
       247
       +
       				status: "failed",

     

       248
       248
       +
       				error_message: errorMessage,

     

       249
       249
       +
       			});

     

       250
       250
       +
       

     

       251
       251
       +
       			this.events.emit(transcriptionId, {

     

       252
       252
       +
       				status: "failed",

     

       253
       253
       +
       				progress: 0,

     

       254
       254
       +
       				error_message: errorMessage,

     

       255
       255
       +
       				error_code: ErrorCode.TRANSCRIPTION_FAILED,

     

       256
       256
       +
       			});

     

       257
       257
       +
       

     

       258
       258
       +
       			this.closeStream(transcriptionId);

     

       259
       259
       +
       			this.deleteWhisperJob(jobId);

     

       260
       260
       +
       		}

     

       261
       261
       +
       	}

     

       262
       262
       +
       

     

       263
       263
       +
       	private cleanupJob(transcriptionId: string, jobId: string, filePath: string) {

     

       264
       264
       +
       		// Delete uploaded file

     

       265
       265
       +
       		Bun.file(filePath)

     

       266
       266
       +
       			.text()

     

       267
       267
       +
       			.then(() => Bun.write(filePath, ""))

     

       268
       268
       +
       			.catch(() => {});

     

       269
       269
       +
       

     

       270
       270
       +
       		this.closeStream(transcriptionId);

     

       271
       271
       +
       		this.deleteWhisperJob(jobId);

     

       272
       272
       +
       	}

     

       273
       273
       +
       

     

       274
       274
       +
       	private closeStream(transcriptionId: string) {

     

       275
       275
       +
       		const es = this.activeStreams.get(transcriptionId);

     

       276
       276
       +
       		if (es) {

     

       277
       277
       +
       			es.close();

     

       278
       278
       +
       			this.activeStreams.delete(transcriptionId);

     

       279
       279
       +
       		}

     

       280
       280
       +
       		this.streamLocks.delete(transcriptionId);

     

       281
       281
       +
       	}

     

       282
       282
       +
       

     

       283
       283
       +
       	private async deleteWhisperJob(jobId: string) {

     

       284
       284
       +
       		try {

     

       285
       285
       +
       			await fetch(`${this.serviceUrl}/transcribe/${jobId}`, {

     

       286
       286
       +
       				method: "DELETE",

     

       287
       287
       +
       			});

     

       288
       288
       +
       		} catch {

     

       289
       289
       +
       			// Silent fail - job may already be deleted

     

       290
       290
       +
       		}

     

       291
       291
       +
       	}

     

       292
       292
       +
       

     

       293
       293
       +
       	private updateTranscription(

     

       294
       294
       +
       		transcriptionId: string,

     

       295
       295
       +
       		data: {

     

       296
       296
       +
       			status?: TranscriptionStatus;

     

       297
       297
       +
       			progress?: number;

     

       298
       298
       +
       			transcript?: string;

     

       299
       299
       +
       			error_message?: string;

     

       300
       300
       +
       		},

     

       301
       301
       +
       	) {

     

       302
       302
       +
       		const updates: string[] = [];

     

       303
       303
       +
       		const values: (string | number)[] = [];

     

       304
       304
       +
       

     

       305
       305
       +
       		if (data.status !== undefined) {

     

       306
       306
       +
       			updates.push("status = ?");

     

       307
       307
       +
       			values.push(data.status);

     

       308
       308
       +
       		}

     

       309
       309
       +
       		if (data.progress !== undefined) {

     

       310
       310
       +
       			updates.push("progress = ?");

     

       311
       311
       +
       			values.push(data.progress);

     

       312
       312
       +
       		}

     

       313
       313
       +
       		if (data.transcript !== undefined) {

     

       314
       314
       +
       			updates.push("transcript = ?");

     

       315
       315
       +
       			values.push(data.transcript);

     

       316
       316
       +
       		}

     

       317
       317
       +
       		if (data.error_message !== undefined) {

     

       318
       318
       +
       			updates.push("error_message = ?");

     

       319
       319
       +
       			values.push(data.error_message);

     

       320
       320
       +
       		}

     

       321
       321
       +
       

     

       322
       322
       +
       		updates.push("updated_at = ?");

     

       323
       323
       +
       		values.push(Math.floor(Date.now() / 1000));

     

       324
       324
       +
       

     

       325
       325
       +
       		values.push(transcriptionId);

     

       326
       326
       +
       

     

       327
       327
       +
       		this.db.run(

     

       328
       328
       +
       			`UPDATE transcriptions SET ${updates.join(", ")} WHERE id = ?`,

     

       329
       329
       +
       			values,

     

       330
       330
       +
       		);

     

       331
       331
       +
       	}

     

       332
       332
       +
       

     

       333
       333
       +
       	async syncWithWhisper(): Promise<void> {

     

       334
       334
       +
       		try {

     

       335
       335
       +
       			const whisperJobs = await this.fetchWhisperJobs();

     

       336
       336
       +
       			if (!whisperJobs) return;

     

       337
       337
       +
       

     

       338
       338
       +
       			const activeDbJobs = this.getActiveDbJobs();

     

       339
       339
       +
       			const activeJobsMap = new Map(activeDbJobs.map((j) => [j.id, j]));

     

       340
       340
       +
       

     

       341
       341
       +
       			await this.syncWhisperJobsToDb(whisperJobs, activeJobsMap);

     

       342
       342
       +
       			await this.syncDbJobsToWhisper(activeDbJobs, whisperJobs);

     

       343
       343
       +
       		} catch (error) {

     

       344
       344
       +
       			console.warn(

     

       345
       345
       +
       				"[Sync] Failed:",

     

       346
       346
       +
       				error instanceof Error ? error.message : "Unknown error",

     

       347
       347
       +
       			);

     

       348
       348
       +
       		}

     

       349
       349
       +
       	}

     

       350
       350
       +
       

     

       351
       351
       +
       	private async fetchWhisperJobs(): Promise<WhisperJob[] | null> {

     

       352
       352
       +
       		try {

     

       353
       353
       +
       			const response = await fetch(`${this.serviceUrl}/jobs`);

     

       354
       354
       +
       			if (!response.ok) {

     

       355
       355
       +
       				console.warn("[Sync] Whisper service unavailable");

     

       356
       356
       +
       				return null;

     

       357
       357
       +
       			}

     

       358
       358
       +
       			const { jobs } = await response.json();

     

       359
       359
       +
       			return jobs;

     

       360
       360
       +
       		} catch {

     

       361
       361
       +
       			return null;

     

       362
       362
       +
       		}

     

       363
       363
       +
       	}

     

       364
       364
       +
       

     

       365
       365
       +
       	private getActiveDbJobs(): Array<{

     

       366
       366
       +
       		id: string;

     

       367
       367
       +
       		filename: string;

     

       368
       368
       +
       		status: string;

     

       369
       369
       +
       	}> {

     

       370
       370
       +
       		return this.db

     

       371
       371
       +
       			.query<{ id: string; filename: string; status: string }, []>(

     

       372
       372
       +
       				"SELECT id, filename, status FROM transcriptions WHERE status IN ('uploading', 'processing')",

     

       373
       373
       +
       			)

     

       374
       374
       +
       			.all();

     

       375
       375
       +
       	}

     

       376
       376
       +
       

     

       377
       377
       +
       	private async syncWhisperJobsToDb(

     

       378
       378
       +
       		whisperJobs: WhisperJob[],

     

       379
       379
       +
       		activeJobsMap: Map<

     

       380
       380
       +
       			string,

     

       381
       381
       +
       			{ id: string; filename: string; status: string }

     

       382
       382
       +
       		>,

     

       383
       383
       +
       	) {

     

       384
       384
       +
       		for (const whisperJob of whisperJobs) {

     

       385
       385
       +
       			const localJob = activeJobsMap.get(whisperJob.id);

     

       386
       386
       +
       

     

       387
       387
       +
       			if (!localJob) {

     

       388
       388
       +
       				await this.handleOrphanedWhisperJob(whisperJob.id);

     

       389
       389
       +
       				continue;

     

       390
       390
       +
       			}

     

       391
       391
       +
       

     

       392
       392
       +
       			if (whisperJob.status === "completed" || whisperJob.status === "failed") {

     

       393
       393
       +
       				await this.syncCompletedJob(whisperJob);

     

       394
       394
       +
       			}

     

       395
       395
       +
       		}

     

       396
       396
       +
       	}

     

       397
       397
       +
       

     

       398
       398
       +
       	private async handleOrphanedWhisperJob(jobId: string) {

     

       399
       399
       +
       		const jobExists = this.db

     

       400
       400
       +
       			.query<{ id: string }, [string]>(

     

       401
       401
       +
       				"SELECT id FROM transcriptions WHERE id = ?",

     

       402
       402
       +
       			)

     

       403
       403
       +
       			.get(jobId);

     

       404
       404
       +
       

     

       405
       405
       +
       		if (!jobExists) {

     

       406
       406
       +
       			// Not our job, delete it from Whisper

     

       407
       407
       +
       			await this.deleteWhisperJob(jobId);

     

       408
       408
       +
       		}

     

       409
       409
       +
       	}

     

       410
       410
       +
       

     

       411
       411
       +
       	private async syncCompletedJob(whisperJob: WhisperJob) {

     

       412
       412
       +
       		try {

     

       413
       413
       +
       			const details = await this.fetchJobDetails(whisperJob.id);

     

       414
       414
       +
       			if (!details) return;

     

       415
       415
       +
       

     

       416
       416
       +
       			if (details.status === "completed") {

     

       417
       417
       +
       				const transcript =

     

       418
       418
       +
       					details.transcript?.substring(0, MAX_TRANSCRIPT_LENGTH) ?? "";

     

       419
       419
       +
       

     

       420
       420
       +
       				this.updateTranscription(whisperJob.id, {

     

       421
       421
       +
       					status: "completed",

     

       422
       422
       +
       					progress: 100,

     

       423
       423
       +
       					transcript,

     

       424
       424
       +
       				});

     

       425
       425
       +
       

     

       426
       426
       +
       				this.events.emit(whisperJob.id, {

     

       427
       427
       +
       					status: "completed",

     

       428
       428
       +
       					progress: 100,

     

       429
       429
       +
       					transcript,

     

       430
       430
       +
       				});

     

       431
       431
       +
       			} else if (details.status === "failed") {

     

       432
       432
       +
       				const errorMessage = (

     

       433
       433
       +
       					details.error_message ?? "Transcription failed"

     

       434
       434
       +
       				).substring(0, MAX_ERROR_LENGTH);

     

       435
       435
       +
       

     

       436
       436
       +
       				this.updateTranscription(whisperJob.id, {

     

       437
       437
       +
       					status: "failed",

     

       438
       438
       +
       					error_message: errorMessage,

     

       439
       439
       +
       				});

     

       440
       440
       +
       

     

       441
       441
       +
       				this.events.emit(whisperJob.id, {

     

       442
       442
       +
       					status: "failed",

     

       443
       443
       +
       					progress: 0,

     

       444
       444
       +
       					error_message: errorMessage,

     

       445
       445
       +
       				});

     

       446
       446
       +
       			}

     

       447
       447
       +
       

     

       448
       448
       +
       			await this.deleteWhisperJob(whisperJob.id);

     

       449
       449
       +
       		} catch {

     

       450
       450
       +
       			console.warn(

     

       451
       451
       +
       				`[Sync] Failed to retrieve details for job ${whisperJob.id}`,

     

       452
       452
       +
       			);

     

       453
       453
       +
       		}

     

       454
       454
       +
       	}

     

       455
       455
       +
       

     

       456
       456
       +
       	private async fetchJobDetails(jobId: string): Promise<WhisperJob | null> {

     

       457
       457
       +
       		const response = await fetch(`${this.serviceUrl}/transcribe/${jobId}`);

     

       458
       458
       +
       		if (!response.ok) return null;

     

       459
       459
       +
       		return response.json();

     

       460
       460
       +
       	}

     

       461
       461
       +
       

     

       462
       462
       +
       	private async syncDbJobsToWhisper(

     

       463
       463
       +
       		activeDbJobs: Array<{ id: string; filename: string; status: string }>,

     

       464
       464
       +
       		whisperJobs: WhisperJob[],

     

       465
       465
       +
       	) {

     

       466
       466
       +
       		for (const localJob of activeDbJobs) {

     

       467
       467
       +
       			const whisperHasJob = whisperJobs.some((wj) => wj.id === localJob.id);

     

       468
       468
       +
       

     

       469
       469
       +
       			if (!whisperHasJob) {

     

       470
       470
       +
       				// Job was lost, mark as failed

     

       471
       471
       +
       				const errorMessage = "Job lost - whisper service may have restarted";

     

       472
       472
       +
       

     

       473
       473
       +
       				this.updateTranscription(localJob.id, {

     

       474
       474
       +
       					status: "failed",

     

       475
       475
       +
       					error_message: errorMessage,

     

       476
       476
       +
       				});

     

       477
       477
       +
       

     

       478
       478
       +
       				this.events.emit(localJob.id, {

     

       479
       479
       +
       					status: "failed",

     

       480
       480
       +
       					progress: 0,

     

       481
       481
       +
       					error_message: errorMessage,

     

       482
       482
       +
       				});

     

       483
       483
       +
       			}

     

       484
       484
       +
       		}

     

       485
       485
       +
       	}

     

       486
       486
       +
       

     

       487
       487
       +
       	async cleanupStaleFiles(): Promise<void> {

     

       488
       488
       +
       		try {

     

       489
       489
       +
       			// Find transcriptions older than 24 hours that are completed or failed

     

       490
       490
       +
       			const staleTranscriptions = this.db

     

       491
       491
       +
       				.query<{ filename: string }, [number]>(

     

       492
       492
       +
       					`SELECT filename FROM transcriptions 

     

       493
       493
       +
       					 WHERE status IN ('completed', 'failed') 

     

       494
       494
       +
       					 AND updated_at < ?`,

     

       495
       495
       +
       				)

     

       496
       496
       +
       				.all(Math.floor(Date.now() / 1000) - 24 * 60 * 60);

     

       497
       497
       +
       

     

       498
       498
       +
       			for (const { filename } of staleTranscriptions) {

     

       499
       499
       +
       				const filePath = `./uploads/${filename}`;

     

       500
       500
       +
       				await Bun.write(filePath, "").catch(() => {});

     

       501
       501
       +
       			}

     

       502
       502
       +
       

     

       503
       503
       +
       			console.log(

     

       504
       504
       +
       				`[Cleanup] Removed ${staleTranscriptions.length} stale files`,

     

       505
       505
       +
       			);

     

       506
       506
       +
       		} catch (error) {

     

       507
       507
       +
       			console.error("[Cleanup] Failed:", error);

     

       508
       508
       +
       		}

     

       509
       509
       +
       	}

     

       510
       510
       +
       }