velocious 1.0.106 → 1.0.107

package/package.json

@@ -3,11 +3,12 @@
     "velocious": "bin/velocious.js"
   },
   "name": "velocious",
-  "version": "1.0.106",
+  "version": "1.0.107",
   "main": "index.js",
   "scripts": {
     "lint": "eslint",
     "test": "VELOCIOUS_TEST_DIR=../ cd spec/dummy && npx velocious test",
+    "typecheck": "tsc --noEmit",
     "velocious": "asd"
   },
   "type": "module",
@@ -54,6 +55,7 @@
     "sqlite": "^5.1.1",
     "sqlite3": "^5.1.7",
     "tedious": "^19.1.3",
+    "typescript": "^5.9.3",
     "uniqunize": "^1.0.1"
   }
 }

package/peak_flow.yml

@@ -86,3 +86,4 @@ builds:
       - cp spec/dummy/src/config/configuration.peakflow.sqlite.js spec/dummy/src/config/configuration.js
       - sleep 5
       - npm run lint
+      - npm run typecheck

package/spec/cli/commands/db/migrate-spec.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 import Cli from "../../../../src/cli/index.js"
 import dummyConfiguration from "../../../dummy/src/config/configuration.js"
 import dummyDirectory from "../../../dummy/dummy-directory.js"
@@ -15,9 +17,12 @@ describe("Cli - Commands - db:migrate", () => {
       testing: true
     })
 
-    let defaultDatabaseType, defaultSchemaMigrations = [], projectForeignKey = [], tablesResult = []
+    let defaultDatabaseType, defaultSchemaMigrations = [], tablesResult = []
+
+    /** @type {import("../../../../src/database/drivers/base-foreign-key.js").default} */
+    let projectForeignKey = undefined
 
