velocious 1.0.562 → 1.0.564

package/src/frontend-models/query.js

@@ -5,28 +5,6 @@ import {normalizeRansackGroup, parseRansackSort} from "../utils/ransack.js"
 import {isModelScopeDescriptor} from "../utils/model-scope.js"
 import isPlainObject from "../utils/plain-object.js"
 
-/** Error raised when a frontend-model query descriptor is malformed. */
-export class FrontendModelQueryError extends Error {
-  /**
-   * Creates a frontend-model query error.
-   * @param {string} message - Error message.
-   */
-  constructor(message) {
-    super(message)
-
-    this.name = "FrontendModelQueryError"
-  }
-}
-
-/**
- * Builds a query descriptor error.
- * @param {string} message - Error message.
- * @returns {FrontendModelQueryError} - Query descriptor error.
- */
-function frontendModelQueryError(message) {
-  return new FrontendModelQueryError(message)
-}
-
 /**
  * FrontendModelSearch type.
  * @typedef {object} FrontendModelSearch
@@ -97,6 +75,46 @@ function frontendModelQueryError(message) {
  * @property {FrontendModelEventFilterPayload | null} eventFilterPayload - Normalized event filter payload, or null when unfiltered.
  * @property {FrontendModelProjectionPayload} projectionPayload - Normalized event serialization projection payload.
  */
