velocious 1.0.577 → 1.0.579

package/build/environment-handlers/node/cli/commands/runner.js

@@ -10,7 +10,7 @@ import buildCliCommandContext from "./cli-command-context.js"
 export default class RunnerCommand extends BaseCommand {
   /**
    * Runs execute.
-   * @returns {Promise<?>} - Resolves with the evaluated code result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the evaluated code result.
    */
   async execute() {
     const configuration = this.getConfiguration()
@@ -66,7 +66,7 @@ export default class RunnerCommand extends BaseCommand {
   /**
    * Runs evaluate code.
    * @param {string} code - JavaScript code to evaluate.
-   * @returns {Promise<?>} - Evaluated code result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Evaluated code result.
    */
   async evaluateCode(code) {
     const context = this.buildRunnerContext()

package/build/environment-handlers/node/cli/commands/server.js

@@ -39,7 +39,7 @@ export function waitForApplicationWithSignalShutdown({application, processObject
 
     /**
      * Completes the wait promise once.
-     * @param {?} [error] - Optional rejection reason.
+     * @param {ReturnType<typeof JSON.parse>} [error] - Optional rejection reason.
      * @returns {void}
      */
     const finish = (error) => {

package/build/environment-handlers/node.js

@@ -39,7 +39,7 @@ import AttachmentPathSource from "./node/attachment-path-source.js"
 
 /**
  * Defines this typedef.
- * @typedef {{ability?: import("../authorization/ability.js").default, offsetMinutes: number, requestTiming?: import("../http-server/client/request-timing.js").default, tenant?: ?, timeZone?: string}} TimezoneStore */
+ * @typedef {{ability?: import("../authorization/ability.js").default, offsetMinutes: number, requestTiming?: import("../http-server/client/request-timing.js").default, tenant?: ReturnType<typeof JSON.parse>, timeZone?: string}} TimezoneStore */
 
 /**
  * Runs path within allowed prefixes.
@@ -118,11 +118,11 @@ export default class VelociousEnvironmentHandlerNode extends Base{
 
       /**
        * Discovered frontend-model resources keyed by model name.
-       * @type {Record<string, ?>} */
+       * @type {Record<string, ReturnType<typeof JSON.parse>>} */
       const discovered = {}
       /**
        * Every discovered ability resource class (frontend-model and authorization).
-       * @type {Array<?>} */
+       * @type {Array<ReturnType<typeof JSON.parse>>} */
       const abilityResourceClasses = []
 
       for (const file of files) {
@@ -284,8 +284,8 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs run with timezone offset.
    * @param {number} offsetMinutes - Offset in minutes (Date#getTimezoneOffset).
-   * @param {() => Promise<?>} callback - Callback to run.
-   * @returns {Promise<?>} - Result of the callback.
+   * @param {() => Promise<ReturnType<typeof JSON.parse>>} callback - Callback to run.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Result of the callback.
    */
   async runWithTimezoneOffset(offsetMinutes, callback) {
     if (!this._timezoneAsyncLocalStorage) {
@@ -306,8 +306,8 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs run with timezone.
    * @param {string} timeZone - IANA timezone identifier.
-   * @param {() => Promise<?>} callback - Callback to run.
-   * @returns {Promise<?>} - Result of the callback.
+   * @param {() => Promise<ReturnType<typeof JSON.parse>>} callback - Callback to run.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Result of the callback.
    */
   async runWithTimezone(timeZone, callback) {
     if (!this._timezoneAsyncLocalStorage) {
@@ -416,8 +416,8 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs run with ability.
    * @param {import("../authorization/ability.js").default | undefined} ability - Ability to set for callback scope.
-   * @param {() => Promise<?>} callback - Callback.
-   * @returns {Promise<?>} - Callback result.
+   * @param {() => Promise<ReturnType<typeof JSON.parse>>} callback - Callback.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Callback result.
    */
   async runWithAbility(ability, callback) {
     if (!this._timezoneAsyncLocalStorage) {
@@ -476,8 +476,8 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs run with request timing.
    * @param {import("../http-server/client/request-timing.js").default | undefined} requestTiming - Request timing collector.
-   * @param {() => Promise<?>} callback - Callback.
-   * @returns {Promise<?>} - Callback result.
+   * @param {() => Promise<ReturnType<typeof JSON.parse>>} callback - Callback.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Callback result.
    */
   async runWithRequestTiming(requestTiming, callback) {
     if (!this._timezoneAsyncLocalStorage) {
@@ -509,9 +509,9 @@ export default class VelociousEnvironmentHandlerNode extends Base{
 
   /**
    * Runs run with tenant.
-   * @param {?} tenant - Tenant to set for callback scope.
-   * @param {() => Promise<?>} callback - Callback.
-   * @returns {Promise<?>} - Callback result.
+   * @param {ReturnType<typeof JSON.parse>} tenant - Tenant to set for callback scope.
+   * @param {() => Promise<ReturnType<typeof JSON.parse>>} callback - Callback.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Callback result.
    */
   async runWithTenant(tenant, callback) {
     if (!this._timezoneAsyncLocalStorage) {
@@ -531,7 +531,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
 
   /**
    * Runs set current tenant.
-   * @param {?} tenant - Tenant to set.
+   * @param {ReturnType<typeof JSON.parse>} tenant - Tenant to set.
    * @returns {void} - No return value.
    */
   setCurrentTenant(tenant) {
@@ -557,7 +557,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
 
   /**
    * Runs get current tenant.
-   * @returns {?} - Current tenant.
+   * @returns {ReturnType<typeof JSON.parse>} - Current tenant.
    */
   getCurrentTenant() {
     if (!this._timezoneAsyncLocalStorage) {
@@ -616,7 +616,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands init.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsInit(command) {
     return await this.forwardCommand(command, CliCommandsInit)
@@ -625,7 +625,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands migration generate.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsMigrationGenerate(command) {
     return await this.forwardCommand(command, CliCommandsGenerateMigration)
@@ -634,7 +634,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands migration destroy.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsMigrationDestroy(command) {
     return await this.forwardCommand(command, CliCommandsDestroyMigration)
@@ -643,7 +643,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands generate base models.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsGenerateBaseModels(command) {
     return await this.forwardCommand(command, CliCommandsGenerateBaseModels)
@@ -652,7 +652,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands generate frontend models.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsGenerateFrontendModels(command) {
     return await this.forwardCommand(command, CliCommandsGenerateFrontendModels)
@@ -661,7 +661,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands generate model.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsGenerateModel(command) {
     return await this.forwardCommand(command, CliCommandsGenerateModel)
@@ -670,7 +670,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands lint relationships.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsLintRelationships(command) {
     return await this.forwardCommand(command, CliCommandsLintRelationships)
@@ -679,7 +679,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands routes.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsRoutes(command) {
     return await this.forwardCommand(command, CliCommandsRoutes)
@@ -688,7 +688,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands console.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsConsole(command) {
     return await this.forwardCommand(command, CliCommandsConsole)
@@ -697,7 +697,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands server.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsServer(command) {
     return await this.forwardCommand(command, CliCommandsServer)
@@ -706,7 +706,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands test.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsTest(command) {
     return await this.forwardCommand(command, CliCommandsTest)
@@ -715,7 +715,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands background jobs main.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsBackgroundJobsMain(command) {
     return await this.forwardCommand(command, CliCommandsBackgroundJobsMain)
@@ -724,7 +724,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands background jobs worker.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsBackgroundJobsWorker(command) {
     return await this.forwardCommand(command, CliCommandsBackgroundJobsWorker)
@@ -733,7 +733,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands background jobs runner.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsBackgroundJobsRunner(command) {
     return await this.forwardCommand(command, CliCommandsBackgroundJobsRunner)
@@ -742,7 +742,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands beacon.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsBeacon(command) {
     return await this.forwardCommand(command, CliCommandsBeacon)
@@ -771,7 +771,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands db schema dump.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsDbSchemaDump(command) {
     return await this.forwardCommand(command, CliCommandsDbSchemaDump)
@@ -780,7 +780,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands db schema load.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsDbSchemaLoad(command) {
     return await this.forwardCommand(command, CliCommandsDbSchemaLoad)
@@ -789,7 +789,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands db seed.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsDbSeed(command) {
     return await this.forwardCommand(command, CliCommandsDbSeed)
@@ -798,7 +798,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands runner.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsRunner(command) {
     return await this.forwardCommand(command, CliCommandsRunner)
@@ -807,7 +807,7 @@ export default class VelociousEnvironmentHandlerNode extends Base{
   /**
    * Runs cli commands run script.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsRunScript(command) {
     return await this.forwardCommand(command, CliCommandsRunScript)

package/build/error-logger.js

@@ -2,8 +2,8 @@
 
 /**
  * Runs error logger.
- * @param {(...args: Array<?>) => Promise<void>} callback - Callback function.
- * @returns {(...args: Array<?>) => Promise<void>} - The error logger.
+ * @param {(...args: Array<ReturnType<typeof JSON.parse>>) => Promise<void>} callback - Callback function.
+ * @returns {(...args: Array<ReturnType<typeof JSON.parse>>) => Promise<void>} - The error logger.
  */
 export default function errorLogger(callback) {
   return async function(...args) {

package/build/error-reporting/request-details.js

@@ -38,7 +38,7 @@ export function requestDetails(request) {
 /**
  * Snapshots parsed request params for error reports.
  * @param {import("../http-server/client/request.js").default | import("../http-server/client/websocket-request.js").default} request - Request object.
- * @returns {? | undefined} - Sanitized body snapshot.
+ * @returns {ReturnType<typeof JSON.parse> | undefined} - Sanitized body snapshot.
  */
 function requestBodySnapshot(request) {
   if (typeof request.params !== "function") return undefined
@@ -55,8 +55,8 @@ function requestBodySnapshot(request) {
 
 /**
  * Builds a bounded, redacted body snapshot for error reports.
- * @param {?} body - Parsed request body.
- * @returns {?} - Sanitized body snapshot.
+ * @param {ReturnType<typeof JSON.parse>} body - Parsed request body.
+ * @returns {ReturnType<typeof JSON.parse>} - Sanitized body snapshot.
  */
 function requestDetailsBodySnapshot(body) {
   const originalLength = serializedLength(body)
@@ -78,10 +78,10 @@ function requestDetailsBodySnapshot(body) {
 
 /**
  * Sanitizes a value recursively for request details.
- * @param {?} value - Value to sanitize.
+ * @param {ReturnType<typeof JSON.parse>} value - Value to sanitize.
  * @param {string} [key] - Current object key.
  * @param {WeakSet<object>} [seen] - Seen object references.
- * @returns {?} - Sanitized value.
+ * @returns {ReturnType<typeof JSON.parse>} - Sanitized value.
  */
 function sanitizeRequestDetailsValue(value, key = "", seen = new WeakSet()) {
   if (sensitiveRequestDetailsKey(key)) return REDACTED_REQUEST_DETAILS_VALUE
@@ -97,7 +97,7 @@ function sanitizeRequestDetailsValue(value, key = "", seen = new WeakSet()) {
 
 /**
  * Checks whether a value can be kept as-is.
- * @param {?} value - Value.
+ * @param {ReturnType<typeof JSON.parse>} value - Value.
  * @returns {boolean} - Whether the value is primitive and safe.
  */
 function primitiveRequestDetailsValue(value) {
@@ -117,9 +117,9 @@ function sanitizeRequestDetailsString(value) {
 
 /**
  * Sanitizes an array value.
- * @param {Array<?>} value - Array value.
+ * @param {Array<ReturnType<typeof JSON.parse>>} value - Array value.
  * @param {WeakSet<object>} seen - Seen object references.
- * @returns {Array<?>} - Sanitized array.
+ * @returns {Array<ReturnType<typeof JSON.parse>>} - Sanitized array.
  */
 function sanitizeRequestDetailsArray(value, seen) {
   const entries = value
@@ -137,14 +137,14 @@ function sanitizeRequestDetailsArray(value, seen) {
  * Sanitizes a plain object-like value.
  * @param {object} value - Object value.
  * @param {WeakSet<object>} seen - Seen object references.
- * @returns {Record<string, ?> | string} - Sanitized object or circular marker.
+ * @returns {Record<string, ReturnType<typeof JSON.parse>> | string} - Sanitized object or circular marker.
  */
 function sanitizeRequestDetailsObject(value, seen) {
   if (seen.has(value)) return "[circular]"
 
   seen.add(value)
 
-  /** @type {Record<string, ?>} */
+  /** @type {Record<string, ReturnType<typeof JSON.parse>>} */
   const sanitized = {}
 
   for (const [entryKey, entryValue] of Object.entries(value)) {
@@ -158,7 +158,7 @@ function sanitizeRequestDetailsObject(value, seen) {
 
 /**
  * Checks whether a value is a Node.js Buffer.
- * @param {?} value - Value.
+ * @param {ReturnType<typeof JSON.parse>} value - Value.
  * @returns {value is Buffer} - Whether value is a Buffer.
  */
 function bufferValue(value) {
@@ -168,7 +168,7 @@ function bufferValue(value) {
 /**
  * Summarizes raw binary data without serializing bytes.
  * @param {Buffer} buffer - Uploaded or request buffer.
- * @returns {Record<string, ?>} - Request-safe buffer summary.
+ * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Request-safe buffer summary.
  */
 function bufferRequestDetailsSummary(buffer) {
   return {
@@ -181,7 +181,7 @@ function bufferRequestDetailsSummary(buffer) {
 /**
  * Summarizes uploaded files without serializing file bytes or temp paths.
  * @param {UploadedFile} uploadedFile - Uploaded file object.
- * @returns {Record<string, ?>} - Request-safe upload summary.
+ * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Request-safe upload summary.
  */
 function uploadedFileRequestDetailsSummary(uploadedFile) {
   return {
@@ -205,19 +205,19 @@ function sensitiveRequestDetailsKey(key) {
 
 /**
  * Compacts a frontend-model request envelope while preserving debugging shape.
- * @param {?} value - Sanitized body value.
+ * @param {ReturnType<typeof JSON.parse>} value - Sanitized body value.
  * @param {number} originalSerializedLength - Byte count before redaction or compaction.
- * @returns {?} - Compacted body value.
+ * @returns {ReturnType<typeof JSON.parse>} - Compacted body value.
  */
 function compactFrontendModelRequestBody(value, originalSerializedLength) {
-  if (!value || typeof value !== "object" || !Array.isArray(/** @type {Record<string, ?>} */ (value).requests)) {
+  if (!value || typeof value !== "object" || !Array.isArray(/** @type {Record<string, ReturnType<typeof JSON.parse>>} */ (value).requests)) {
     return compactRequestDetailsBody(value, originalSerializedLength)
   }
 
   return {
     __truncated: true,
     originalSerializedLength,
-    requests: /** @type {Array<?>} */ (/** @type {Record<string, ?>} */ (value).requests).map((request) => {
+    requests: /** @type {Array<ReturnType<typeof JSON.parse>>} */ (/** @type {Record<string, ReturnType<typeof JSON.parse>>} */ (value).requests).map((request) => {
       return compactFrontendModelRequest(request)
     })
   }
@@ -225,14 +225,14 @@ function compactFrontendModelRequestBody(value, originalSerializedLength) {
 
 /**
  * Compacts one frontend-model request entry.
- * @param {?} value - Candidate request entry from the transport envelope.
- * @returns {?} - Compacted request.
+ * @param {ReturnType<typeof JSON.parse>} value - Candidate request entry from the transport envelope.
+ * @returns {ReturnType<typeof JSON.parse>} - Compacted request.
  */
 function compactFrontendModelRequest(value) {
   if (!value || typeof value !== "object") return value
 
-  const request = /** @type {Record<string, ?>} */ (value)
-  /** @type {Record<string, ?>} */
+  const request = /** @type {Record<string, ReturnType<typeof JSON.parse>>} */ (value)
+  /** @type {Record<string, ReturnType<typeof JSON.parse>>} */
   const compact = {}
 
   for (const key of ["requestId", "model", "commandType", "customPath"]) {
@@ -248,14 +248,14 @@ function compactFrontendModelRequest(value) {
 
 /**
  * Compacts a frontend-model payload.
- * @param {?} value - Candidate payload from a request entry.
- * @returns {?} - Compacted payload.
+ * @param {ReturnType<typeof JSON.parse>} value - Candidate payload from a request entry.
+ * @returns {ReturnType<typeof JSON.parse>} - Compacted payload.
  */
 function compactFrontendModelPayload(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return value
 
-  const payload = /** @type {Record<string, ?>} */ (value)
-  /** @type {Record<string, ?>} */
+  const payload = /** @type {Record<string, ReturnType<typeof JSON.parse>>} */ (value)
+  /** @type {Record<string, ReturnType<typeof JSON.parse>>} */
   const compact = {}
 
   for (const [key, entryValue] of Object.entries(payload)) {
@@ -267,36 +267,36 @@ function compactFrontendModelPayload(value) {
 
 /**
  * Compacts one frontend-model payload entry.
- * @param {{key: string, value: ?}} args - Payload entry.
- * @returns {?} - Compacted value.
+ * @param {{key: string, value: ReturnType<typeof JSON.parse>}} args - Payload entry.
+ * @returns {ReturnType<typeof JSON.parse>} - Compacted value.
  */
 function compactFrontendModelPayloadEntry({key, value}) {
   if (key !== "attributes" || !value || typeof value !== "object" || Array.isArray(value)) {
     return value
   }
 
-  return {__keys: Object.keys(/** @type {Record<string, ?>} */ (value))}
+  return {__keys: Object.keys(/** @type {Record<string, ReturnType<typeof JSON.parse>>} */ (value))}
 }
 
 /**
  * Builds a last-resort compact body summary.
- * @param {?} value - Sanitized body.
+ * @param {ReturnType<typeof JSON.parse>} value - Sanitized body.
  * @param {number} originalSerializedLength - Byte count before redaction or compaction.
- * @returns {Record<string, ?>} - Compact summary.
+ * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Compact summary.
  */
 function compactRequestDetailsBody(value, originalSerializedLength) {
   return {
     __truncated: true,
     originalSerializedLength,
     topLevelKeys: value && typeof value === "object" && !Array.isArray(value)
-      ? Object.keys(/** @type {Record<string, ?>} */ (value))
+      ? Object.keys(/** @type {Record<string, ReturnType<typeof JSON.parse>>} */ (value))
       : []
   }
 }
 
 /**
  * Measures JSON serialized length.
- * @param {?} value - Value to measure.
+ * @param {ReturnType<typeof JSON.parse>} value - Value to measure.
  * @returns {number} - Serialized length, or Infinity when not serializable.
  */
 function serializedLength(value) {