velocious 1.0.577 → 1.0.579

package/build/http-server/worker-handler/index.js

@@ -57,7 +57,7 @@ export default class VelociousHttpServerWorker {
     this._debugRequestId = 0
     /**
      * Narrows the runtime value to the documented type.
-     * @type {Map<number, {resolve: (snapshot: Record<string, ?>) => void}>} */
+     * @type {Map<number, {resolve: (snapshot: Record<string, ReturnType<typeof JSON.parse>>) => void}>} */
     this._debugSnapshotRequests = new Map()
 
     /** @type {Map<number, ClientDeliveryQueue>} */
@@ -125,7 +125,7 @@ export default class VelociousHttpServerWorker {
 
   /**
    * On worker error.
-   * @param {?} error - Error instance.
+   * @param {ReturnType<typeof JSON.parse>} error - Error instance.
    */
   onWorkerError = (error) => {
     this.logger.error(`Velocious worker ${this.workerCount} error`, error)
@@ -191,10 +191,10 @@ export default class VelociousHttpServerWorker {
    * @param {boolean} [data.websocketFrame] - Whether output is a completed WebSocket frame.
    * @param {string} [data.channel] - Channel name.
    * @param {number} [data.requestId] - Debug request id.
-   * @param {Record<string, ?>} [data.snapshot] - Worker debug snapshot.
-   * @param {?} [data.payload] - Payload data.
-   * @param {Record<string, ?>} [data.broadcastParams] - V2 broadcast filter params.
-   * @param {?} [data.body] - V2 broadcast body.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} [data.snapshot] - Worker debug snapshot.
+   * @param {ReturnType<typeof JSON.parse>} [data.payload] - Payload data.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} [data.broadcastParams] - V2 broadcast filter params.
+   * @param {ReturnType<typeof JSON.parse>} [data.body] - V2 broadcast body.
    * @returns {void} - No return value.
    */
   onWorkerMessage = (data) => {
@@ -381,7 +381,7 @@ export default class VelociousHttpServerWorker {
 
   /**
    * Runs get debug snapshot.
-   * @returns {Promise<Record<string, ?>>} - Worker-local debug snapshot.
+   * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>>>} - Worker-local debug snapshot.
    */
   getDebugSnapshot() {
     if (!this.workerStarted || !this.worker) {
@@ -443,7 +443,7 @@ export default class VelociousHttpServerWorker {
    * @param {string} args.channel - Channel name.
    * @param {string} [args.createdAt] - Event creation time.
    * @param {string} [args.eventId] - Event identifier.
-   * @param {?} args.payload - Payload data.
+   * @param {ReturnType<typeof JSON.parse>} args.payload - Payload data.
    * @returns {void} - No return value.
    */
   dispatchWebsocketEvent({channel, createdAt, eventId, payload}) {
@@ -459,8 +459,8 @@ export default class VelociousHttpServerWorker {
    * dispatch to any locally-registered V2 subscriptions.
    * @param {object} args - Options object.
    * @param {string} args.channel - Channel name.
-   * @param {Record<string, ?>} args.broadcastParams - Routing filter params.
-   * @param {?} args.body - Message body.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} args.broadcastParams - Routing filter params.
+   * @param {ReturnType<typeof JSON.parse>} args.body - Message body.
    * @param {string} [args.eventId] - Persisted event id for replay.
    * @param {string} [args.createdAt] - Event creation timestamp.
    * @returns {void}

package/build/http-server/worker-handler/worker-thread.js

@@ -25,7 +25,7 @@ export default class VelociousHttpServerWorkerHandlerWorkerThread {
   /**
    * Runs constructor.
    * @param {object} args - Options object.
-   * @param {import("worker_threads").parentPort} args.parentPort - Parent port.
+   * @param {import("node:worker_threads").MessagePort | null} args.parentPort - Parent port.
    * @param {{debug: boolean, directory: string, environment: string, workerCount: number}} args.workerData - Worker configuration details.
    */
   constructor({parentPort, workerData}) {
@@ -104,9 +104,9 @@ export default class VelociousHttpServerWorkerHandlerWorkerThread {
    * @param {number} [data.requestId] - Debug request id.
    * @param {number} [data.transferId] - File transfer id.
    * @param {"completed" | "aborted"} [data.result] - File transfer result.
-   * @param {?} [data.payload] - Payload data.
-   * @param {Record<string, ?>} [data.broadcastParams] - V2 broadcast filter params.
-   * @param {?} [data.body] - V2 broadcast body.
+   * @param {ReturnType<typeof JSON.parse>} [data.payload] - Payload data.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} [data.broadcastParams] - V2 broadcast filter params.
+   * @param {ReturnType<typeof JSON.parse>} [data.body] - V2 broadcast body.
    */
   onCommand = async (data) => {
     await this.logger.debugLowLevel(() => [`Worker ${this.workerCount} received command`, data])
@@ -250,7 +250,7 @@ export default class VelociousHttpServerWorkerHandlerWorkerThread {
    * @param {string} [data.channel] - Channel name.
    * @param {string} [data.createdAt] - Event creation time.
    * @param {string} [data.eventId] - Event identifier.
-   * @param {?} [data.payload] - Payload data.
+   * @param {ReturnType<typeof JSON.parse>} [data.payload] - Payload data.
    * @returns {Promise<void>} Resolves when the websocket event is dispatched.
    */
   async handleWebsocketEvent(data) {
@@ -264,8 +264,8 @@ export default class VelociousHttpServerWorkerHandlerWorkerThread {
   /**
    * Runs handle websocket v2 broadcast.
    * @param {object} data - Data payload.
-   * @param {Record<string, ?>} [data.broadcastParams] - V2 broadcast filter params.
-   * @param {?} [data.body] - V2 broadcast body.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} [data.broadcastParams] - V2 broadcast filter params.
+   * @param {ReturnType<typeof JSON.parse>} [data.body] - V2 broadcast body.
    * @param {string} [data.channel] - Channel name.
    * @param {string} [data.eventId] - Event identifier.
    * @returns {void}
@@ -320,7 +320,7 @@ export default class VelociousHttpServerWorkerHandlerWorkerThread {
    * @param {string} args.channel - Channel name.
    * @param {string | undefined} args.createdAt - Event creation time.
    * @param {string | undefined} args.eventId - Event identifier.
-   * @param {?} args.payload - Payload data.
+   * @param {ReturnType<typeof JSON.parse>} args.payload - Payload data.
    * @returns {Promise<void>} - Resolves when complete.
    */
   async broadcastWebsocketEvent({channel, createdAt, eventId, payload}) {

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.js"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAA"}

package/build/logger/base-logger.js

@@ -18,7 +18,7 @@ export default class BaseLogger {
 
     return {
       output: this,
-      levels: /** @type {?} */ (this).levels
+      levels: /** @type {ReturnType<typeof JSON.parse>} */ (this).levels
     }
   }
 

package/build/logger.js

@@ -26,8 +26,8 @@ const LEVEL_ORDER = ["debug-low-level", "debug", "info", "warn", "error"]
 
 /**
  * Runs function or messages.
- * @param {...?|function() : Array<?>} messages - Messages.
- * @returns {Array<?>} - Either the function result or the messages
+ * @param {...ReturnType<typeof JSON.parse>|(() => Array<ReturnType<typeof JSON.parse>>)} messages - Messages.
+ * @returns {Array<ReturnType<typeof JSON.parse>>} - Either the function result or the messages
  */
 function functionOrMessages(...messages) {
   if (messages.length === 1 && typeof messages[0] == "function") {
@@ -40,7 +40,7 @@ function functionOrMessages(...messages) {
 
 /**
  * Format a single value for inclusion in a log message.
- * @param {?} value - Value to format.
+ * @param {ReturnType<typeof JSON.parse>} value - Value to format.
  * @returns {string} - String representation.
  */
 function formatPart(value) {
@@ -63,7 +63,7 @@ function formatPart(value) {
  * messages are interpolated into it in order (like `console.log` /
  * `util.format`). Any leftover messages are appended with a space
  * separator. Otherwise, all parts are joined with spaces.
- * @param {Array<?>} messages - User-supplied message parts.
+ * @param {Array<ReturnType<typeof JSON.parse>>} messages - User-supplied message parts.
  * @returns {string} - The formatted user message.
  */
 function formatUserMessages(messages) {
@@ -117,7 +117,7 @@ function formatUserMessages(messages) {
 /**
  * Converts a logger subject and message parts into a single log line.
  * @param {string} subject - Logger subject / category prefix.
- * @param {...?} messages - User-supplied message parts (supports printf-style format specifiers on the first part).
+ * @param {...ReturnType<typeof JSON.parse>} messages - User-supplied message parts (supports printf-style format specifiers on the first part).
  * @returns {string} - The formatted log line.
  */
 function messagesToMessage(subject, ...messages) {
@@ -196,7 +196,7 @@ function resolveLoggingOutputs({loggingConfiguration, configuration}) {
     for (const logger of loggingConfiguration.loggers) {
       if (!logger) continue
 
-      const loggerConfig = /** @type {?} */ (logger)
+      const loggerConfig = /** @type {ReturnType<typeof JSON.parse>} */ (logger)
 
       if (typeof loggerConfig.toOutputConfig === "function") {
         loggerOutputs.push(loggerConfig.toOutputConfig({configuration}))
@@ -317,7 +317,7 @@ async function writeLog({subject, level, messages, configuration, loggingConfigu
   const writes = []
   /**
    * Types the following value.
-   * @type {Array<?> | undefined} */
+   * @type {Array<ReturnType<typeof JSON.parse>> | undefined} */
   let resolvedMessages
   /**
    * Types the following value.
@@ -420,7 +420,7 @@ export default class Logger {
 
   /**
    * Runs debug.
-   * @param {Array<?>} messages - Messages.
+   * @param {Array<ReturnType<typeof JSON.parse>>} messages - Messages.
    * @returns {Promise<void>} - Resolves when complete.
    */
   async debug(...messages) {
@@ -429,7 +429,7 @@ export default class Logger {
 
   /**
    * Runs info.
-   * @param {Array<?>} messages - Messages.
+   * @param {Array<ReturnType<typeof JSON.parse>>} messages - Messages.
    * @returns {Promise<void>} - Resolves when complete.
    */
   async info(...messages) {
@@ -438,7 +438,7 @@ export default class Logger {
 
   /**
    * Runs debug low level.
-   * @param {Array<?>} messages - Messages.
+   * @param {Array<ReturnType<typeof JSON.parse>>} messages - Messages.
    * @returns {Promise<void>} - Resolves when complete.
    */
   async debugLowLevel(...messages) {
@@ -447,7 +447,7 @@ export default class Logger {
 
   /**
    * Runs log.
-   * @param {Array<?>} messages - Messages.
+   * @param {Array<ReturnType<typeof JSON.parse>>} messages - Messages.
    * @returns {Promise<void>} - Resolves when complete.
    */
   async log(...messages) {
@@ -456,7 +456,7 @@ export default class Logger {
 
   /**
    * Runs error.
-   * @param {Array<?>} messages - Messages.
+   * @param {Array<ReturnType<typeof JSON.parse>>} messages - Messages.
    * @returns {Promise<void>} - Resolves when complete.
    */
   async error(...messages) {

package/build/mailer/backends/smtp.js

@@ -4,11 +4,11 @@ import restArgsError from "../../utils/rest-args-error.js"
 
 /**
  * Defines this typedef.
- * @typedef {{auth?: Record<string, ?>, [key: string]: ?}} SmtpConnectionOptions */
+ * @typedef {{auth?: Record<string, ReturnType<typeof JSON.parse>>, [key: string]: ReturnType<typeof JSON.parse>}} SmtpConnectionOptions */
 
 /**
  * Runs normalize recipients.
- * @param {?} value - Recipient input.
+ * @param {ReturnType<typeof JSON.parse>} value - Recipient input.
  * @returns {string[]} - Normalized recipients.
  */
 function normalizeRecipients(value) {
@@ -160,7 +160,7 @@ export default class SmtpMailerBackend {
       }
 
       const sendMessage = () => {
-        connection.send({from: envelopeFrom, to: recipients}, /** @type {?} */ (message), (/** @type {Error | null | undefined} */ sendError) => {
+        connection.send({from: envelopeFrom, to: recipients}, /** @type {ReturnType<typeof JSON.parse>} */ (message), (/** @type {Error | null | undefined} */ sendError) => {
           if (sendError) {
             rejectDelivery(sendError)
             return

package/build/mailer/base.js

@@ -13,7 +13,7 @@ import MailerDelivery from "./delivery.js"
 const deliveriesStore = []
 /**
  * Delivery handler.
- * @type {((payload: import("./index.js").MailerDeliveryPayload) => Promise<?> | ?) | null} */
+ * @type {((payload: import("./index.js").MailerDeliveryPayload) => Promise<ReturnType<typeof JSON.parse>> | ReturnType<typeof JSON.parse>) | null} */
 let deliveryHandler = null
 
 /**
@@ -58,7 +58,7 @@ function inferActionName(mailerClass, stack) {
     if (frameActionName.startsWith("_")) continue
     if (frameActionName === "constructor") continue
     if (Object.prototype.hasOwnProperty.call(VelociousMailerBase.prototype, frameActionName)) continue
-    if (typeof /** @type {Record<string, ?>} */ (/** @type {?} */ (prototype))[frameActionName] !== "function") continue
+    if (typeof /** @type {Record<string, ReturnType<typeof JSON.parse>>} */ (/** @type {ReturnType<typeof JSON.parse>} */ (prototype))[frameActionName] !== "function") continue
 
     actionName = frameActionName
   }
@@ -94,7 +94,7 @@ export class VelociousMailerBase {
 
   /**
    * Runs assign view.
-   * @param {Record<string, ?>} params - View params.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} params - View params.
    * @returns {void} - No return value.
    */
   assignView(params) {
@@ -104,15 +104,15 @@ export class VelociousMailerBase {
   /**
    * Runs mail.
    * @param {object} args - Mail options.
-   * @param {?} args.to - Recipient.
+   * @param {ReturnType<typeof JSON.parse>} args.to - Recipient.
    * @param {string} args.subject - Subject line.
-   * @param {?} [args.from] - Sender.
-   * @param {?} [args.cc] - CC recipients.
-   * @param {?} [args.bcc] - BCC recipients.
-   * @param {?} [args.replyTo] - Reply-to address.
+   * @param {ReturnType<typeof JSON.parse>} [args.from] - Sender.
+   * @param {ReturnType<typeof JSON.parse>} [args.cc] - CC recipients.
+   * @param {ReturnType<typeof JSON.parse>} [args.bcc] - BCC recipients.
+   * @param {ReturnType<typeof JSON.parse>} [args.replyTo] - Reply-to address.
    * @param {Record<string, string>} [args.headers] - Custom headers.
    * @param {string} [args.actionName] - Mailer action name.
-   * @param {Promise<?> | ?} [args.actionPromise] - Action completion promise.
+   * @param {Promise<ReturnType<typeof JSON.parse>> | ReturnType<typeof JSON.parse>} [args.actionPromise] - Action completion promise.
    * @returns {MailerDelivery} - Delivery wrapper.
    */
   mail({to, subject, from, cc, bcc, replyTo, headers, actionName, actionPromise, ...restArgs}) {
@@ -209,7 +209,7 @@ export class VelociousMailerBase {
     const actionName = this._getActionName()
     const fileName = viewFileName(actionName)
     const viewPath = `${configuration.getDirectory()}/src/mailers/${mailerDir}/${fileName}.ejs`
-    const translate = (/** @type {string} */ msgID, /** @type {Record<string, ?> | undefined} */ args) => configuration.getTranslator()(msgID, args)
+    const translate = (/** @type {string} */ msgID, /** @type {Record<string, ReturnType<typeof JSON.parse>> | undefined} */ args) => configuration.getTranslator()(msgID, args)
     const viewParams = incorporate({mailer: this, _: translate}, this._viewParams)
 
     return await new Promise((resolve, reject) => {
@@ -232,7 +232,7 @@ export class VelociousMailerBase {
   /**
    * Runs deliver payload.
    * @param {import("./index.js").MailerDeliveryPayload} payload - Mail delivery payload.
-   * @returns {Promise<import("./index.js").MailerDeliveryPayload | ?>} - Handler result.
+   * @returns {Promise<import("./index.js").MailerDeliveryPayload | ReturnType<typeof JSON.parse>>} - Handler result.
    */
   async _deliverPayload(payload) {
     return await deliverPayload(payload)
@@ -266,7 +266,7 @@ export function clearDeliveries() {
 
 /**
  * Runs the setDeliveryHandler helper.
- * @param {(payload: import("./index.js").MailerDeliveryPayload) => Promise<?> | ?} handler - Delivery handler.
+ * @param {(payload: import("./index.js").MailerDeliveryPayload) => Promise<ReturnType<typeof JSON.parse>> | ReturnType<typeof JSON.parse>} handler - Delivery handler.
  * @returns {void} - No return value.
  */
 export function setDeliveryHandler(handler) {
@@ -275,7 +275,7 @@ export function setDeliveryHandler(handler) {
 
 /**
  * Runs the getDeliveryHandler helper.
- * @returns {((payload: import("./index.js").MailerDeliveryPayload) => Promise<?> | ?) | null} - Handler or null.
+ * @returns {((payload: import("./index.js").MailerDeliveryPayload) => Promise<ReturnType<typeof JSON.parse>> | ReturnType<typeof JSON.parse>) | null} - Handler or null.
  */
 export function getDeliveryHandler() {
   return deliveryHandler
@@ -284,7 +284,7 @@ export function getDeliveryHandler() {
 /**
  * Runs the deliverPayload helper.
  * @param {import("./index.js").MailerDeliveryPayload} payload - Mail delivery payload.
- * @returns {Promise<import("./index.js").MailerDeliveryPayload | ?>} - Handler result.
+ * @returns {Promise<import("./index.js").MailerDeliveryPayload | ReturnType<typeof JSON.parse>>} - Handler result.
  */
 export async function deliverPayload(payload) {
   if (await isTestingEnvironment()) {

package/build/mailer/delivery.js

@@ -10,7 +10,7 @@ export default class MailerDelivery {
   mailer
   /**
    * Narrows the runtime value to the documented type.
-   * @type {Promise<?>} */
+   * @type {Promise<ReturnType<typeof JSON.parse>>} */
   actionPromise
   /**
    * Narrows the runtime value to the documented type.
@@ -21,7 +21,7 @@ export default class MailerDelivery {
    * Runs constructor.
    * @param {object} args - Constructor args.
    * @param {import("./base.js").VelociousMailerBase} args.mailer - Mailer instance.
-   * @param {Promise<?>} args.actionPromise - Action promise.
+   * @param {Promise<ReturnType<typeof JSON.parse>>} args.actionPromise - Action promise.
    * @param {string} args.actionName - Action name.
    */
   constructor({mailer, actionPromise, actionName}) {
@@ -42,7 +42,7 @@ export default class MailerDelivery {
 
   /**
    * Runs deliver now.
-   * @returns {Promise<import("./index.js").MailerDeliveryPayload | ?>} - Delivered payload or handler result.
+   * @returns {Promise<import("./index.js").MailerDeliveryPayload | ReturnType<typeof JSON.parse>>} - Delivered payload or handler result.
    */
   async deliverNow() {
     const payload = await this.buildPayload()

package/build/mailer/index.js

@@ -1,6 +1,6 @@
 // @ts-check
 
-/** @typedef {{to: ?, subject: string, from?: ?, cc?: ?, bcc?: ?, replyTo?: ?, headers?: Record<string, string>, html: string, mailer: string, action: string}} MailerDeliveryPayload */
+/** @typedef {{to: ReturnType<typeof JSON.parse>, subject: string, from?: ReturnType<typeof JSON.parse>, cc?: ReturnType<typeof JSON.parse>, bcc?: ReturnType<typeof JSON.parse>, replyTo?: ReturnType<typeof JSON.parse>, headers?: Record<string, string>, html: string, mailer: string, action: string}} MailerDeliveryPayload */
 
 import {
   clearDeliveries,

package/build/mailer.js

@@ -1,6 +1,6 @@
 // @ts-check
 
-/** @typedef {{to: ?, subject: string, from?: ?, cc?: ?, bcc?: ?, replyTo?: ?, headers?: Record<string, string>, html: string, mailer: string, action: string}} MailerDeliveryPayload */
+/** @typedef {{to: ReturnType<typeof JSON.parse>, subject: string, from?: ReturnType<typeof JSON.parse>, cc?: ReturnType<typeof JSON.parse>, bcc?: ReturnType<typeof JSON.parse>, replyTo?: ReturnType<typeof JSON.parse>, headers?: Record<string, string>, html: string, mailer: string, action: string}} MailerDeliveryPayload */
 
 export {
   VelociousMailerBase,

package/build/plugins/sqljs-wasm-route-controller.js

@@ -5,7 +5,7 @@ import Controller from "../controller.js"
 
 /**
  * Runs valid asset file name.
- * @param {?} assetFileName - Asset file name.
+ * @param {ReturnType<typeof JSON.parse>} assetFileName - Asset file name.
  * @returns {boolean} - Whether asset file name is safe.
  */
 function validAssetFileName(assetFileName) {

package/build/record-payload-values.js

@@ -1,7 +1,7 @@
 // @ts-check
 
 /**
- * @typedef {{_associationCounts?: Map<string, number>, _computedAbilities?: Map<string, boolean>, _queryDataValues?: Map<string, ?>}} RecordPayloadValuesTarget
+ * @typedef {{_associationCounts?: Map<string, number>, _computedAbilities?: Map<string, boolean>, _queryDataValues?: Map<string, ReturnType<typeof JSON.parse>>}} RecordPayloadValuesTarget
  */
 
 /**
@@ -60,7 +60,7 @@ export function setPayloadComputedAbility(target, action, value) {
  * Read a queryData value attached to a record/frontend-model payload.
  * @param {RecordPayloadValuesTarget} target - Record-like object holding queryData payload values.
  * @param {string} name - queryData alias name.
- * @returns {?} Attached queryData value, or null when it was not loaded.
+ * @returns {ReturnType<typeof JSON.parse>} Attached queryData value, or null when it was not loaded.
  */
 export function readPayloadQueryData(target, name) {
   if (!target._queryDataValues) return null
@@ -73,7 +73,7 @@ export function readPayloadQueryData(target, name) {
  * Store a queryData value attached to a record/frontend-model payload.
  * @param {RecordPayloadValuesTarget} target - Record-like object holding queryData payload values.
  * @param {string} name - queryData alias name.
- * @param {?} value - Attached queryData value.
+ * @param {ReturnType<typeof JSON.parse>} value - Attached queryData value.
  * @returns {void}
  */
 export function setPayloadQueryData(target, name, value) {

package/build/routes/base-route.js

@@ -60,7 +60,7 @@ export default class VelociousBaseRoute {
 
   /**
    * Mounts.
-   * @type {Array<{mountable: {mountInto: (args: object) => void}, options: Record<string, ?>}>} */
+   * @type {Array<{mountable: {mountInto: (args: object) => void}, options: Record<string, ReturnType<typeof JSON.parse>>}>} */
   mounts = []
 
   constructor() {
@@ -69,7 +69,7 @@ export default class VelociousBaseRoute {
 
   /**
    * Runs get mounts.
-   * @returns {Array<{mountable: {mountInto: (args: object) => void}, options: Record<string, ?>}>} - Mounts declared on this route.
+   * @returns {Array<{mountable: {mountInto: (args: object) => void}, options: Record<string, ReturnType<typeof JSON.parse>>}>} - Mounts declared on this route.
    */
   getMounts() { return this.mounts }
 
@@ -96,7 +96,7 @@ export default class VelociousBaseRoute {
   /**
    * Runs match with path.
    * @param {object} args - Options object.
-   * @param {Record<string, ?>} args.params - Parameters object.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} args.params - Parameters object.
    * @param {string} args.path - Path.
    * @param {import("../http-server/client/request.js").default | import("../http-server/client/websocket-request.js").default} args.request - Request object.
    * @returns {{restPath: string} | undefined} - REST path metadata for this route.
@@ -109,7 +109,7 @@ export default class VelociousBaseRoute {
    * Runs namespace.
    * @abstract
    * @param {string} name - Name.
-   * @param {function(import("./namespace-route.js").default) : void} callback - Callback function.
+   * @param {(arg: import("./namespace-route.js").default) => void} callback - Callback function.
    * @returns {void} - No return value.
    */
   namespace(name, callback) { throw new Error("'namespace' not implemented") } // eslint-disable-line no-unused-vars
@@ -126,7 +126,7 @@ export default class VelociousBaseRoute {
    * Runs resources.
    * @abstract
    * @param {string} name - Name.
-   * @param {function(import("./resource-route.js").default) : void} callback - Callback function.
+   * @param {(arg: import("./resource-route.js").default) => void} callback - Callback function.
    * @returns {void} - No return value.
    */
   resources(name, callback) { throw new Error("'resources' not implemented") } // eslint-disable-line no-unused-vars

package/build/routes/basic-route.js

@@ -17,7 +17,7 @@ export default class VelociousBasicRoute extends BaseRoute {
   /**
    * Runs match with path.
    * @param {object} args - Options object.
-   * @param {Record<string, ?>} args.params - Parameters object.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} args.params - Parameters object.
    * @param {string} args.path - Path.
    * @param {import("../http-server/client/request.js").default | import("../http-server/client/websocket-request.js").default} args.request - Request object.
    * @returns {{restPath: string} | undefined} - REST path metadata for this route.
@@ -40,7 +40,7 @@ export default class VelociousBasicRoute extends BaseRoute {
       throw new Error("mount expects a mountable with a 'mountInto' method")
     }
 
-    const at = /** @type {Record<string, ?>} */ (options).at
+    const at = /** @type {Record<string, ReturnType<typeof JSON.parse>>} */ (options).at
 
     if (typeof at !== "string" || !at.startsWith("/")) {
       throw new Error(`mount requires an 'at' option starting with '/', got: ${String(at)}`)
@@ -52,7 +52,7 @@ export default class VelociousBasicRoute extends BaseRoute {
   /**
    * Runs namespace.
    * @param {string} name - Name.
-   * @param {function(import("./namespace-route.js").default) : void} callback - Callback function.
+   * @param {(arg: import("./namespace-route.js").default) => void} callback - Callback function.
    * @returns {void} - No return value.
    */
   namespace(name, callback) {
@@ -87,7 +87,7 @@ export default class VelociousBasicRoute extends BaseRoute {
   /**
    * Runs resources.
    * @param {string} name - Name.
-   * @param {function(import("./resource-route.js").default) : void} [callback] - Callback function.
+   * @param {(arg: import("./resource-route.js").default) => void} [callback] - Callback function.
    * @returns {void} - No return value.
    */
   resources(name, callback) {

package/build/routes/get-route.js

@@ -7,7 +7,7 @@ import restArgsError from "../utils/rest-args-error.js"
 
 /**
  * Runs assign action and controller.
- * @param {Record<string, ?>} params - Route params object.
+ * @param {Record<string, ReturnType<typeof JSON.parse>>} params - Route params object.
  * @param {string} name - Route name.
  * @returns {void} - No return value.
  */
@@ -49,7 +49,7 @@ class VelociousRouteGetRoute extends BaseRoute {
   /**
    * Runs match with path.
    * @param {object} args - Options object.
-   * @param {Record<string, ?>} args.params - Parameters object.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} args.params - Parameters object.
    * @param {string} args.path - Path.
    * @param {import("../http-server/client/request.js").default | import("../http-server/client/websocket-request.js").default} args.request - Request object.
    * @returns {{restPath: string} | undefined} - REST path metadata for this route.

package/build/routes/hooks/frontend-model-command-route-hook.js

@@ -69,7 +69,7 @@ export default async function frontendModelCommandRouteHook({configuration, curr
   if (customCommandMatch) {
     /**
      * Params.
-     * @type {Record<string, ?>} */
+     * @type {Record<string, ReturnType<typeof JSON.parse>>} */
     const params = {
       frontendModelCustomCommandMethodName: customCommandMatch.methodName,
       frontendModelCustomCommandScope: customCommandMatch.scope,

package/build/routes/index.js

@@ -11,7 +11,7 @@ export default class VelociousRoutes {
 
   /**
    * Runs draw.
-   * @param {function(import("./root-route.js").default) : void} callback - Callback function.
+   * @param {(arg: import("./root-route.js").default) => void} callback - Callback function.
    * @returns {void} - No return value.
    */
   draw(callback) {
@@ -21,12 +21,12 @@ export default class VelociousRoutes {
   /**
    * Collects all `route.mount(...)` registrations across the route tree so the
    * configuration can apply them when the routes are set.
-   * @returns {Array<{mountable: {mountInto: (args: object) => void}, options: Record<string, ?>}>} - Declared mounts.
+   * @returns {Array<{mountable: {mountInto: (args: object) => void}, options: Record<string, ReturnType<typeof JSON.parse>>}>} - Declared mounts.
    */
   getMounts() {
     /**
      * Collected.
-     * @type {Array<{mountable: {mountInto: (args: object) => void}, options: Record<string, ?>}>} */
+     * @type {Array<{mountable: {mountInto: (args: object) => void}, options: Record<string, ReturnType<typeof JSON.parse>>}>} */
     const collected = []
 
     /**

package/build/routes/namespace-route.js

@@ -27,7 +27,7 @@ class VelociousRouteNamespaceRoute extends BasicRoute {
   /**
    * Runs match with path.
    * @param {object} args - Options object.
-   * @param {Record<string, ?>} args.params - Parameters object.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} args.params - Parameters object.
    * @param {string} args.path - Path.
    * @param {import("../http-server/client/request.js").default | import("../http-server/client/websocket-request.js").default} args.request - Request object.
    * @returns {{restPath: string} | undefined} - REST path metadata for this route.

package/build/routes/plugin-routes.js

@@ -1,7 +1,7 @@
 /**
  * AddRouteOptions type.
  * @typedef {object} AddRouteOptions
- * @property {Record<string, ?>} [params] - Static params to merge for matched route.
+ * @property {Record<string, ReturnType<typeof JSON.parse>>} [params] - Static params to merge for matched route.
  * @property {[typeof import("../controller.js").default, string]} to - Controller class and action tuple.
  * @property {string} [viewPath] - Optional view path for controllers using renderView().
  */

package/build/routes/post-route.js

@@ -6,7 +6,7 @@ import restArgsError from "../utils/rest-args-error.js"
 
 /**
  * Runs assign action and controller.
- * @param {Record<string, ?>} params - Route params object.
+ * @param {Record<string, ReturnType<typeof JSON.parse>>} params - Route params object.
  * @param {string} name - Route name.
  * @returns {void} - No return value.
  */
@@ -48,7 +48,7 @@ class VelociousRoutePostRoute extends BaseRoute {
   /**
    * Runs match with path.
    * @param {object} args - Options object.
-   * @param {Record<string, ?>} args.params - Parameters object.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} args.params - Parameters object.
    * @param {string} args.path - Path.
    * @param {import("../http-server/client/request.js").default | import("../http-server/client/websocket-request.js").default} args.request - Request object.
    * @returns {{restPath: string} | undefined} - REST path metadata for this route.

package/build/routes/resolver.js

@@ -161,7 +161,7 @@ export default class VelociousRoutesResolver {
       throw new Error(`Missing action on controller: ${controller}#${action}`)
     }
 
-    const actionHandlers = /** @type {Record<string, () => void | Promise<void>>} */ (/** @type {?} */ (controllerInstance))
+    const actionHandlers = /** @type {Record<string, () => void | Promise<void>>} */ (/** @type {ReturnType<typeof JSON.parse>} */ (controllerInstance))
 
     const logMethod = this._logMethod()
 
@@ -370,7 +370,7 @@ export default class VelociousRoutesResolver {
     const request = this.request
     const timestamp = this._formatTimestamp(new Date())
     const remoteAddress = request.remoteAddress() || "unknown"
-    const loggedParams = /** @type {Record<string, ?>} */ (this._sanitizeParamsForLogging(this.params))
+    const loggedParams = /** @type {Record<string, ReturnType<typeof JSON.parse>>} */ (this._sanitizeParamsForLogging(this.params))
 
     delete loggedParams.action
     delete loggedParams.controller
@@ -449,8 +449,8 @@ export default class VelociousRoutesResolver {
 
   /**
    * Runs sanitize params for logging.
-   * @param {?} value - Value to use.
-   * @returns {?} - The sanitize params for logging.
+   * @param {ReturnType<typeof JSON.parse>} value - Value to use.
+   * @returns {ReturnType<typeof JSON.parse>} - The sanitize params for logging.
    */
   _sanitizeParamsForLogging(value) {
     if (value instanceof UploadedFile) {
@@ -468,7 +468,7 @@ export default class VelociousRoutesResolver {
     if (value && typeof value === "object") {
       /**
        * Result.
-       * @type {Record<string, ?>} */
+       * @type {Record<string, ReturnType<typeof JSON.parse>>} */
       const result = {}
 
       for (const key of Object.keys(value)) {