+/**
+ * FrontendModelSort type.
+ * @typedef {object} FrontendModelSort
+ * @property {string} column - Attribute name to sort by.
+ * @property {"asc" | "desc"} direction - Sort direction.
+ * @property {string[]} path - Relationship path from root model.
+ */
+/**
+ * FrontendModelGroup type.
+ * @typedef {object} FrontendModelGroup
+ * @property {string} column - Attribute name to group by.
+ * @property {string[]} path - Relationship path from root model.
+ */
+/**
+ * FrontendModelPluck type.
+ * @typedef {object} FrontendModelPluck
+ * @property {string} column - Attribute name to pluck.
+ * @property {string[]} path - Relationship path from root model.
+ */
+/** Error raised when a frontend-model query descriptor is malformed. */
+export class FrontendModelQueryError extends Error {
+  /**
+   * Creates a frontend-model query error.
+   * @param {string} message - Error message.
+   */
+  constructor(message) {
+    super(message)
+
+    this.name = "FrontendModelQueryError"
+  }
+}
+
+/**
+ * Builds a query descriptor error.
+ * @param {string} message - Error message.
+ * @returns {FrontendModelQueryError} - Query descriptor error.
+ */
+function frontendModelQueryError(message) {
+  return new FrontendModelQueryError(message)
+}
 
 /**
  * Runs the normalizePreload helper.
@@ -490,28 +508,6 @@ export function normalizeJoins(joins) {
   return normalized
 }
 
-/**
- * FrontendModelSort type.
- * @typedef {object} FrontendModelSort
- * @property {string} column - Attribute name to sort by.
- * @property {"asc" | "desc"} direction - Sort direction.
- * @property {string[]} path - Relationship path from root model.
- */
-
-/**
- * FrontendModelGroup type.
- * @typedef {object} FrontendModelGroup
- * @property {string} column - Attribute name to group by.
- * @property {string[]} path - Relationship path from root model.
- */
-
-/**
- * FrontendModelPluck type.
- * @typedef {object} FrontendModelPluck
- * @property {string} column - Attribute name to pluck.
- * @property {string[]} path - Relationship path from root model.
- */
-
 /**
  * Runs normalize sort direction.
  * @param {?} direction - Direction value.

package/src/frontend-models/resource-definition.js

@@ -5,6 +5,13 @@ import FrontendModelBaseResource from "../frontend-model-resource/base-resource.
 import restArgsError from "../utils/rest-args-error.js"
 import {validateFrontendModelResourceCommandName} from "./resource-config-validation.js"
 
+/**
+ * Resolved frontend-model resource registration for a replay resource type.
+ * @typedef {object} FrontendModelResolvedResourceRegistration
+ * @property {string} modelName - Effective frontend model name (modelName override or registry key).
+ * @property {import("../configuration-types.js").FrontendModelResourceClassType} resourceClass - Registered resource class.
+ * @property {import("../configuration-types.js").NormalizedFrontendModelResourceConfiguration} resourceConfiguration - Normalized resource configuration.
+ */
 const BASE_FRONTEND_MODEL_ABILITY_ACTIONS = ["create", "destroy", "read", "update"]
 const SHA256_INITIAL_HASH = [
   0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a,
@@ -1027,14 +1034,6 @@ function normalizeFrontendModelResourcePathForMatch(path) {
   return withLeadingSlash
 }
 
-/**
- * Resolved frontend-model resource registration for a replay resource type.
- * @typedef {object} FrontendModelResolvedResourceRegistration
- * @property {string} modelName - Effective frontend model name (modelName override or registry key).
- * @property {import("../configuration-types.js").FrontendModelResourceClassType} resourceClass - Registered resource class.
- * @property {import("../configuration-types.js").NormalizedFrontendModelResourceConfiguration} resourceConfiguration - Normalized resource configuration.
- */
-
 /**
  * Resolves the registered frontend-model resource class for a resource type
  * across all backend projects. A resource's effective name is its

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

@@ -4,28 +4,26 @@ import {resolveFrontendModelClass} from "./model-registry.js"
 import isPlainObject from "../utils/plain-object.js"
 import {formatDateInTimeZone, validateTimeZone} from "../time-zone.js"
 
-const TYPE_KEY = "__velocious_type"
-const TYPE_DATE = "date"
-const TYPE_UNDEFINED = "undefined"
-const TYPE_BIGINT = "bigint"
-const TYPE_NUMBER = "number"
-const TYPE_FRONTEND_MODEL = "frontend_model"
-const NUMBER_NAN = "NaN"
-const NUMBER_POSITIVE_INFINITY = "Infinity"
-const NUMBER_NEGATIVE_INFINITY = "-Infinity"
-const PRELOADED_RELATIONSHIPS_KEY = "__preloadedRelationships"
-
 /**
  * Frontend model transport serialization options.
  * @typedef {object} FrontendModelTransportSerializationOptions
  * @property {string | undefined} [timeZone] - IANA timezone used when serializing Date instants.
  */
-
 /**
  * Normalized frontend model transport serialization options.
  * @typedef {object} NormalizedFrontendModelTransportSerializationOptions
  * @property {string | undefined} timeZone - Validated IANA timezone used when serializing Date instants.
  */
+const TYPE_KEY = "__velocious_type"
+const TYPE_DATE = "date"
+const TYPE_UNDEFINED = "undefined"
+const TYPE_BIGINT = "bigint"
+const TYPE_NUMBER = "number"
+const TYPE_FRONTEND_MODEL = "frontend_model"
+const NUMBER_NAN = "NaN"
+const NUMBER_POSITIVE_INFINITY = "Infinity"
+const NUMBER_NEGATIVE_INFINITY = "-Infinity"
+const PRELOADED_RELATIONSHIPS_KEY = "__preloadedRelationships"
 
 /**
  * Assign a key to a plain object without triggering the `__proto__` setter.

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

@@ -4,6 +4,18 @@ import VelociousWebsocketChannel from "../http-server/websocket-channel.js"
 import Response from "../http-server/client/response.js"
 import {serializeFrontendModelTransportValue} from "./transport-serialization.js"
 
+/**
+ * Defines this typedef.
+ * @typedef {{action?: string, id?: string | number, matchedEventFilterKeys?: string[], record?: import("./query.js").FrontendModelTransportValue, [key: string]: import("./query.js").FrontendModelTransportValue | string[] | undefined}} FrontendModelLifecycleBroadcastBody
+ */
+/**
+ * Defines this typedef.
+ * @typedef {{headers?: () => Record<string, string | string[] | undefined>, remoteAddress?: () => string | undefined}} FrontendModelWebsocketUpgradeRequest
+ */
+/**
+ * Defines this typedef.
+ * @typedef {{headers: () => Record<string, string | string[] | undefined>, header: (name: string) => string | string[] | undefined, metadata: (key?: string) => Record<string, import("./query.js").FrontendModelTransportValue> | import("./query.js").FrontendModelTransportValue | undefined, path: () => string, httpMethod: () => string, remoteAddress: () => string | undefined, origin: () => string | string[] | undefined}} FrontendModelWebsocketSyntheticRequest
+ */
 const EVENT_FILTER_KEYS = new Set(["joins", "key", "searches", "where"])
 
 // Mirrors FRONTEND_MODELS_CHANNEL_NAME in ./websocket-publishers.js, duplicated here
@@ -21,19 +33,6 @@ function transportSerializationOptionsForConfiguration(configuration) {
   }
 }
 
