@balena/pinejs 17.1.0-build-joshbwlng-tasks-e3dcb0e73ea9c960af553c67cbf7121650f8d1ea-1 → 17.1.0-build-model-based-typings-c276ef4fb8482a246c25940d617d76b76847eff8-1

package/src/tasks/worker.ts

@@ -1,276 +0,0 @@
-import { setTimeout } from 'node:timers/promises';
-import type { AnyObject } from 'pinejs-client-core';
-import { tasks as tasksEnv } from '../config-loader/env';
-import type * as Db from '../database-layer/db';
-import { TransactionClosedError } from '../database-layer/db';
-import * as permissions from '../sbvr-api/permissions';
-import { PinejsClient } from '../sbvr-api/sbvr-utils';
-import { sbvrUtils } from '../server-glue/module';
-import { ajv, channel } from './common';
-import type { PartialTask, TaskHandler, TaskStatus } from './types';
-
-// Map of column names with SBVR names used in SELECT queries
-const selectColumns = Object.entries({
-	id: 'id',
-	'is executed by-handler': 'is_executed_by__handler',
-	'is executed with-parameter set': 'is_executed_with__parameter_set',
-	'is scheduled with-cron expression': 'is_scheduled_with__cron_expression',
-	'attempt count': 'attempt_count',
-	'attempt limit': 'attempt_limit',
-	'is created by-actor': 'is_created_by__actor',
-})
-	.map(([key, value]) => `t."${key}" AS "${value}"`)
-	.join(', ');
-
-// The worker is responsible for executing tasks in the queue. It listens for
-// notifications and polls the database for tasks to execute. It will execute
-// tasks in parallel up to a certain concurrency limit.
-export class Worker {
-	public handlers: Record<string, TaskHandler> = {};
-	private readonly concurrency: number;
-	private readonly interval: number;
-	private executing = 0;
-
-	constructor(private readonly client: PinejsClient) {
-		this.concurrency = tasksEnv.queueConcurrency;
-		this.interval = tasksEnv.queueIntervalMS;
-	}
-
-	// Check if instance can execute more tasks
-	private canExecute(): boolean {
-		return (
-			this.executing < this.concurrency && Object.keys(this.handlers).length > 0
-		);
-	}
-
-	private async execute(task: PartialTask, tx: Db.Tx): Promise<void> {
-		this.executing++;
-		try {
-			// Get specified handler
-			const handler = this.handlers[task.is_executed_by__handler];
-			const startedOnTime = new Date();
-			if (handler == null) {
-				await this.finalize(
-					tx,
-					task,
-					startedOnTime,
-					'failed',
-					'Matching task handler not found',
-				);
-				return;
-			}
-
-			// Validate parameters before execution so we can fail early if
-			// the parameter set is invalid. This can happen if the handler
-			// definition changes after a task is added to the queue.
-			if (
-				handler.validate != null &&
-				!handler.validate(task.is_executed_with__parameter_set)
-			) {
-				await this.finalize(
-					tx,
-					task,
-					startedOnTime,
-					'failed',
-					`Invalid parameter set: ${ajv.errorsText(handler.validate.errors)}`,
-				);
-				return;
-			}
-
-			// Execute handler
-			let status: TaskStatus = 'queued';
-			let error: string | undefined;
-			try {
-				await sbvrUtils.db.transaction(async (handlerTx) => {
-					const results = await handler.fn({
-						api: new PinejsClient({
-							passthrough: {
-								tx: handlerTx,
-							},
-						}),
-						params: task.is_executed_with__parameter_set ?? {},
-						tx: handlerTx,
-					});
-					status = results.status;
-					error = results.error;
-					if (results.status !== 'succeeded' && !handlerTx.isClosed()) {
-						await handlerTx.rollback();
-					}
-				});
-			} catch (err) {
-				// Ignore closed/rollback errors
-				if (!(err instanceof TransactionClosedError)) {
-					throw err;
-				}
-			} finally {
-				// Update task with results
-				await this.finalize(tx, task, startedOnTime, status, error);
-			}
-		} catch (err) {
-			// This shouldn't happen, but if it does we want to log and kill the process
-			console.error(
-				`Failed to execute task ${task.id} with handler ${task.is_executed_by__handler}:`,
-				err,
-			);
-			process.exit(1);
-		} finally {
-			this.executing--;
-		}
-	}
-
-	// Update task and schedule next attempt if needed
-	private async finalize(
-		tx: Db.Tx,
-		task: PartialTask,
-		startedOnTime: Date,
-		status: TaskStatus,
-		errorMessage?: string,
-	): Promise<void> {
-		const attemptCount = task.attempt_count + 1;
-		const body: AnyObject = {
-			started_on__time: startedOnTime,
-			ended_on__time: new Date(),
-			status,
-			attempt_count: attemptCount,
-			...(errorMessage != null && { error_message: errorMessage }),
-		};
-
-		// Re-enqueue if the task failed but has retries left, remember that
-		// attemptCount includes the initial attempt while attempt_limit does not
-		if (status === 'failed' && attemptCount < task.attempt_limit) {
-			body.status = 'queued';
-
-			// Schedule next attempt using exponential backoff
-			body.is_scheduled_to_execute_on__time =
-				this.getNextAttemptTime(attemptCount);
-		}
-
-		// Patch current task
-		await this.client.patch({
-			resource: 'task',
-			passthrough: {
-				tx,
-				req: permissions.root,
-			},
-			id: task.id,
-			body,
-		});
-
-		// Create new task with same configuration if previous
-		// iteration completed and has a cron expression
-		if (
-			['failed', 'succeeded'].includes(body.status) &&
-			task.is_scheduled_with__cron_expression != null
-		) {
-			await this.client.post({
-				resource: 'task',
-				passthrough: {
-					tx,
-					req: permissions.root,
-				},
-				options: {
-					returnResource: false,
-				},
-				body: {
-					attempt_limit: task.attempt_limit,
-					is_created_by__actor: task.is_created_by__actor,
-					is_executed_by__handler: task.is_executed_by__handler,
-					is_executed_with__parameter_set: task.is_executed_with__parameter_set,
-					is_scheduled_with__cron_expression:
-						task.is_scheduled_with__cron_expression,
-				},
-			});
-		}
-	}
-
-	// Calculate next attempt time using exponential backoff
-	private getNextAttemptTime(attempt: number): Date | null {
-		const delay = Math.ceil(Math.exp(Math.min(10, attempt)));
-		return new Date(Date.now() + delay);
-	}
-
-	// Poll for tasks to execute
-	private poll(): void {
-		let executed = false;
-		void (async () => {
-			try {
-				if (!this.canExecute()) {
-					return;
-				}
-				const handlerNames = Object.keys(this.handlers);
-				await sbvrUtils.db.transaction(async (tx) => {
-					const result = await tx.executeSql(
-						`SELECT ${selectColumns}
-						FROM task AS t
-						WHERE
-							t."is executed by-handler" IN (${handlerNames.map((_, index) => `$${index + 1}`).join(', ')}) AND
-							t."status" = 'queued' AND
-							t."attempt count" <= t."attempt limit" AND
-							(
-								t."is scheduled to execute on-time" IS NULL OR
-								t."is scheduled to execute on-time" <= CURRENT_TIMESTAMP + $${handlerNames.length + 1} * INTERVAL '1 SECOND'
-							)
-						ORDER BY
-							t."is scheduled to execute on-time" ASC,
-							t."id" ASC
-						LIMIT $${handlerNames.length + 2}
-						FOR UPDATE SKIP LOCKED`,
-						[
-							...handlerNames,
-							Math.ceil(this.interval / 1000),
-							Math.max(this.concurrency - this.executing, 0),
-						],
-					);
-					if (result.rows.length === 0) {
-						return;
-					}
-
-					// Tasks found, execute them in parallel
-					await Promise.all(
-						result.rows.map(async (row) => {
-							await this.execute(row as PartialTask, tx);
-						}),
-					);
-					executed = true;
-				});
-			} catch (err) {
-				console.error('Failed polling for tasks:', err);
-			} finally {
-				if (!executed) {
-					await setTimeout(this.interval);
-				}
-				this.poll();
-			}
-		})();
-	}
-
-	// Start listening and polling for tasks
-	public start(): void {
-		// Tasks only support postgres for now
-		if (sbvrUtils.db.engine !== 'postgres' || sbvrUtils.db.on == null) {
-			throw new Error(
-				'Database does not support tasks, giving up on starting worker',
-			);
-		}
-		sbvrUtils.db.on(
-			'notification',
-			async (msg) => {
-				if (this.canExecute()) {
-					await sbvrUtils.db.transaction(async (tx) => {
-						const result = await tx.executeSql(
-							`SELECT ${selectColumns} FROM task AS t WHERE id = $1 FOR UPDATE SKIP LOCKED`,
-							[msg.payload],
-						);
-						if (result.rows.length > 0) {
-							await this.execute(result.rows[0] as PartialTask, tx);
-						}
-					});
-				}
-			},
-			{
-				channel,
-			},
-		);
-		this.poll();
-	}
-}