velocious 1.0.461 → 1.0.462

package/build/frontend-models/transport-serialization.js

@@ -137,9 +137,7 @@ function isFrontendModelMarker(value) {
 export function isBackendModelInstance(value) {
   if (!value || typeof value !== "object") return false
 
-  const candidate = /**
-                     * Narrows the runtime value to the documented type.
-                     * @type {Record<string, ?>} */ (value)
+  const candidate = /** @type {Record<string, ?>} */ (value)
 
   return (
     typeof candidate.attributes === "function"
@@ -197,9 +195,7 @@ function serializeFrontendModelTransportValueInternal(value, seenModels) {
      * @type {Record<string, ?>} */
     const serializedModel = {
       [TYPE_KEY]: TYPE_FRONTEND_MODEL,
-      attributes: /**
-                   * Narrows the runtime value to the documented type.
-                   * @type {Record<string, ?>} */ (serializeFrontendModelTransportValueInternal(modelAttributes, seenModels)),
+      attributes: /** @type {Record<string, ?>} */ (serializeFrontendModelTransportValueInternal(modelAttributes, seenModels)),
       modelName
     }
 
@@ -259,13 +255,9 @@ function serializeFrontendModelTransportValueInternal(value, seenModels) {
  * @returns {?} - Hydrated frontend model or plain object fallback.
  */
 function deserializeFrontendModelMarker(marker) {
-  const attributes = /**
-                      * Narrows the runtime value to the documented type.
-                      * @type {Record<string, ?>} */ (deserializeFrontendModelTransportValue(marker.attributes))
+  const attributes = /** @type {Record<string, ?>} */ (deserializeFrontendModelTransportValue(marker.attributes))
   const preloadedRelationships = isPlainObject(marker.preloadedRelationships)
-    ? /**
-       * Narrows the runtime value to the documented type.
-       * @type {Record<string, ?>} */ (deserializeFrontendModelTransportValue(marker.preloadedRelationships))
+    ? /** @type {Record<string, ?>} */ (deserializeFrontendModelTransportValue(marker.preloadedRelationships))
     : {}
   const modelClass = resolveFrontendModelClass(marker.modelName)
 
@@ -317,25 +309,19 @@ export function deserializeFrontendModelTransportValue(value) {
   }
 
   if (isDateMarker(value)) {
-    const dateValue = /**
-                       * Narrows the runtime value to the documented type.
-                       * @type {{value: string}} */ (value).value
+    const dateValue = /** @type {{value: string}} */ (value).value
 
     return new Date(dateValue)
   }
 
   if (isBigIntMarker(value)) {
-    const bigintValue = /**
-                         * Narrows the runtime value to the documented type.
-                         * @type {{value: string}} */ (value).value
+    const bigintValue = /** @type {{value: string}} */ (value).value
 
     return BigInt(bigintValue)
   }
 
   if (isNonFiniteNumberMarker(value)) {
-    const numberValue = /**
-                         * Narrows the runtime value to the documented type.
-                         * @type {{value: string}} */ (value).value
+    const numberValue = /** @type {{value: string}} */ (value).value
 
     if (numberValue === NUMBER_NAN) return Number.NaN
     if (numberValue === NUMBER_POSITIVE_INFINITY) return Number.POSITIVE_INFINITY

package/build/frontend-models/use-destroyed-event.js

@@ -92,9 +92,7 @@ function useInstanceDestroyedEvent(modelOrModels, callback, options) {
 
   const modelsKey = modelsDependencyKey(modelOrModels)
   const eventCallback = useMemo(() => {
-    const wrappedCallback = (/**
-                              * Narrows the runtime value to the documented type.
-                              * @type {FrontendModelInstanceDestroyEventPayload} */ payload) => {
+    const wrappedCallback = (/** @type {FrontendModelInstanceDestroyEventPayload} */ payload) => {
       if (activeRef.current) callbackRef.current(payload)
     }
 
@@ -115,9 +113,7 @@ function useInstanceDestroyedEvent(modelOrModels, callback, options) {
      * Unsubscribe callbacks.
      * @type {Array<() => void>} */
     const unsubscribeCallbacks = []
-    const subscriptionCallback = (/**
-                                   * Narrows the runtime value to the documented type.
-                                   * @type {FrontendModelInstanceDestroyEventPayload} */ payload) => {
+    const subscriptionCallback = (/** @type {FrontendModelInstanceDestroyEventPayload} */ payload) => {
       if (!closed) eventCallback(payload)
     }
 

package/build/frontend-models/use-model-class-event.js

@@ -111,9 +111,7 @@ export default function useModelClassEvent(modelClass, eventOrEvents, callback,
   const eventNames = normalizeEventNames(eventOrEvents)
   const eventsKey = eventNamesDependencyKey(eventNames)
   const eventCallback = useMemo(() => {
-    const wrappedCallback = (/**
-                              * Narrows the runtime value to the documented type.
-                              * @type {FrontendModelClassEventPayload} */ payload) => {
+    const wrappedCallback = (/** @type {FrontendModelClassEventPayload} */ payload) => {
       if (activeRef.current) callbackRef.current(payload)
     }
 
@@ -131,9 +129,7 @@ export default function useModelClassEvent(modelClass, eventOrEvents, callback,
      * Unsubscribe callbacks.
      * @type {Array<() => void>} */
     const unsubscribeCallbacks = []
-    const subscriptionCallback = (/**
-                                   * Narrows the runtime value to the documented type.
-                                   * @type {FrontendModelClassEventPayload} */ payload) => {
+    const subscriptionCallback = (/** @type {FrontendModelClassEventPayload} */ payload) => {
       if (!closed) eventCallback(payload)
     }
 

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

@@ -70,9 +70,7 @@ export default function useUpdatedEvent(modelClassOrModels, callback, options =
   const projectionOptions = {abilities, preload, query, queryData, select, selectsExtra, withCount}
 
   useModelClassEvent(classModel, "update", (payload) => {
-    callback(/**
-              * Narrows the runtime value to the documented type.
-              * @type {FrontendModelClassUpdateEventPayload} */ (payload))
+    callback(/** @type {FrontendModelClassUpdateEventPayload} */ (payload))
   }, {active: active && Boolean(classModel), debounce, onConnected, ...projectionOptions})
   useInstanceUpdatedEvent(instanceModels, callback, {active: active && !classModel, debounce, onConnected, ...projectionOptions})
 }
@@ -96,9 +94,7 @@ function useInstanceUpdatedEvent(modelOrModels, callback, options) {
 
   const modelsKey = modelsDependencyKey(modelOrModels)
   const eventCallback = useMemo(() => {
-    const wrappedCallback = (/**
-                              * Narrows the runtime value to the documented type.
-                              * @type {FrontendModelInstanceUpdateEventPayload} */ payload) => {
+    const wrappedCallback = (/** @type {FrontendModelInstanceUpdateEventPayload} */ payload) => {
       if (activeRef.current) callbackRef.current(payload)
     }
 
@@ -119,9 +115,7 @@ function useInstanceUpdatedEvent(modelOrModels, callback, options) {
      * Unsubscribe callbacks.
      * @type {Array<() => void>} */
     const unsubscribeCallbacks = []
-    const subscriptionCallback = (/**
-                                   * Narrows the runtime value to the documented type.
-                                   * @type {FrontendModelInstanceUpdateEventPayload} */ payload) => {
+    const subscriptionCallback = (/** @type {FrontendModelInstanceUpdateEventPayload} */ payload) => {
       if (!closed) eventCallback(payload)
     }
 

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

@@ -85,9 +85,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
 
     const readRules = ability.rulesFor({action: "read", modelClass: ModelClass})
 
-    return readRules.some((/**
-                            * Narrows the runtime value to the documented type.
-                            * @type {{effect: string}} */ rule) => rule.effect === "allow")
+    return readRules.some((/** @type {{effect: string}} */ rule) => rule.effect === "allow")
   }
 
   /**
@@ -168,9 +166,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
 
       deliverBody = {
         ...deliverBody,
-        record: /**
-                 * Narrows the runtime value to the documented type.
-                 * @type {import("./query.js").FrontendModelTransportValue} */ (serializeFrontendModelTransportValue(projectedRecord))
+        record: /** @type {import("./query.js").FrontendModelTransportValue} */ (serializeFrontendModelTransportValue(projectedRecord))
       }
     }
 
@@ -276,9 +272,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
         throw new Error("Frontend model eventFilters entries must be objects")
       }
 
-      const eventFilter = /**
-                           * Narrows the runtime value to the documented type.
-                           * @type {Record<string, ?>} */ (entry)
+      const eventFilter = /** @type {Record<string, ?>} */ (entry)
       const unknownKeys = Object.keys(eventFilter).filter((key) => !EVENT_FILTER_KEYS.has(key))
 
       if (unknownKeys.length > 0) {
@@ -295,21 +289,15 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
       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)
+        sanitizedEventFilter.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)
+        sanitizedEventFilter.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)
+        sanitizedEventFilter.where = /** @type {Record<string, import("./query.js").FrontendModelTransportValue>} */ (eventFilter.where)
       }
 
       return sanitizedEventFilter
@@ -352,9 +340,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
         ...params,
         withCount: this.params.withCount
       },
-      request: /**
-                * Narrows the runtime value to the documented type.
-                * @type {import("../http-server/client/request.js").default} */ (this._syntheticRequest()),
+      request: /** @type {import("../http-server/client/request.js").default} */ (this._syntheticRequest()),
       response: new Response({configuration}),
       viewPath: "/"
     })
@@ -518,9 +504,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
 
         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
+          where: entry.where ? /** @type {Record<string, import("./query.js").FrontendModelTransportValue>} */ (entry.where) : undefined
         }
         query.withCount(spec)
       }
@@ -558,9 +542,7 @@ export default class FrontendModelWebsocketChannel extends VelociousWebsocketCha
    * @returns {FrontendModelWebsocketSyntheticRequest} Request-like object for ability resolution.
    */
   _syntheticRequest() {
-    const upgradeRequest = /**
-                            * Narrows the runtime value to the documented type.
-                            * @type {FrontendModelWebsocketUpgradeRequest} */ (this.session.upgradeRequest)
+    const 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

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

@@ -2,7 +2,7 @@
 
 import AuthorizationBaseResource from "../authorization/base-resource.js"
 import {frontendModelResourcesWithBuiltInsForBackendProject} from "./built-in-resources.js"
-import {frontendModelResourceDefinitionIsClass, frontendModelResourcesForBackendProject} from "./resource-definition.js"
+import {frontendModelResourceDefinitionIsClass} from "./resource-definition.js"
 import {serializeFrontendModelTransportValue} from "./transport-serialization.js"
 
 const modelClassesWithRegisteredHooks = new WeakSet()
@@ -72,27 +72,22 @@ export async function ensureFrontendModelWebsocketPublishersRegistered(configura
    * All frontend models.
    * @type {Record<string, import("../configuration-types.js").FrontendModelResourceClassType>} */
   let allFrontendModels = {}
-  /**
-   * Configured frontend models.
-   * @type {Record<string, import("../configuration-types.js").FrontendModelResourceClassType>} */
-  let configuredFrontendModels = {}
 
   for (const backendProject of configuration.getBackendProjects()) {
-    const configuredProjectResources = frontendModelResourcesForBackendProject(backendProject)
     const projectResources = frontendModelResourcesWithBuiltInsForBackendProject(backendProject)
 
-    configuredFrontendModels = {...configuredFrontendModels, ...configuredProjectResources}
     allFrontendModels = {...allFrontendModels, ...projectResources}
   }
 
-  // Auto-discover from ability resources when backend projects didn't provide any
-  if (Object.keys(configuredFrontendModels).length === 0) {
-    const abilityResources = configuration.getAbilityResources()
+  // Always merge the ability resolver's resource list too. A project can expose some
+  // resources as discoverable `src/resources/*.js` files (configured or auto-discovered)
+  // and others only through `getAbilityResources()`; both sets need lifecycle publishers,
+  // so resource discovery must not suppress this list.
+  const abilityResources = configuration.getAbilityResources()
 
-    allFrontendModels = {
-      ...allFrontendModels,
-      ...frontendModelResourcesFromAbilityResourcesList(abilityResources)
-    }
+  allFrontendModels = {
+    ...allFrontendModels,
+    ...frontendModelResourcesFromAbilityResourcesList(abilityResources)
   }
 
   // Phase 3: register the V2 channel class once per configuration so
@@ -126,21 +121,15 @@ export async function ensureFrontendModelWebsocketPublishersRegistered(configura
     modelClassesWithRegisteredHooks.add(modelClass)
 
     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)
+      const modelWithWebsocketAction = /** @type {import("../database/record/index.js").default & {__frontendModelWebsocketAction?: "create" | "update"}} */ (model)
       const action = modelWithWebsocketAction.__frontendModelWebsocketAction
 
       if (action !== "create" && action !== "update") return

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

@@ -108,14 +108,10 @@ export default class VeoliciousHttpServerClient {
    * @returns {void} - No return value.
    */
   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))])
+    this.logger.warn(() => ["Failed to parse HTTP request", badRequestDetails(/** @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)
+      const httpRequest = /** @type {import("./request.js").default} */ (this.currentRequest)
 
       httpRequest.getRequestParser().destroy()
     }
@@ -279,18 +275,12 @@ export default class VeoliciousHttpServerClient {
         request: this.currentRequest
       })
 
-      const resolvedThenable = /**
-                                * Narrows the runtime value to the documented type.
-                                * @type {{then?: (...args: Array<?>) => ?}} */ (resolvedHandler)
+      const resolvedThenable = /** @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)
+        messageHandlerPromise = /** @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)
+        messageHandler = /** @type {import("../../configuration-types.js").WebsocketMessageHandler} */ (resolvedHandler)
       }
     }
 
@@ -443,9 +433,7 @@ export default class VeoliciousHttpServerClient {
     await requestRunner.logCompletedRequest()
 
     if ("getRequestParser" in request) {
-      const httpRequest = /**
-                           * Narrows the runtime value to the documented type.
-                           * @type {import("./request.js").default} */ (request)
+      const httpRequest = /** @type {import("./request.js").default} */ (request)
       httpRequest.getRequestParser().destroy()
     }
   }

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

@@ -72,14 +72,10 @@ export default class ParamsToObject {
        * Defines newResult.
        * @type {Array<?> | Record<string, ?>} */
       let newResult
-      const objectResult = /**
-                            * Narrows the runtime value to the documented type.
-                            * @type {Record<string, ?>} */ (result)
+      const objectResult = /** @type {Record<string, ?>} */ (result)
 
       if (inputName in objectResult) {
-        newResult = /**
-                     * Narrows the runtime value to the documented type.
-                     * @type {Array<?> | Record<string, ?>} */ (objectResult[inputName])
+        newResult = /** @type {Array<?> | Record<string, ?>} */ (objectResult[inputName])
       } else if (rest == "[]") {
         newResult = []
         objectResult[inputName] = newResult
@@ -90,9 +86,7 @@ export default class ParamsToObject {
 
       this.treatSecond(value, rest, newResult, key)
     } else {
-      const objectResult = /**
-                            * Narrows the runtime value to the documented type.
-                            * @type {Record<string, ?>} */ (result)
+      const objectResult = /** @type {Record<string, ?>} */ (result)
 
       objectResult[key] = value
     }
@@ -126,18 +120,12 @@ export default class ParamsToObject {
 
       result.push(value)
     } 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)
+      const objectResult = /** @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])
+        newResult = /** @type {Array<?> | Record<string, ?>} */ (objectResult[key])
       } else if (newRest == "[]") {
         newResult = []
         objectResult[key] = newResult

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

@@ -512,9 +512,7 @@ export default class RequestBuffer {
 
         incorporate(this.params, newParams)
       } catch (error) {
-        const ensuredError = /**
-                              * Narrows the runtime value to the documented type.
-                              * @type {Error & {velociousContext?: Record<string, ?>}} */ (error)
+        const ensuredError = /** @type {Error & {velociousContext?: Record<string, ?>}} */ (error)
 
         ensuredError.velociousContext = {
           ...(ensuredError.velociousContext || {}),

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

@@ -60,9 +60,7 @@ export default class VelociousHttpServerClientRequestParser {
 
       incorporate(this.params, newParams)
     } catch (error) {
-      const ensuredError = /**
-                            * Narrows the runtime value to the documented type.
-                            * @type {Error & {velociousContext?: Record<string, ?>}} */ (error)
+      const ensuredError = /** @type {Error & {velociousContext?: Record<string, ?>}} */ (error)
 
       ensuredError.velociousContext = {
         ...(ensuredError.velociousContext || {}),

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

@@ -30,12 +30,8 @@ function requestErrorSummary(error, cleanedStackWithHeader) {
 
   if (stackHeader && !stackFrameLine(stackHeader)) return stackHeader
 
-  const errorCode = typeof /**
-                            * Narrows the runtime value to the documented type.
-                            * @type {?} */ (error).code === "string"
-    ? /**
-       * Narrows the runtime value to the documented type.
-       * @type {?} */ (error).code
+  const errorCode = typeof /** @type {?} */ (error).code === "string"
+    ? /** @type {?} */ (error).code
     : undefined
   const errorMessage = error.message || String(error)
 
@@ -190,9 +186,7 @@ export default class VelociousHttpServerClientRequestRunner {
         let timeoutReject
         let timedOut = false
 
-        const setRequestTimeoutSeconds = (/**
-                                           * Narrows the runtime value to the documented type.
-                                           * @type {number | undefined} */ timeoutSeconds) => {
+        const setRequestTimeoutSeconds = (/** @type {number | undefined} */ timeoutSeconds) => {
           if (timeoutId) {
             clearTimeout(timeoutId)
             timeoutId = undefined
@@ -255,9 +249,7 @@ export default class VelociousHttpServerClientRequestRunner {
       }
     } catch (e) {
       const error = ensureError(e)
-      const errorWithContext = /**
-                                * Narrows the runtime value to the documented type.
-                                * @type {{velociousContext?: object}} */ (error)
+      const errorWithContext = /** @type {{velociousContext?: object}} */ (error)
       const errorContext = errorWithContext.velociousContext || {stage: "request-runner"}
       const logDetails = requestErrorLogDetails(error)
 

package/build/http-server/client/websocket-session.js

@@ -38,9 +38,7 @@ const WEBSOCKET_MAX_FRAGMENTED_MESSAGE_FRAGMENTS = 1024
  */
 function subscribeMessage(message) {
   return message.type === "subscribe"
-    ? /**
-       * Narrows the runtime value to the documented type.
-       * @type {{type: "subscribe", channel: string, lastEventId?: string, params?: Record<string, ?>}} */ (message)
+    ? /** @type {{type: "subscribe", channel: string, lastEventId?: string, params?: Record<string, ?>}} */ (message)
     : null
 }
 
@@ -462,9 +460,7 @@ export default class VelociousHttpServerClientWebsocketSession {
     }
 
     if (message.type === "metadata") {
-      const metadataPayload = /**
-                               * Narrows the runtime value to the documented type.
-                               * @type {{data?: Record<string, ?>}} */ (message)
+      const metadataPayload = /** @type {{data?: Record<string, ?>}} */ (message)
 
       this._metadata = metadataPayload.data && typeof metadataPayload.data === "object" ? {...metadataPayload.data} : {}
 
@@ -1147,9 +1143,7 @@ export default class VelociousHttpServerClientWebsocketSession {
       this.sendJson({type: "connection-opened", connectionId})
     } catch (error) {
       this.logger.error(() => [`Failed to open connection ${connectionType}:${connectionId}`, error])
-      this.sendJson({type: "connection-error", connectionId, message: /**
-                                                                       * Narrows the runtime value to the documented type.
-                                                                       * @type {Error} */ (error).message || "Failed to open connection"})
+      this.sendJson({type: "connection-error", connectionId, message: /** @type {Error} */ (error).message || "Failed to open connection"})
     }
   }
 
@@ -1173,9 +1167,7 @@ export default class VelociousHttpServerClientWebsocketSession {
       })
     } catch (error) {
       this.logger.error(() => [`Failed to handle connection-message for ${connectionId}`, error])
-      this.sendJson({type: "connection-error", connectionId, message: /**
-                                                                       * Narrows the runtime value to the documented type.
-                                                                       * @type {Error} */ (error).message || "Failed to handle message"})
+      this.sendJson({type: "connection-error", connectionId, message: /** @type {Error} */ (error).message || "Failed to handle message"})
     }
   }
 
@@ -1286,9 +1278,7 @@ export default class VelociousHttpServerClientWebsocketSession {
       this._channelSubscriptions.delete(subscriptionId)
       this.configuration._unregisterWebsocketChannelSubscription(channelType, subscription)
       this.logger.error(() => [`Failed to subscribe channel ${channelType}:${subscriptionId}`, error])
-      this.sendJson({type: "channel-error", subscriptionId, message: /**
-                                                                      * Narrows the runtime value to the documented type.
-                                                                      * @type {Error} */ (error).message || "Failed to subscribe"})
+      this.sendJson({type: "channel-error", subscriptionId, message: /** @type {Error} */ (error).message || "Failed to subscribe"})
     }
   }
 
@@ -1331,9 +1321,7 @@ export default class VelociousHttpServerClientWebsocketSession {
     for (const event of events) {
       if (subscription.isClosed()) break
 
-      subscription.sendMessage(/**
-                                * Narrows the runtime value to the documented type.
-                                * @type {import("../websocket-channel.js").WebsocketJsonValue} */ (event.payload))
+      subscription.sendMessage(/** @type {import("../websocket-channel.js").WebsocketJsonValue} */ (event.payload))
     }
   }
 

package/build/http-server/development-reloader.js

@@ -96,9 +96,7 @@ export default class VelociousHttpServerDevelopmentReloader {
     try {
       entries = await this.readdir(resolvedDirectoryPath, {withFileTypes: true})
     } catch (error) {
-      if (/**
-           * Narrows the runtime value to the documented type.
-           * @type {{code?: string}} */ (error)?.code === "ENOENT") return
+      if (/** @type {{code?: string}} */ (error)?.code === "ENOENT") return
       throw error
     }
 
@@ -170,9 +168,7 @@ export default class VelociousHttpServerDevelopmentReloader {
         await this.watchDirectoryRecursive(changedPath)
       }
     } catch (error) {
-      if (/**
-           * Narrows the runtime value to the documented type.
-           * @type {{code?: string}} */ (error)?.code !== "ENOENT") {
+      if (/** @type {{code?: string}} */ (error)?.code !== "ENOENT") {
         throw error
       }
     }

package/build/http-server/remote-address.js

@@ -63,11 +63,7 @@ export default function resolveRemoteAddress({configuration, headers, socketRemo
 
   if (!trust) return socketRemoteAddress
 
-  const proxyRequest = /**
-                        * Narrows the runtime value to the documented type.
-                        * @type {Parameters<typeof proxyaddr>[0]} */ (/**
-                                                                      * Narrows the runtime value to the documented type.
-                                                                      * @type {?} */ ({
+  const proxyRequest = /** @type {Parameters<typeof proxyaddr>[0]} */ (/** @type {?} */ ({
     connection: {remoteAddress: socketRemoteAddress},
     headers: nodeStyleHeaders(headers),
     socket: {remoteAddress: socketRemoteAddress}

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

@@ -142,9 +142,7 @@ export default class ServerClient {
    * @returns {void} - No return value.
    */
   onSocketError = (error) => {
-    const errorCode = /**
-                       * Narrows the runtime value to the documented type.
-                       * @type {{code?: string}} */ (error).code
+    const errorCode = /** @type {{code?: string}} */ (error).code
 
     this.logger.error(() => [`Socket ${this.clientCount} error`, errorCode || error.message])
     this.emitClose()
@@ -188,12 +186,8 @@ export default class ServerClient {
         this.socket.off("error", onWriteError)
         resolve()
       }
-      const onWriteError = (/**
-                             * Narrows the runtime value to the documented type.
-                             * @type {Error} */ error) => {
-        const errorCode = /**
-                           * Narrows the runtime value to the documented type.
-                           * @type {{code?: string}} */ (error).code
+      const onWriteError = (/** @type {Error} */ error) => {
+        const errorCode = /** @type {{code?: string}} */ (error).code
 
         this.logger.error(() => [`Socket ${this.clientCount} write error`, errorCode || error.message])
         finish()

package/build/http-server/server-lock.js

@@ -54,9 +54,7 @@ export default class VelociousHttpServerLock {
     try {
       await fs.mkdir(this.lockPath)
     } catch (error) {
-      if (/**
-           * Narrows the runtime value to the documented type.
-           * @type {{code?: string}} */ (error).code === "EEXIST") return false
+      if (/** @type {{code?: string}} */ (error).code === "EEXIST") return false
       throw error
     }
 
@@ -105,9 +103,7 @@ export default class VelociousHttpServerLock {
 
     if (!this.isLocalProcessOwner(owner)) return false
 
-    return this.processIsDead(/**
-                               * Narrows the runtime value to the documented type.
-                               * @type {{pid: number}} */ (owner).pid)
+    return this.processIsDead(/** @type {{pid: number}} */ (owner).pid)
   }
 
   /**

package/build/http-server/websocket-channel-subscribers.js

@@ -92,12 +92,8 @@ export default class VelociousWebsocketChannelSubscribers {
       try {
         const result = callback(payload, meta)
 
-        if (result && typeof (/**
-                               * Narrows the runtime value to the documented type.
-                               * @type {Promise<void>} */ (result)).then === "function") {
-          tasks.push(/**
-                      * Narrows the runtime value to the documented type.
-                      * @type {Promise<void>} */ (result))
+        if (result && typeof (/** @type {Promise<void>} */ (result)).then === "function") {
+          tasks.push(/** @type {Promise<void>} */ (result))
         }
       } catch (error) {
         // Don't let one subscriber's failure abort the others; surface via the returned promises instead.