-/**
- * Defines this typedef.
- * @typedef {{action?: string, id?: string | number, matchedEventFilterKeys?: string[], record?: import("./query.js").FrontendModelTransportValue, [key: string]: import("./query.js").FrontendModelTransportValue | string[] | undefined}} FrontendModelLifecycleBroadcastBody
- */
-/**
- * Defines this typedef.
- * @typedef {{headers?: () => Record<string, string | string[] | undefined>, remoteAddress?: () => string | undefined}} FrontendModelWebsocketUpgradeRequest
- */
-/**
- * Defines this typedef.
- * @typedef {{headers: () => Record<string, string | string[] | undefined>, header: (name: string) => string | string[] | undefined, metadata: (key?: string) => Record<string, import("./query.js").FrontendModelTransportValue> | import("./query.js").FrontendModelTransportValue | undefined, path: () => string, httpMethod: () => string, remoteAddress: () => string | undefined, origin: () => string | string[] | undefined}} FrontendModelWebsocketSyntheticRequest
- */
-
 /**
  * Per-session channel subscription for frontend-model lifecycle events.
  * Replaces the legacy `FrontendModelWebsocketChannel` (Phase 3).

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

@@ -9,6 +9,10 @@ import WebsocketRequest from "./websocket-request.js"
 import WebsocketChannel from "../websocket-channel.js"
 import {websocketEventLogStoreForConfiguration} from "../websocket-event-log-store.js"
 
+/**
+ * Defines this typedef.
+ * @typedef {{type: "subscribe", channel: string, lastEventId?: string, params?: Record<string, ?>} | {type: "metadata", data?: Record<string, ?>} | {type?: "request", body?: ?, headers?: Record<string, ?>, id?: string | number | null, method: string, path: string} | Record<string, ?>} WebsocketSessionMessage
+ */
 const WEBSOCKET_FINAL_FRAME = 0x80
 const WEBSOCKET_OPCODE_CONTINUATION = 0x0
 const WEBSOCKET_OPCODE_TEXT = 0x1
