velocious 1.0.449 → 1.0.451

package/src/frontend-models/use-updated-event.js

@@ -9,25 +9,25 @@ import useModelClassEvent from "./use-model-class-event.js"
 
 /**
  * FrontendModelClass type.
-  @typedef {import("./base.js").FrontendModelClass} FrontendModelClass */
+ * @typedef {import("./base.js").FrontendModelClass} FrontendModelClass */
 /**
  * FrontendModelInstance type.
-  @typedef {import("./base.js").default} FrontendModelInstance */
+ * @typedef {import("./base.js").default} FrontendModelInstance */
 /**
  * FrontendModelClassUpdateEventPayload type.
-  @typedef {import("./use-model-class-event.js").FrontendModelCreateUpdateEventPayload} FrontendModelClassUpdateEventPayload */
+ * @typedef {import("./use-model-class-event.js").FrontendModelCreateUpdateEventPayload} FrontendModelClassUpdateEventPayload */
 /**
  * Defines this typedef.
-  @typedef {{id: string, model: FrontendModelInstance}} FrontendModelInstanceUpdateEventPayload */
+ * @typedef {{id: string, model: FrontendModelInstance}} FrontendModelInstanceUpdateEventPayload */
 /**
  * FrontendModelUpdateEventPayload type.
-  @typedef {FrontendModelClassUpdateEventPayload | FrontendModelInstanceUpdateEventPayload} FrontendModelUpdateEventPayload */
+ * @typedef {FrontendModelClassUpdateEventPayload | FrontendModelInstanceUpdateEventPayload} FrontendModelUpdateEventPayload */
 /**
  * UseUpdatedEventOptions type.
-  @typedef {import("./use-model-class-event.js").UseModelClassEventOptions} UseUpdatedEventOptions */
+ * @typedef {import("./use-model-class-event.js").UseModelClassEventOptions} UseUpdatedEventOptions */
 /**
  * FrontendModelUpdateEventCallback type.
-  @typedef {(payload: FrontendModelUpdateEventPayload) => void} FrontendModelUpdateEventCallback */
+ * @typedef {(payload: FrontendModelUpdateEventPayload) => void} FrontendModelUpdateEventCallback */
 
 /**
  * Runs assert no unknown options.
@@ -72,7 +72,7 @@ export default function useUpdatedEvent(modelClassOrModels, callback, options =
   useModelClassEvent(classModel, "update", (payload) => {
     callback(/**
               * Narrows the runtime value to the documented type.
-               @type {FrontendModelClassUpdateEventPayload} */ (payload))
+              * @type {FrontendModelClassUpdateEventPayload} */ (payload))
   }, {active: active && Boolean(classModel), debounce, onConnected, ...projectionOptions})
   useInstanceUpdatedEvent(instanceModels, callback, {active: active && !classModel, debounce, onConnected, ...projectionOptions})
 }
