velocious 1.0.396 → 1.0.398

package/build/src/http-server/websocket-channel.d.ts

@@ -1,3 +1,9 @@
+/**
+ * @typedef {null | boolean | number | string | object} WebsocketJsonValue
+ */
+/**
+ * @typedef {Record<string, WebsocketJsonValue>} WebsocketParams
+ */
 /**
  * Base class for app-defined 1:N pub/sub channels.
  *
@@ -10,16 +16,16 @@ export default class VelociousWebsocketChannel {
     /**
      * @param {object} args
      * @param {string} args.subscriptionId - Client-assigned id, unique within the session.
-     * @param {Record<string, any>} args.params - Subscribe params.
+     * @param {WebsocketParams} args.params - Subscribe params.
      * @param {import("./client/websocket-session.js").default} args.session - Owning session.
      */
     constructor({ subscriptionId, params, session }: {
         subscriptionId: string;
-        params: Record<string, any>;
+        params: WebsocketParams;
         session: import("./client/websocket-session.js").default;
     });
     subscriptionId: string;
-    params: Record<string, any>;
+    params: WebsocketParams;
     session: import("./client/websocket-session.js").default;
     _closed: boolean;
     /**
@@ -66,33 +72,47 @@ export default class VelociousWebsocketChannel {
      * sign-in / locale change). Override to react to session-level
      * metadata updates.
      *
-     * @param {Record<string, any>} _metadata - Updated metadata.
+     * @param {WebsocketParams} _metadata - Updated metadata.
      * @returns {void | Promise<void>}
      */
-    onMetadataChanged(_metadata: Record<string, any>): void | Promise<void>;
+    onMetadataChanged(_metadata: WebsocketParams): void | Promise<void>;
     /**
      * Broadcast routing filter. Called by `broadcastToChannel` for
      * each live subscription — returning true delivers the body via
      * `sendMessage`. Default matches all broadcasts regardless of
      * params; override for per-subscriber filtering.
      *
-     * @param {...any} _broadcastArgs - Params forwarded from `broadcastToChannel` (ignored by default).
+     * @param {...WebsocketJsonValue} _broadcastArgs - Params forwarded from `broadcastToChannel` (ignored by default).
      * @returns {boolean} - True to deliver the broadcast to this subscriber.
      */
-    matches(..._broadcastArgs: any[]): boolean;
+    matches(..._broadcastArgs: WebsocketJsonValue[]): boolean;
+    /**
+     * Delivers a matched broadcast to this subscriber. Subclasses can
+     * override when the outbound body must be tailored to subscription
+     * params before sending.
+     *
+     * @param {WebsocketJsonValue} body
+     * @param {{eventId?: string}} [meta] - Optional event metadata.
+     * @returns {void | Promise<void>}
+     */
+    deliverBroadcast(body: WebsocketJsonValue, meta?: {
+        eventId?: string;
+    }): void | Promise<void>;
     /**
      * Sends a `channel-message` frame to THIS subscriber only.
      * When `meta.eventId` is provided, the client receives it so it
      * can track its checkpoint for `lastEventId` replay on reconnect.
      *
-     * @param {any} body
+     * @param {WebsocketJsonValue} body
      * @param {{eventId?: string}} [meta] - Optional event metadata.
      * @returns {void}
      */