@@ -31,11 +35,6 @@ const WEBSOCKET_MAX_INBOUND_FRAME_BYTES_BIGINT = BigInt(WEBSOCKET_MAX_FINAL_FRAM
 /** Cap on fragment count for a single fragmented message. */
 const WEBSOCKET_MAX_FRAGMENTED_MESSAGE_FRAGMENTS = 1024
 
-/**
- * Defines this typedef.
- * @typedef {{type: "subscribe", channel: string, lastEventId?: string, params?: Record<string, ?>} | {type: "metadata", data?: Record<string, ?>} | {type?: "request", body?: ?, headers?: Record<string, ?>, id?: string | number | null, method: string, path: string} | Record<string, ?>} WebsocketSessionMessage
- */
-
 /**
  * Runs subscribe message.
  * @param {WebsocketSessionMessage} message - Raw websocket message.
@@ -423,7 +422,7 @@ export default class VelociousHttpServerClientWebsocketSession {
   sendGoodbye(client) {
     const frame = Buffer.from([WEBSOCKET_FINAL_FRAME | WEBSOCKET_OPCODE_CLOSE, 0x00])
 
-    client.events.emit("output", frame)
+    client.events.emit("output", frame, {websocketFrame: true})
   }
 
   /**
@@ -967,7 +966,7 @@ export default class VelociousHttpServerClientWebsocketSession {
     header[0] = WEBSOCKET_FINAL_FRAME | opcode
     header[1] = payload.length
 
-    this.client.events.emit("output", Buffer.concat([header, payload]))
+    this.client.events.emit("output", Buffer.concat([header, payload]), {websocketFrame: true})
   }
 
   /**
@@ -1012,7 +1011,7 @@ export default class VelociousHttpServerClientWebsocketSession {
 
     header[0] = WEBSOCKET_FINAL_FRAME | WEBSOCKET_OPCODE_TEXT
 
-    this.client.events.emit("output", Buffer.concat([header, payload]))
+    this.client.events.emit("output", Buffer.concat([header, payload]), {websocketFrame: true})
   }
 
   /**

package/src/http-server/client-delivery-queue.js

@@ -0,0 +1,167 @@
+/**
+ * @typedef {object} DeliveryTask
+ * @property {number} byteLength - Retained complete-buffer bytes.
+ * @property {boolean} countedFrame - Whether this task is an outbound frame.
+ * @property {() => Promise<void>} delivery - Delivery operation.
+ * @property {(error?: Error) => void} settle - Settles the enqueue promise.
+ */
+// @ts-check
+
+export class ClientDeliveryQueueOverflowError extends Error {
+  /**
+   * Builds an outbound queue overflow error.
+   * @param {object} args - Overflow details.
+   * @param {number} args.clientCount - Client identifier.
+   * @param {number} args.maxBytes - Configured byte high-water mark.
+   * @param {number} args.maxFrames - Configured frame high-water mark.
+   * @param {number} args.pendingBytes - Bytes retained before rejecting the frame.
+   * @param {number} args.pendingFrames - Frames retained before rejecting the frame.
+   * @param {number} args.rejectedBytes - Rejected frame size.
+   */
+  constructor({clientCount, maxBytes, maxFrames, pendingBytes, pendingFrames, rejectedBytes}) {
+    super(`WebSocket client ${clientCount} exceeded its outbound queue limit (${pendingFrames}/${maxFrames} frames, ${pendingBytes}/${maxBytes} bytes; rejected ${rejectedBytes} bytes)`)
+    this.name = "ClientDeliveryQueueOverflowError"
+  }
+}
+
+export default class ClientDeliveryQueue {
+  /**
+   * Builds a per-client delivery queue.
+   * @param {object} args - Queue options.
+   * @param {number} args.clientCount - Client identifier.
+   * @param {number} args.maxBytes - Byte high-water mark.
+   * @param {number} args.maxFrames - Frame high-water mark.
+   * @param {(error: ClientDeliveryQueueOverflowError) => void} args.onOverflow - Overflow handler.
+   */
+  constructor({clientCount, maxBytes, maxFrames, onOverflow}) {
+    this.clientCount = clientCount
+    this.maxBytes = maxBytes
+    this.maxFrames = maxFrames
+    this.onOverflow = onOverflow
+    /** @type {DeliveryTask[]} */
+    this.tasks = []
+    /** @type {DeliveryTask | undefined} */
+    this.activeTask = undefined
+    this.pendingBytes = 0
+    this.pendingFrames = 0
+    this.destroyed = false
+  }
+
+  /**
+   * Enqueues one complete output buffer.
+   * @param {object} args - Delivery details.
+   * @param {number} args.byteLength - Exact buffer byte length.
+   * @param {() => Promise<void>} args.delivery - Delivery operation.
+   * @returns {Promise<void>} - Settles after delivery or teardown.
+   */
+  enqueueFrame({byteLength, delivery}) {
+    if (this.destroyed) return Promise.resolve()
+
+    if (this.pendingFrames + 1 > this.maxFrames || this.pendingBytes + byteLength > this.maxBytes) {
+      const error = new ClientDeliveryQueueOverflowError({
+        clientCount: this.clientCount,
+        maxBytes: this.maxBytes,
+        maxFrames: this.maxFrames,
+        pendingBytes: this.pendingBytes,
+        pendingFrames: this.pendingFrames,
+        rejectedBytes: byteLength
+      })
+
+      this.onOverflow(error)
+      return Promise.reject(error)
+    }
+
+    this.pendingFrames += 1
+    this.pendingBytes += byteLength
+    return this._enqueue({byteLength, countedFrame: true, delivery})
+  }
+
+  /**
+   * Enqueues an ordering-only operation that retains no complete output frame.
+   * @param {() => Promise<void>} delivery - Delivery operation.
+   * @returns {Promise<void>} - Settles after delivery or teardown.
+   */
+  enqueueControl(delivery) {
+    if (this.destroyed) return Promise.resolve()
+
+    return this._enqueue({byteLength: 0, countedFrame: false, delivery})
+  }
+
+  /**
+   * Releases queued and active accounting during explicit client teardown.
+   * @returns {void}
+   */
+  destroy() {
+    if (this.destroyed) return
+
+    this.destroyed = true
+    const tasks = this.activeTask ? [this.activeTask, ...this.tasks] : this.tasks
+
+    this.activeTask = undefined
+    this.tasks = []
+    this.pendingBytes = 0
+    this.pendingFrames = 0
+
+    for (const task of tasks) task.settle()
+  }
+
+  /**
+   * Gets current retained-buffer accounting.
+   * @returns {{pendingBytes: number, pendingFrames: number}} - Current retained-buffer accounting.
+   */
+  snapshot() {
+    return {pendingBytes: this.pendingBytes, pendingFrames: this.pendingFrames}
+  }
+
+  /**
+   * Enqueues a delivery task.
+   * @param {Omit<DeliveryTask, "settle">} task - Task to enqueue.
+   * @returns {Promise<void>} - Task completion.
+   */
+  _enqueue(task) {
+    const promise = new Promise((resolve, reject) => {
+      this.tasks.push({
+        ...task,
+        settle: (error) => error ? reject(error) : resolve(undefined)
+      })
+    })
+
+    this._drain()
+    return promise
+  }
+
+  /**
+   * Starts the next task when idle.
+   * @returns {void} - No return value.
+   */
+  _drain() {
+    if (this.destroyed || this.activeTask) return
+
+    const task = this.tasks.shift()
+    if (!task) return
+
+    this.activeTask = task
+    void task.delivery().then(
+      () => this._finish(task),
+      (error) => this._finish(task, error)
+    )
+  }
+
+  /**
+   * Finishes the active delivery task.
+   * @param {DeliveryTask} task - Completed task.
+   * @param {Error} [error] - Delivery error.
+   * @returns {void}
+   */
+  _finish(task, error) {
+    if (this.destroyed || this.activeTask !== task) return
+
+    this.activeTask = undefined
+    if (task.countedFrame) {
+      this.pendingBytes -= task.byteLength
+      this.pendingFrames -= 1
+    }
+    task.settle(error)
+    this._drain()
+  }
+}

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

@@ -76,6 +76,15 @@ export default class ServerClient {
     })
   }
 
