@bquery/bquery 1.7.0 → 1.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (262) hide show
  1. package/README.md +760 -716
  2. package/dist/{a11y-C5QOVvRn.js → a11y-DVBCy09c.js} +3 -3
  3. package/dist/a11y-DVBCy09c.js.map +1 -0
  4. package/dist/a11y.es.mjs +1 -1
  5. package/dist/component/library.d.ts.map +1 -1
  6. package/dist/{component-CuuTijA6.js → component-L3-JfOFz.js} +5 -5
  7. package/dist/component-L3-JfOFz.js.map +1 -0
  8. package/dist/component.es.mjs +1 -1
  9. package/dist/{config-BW35FKuA.js → config-DhT9auRm.js} +1 -1
  10. package/dist/{config-BW35FKuA.js.map → config-DhT9auRm.js.map} +1 -1
  11. package/dist/{constraints-3lV9yyBw.js → constraints-D5RHQLmP.js} +1 -1
  12. package/dist/constraints-D5RHQLmP.js.map +1 -0
  13. package/dist/core/collection.d.ts +86 -0
  14. package/dist/core/collection.d.ts.map +1 -1
  15. package/dist/core/element.d.ts +28 -0
  16. package/dist/core/element.d.ts.map +1 -1
  17. package/dist/core/shared.d.ts +6 -0
  18. package/dist/core/shared.d.ts.map +1 -1
  19. package/dist/core-DdtZHzsS.js +168 -0
  20. package/dist/core-DdtZHzsS.js.map +1 -0
  21. package/dist/{core-Cjl7GUu8.js → core-EMYSLzaT.js} +289 -259
  22. package/dist/core-EMYSLzaT.js.map +1 -0
  23. package/dist/core.es.mjs +48 -47
  24. package/dist/{custom-directives-7wAShnnd.js → custom-directives-Dr4C5lVV.js} +1 -1
  25. package/dist/custom-directives-Dr4C5lVV.js.map +1 -0
  26. package/dist/{devtools-D2fQLhDN.js → devtools-BhB2iDPT.js} +2 -2
  27. package/dist/devtools-BhB2iDPT.js.map +1 -0
  28. package/dist/devtools.es.mjs +1 -1
  29. package/dist/{dnd-B8EgyzaI.js → dnd-NwZBYh4l.js} +1 -1
  30. package/dist/dnd-NwZBYh4l.js.map +1 -0
  31. package/dist/dnd.es.mjs +1 -1
  32. package/dist/{env-NeVmr4Gf.js → env-CTdvLaH2.js} +1 -1
  33. package/dist/env-CTdvLaH2.js.map +1 -0
  34. package/dist/forms/create-form.d.ts.map +1 -1
  35. package/dist/forms/index.d.ts +3 -2
  36. package/dist/forms/index.d.ts.map +1 -1
  37. package/dist/forms/types.d.ts +46 -0
  38. package/dist/forms/types.d.ts.map +1 -1
  39. package/dist/forms/use-field.d.ts +34 -0
  40. package/dist/forms/use-field.d.ts.map +1 -0
  41. package/dist/forms/validators.d.ts +25 -0
  42. package/dist/forms/validators.d.ts.map +1 -1
  43. package/dist/forms-UcRHsYxC.js +227 -0
  44. package/dist/forms-UcRHsYxC.js.map +1 -0
  45. package/dist/forms.es.mjs +14 -12
  46. package/dist/full.d.ts +17 -26
  47. package/dist/full.d.ts.map +1 -1
  48. package/dist/full.es.mjs +206 -181
  49. package/dist/full.iife.js +33 -33
  50. package/dist/full.iife.js.map +1 -1
  51. package/dist/full.umd.js +33 -33
  52. package/dist/full.umd.js.map +1 -1
  53. package/dist/function-Cybd57JV.js +33 -0
  54. package/dist/function-Cybd57JV.js.map +1 -0
  55. package/dist/{i18n-BnnhTFOS.js → i18n-kuF6Ekj6.js} +3 -3
  56. package/dist/i18n-kuF6Ekj6.js.map +1 -0
  57. package/dist/i18n.es.mjs +1 -1
  58. package/dist/index.es.mjs +251 -228
  59. package/dist/media/breakpoints.d.ts.map +1 -1
  60. package/dist/media/types.d.ts +2 -2
  61. package/dist/media/types.d.ts.map +1 -1
  62. package/dist/{media-Di2Ta22s.js → media-i-fB5WxI.js} +3 -3
  63. package/dist/media-i-fB5WxI.js.map +1 -0
  64. package/dist/media.es.mjs +1 -1
  65. package/dist/{motion-qPj_TYGv.js → motion-BJsAuULb.js} +2 -2
  66. package/dist/motion-BJsAuULb.js.map +1 -0
  67. package/dist/motion.es.mjs +1 -1
  68. package/dist/{mount-SM07RUa6.js → mount-B4Y8bk8Z.js} +5 -5
  69. package/dist/mount-B4Y8bk8Z.js.map +1 -0
  70. package/dist/{platform-CPbCprb6.js → platform-Dw2gE3zI.js} +3 -3
  71. package/dist/{platform-CPbCprb6.js.map → platform-Dw2gE3zI.js.map} +1 -1
  72. package/dist/platform.es.mjs +2 -2
  73. package/dist/plugin/registry.d.ts.map +1 -1
  74. package/dist/{plugin-cPoOHFLY.js → plugin-C2WuC8SF.js} +20 -18
  75. package/dist/plugin-C2WuC8SF.js.map +1 -0
  76. package/dist/plugin.es.mjs +1 -1
  77. package/dist/reactive/async-data.d.ts +28 -3
  78. package/dist/reactive/async-data.d.ts.map +1 -1
  79. package/dist/reactive/computed.d.ts +3 -0
  80. package/dist/reactive/computed.d.ts.map +1 -1
  81. package/dist/reactive/effect.d.ts +3 -0
  82. package/dist/reactive/effect.d.ts.map +1 -1
  83. package/dist/reactive/http.d.ts +194 -0
  84. package/dist/reactive/http.d.ts.map +1 -0
  85. package/dist/reactive/index.d.ts +2 -2
  86. package/dist/reactive/index.d.ts.map +1 -1
  87. package/dist/reactive/pagination.d.ts +126 -0
  88. package/dist/reactive/pagination.d.ts.map +1 -0
  89. package/dist/reactive/polling.d.ts +55 -0
  90. package/dist/reactive/polling.d.ts.map +1 -0
  91. package/dist/reactive/readonly.d.ts +20 -1
  92. package/dist/reactive/readonly.d.ts.map +1 -1
  93. package/dist/reactive/rest.d.ts +293 -0
  94. package/dist/reactive/rest.d.ts.map +1 -0
  95. package/dist/reactive/scope.d.ts +140 -0
  96. package/dist/reactive/scope.d.ts.map +1 -0
  97. package/dist/reactive/signal.d.ts +16 -2
  98. package/dist/reactive/signal.d.ts.map +1 -1
  99. package/dist/reactive/to-value.d.ts +57 -0
  100. package/dist/reactive/to-value.d.ts.map +1 -0
  101. package/dist/reactive/websocket.d.ts +285 -0
  102. package/dist/reactive/websocket.d.ts.map +1 -0
  103. package/dist/reactive-DwkhUJfP.js +1148 -0
  104. package/dist/reactive-DwkhUJfP.js.map +1 -0
  105. package/dist/reactive.es.mjs +38 -19
  106. package/dist/{registry-CWf368tT.js → registry-B08iilIh.js} +1 -1
  107. package/dist/{registry-CWf368tT.js.map → registry-B08iilIh.js.map} +1 -1
  108. package/dist/router/constraints.d.ts.map +1 -1
  109. package/dist/router/index.d.ts +1 -1
  110. package/dist/router/index.d.ts.map +1 -1
  111. package/dist/router/router.d.ts.map +1 -1
  112. package/dist/router/state.d.ts +25 -2
  113. package/dist/router/state.d.ts.map +1 -1
  114. package/dist/router-CQikC9Ed.js +492 -0
  115. package/dist/router-CQikC9Ed.js.map +1 -0
  116. package/dist/router.es.mjs +9 -8
  117. package/dist/ssr/hydrate.d.ts.map +1 -1
  118. package/dist/{ssr-B2qd_WBB.js → ssr-_dAcGdzu.js} +4 -4
  119. package/dist/ssr-_dAcGdzu.js.map +1 -0
  120. package/dist/ssr.es.mjs +1 -1
  121. package/dist/store/persisted.d.ts.map +1 -1
  122. package/dist/{store-DWpyH6p5.js → store-Cb3gPRve.js} +7 -7
  123. package/dist/store-Cb3gPRve.js.map +1 -0
  124. package/dist/store.es.mjs +2 -2
  125. package/dist/storybook.es.mjs.map +1 -1
  126. package/dist/{testing-CsqjNUyy.js → testing-C5Sjfsna.js} +8 -8
  127. package/dist/testing-C5Sjfsna.js.map +1 -0
  128. package/dist/testing.es.mjs +1 -1
  129. package/dist/{type-guards-Do9DWgNp.js → type-guards-BMX2c0LP.js} +1 -1
  130. package/dist/{type-guards-Do9DWgNp.js.map → type-guards-BMX2c0LP.js.map} +1 -1
  131. package/dist/untrack-D0fnO5k2.js +36 -0
  132. package/dist/untrack-D0fnO5k2.js.map +1 -0
  133. package/dist/view/custom-directives.d.ts.map +1 -1
  134. package/dist/view.es.mjs +4 -4
  135. package/package.json +177 -177
  136. package/src/a11y/announce.ts +131 -131
  137. package/src/a11y/audit.ts +314 -314
  138. package/src/a11y/index.ts +68 -68
  139. package/src/a11y/media-preferences.ts +255 -255
  140. package/src/a11y/roving-tab-index.ts +164 -164
  141. package/src/a11y/skip-link.ts +255 -255
  142. package/src/a11y/trap-focus.ts +184 -184
  143. package/src/a11y/types.ts +183 -183
  144. package/src/component/component.ts +599 -599
  145. package/src/component/html.ts +153 -153
  146. package/src/component/index.ts +52 -52
  147. package/src/component/library.ts +540 -542
  148. package/src/component/scope.ts +212 -212
  149. package/src/component/types.ts +310 -310
  150. package/src/core/collection.ts +876 -707
  151. package/src/core/element.ts +1015 -981
  152. package/src/core/env.ts +60 -60
  153. package/src/core/index.ts +49 -49
  154. package/src/core/shared.ts +77 -62
  155. package/src/core/utils/index.ts +148 -148
  156. package/src/devtools/devtools.ts +410 -410
  157. package/src/devtools/index.ts +48 -48
  158. package/src/devtools/types.ts +104 -104
  159. package/src/dnd/draggable.ts +296 -296
  160. package/src/dnd/droppable.ts +228 -228
  161. package/src/dnd/index.ts +62 -62
  162. package/src/dnd/sortable.ts +307 -307
  163. package/src/dnd/types.ts +293 -293
  164. package/src/forms/create-form.ts +320 -278
  165. package/src/forms/index.ts +70 -65
  166. package/src/forms/types.ts +203 -154
  167. package/src/forms/use-field.ts +231 -0
  168. package/src/forms/validators.ts +294 -265
  169. package/src/full.ts +554 -480
  170. package/src/i18n/formatting.ts +67 -67
  171. package/src/i18n/i18n.ts +200 -200
  172. package/src/i18n/index.ts +67 -67
  173. package/src/i18n/translate.ts +182 -182
  174. package/src/i18n/types.ts +171 -171
  175. package/src/index.ts +108 -108
  176. package/src/media/battery.ts +116 -116
  177. package/src/media/breakpoints.ts +129 -131
  178. package/src/media/clipboard.ts +80 -80
  179. package/src/media/device-sensors.ts +158 -158
  180. package/src/media/geolocation.ts +119 -119
  181. package/src/media/index.ts +76 -76
  182. package/src/media/media-query.ts +92 -92
  183. package/src/media/network.ts +115 -115
  184. package/src/media/types.ts +177 -177
  185. package/src/media/viewport.ts +84 -84
  186. package/src/motion/index.ts +57 -57
  187. package/src/motion/morph.ts +151 -151
  188. package/src/motion/parallax.ts +120 -120
  189. package/src/motion/reduced-motion.ts +66 -66
  190. package/src/motion/types.ts +271 -271
  191. package/src/motion/typewriter.ts +164 -164
  192. package/src/plugin/index.ts +37 -37
  193. package/src/plugin/registry.ts +284 -269
  194. package/src/plugin/types.ts +137 -137
  195. package/src/reactive/async-data.ts +250 -29
  196. package/src/reactive/computed.ts +144 -130
  197. package/src/reactive/effect.ts +29 -6
  198. package/src/reactive/http.ts +790 -0
  199. package/src/reactive/index.ts +60 -0
  200. package/src/reactive/pagination.ts +317 -0
  201. package/src/reactive/polling.ts +179 -0
  202. package/src/reactive/readonly.ts +52 -8
  203. package/src/reactive/rest.ts +859 -0
  204. package/src/reactive/scope.ts +276 -0
  205. package/src/reactive/signal.ts +61 -1
  206. package/src/reactive/to-value.ts +71 -0
  207. package/src/reactive/websocket.ts +849 -0
  208. package/src/router/bq-link.ts +279 -279
  209. package/src/router/constraints.ts +204 -201
  210. package/src/router/index.ts +49 -49
  211. package/src/router/match.ts +312 -312
  212. package/src/router/path-pattern.ts +52 -52
  213. package/src/router/query.ts +38 -38
  214. package/src/router/router.ts +421 -402
  215. package/src/router/state.ts +51 -3
  216. package/src/router/types.ts +139 -139
  217. package/src/router/use-route.ts +68 -68
  218. package/src/router/utils.ts +157 -157
  219. package/src/security/index.ts +12 -12
  220. package/src/ssr/hydrate.ts +84 -82
  221. package/src/ssr/index.ts +70 -70
  222. package/src/ssr/render.ts +508 -508
  223. package/src/ssr/serialize.ts +296 -296
  224. package/src/ssr/types.ts +81 -81
  225. package/src/store/create-store.ts +467 -467
  226. package/src/store/index.ts +27 -27
  227. package/src/store/persisted.ts +245 -249
  228. package/src/store/types.ts +247 -247
  229. package/src/store/utils.ts +135 -135
  230. package/src/storybook/index.ts +480 -480
  231. package/src/testing/index.ts +42 -42
  232. package/src/testing/testing.ts +593 -593
  233. package/src/testing/types.ts +170 -170
  234. package/src/view/custom-directives.ts +28 -30
  235. package/src/view/evaluate.ts +292 -292
  236. package/src/view/process.ts +108 -108
  237. package/dist/a11y-C5QOVvRn.js.map +0 -1
  238. package/dist/component-CuuTijA6.js.map +0 -1
  239. package/dist/constraints-3lV9yyBw.js.map +0 -1
  240. package/dist/core-Cjl7GUu8.js.map +0 -1
  241. package/dist/core-DnlyjbF2.js +0 -112
  242. package/dist/core-DnlyjbF2.js.map +0 -1
  243. package/dist/custom-directives-7wAShnnd.js.map +0 -1
  244. package/dist/devtools-D2fQLhDN.js.map +0 -1
  245. package/dist/dnd-B8EgyzaI.js.map +0 -1
  246. package/dist/env-NeVmr4Gf.js.map +0 -1
  247. package/dist/forms-C3yovgH9.js +0 -141
  248. package/dist/forms-C3yovgH9.js.map +0 -1
  249. package/dist/i18n-BnnhTFOS.js.map +0 -1
  250. package/dist/media-Di2Ta22s.js.map +0 -1
  251. package/dist/motion-qPj_TYGv.js.map +0 -1
  252. package/dist/mount-SM07RUa6.js.map +0 -1
  253. package/dist/plugin-cPoOHFLY.js.map +0 -1
  254. package/dist/reactive-Cfv0RK6x.js +0 -233
  255. package/dist/reactive-Cfv0RK6x.js.map +0 -1
  256. package/dist/router-BrthaP_z.js +0 -473
  257. package/dist/router-BrthaP_z.js.map +0 -1
  258. package/dist/ssr-B2qd_WBB.js.map +0 -1
  259. package/dist/store-DWpyH6p5.js.map +0 -1
  260. package/dist/testing-CsqjNUyy.js.map +0 -1
  261. package/dist/untrack-DJVQQ2WM.js +0 -33
  262. package/dist/untrack-DJVQQ2WM.js.map +0 -1