-    await cli.configuration.ensureConnections(async (dbs) => {
+    await cli.getConfiguration().ensureConnections(async (dbs) => {
       defaultDatabaseType = dbs.default.getType()
 
       const tableNames = ["accounts", "authentication_tokens", "tasks", "project_details", "project_translations", "projects", "schema_migrations", "users"]

package/spec/cli/commands/test/test-files-finder-spec.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 import fs from "fs/promises"
 import TestFilesFinder from "../../../../src/testing/test-files-finder.js"
 

package/spec/database/connection/drivers/mysql/query-parser-spec.js

@@ -1,3 +1,4 @@
+import configuration from "../../../../dummy/src/config/configuration.js"
 import DatabaseHandler from "../../../../../src/database/handler.js"
 import DatabaseQuery from "../../../../../src/database/query/index.js"
 import MysqlQueryParser from "../../../../../src/database/drivers/mysql/query-parser.js"
@@ -7,7 +8,8 @@ import SelectTableAndColumn from "../../../../../src/database/query/select-table
 
 import MysqlDriverClass from "../../../../../src/database/drivers/mysql/index.js"
 
-const mysqlDriver = new MysqlDriverClass()
+const mysqlConfig = configuration.database.test.default
+const mysqlDriver = new MysqlDriverClass(mysqlConfig, configuration)
 
 describe("database - connection - drivers - mysql - query parser", () => {
   it("generates sql with selects, joins and orders", () => {

package/spec/database/drivers/mysql/connection-spec.js

@@ -7,7 +7,7 @@ const mysqlConfig = digg(configuration, "database", "test", "default")
 describe("Database - Drivers - Mysql - Connection", () => {
   it("connects", async () => {
     if (configuration.getDatabaseType() != "sqlite" && configuration.getDatabaseType() != "mssql" && configuration.getDatabaseType() != "pgsql") {
-      const mysql = new DatabaseDriversMysql(mysqlConfig)
+      const mysql = new DatabaseDriversMysql(mysqlConfig, configuration)
 
       await mysql.connect()
 

package/spec/database/record/find-or-create-spec.js

@@ -4,11 +4,11 @@ import Task from "../../dummy/src/models/task.js"
 describe("Record - find or create", () => {
   it("doesnt find but then creates a record", async () => {
     await Dummy.run(async () => {
-      const task = await Task.findOrCreateBy({name: "Test task"}, (newTask) => {
+      const task = /** @type {Task} */ (await Task.findOrCreateBy({name: "Test task"}, (newTask) => {
         const project = newTask.buildProject({nameEn: "Test project", nameDe: "Test projekt"})
 
         project.buildProjectDetail({note: "Test note"})
-      })
+      }))
 
       const project = task.project()
 
@@ -51,7 +51,7 @@ describe("Record - find or create", () => {
 
       expect(tasksRelationship.getPreloaded()).toBeTrue()
 
-      const projectTasksIDs = project.tasks().loaded().map((task) => task.id())
+      const projectTasksIDs = project.tasksLoaded().map((task) => task.id())
 
       expect(projectTasksIDs).toEqual([task.id()])
     })

package/spec/database/record/find-spec.js

@@ -10,7 +10,7 @@ describe("Record - find", () => {
 
       await task.save()
 
-      const foundTask = await Task.find(task.id())
+      const foundTask = /** @type {Task} */ (await Task.find(task.id()))
 
       expect(foundTask.readAttribute("name")).toEqual("Test task")
       expect(foundTask.readColumn("name")).toEqual("Test task")

package/spec/database/record/instance-relationships/belongs-to-relationship-spec.js

@@ -7,7 +7,7 @@ describe("Record - instance relationships - belongs to relationship", () => {
     await Dummy.run(async () => {
       const project = await Project.create()
       const task = await Task.create({name: "Test task", project})
-      const foundTask = await Task.find(task.id())
+      const foundTask = /** @type {Task} */ (await Task.find(task.id()))
       const projectInstanceRelationship = foundTask.getRelationshipByName("project")
 
       expect(projectInstanceRelationship.isLoaded()).toBeFalse()

package/spec/database/record/instance-relationships/has-many-relationship-spec.js

@@ -5,9 +5,9 @@ import Task from "../../../dummy/src/models/task.js"
 describe("Record - instance relationships - has many relationship", () => {
   it("loads a relationship", async () => {
     await Dummy.run(async () => {
-      const project = await Project.create()
+      const project = /** @type {Project} */ (await Project.create())
       const task = await Task.create({name: "Test task", project})
-      const foundProject = await Project.find(project.id())
+      const foundProject = /** @type {Project} */ (await Project.find(project.id()))
       const tasksInstanceRelationship = foundProject.getRelationshipByName("tasks")
 
       expect(tasksInstanceRelationship.isLoaded()).toBeFalse()
@@ -16,7 +16,7 @@ describe("Record - instance relationships - has many relationship", () => {
 
       expect(tasksInstanceRelationship.isLoaded()).toBeTrue()
 
-      const taskIDs = foundProject.tasks().loaded().map((task) => task.id())
+      const taskIDs = foundProject.tasksLoaded().map((task) => task.id())
 
       expect(taskIDs).toEqual([task.id()])
     })

package/spec/database/record/instance-relationships/has-one-relationship-spec.js

@@ -7,7 +7,7 @@ describe("Record - instance relationships - has one relationship", () => {
     await Dummy.run(async () => {
       const project = await Project.create()
       const projectDetail = await ProjectDetail.create({note: "Test project", project})
-      const foundProject = await Project.find(project.id())
+      const foundProject = /** @type {Project} */ (await Project.find(project.id()))
       const projectDetailInstanceRelationship = foundProject.getRelationshipByName("projectDetail")
 
       expect(projectDetailInstanceRelationship.isLoaded()).toBeFalse()

package/spec/database/record/last-spec.js

@@ -17,11 +17,11 @@ describe("Record - last", () => {
       await Task.create({name: "Test task 5", project: project2})
       await Task.create({name: "Test task 6", project: project2})
 
-      const foundTask = await Task.last()
+      const foundTask = /** @type {Task} */ (await Task.last())
 
       expect(foundTask.name()).toEqual("Test task 6")
 
-      const foundTaskWithFilter = await Task.where({project_id: project1.id()}).last()
+      const foundTaskWithFilter = /** @type {Task} */ (await Task.where({project_id: project1.id()}).last())
 
       expect(foundTaskWithFilter.name()).toEqual("Test task 3")
     })

package/spec/database/record/preloader/belongs-to-spec.js

@@ -7,7 +7,7 @@ describe("Record - preloader - belongs to", () => {
     await Dummy.run(async () => {
       const project = await Project.create({creating_user_reference: "User-65"})
       const user = await User.create({email: "user@example.com", encrypted_password: "password", reference: "User-65"})
-      const foundProject = await Project.preload({creatingUser: true}).find(project.id())
+      const foundProject = /** @type {Project} */ (await Project.preload({creatingUser: true}).find(project.id()))
 
       expect(foundProject.creatingUser().id()).toEqual(user.id())
     })

package/spec/database/record/preloader/has-many-spec.js

@@ -7,8 +7,8 @@ describe("Record - preloader - has many", () => {
     await Dummy.run(async () => {
       const project = await Project.create({creating_user_reference: "User-65"})
       const user = await User.create({email: "user@example.com", encrypted_password: "password", reference: "User-65"})
-      const foundUser = await User.preload({createdProjects: true}).find(user.id())
-      const createdProjectsIDs = foundUser.createdProjects().loaded().map((createdProject) => createdProject.id())
+      const foundUser = /** @type {User} */ (await User.preload({createdProjects: true}).find(user.id()))
+      const createdProjectsIDs = foundUser.createdProjectsLoaded().map((createdProject) => createdProject.id())
 
       expect(createdProjectsIDs).toEqual([project.id()])
     })
@@ -20,8 +20,8 @@ describe("Record - preloader - has many", () => {
       await Project.create({creating_user_reference: "User-69"})
 
       const user = await User.create({email: "user@example.com", encrypted_password: "password", reference: "User-65"})
-      const foundUser = await User.preload({createdProjects: true}).find(user.id())
-      const createdProjectsIDs = foundUser.createdProjects().loaded().map((createdProject) => createdProject.id())
+      const foundUser = /** @type {User} */ (await User.preload({createdProjects: true}).find(user.id()))
+      const createdProjectsIDs = foundUser.createdProjectsLoaded().map((createdProject) => createdProject.id())
 
       expect(createdProjectsIDs).toEqual([])
     })

package/spec/database/record/preloader/has-one-spec.js

@@ -7,7 +7,7 @@ describe("Record - preloader - has one", () => {
     await Dummy.run(async () => {
       const project = await Project.create({creating_user_reference: "User-65"})
       const user = await User.create({email: "user@example.com", encrypted_password: "password", reference: "User-65"})
-      const foundUser = await User.preload({createdProject: true}).find(user.id())
+      const foundUser = /** @type {User} */ (await User.preload({createdProject: true}).find(user.id()))
 
       expect(foundUser.createdProject().id()).toEqual([project.id()])
     })

package/spec/database/record/query-spec.js

@@ -22,7 +22,7 @@ describe("Record - query", () => {
       expect(project.nameDe()).toEqual("Test projekt")
       expect(project.nameEn()).toEqual("Test project")
 
-      const tasks = await Task.preload({project: {projectDetail: true, translations: true}}).toArray()
+      const tasks = /** @type {Task[]} */ (await Task.preload({project: {projectDetail: true, translations: true}}).toArray())
       const newTask = tasks[0]
       const newProject = newTask.project()
       const newProjectDetail = newProject.projectDetail()
@@ -85,11 +85,13 @@ describe("Record - query", () => {
         await Task.create({name: `Task 2-${i}`, project: project2})
       }
 
-      const tasks = await Task
-        .joins({project: {translations: true}})
-        .where({tasks: {name: "Task 2-2"}, project_translations: {name: "Test project 2"}})
-        .preload({project: {translations: true}})
-        .toArray()
+      const tasks = /** @type {Task[]} */ (
+        await Task
+          .joins({project: {translations: true}})
+          .where({tasks: {name: "Task 2-2"}, project_translations: {name: "Test project 2"}})
+          .preload({project: {translations: true}})
+          .toArray()
+      )
 
       const task = tasks[0]
 

package/spec/database/record/translation-fallbacks-spec.js

@@ -13,7 +13,7 @@ describe("Record - translation fallbacks", () => {
 
       await task.save()
 
-      const sameTask = await Task.preload({project: {translations: true}}).find(task.id())
+      const sameTask = /** @type {Task} */ (await Task.preload({project: {translations: true}}).find(task.id()))
       const sameProject = sameTask.project()
 
       expect(sameProject.name()).toEqual("Test projekt")

package/spec/dummy/src/config/configuration.example.js

@@ -49,6 +49,7 @@ export default new Configuration({
     }
   },
   directory: dummyDirectory(),
+  environment: "development",
   environmentHandler: new NodeEnvironmentHandler(),
   initializeModels: async ({configuration}) => {
     const modelsPath = await fs.realpath(`${path.dirname(import.meta.dirname)}/../src/models`)

package/spec/dummy/src/model-bases/account.js

@@ -1,6 +1,6 @@
-import Record from "../../../../src/database/record/index.js"
+import DatabaseRecord from "../../../../src/database/record/index.js"
 
-export default class AccountBase extends Record {
+export default class AccountBase extends DatabaseRecord {
   /**
    * @returns {number}
    */

package/spec/dummy/src/model-bases/authentication-token.js

@@ -1,6 +1,6 @@
-import Record from "../../../../src/database/record/index.js"
+import DatabaseRecord from "../../../../src/database/record/index.js"
 
-export default class AuthenticationTokenBase extends Record {
+export default class AuthenticationTokenBase extends DatabaseRecord {
   /**
    * @returns {number}
    */
@@ -84,7 +84,7 @@ export default class AuthenticationTokenBase extends Record {
   /**
    * @returns {import("../models/user.js").default}
    */
-  user() { return this.getRelationshipByName("user").loaded() }
+  user() { return /** @type {import("../models/user.js").default} */ (this.getRelationshipByName("user").loaded()) }
 
   /**
    * @abstract

package/spec/dummy/src/model-bases/project-detail.js

@@ -1,6 +1,6 @@
-import Record from "../../../../src/database/record/index.js"
+import DatabaseRecord from "../../../../src/database/record/index.js"
 
-export default class ProjectDetailBase extends Record {
+export default class ProjectDetailBase extends DatabaseRecord {
   /**
    * @returns {number}
    */
@@ -77,7 +77,7 @@ export default class ProjectDetailBase extends Record {
   /**
    * @returns {import("../models/project.js").default}
    */
-  project() { return this.getRelationshipByName("project").loaded() }
+  project() { return /** @type {import("../models/project.js").default} */ (this.getRelationshipByName("project").loaded()) }
 
   /**
    * @abstract

package/spec/dummy/src/model-bases/project-translation.js

@@ -1,6 +1,6 @@
-import Record from "../../../../src/database/record/index.js"
+import DatabaseRecord from "../../../../src/database/record/index.js"
 
-export default class ProjectTranslationBase extends Record {
+export default class ProjectTranslationBase extends DatabaseRecord {
   /**
    * @returns {number}
    */
@@ -100,7 +100,7 @@ export default class ProjectTranslationBase extends Record {
   /**
    * @returns {import("../models/project.js").default}
    */
-  project() { return this.getRelationshipByName("project").loaded() }
+  project() { return /** @type {import("../models/project.js").default} */ (this.getRelationshipByName("project").loaded()) }
 
   /**
    * @abstract

package/spec/dummy/src/model-bases/project.js

@@ -1,6 +1,6 @@
-import Record from "../../../../src/database/record/index.js"
+import DatabaseRecord from "../../../../src/database/record/index.js"
 
-export default class ProjectBase extends Record {
+export default class ProjectBase extends DatabaseRecord {
   /**
    * @returns {number}
    */
@@ -101,7 +101,7 @@ export default class ProjectBase extends Record {
   /**
    * @returns {import("../models/user.js").default}
    */
-  creatingUser() { return this.getRelationshipByName("creatingUser").loaded() }
+  creatingUser() { return /** @type {import("../models/user.js").default} */ (this.getRelationshipByName("creatingUser").loaded()) }
 
   /**
    * @abstract
@@ -124,14 +124,14 @@ export default class ProjectBase extends Record {
   setCreatingUser(newModel) { throw new Error("Not implemented") } // eslint-disable-line no-unused-vars
 
   /**
-   * @returns {import("velocious/src/database/query/index.js").default<import("../models/task.js").default>}
+   * @returns {import("../../../../src/database/record/instance-relationships/has-many.js").default}
    */
-  tasks() { return this.getRelationshipByName("tasks") }
+  tasks() { return /** @type {import("../../../../src/database/record/instance-relationships/has-many.js").default} */ (this.getRelationshipByName("tasks")) }
 
   /**
    * @returns {Array<import("../models/task.js").default>}
    */
-  tasksLoaded() { return this.getRelationshipByName("tasks").loaded() }
+  tasksLoaded() { return /** @type {Array<import("../models/task.js").default>} */ (this.getRelationshipByName("tasks").loaded()) }
 
   /**
    * @abstract
@@ -149,7 +149,7 @@ export default class ProjectBase extends Record {
   /**
    * @returns {import("../models/project-detail.js").default}
    */
-  projectDetail() { return this.getRelationshipByName("projectDetail").loaded() }
+  projectDetail() { return /** @type {import("../models/project-detail.js").default} */ (this.getRelationshipByName("projectDetail").loaded()) }
 
   /**
    * @abstract
@@ -172,14 +172,14 @@ export default class ProjectBase extends Record {
   setProjectDetail(newModel) { throw new Error("Not implemented") } // eslint-disable-line no-unused-vars
 
   /**
-   * @returns {import("velocious/src/database/query/index.js").default<import("velocious/src/database/record/index.js").default>}
+   * @returns {import("../../../../src/database/record/instance-relationships/has-many.js").default}
    */
-  translations() { return this.getRelationshipByName("translations") }
+  translations() { return /** @type {import("../../../../src/database/record/instance-relationships/has-many.js").default} */ (this.getRelationshipByName("translations")) }
 
   /**
-   * @returns {Array<import("velocious/src/database/record/index.js").default>}
+   * @returns {Array<import("../model-bases/project-translation.js").default>}
    */
-  translationsLoaded() { return this.getRelationshipByName("translations").loaded() }
+  translationsLoaded() { return /** @type {Array<import("../model-bases/project-translation.js").default>} */ (this.getRelationshipByName("translations").loaded()) }
 
   /**
    * @abstract
@@ -189,7 +189,7 @@ export default class ProjectBase extends Record {
 
   /**
    * @abstract
-   * @param {Array<import("velocious/src/database/record/index.js").default>} newModels
+   * @param {Array<import("../model-bases/project-translation.js").default>} newModels
    * @returns {void}
    */
   setTranslations(newModels) { throw new Error("Not implemented") } // eslint-disable-line no-unused-vars

package/spec/dummy/src/model-bases/task.js

@@ -1,6 +1,6 @@
-import Record from "../../../../src/database/record/index.js"
+import DatabaseRecord from "../../../../src/database/record/index.js"
 
-export default class TaskBase extends Record {
+export default class TaskBase extends DatabaseRecord {
   /**
    * @returns {number}
    */
@@ -93,7 +93,7 @@ export default class TaskBase extends Record {
   /**
    * @returns {import("../models/project.js").default}
    */
-  project() { return this.getRelationshipByName("project").loaded() }
+  project() { return /** @type {import("../models/project.js").default} */ (this.getRelationshipByName("project").loaded()) }
 
   /**
    * @abstract

package/spec/dummy/src/model-bases/user.js

@@ -1,6 +1,6 @@
-import Record from "../../../../src/database/record/index.js"
+import DatabaseRecord from "../../../../src/database/record/index.js"
 
-export default class UserBase extends Record {
+export default class UserBase extends DatabaseRecord {
   /**
    * @returns {number}
    */
@@ -100,7 +100,7 @@ export default class UserBase extends Record {
   /**
    * @returns {import("../models/project.js").default}
    */
-  createdProject() { return this.getRelationshipByName("createdProject").loaded() }
+  createdProject() { return /** @type {import("../models/project.js").default} */ (this.getRelationshipByName("createdProject").loaded()) }
 
   /**
    * @abstract
@@ -123,14 +123,14 @@ export default class UserBase extends Record {
   setCreatedProject(newModel) { throw new Error("Not implemented") } // eslint-disable-line no-unused-vars
 
   /**
-   * @returns {import("velocious/src/database/query/index.js").default<import("../models/authentication-token.js").default>}
+   * @returns {import("../../../../src/database/record/instance-relationships/has-many.js").default}
    */
-  authenticationTokens() { return this.getRelationshipByName("authenticationTokens") }
+  authenticationTokens() { return /** @type {import("../../../../src/database/record/instance-relationships/has-many.js").default} */ (this.getRelationshipByName("authenticationTokens")) }
 
   /**
    * @returns {Array<import("../models/authentication-token.js").default>}
    */
-  authenticationTokensLoaded() { return this.getRelationshipByName("authenticationTokens").loaded() }
+  authenticationTokensLoaded() { return /** @type {Array<import("../models/authentication-token.js").default>} */ (this.getRelationshipByName("authenticationTokens").loaded()) }
 
   /**
    * @abstract
@@ -146,14 +146,14 @@ export default class UserBase extends Record {
   setAuthenticationTokens(newModels) { throw new Error("Not implemented") } // eslint-disable-line no-unused-vars
 
   /**
-   * @returns {import("velocious/src/database/query/index.js").default<import("../models/project.js").default>}
+   * @returns {import("../../../../src/database/record/instance-relationships/has-many.js").default}
    */
-  createdProjects() { return this.getRelationshipByName("createdProjects") }
+  createdProjects() { return /** @type {import("../../../../src/database/record/instance-relationships/has-many.js").default} */ (this.getRelationshipByName("createdProjects")) }
 
   /**
    * @returns {Array<import("../models/project.js").default>}
    */
-  createdProjectsLoaded() { return this.getRelationshipByName("createdProjects").loaded() }
+  createdProjectsLoaded() { return /** @type {Array<import("../models/project.js").default>} */ (this.getRelationshipByName("createdProjects").loaded()) }
 
   /**
    * @abstract

package/spec/dummy/src/routes/projects/controller.js

@@ -10,7 +10,7 @@ export default class ProjectsController extends Controller {
   }
 
   async show() {
-    const projectId = digg(params, "id")
+    const projectId = digg(this.params(), "id")
     const project = await Project.find(projectId)
 
     this.viewParams.project = project

package/spec/dummy/src/routes/tasks/controller.js

@@ -1,5 +1,3 @@
-import {digg} from "diggerize"
-
 import Controller from "../../../../../src/controller.js"
 import Task from "../../models/task.js"
 
@@ -10,7 +8,7 @@ export default class TasksController extends Controller {
   }
 
   async show() {
-    const taskId = digg(params, "id")
+    const taskId = this.params().id
     const task = await Task.find(taskId)
 
     this.viewParams.task = task

package/spec/http-server/client-spec.js

@@ -3,7 +3,7 @@ import Client from "../../src/http-server/client/index.js"
 import {digg} from "diggerize"
 import dummyConfiguration from "../dummy/src/config/configuration.js"
 
-describe("http server - client", {databaseCleaning: {transaction: false, truncate: true}}, () => {
+describe("http server - client", {databaseCleaning: {transaction: false, truncate: true}}, async () => {
   it("spawns a request for each that it is fed", async () => {
     await dummyConfiguration.initialize()
 

package/spec/http-server/get-spec.js

@@ -4,7 +4,7 @@ import Header from "../../src/http-client/header.js"
 import HttpClient from "../../src/http-client/index.js"
 import {wait, waitFor} from "awaitery"
 
-describe("HttpServer - get", {databaseCleaning: {transaction: false, truncate: true}}, () => {
+describe("HttpServer - get", {databaseCleaning: {transaction: false, truncate: true}}, async () => {
   it("handles get requests", async () => {
     await Dummy.run(async () => {
       for (let i = 0; i <= 5; i++) {

package/spec/http-server/post-spec.js

@@ -6,7 +6,7 @@ import wait from "awaitery/src/wait.js"
 import Dummy from "../dummy/index.js"
 import Project from "../dummy/src/models/project.js"
 
-describe("HttpServer - post", {databaseCleaning: {transaction: false, truncate: true}}, () => {
+describe("HttpServer - post", {databaseCleaning: {transaction: false, truncate: true}}, async () => {
   it("handles post requests", async () => {
     await Dummy.run(async () => {
       for (let i = 0; i <= 5; i++) {
@@ -17,7 +17,7 @@ describe("HttpServer - post", {databaseCleaning: {transaction: false, truncate:
             body: postData,
             headers: {
               "Content-Type": "application/x-www-form-urlencoded",
-              "Content-Length": Buffer.byteLength(postData)
+              "Content-Length": Buffer.byteLength(postData).toString()
             },
             method: "POST"
           }
@@ -27,7 +27,7 @@ describe("HttpServer - post", {databaseCleaning: {transaction: false, truncate:
 
         await wait(100) // Wait a bit to ensure the database connections are in sync
 
-        const createdProject = await Project.preload({translations: true}).find(projectID)
+        const createdProject = /** @type {Project} */ (await Project.preload({translations: true}).find(projectID))
 
         expect(createdProject.name()).toEqual("Test create project")
       }
@@ -44,18 +44,18 @@ describe("HttpServer - post", {databaseCleaning: {transaction: false, truncate:
             body: postData,
             headers: {
               "Content-Type": "application/json",
-              "Content-Length": Buffer.byteLength(postData)
+              "Content-Length": Buffer.byteLength(postData).toString()
             },
             method: "POST"
           }
         )
-        const data = await response.json()
+        const data = /** @type {Record<string, any>} */ (await response.json())
 
         expect(data.status).toEqual("success")
 
         await wait(100) // Wait a bit to ensure the database connections are in sync
 
-        const createdProject = await Project.preload({translations: true}).last()
+        const createdProject = /** @type {Project} */ (await Project.preload({translations: true}).last())
 
         expect(createdProject.name()).toEqual("Test create project")
       }
@@ -67,7 +67,7 @@ describe("HttpServer - post", {databaseCleaning: {transaction: false, truncate:
       for (let i = 0; i <= 5; i++) {
         const body = new FormData()
 
-        body.append("project[creating_user_reference]", 150123)
+        body.append("project[creating_user_reference]", "150123")
         body.append("project[name]", "Test create project")
 
         const response = await fetch(
@@ -77,13 +77,13 @@ describe("HttpServer - post", {databaseCleaning: {transaction: false, truncate:
             method: "POST"
           }
         )
-        const data = await response.json()
+        const data = /** @type {Record<string, any>} */ (await response.json())
 
         expect(data.status).toEqual("success")
 
         await wait(100) // Wait a bit to ensure the database connections are in sync
 
-        const createdProject = await Project.preload({translations: true}).last()
+        const createdProject = /** @type {Project} */ (await Project.preload({translations: true}).last())
 
         expect(createdProject.creatingUserReference()).toEqual("150123")
         expect(createdProject.name()).toEqual("Test create project")

package/spec/http-server/root-get-spec.js

@@ -1,7 +1,8 @@
+import {describe, it} from "../../src/testing/test.js"
 import fetch from "node-fetch"
 import Dummy from "../dummy/index.js"
 
-describe("HttpServer - root get", {databaseCleaning: {transaction: false, truncate: true}}, () => {
+describe("HttpServer - root get", {databaseCleaning: {transaction: false, truncate: true}}, async () => {
   it("handles root get requests", async () => {
     await Dummy.run(async () => {
       for (let i = 0; i <= 5; i++) {

package/src/application.js

@@ -8,6 +8,7 @@ import restArgsError from "./utils/rest-args-error.js"
 /**
  * @typedef {object} HttpServerConfiguration
  * @property {number} [maxWorkers]
+ * @property {string} [host]
  * @property {number} [port]
  */
 

package/src/cli/base-command.js

@@ -21,7 +21,7 @@ export default class VelociousCliBaseCommand {
 
   /**
    * @abstract
-   * @returns {Promise<void>}
+   * @returns {Promise<any>}
    */
   execute() {
     throw new Error("execute not implemented")