@@ -98,7 +98,7 @@ function useInstanceUpdatedEvent(modelOrModels, callback, options) {
   const eventCallback = useMemo(() => {
     const wrappedCallback = (/**
                               * Narrows the runtime value to the documented type.
-                               @type {FrontendModelInstanceUpdateEventPayload} */ payload) => {
+                              * @type {FrontendModelInstanceUpdateEventPayload} */ payload) => {
       if (activeRef.current) callbackRef.current(payload)
     }
 
@@ -117,11 +117,11 @@ function useInstanceUpdatedEvent(modelOrModels, callback, options) {
     let closed = false
     /**
      * Unsubscribe callbacks.
-      @type {Array<() => void>} */
+     * @type {Array<() => void>} */
     const unsubscribeCallbacks = []
     const subscriptionCallback = (/**
                                    * Narrows the runtime value to the documented type.
-                                    @type {FrontendModelInstanceUpdateEventPayload} */ payload) => {
+                                   * @type {FrontendModelInstanceUpdateEventPayload} */ payload) => {
       if (!closed) eventCallback(payload)
     }
 

package/src/frontend-models/websocket-channel.js

@@ -41,7 +41,7 @@ const EVENT_FILTER_KEYS = new Set(["joins", "key", "searches", "where"])
 export default class FrontendModelWebsocketChannel extends VelociousWebsocketChannel {
   /**
    * Ability.
-    @type {import("../authorization/ability.js").default | null} */
+   * @type {import("../authorization/ability.js").default | null} */
   _ability = null
 
   /**
@@ -68,7 +68,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
       params: {...this.params, model: modelName},
       request: /**
                 * Narrows the runtime value to the documented type.
-                 @type {import("../http-server/client/request.js").default} */ (this._syntheticRequest()),
+                * @type {import("../http-server/client/request.js").default} */ (this._syntheticRequest()),
       response: new Response({configuration})
     })
 
@@ -88,7 +88,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
 
     return readRules.some((/**
                             * Narrows the runtime value to the documented type.
-                             @type {{effect: string}} */ rule) => rule.effect === "allow")
+                            * @type {{effect: string}} */ rule) => rule.effect === "allow")
   }
 
   /**
@@ -139,7 +139,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
     }
 
     if (body.action === "destroy") {
-      if (!hasEventFilters || this._hasUnfilteredEventDelivery()) this.sendMessage(body, meta)
+      if (!hasEventFilters || this._hasDestroyEventDelivery() || this._hasUnfilteredEventDelivery()) this.sendMessage(body, meta)
       return
     }
 
@@ -157,7 +157,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
 
     /**
      * Deliver body.
-      @type {FrontendModelLifecycleBroadcastBody} */
+     * @type {FrontendModelLifecycleBroadcastBody} */
     let deliverBody = body
 
     if (this._hasProjectionParams()) {
@@ -171,7 +171,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
         ...deliverBody,
         record: /**
                  * Narrows the runtime value to the documented type.
-                  @type {import("./query.js").FrontendModelTransportValue} */ (serializeFrontendModelTransportValue(projectedRecord))
+                 * @type {import("./query.js").FrontendModelTransportValue} */ (serializeFrontendModelTransportValue(projectedRecord))
       }
     }
 
@@ -204,6 +204,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
     return {
       abilities: this.params.abilities !== undefined,
       eventFilterCount: eventFilters.length,
+      destroyEventDelivery: this.params.destroyEventDelivery === true,
       model: this._modelName(),
       preload: this.params.preload !== undefined,
       queryData: this.params.queryData !== undefined,
@@ -253,6 +254,14 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
     return this.params.unfilteredEventDelivery === true
   }
 
+  /**
+   * Runs has destroy event delivery.
+   * @returns {boolean} - Whether id-only destroy events should be delivered with event filters.
+   */
+  _hasDestroyEventDelivery() {
+    return this.params.destroyEventDelivery === true
+  }
+
   /**
    * Runs event filters.
    * @returns {import("./query.js").FrontendModelEventFilterPayloadEntry[]} - Valid event filters.
@@ -270,7 +279,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
 
       const eventFilter = /**
                            * Narrows the runtime value to the documented type.
-                            @type {Record<string, ?>} */ (entry)
+                           * @type {Record<string, ?>} */ (entry)
       const unknownKeys = Object.keys(eventFilter).filter((key) => !EVENT_FILTER_KEYS.has(key))
 
       if (unknownKeys.length > 0) {
@@ -283,25 +292,25 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
 
       /**
        * Sanitized event filter.
-        @type {import("./query.js").FrontendModelEventFilterPayloadEntry} */
+       * @type {import("./query.js").FrontendModelEventFilterPayloadEntry} */
       const sanitizedEventFilter = {key: eventFilter.key}
 
       if (eventFilter.joins !== undefined) {
         sanitizedEventFilter.joins = /**
                                       * Narrows the runtime value to the documented type.
-                                       @type {Record<string, import("./query.js").FrontendModelTransportValue>} */ (eventFilter.joins)
+                                      * @type {Record<string, import("./query.js").FrontendModelTransportValue>} */ (eventFilter.joins)
       }
 
       if (eventFilter.searches !== undefined) {
         sanitizedEventFilter.searches = /**
                                          * Narrows the runtime value to the documented type.
-                                          @type {import("./query.js").FrontendModelSearch[]} */ (eventFilter.searches)
+                                         * @type {import("./query.js").FrontendModelSearch[]} */ (eventFilter.searches)
       }
 
       if (eventFilter.where !== undefined) {
         sanitizedEventFilter.where = /**
                                       * Narrows the runtime value to the documented type.
-                                       @type {Record<string, import("./query.js").FrontendModelTransportValue>} */ (eventFilter.where)
+                                      * @type {Record<string, import("./query.js").FrontendModelTransportValue>} */ (eventFilter.where)
       }
 
       return sanitizedEventFilter
@@ -346,7 +355,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
       },
       request: /**
                 * Narrows the runtime value to the documented type.
-                 @type {import("../http-server/client/request.js").default} */ (this._syntheticRequest()),
+                * @type {import("../http-server/client/request.js").default} */ (this._syntheticRequest()),
       response: new Response({configuration}),
       viewPath: "/"
     })