@@ -0,0 +1,285 @@
1
+ /**
2
+ * Reactive WebSocket composable with auto-reconnect, heartbeat,
3
+ * message history, and signal-based connection state.
4
+ *
5
+ * @module bquery/reactive
6
+ */
7
+ import { Signal } from './core';
8
+ /** Connection status for a WebSocket. */
9
+ export type WebSocketStatus = 'CONNECTING' | 'OPEN' | 'CLOSING' | 'CLOSED';
10
+ /** Connection status for an EventSource. */
11
+ export type EventSourceStatus = 'CONNECTING' | 'OPEN' | 'CLOSED';
12
+ /** Configuration for automatic reconnection. */
13
+ export interface WebSocketReconnectConfig {
14
+ /** Maximum number of reconnection attempts. Use `0` to disable reconnection (default: Infinity / unlimited). */
15
+ maxAttempts?: number;
16
+ /** Base delay in ms between reconnects (default: 1000). */
17
+ delay?: number;
18
+ /** Maximum delay in ms between reconnects (default: 30000). */
19
+ maxDelay?: number;
20
+ /** Multiply factor for exponential backoff (default: 2). */
21
+ factor?: number;
22
+ /** Custom predicate — return `false` to prevent a reconnect attempt. */
23
+ shouldReconnect?: (event: CloseEvent, attempts: number) => boolean;
24
+ }
25
+ /** Reconnect configuration supported by `useEventSource()`. */
26
+ export type EventSourceReconnectConfig = Pick<WebSocketReconnectConfig, 'maxAttempts' | 'delay' | 'maxDelay' | 'factor'>;
27
+ /** Configuration for keep-alive heartbeats. */
28
+ export interface WebSocketHeartbeatConfig {
29
+ /** Outgoing ping message (default: `'ping'`). */
30
+ message?: string | ArrayBufferLike | Blob | ArrayBufferView;
31
+ /** Interval in ms between heartbeat pings (default: 30 000). */
32
+ interval?: number;
33
+ /** Time in ms to wait for a pong before assuming the connection is dead (default: 10 000). */
34
+ pongTimeout?: number;
35
+ /** Expected response message. If set, only messages matching this value reset the pong timer. */
36
+ responseMessage?: string;
37
+ }
38
+ /** Serializer/deserializer for typed messaging. */
39
+ export interface WebSocketSerializer<TSend = unknown, TReceive = unknown> {
40
+ /** Serialize a value before sending over the wire. Default: `JSON.stringify`. */
41
+ serialize?: (data: TSend) => string | ArrayBufferLike | Blob | ArrayBufferView;
42
+ /** Deserialize an incoming message. Default: `JSON.parse`. */
43
+ deserialize?: (event: MessageEvent) => TReceive;
44
+ }
45
+ /** Full configuration accepted by `useWebSocket()`. */
46
+ export interface UseWebSocketOptions<TSend = unknown, TReceive = unknown> extends WebSocketSerializer<TSend, TReceive> {
47
+ /** Sub-protocols to request during the WebSocket handshake. */
48
+ protocols?: string | string[];
49
+ /** Open the connection immediately (default: true). */
50
+ immediate?: boolean;
51
+ /** Automatically reconnect on unexpected close (default: true). Pass `false` or config. */
52
+ autoReconnect?: boolean | WebSocketReconnectConfig;
53
+ /** Keep-alive heartbeat configuration. Pass `true` for defaults or a config object. */
54
+ heartbeat?: boolean | WebSocketHeartbeatConfig;
55
+ /** Maximum number of messages to keep in `history` (default: 0 = disabled). */
56
+ historySize?: number;
57
+ /** Called when the connection opens. */
58
+ onOpen?: (event: Event) => void;
59
+ /** Called when a message is received (after deserialization). */
60
+ onMessage?: (data: TReceive, event: MessageEvent) => void;
61
+ /** Called when the connection closes. */
62
+ onClose?: (event: CloseEvent) => void;
63
+ /** Called when a connection error occurs. */
64
+ onError?: (event: Event) => void;
65
+ /** Called after a successful reconnection. Receives the reconnection attempt count. */
66
+ onReconnect?: (attempts: number) => void;
67
+ }
68
+ /** Return value of `useWebSocket()`. */
69
+ export interface UseWebSocketReturn<TSend = unknown, TReceive = unknown> {
70
+ /** Reactive connection status. */
71
+ status: {
72
+ readonly value: WebSocketStatus;
73
+ peek(): WebSocketStatus;
74
+ };
75
+ /** Reactive last received message (deserialized). */
76
+ data: Signal<TReceive | undefined>;
77
+ /** Last error event. */
78
+ error: Signal<Event | null>;
79
+ /** Rolling message history (newest last). */
80
+ history: Signal<TReceive[]>;
81
+ /** Computed boolean — `true` when the socket is `OPEN`. */
82
+ isConnected: {
83
+ readonly value: boolean;
84
+ peek(): boolean;
85
+ };
86
+ /** Number of reconnection attempts since last successful open. */
87
+ reconnectAttempts: Signal<number>;
88
+ /** Round-trip latency in ms measured via heartbeat pings (requires `heartbeat` option). */
89
+ latency: Signal<number>;
90
+ /** Timestamp of the last unexpected disconnection, or 0 if never disconnected. */
91
+ lastDisconnectedAt: Signal<number>;
92
+ /**
93
+ * Send a message.
94
+ *
95
+ * If the socket is not `OPEN`, the message is queued and sent once a
96
+ * connection is (re)established, subject to the configured options.
97
+ */
98
+ send: (data: TSend) => void;
99
+ /**
100
+ * Send raw data without serialization.
101
+ *
102
+ * Uses the same queuing behavior as {@link send}: data is queued when the
103
+ * socket is not `OPEN` and flushed once a connection is (re)established.
104
+ */
105
+ sendRaw: (data: string | ArrayBufferLike | Blob | ArrayBufferView) => void;
106
+ /** Manually open / reconnect the WebSocket. */
107
+ open: () => void;
108
+ /** Gracefully close the connection. */
109
+ close: (code?: number, reason?: string) => void;
110
+ /** Tear down all resources (close + remove listeners + stop reconnect/heartbeat). */
111
+ dispose: () => void;
112
+ }
113
+ /**
114
+ * Reactive WebSocket composable with auto-reconnect, heartbeat,
115
+ * typed messaging, and signal-based connection state.
116
+ *
117
+ * @template TSend - Type of outgoing messages (serialized via `serialize`)
118
+ * @template TReceive - Type of incoming messages (deserialized via `deserialize`)
119
+ * @param url - WebSocket URL (`ws://` or `wss://`) or a getter returning one
120
+ * @param options - Connection, reconnect, heartbeat, and serialization options
121
+ * @returns Reactive WebSocket state with `send()`, `open()`, `close()`, and `dispose()`
122
+ *
123
+ * @example
124
+ * ```ts
125
+ * import { useWebSocket } from '@bquery/bquery/reactive';
126
+ *
127
+ * const ws = useWebSocket<{ type: string; payload: unknown }>('wss://api.example.com/ws', {
128
+ * autoReconnect: { maxAttempts: 5, delay: 2000 },
129
+ * heartbeat: true,
130
+ * historySize: 50,
131
+ * onMessage: (data) => console.log('Received:', data),
132
+ * });
133
+ *
134
+ * ws.send({ type: 'subscribe', payload: { channel: 'updates' } });
135
+ *
136
+ * // Reactive state
137
+ * effect(() => {
138
+ * console.log('Connected:', ws.isConnected.value);
139
+ * console.log('Last message:', ws.data.value);
140
+ * });
141
+ *
142
+ * // Cleanup
143
+ * ws.dispose();
144
+ * ```
145
+ */
146
+ export declare const useWebSocket: <TSend = string, TReceive = string>(url: string | URL | (() => string | URL), options?: UseWebSocketOptions<TSend, TReceive>) => UseWebSocketReturn<TSend, TReceive>;
147
+ /** Default channel message format used by `useWebSocketChannel()`. */
148
+ export interface ChannelMessage<T = unknown> {
149
+ /** Channel / topic name. */
150
+ channel: string;
151
+ /** Message payload. */
152
+ data: T;
153
+ }
154
+ /** Configuration for `useWebSocketChannel()`. */
155
+ export interface UseWebSocketChannelOptions<TSend = unknown, TReceive = unknown> {
156
+ /**
157
+ * Extract the channel name from an incoming deserialized message.
158
+ * Default: reads `(msg as ChannelMessage).channel`.
159
+ */
160
+ getChannel?: (msg: TReceive) => string | undefined;
161
+ /**
162
+ * Wrap a payload + channel into the wire format before sending.
163
+ * Default: `{ channel, data }`.
164
+ */
165
+ wrap?: (channel: string, data: TSend) => TReceive;
166
+ }
167
+ /** A single channel subscription returned by `subscribe()`. */
168
+ export interface ChannelSubscription<TReceive = unknown> {
169
+ /** Reactive last message received on this channel. */
170
+ data: Signal<TReceive | undefined>;
171
+ /** Unsubscribe from this channel. */
172
+ unsubscribe: () => void;
173
+ }
174
+ /** Return value of `useWebSocketChannel()`. */
175
+ export interface UseWebSocketChannelReturn<TSend = unknown, TReceive = unknown> {
176
+ /** Subscribe to a topic. Multiple subscriptions to the same channel share a signal. */
177
+ subscribe: (channel: string) => ChannelSubscription<TReceive>;
178
+ /** Publish a message to a channel. */
179
+ publish: (channel: string, data: TSend) => void;
180
+ /** The underlying `useWebSocket` return for direct access. */
181
+ ws: UseWebSocketReturn<TReceive, TReceive>;
182
+ }
183
+ /**
184
+ * Topic-based channel multiplexer over a single WebSocket connection.
185
+ *
186
+ * Builds on `useWebSocket()` and routes incoming messages to per-channel
187
+ * reactive signals based on a configurable channel extractor.
188
+ *
189
+ * @template TSend - Type of outgoing message payloads
190
+ * @template TReceive - Type of incoming deserialized messages
191
+ * @param url - WebSocket URL
192
+ * @param wsOptions - All `useWebSocket` options
193
+ * @param channelOptions - Channel routing configuration
194
+ * @returns Channel multiplexer with `subscribe()`, `publish()`, and the underlying `ws`
195
+ *
196
+ * @example
197
+ * ```ts
198
+ * import { useWebSocketChannel } from '@bquery/bquery/reactive';
199
+ *
200
+ * const chat = useWebSocketChannel('wss://chat.example.com/ws');
201
+ *
202
+ * const general = chat.subscribe('general');
203
+ * const updates = chat.subscribe('updates');
204
+ *
205
+ * effect(() => console.log('General:', general.data.value));
206
+ *
207
+ * chat.publish('general', { text: 'Hello!' });
208
+ * ```
209
+ */
210
+ export declare const useWebSocketChannel: <TSend = unknown, TReceive = unknown>(url: string | URL | (() => string | URL), wsOptions?: UseWebSocketOptions<TReceive, TReceive>, channelOptions?: UseWebSocketChannelOptions<TSend, TReceive>) => UseWebSocketChannelReturn<TSend, TReceive>;
211
+ /** Configuration for `useEventSource()`. */
212
+ export interface UseEventSourceOptions<TData = unknown> {
213
+ /** Whether to open the connection immediately (default: true). */
214
+ immediate?: boolean;
215
+ /** Automatically reconnect on error (default: true). Pass a reconnect config to customize delay and attempt limits. */
216
+ autoReconnect?: boolean | EventSourceReconnectConfig;
217
+ /** Event names to listen for besides the default `message` event. */
218
+ events?: string[];
219
+ /** Deserializer for incoming event data. Default: `JSON.parse` with string fallback. */
220
+ deserialize?: (data: string) => TData;
221
+ /** EventSource init options (e.g. `withCredentials`). */
222
+ eventSourceInit?: EventSourceInit;
223
+ /** Called when the connection opens. */
224
+ onOpen?: (event: Event) => void;
225
+ /** Called when a message is received. */
226
+ onMessage?: (data: TData, event: MessageEvent) => void;
227
+ /** Called when an error occurs. */
228
+ onError?: (event: Event) => void;
229
+ }
230
+ /** Return value of `useEventSource()`. */
231
+ export interface UseEventSourceReturn<TData = unknown> {
232
+ /** Current connection status (`CONNECTING`, `OPEN`, `CLOSED`). */
233
+ status: {
234
+ readonly value: EventSourceStatus;
235
+ peek(): EventSourceStatus;
236
+ };
237
+ /** Last received data (deserialized). */
238
+ data: Signal<TData | undefined>;
239
+ /** Last event name that delivered data. */
240
+ eventName: Signal<string | undefined>;
241
+ /** Last error event. */
242
+ error: Signal<Event | null>;
243
+ /** Computed boolean — `true` when the EventSource is open. */
244
+ isConnected: {
245
+ readonly value: boolean;
246
+ peek(): boolean;
247
+ };
248
+ /** Manually open / reconnect the EventSource. */
249
+ open: () => void;
250
+ /** Close the connection. */
251
+ close: () => void;
252
+ /** Tear down all resources. */
253
+ dispose: () => void;
254
+ }
255
+ /**
256
+ * Reactive Server-Sent Events (SSE) composable.
257
+ *
258
+ * Wraps the native `EventSource` API with reactive signals, auto-reconnect,
259
+ * and typed deserialization.
260
+ *
261
+ * @template TData - Type of deserialized event data
262
+ * @param url - SSE endpoint URL or a getter returning one
263
+ * @param options - EventSource options
264
+ * @returns Reactive EventSource state with `open()`, `close()`, and `dispose()`
265
+ *
266
+ * @example
267
+ * ```ts
268
+ * import { useEventSource } from '@bquery/bquery/reactive';
269
+ *
270
+ * const sse = useEventSource<{ type: string; message: string }>('/api/events', {
271
+ * events: ['notification', 'update'],
272
+ * onMessage: (data) => console.log('Event:', data),
273
+ * });
274
+ *
275
+ * effect(() => {
276
+ * if (sse.data.value) {
277
+ * console.log(`[${sse.eventName.value}]`, sse.data.value);
278
+ * }
279
+ * });
280
+ *
281
+ * sse.dispose();
282
+ * ```
283
+ */
284
+ export declare const useEventSource: <TData = unknown>(url: string | URL | (() => string | URL), options?: UseEventSourceOptions<TData>) => UseEventSourceReturn<TData>;
285
+ //# sourceMappingURL=websocket.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/reactive/websocket.ts"],"names":[],"mappings":"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"}