velocious 1.0.448 → 1.0.450

package/build/application.js

@@ -9,7 +9,7 @@ import restArgsError from "./utils/rest-args-error.js"
 
 /**
  * HttpServerConfiguration type.
-  @typedef {import("./configuration-types.js").HttpServerConfiguration} HttpServerConfiguration */
+ * @typedef {import("./configuration-types.js").HttpServerConfiguration} HttpServerConfiguration */
 
 export default class VelociousApplication {
   /**
@@ -28,14 +28,14 @@ export default class VelociousApplication {
 
     /**
      * Stores the http server configuration value.
-      @type {HttpServerConfiguration} */
+     * @type {HttpServerConfiguration} */
     this.httpServerConfiguration = httpServer ?? {}
 
     this.logger = new Logger(this)
     this._type = type
     /**
      * Stores the http server lock value.
-      @type {HttpServerLock | undefined} */
+     * @type {HttpServerLock | undefined} */
     this.httpServerLock = undefined
   }
 
@@ -121,7 +121,7 @@ export default class VelociousApplication {
       if (!configuration.getWebsocketEvents()) {
         configuration.setWebsocketEvents(/**
                                           * Types the following value.
-                                           @type {?} */ (websocketEventsHost))
+                                          * @type {?} */ (websocketEventsHost))
       }
 
       await configuration.connectBeacon({peerType: "server"})

package/build/authorization/ability.js

@@ -19,27 +19,27 @@
 export default class VelociousAuthorizationAbility {
   /**
    * Create.
-    @type {string[]} */
+   * @type {string[]} */
   static CREATE = ["create"]
 
   /**
    * Read.
-    @type {string[]} */
+   * @type {string[]} */
   static READ = ["read"]
 
   /**
    * Update.
-    @type {string[]} */
+   * @type {string[]} */
   static UPDATE = ["update"]
 
   /**
    * Destroy.
-    @type {string[]} */
+   * @type {string[]} */
   static DESTROY = ["destroy"]
 
   /**
    * Crud.
-    @type {string[]} */
+   * @type {string[]} */
   static CRUD = ["create", "read", "update", "destroy"]
 
   /**
@@ -56,12 +56,12 @@ export default class VelociousAuthorizationAbility {
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {AbilityRuleType[]} */
+     * @type {AbilityRuleType[]} */
     this.rules = []
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {Record<string, boolean>} */
+     * @type {Record<string, boolean>} */
     this.loadedModelClassAbilities = {}
   }
 