-    sendMessage(body: any, meta?: {
+    sendMessage(body: WebsocketJsonValue, meta?: {
         eventId?: string;
     }): void;
     /** @returns {boolean} */
     isClosed(): boolean;
 }
+export type WebsocketJsonValue = null | boolean | number | string | object;
+export type WebsocketParams = Record<string, WebsocketJsonValue>;
 //# sourceMappingURL=websocket-channel.d.ts.map

package/build/src/http-server/websocket-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket-channel.d.ts","sourceRoot":"","sources":["../../../src/http-server/websocket-channel.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH;IACE;;;;;OAKG;IACH,iDAJG;QAAqB,cAAc,EAA3B,MAAM;QACoB,MAAM,EAAhC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;QACmC,OAAO,EAA7D,OAAO,+BAA+B,EAAE,OAAO;KACzD,EAMA;IAJC,uBAAoC;IACpC,4BAA0B;IAC1B,yDAAsB;IACtB,iBAAoB;IAGtB;;;;;;OAMG;IACH,gBAFa,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAER;IAE/B;;;;;;OAMG;IACH,cAFa,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAElB;IAEf;;;;;OAKG;IACH,gBAFa,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB;IAEjB;;;;;;;OAOG;IACH,gBAFa,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB;IAEjB;;;;;OAKG;IACH,YAFa,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpB;IAEb;;;;;;;OAOG;IACH,6BAHW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACjB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAEF;IAE/B;;;;;;;;OAQG;IACH,2BAHc,GAAG,EAAA,GACJ,OAAO,CAEsB;IAE1C;;;;;;;;OAQG;IACH,kBAJW,GAAG,SACH;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC,GAChB,IAAI,CAahB;IAED,yBAAyB;IACzB,YADc,OAAO,CACa;CACnC"}
+{"version":3,"file":"websocket-channel.d.ts","sourceRoot":"","sources":["../../../src/http-server/websocket-channel.js"],"names":[],"mappings":"AAEA;;GAEG;AACH;;GAEG;AAEH;;;;;;;GAOG;AACH;IACE;;;;;OAKG;IACH,iDAJG;QAAqB,cAAc,EAA3B,MAAM;QACgB,MAAM,EAA5B,eAAe;QACuC,OAAO,EAA7D,OAAO,+BAA+B,EAAE,OAAO;KACzD,EAMA;IAJC,uBAAoC;IACpC,wBAA0B;IAC1B,yDAAsB;IACtB,iBAAoB;IAGtB;;;;;;OAMG;IACH,gBAFa,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAER;IAE/B;;;;;;OAMG;IACH,cAFa,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAElB;IAEf;;;;;OAKG;IACH,gBAFa,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB;IAEjB;;;;;;;OAOG;IACH,gBAFa,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB;IAEjB;;;;;OAKG;IACH,YAFa,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpB;IAEb;;;;;;;OAOG;IACH,6BAHW,eAAe,GACb,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAEF;IAE/B;;;;;;;;OAQG;IACH,2BAHc,kBAAkB,EAAA,GACnB,OAAO,CAEsB;IAE1C;;;;;;;;OAQG;IACH,uBAJW,kBAAkB,SAClB;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC,GAChB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhC;IAED;;;;;;;;OAQG;IACH,kBAJW,kBAAkB,SAClB;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC,GAChB,IAAI,CAahB;IAED,yBAAyB;IACzB,YADc,OAAO,CACa;CACnC;iCAlIY,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;8BAGzC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC"}

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

@@ -1,4 +1,10 @@
 // @ts-check
+/**
+ * @typedef {null | boolean | number | string | object} WebsocketJsonValue
+ */
+/**
+ * @typedef {Record<string, WebsocketJsonValue>} WebsocketParams
+ */
 /**
  * Base class for app-defined 1:N pub/sub channels.
  *
@@ -11,7 +17,7 @@ export default class VelociousWebsocketChannel {
     /**
      * @param {object} args
      * @param {string} args.subscriptionId - Client-assigned id, unique within the session.
-     * @param {Record<string, any>} args.params - Subscribe params.
+     * @param {WebsocketParams} args.params - Subscribe params.
      * @param {import("./client/websocket-session.js").default} args.session - Owning session.
      */
     constructor({ subscriptionId, params, session }) {
@@ -64,7 +70,7 @@ export default class VelociousWebsocketChannel {
      * sign-in / locale change). Override to react to session-level
      * metadata updates.
      *
-     * @param {Record<string, any>} _metadata - Updated metadata.
+     * @param {WebsocketParams} _metadata - Updated metadata.
      * @returns {void | Promise<void>}
      */
     onMetadataChanged(_metadata) { }
@@ -74,16 +80,28 @@ export default class VelociousWebsocketChannel {
      * `sendMessage`. Default matches all broadcasts regardless of
      * params; override for per-subscriber filtering.
      *
-     * @param {...any} _broadcastArgs - Params forwarded from `broadcastToChannel` (ignored by default).
+     * @param {...WebsocketJsonValue} _broadcastArgs - Params forwarded from `broadcastToChannel` (ignored by default).
      * @returns {boolean} - True to deliver the broadcast to this subscriber.
      */
     matches(..._broadcastArgs) { return true; }
+    /**
+     * Delivers a matched broadcast to this subscriber. Subclasses can
+     * override when the outbound body must be tailored to subscription
+     * params before sending.
+     *
+     * @param {WebsocketJsonValue} body
+     * @param {{eventId?: string}} [meta] - Optional event metadata.
+     * @returns {void | Promise<void>}
+     */
+    deliverBroadcast(body, meta) {
+        this.sendMessage(body, meta);
+    }
     /**
      * Sends a `channel-message` frame to THIS subscriber only.
      * When `meta.eventId` is provided, the client receives it so it
      * can track its checkpoint for `lastEventId` replay on reconnect.
      *
-     * @param {any} body
+     * @param {WebsocketJsonValue} body
      * @param {{eventId?: string}} [meta] - Optional event metadata.
      * @returns {void}
      */
@@ -101,4 +119,4 @@ export default class VelociousWebsocketChannel {
     /** @returns {boolean} */
     isClosed() { return this._closed; }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2Vic29ja2V0LWNoYW5uZWwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvaHR0cC1zZXJ2ZXIvd2Vic29ja2V0LWNoYW5uZWwuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLENBQUMsT0FBTyxPQUFPLHlCQUF5QjtJQUM1Qzs7Ozs7T0FLRztJQUNILFlBQVksRUFBQyxjQUFjLEVBQUUsTUFBTSxFQUFFLE9BQU8sRUFBQztRQUMzQyxJQUFJLENBQUMsY0FBYyxHQUFHLGNBQWMsQ0FBQTtRQUNwQyxJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sSUFBSSxFQUFFLENBQUE7UUFDMUIsSUFBSSxDQUFDLE9BQU8sR0FBRyxPQUFPLENBQUE7UUFDdEIsSUFBSSxDQUFDLE9BQU8sR0FBRyxLQUFLLENBQUE7SUFDdEIsQ0FBQztJQUVEOzs7Ozs7T0FNRztJQUNILFlBQVksS0FBSyxPQUFPLEtBQUssQ0FBQSxDQUFDLENBQUM7SUFFL0I7Ozs7OztPQU1HO0lBQ0gsVUFBVSxLQUFJLENBQUM7SUFFZjs7Ozs7T0FLRztJQUNILFlBQVksS0FBSSxDQUFDO0lBRWpCOzs7Ozs7O09BT0c7SUFDSCxZQUFZLEtBQUksQ0FBQztJQUVqQjs7Ozs7T0FLRztJQUNILFFBQVEsS0FBSSxDQUFDO0lBRWI7Ozs7Ozs7T0FPRztJQUNILGlCQUFpQixDQUFDLFNBQVMsSUFBRyxDQUFDO0lBRS9COzs7Ozs7OztPQVFHO0lBQ0gsT0FBTyxDQUFDLEdBQUcsY0FBYyxJQUFJLE9BQU8sSUFBSSxDQUFBLENBQUMsQ0FBQztJQUUxQzs7Ozs7Ozs7T0FRRztJQUNILFdBQVcsQ0FBQyxJQUFJLEVBQUUsSUFBSTtRQUNwQixJQUFJLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUNqQixNQUFNLElBQUksS0FBSyxDQUFDLDZDQUE2QyxJQUFJLENBQUMsY0FBYyxFQUFFLENBQUMsQ0FBQTtRQUNyRixDQUFDO1FBRUQsSUFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUM7WUFDcEIsSUFBSSxFQUFFLGlCQUFpQjtZQUN2QixjQUFjLEVBQUUsSUFBSSxDQUFDLGNBQWM7WUFDbkMsSUFBSTtZQUNKLEdBQUcsQ0FBQyxJQUFJLEVBQUUsT0FBTyxDQUFDLENBQUMsQ0FBQyxFQUFDLE9BQU8sRUFBRSxJQUFJLENBQUMsT0FBTyxFQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztTQUNsRCxDQUFDLENBQUE7SUFDSixDQUFDO0lBRUQseUJBQXlCO0lBQ3pCLFFBQVEsS0FBSyxPQUFPLElBQUksQ0FBQyxPQUFPLENBQUEsQ0FBQyxDQUFDO0NBQ25DIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQHRzLWNoZWNrXG5cbi8qKlxuICogQmFzZSBjbGFzcyBmb3IgYXBwLWRlZmluZWQgMTpOIHB1Yi9zdWIgY2hhbm5lbHMuXG4gKlxuICogU3ViY2xhc3NlcyBvdmVycmlkZTpcbiAqICAtIGBjYW5TdWJzY3JpYmUoKWAg4oCUIHN1YnNjcmliZS10aW1lIGF1dGggKGRlZmF1bHQgYGZhbHNlYCkuXG4gKiAgLSBgc3Vic2NyaWJlZCgpYCAvIGB1bnN1YnNjcmliZWQoKWAg4oCUIG9wdGlvbmFsIGxpZmVjeWNsZSBob29rcy5cbiAqICAtIGBtYXRjaGVzKGJyb2FkY2FzdFBhcmFtcylgIOKAlCBicm9hZGNhc3Qgcm91dGluZyBmaWx0ZXIuXG4gKi9cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIFZlbG9jaW91c1dlYnNvY2tldENoYW5uZWwge1xuICAvKipcbiAgICogQHBhcmFtIHtvYmplY3R9IGFyZ3NcbiAgICogQHBhcmFtIHtzdHJpbmd9IGFyZ3Muc3Vic2NyaXB0aW9uSWQgLSBDbGllbnQtYXNzaWduZWQgaWQsIHVuaXF1ZSB3aXRoaW4gdGhlIHNlc3Npb24uXG4gICAqIEBwYXJhbSB7UmVjb3JkPHN0cmluZywgYW55Pn0gYXJncy5wYXJhbXMgLSBTdWJzY3JpYmUgcGFyYW1zLlxuICAgKiBAcGFyYW0ge2ltcG9ydChcIi4vY2xpZW50L3dlYnNvY2tldC1zZXNzaW9uLmpzXCIpLmRlZmF1bHR9IGFyZ3Muc2Vzc2lvbiAtIE93bmluZyBzZXNzaW9uLlxuICAgKi9cbiAgY29uc3RydWN0b3Ioe3N1YnNjcmlwdGlvbklkLCBwYXJhbXMsIHNlc3Npb259KSB7XG4gICAgdGhpcy5zdWJzY3JpcHRpb25JZCA9IHN1YnNjcmlwdGlvbklkXG4gICAgdGhpcy5wYXJhbXMgPSBwYXJhbXMgfHwge31cbiAgICB0aGlzLnNlc3Npb24gPSBzZXNzaW9uXG4gICAgdGhpcy5fY2xvc2VkID0gZmFsc2VcbiAgfVxuXG4gIC8qKlxuICAgKiBTdWJzY3JpYmUtdGltZSBhdXRoLiBEZWZhdWx0IGlzIGBmYWxzZWAgKGRlbnkpLiBDaGFubmVsIGF1dGhvcnNcbiAgICogTVVTVCBvdmVycmlkZSB0byBhbGxvdyBzdWJzY3JpcHRpb25zLiBSZXR1cm5pbmcgYSBQcm9taXNlIGRlZmVyc1xuICAgKiB0aGUgYGNoYW5uZWwtc3Vic2NyaWJlZGAgY29uZmlybWF0aW9uIHVudGlsIGl0IHJlc29sdmVzLlxuICAgKlxuICAgKiBAcmV0dXJucyB7Ym9vbGVhbiB8IFByb21pc2U8Ym9vbGVhbj59XG4gICAqL1xuICBjYW5TdWJzY3JpYmUoKSB7IHJldHVybiBmYWxzZSB9XG5cbiAgLyoqXG4gICAqIE9wdGlvbmFsIOKAlCBjYWxsZWQgb25jZSBhZnRlciBgY2FuU3Vic2NyaWJlYCByZXNvbHZlcyB0cnV0aHkgYW5kXG4gICAqIGJlZm9yZSBgY2hhbm5lbC1zdWJzY3JpYmVkYCBpcyBzZW50IHRvIHRoZSBjbGllbnQuIFVzZSBmb3JcbiAgICogaW5pdGlhbCBzbmFwc2hvdCBkZWxpdmVyeS5cbiAgICpcbiAgICogQHJldHVybnMge3ZvaWQgfCBQcm9taXNlPHZvaWQ+fVxuICAgKi9cbiAgc3Vic2NyaWJlZCgpIHt9XG5cbiAgLyoqXG4gICAqIE9wdGlvbmFsIOKAlCBjYWxsZWQgb25jZSB3aGVuIHRoZSBzdWJzY3JpcHRpb24gZW5kcy4gRmlyZXMgb25cbiAgICogY2xpZW50LWluaXRpYXRlZCBgY2hhbm5lbC11bnN1YnNjcmliZWAgb3Igb24gc2Vzc2lvbiB0ZWFyZG93bi5cbiAgICpcbiAgICogQHJldHVybnMge3ZvaWQgfCBQcm9taXNlPHZvaWQ+fVxuICAgKi9cbiAgdW5zdWJzY3JpYmVkKCkge31cblxuICAvKipcbiAgICogQ2FsbGVkIHdoZW4gdGhlIHVuZGVybHlpbmcgc29ja2V0IGRyb3BzIGFuZCB0aGUgc2Vzc2lvbiBpc1xuICAgKiBtb3ZlZCBpbnRvIHRoZSBwYXVzZWQvZ3JhY2UgcmVnaXN0cnkuIEVpdGhlciBgb25SZXN1bWVgIGZpcmVzXG4gICAqIG9uIHN1Y2Nlc3NmdWwgY2xpZW50IHJlY29ubmVjdCwgb3IgYHVuc3Vic2NyaWJlZCgpYCBmaXJlcyB3aGVuXG4gICAqIHRoZSBncmFjZSB3aW5kb3cgZXhwaXJlcy5cbiAgICpcbiAgICogQHJldHVybnMge3ZvaWQgfCBQcm9taXNlPHZvaWQ+fVxuICAgKi9cbiAgb25EaXNjb25uZWN0KCkge31cblxuICAvKipcbiAgICogQ2FsbGVkIGFmdGVyIGEgY2xpZW50IHJlY29ubmVjdCArIGBzZXNzaW9uLXJlc3VtZWAgcmViaW5kcyB0aGlzXG4gICAqIHN1YnNjcmlwdGlvbiB0byBhIG5ldyBzb2NrZXQuXG4gICAqXG4gICAqIEByZXR1cm5zIHt2b2lkIHwgUHJvbWlzZTx2b2lkPn1cbiAgICovXG4gIG9uUmVzdW1lKCkge31cblxuICAvKipcbiAgICogQ2FsbGVkIHdoZW4gdGhlIGNsaWVudCBzZW5kcyB1cGRhdGVkIG1ldGFkYXRhIChlLmcuIGFmdGVyXG4gICAqIHNpZ24taW4gLyBsb2NhbGUgY2hhbmdlKS4gT3ZlcnJpZGUgdG8gcmVhY3QgdG8gc2Vzc2lvbi1sZXZlbFxuICAgKiBtZXRhZGF0YSB1cGRhdGVzLlxuICAgKlxuICAgKiBAcGFyYW0ge1JlY29yZDxzdHJpbmcsIGFueT59IF9tZXRhZGF0YSAtIFVwZGF0ZWQgbWV0YWRhdGEuXG4gICAqIEByZXR1cm5zIHt2b2lkIHwgUHJvbWlzZTx2b2lkPn1cbiAgICovXG4gIG9uTWV0YWRhdGFDaGFuZ2VkKF9tZXRhZGF0YSkge31cblxuICAvKipcbiAgICogQnJvYWRjYXN0IHJvdXRpbmcgZmlsdGVyLiBDYWxsZWQgYnkgYGJyb2FkY2FzdFRvQ2hhbm5lbGAgZm9yXG4gICAqIGVhY2ggbGl2ZSBzdWJzY3JpcHRpb24g4oCUIHJldHVybmluZyB0cnVlIGRlbGl2ZXJzIHRoZSBib2R5IHZpYVxuICAgKiBgc2VuZE1lc3NhZ2VgLiBEZWZhdWx0IG1hdGNoZXMgYWxsIGJyb2FkY2FzdHMgcmVnYXJkbGVzcyBvZlxuICAgKiBwYXJhbXM7IG92ZXJyaWRlIGZvciBwZXItc3Vic2NyaWJlciBmaWx0ZXJpbmcuXG4gICAqXG4gICAqIEBwYXJhbSB7Li4uYW55fSBfYnJvYWRjYXN0QXJncyAtIFBhcmFtcyBmb3J3YXJkZWQgZnJvbSBgYnJvYWRjYXN0VG9DaGFubmVsYCAoaWdub3JlZCBieSBkZWZhdWx0KS5cbiAgICogQHJldHVybnMge2Jvb2xlYW59IC0gVHJ1ZSB0byBkZWxpdmVyIHRoZSBicm9hZGNhc3QgdG8gdGhpcyBzdWJzY3JpYmVyLlxuICAgKi9cbiAgbWF0Y2hlcyguLi5fYnJvYWRjYXN0QXJncykgeyByZXR1cm4gdHJ1ZSB9XG5cbiAgLyoqXG4gICAqIFNlbmRzIGEgYGNoYW5uZWwtbWVzc2FnZWAgZnJhbWUgdG8gVEhJUyBzdWJzY3JpYmVyIG9ubHkuXG4gICAqIFdoZW4gYG1ldGEuZXZlbnRJZGAgaXMgcHJvdmlkZWQsIHRoZSBjbGllbnQgcmVjZWl2ZXMgaXQgc28gaXRcbiAgICogY2FuIHRyYWNrIGl0cyBjaGVja3BvaW50IGZvciBgbGFzdEV2ZW50SWRgIHJlcGxheSBvbiByZWNvbm5lY3QuXG4gICAqXG4gICAqIEBwYXJhbSB7YW55fSBib2R5XG4gICAqIEBwYXJhbSB7e2V2ZW50SWQ/OiBzdHJpbmd9fSBbbWV0YV0gLSBPcHRpb25hbCBldmVudCBtZXRhZGF0YS5cbiAgICogQHJldHVybnMge3ZvaWR9XG4gICAqL1xuICBzZW5kTWVzc2FnZShib2R5LCBtZXRhKSB7XG4gICAgaWYgKHRoaXMuX2Nsb3NlZCkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKGBDYW5ub3Qgc2VuZE1lc3NhZ2Ugb24gY2xvc2VkIHN1YnNjcmlwdGlvbiAke3RoaXMuc3Vic2NyaXB0aW9uSWR9YClcbiAgICB9XG5cbiAgICB0aGlzLnNlc3Npb24uc2VuZEpzb24oe1xuICAgICAgdHlwZTogXCJjaGFubmVsLW1lc3NhZ2VcIixcbiAgICAgIHN1YnNjcmlwdGlvbklkOiB0aGlzLnN1YnNjcmlwdGlvbklkLFxuICAgICAgYm9keSxcbiAgICAgIC4uLihtZXRhPy5ldmVudElkID8ge2V2ZW50SWQ6IG1ldGEuZXZlbnRJZH0gOiB7fSlcbiAgICB9KVxuICB9XG5cbiAgLyoqIEByZXR1cm5zIHtib29sZWFufSAqL1xuICBpc0Nsb3NlZCgpIHsgcmV0dXJuIHRoaXMuX2Nsb3NlZCB9XG59XG4iXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2Vic29ja2V0LWNoYW5uZWwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvaHR0cC1zZXJ2ZXIvd2Vic29ja2V0LWNoYW5uZWwuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaOztHQUVHO0FBQ0g7O0dBRUc7QUFFSDs7Ozs7OztHQU9HO0FBQ0gsTUFBTSxDQUFDLE9BQU8sT0FBTyx5QkFBeUI7SUFDNUM7Ozs7O09BS0c7SUFDSCxZQUFZLEVBQUMsY0FBYyxFQUFFLE1BQU0sRUFBRSxPQUFPLEVBQUM7UUFDM0MsSUFBSSxDQUFDLGNBQWMsR0FBRyxjQUFjLENBQUE7UUFDcEMsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLElBQUksRUFBRSxDQUFBO1FBQzFCLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFBO1FBQ3RCLElBQUksQ0FBQyxPQUFPLEdBQUcsS0FBSyxDQUFBO0lBQ3RCLENBQUM7SUFFRDs7Ozs7O09BTUc7SUFDSCxZQUFZLEtBQUssT0FBTyxLQUFLLENBQUEsQ0FBQyxDQUFDO0lBRS9COzs7Ozs7T0FNRztJQUNILFVBQVUsS0FBSSxDQUFDO0lBRWY7Ozs7O09BS0c7SUFDSCxZQUFZLEtBQUksQ0FBQztJQUVqQjs7Ozs7OztPQU9HO0lBQ0gsWUFBWSxLQUFJLENBQUM7SUFFakI7Ozs7O09BS0c7SUFDSCxRQUFRLEtBQUksQ0FBQztJQUViOzs7Ozs7O09BT0c7SUFDSCxpQkFBaUIsQ0FBQyxTQUFTLElBQUcsQ0FBQztJQUUvQjs7Ozs7Ozs7T0FRRztJQUNILE9BQU8sQ0FBQyxHQUFHLGNBQWMsSUFBSSxPQUFPLElBQUksQ0FBQSxDQUFDLENBQUM7SUFFMUM7Ozs7Ozs7O09BUUc7SUFDSCxnQkFBZ0IsQ0FBQyxJQUFJLEVBQUUsSUFBSTtRQUN6QixJQUFJLENBQUMsV0FBVyxDQUFDLElBQUksRUFBRSxJQUFJLENBQUMsQ0FBQTtJQUM5QixDQUFDO0lBRUQ7Ozs7Ozs7O09BUUc7SUFDSCxXQUFXLENBQUMsSUFBSSxFQUFFLElBQUk7UUFDcEIsSUFBSSxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUM7WUFDakIsTUFBTSxJQUFJLEtBQUssQ0FBQyw2Q0FBNkMsSUFBSSxDQUFDLGNBQWMsRUFBRSxDQUFDLENBQUE7UUFDckYsQ0FBQztRQUVELElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDO1lBQ3BCLElBQUksRUFBRSxpQkFBaUI7WUFDdkIsY0FBYyxFQUFFLElBQUksQ0FBQyxjQUFjO1lBQ25DLElBQUk7WUFDSixHQUFHLENBQUMsSUFBSSxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUMsRUFBQyxPQUFPLEVBQUUsSUFBSSxDQUFDLE9BQU8sRUFBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7U0FDbEQsQ0FBQyxDQUFBO0lBQ0osQ0FBQztJQUVELHlCQUF5QjtJQUN6QixRQUFRLEtBQUssT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFBLENBQUMsQ0FBQztDQUNuQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG4vKipcbiAqIEB0eXBlZGVmIHtudWxsIHwgYm9vbGVhbiB8IG51bWJlciB8IHN0cmluZyB8IG9iamVjdH0gV2Vic29ja2V0SnNvblZhbHVlXG4gKi9cbi8qKlxuICogQHR5cGVkZWYge1JlY29yZDxzdHJpbmcsIFdlYnNvY2tldEpzb25WYWx1ZT59IFdlYnNvY2tldFBhcmFtc1xuICovXG5cbi8qKlxuICogQmFzZSBjbGFzcyBmb3IgYXBwLWRlZmluZWQgMTpOIHB1Yi9zdWIgY2hhbm5lbHMuXG4gKlxuICogU3ViY2xhc3NlcyBvdmVycmlkZTpcbiAqICAtIGBjYW5TdWJzY3JpYmUoKWAg4oCUIHN1YnNjcmliZS10aW1lIGF1dGggKGRlZmF1bHQgYGZhbHNlYCkuXG4gKiAgLSBgc3Vic2NyaWJlZCgpYCAvIGB1bnN1YnNjcmliZWQoKWAg4oCUIG9wdGlvbmFsIGxpZmVjeWNsZSBob29rcy5cbiAqICAtIGBtYXRjaGVzKGJyb2FkY2FzdFBhcmFtcylgIOKAlCBicm9hZGNhc3Qgcm91dGluZyBmaWx0ZXIuXG4gKi9cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIFZlbG9jaW91c1dlYnNvY2tldENoYW5uZWwge1xuICAvKipcbiAgICogQHBhcmFtIHtvYmplY3R9IGFyZ3NcbiAgICogQHBhcmFtIHtzdHJpbmd9IGFyZ3Muc3Vic2NyaXB0aW9uSWQgLSBDbGllbnQtYXNzaWduZWQgaWQsIHVuaXF1ZSB3aXRoaW4gdGhlIHNlc3Npb24uXG4gICAqIEBwYXJhbSB7V2Vic29ja2V0UGFyYW1zfSBhcmdzLnBhcmFtcyAtIFN1YnNjcmliZSBwYXJhbXMuXG4gICAqIEBwYXJhbSB7aW1wb3J0KFwiLi9jbGllbnQvd2Vic29ja2V0LXNlc3Npb24uanNcIikuZGVmYXVsdH0gYXJncy5zZXNzaW9uIC0gT3duaW5nIHNlc3Npb24uXG4gICAqL1xuICBjb25zdHJ1Y3Rvcih7c3Vic2NyaXB0aW9uSWQsIHBhcmFtcywgc2Vzc2lvbn0pIHtcbiAgICB0aGlzLnN1YnNjcmlwdGlvbklkID0gc3Vic2NyaXB0aW9uSWRcbiAgICB0aGlzLnBhcmFtcyA9IHBhcmFtcyB8fCB7fVxuICAgIHRoaXMuc2Vzc2lvbiA9IHNlc3Npb25cbiAgICB0aGlzLl9jbG9zZWQgPSBmYWxzZVxuICB9XG5cbiAgLyoqXG4gICAqIFN1YnNjcmliZS10aW1lIGF1dGguIERlZmF1bHQgaXMgYGZhbHNlYCAoZGVueSkuIENoYW5uZWwgYXV0aG9yc1xuICAgKiBNVVNUIG92ZXJyaWRlIHRvIGFsbG93IHN1YnNjcmlwdGlvbnMuIFJldHVybmluZyBhIFByb21pc2UgZGVmZXJzXG4gICAqIHRoZSBgY2hhbm5lbC1zdWJzY3JpYmVkYCBjb25maXJtYXRpb24gdW50aWwgaXQgcmVzb2x2ZXMuXG4gICAqXG4gICAqIEByZXR1cm5zIHtib29sZWFuIHwgUHJvbWlzZTxib29sZWFuPn1cbiAgICovXG4gIGNhblN1YnNjcmliZSgpIHsgcmV0dXJuIGZhbHNlIH1cblxuICAvKipcbiAgICogT3B0aW9uYWwg4oCUIGNhbGxlZCBvbmNlIGFmdGVyIGBjYW5TdWJzY3JpYmVgIHJlc29sdmVzIHRydXRoeSBhbmRcbiAgICogYmVmb3JlIGBjaGFubmVsLXN1YnNjcmliZWRgIGlzIHNlbnQgdG8gdGhlIGNsaWVudC4gVXNlIGZvclxuICAgKiBpbml0aWFsIHNuYXBzaG90IGRlbGl2ZXJ5LlxuICAgKlxuICAgKiBAcmV0dXJucyB7dm9pZCB8IFByb21pc2U8dm9pZD59XG4gICAqL1xuICBzdWJzY3JpYmVkKCkge31cblxuICAvKipcbiAgICogT3B0aW9uYWwg4oCUIGNhbGxlZCBvbmNlIHdoZW4gdGhlIHN1YnNjcmlwdGlvbiBlbmRzLiBGaXJlcyBvblxuICAgKiBjbGllbnQtaW5pdGlhdGVkIGBjaGFubmVsLXVuc3Vic2NyaWJlYCBvciBvbiBzZXNzaW9uIHRlYXJkb3duLlxuICAgKlxuICAgKiBAcmV0dXJucyB7dm9pZCB8IFByb21pc2U8dm9pZD59XG4gICAqL1xuICB1bnN1YnNjcmliZWQoKSB7fVxuXG4gIC8qKlxuICAgKiBDYWxsZWQgd2hlbiB0aGUgdW5kZXJseWluZyBzb2NrZXQgZHJvcHMgYW5kIHRoZSBzZXNzaW9uIGlzXG4gICAqIG1vdmVkIGludG8gdGhlIHBhdXNlZC9ncmFjZSByZWdpc3RyeS4gRWl0aGVyIGBvblJlc3VtZWAgZmlyZXNcbiAgICogb24gc3VjY2Vzc2Z1bCBjbGllbnQgcmVjb25uZWN0LCBvciBgdW5zdWJzY3JpYmVkKClgIGZpcmVzIHdoZW5cbiAgICogdGhlIGdyYWNlIHdpbmRvdyBleHBpcmVzLlxuICAgKlxuICAgKiBAcmV0dXJucyB7dm9pZCB8IFByb21pc2U8dm9pZD59XG4gICAqL1xuICBvbkRpc2Nvbm5lY3QoKSB7fVxuXG4gIC8qKlxuICAgKiBDYWxsZWQgYWZ0ZXIgYSBjbGllbnQgcmVjb25uZWN0ICsgYHNlc3Npb24tcmVzdW1lYCByZWJpbmRzIHRoaXNcbiAgICogc3Vic2NyaXB0aW9uIHRvIGEgbmV3IHNvY2tldC5cbiAgICpcbiAgICogQHJldHVybnMge3ZvaWQgfCBQcm9taXNlPHZvaWQ+fVxuICAgKi9cbiAgb25SZXN1bWUoKSB7fVxuXG4gIC8qKlxuICAgKiBDYWxsZWQgd2hlbiB0aGUgY2xpZW50IHNlbmRzIHVwZGF0ZWQgbWV0YWRhdGEgKGUuZy4gYWZ0ZXJcbiAgICogc2lnbi1pbiAvIGxvY2FsZSBjaGFuZ2UpLiBPdmVycmlkZSB0byByZWFjdCB0byBzZXNzaW9uLWxldmVsXG4gICAqIG1ldGFkYXRhIHVwZGF0ZXMuXG4gICAqXG4gICAqIEBwYXJhbSB7V2Vic29ja2V0UGFyYW1zfSBfbWV0YWRhdGEgLSBVcGRhdGVkIG1ldGFkYXRhLlxuICAgKiBAcmV0dXJucyB7dm9pZCB8IFByb21pc2U8dm9pZD59XG4gICAqL1xuICBvbk1ldGFkYXRhQ2hhbmdlZChfbWV0YWRhdGEpIHt9XG5cbiAgLyoqXG4gICAqIEJyb2FkY2FzdCByb3V0aW5nIGZpbHRlci4gQ2FsbGVkIGJ5IGBicm9hZGNhc3RUb0NoYW5uZWxgIGZvclxuICAgKiBlYWNoIGxpdmUgc3Vic2NyaXB0aW9uIOKAlCByZXR1cm5pbmcgdHJ1ZSBkZWxpdmVycyB0aGUgYm9keSB2aWFcbiAgICogYHNlbmRNZXNzYWdlYC4gRGVmYXVsdCBtYXRjaGVzIGFsbCBicm9hZGNhc3RzIHJlZ2FyZGxlc3Mgb2ZcbiAgICogcGFyYW1zOyBvdmVycmlkZSBmb3IgcGVyLXN1YnNjcmliZXIgZmlsdGVyaW5nLlxuICAgKlxuICAgKiBAcGFyYW0gey4uLldlYnNvY2tldEpzb25WYWx1ZX0gX2Jyb2FkY2FzdEFyZ3MgLSBQYXJhbXMgZm9yd2FyZGVkIGZyb20gYGJyb2FkY2FzdFRvQ2hhbm5lbGAgKGlnbm9yZWQgYnkgZGVmYXVsdCkuXG4gICAqIEByZXR1cm5zIHtib29sZWFufSAtIFRydWUgdG8gZGVsaXZlciB0aGUgYnJvYWRjYXN0IHRvIHRoaXMgc3Vic2NyaWJlci5cbiAgICovXG4gIG1hdGNoZXMoLi4uX2Jyb2FkY2FzdEFyZ3MpIHsgcmV0dXJuIHRydWUgfVxuXG4gIC8qKlxuICAgKiBEZWxpdmVycyBhIG1hdGNoZWQgYnJvYWRjYXN0IHRvIHRoaXMgc3Vic2NyaWJlci4gU3ViY2xhc3NlcyBjYW5cbiAgICogb3ZlcnJpZGUgd2hlbiB0aGUgb3V0Ym91bmQgYm9keSBtdXN0IGJlIHRhaWxvcmVkIHRvIHN1YnNjcmlwdGlvblxuICAgKiBwYXJhbXMgYmVmb3JlIHNlbmRpbmcuXG4gICAqXG4gICAqIEBwYXJhbSB7V2Vic29ja2V0SnNvblZhbHVlfSBib2R5XG4gICAqIEBwYXJhbSB7e2V2ZW50SWQ/OiBzdHJpbmd9fSBbbWV0YV0gLSBPcHRpb25hbCBldmVudCBtZXRhZGF0YS5cbiAgICogQHJldHVybnMge3ZvaWQgfCBQcm9taXNlPHZvaWQ+fVxuICAgKi9cbiAgZGVsaXZlckJyb2FkY2FzdChib2R5LCBtZXRhKSB7XG4gICAgdGhpcy5zZW5kTWVzc2FnZShib2R5LCBtZXRhKVxuICB9XG5cbiAgLyoqXG4gICAqIFNlbmRzIGEgYGNoYW5uZWwtbWVzc2FnZWAgZnJhbWUgdG8gVEhJUyBzdWJzY3JpYmVyIG9ubHkuXG4gICAqIFdoZW4gYG1ldGEuZXZlbnRJZGAgaXMgcHJvdmlkZWQsIHRoZSBjbGllbnQgcmVjZWl2ZXMgaXQgc28gaXRcbiAgICogY2FuIHRyYWNrIGl0cyBjaGVja3BvaW50IGZvciBgbGFzdEV2ZW50SWRgIHJlcGxheSBvbiByZWNvbm5lY3QuXG4gICAqXG4gICAqIEBwYXJhbSB7V2Vic29ja2V0SnNvblZhbHVlfSBib2R5XG4gICAqIEBwYXJhbSB7e2V2ZW50SWQ/OiBzdHJpbmd9fSBbbWV0YV0gLSBPcHRpb25hbCBldmVudCBtZXRhZGF0YS5cbiAgICogQHJldHVybnMge3ZvaWR9XG4gICAqL1xuICBzZW5kTWVzc2FnZShib2R5LCBtZXRhKSB7XG4gICAgaWYgKHRoaXMuX2Nsb3NlZCkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKGBDYW5ub3Qgc2VuZE1lc3NhZ2Ugb24gY2xvc2VkIHN1YnNjcmlwdGlvbiAke3RoaXMuc3Vic2NyaXB0aW9uSWR9YClcbiAgICB9XG5cbiAgICB0aGlzLnNlc3Npb24uc2VuZEpzb24oe1xuICAgICAgdHlwZTogXCJjaGFubmVsLW1lc3NhZ2VcIixcbiAgICAgIHN1YnNjcmlwdGlvbklkOiB0aGlzLnN1YnNjcmlwdGlvbklkLFxuICAgICAgYm9keSxcbiAgICAgIC4uLihtZXRhPy5ldmVudElkID8ge2V2ZW50SWQ6IG1ldGEuZXZlbnRJZH0gOiB7fSlcbiAgICB9KVxuICB9XG5cbiAgLyoqIEByZXR1cm5zIHtib29sZWFufSAqL1xuICBpc0Nsb3NlZCgpIHsgcmV0dXJuIHRoaXMuX2Nsb3NlZCB9XG59XG4iXX0=

package/build/src/testing/browser-frontend-model-event-hook-scenarios.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @param {keyof typeof scenarios} scenarioName - Scenario name.
+ * @returns {Promise<Record<string, number>>} - Scenario result.
+ */
+export default function runFrontendModelEventHookScenario(scenarioName: keyof typeof scenarios): Promise<Record<string, number>>;
+export type FrontendModelProjectionOptions = import("../frontend-models/query.js").FrontendModelProjectionOptions;
+export type FrontendModelResourceConfig = import("../frontend-models/base.js").FrontendModelResourceConfig;
+export type FrontendModelHookTestCreateUpdatePayload = {
+    id: string;
+    model: FrontendModelBase;
+};
+export type FrontendModelHookTestDestroyPayload = {
+    id: string;
+};
+export type FakeSubscriptions = {
+    /**
+     * - Create callbacks.
+     */
+    create: Set<(payload: FrontendModelHookTestCreateUpdatePayload) => void>;
+    /**
+     * - Destroy callbacks.
+     */
+    destroy: Set<(payload: FrontendModelHookTestDestroyPayload) => void>;
+    /**
+     * - Subscription options.
+     */
+    options: {
+        create: FrontendModelProjectionOptions[];
+        destroy: FrontendModelProjectionOptions[];
+        update: FrontendModelProjectionOptions[];
+    };
+    /**
+     * - Update callbacks.
+     */
+    update: Set<(payload: FrontendModelHookTestCreateUpdatePayload) => void>;
+};
+declare namespace scenarios {
+    export { classLifecycleScenario as classLifecycle };
+    export { debounceUnmountScenario as debounceUnmount };
+    export { instanceLifecycleScenario as instanceLifecycle };
+    export { projectionOptionsScenario as projectionOptions };
+    export { resubscribeInstanceScenario as resubscribeInstance };
+}
+import FrontendModelBase from "../frontend-models/base.js";
+/** @returns {Promise<Record<string, number>>} - Scenario result. */
+declare function classLifecycleScenario(): Promise<Record<string, number>>;
+/** @returns {Promise<Record<string, number>>} - Scenario result. */
+declare function debounceUnmountScenario(): Promise<Record<string, number>>;
+/** @returns {Promise<Record<string, number>>} - Scenario result. */
+declare function instanceLifecycleScenario(): Promise<Record<string, number>>;
+/** @returns {Promise<Record<string, number>>} - Scenario result. */
+declare function projectionOptionsScenario(): Promise<Record<string, number>>;
+/** @returns {Promise<Record<string, number>>} - Scenario result. */
+declare function resubscribeInstanceScenario(): Promise<Record<string, number>>;
+export {};
+//# sourceMappingURL=browser-frontend-model-event-hook-scenarios.d.ts.map

package/build/src/testing/browser-frontend-model-event-hook-scenarios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-frontend-model-event-hook-scenarios.d.ts","sourceRoot":"","sources":["../../../src/testing/browser-frontend-model-event-hook-scenarios.js"],"names":[],"mappings":"AAwbA;;;GAGG;AACH,wEAHW,MAAM,OAAO,SAAS,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQ3C;6CAvba,OAAO,6BAA6B,EAAE,8BAA8B;0CACpE,OAAO,4BAA4B,EAAE,2BAA2B;uDAChE;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAC;kDACtC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC;;;;;YAGZ,GAAG,CAAC,CAAC,OAAO,EAAE,wCAAwC,KAAK,IAAI,CAAC;;;;aAChE,GAAG,CAAC,CAAC,OAAO,EAAE,mCAAmC,KAAK,IAAI,CAAC;;;;aAC3D;QAAC,MAAM,EAAE,8BAA8B,EAAE,CAAC;QAAC,OAAO,EAAE,8BAA8B,EAAE,CAAC;QAAC,MAAM,EAAE,8BAA8B,EAAE,CAAA;KAAC;;;;YAC/H,GAAG,CAAC,CAAC,OAAO,EAAE,wCAAwC,KAAK,IAAI,CAAC;;;;;;;;;8BAbhD,4BAA4B;AAkN1D,oEAAoE;AACpE,2CADc,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA2C5C;AAyFD,oEAAoE;AACpE,4CADc,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA4B5C;AAnHD,oEAAoE;AACpE,8CADc,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA0C5C;AAED,oEAAoE;AACpE,8CADc,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAyC5C;AAgCD,oEAAoE;AACpE,gDADc,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAmD5C"}