+  /**
+   * Immediately destroys the socket and all transport-owned write buffers.
+   * @param {Error} error - Destruction reason.
+   * @returns {void}
+   */
+  destroy(error) {
+    if (!this.socket.destroyed) this.socket.destroy(error)
+  }
+
   /**
    * On socket data.
    * @param {Buffer} chunk - Chunk.

package/src/http-server/websocket-event-log-store.js

@@ -4,11 +4,6 @@ import {randomUUID} from "crypto"
 import TableData from "../database/table-data/index.js"
 import Logger from "../logger.js"
 
-const EVENTS_TABLE = "websocket_channel_events"
-const REPLAY_CHANNELS_TABLE = "websocket_replay_channels"
-const DEFAULT_RETENTION_MS = 10 * 60 * 1000
-const stores = new WeakMap()
-
 /**
  * WebsocketEventRow type.
  * @typedef {object} WebsocketEventRow
@@ -18,12 +13,15 @@ const stores = new WeakMap()
  * @property {string} payload_json - Serialized payload.
  * @property {number | string} sequence - Sequence number.
  */
-
 /**
  * WebsocketReplayChannelRow type.
  * @typedef {object} WebsocketReplayChannelRow
  * @property {string} channel - Channel name.
  */
+const EVENTS_TABLE = "websocket_channel_events"
+const REPLAY_CHANNELS_TABLE = "websocket_replay_channels"
+const DEFAULT_RETENTION_MS = 10 * 60 * 1000
+const stores = new WeakMap()
 
 /**
  * Runs the websocketEventLogStoreForConfiguration helper.

package/src/http-server/websocket-events-host.js

@@ -8,6 +8,10 @@ export class VelociousHttpServerWebsocketEventsHost {
      * Narrows the runtime value to the documented type.
      * @type {Set<import("./worker-handler/index.js").default>} */
     this.handlers = new Set()
+    /**
+     * Broadcast handlers grouped by the configuration that owns them.
+     * @type {Map<import("../configuration.js").default, Set<import("./worker-handler/index.js").default>>} */
+    this.broadcastHandlersByConfiguration = new Map()
     this.publishQueue = Promise.resolve()
   }
 