@@ -78,7 +78,7 @@ export default class VelociousAuthorizationAbility {
 
     /**
      * Resolved.
-      @type {Array<typeof import("./base-resource.js").default>} */
+     * @type {Array<typeof import("./base-resource.js").default>} */
     const resolved = []
     const backendProjects = configuration.getBackendProjects()
 

package/build/authorization/base-resource.js

@@ -4,7 +4,7 @@
 export default class AuthorizationBaseResource {
   /**
    * Model class.
-    @type {typeof import("../database/record/index.js").default | undefined} */
+   * @type {typeof import("../database/record/index.js").default | undefined} */
   static ModelClass = undefined
 
   /**
@@ -37,7 +37,7 @@ export default class AuthorizationBaseResource {
    */
   can(actions, conditions) {
     this.assertResourceConditionsSignature({conditions, methodName: "can"})
-    this.requiredAbility().can(actions, this.requiredModelClass(), /** Narrows conditions to the runtime resource model class. @type {import("./ability.js").AbilityConditionsType<typeof import("../database/record/index.js").default> | undefined} */ (conditions))
+    this.requiredAbility().can(actions, this.requiredModelClass(), /** @type {import("./ability.js").AbilityConditionsType<typeof import("../database/record/index.js").default> | undefined} */ (conditions))
   }
 
   /**
@@ -49,7 +49,7 @@ export default class AuthorizationBaseResource {
    */
   cannot(actions, conditions) {
     this.assertResourceConditionsSignature({conditions, methodName: "cannot"})
-    this.requiredAbility().cannot(actions, this.requiredModelClass(), /** Narrows conditions to the runtime resource model class. @type {import("./ability.js").AbilityConditionsType<typeof import("../database/record/index.js").default> | undefined} */ (conditions))
+    this.requiredAbility().cannot(actions, this.requiredModelClass(), /** @type {import("./ability.js").AbilityConditionsType<typeof import("../database/record/index.js").default> | undefined} */ (conditions))
   }
 
   /**
@@ -71,7 +71,7 @@ export default class AuthorizationBaseResource {
   requiredModelClass() {
     const modelClass = /**
                         * Narrows the runtime value to the documented type.
-                         @type {typeof AuthorizationBaseResource} */ (this.constructor).modelClass()
+                        * @type {typeof AuthorizationBaseResource} */ (this.constructor).modelClass()
 
     if (!modelClass) {
       throw new Error(`${this.constructor.name} must define static ModelClass before calling ability helpers.`)

package/build/background-jobs/cron-expression.js

@@ -62,7 +62,7 @@ export function parseCronExpression(expression) {
   const trimmed = expression.trim().toLowerCase()
   const expanded = SHORTCUTS[/**
                               * Narrows the runtime value to the documented type.
-                               @type {keyof typeof SHORTCUTS} */ (trimmed)] || trimmed
+                              * @type {keyof typeof SHORTCUTS} */ (trimmed)] || trimmed
   const fields = expanded.split(/\s+/)
 
   if (fields.length !== 5) {

package/build/background-jobs/forked-runner-child.js

@@ -14,7 +14,7 @@ function isJobMessage(message) {
 
   const messageRecord = /**
                          * Narrows the runtime value to the documented type.
-                          @type {{type?: ?, payload?: ?}} */ (message)
+                         * @type {{type?: ?, payload?: ?}} */ (message)
 
   return messageRecord.type === "job" && Object.hasOwn(messageRecord, "payload")
 }

package/build/background-jobs/job-registry.js

@@ -15,7 +15,7 @@ export default class BackgroundJobRegistry {
     this.configuration = configuration
     /**
      * Narrows the runtime value to the documented type.
-      @type {Map<string, typeof VelociousJob>} */
+     * @type {Map<string, typeof VelociousJob>} */
     this.jobsByName = new Map()
   }
 

package/build/background-jobs/job-runner.js

@@ -65,7 +65,7 @@ export default async function runJobPayload(payload) {
   const jobInstance = new JobClass()
   /**
    * Perform.
-    @type {(...args: Array<?>) => Promise<void>} */
+   * @type {(...args: Array<?>) => Promise<void>} */
   const perform = jobInstance.perform
 
   try {

package/build/background-jobs/job.js

@@ -60,7 +60,7 @@ export default class VelociousJob {
     if (isOptionsArg) {
       const {jobOptions} = /**
                             * Narrows the runtime value to the documented type.
-                             @type {{jobOptions: import("./types.js").BackgroundJobOptions}} */ (lastArg)
+                            * @type {{jobOptions: import("./types.js").BackgroundJobOptions}} */ (lastArg)
       return {jobArgs: args.slice(0, -1), jobOptions: jobOptions || {}}
     }
 

package/build/background-jobs/json-socket.js

@@ -12,19 +12,19 @@ export default class JsonSocket extends EventEmitter {
     this.socket = socket
     /**
      * Narrows the runtime value to the documented type.
-      @type {string | undefined} */
+     * @type {string | undefined} */
     this.workerId = undefined
     /**
      * Narrows the runtime value to the documented type.
-      @type {boolean} */
+     * @type {boolean} */
     this.acceptsSpawnedJobs = true
     /**
      * Narrows the runtime value to the documented type.
-      @type {boolean} */
+     * @type {boolean} */
     this.acceptsForkedJobs = true
     /**
      * Narrows the runtime value to the documented type.
-      @type {boolean} */
+     * @type {boolean} */
     this.acceptsInlineJobs = true
     this.buffer = ""
     this.socket.setEncoding("utf8")

package/build/background-jobs/main.js

@@ -29,7 +29,7 @@ const MAX_TIMER_MS = 2_147_483_647 // ~24.8 days
  */
 /**
  * Worker execution mode capabilities.
-  @type {WorkerExecutionModeCapability[]} */
+ * @type {WorkerExecutionModeCapability[]} */
 const WORKER_EXECUTION_MODE_CAPABILITIES = [
   {executionMode: "inline", accepts: (worker) => worker.acceptsInlineJobs !== false},
   {executionMode: "forked", accepts: (worker) => worker.acceptsForkedJobs !== false},
@@ -58,50 +58,50 @@ export default class BackgroundJobsMain {
     this.logger = new Logger(this)
     /**
      * Narrows the runtime value to the documented type.
-      @type {Set<JsonSocket>} */
+     * @type {Set<JsonSocket>} */
     this.workers = new Set()
     /**
      * Narrows the runtime value to the documented type.
-      @type {Set<JsonSocket>} */
+     * @type {Set<JsonSocket>} */
     this.readyWorkers = new Set()
     /**
      * Narrows the runtime value to the documented type.
-      @type {net.Server | undefined} */
+     * @type {net.Server | undefined} */
     this.server = undefined
     /**
      * Narrows the runtime value to the documented type.
-      @type {NodeJS.Timeout | undefined} */
+     * @type {NodeJS.Timeout | undefined} */
     this._pollTimer = undefined
     /**
      * Narrows the runtime value to the documented type.
-      @type {NodeJS.Timeout | undefined} */
+     * @type {NodeJS.Timeout | undefined} */
     this._scheduledTimer = undefined
     /**
      * Narrows the runtime value to the documented type.
-      @type {NodeJS.Timeout | undefined} */
+     * @type {NodeJS.Timeout | undefined} */
     this._errorRetryTimer = undefined
     /**
      * Narrows the runtime value to the documented type.
-      @type {NodeJS.Timeout | undefined} */
+     * @type {NodeJS.Timeout | undefined} */
     this._orphanTimer = undefined
     /**
      * Narrows the runtime value to the documented type.
-      @type {BackgroundJobsScheduler | undefined} */
+     * @type {BackgroundJobsScheduler | undefined} */
     this.scheduler = undefined
     this._draining = false
     this._redrainQueued = false
     this._stopped = false
     /**
      * Narrows the runtime value to the documented type.
-      @type {(() => void) | undefined} */
+     * @type {(() => void) | undefined} */
     this._unsubscribeBeacon = undefined
     /**
      * Narrows the runtime value to the documented type.
-      @type {((...args: Array<?>) => void) | undefined} */
+     * @type {((...args: Array<?>) => void) | undefined} */
     this._beaconConnectHandler = undefined
     /**
      * Narrows the runtime value to the documented type.
-      @type {import("../beacon/client.js").default | import("../beacon/in-process-client.js").default | undefined} */
+     * @type {import("../beacon/client.js").default | import("../beacon/in-process-client.js").default | undefined} */
     this._beaconClient = undefined
   }
 
@@ -178,7 +178,7 @@ export default class BackgroundJobsMain {
 
   /**
    * Runs close workers.
-    @returns {void} */
+   * @returns {void} */
   _closeWorkers() {
     for (const worker of this.workers) {
       worker.close()
@@ -187,7 +187,7 @@ export default class BackgroundJobsMain {
 
   /**
    * Runs clear timers.
-    @returns {void} */
+   * @returns {void} */
   _clearTimers() {
     if (this._pollTimer) clearInterval(this._pollTimer)
     if (this._scheduledTimer) clearTimeout(this._scheduledTimer)
@@ -201,7 +201,7 @@ export default class BackgroundJobsMain {
 
   /**
    * Runs disconnect beacon handlers.
-    @returns {void} */
+   * @returns {void} */
   _disconnectBeaconHandlers() {
     if (this._unsubscribeBeacon) {
       this._unsubscribeBeacon()
@@ -217,7 +217,7 @@ export default class BackgroundJobsMain {
 
   /**
    * Runs stop beacon and server.
-    @returns {Promise<void>} */
+   * @returns {Promise<void>} */
   async _stopBeaconAndServer() {
     try {
       await this.configuration.disconnectBeacon()
@@ -228,7 +228,7 @@ export default class BackgroundJobsMain {
 
   /**
    * Runs close server and database connections.
-    @returns {Promise<void>} */
+   * @returns {Promise<void>} */
   async _closeServerAndDatabaseConnections() {
     try {
       await this._closeServer()
@@ -239,7 +239,7 @@ export default class BackgroundJobsMain {
 
   /**
    * Runs close server.
-    @returns {Promise<void>} */
+   * @returns {Promise<void>} */
   async _closeServer() {
     if (!this.server) return
 
@@ -327,7 +327,7 @@ export default class BackgroundJobsMain {
     const jsonSocket = new JsonSocket(socket)
     /**
      * Role.
-      @type {import("./types.js").BackgroundJobSocketRole | null} */
+     * @type {import("./types.js").BackgroundJobSocketRole | null} */
     let role = null
 
     const cleanup = () => {
@@ -697,7 +697,7 @@ export default class BackgroundJobsMain {
 
   /**
    * Runs clear error retry timer.
-    @returns {void} */
+   * @returns {void} */
   _clearErrorRetryTimer() {
     if (this._errorRetryTimer) {
       clearTimeout(this._errorRetryTimer)
@@ -839,7 +839,7 @@ export default class BackgroundJobsMain {
       this._addAcceptedExecutionModes({executionModes, worker})
     }
 
-    return /** Narrows the runtime value to the documented type. @type {import("./types.js").BackgroundJobExecutionMode[]} */ ([...executionModes])
+    return /** @type {import("./types.js").BackgroundJobExecutionMode[]} */ ([...executionModes])
   }
 
   /**

package/build/background-jobs/scheduler.js

@@ -23,7 +23,7 @@ const DURATION_MULTIPLIERS = {
 }
 /**
  * DurationUnit type.
-  @typedef {keyof typeof DURATION_MULTIPLIERS} DurationUnit */
+ * @typedef {keyof typeof DURATION_MULTIPLIERS} DurationUnit */
 
 /**
  * Runs the parseScheduledDuration helper.
@@ -54,7 +54,7 @@ export function parseScheduledDuration(value, fieldName) {
   const numericValue = Number(match[1])
   const multiplier = DURATION_MULTIPLIERS[/**
                                            * Narrows the runtime value to the documented type.
-                                            @type {DurationUnit} */ (match[2])]
+                                           * @type {DurationUnit} */ (match[2])]
 
   if (!multiplier) {
     throw new Error(`Invalid scheduled background job ${fieldName}: ${value}`)
@@ -77,11 +77,11 @@ export default class BackgroundJobsScheduler {
     this.logger = new Logger(this)
     /**
      * Narrows the runtime value to the documented type.
-      @type {Array<ReturnType<typeof setInterval>>} */
+     * @type {Array<ReturnType<typeof setInterval>>} */
     this.intervalIds = []
     /**
      * Narrows the runtime value to the documented type.
-      @type {Array<ReturnType<typeof setTimeout>>} */
+     * @type {Array<ReturnType<typeof setTimeout>>} */
     this.timeoutIds = []
     /**
      * Narrows the runtime value to the documented type.
@@ -92,7 +92,7 @@ export default class BackgroundJobsScheduler {
 
   /**
    * Runs start.
-    @returns {Promise<void>} */
+   * @returns {Promise<void>} */
   async start() {
     this.stopped = false
 
@@ -115,7 +115,7 @@ export default class BackgroundJobsScheduler {
 
   /**
    * Runs stop.
-    @returns {void} */
+   * @returns {void} */
   stop() {
     this.stopped = true
 
@@ -170,7 +170,7 @@ export default class BackgroundJobsScheduler {
   scheduleEveryJob({jobConfiguration, jobKey}) {
     const everyConfig = /**
                          * Narrows the runtime value to the documented type.
-                          @type {NonNullable<typeof jobConfiguration.every>} */ (jobConfiguration.every)
+                         * @type {NonNullable<typeof jobConfiguration.every>} */ (jobConfiguration.every)
     const {everyValue, firstInValue} = this.normalizeEvery(everyConfig)
     const intervalMs = parseScheduledDuration(everyValue, `${jobKey}.every`)
     const firstInMs = firstInValue !== undefined ? parseScheduledDuration(firstInValue, `${jobKey}.first_in`) : intervalMs

package/build/background-jobs/store.js

@@ -15,7 +15,7 @@ const DEFAULT_MAX_RETRIES = 10
 const ORPHANED_AFTER_MS = 2 * 60 * 60 * 1000
 /**
  * Execution modes.
-  @type {import("./types.js").BackgroundJobExecutionMode[]} */
+ * @type {import("./types.js").BackgroundJobExecutionMode[]} */
 const EXECUTION_MODES = ["inline", "forked", "spawned"]
 const DEFAULT_EXECUTION_MODE = "forked"
 
@@ -233,13 +233,13 @@ export default class BackgroundJobsStore {
 
       /**
        * Counts.
-        @type {Record<string, number>} */
+       * @type {Record<string, number>} */
       const counts = {}
 
       for (const row of rows) {
         const typedRow = /**
                           * Narrows the runtime value to the documented type.
-                           @type {Record<string, ?>} */ (row)
+                          * @type {Record<string, ?>} */ (row)
 
         counts[String(typedRow.status)] = this._normalizeNumber(typedRow.count) || 0
       }
@@ -267,7 +267,7 @@ export default class BackgroundJobsStore {
       const rows = await query.results()
       const countRow = /**
                         * Narrows the runtime value to the documented type.
-                         @type {Record<string, ?>} */ (rows[0] || {})
+                        * @type {Record<string, ?>} */ (rows[0] || {})
 
       return this._normalizeNumber(countRow.count) || 0
     })
@@ -734,7 +734,7 @@ export default class BackgroundJobsStore {
   _failureUpdate({failureMessage, markOrphaned, nextAttempt, now, scheduledAt, shouldRetry}) {
     /**
      * Update.
-      @type {Record<string, ?>} */
+     * @type {Record<string, ?>} */
     const update = {
       attempts: nextAttempt,
       handed_off_at_ms: null,
@@ -926,7 +926,7 @@ export default class BackgroundJobsStore {
     let callbackCalled = false
     /**
      * Defines result.
-      @type {T | undefined} */
+     * @type {T | undefined} */
     let result
 
     await pool.withConnection({name: "Background jobs store"}, async (db) => {
@@ -938,7 +938,7 @@ export default class BackgroundJobsStore {
       throw new Error("Background jobs store callback was not invoked")
     }
 
-    return /** Narrows the runtime value to the documented type. @type {T} */ (result)
+    return /** @type {T} */ (result)
   }
 
   /**

package/build/background-jobs/web/controller.js

@@ -112,7 +112,7 @@ export default class VelociousBackgroundJobsWebController extends Controller {
       const counts = await this._store().countsByStatus()
       /**
        * By status.
-        @type {Record<string, number>} */
+       * @type {Record<string, number>} */
       const byStatus = {}
       let total = 0
 
@@ -224,7 +224,7 @@ export default class VelociousBackgroundJobsWebController extends Controller {
     return Object.keys(jobs).map((name) => {
       const entry = jobs[name] || /**
                                    * Narrows the runtime value to the documented type.
-                                    @type {?} */ ({})
+                                   * @type {?} */ ({})
 
       return {
         args: redactArgs ? undefined : (entry.args || []),

package/build/background-jobs/worker.js

@@ -14,7 +14,7 @@ const FORKED_CHILD_SIGKILL_GRACE_MS = 5000
 const FORKED_RUNNER_ENTRY_PATH = fileURLToPath(new URL("./forked-runner-child.js", import.meta.url))
 /**
  * Execution modes.
-  @type {import("./types.js").BackgroundJobExecutionMode[]} */
+ * @type {import("./types.js").BackgroundJobExecutionMode[]} */
 const EXECUTION_MODES = ["inline", "forked", "spawned"]
 
 export default class BackgroundJobsWorker {
@@ -31,11 +31,11 @@ export default class BackgroundJobsWorker {
   constructor({configuration, host, port, maxConcurrentForkedJobs, maxConcurrentInlineJobs, forkedChildSigkillGraceMs} = {}) {
     /**
      * Narrows the runtime value to the documented type.
-      @type {Promise<import("../configuration.js").default>} */
+     * @type {Promise<import("../configuration.js").default>} */
     this.configurationPromise = configuration ? Promise.resolve(configuration) : configurationResolver()
     /**
      * Narrows the runtime value to the documented type.
-      @type {import("../configuration.js").default | undefined} */
+     * @type {import("../configuration.js").default | undefined} */
     this.configuration = undefined
     this.host = host
     this.port = port
@@ -50,7 +50,7 @@ export default class BackgroundJobsWorker {
       : undefined
     /**
      * Narrows the runtime value to the documented type.
-      @type {number | undefined} */
+     * @type {number | undefined} */
     this.maxConcurrentForkedJobsOverride = typeof maxConcurrentForkedJobs === "number" && maxConcurrentForkedJobs >= 1
       ? maxConcurrentForkedJobs
       : undefined
@@ -62,7 +62,7 @@ export default class BackgroundJobsWorker {
     this.maxConcurrentInlineJobs = this.maxConcurrentInlineJobsOverride || 4
     /**
      * Narrows the runtime value to the documented type.
-      @type {number} */
+     * @type {number} */
     this.maxConcurrentForkedJobs = this.maxConcurrentForkedJobsOverride || 4
     /**
      * Grace period between SIGTERM and SIGKILL when reaping process runners that
@@ -76,11 +76,11 @@ export default class BackgroundJobsWorker {
     this.workerId = randomUUID()
     /**
      * Narrows the runtime value to the documented type.
-      @type {JsonSocket | undefined} */
+     * @type {JsonSocket | undefined} */
     this.jsonSocket = undefined
     /**
      * Narrows the runtime value to the documented type.
-      @type {BackgroundJobsStatusReporter | undefined} */
+     * @type {BackgroundJobsStatusReporter | undefined} */
     this.statusReporter = undefined
     /**
      * Up to `this.maxConcurrentInlineJobs` of these run in parallel. They
@@ -275,10 +275,10 @@ export default class BackgroundJobsWorker {
     if (!payload.id) throw new Error("Background job payload missing id")
     /**
      * Identified payload.
-      @type {import("./types.js").BackgroundJobPayload & {id: string}} */
+     * @type {import("./types.js").BackgroundJobPayload & {id: string}} */
     const identifiedPayload = /**
                                * Narrows the runtime value to the documented type.
-                                @type {?} */ (payload)
+                               * @type {?} */ (payload)
 
     const executionMode = this._executionModeForPayload(identifiedPayload)
 
@@ -322,7 +322,7 @@ export default class BackgroundJobsWorker {
     // regardless of success or failure.
     /**
      * Defines inflight.
-      @type {Promise<void>} */
+     * @type {Promise<void>} */
     let inflight
 
     inflight = this._runInlineJobAndReport(payload).finally(() => {
@@ -375,7 +375,7 @@ export default class BackgroundJobsWorker {
   _trackProcessJob(processJob) {
     /**
      * Defines inflight.
-      @type {Promise<void>} */
+     * @type {Promise<void>} */
     let inflight
 
     inflight = processJob.finally(() => {
@@ -464,7 +464,7 @@ export default class BackgroundJobsWorker {
     const jobInstance = new JobClass()
     /**
      * Perform.
-      @type {(...args: Array<?>) => Promise<void>} */
+     * @type {(...args: Array<?>) => Promise<void>} */
     const perform = jobInstance.perform
 
     await configuration.withConnections({name: `Background job worker inline: ${payload.jobName}`}, async () => {

package/build/beacon/client.js

@@ -55,22 +55,22 @@ export default class BeaconClient extends EventEmitter {
     this._reconnectDelayMs = this._initialReconnectDelayMs
     /**
      * Narrows the runtime value to the documented type.
-      @type {JsonSocket | undefined} */
+     * @type {JsonSocket | undefined} */
     this._jsonSocket = undefined
     /**
      * Narrows the runtime value to the documented type.
-      @type {net.Socket | undefined} */
+     * @type {net.Socket | undefined} */
     this._socket = undefined
     this._connected = false
     this._ready = false
     this._closed = false
     /**
      * Narrows the runtime value to the documented type.
-      @type {NodeJS.Timeout | undefined} */
+     * @type {NodeJS.Timeout | undefined} */
     this._reconnectTimer = undefined
     /**
      * Narrows the runtime value to the documented type.
-      @type {Promise<void> | undefined} */
+     * @type {Promise<void> | undefined} */
     this._connectPromise = undefined
     /**
      * Last socket error observed while connected, surfaced as the disconnect reason.
@@ -118,7 +118,7 @@ export default class BeaconClient extends EventEmitter {
       }
       const onError = (/**
                         * Narrows the runtime value to the documented type.
-                         @type {Error} */ error) => {
+                        * @type {Error} */ error) => {
         this.off("connect", onConnect)
         this.off("connect-error", onError)
         reject(error)
@@ -145,7 +145,10 @@ export default class BeaconClient extends EventEmitter {
   async waitForReady({timeoutMs} = {}) {
     if (this._ready) return
 
-    /** Cleanup. @type {() => void} */
+    /**
+     * Cleans up the ready listener and timeout.
+     * @type {() => void}
+     */
     let cleanup = () => {}
     const readyPromise = new Promise((resolve) => {
       const onReady = () => {
@@ -184,7 +187,7 @@ export default class BeaconClient extends EventEmitter {
 
     /**
      * Message.
-      @type {import("./types.js").BeaconBroadcastMessage} */
+     * @type {import("./types.js").BeaconBroadcastMessage} */
     const message = {
       type: "broadcast",
       channel,
@@ -270,7 +273,7 @@ export default class BeaconClient extends EventEmitter {
 
     jsonSocket.on("message", (/**
                                * Narrows the runtime value to the documented type.
-                                @type {import("./types.js").BeaconSocketMessage} */ message) => {
+                               * @type {import("./types.js").BeaconSocketMessage} */ message) => {
       if (message?.type === "hello-ack" && message.peerId === this.peerId) {
         this._ready = true
         this.emit("ready")

package/build/beacon/in-process-broker.js

@@ -20,11 +20,11 @@
 
 /**
  * Defines this typedef.
-  @typedef {{_receiveBroadcast: (message: import("./types.js").BeaconBroadcastMessage) => void}} InProcessPeer */
+ * @typedef {{_receiveBroadcast: (message: import("./types.js").BeaconBroadcastMessage) => void}} InProcessPeer */
 
 /**
  * Peers.
-  @type {Set<InProcessPeer>} */
+ * @type {Set<InProcessPeer>} */
 const peers = new Set()
 
 /**