json-rest-api 1.0.29 → 2.1.0

package/lib/runtime/json-rest-api.js

@@ -0,0 +1,172 @@
+export class Hooks {
+  #events = new Map()
+
+  add (event, name, options, handler, resource) {
+    if (typeof handler !== 'function') throw new TypeError(`Hook '${name}' needs a function`)
+    const { beforeFunction, afterFunction, ...unsupported } = options
+    if (Object.keys(unsupported).length || (beforeFunction && afterFunction)) {
+      throw new TypeError(`Hook '${name}' requires at most one beforeFunction or afterFunction`)
+    }
+    const handlers = this.#events.get(event) || []
+    const anchor = beforeFunction || afterFunction
+    let index = handlers.length
+    if (anchor) {
+      index = handlers.findIndex(entry => entry.name === anchor)
+      if (index < 0) throw new Error(`Hook '${event}' has no handler '${anchor}'`)
+      if (afterFunction) index++
+    }
+    handlers.splice(index, 0, { name, handler, resource })
+    this.#events.set(event, handlers)
+  }
+
+  async run (event, args) {
+    for (const entry of [...(this.#events.get(event) || [])]) {
+      if (entry.resource && entry.resource !== args.scope) continue
+      if (await entry.handler(args) === false) return false
+    }
+    return true
+  }
+}
+
+function checkName (name) {
+  if (typeof name !== 'string' || !/^[A-Za-z_$][\w$]*$/.test(name) ||
+      ['__proto__', 'prototype', 'constructor', 'then'].includes(name)) {
+    throw new TypeError(`Invalid name '${name}'`)
+  }
+}
+
+function checkResourceMethodName (name) {
+  checkName(name)
+  if (['name', 'vars', 'helpers', 'scopeOptions'].includes(name)) {
+    throw new Error(`Resource member '${name}' is reserved`)
+  }
+}
+
+function assignValues (target, values = {}) {
+  for (const [name, value] of Object.entries(values)) {
+    checkName(name)
+    target[name] = value
+  }
+}
+
+export class JsonRestApi {
+  #hooks = new Hooks()
+  #plugins = new Set()
+  #resourceMethods = Object.create(null)
+
+  constructor ({ name, logger = {}, ...options } = {}) {
+    if ('log' in options || 'logging' in options) throw new TypeError('Pass logger directly instead of log or logging options')
+    this.name = name
+    this.log = Object.fromEntries(['trace', 'debug', 'info', 'warn', 'error', 'fatal'].map(level => [
+      level, (...args) => logger[level]?.(...args)
+    ]))
+    this.options = Object.freeze(options)
+    this.vars = Object.create(null)
+    this.helpers = Object.create(null)
+    this.resources = Object.create(null)
+  }
+
+  // Existing operation handlers receive the same explicit argument object.
+  #arguments (resource, params = {}, context = {}) {
+    return {
+      api: this,
+      name: this.name,
+      apiOptions: this.options,
+      params,
+      context,
+      scope: resource,
+      scopeName: resource?.name,
+      scopeOptions: resource?.scopeOptions,
+      scopes: this.resources,
+      vars: resource?.vars || this.vars,
+      helpers: resource?.helpers || this.helpers,
+      log: this.log,
+      runHooks: (event, nextContext = context) => this.#hooks.run(event, this.#arguments(resource, {}, nextContext))
+    }
+  }
+
+  #method (handler, resource) {
+    if (typeof handler !== 'function') throw new TypeError('Method needs a function')
+    return async (params = {}, context = {}) => handler(this.#arguments(resource, params, context))
+  }
+
+  #addApiMethod (name, handler) {
+    checkName(name)
+    if (name in this) throw new Error(`API member '${name}' already exists`)
+    this[name] = this.#method(handler)
+  }
+
+  #addResourceMethod (name, handler) {
+    checkResourceMethodName(name)
+    if (typeof handler !== 'function') throw new TypeError('Method needs a function')
+    const api = this
+    this.#resourceMethods[name] = async function (params = {}, context = {}) {
+      return handler(api.#arguments(this, params, context))
+    }
+  }
+
+  #addHooks (hooks = {}, resource) {
+    for (const [event, definition] of Object.entries(hooks)) {
+      const { handler, functionName = event, ...options } = typeof definition === 'function'
+        ? { handler: definition }
+        : definition
+      this.#hooks.add(event, functionName, options, handler, resource)
+    }
+  }
+
+  async use (plugin, pluginOptions = {}) {
+    if (!plugin?.name || typeof plugin.install !== 'function') throw new TypeError('Invalid plugin')
+    if (this.#plugins.has(plugin.name)) throw new Error(`Plugin '${plugin.name}' already installed`)
+    for (const dependency of plugin.dependencies || []) {
+      const alternatives = Array.isArray(dependency) ? dependency : [dependency]
+      if (!alternatives.some(name => this.#plugins.has(name))) {
+        throw new Error(`Plugin '${plugin.name}' requires ${alternatives.join(' or ')}`)
+      }
+    }
+    await plugin.install({
+      ...this.#arguments(),
+      pluginOptions,
+      addApiMethod: (name, handler) => this.#addApiMethod(name, handler),
+      addResourceMethod: (name, handler) => this.#addResourceMethod(name, handler),
+      addHook: (event, name, options, handler) => this.#hooks.add(event, name, options, handler)
+    })
+    this.#plugins.add(plugin.name)
+    return this
+  }
+
+  async addResource (name, { hooks, methods = {}, vars, helpers, ...scopeOptions } = {}) {
+    if ('scopeMethods' in scopeOptions) throw new TypeError('Use methods instead of scopeMethods')
+    checkName(name)
+    if (Object.hasOwn(this.resources, name)) throw new Error(`Resource '${name}' already exists`)
+    const resource = Object.assign(Object.create(this.#resourceMethods), {
+      name,
+      scopeOptions: Object.freeze(scopeOptions),
+      // One ordinary prototype link supplies live API defaults; writes stay local.
+      vars: Object.create(this.vars),
+      helpers: Object.create(this.helpers)
+    })
+    assignValues(resource.vars, vars)
+    assignValues(resource.helpers, helpers)
+    for (const [method, handler] of Object.entries(methods)) {
+      checkResourceMethodName(method)
+      resource[method] = this.#method(handler, resource)
+    }
+    this.resources[name] = resource
+    await this.runHooks('resource:added', { scopeName: name, scopeOptions, vars: resource.vars, helpers: resource.helpers })
+    this.#addHooks(hooks, resource)
+    return resource
+  }
+
+  async customize ({ hooks, methods = {}, vars, helpers, ...unsupported } = {}) {
+    if (Object.keys(unsupported).length) throw new TypeError(`Unsupported customization: ${Object.keys(unsupported).join(', ')}`)
+    assignValues(this.vars, vars)
+    assignValues(this.helpers, helpers)
+    for (const [name, handler] of Object.entries(methods)) this.#addResourceMethod(name, handler)
+    this.#addHooks(hooks)
+    return this
+  }
+
+  async runHooks (event, context = {}) {
+    return this.#hooks.run(event, this.#arguments(undefined, {}, context))
+  }
+}

package/lib/transaction-types.d.ts

@@ -0,0 +1,59 @@
+import type { Knex } from 'knex'
+import type { StorageRow } from '../plugins/core/lib/storage/storage-types.js'
+import type { TransactionOutcome } from '../types/errors.js'
+
+export type { TransactionOutcome } from '../types/errors.js'
+export type OwnedTransaction = Knex.Transaction<StorageRow, StorageRow[]>
+
+export interface CleanupDiagnostic {
+  phase: string
+  error: unknown
+  operationIndex?: number
+  finalizerIndex?: number
+  scopeName?: string
+  method?: string
+}
+
+// Only the context fields used by transaction orchestration; resource stages extend it.
+export interface TransactionContext {
+  transaction?: OwnedTransaction
+  transactionOutcome?: TransactionOutcome
+  transactionCommitted?: boolean
+  shouldCommit?: boolean
+  error?: unknown
+  cleanupErrors?: CleanupDiagnostic[]
+  scopeName?: string
+  method?: string
+}
+
+export type CompletionHook = (name: 'afterCommit' | 'afterRollback') => unknown | Promise<unknown>
+export type TransactionFactory = (context: TransactionContext) => Promise<OwnedTransaction>
+export type TransactionCallback<T> = ((transaction: OwnedTransaction) => T | Promise<T>) & {
+  transaction?: OwnedTransaction
+}
+export interface WriteRequest {
+  context: TransactionContext
+  params?: { transaction?: OwnedTransaction } | TransactionCallback<unknown>
+}
+
+export interface TransactionState {
+  transaction: OwnedTransaction
+  owner: TransactionContext
+  phase: 'pending' | 'completing' | 'finishing' | 'finished'
+  failed: boolean
+  error?: unknown
+  participants: Array<{
+    context: TransactionContext
+    runHooks: CompletionHook
+    operationIndex: number
+    failed?: boolean
+  }>
+  contexts: Set<TransactionContext>
+  finalizers: Array<() => unknown | Promise<unknown>>
+  inFlight: Map<TransactionContext, {
+    promise: Promise<void>
+    resolve: () => void
+    reject: (reason?: unknown) => void
+  }>
+  onQueryError?: (error: unknown) => void
+}

package/package.json

@@ -1,47 +1,114 @@
 {
   "name": "json-rest-api",
-  "version": "1.0.29",
+  "version": "2.1.0",
   "main": "index.js",
+  "types": "index.d.ts",
   "type": "module",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "lib/**/*.js",
+    "lib/**/*.d.ts",
+    "plugins/**/*.js",
+    "plugins/**/*.d.ts",
+    "types/**/*.d.ts",
+    "LICENSE",
+    "LICENSE-MIT",
+    "LICENSE-GPL-3.0",
+    "README.md",
+    "docs/API.md",
+    "docs/QUICKSTART.md",
+    "docs/GUIDE/**/*.md",
+    "docs/architecture.md",
+    "docs/contributing.md"
+  ],
   "scripts": {
     "test": "node --test tests/*.test.js",
+    "test:public-types": "node scripts/check-public-types.js",
+    "test:clean-package": "node scripts/check-clean-package.js",
+    "test:api-reference": "node scripts/check-api-reference.js",
+    "test:quickstart": "node scripts/check-quickstart.js",
+    "test:setup-guide": "node scripts/check-setup-guide.js",
+    "test:relationship-guides": "node scripts/check-relationship-guides.js",
+    "test:tutorial-guides": "node scripts/check-tutorial-guides.js",
+    "test:tutorial-guides:databases": "node scripts/test-databases.js all scripts/check-tutorial-guides.js",
+    "test:server-examples": "node scripts/check-server-examples.js",
+    "test:migration-guide": "node scripts/check-migration-guide.js",
+    "test:migration-guide:package": "node scripts/check-packaged-migration-guide.js",
+    "test:migration-guide:databases": "node scripts/test-databases.js all scripts/check-migration-guide.js",
+    "test:socket-guide": "node scripts/check-socket-guide.js && node --import ./tests/helpers/select-express4.js scripts/check-socket-guide.js",
+    "test:file-guide": "node scripts/check-file-guide.js && node --import ./tests/helpers/select-express4.js scripts/check-file-guide.js",
     "test:anyapi": "JSON_REST_API_STORAGE=anyapi node --test tests/*.test.js",
-    "test:id-contracts": "node --test tests/id-normalization.test.js tests/logical-id-write-validation.test.js tests/custom-id-simplified-post.test.js",
-    "test:id-contracts:anyapi": "JSON_REST_API_STORAGE=anyapi node --test tests/id-normalization.test.js",
+    "test:conformance": "npm run test:conformance:knex && npm run test:conformance:anyapi",
+    "test:conformance:knex": "JSON_REST_API_STORAGE=knex node --test tests/conformance-*.test.js",
+    "test:conformance:anyapi": "JSON_REST_API_STORAGE=anyapi node --test tests/conformance-*.test.js",
+    "test:consumer": "node scripts/check-consumer-package.js",
+    "test:multipart": "npm run test:multipart:knex && npm run test:multipart:anyapi",
+    "test:multipart:knex": "JSON_REST_API_STORAGE=knex node --test tests/multipart-detectors.test.js tests/multipart-uploads.test.js tests/file-handling.test.js",
+    "test:multipart:anyapi": "JSON_REST_API_STORAGE=anyapi node --test tests/multipart-detectors.test.js tests/multipart-uploads.test.js tests/file-handling.test.js",
+    "test:connectors": "npm run test:connectors:knex && npm run test:connectors:anyapi && npm run test:connectors:express4",
+    "test:connectors:knex": "JSON_REST_API_STORAGE=knex node --test tests/http-connectors-parity.test.js tests/conformance-bulk-authorization.test.js tests/conformance-related-permissions.test.js tests/fastify-plugin.test.js tests/connectors-query-parser.test.js tests/multipart-detectors.test.js tests/multipart-uploads.test.js tests/file-handling.test.js tests/cors.test.js tests/cors-transport.test.js tests/socketio.test.js tests/socketio-contract.test.js tests/conformance-socketio-authorization.test.js tests/conformance-include-permissions.test.js tests/conformance-search-authorization.test.js tests/conformance-reference-sorting.test.js tests/conformance-include-limits.test.js tests/anyapi-descriptor-failures.test.js tests/conformance-field-callback-failures.test.js tests/conformance-relationship-metadata.test.js tests/conformance-schema-enrichment.test.js tests/http-connector-diagnostics.test.js tests/conformance-http-validators.test.js tests/http-validator-client-example.test.js tests/http-validators.test.js tests/http-response-replacement.test.js tests/conformance-versioned-bulk.test.js tests/conformance-route-transactions.test.js",
+    "test:connectors:anyapi": "JSON_REST_API_STORAGE=anyapi node --test tests/http-connectors-parity.test.js tests/conformance-bulk-authorization.test.js tests/conformance-related-permissions.test.js tests/fastify-plugin.test.js tests/connectors-query-parser.test.js tests/multipart-detectors.test.js tests/multipart-uploads.test.js tests/file-handling.test.js tests/cors.test.js tests/cors-transport.test.js tests/socketio.test.js tests/socketio-contract.test.js tests/conformance-socketio-authorization.test.js tests/conformance-include-permissions.test.js tests/conformance-search-authorization.test.js tests/conformance-reference-sorting.test.js tests/conformance-include-limits.test.js tests/anyapi-descriptor-failures.test.js tests/conformance-field-callback-failures.test.js tests/conformance-relationship-metadata.test.js tests/conformance-schema-enrichment.test.js tests/http-connector-diagnostics.test.js tests/conformance-http-validators.test.js tests/http-validator-client-example.test.js tests/http-validators.test.js tests/http-response-replacement.test.js tests/conformance-versioned-bulk.test.js tests/conformance-route-transactions.test.js",
+    "test:connectors:express4": "npm run test:connectors:express4:knex && npm run test:connectors:express4:anyapi",
+    "test:connectors:express4:knex": "JSON_REST_API_STORAGE=knex node --import ./tests/helpers/select-express4.js --test --test-name-pattern 'HTTP serialized validators express|Conditional HTTP client example express|HTTP bulk version conditions express|HTTP diagnostic route metadata express|Real express|Real Socket.IO|Bulk HTTP authorization through express|Related HTTP authorization through express|Include HTTP authorization through express|Search HTTP authorization through express|Reference sort HTTP authorization through express|Include limit HTTP through express|Schema enrichment HTTP express' tests/conformance-bulk-authorization.test.js tests/conformance-related-permissions.test.js tests/http-connectors-parity.test.js tests/multipart-uploads.test.js tests/cors-transport.test.js tests/socketio-contract.test.js tests/conformance-socketio-authorization.test.js tests/conformance-include-permissions.test.js tests/conformance-search-authorization.test.js tests/conformance-reference-sorting.test.js tests/conformance-include-limits.test.js tests/anyapi-descriptor-failures.test.js tests/conformance-field-callback-failures.test.js tests/conformance-relationship-metadata.test.js tests/conformance-schema-enrichment.test.js tests/http-connector-diagnostics.test.js tests/conformance-versioned-bulk.test.js tests/conformance-http-validators.test.js tests/http-validator-client-example.test.js",
+    "test:connectors:express4:anyapi": "JSON_REST_API_STORAGE=anyapi node --import ./tests/helpers/select-express4.js --test --test-name-pattern 'HTTP serialized validators express|Conditional HTTP client example express|HTTP bulk version conditions express|HTTP diagnostic route metadata express|Real express|Real Socket.IO|Bulk HTTP authorization through express|Related HTTP authorization through express|Include HTTP authorization through express|Search HTTP authorization through express|Reference sort HTTP authorization through express|Include limit HTTP through express|Schema enrichment HTTP express' tests/conformance-bulk-authorization.test.js tests/conformance-related-permissions.test.js tests/http-connectors-parity.test.js tests/multipart-uploads.test.js tests/cors-transport.test.js tests/socketio-contract.test.js tests/conformance-socketio-authorization.test.js tests/conformance-include-permissions.test.js tests/conformance-search-authorization.test.js tests/conformance-reference-sorting.test.js tests/conformance-include-limits.test.js tests/anyapi-descriptor-failures.test.js tests/conformance-field-callback-failures.test.js tests/conformance-relationship-metadata.test.js tests/conformance-schema-enrichment.test.js tests/http-connector-diagnostics.test.js tests/conformance-versioned-bulk.test.js tests/conformance-http-validators.test.js tests/http-validator-client-example.test.js",
+    "test:id-contracts": "npm run test:id-contracts:knex && npm run test:id-contracts:anyapi",
+    "test:id-contracts:knex": "JSON_REST_API_STORAGE=knex node --test tests/conformance-ids.test.js tests/id-normalization.test.js tests/logical-id-write-validation.test.js tests/custom-id-simplified-post.test.js tests/custom-idproperty-relationships.test.js",
+    "test:id-contracts:anyapi": "JSON_REST_API_STORAGE=anyapi node --test tests/conformance-ids.test.js tests/id-normalization.test.js tests/custom-idproperty-relationships.test.js tests/anyapi-custom-idproperty.test.js",
+    "test:temporal": "npm run test:temporal:knex && npm run test:temporal:anyapi",
+    "test:temporal:knex": "JSON_REST_API_STORAGE=knex node --test tests/conformance-temporal.test.js tests/temporal-boundaries.test.js tests/storage-mapping.test.js tests/field-getters.test.js tests/field-setters.test.js tests/computed-fields.test.js",
+    "test:temporal:anyapi": "JSON_REST_API_STORAGE=anyapi node --test tests/conformance-temporal.test.js tests/temporal-boundaries.test.js tests/field-getters.test.js tests/field-setters.test.js tests/computed-fields.test.js",
     "docs": "node scripts/run-docs.js",
     "docs:dev": "node scripts/run-docs.js --serve",
-    "verify": "npm run test:id-contracts && npm run test:id-contracts:anyapi && npm run docs",
-    "sloc": "sloc --exclude \"(_site|node_modules|\\.git|vendor|docs)\" .",
-    "slod": "cd docs;echo 'DOC LINES:'; cat `find . -iname \\*md | grep -v _site | grep -v vendor` | wc",
+    "verify": "npm run typecheck && npm run test:public-types && npm run test:query-budgets && npm test && npm run test:anyapi && npm run test:connectors:express4 && npm run lint && npm run docs",
     "lint": "eslint .",
-    "lint:fix": "eslint . --fix"
+    "lint:fix": "eslint . --fix",
+    "test:socketio": "npm run test:socketio:knex && npm run test:socketio:anyapi",
+    "test:socketio:knex": "JSON_REST_API_STORAGE=knex node --test tests/socketio.test.js tests/socketio-contract.test.js tests/conformance-socketio-authorization.test.js",
+    "test:socketio:anyapi": "JSON_REST_API_STORAGE=anyapi node --test tests/socketio.test.js tests/socketio-contract.test.js tests/conformance-socketio-authorization.test.js",
+    "test:queries": "npm run test:queries:knex && npm run test:queries:anyapi",
+    "test:query-budgets": "npm run test:query-budgets:knex && npm run test:query-budgets:anyapi",
+    "test:query-budgets:knex": "JSON_REST_API_STORAGE=knex node scripts/measure-query-baseline.js",
+    "test:query-budgets:anyapi": "JSON_REST_API_STORAGE=anyapi node scripts/measure-query-baseline.js",
+    "test:stress": "npm run test:stress:knex && npm run test:stress:anyapi",
+    "test:stress:knex": "JSON_REST_API_STORAGE=knex node --expose-gc scripts/stress-resources.js",
+    "test:stress:anyapi": "JSON_REST_API_STORAGE=anyapi node --expose-gc scripts/stress-resources.js",
+    "test:queries:knex": "JSON_REST_API_STORAGE=knex node --test tests/conformance-queries.test.js tests/conformance-related.test.js tests/queries.test.js tests/projected-fields.test.js tests/nested-includes.test.js tests/include-traversal.test.js tests/searchschema-merge.test.js tests/conformance-search-authorization.test.js tests/conformance-reference-sorting.test.js tests/conformance-include-limits.test.js",
+    "test:queries:anyapi": "JSON_REST_API_STORAGE=anyapi node --test tests/conformance-queries.test.js tests/conformance-related.test.js tests/queries.test.js tests/projected-fields.test.js tests/nested-includes.test.js tests/include-traversal.test.js tests/searchschema-merge.test.js tests/conformance-search-authorization.test.js tests/conformance-reference-sorting.test.js tests/conformance-include-limits.test.js",
+    "test:authorization": "npm run test:authorization:knex && npm run test:authorization:anyapi",
+    "test:authorization:knex": "JSON_REST_API_STORAGE=knex node --test tests/conformance-authorization.test.js tests/conformance-bulk-authorization.test.js tests/conformance-related-permissions.test.js tests/conformance-transaction-context.test.js tests/bulk-operations.test.js tests/row-policy.test.js tests/autofilter.test.js tests/conformance-socketio-authorization.test.js tests/conformance-include-permissions.test.js tests/conformance-search-authorization.test.js tests/conformance-reference-sorting.test.js tests/conformance-include-limits.test.js",
+    "test:authorization:anyapi": "JSON_REST_API_STORAGE=anyapi node --test tests/conformance-authorization.test.js tests/conformance-bulk-authorization.test.js tests/conformance-related-permissions.test.js tests/conformance-transaction-context.test.js tests/bulk-operations.test.js tests/row-policy.test.js tests/autofilter.test.js tests/conformance-socketio-authorization.test.js tests/conformance-include-permissions.test.js tests/conformance-search-authorization.test.js tests/conformance-reference-sorting.test.js tests/conformance-include-limits.test.js",
+    "test:redis": "node scripts/test-databases.js redis",
+    "test:databases": "node scripts/test-databases.js",
+    "test:databases:sqlite": "node scripts/test-databases.js better-sqlite3",
+    "test:databases:pg": "node scripts/test-databases.js pg",
+    "test:databases:mysql": "node scripts/test-databases.js mysql2",
+    "typecheck": "tsc --project tsconfig.json"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/mobily-enterprises/jsonrestapi.git"
+    "url": "git+https://github.com/mobily-enterprises/json-rest-api.git"
   },
   "author": "Tony Mobily",
-  "license": "GPL-3.0-or-later",
+  "license": "(GPL-3.0-or-later OR MIT)",
   "bugs": {
-    "url": "https://github.com/mobily-enterprises/jsonrestapi/issues"
+    "url": "https://github.com/mobily-enterprises/json-rest-api/issues"
   },
   "homepage": "https://mobily-enterprises.github.io/json-rest-api",
-  "description": "REST API plugin for hooked-api with JSON:API compliance",
+  "description": "JSON:API mini-ORM with resource hooks and pluggable storage",
   "dependencies": {
-    "hooked-api": "^1.0.24",
+    "content-type": "^1.0.5",
     "json-rest-schema": "^1.0.17",
-    "semver": "^7.7.2"
+    "on-headers": "^1.1.0",
+    "vary": "^1.1.2"
   },
   "peerDependencies": {
     "@socket.io/redis-adapter": "^8.3.0",
     "busboy": "^1.0.0",
-    "content-type": "^1.0.0",
     "express": "^4.0.0 || ^5.0.0",
     "formidable": "^3.0.0",
     "fractional-indexing": "^3.2.0",
-    "jose": "^5.10.0 || ^6.0.0",
     "knex": "^3.1.0",
-    "raw-body": "^2.0.0",
     "redis": "^5.6.0",
     "socket.io": "^4.8.1"
   },
@@ -52,9 +119,6 @@
     "busboy": {
       "optional": true
     },
-    "content-type": {
-      "optional": true
-    },
     "express": {
       "optional": true
     },
@@ -64,15 +128,9 @@
     "fractional-indexing": {
       "optional": true
     },
-    "jose": {
-      "optional": true
-    },
     "knex": {
       "optional": true
     },
-    "raw-body": {
-      "optional": true
-    },
     "redis": {
       "optional": true
     },
@@ -82,16 +140,28 @@
   },
   "devDependencies": {
     "@socket.io/redis-adapter": "^8.3.0",
+    "@types/node": "24.0.14",
     "better-sqlite3": "^11.10.0",
+    "busboy": "^1.6.0",
+    "eslint": "^9.37.0",
     "express": "^5.1.0",
+    "express4": "npm:express@^4.22.2",
+    "fast-check": "^4.9.0",
+    "fastify": "^5.12.3",
+    "formidable": "^3.5.4",
     "fractional-indexing": "^3.2.0",
     "jose": "^6.2.2",
     "knex": "^3.1.0",
+    "mysql2": "^3.24.4",
+    "neostandard": "^0.12.2",
+    "pg": "^8.23.0",
     "redis": "^5.6.0",
     "socket.io": "^4.8.1",
     "socket.io-client": "^4.8.1",
     "supertest": "^7.1.3",
-    "eslint": "^9.37.0",
-    "neostandard": "^0.12.2"
+    "typescript": "5.9.3"
+  },
+  "engines": {
+    "node": ">=24.0.0"
   }
 }