@@ -30,8 +34,23 @@ export class VelociousHttpServerWebsocketEventsHost {
    */
   register(handler) {
     this.handlers.add(handler)
+    let configurationHandlers = this.broadcastHandlersByConfiguration.get(handler.configuration)
+
+    if (!configurationHandlers) {
+      configurationHandlers = new Set()
+      this.broadcastHandlersByConfiguration.set(handler.configuration, configurationHandlers)
+    }
+
+    configurationHandlers.add(handler)
+
+    return () => {
+      this.handlers.delete(handler)
+      configurationHandlers.delete(handler)
 
-    return () => this.handlers.delete(handler)
+      if (configurationHandlers.size === 0) {
+        this.broadcastHandlersByConfiguration.delete(handler.configuration)
+      }
+    }
   }
 
   /**
@@ -69,17 +88,24 @@ export class VelociousHttpServerWebsocketEventsHost {
    * @param {string} args.channel - Channel name.
    * @param {Record<string, ?>} args.broadcastParams - Routing filter params.
    * @param {?} args.body - Message body.
+   * @param {import("../configuration.js").default} args.configuration - Originating configuration.
    * @returns {void}
    */
-  broadcastV2({body, broadcastParams, channel}) {
+  broadcastV2({body, broadcastParams, channel, configuration}) {
     // Chain onto publishQueue so persistence completes before
     // the next broadcast — without this, a subscriber that connects
     // immediately after a broadcast could miss the just-persisted
     // event when replaying from lastEventId on a slow DB.
     this._queuePublish(async () => {
-      const persistedEvent = await this._persistV2EventIfNeeded({body, channel})
+      const persistedEvent = await this._persistV2EventIfNeeded({body, channel, configuration})
+      const dispatchedTargets = new Set()
 
-      for (const handler of this.handlers) {
+      for (const handler of this.broadcastHandlersByConfiguration.get(configuration) || []) {
+        const dispatchKey = handler.websocketV2BroadcastDispatchKey()
+
+        if (dispatchedTargets.has(dispatchKey)) continue
+
+        dispatchedTargets.add(dispatchKey)
         handler.dispatchWebsocketV2Broadcast({
           body,
           broadcastParams,
@@ -88,18 +114,19 @@ export class VelociousHttpServerWebsocketEventsHost {
           createdAt: persistedEvent?.createdAt
         })
       }
-    }, "Failed to persist/broadcast V2 event")
+    }, "Failed to persist/broadcast V2 event", configuration)
   }
 
   /**
    * Runs queue publish.
    * @param {() => Promise<void>} callback - Publish work to run in order.
    * @param {string} errorMessage - Message logged when publish work fails.
+   * @param {import("../configuration.js").default} [originatingConfiguration] - Configuration whose context owns the work.
    * @returns {void}
    */
-  _queuePublish(callback, errorMessage) {
+  _queuePublish(callback, errorMessage, originatingConfiguration) {
     const handler = this.handlers.values().next().value
-    const configuration = handler?.configuration
+    const configuration = originatingConfiguration || handler?.configuration
 
     this.publishQueue = this.publishQueue
       .then(async () => {
@@ -120,10 +147,11 @@ export class VelociousHttpServerWebsocketEventsHost {
    * @param {object} args - Options.
    * @param {?} args.body - Event body.
    * @param {string} args.channel - Channel name.
+   * @param {import("../configuration.js").default} args.configuration - Originating configuration.
    * @returns {Promise<{createdAt: string, id: string} | null>} - Persisted event metadata when storage is enabled.
    */
-  async _persistV2EventIfNeeded({body, channel}) {
-    return await this._persistChannelEventIfNeeded({channel, payload: body})
+  async _persistV2EventIfNeeded({body, channel, configuration}) {
+    return await this._persistChannelEventIfNeeded({channel, payload: body, configuration})
   }
 
   /**
@@ -142,14 +170,16 @@ export class VelociousHttpServerWebsocketEventsHost {
    * @param {object} args - Options object.
    * @param {string} args.channel - Channel name.
    * @param {?} args.payload - Payload data.
+   * @param {import("../configuration.js").default} [args.configuration] - Configuration owning the event store.
    * @returns {Promise<{createdAt: string, id: string} | null>} - Persisted event metadata.
    */
-  async _persistChannelEventIfNeeded({channel, payload}) {
+  async _persistChannelEventIfNeeded({channel, payload, configuration}) {
     const handler = this.handlers.values().next().value
+    const eventConfiguration = configuration || handler?.configuration
 
-    if (!handler?.configuration) return null
+    if (!eventConfiguration) return null
 
-    const websocketEventLogStore = websocketEventLogStoreForConfiguration(handler.configuration)
+    const websocketEventLogStore = websocketEventLogStoreForConfiguration(eventConfiguration)
     const shouldPersist = await websocketEventLogStore.shouldPersistChannel(channel)
 
     if (!shouldPersist) return null