@balena/pinejs 17.1.0-build-model-based-typings-85488426453e79d26b93e0ac91f30b73beb2c181-1 → 17.1.0-build-joshbwlng-tasks-0c116dc98102e3ddd4aa6e8a4f350a1e18891e1a-1

package/src/database-layer/db.ts

@@ -98,6 +98,13 @@ export interface Database extends BaseDatabase {
 	) => Promise<Result>;
 	transaction: TransactionFn;
 	readTransaction: TransactionFn;
+	on?: (
+		name: 'notification',
+		fn: (...args: any[]) => Promise<void>,
+		options?: {
+			channel?: string;
+		},
+	) => void;
 }
 
 interface EngineParams {
@@ -689,6 +696,24 @@ if (maybePg != null) {
 		return {
 			engine: Engines.postgres,
 			executeSql: atomicExecuteSql,
+			on: async (name, fn, options) => {
+				if (name === 'notification' && options?.channel === undefined) {
+					throw new Error('Missing channel option for notification listener');
+				}
+
+				const client = await pool.connect();
+				client.on(name, async (msg) => {
+					try {
+						await fn(msg);
+					} catch (error) {
+						console.error('Error handling message:', error);
+					}
+				});
+
+				if (name === 'notification' && options?.channel !== undefined) {
+					await client.query(`LISTEN "${options.channel}";`);
+				}
+			},
 			transaction: createTransaction(async (stackTraceErr) => {
 				const client = await pool.connect();
 				const tx = new PostgresTx(client, false, stackTraceErr);

package/src/migrator/sync.ts

@@ -1,4 +1,3 @@
-import type MigrationsModel from './migrations';
 import {
 	type MigrationTuple,
 	MigrationError,
@@ -17,7 +16,7 @@ import _ from 'lodash';
 import * as sbvrUtils from '../sbvr-api/sbvr-utils';
 
 // eslint-disable-next-line @typescript-eslint/no-var-requires
-const migrationsModel = require('./migrations.sbvr');
+const modelText = require('./migrations.sbvr');
 
 type ApiRootModel = Model & { apiRoot: string };
 
@@ -137,49 +136,45 @@ const executeMigration = async (
 	}
 };
 
-declare module '../sbvr-api/sbvr-utils' {
-	export interface API {
-		[migrationModelConfig.apiRoot]: PinejsClient<MigrationsModel>;
-	}
-}
-const migrationModelConfig = {
-	modelName: 'migrations',
-	apiRoot: 'migrations',
-	modelText: migrationsModel,
-	migrations: {
-		'11.0.0-modified-at': `
-			ALTER TABLE "migration"
-			ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
-		`,
-		'11.0.1-modified-at': `
-			ALTER TABLE "migration lock"
-			ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
-		`,
-		'15.0.0-data-types': async (tx, { db }) => {
-			switch (db.engine) {
-				case 'mysql':
-					await tx.executeSql(`\
-						ALTER TABLE "migration"
-						MODIFY "executed migrations" JSON NOT NULL;`);
-					await tx.executeSql(`\
-						ALTER TABLE "migration status"
-						MODIFY "is backing off" BOOLEAN NOT NULL;`);
-					break;
-				case 'postgres':
-					await tx.executeSql(`\
-						ALTER TABLE "migration"
-						ALTER COLUMN "executed migrations" SET DATA TYPE JSONB USING "executed migrations"::JSONB;`);
-					await tx.executeSql(`\
-						ALTER TABLE "migration status"
-						ALTER COLUMN "is backing off" DROP DEFAULT,
-						ALTER COLUMN "is backing off" SET DATA TYPE BOOLEAN USING "is backing off"::BOOLEAN,
-						ALTER COLUMN "is backing off" SET DEFAULT FALSE;`);
-					break;
-				// No need to migrate for websql
-			}
-		},
-	},
-} as const satisfies sbvrUtils.ExecutableModel;
 export const config: Config = {
-	models: [migrationModelConfig],
+	models: [
+		{
+			modelName: 'migrations',
+			apiRoot: 'migrations',
+			modelText,
+			migrations: {
+				'11.0.0-modified-at': `
+					ALTER TABLE "migration"
+					ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
+				`,
+				'11.0.1-modified-at': `
+					ALTER TABLE "migration lock"
+					ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
+				`,
+				'15.0.0-data-types': async (tx, { db }) => {
+					switch (db.engine) {
+						case 'mysql':
+							await tx.executeSql(`\
+								ALTER TABLE "migration"
+								MODIFY "executed migrations" JSON NOT NULL;`);
+							await tx.executeSql(`\
+								ALTER TABLE "migration status"
+								MODIFY "is backing off" BOOLEAN NOT NULL;`);
+							break;
+						case 'postgres':
+							await tx.executeSql(`\
+								ALTER TABLE "migration"
+								ALTER COLUMN "executed migrations" SET DATA TYPE JSONB USING "executed migrations"::JSONB;`);
+							await tx.executeSql(`\
+								ALTER TABLE "migration status"
+								ALTER COLUMN "is backing off" DROP DEFAULT,
+								ALTER COLUMN "is backing off" SET DATA TYPE BOOLEAN USING "is backing off"::BOOLEAN,
+								ALTER COLUMN "is backing off" SET DEFAULT FALSE;`);
+							break;
+						// No need to migrate for websql
+					}
+				},
+			},
+		},
+	],
 };

package/src/sbvr-api/hooks.ts

@@ -9,6 +9,7 @@ import _ from 'lodash';
 import { settleMapSeries } from './control-flow';
 import memoize from 'memoizee';
 import {
+	type PinejsClient,
 	type User,
 	type ApiKey,
 	resolveSynonym,
@@ -30,27 +31,23 @@ export interface HookReq {
 	hooks?: InstantiatedHooks;
 	is?: (type: string | string[]) => string | false | null;
 }
-export interface HookArgs<Vocab extends string = string> {
+export interface HookArgs {
 	req: HookReq;
 	request: ODataRequest;
-	api: (typeof api)[Vocab];
+	api: PinejsClient;
 	tx?: Tx | undefined;
 }
 export type HookResponse = PromiseLike<any> | null | void;
 
-export interface Hooks<Vocab extends string = string> {
-	PREPARSE?: (
-		options: Omit<HookArgs<Vocab>, 'request' | 'api'>,
-	) => HookResponse;
-	POSTPARSE?: (options: HookArgs<Vocab>) => HookResponse;
-	PRERUN?: (options: HookArgs<Vocab> & { tx: Tx }) => HookResponse;
+export interface Hooks {
+	PREPARSE?: (options: Omit<HookArgs, 'request' | 'api'>) => HookResponse;
+	POSTPARSE?: (options: HookArgs) => HookResponse;
+	PRERUN?: (options: HookArgs & { tx: Tx }) => HookResponse;
 	/** These are run in reverse translation order from newest to oldest */
-	POSTRUN?: (
-		options: HookArgs<Vocab> & { tx: Tx; result: any },
-	) => HookResponse;
+	POSTRUN?: (options: HookArgs & { tx: Tx; result: any }) => HookResponse;
 	/** These are run in reverse translation order from newest to oldest */
 	PRERESPOND?: (
-		options: HookArgs<Vocab> & {
+		options: HookArgs & {
 			tx: Tx;
 			result: any;
 			/** This can be mutated to modify the response sent to the client */
@@ -59,7 +56,7 @@ export interface Hooks<Vocab extends string = string> {
 	) => HookResponse;
 	/** These are run in reverse translation order from newest to oldest */
 	'POSTRUN-ERROR'?: (
-		options: HookArgs<Vocab> & { tx: Tx; error: TypedError | any },
+		options: HookArgs & { tx: Tx; error: TypedError | any },
 	) => HookResponse;
 }
 export type HookBlueprints = {
@@ -265,9 +262,9 @@ const apiHooks = {
 // Share hooks between merge and patch since they are the same operation,
 // just MERGE was the OData intermediary until the HTTP spec added PATCH.
 apiHooks.MERGE = apiHooks.PATCH;
-export const addHook = <Vocab extends string>(
+export const addHook = (
 	method: keyof typeof apiHooks,
-	vocabulary: Vocab,
+	vocabulary: string,
 	resourceName: string,
 	hooks:
 		| { [key in keyof Hooks]: HookBlueprint<NonNullable<Hooks[key]>> }
@@ -346,11 +343,11 @@ export const addHook = <Vocab extends string>(
 	getHooks.clear();
 };
 
-export const addSideEffectHook = <Vocab extends string>(
+export const addSideEffectHook = (
 	method: HookMethod,
-	apiRoot: Vocab,
+	apiRoot: string,
 	resourceName: string,
-	hooks: Hooks<NoInfer<Vocab>>,
+	hooks: Hooks,
 ): void => {
 	addHook(method, apiRoot, resourceName, {
 		...hooks,
@@ -359,11 +356,11 @@ export const addSideEffectHook = <Vocab extends string>(
 	});
 };
 
-export const addPureHook = <Vocab extends string>(
+export const addPureHook = (
 	method: HookMethod,
-	apiRoot: Vocab,
+	apiRoot: string,
 	resourceName: string,
-	hooks: Hooks<NoInfer<Vocab>>,
+	hooks: Hooks,
 ): void => {
 	addHook(method, apiRoot, resourceName, {
 		...hooks,

package/src/sbvr-api/permissions.ts

@@ -1,4 +1,3 @@
-import type AuthModel from './user';
 import type {
 	AbstractSqlModel,
 	AbstractSqlQuery,
@@ -52,7 +51,6 @@ import {
 	type ODataRequest,
 } from './uri-parser';
 import memoizeWeak = require('memoizee/weak');
-import type { Config } from '../config-loader/config-loader';
 
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const userModel: string = require('./user.sbvr');
@@ -1120,7 +1118,7 @@ const memoizedGetConstrainedModel = (
 	getBoundConstrainedMemoizer(abstractSqlModel)(permissionsLookup, vocabulary);
 
 const getCheckPasswordQuery = _.once(() =>
-	sbvrUtils.api.Auth.prepare<{ username: string }, 'user'>({
+	sbvrUtils.api.Auth.prepare<{ username: string }>({
 		resource: 'user',
 		passthrough: {
 			req: rootRead,
@@ -1166,7 +1164,7 @@ export const checkPassword = async (
 
 const $getUserPermissions = (() => {
 	const getUserPermissionsQuery = _.once(() =>
-		sbvrUtils.api.Auth.prepare<{ userId: number }, 'permission'>({
+		sbvrUtils.api.Auth.prepare<{ userId: number }>({
 			resource: 'permission',
 			passthrough: {
 				req: rootRead,
@@ -1277,7 +1275,7 @@ export const getUserPermissions = async (
 
 const $getApiKeyPermissions = (() => {
 	const getApiKeyPermissionsQuery = _.once(() =>
-		sbvrUtils.api.Auth.prepare<{ apiKey: string }, 'permission'>({
+		sbvrUtils.api.Auth.prepare<{ apiKey: string }>({
 			resource: 'permission',
 			passthrough: {
 				req: rootRead,
@@ -1405,7 +1403,7 @@ export const getApiKeyPermissions = async (
 
 const getApiKeyActorId = (() => {
 	const getApiKeyActorIdQuery = _.once(() =>
-		sbvrUtils.api.Auth.prepare<{ apiKey: string }, 'api_key'>({
+		sbvrUtils.api.Auth.prepare<{ apiKey: string }>({
 			resource: 'api_key',
 			passthrough: {
 				req: rootRead,
@@ -1588,7 +1586,7 @@ let guestPermissionsInitialized = false;
 const getGuestPermissions = memoize(
 	async () => {
 		// Get guest user
-		const result = await sbvrUtils.api.Auth.get({
+		const result = (await sbvrUtils.api.Auth.get({
 			resource: 'user',
 			passthrough: {
 				req: rootRead,
@@ -1599,7 +1597,7 @@ const getGuestPermissions = memoize(
 			options: {
 				$select: 'id',
 			},
-		});
+		})) as { id: number } | undefined;
 		if (result == null) {
 			throw new Error('No guest user');
 		}
@@ -1688,53 +1686,49 @@ export const addPermissions = async (
 	}
 };
 
-declare module './sbvr-utils' {
-	export interface API {
-		[authModelConfig.apiRoot]: PinejsClient<AuthModel>;
-	}
-}
-const authModelConfig = {
-	apiRoot: 'Auth',
-	modelText: userModel,
-	customServerCode: exports,
-	migrations: {
-		'11.0.0-modified-at': `
-			ALTER TABLE "actor"
-			ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
-
-			ALTER TABLE "api key"
-			ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
-			ALTER TABLE "api key-has-permission"
-			ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
-			ALTER TABLE "api key-has-role"
-			ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
-
-			ALTER TABLE "permission"
-			ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
-
-			ALTER TABLE "role"
-			ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
-
-			ALTER TABLE "user"
-			ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
-			ALTER TABLE "user-has-role"
-			ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
-			ALTER TABLE "user-has-permission"
-			ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
-		`,
-		'11.0.1-modified-at': `
-			ALTER TABLE "role-has-permission"
-			ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
-		`,
-		'14.42.0-api-key-expiry-date': `
-			ALTER TABLE "api key"
-			ADD COLUMN IF NOT EXISTS "expiry date" TIMESTAMP NULL;
-		`,
-	},
-} as const satisfies sbvrUtils.ExecutableModel;
 export const config = {
-	models: [authModelConfig],
-} satisfies Config;
+	models: [
+		{
+			apiRoot: 'Auth',
+			modelText: userModel,
+			customServerCode: exports,
+			migrations: {
+				'11.0.0-modified-at': `
+					ALTER TABLE "actor"
+					ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
+
+					ALTER TABLE "api key"
+					ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
+					ALTER TABLE "api key-has-permission"
+					ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
+					ALTER TABLE "api key-has-role"
+					ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
+
+					ALTER TABLE "permission"
+					ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
+
+					ALTER TABLE "role"
+					ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
+
+					ALTER TABLE "user"
+					ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
+					ALTER TABLE "user-has-role"
+					ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
+					ALTER TABLE "user-has-permission"
+					ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
+				`,
+				'11.0.1-modified-at': `
+					ALTER TABLE "role-has-permission"
+					ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
+				`,
+				'14.42.0-api-key-expiry-date': `
+					ALTER TABLE "api key"
+					ADD COLUMN IF NOT EXISTS "expiry date" TIMESTAMP NULL;
+				`,
+			},
+		},
+	] as sbvrUtils.ExecutableModel[],
+};
 export const setup = () => {
 	addHook('all', 'all', 'all', {
 		sideEffects: false,

package/src/sbvr-api/sbvr-utils.ts

@@ -2,7 +2,6 @@ import type * as Express from 'express';
 import type * as Db from '../database-layer/db';
 import type { Model } from '../config-loader/config-loader';
 import type { AnyObject, RequiredField } from './common-types';
-import type { Resource } from '@balena/abstract-sql-to-typescript';
 
 // Augment the Express typings
 declare global {
@@ -33,7 +32,6 @@ import {
 } from '@balena/odata-to-abstract-sql';
 import sbvrTypes from '@balena/sbvr-types';
 import deepFreeze = require('deep-freeze');
-import type { AnyResource, Params } from 'pinejs-client-core';
 import { PinejsClientCore, type PromiseResultTypes } from 'pinejs-client-core';
 
 import { ExtendedSBVRParser } from '../extended-sbvr-parser/extended-sbvr-parser';
@@ -42,9 +40,9 @@ import * as asyncMigrator from '../migrator/async';
 import * as syncMigrator from '../migrator/sync';
 import { generateODataMetadata } from '../odata-metadata/odata-metadata-generator';
 
-import type DevModel from './dev';
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const devModel = require('./dev.sbvr');
+import * as tasks from '../tasks';
 import * as permissions from './permissions';
 import {
 	BadRequestError,
@@ -80,6 +78,7 @@ export {
 	addPureHook,
 	addSideEffectHook,
 } from './hooks';
+export { addTaskHandler } from '../tasks';
 
 import memoizeWeak = require('memoizee/weak');
 import * as controlFlow from './control-flow';
@@ -713,7 +712,7 @@ export const executeModels = async (
 							},
 						});
 					}
-					const result = await api.dev.get({
+					const result = (await api.dev.get({
 						resource: 'model',
 						passthrough: {
 							tx,
@@ -726,7 +725,7 @@ export const executeModels = async (
 								model_type: modelType,
 							},
 						},
-					});
+					})) as Array<{ id: number }>;
 
 					let method: SupportedMethod = 'POST';
 					let uri = '/dev/model';
@@ -776,7 +775,7 @@ export const postExecuteModels = async (tx: Db.Tx): Promise<void> => {
 	// Hence, skipped migrations from earlier models are not set as executed as the `migration` table is missing
 	// Here the skipped migrations that haven't been set properly are covered
 	// This is mostly an edge case when running on an empty database schema and migrations model hasn't been executed, yet.
-	// One specifc case are tests to run tests against migrated and unmigrated database states
+	// One specific case are tests to run tests against migrated and unmigrated database states
 
 	for (const modelKey of Object.keys(models)) {
 		const pendingToSetExecutedMigrations =
@@ -786,6 +785,9 @@ export const postExecuteModels = async (tx: Db.Tx): Promise<void> => {
 			await setExecutedMigrations(tx, modelKey, pendingToSetExecutedMigrations);
 		}
 	}
+
+	// Initialize task worker and create required hooks
+	await tasks.setup(db);
 };
 
 const cleanupModel = (vocab: string) => {
@@ -1005,16 +1007,7 @@ export type Passthrough = AnyObject & {
 	tx?: Db.Tx;
 };
 
-export class PinejsClient<
-	M extends {
-		[key in keyof M]: Resource;
-	} = {
-		[key in string]: {
-			Read: AnyObject;
-			Write: AnyObject;
-		};
-	},
-> extends PinejsClientCore<unknown, M> {
+export class PinejsClient extends PinejsClientCore {
 	public async _request({
 		method,
 		url,
@@ -1032,37 +1025,11 @@ export class PinejsClient<
 	}) {
 		return (await runURI(method, url, body, tx, req, custom)) as object;
 	}
-
-	public post<TResource extends keyof M & string>(
-		params: {
-			resource: TResource;
-			options?: Params<M[TResource]>['options'] & { returnResource?: true };
-		} & Params<M[TResource]>,
-	): Promise<M[TResource]['Read']>;
-	public post<TResource extends keyof M & string>(
-		params: {
-			resource: TResource;
-			options: Params<M[TResource]>['options'] & { returnResource: boolean };
-		} & Params<M[TResource]>,
-	): Promise<Pick<M[TResource]['Read'], 'id'>>; // TODO: This should use the primary key rather than hardcoding `id`
-	/**
-	 * @deprecated POSTing via `url` is deprecated
-	 */
-	public post<T extends Resource = AnyResource>(
-		params: {
-			resource?: undefined;
-			url: NonNullable<Params<T>['url']>;
-		} & Params<T>,
-	): Promise<AnyObject>;
-	public post(params: Params<AnyResource>): Promise<AnyObject> {
-		return super.post(params as Parameters<PinejsClient['post']>[0]);
-	}
 }
 
-export interface API {
+export const api: {
 	[vocab: string]: PinejsClient;
-}
-export const api = {} as API;
+} = {};
 export const logger: {
 	[vocab: string]: Console;
 } = {};
@@ -1169,8 +1136,8 @@ const getIdField = (
 	// TODO: Should resolveSynonym also be using the finalAbstractSqlModel?
 	getFinalAbstractSqlModel(request).tables[resolveSynonym(request)].idField;
 
-export const getAffectedIds = async <Vocab extends string>(
-	args: HookArgs<Vocab> & {
+export const getAffectedIds = async (
+	args: HookArgs & {
 		tx: Db.Tx;
 	},
 ): Promise<number[]> => {
@@ -1192,11 +1159,11 @@ export const getAffectedIds = async <Vocab extends string>(
 	return request.affectedIds;
 };
 
-const $getAffectedIds = async <Vocab extends string>({
+const $getAffectedIds = async ({
 	req,
 	request,
 	tx,
-}: HookArgs<Vocab> & {
+}: HookArgs & {
 	tx: Db.Tx;
 }): Promise<number[]> => {
 	if (!['PATCH', 'DELETE'].includes(request.method)) {
@@ -1980,51 +1947,47 @@ const runDelete = async (
 	return undefined;
 };
 
-export interface API {
-	[devModelConfig.apiRoot]: PinejsClient<DevModel>;
-}
-const devModelConfig = {
-	apiRoot: 'dev',
-	modelText: devModel,
-	logging: {
-		log: false,
-	},
-	migrations: {
-		'11.0.0-modified-at': `
-			ALTER TABLE "model"
-			ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
-		`,
-		'15.0.0-data-types': async ($tx, sbvrUtils) => {
-			switch (sbvrUtils.db.engine) {
-				case 'mysql':
-					await $tx.executeSql(`\
-						ALTER TABLE "model"
-						MODIFY "model value" JSON NOT NULL;
-
-						UPDATE "model"
-						SET "model value" = CAST('{"value":' || CAST("model value" AS CHAR) || '}' AS JSON)
-						WHERE "model type" IN ('se', 'odataMetadata')
-						AND CAST("model value" AS CHAR) LIKE '"%';`);
-					break;
-				case 'postgres':
-					await $tx.executeSql(`\
-						ALTER TABLE "model"
-						ALTER COLUMN "model value" SET DATA TYPE JSONB USING "model value"::JSONB;
-
-						UPDATE "model"
-						SET "model value" = CAST('{"value":' || CAST("model value" AS TEXT) || '}' AS JSON)
-						WHERE "model type" IN ('se', 'odataMetadata')
-						AND CAST("model value" AS TEXT) LIKE '"%';`);
-					break;
-				// No need to migrate for websql
-			}
-		},
-	},
-} as const satisfies ExecutableModel;
 export const executeStandardModels = async (tx: Db.Tx): Promise<void> => {
 	try {
 		// dev model must run first
-		await executeModel(tx, devModelConfig);
+		await executeModel(tx, {
+			apiRoot: 'dev',
+			modelText: devModel,
+			logging: {
+				log: false,
+			},
+			migrations: {
+				'11.0.0-modified-at': `
+					ALTER TABLE "model"
+					ADD COLUMN IF NOT EXISTS "modified at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL;
+				`,
+				'15.0.0-data-types': async ($tx, sbvrUtils) => {
+					switch (sbvrUtils.db.engine) {
+						case 'mysql':
+							await $tx.executeSql(`\
+								ALTER TABLE "model"
+								MODIFY "model value" JSON NOT NULL;
+
+								UPDATE "model"
+								SET "model value" = CAST('{"value":' || CAST("model value" AS CHAR) || '}' AS JSON)
+								WHERE "model type" IN ('se', 'odataMetadata')
+								AND CAST("model value" AS CHAR) LIKE '"%';`);
+							break;
+						case 'postgres':
+							await $tx.executeSql(`\
+								ALTER TABLE "model"
+								ALTER COLUMN "model value" SET DATA TYPE JSONB USING "model value"::JSONB;
+
+								UPDATE "model"
+								SET "model value" = CAST('{"value":' || CAST("model value" AS TEXT) || '}' AS JSON)
+								WHERE "model type" IN ('se', 'odataMetadata')
+								AND CAST("model value" AS TEXT) LIKE '"%';`);
+							break;
+						// No need to migrate for websql
+					}
+				},
+			},
+		});
 		await executeModels(tx, permissions.config.models);
 		console.info('Successfully executed standard models.');
 	} catch (err: any) {

package/src/server-glue/module.ts

@@ -6,6 +6,7 @@ import * as dbModule from '../database-layer/db';
 import * as configLoader from '../config-loader/config-loader';
 import * as migrator from '../migrator/sync';
 import type * as migratorUtils from '../migrator/utils';
+import * as tasks from '../tasks';
 
 import * as sbvrUtils from '../sbvr-api/sbvr-utils';
 import { PINEJS_ADVISORY_LOCK } from '../config-loader/env';
@@ -19,6 +20,7 @@ export * as errors from '../sbvr-api/errors';
 export * as env from '../config-loader/env';
 export * as types from '../sbvr-api/common-types';
 export * as hooks from '../sbvr-api/hooks';
+export * as tasks from '../tasks';
 export * as webResourceHandler from '../webresource-handler';
 export type { configLoader as ConfigLoader };
 export type { migratorUtils as Migrator };
@@ -63,6 +65,7 @@ export const init = async <T extends string>(
 		await sbvrUtils.setup(app, db);
 		const cfgLoader = await configLoader.setup(app);
 		await cfgLoader.loadConfig(migrator.config);
+		await cfgLoader.loadConfig(tasks.config);
 
 		const promises: Array<Promise<void>> = [];
 		if (process.env.SBVR_SERVER_ENABLED) {

package/src/tasks/common.ts

@@ -0,0 +1,14 @@
+import Ajv from 'ajv';
+
+// Root path for the tasks API
+export const apiRoot = 'tasks';
+
+// Channel name for task insert notifications
+export const channel = 'pinejs$task_insert';
+
+// Setting inlineRefs=false as without it we run into a
+// "Maximum call stack size exceeded" error apprarently caused
+// by String.prototype._uncountable_words being set in sbvr-parser?
+export const ajv = new Ajv({
+	inlineRefs: false,
+});