@@ -384,7 +393,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
   async _matchedEventFilterKeysForEventId(id, FrontendModelController) {
     /**
      * Matched event filter keys.
-      @type {string[]} */
+     * @type {string[]} */
     const matchedEventFilterKeys = []
 
     for (const eventFilter of this._eventFilters()) {
@@ -458,14 +467,14 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
     for (const entry of controller.frontendModelWithCount()) {
       /**
        * Spec.
-        @type {Record<string, boolean | {relationship?: string, where?: Record<string, import("./query.js").FrontendModelTransportValue>}>} */
+       * @type {Record<string, boolean | {relationship?: string, where?: Record<string, import("./query.js").FrontendModelTransportValue>}>} */
       const spec = {}
 
       spec[entry.attributeName] = {
         relationship: entry.relationshipName,
         where: entry.where ? /**
                               * Narrows the runtime value to the documented type.
-                               @type {Record<string, import("./query.js").FrontendModelTransportValue>} */ (entry.where) : undefined
+                              * @type {Record<string, import("./query.js").FrontendModelTransportValue>} */ (entry.where) : undefined
       }
       query.withCount(spec)
     }
@@ -504,13 +513,13 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
   _syntheticRequest() {
     const upgradeRequest = /**
                             * Narrows the runtime value to the documented type.
-                             @type {FrontendModelWebsocketUpgradeRequest} */ (this.session.upgradeRequest)
+                            * @type {FrontendModelWebsocketUpgradeRequest} */ (this.session.upgradeRequest)
     const rawHeaders = typeof upgradeRequest?.headers === "function" ? upgradeRequest.headers() : {}
     const metadata = typeof this.session.getMetadata === "function" ? this.session.getMetadata() : {}
     const remoteAddress = typeof upgradeRequest?.remoteAddress === "function" ? upgradeRequest.remoteAddress() : undefined
     /**
      * Header map.
-      @type {Record<string, string | string[] | undefined>} */
+     * @type {Record<string, string | string[] | undefined>} */
     const headerMap = {}
 
     for (const key of Object.keys(rawHeaders || {})) {

package/src/frontend-models/websocket-publishers.js

@@ -44,9 +44,9 @@ async function resolveAbilityResourcesList(configuration) {
   if (typeof resolver === "function") {
     const ability = await resolver({configuration, params: {}, request: /**
                                                                          * Narrows the runtime value to the documented type.
-                                                                          @type {?} */ (undefined), response: /**
+                                                                         * @type {?} */ (undefined), response: /**
                                                                                                                * Narrows the runtime value to the documented type.
-                                                                                                                @type {?} */ (undefined)})
+                                                                                                               * @type {?} */ (undefined)})
 
     if (ability?.resources && Array.isArray(ability.resources)) {
       return ability.resources
@@ -64,7 +64,7 @@ async function resolveAbilityResourcesList(configuration) {
 function frontendModelResourcesFromAbilityResourcesList(abilityResources) {
   /**
    * Resources.
-    @type {Record<string, import("../configuration-types.js").FrontendModelResourceClassType>} */
+   * @type {Record<string, import("../configuration-types.js").FrontendModelResourceClassType>} */
   const resources = {}
 
   if (!abilityResources || abilityResources.length === 0) return resources
@@ -81,7 +81,7 @@ function frontendModelResourcesFromAbilityResourcesList(abilityResources) {
     if (resourceClass.prototype instanceof FrontendModelBaseResource) {
       const modelClass = /**
                           * Narrows the runtime value to the documented type.
-                           @type {import("../configuration-types.js").FrontendModelResourceClassType} */ (resourceClass).ModelClass
+                          * @type {import("../configuration-types.js").FrontendModelResourceClassType} */ (resourceClass).ModelClass
 
       if (!modelClass) {
         throw new Error(`Resource class ${resourceClass.name} is missing a static ModelClass property`)
@@ -95,7 +95,7 @@ function frontendModelResourcesFromAbilityResourcesList(abilityResources) {
 
       resources[modelName] = /**
                               * Narrows the runtime value to the documented type.
-                               @type {import("../configuration-types.js").FrontendModelResourceClassType} */ (resourceClass)
+                              * @type {import("../configuration-types.js").FrontendModelResourceClassType} */ (resourceClass)
     } else if (resourceClass.prototype instanceof AuthorizationBaseResource) {
       // Authorization-only resource — valid but not relevant for WebSocket publishing
     } else {
@@ -116,7 +116,7 @@ export async function ensureFrontendModelWebsocketPublishersRegistered(configura
 
   /**
    * All frontend models.
-    @type {Record<string, import("../configuration-types.js").FrontendModelResourceClassType>} */
+   * @type {Record<string, import("../configuration-types.js").FrontendModelResourceClassType>} */
   let allFrontendModels = {}
 
   for (const backendProject of configuration.getBackendProjects()) {
@@ -161,19 +161,19 @@ export async function ensureFrontendModelWebsocketPublishersRegistered(configura
     modelClass.beforeCreate((model) => {
       /**
        * Narrows the runtime value to the documented type.
-        @type {import("../database/record/index.js").default & {__frontendModelWebsocketAction?: "create" | "update"}} */ (model).__frontendModelWebsocketAction = "create"
+       * @type {import("../database/record/index.js").default & {__frontendModelWebsocketAction?: "create" | "update"}} */ (model).__frontendModelWebsocketAction = "create"
     })
 
     modelClass.beforeUpdate((model) => {
       /**
        * Narrows the runtime value to the documented type.
-        @type {import("../database/record/index.js").default & {__frontendModelWebsocketAction?: "create" | "update"}} */ (model).__frontendModelWebsocketAction = "update"
+       * @type {import("../database/record/index.js").default & {__frontendModelWebsocketAction?: "create" | "update"}} */ (model).__frontendModelWebsocketAction = "update"
     })
 
     modelClass.afterSave((model) => {
       const modelWithWebsocketAction = /**
                                         * Narrows the runtime value to the documented type.
-                                         @type {import("../database/record/index.js").default & {__frontendModelWebsocketAction?: "create" | "update"}} */ (model)
+                                        * @type {import("../database/record/index.js").default & {__frontendModelWebsocketAction?: "create" | "update"}} */ (model)
       const action = modelWithWebsocketAction.__frontendModelWebsocketAction
 
       if (action !== "create" && action !== "update") return

package/src/http-client/response.js

@@ -15,7 +15,7 @@ export default class Response {
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {Header[]} */
+     * @type {Header[]} */
     this.headers = []
 
     this.method = method.toUpperCase().trim()
@@ -24,7 +24,7 @@ export default class Response {
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {Buffer} */
+     * @type {Buffer} */
     this.response = Buffer.alloc(0);
   }
 

package/src/http-server/client/index.js

@@ -56,7 +56,7 @@ export default class VeoliciousHttpServerClient {
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {RequestRunner[]} */
+     * @type {RequestRunner[]} */
     this.requestRunners = []
   }
 
@@ -110,12 +110,12 @@ export default class VeoliciousHttpServerClient {
   handleBadRequest(error) {
     this.logger.warn(() => ["Failed to parse HTTP request", badRequestDetails(/**
                                                                                * Narrows the runtime value to the documented type.
-                                                                                @type {Error & {velociousContext?: Record<string, ?>}} */ (error))])
+                                                                               * @type {Error & {velociousContext?: Record<string, ?>}} */ (error))])
 
     if (this.currentRequest && "getRequestParser" in this.currentRequest) {
       const httpRequest = /**
                            * Narrows the runtime value to the documented type.
-                            @type {import("./request.js").default} */ (this.currentRequest)
+                           * @type {import("./request.js").default} */ (this.currentRequest)
 
       httpRequest.getRequestParser().destroy()
     }
@@ -179,7 +179,7 @@ export default class VeoliciousHttpServerClient {
     try {
       /**
        * Remaining.
-        @type {Buffer | undefined} */
+       * @type {Buffer | undefined} */
       let remaining = data
 
       while (remaining) {
@@ -281,16 +281,16 @@ export default class VeoliciousHttpServerClient {
 
       const resolvedThenable = /**
                                 * Narrows the runtime value to the documented type.
-                                 @type {{then?: (...args: Array<?>) => ?}} */ (resolvedHandler)
+                                * @type {{then?: (...args: Array<?>) => ?}} */ (resolvedHandler)
 
       if (resolvedThenable?.then) {
         messageHandlerPromise = /**
                                  * Narrows the runtime value to the documented type.
-                                  @type {Promise<import("../../configuration-types.js").WebsocketMessageHandler | void>} */ (resolvedHandler)
+                                 * @type {Promise<import("../../configuration-types.js").WebsocketMessageHandler | void>} */ (resolvedHandler)
       } else if (resolvedHandler) {
         messageHandler = /**
                           * Narrows the runtime value to the documented type.
-                           @type {import("../../configuration-types.js").WebsocketMessageHandler} */ (resolvedHandler)
+                          * @type {import("../../configuration-types.js").WebsocketMessageHandler} */ (resolvedHandler)
       }
     }
 
@@ -445,7 +445,7 @@ export default class VeoliciousHttpServerClient {
     if ("getRequestParser" in request) {
       const httpRequest = /**
                            * Narrows the runtime value to the documented type.
-                            @type {import("./request.js").default} */ (request)
+                           * @type {import("./request.js").default} */ (request)
       httpRequest.getRequestParser().destroy()
     }
   }

package/src/http-server/client/params-to-object.js

@@ -12,7 +12,7 @@ function malformedNestedParamsKeyError(args) {
   const error = new Error(`Could not parse nested params key "${key}" at rest "${rest}"`)
   /**
    * Typed error.
-    @type {Error & {velociousContext?: Record<string, ?>}} */
+   * @type {Error & {velociousContext?: Record<string, ?>}} */
   const typedError = error
 
   typedError.velociousContext = {
@@ -42,7 +42,7 @@ export default class ParamsToObject {
   toObject() {
     /**
      * Result.
-      @type {Record<string, ?>} */
+     * @type {Record<string, ?>} */
     const result = {}
 
     for(const key in this.object) {
@@ -70,16 +70,16 @@ export default class ParamsToObject {
 
       /**
        * Defines newResult.
-        @type {Array<?> | Record<string, ?>} */
+       * @type {Array<?> | Record<string, ?>} */
       let newResult
       const objectResult = /**
                             * Narrows the runtime value to the documented type.
-                             @type {Record<string, ?>} */ (result)
+                            * @type {Record<string, ?>} */ (result)
 
       if (inputName in objectResult) {
         newResult = /**
                      * Narrows the runtime value to the documented type.
-                      @type {Array<?> | Record<string, ?>} */ (objectResult[inputName])
+                     * @type {Array<?> | Record<string, ?>} */ (objectResult[inputName])
       } else if (rest == "[]") {
         newResult = []
         objectResult[inputName] = newResult
@@ -92,7 +92,7 @@ export default class ParamsToObject {
     } else {
       const objectResult = /**
                             * Narrows the runtime value to the documented type.
-                             @type {Record<string, ?>} */ (result)
+                            * @type {Record<string, ?>} */ (result)
 
       objectResult[key] = value
     }
@@ -116,7 +116,7 @@ export default class ParamsToObject {
 
     /**
      * Defines newResult.
-      @type {Array<?> | Record<string, ?>} */
+     * @type {Array<?> | Record<string, ?>} */
     let newResult
 
     if (rest == "[]") {
@@ -128,16 +128,16 @@ export default class ParamsToObject {
     } else if (newRest == "") {
       /**
        * Narrows the runtime value to the documented type.
-        @type {Record<string, ?>} */ (result)[key] = value
+       * @type {Record<string, ?>} */ (result)[key] = value
     } else {
       const objectResult = /**
                             * Narrows the runtime value to the documented type.
-                             @type {Record<string, ?>} */ (result)
+                            * @type {Record<string, ?>} */ (result)
 
       if (!Array.isArray(result) && key in objectResult) {
         newResult = /**
                      * Narrows the runtime value to the documented type.
-                      @type {Array<?> | Record<string, ?>} */ (objectResult[key])
+                     * @type {Array<?> | Record<string, ?>} */ (objectResult[key])
       } else if (newRest == "[]") {
         newResult = []
         objectResult[key] = newResult

package/src/http-server/client/request-buffer/form-data-part.js

@@ -14,12 +14,12 @@ export default class FormDataPart {
 
   /**
    * Headers.
-    @type {Record<string, import("./header.js").default>} */
+   * @type {Record<string, import("./header.js").default>} */
   headers = {}
 
   /**
    * Body.
-    @type {number[]} */
+   * @type {number[]} */
   body = []
 
   /**

package/src/http-server/client/request-buffer/index.js

@@ -26,18 +26,18 @@ export default class RequestBuffer {
 
   /**
    * Data.
-    @type {number[]} */
+   * @type {number[]} */
   data = []
 
   events = new EventEmitter()
 
   /**
    * Headers by name.
-    @type {Record<string, Header>} */
+   * @type {Record<string, Header>} */
   headersByName = {}
   /**
    * Chunked body chars.
-    @type {number[] | undefined} */
+   * @type {number[] | undefined} */
   chunkedBodyChars = undefined
 
   multiPartyFormData = false
@@ -98,7 +98,7 @@ export default class RequestBuffer {
           chunkedBodyChars.push(char)
           /**
            * Current chunk bytes read.
-            @type {number} */
+           * @type {number} */
           const currentChunkBytesRead = (this.currentChunkBytesRead || 0) + 1
 
           this.currentChunkBytesRead = currentChunkBytesRead
@@ -196,7 +196,7 @@ export default class RequestBuffer {
   getHeadersHash() {
     /**
      * Result.
-      @type {Record<string, string>} */
+     * @type {Record<string, string>} */
     const result = {}
 
     for (const headerFormattedName in this.headersByName) {
@@ -347,7 +347,7 @@ export default class RequestBuffer {
         } else {
           /**
            * Narrows the runtime value to the documented type.
-            @type {number[]} */
+           * @type {number[]} */
           this.postBodyChars = []
 
           // this.postBodyBuffer = new ArrayBuffer(this.contentLength)
@@ -498,7 +498,7 @@ export default class RequestBuffer {
         const parsedQuery = querystring.parse(this.postBody)
         /**
          * Unparsed params.
-          @type {Record<string, string | string[]>} */
+         * @type {Record<string, string | string[]>} */
         const unparsedParams = {}
 
         for (const [key, value] of Object.entries(parsedQuery)) {
@@ -514,7 +514,7 @@ export default class RequestBuffer {
       } catch (error) {
         const ensuredError = /**
                               * Narrows the runtime value to the documented type.
-                               @type {Error & {velociousContext?: Record<string, ?>}} */ (error)
+                              * @type {Error & {velociousContext?: Record<string, ?>}} */ (error)
 
         ensuredError.velociousContext = {
           ...(ensuredError.velociousContext || {}),

package/src/http-server/client/request-parser.js

@@ -21,7 +21,7 @@ export default class VelociousHttpServerClientRequestParser {
     this.hasCompleted = false
     /**
      * Narrows the runtime value to the documented type.
-      @type {Record<string, string | string[] | undefined | Record<string, ?> | Array<?>>} */
+     * @type {Record<string, string | string[] | undefined | Record<string, ?> | Array<?>>} */
     this.params = {}
 
     this.requestBuffer = new RequestBuffer({configuration})
@@ -49,7 +49,7 @@ export default class VelociousHttpServerClientRequestParser {
   onFormDataPart = (formDataPart) => {
     /**
      * Unordered params.
-      @type {Record<string, string | string[] | import("./uploaded-file/uploaded-file.js").default>} */
+     * @type {Record<string, string | string[] | import("./uploaded-file/uploaded-file.js").default>} */
     const unorderedParams = {}
 
     unorderedParams[formDataPart.getName()] = formDataPart.getValue()
@@ -62,7 +62,7 @@ export default class VelociousHttpServerClientRequestParser {
     } catch (error) {
       const ensuredError = /**
                             * Narrows the runtime value to the documented type.
-                             @type {Error & {velociousContext?: Record<string, ?>}} */ (error)
+                            * @type {Error & {velociousContext?: Record<string, ?>}} */ (error)
 
       ensuredError.velociousContext = {
         ...(ensuredError.velociousContext || {}),

package/src/http-server/client/request-runner.js

@@ -32,10 +32,10 @@ function requestErrorSummary(error, cleanedStackWithHeader) {
 
   const errorCode = typeof /**
                             * Narrows the runtime value to the documented type.
-                             @type {?} */ (error).code === "string"
+                            * @type {?} */ (error).code === "string"
     ? /**
        * Narrows the runtime value to the documented type.
-        @type {?} */ (error).code
+       * @type {?} */ (error).code
     : undefined
   const errorMessage = error.message || String(error)
 
@@ -182,17 +182,17 @@ export default class VelociousHttpServerClientRequestRunner {
         const startTimeMs = Date.now()
         /**
          * Defines timeoutId.
-          @type {ReturnType<typeof setTimeout> | undefined} */
+         * @type {ReturnType<typeof setTimeout> | undefined} */
         let timeoutId
         /**
          * Defines timeoutReject.
-          @type {((error: Error) => void) | undefined} */
+         * @type {((error: Error) => void) | undefined} */
         let timeoutReject
         let timedOut = false
 
         const setRequestTimeoutSeconds = (/**
                                            * Narrows the runtime value to the documented type.
-                                            @type {number | undefined} */ timeoutSeconds) => {
+                                           * @type {number | undefined} */ timeoutSeconds) => {
           if (timeoutId) {
             clearTimeout(timeoutId)
             timeoutId = undefined
@@ -257,7 +257,7 @@ export default class VelociousHttpServerClientRequestRunner {
       const error = ensureError(e)
       const errorWithContext = /**
                                 * Narrows the runtime value to the documented type.
-                                 @type {{velociousContext?: object}} */ (error)
+                                * @type {{velociousContext?: object}} */ (error)
       const errorContext = errorWithContext.velociousContext || {stage: "request-runner"}
       const logDetails = requestErrorLogDetails(error)
 

package/src/http-server/client/request-timing.js

@@ -17,7 +17,7 @@
 export default class RequestTiming {
   /**
    * Buckets.
-    @type {Record<RequestTimingBucket, number>} */
+   * @type {Record<RequestTimingBucket, number>} */
   buckets = {
     controller: 0,
     db: 0,
@@ -26,21 +26,21 @@ export default class RequestTiming {
 
   /**
    * Bucket stack.
-    @type {ActiveTimingBucket[]} */
+   * @type {ActiveTimingBucket[]} */
   bucketStack = []
 
   dbQueryCount = 0
   /**
    * Completed log method.
-    @type {"debug" | "info" | undefined} */
+   * @type {"debug" | "info" | undefined} */
   completedLogMethod = undefined
   /**
    * Completed log subject.
-    @type {string | undefined} */
+   * @type {string | undefined} */
   completedLogSubject = undefined
   /**
    * Response served at ms.
-    @type {number | undefined} */
+   * @type {number | undefined} */
   responseServedAtMs = undefined
   startedAtMs = Date.now()
 

package/src/http-server/client/request.js

@@ -88,7 +88,7 @@ export default class VelociousHttpServerClientRequest {
     const parsed = querystring.parse(query)
     /**
      * Params.
-      @type {Record<string, string | string[]>} */
+     * @type {Record<string, string | string[]>} */
     const params = Object.create(null)
 
     for (const [key, value] of Object.entries(parsed)) {