@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.
- package/README.md +760 -716
- package/dist/{a11y-C5QOVvRn.js → a11y-DVBCy09c.js} +3 -3
- package/dist/a11y-DVBCy09c.js.map +1 -0
- package/dist/a11y.es.mjs +1 -1
- package/dist/component/library.d.ts.map +1 -1
- package/dist/{component-CuuTijA6.js → component-L3-JfOFz.js} +5 -5
- package/dist/component-L3-JfOFz.js.map +1 -0
- package/dist/component.es.mjs +1 -1
- package/dist/{config-BW35FKuA.js → config-DhT9auRm.js} +1 -1
- package/dist/{config-BW35FKuA.js.map → config-DhT9auRm.js.map} +1 -1
- package/dist/{constraints-3lV9yyBw.js → constraints-D5RHQLmP.js} +1 -1
- package/dist/constraints-D5RHQLmP.js.map +1 -0
- package/dist/core/collection.d.ts +86 -0
- package/dist/core/collection.d.ts.map +1 -1
- package/dist/core/element.d.ts +28 -0
- package/dist/core/element.d.ts.map +1 -1
- package/dist/core/shared.d.ts +6 -0
- package/dist/core/shared.d.ts.map +1 -1
- package/dist/core-DdtZHzsS.js +168 -0
- package/dist/core-DdtZHzsS.js.map +1 -0
- package/dist/{core-Cjl7GUu8.js → core-EMYSLzaT.js} +289 -259
- package/dist/core-EMYSLzaT.js.map +1 -0
- package/dist/core.es.mjs +48 -47
- package/dist/{custom-directives-7wAShnnd.js → custom-directives-Dr4C5lVV.js} +1 -1
- package/dist/custom-directives-Dr4C5lVV.js.map +1 -0
- package/dist/{devtools-D2fQLhDN.js → devtools-BhB2iDPT.js} +2 -2
- package/dist/devtools-BhB2iDPT.js.map +1 -0
- package/dist/devtools.es.mjs +1 -1
- package/dist/{dnd-B8EgyzaI.js → dnd-NwZBYh4l.js} +1 -1
- package/dist/dnd-NwZBYh4l.js.map +1 -0
- package/dist/dnd.es.mjs +1 -1
- package/dist/{env-NeVmr4Gf.js → env-CTdvLaH2.js} +1 -1
- package/dist/env-CTdvLaH2.js.map +1 -0
- package/dist/forms/create-form.d.ts.map +1 -1
- package/dist/forms/index.d.ts +3 -2
- package/dist/forms/index.d.ts.map +1 -1
- package/dist/forms/types.d.ts +46 -0
- package/dist/forms/types.d.ts.map +1 -1
- package/dist/forms/use-field.d.ts +34 -0
- package/dist/forms/use-field.d.ts.map +1 -0
- package/dist/forms/validators.d.ts +25 -0
- package/dist/forms/validators.d.ts.map +1 -1
- package/dist/forms-UcRHsYxC.js +227 -0
- package/dist/forms-UcRHsYxC.js.map +1 -0
- package/dist/forms.es.mjs +14 -12
- package/dist/full.d.ts +17 -26
- package/dist/full.d.ts.map +1 -1
- package/dist/full.es.mjs +206 -181
- package/dist/full.iife.js +33 -33
- package/dist/full.iife.js.map +1 -1
- package/dist/full.umd.js +33 -33
- package/dist/full.umd.js.map +1 -1
- package/dist/function-Cybd57JV.js +33 -0
- package/dist/function-Cybd57JV.js.map +1 -0
- package/dist/{i18n-BnnhTFOS.js → i18n-kuF6Ekj6.js} +3 -3
- package/dist/i18n-kuF6Ekj6.js.map +1 -0
- package/dist/i18n.es.mjs +1 -1
- package/dist/index.es.mjs +251 -228
- package/dist/media/breakpoints.d.ts.map +1 -1
- package/dist/media/types.d.ts +2 -2
- package/dist/media/types.d.ts.map +1 -1
- package/dist/{media-Di2Ta22s.js → media-i-fB5WxI.js} +3 -3
- package/dist/media-i-fB5WxI.js.map +1 -0
- package/dist/media.es.mjs +1 -1
- package/dist/{motion-qPj_TYGv.js → motion-BJsAuULb.js} +2 -2
- package/dist/motion-BJsAuULb.js.map +1 -0
- package/dist/motion.es.mjs +1 -1
- package/dist/{mount-SM07RUa6.js → mount-B4Y8bk8Z.js} +5 -5
- package/dist/mount-B4Y8bk8Z.js.map +1 -0
- package/dist/{platform-CPbCprb6.js → platform-Dw2gE3zI.js} +3 -3
- package/dist/{platform-CPbCprb6.js.map → platform-Dw2gE3zI.js.map} +1 -1
- package/dist/platform.es.mjs +2 -2
- package/dist/plugin/registry.d.ts.map +1 -1
- package/dist/{plugin-cPoOHFLY.js → plugin-C2WuC8SF.js} +20 -18
- package/dist/plugin-C2WuC8SF.js.map +1 -0
- package/dist/plugin.es.mjs +1 -1
- package/dist/reactive/async-data.d.ts +28 -3
- package/dist/reactive/async-data.d.ts.map +1 -1
- package/dist/reactive/computed.d.ts +3 -0
- package/dist/reactive/computed.d.ts.map +1 -1
- package/dist/reactive/effect.d.ts +3 -0
- package/dist/reactive/effect.d.ts.map +1 -1
- package/dist/reactive/http.d.ts +194 -0
- package/dist/reactive/http.d.ts.map +1 -0
- package/dist/reactive/index.d.ts +2 -2
- package/dist/reactive/index.d.ts.map +1 -1
- package/dist/reactive/pagination.d.ts +126 -0
- package/dist/reactive/pagination.d.ts.map +1 -0
- package/dist/reactive/polling.d.ts +55 -0
- package/dist/reactive/polling.d.ts.map +1 -0
- package/dist/reactive/readonly.d.ts +20 -1
- package/dist/reactive/readonly.d.ts.map +1 -1
- package/dist/reactive/rest.d.ts +293 -0
- package/dist/reactive/rest.d.ts.map +1 -0
- package/dist/reactive/scope.d.ts +140 -0
- package/dist/reactive/scope.d.ts.map +1 -0
- package/dist/reactive/signal.d.ts +16 -2
- package/dist/reactive/signal.d.ts.map +1 -1
- package/dist/reactive/to-value.d.ts +57 -0
- package/dist/reactive/to-value.d.ts.map +1 -0
- package/dist/reactive/websocket.d.ts +285 -0
- package/dist/reactive/websocket.d.ts.map +1 -0
- package/dist/reactive-DwkhUJfP.js +1148 -0
- package/dist/reactive-DwkhUJfP.js.map +1 -0
- package/dist/reactive.es.mjs +38 -19
- package/dist/{registry-CWf368tT.js → registry-B08iilIh.js} +1 -1
- package/dist/{registry-CWf368tT.js.map → registry-B08iilIh.js.map} +1 -1
- package/dist/router/constraints.d.ts.map +1 -1
- package/dist/router/index.d.ts +1 -1
- package/dist/router/index.d.ts.map +1 -1
- package/dist/router/router.d.ts.map +1 -1
- package/dist/router/state.d.ts +25 -2
- package/dist/router/state.d.ts.map +1 -1
- package/dist/router-CQikC9Ed.js +492 -0
- package/dist/router-CQikC9Ed.js.map +1 -0
- package/dist/router.es.mjs +9 -8
- package/dist/ssr/hydrate.d.ts.map +1 -1
- package/dist/{ssr-B2qd_WBB.js → ssr-_dAcGdzu.js} +4 -4
- package/dist/ssr-_dAcGdzu.js.map +1 -0
- package/dist/ssr.es.mjs +1 -1
- package/dist/store/persisted.d.ts.map +1 -1
- package/dist/{store-DWpyH6p5.js → store-Cb3gPRve.js} +7 -7
- package/dist/store-Cb3gPRve.js.map +1 -0
- package/dist/store.es.mjs +2 -2
- package/dist/storybook.es.mjs.map +1 -1
- package/dist/{testing-CsqjNUyy.js → testing-C5Sjfsna.js} +8 -8
- package/dist/testing-C5Sjfsna.js.map +1 -0
- package/dist/testing.es.mjs +1 -1
- package/dist/{type-guards-Do9DWgNp.js → type-guards-BMX2c0LP.js} +1 -1
- package/dist/{type-guards-Do9DWgNp.js.map → type-guards-BMX2c0LP.js.map} +1 -1
- package/dist/untrack-D0fnO5k2.js +36 -0
- package/dist/untrack-D0fnO5k2.js.map +1 -0
- package/dist/view/custom-directives.d.ts.map +1 -1
- package/dist/view.es.mjs +4 -4
- package/package.json +177 -177
- package/src/a11y/announce.ts +131 -131
- package/src/a11y/audit.ts +314 -314
- package/src/a11y/index.ts +68 -68
- package/src/a11y/media-preferences.ts +255 -255
- package/src/a11y/roving-tab-index.ts +164 -164
- package/src/a11y/skip-link.ts +255 -255
- package/src/a11y/trap-focus.ts +184 -184
- package/src/a11y/types.ts +183 -183
- package/src/component/component.ts +599 -599
- package/src/component/html.ts +153 -153
- package/src/component/index.ts +52 -52
- package/src/component/library.ts +540 -542
- package/src/component/scope.ts +212 -212
- package/src/component/types.ts +310 -310
- package/src/core/collection.ts +876 -707
- package/src/core/element.ts +1015 -981
- package/src/core/env.ts +60 -60
- package/src/core/index.ts +49 -49
- package/src/core/shared.ts +77 -62
- package/src/core/utils/index.ts +148 -148
- package/src/devtools/devtools.ts +410 -410
- package/src/devtools/index.ts +48 -48
- package/src/devtools/types.ts +104 -104
- package/src/dnd/draggable.ts +296 -296
- package/src/dnd/droppable.ts +228 -228
- package/src/dnd/index.ts +62 -62
- package/src/dnd/sortable.ts +307 -307
- package/src/dnd/types.ts +293 -293
- package/src/forms/create-form.ts +320 -278
- package/src/forms/index.ts +70 -65
- package/src/forms/types.ts +203 -154
- package/src/forms/use-field.ts +231 -0
- package/src/forms/validators.ts +294 -265
- package/src/full.ts +554 -480
- package/src/i18n/formatting.ts +67 -67
- package/src/i18n/i18n.ts +200 -200
- package/src/i18n/index.ts +67 -67
- package/src/i18n/translate.ts +182 -182
- package/src/i18n/types.ts +171 -171
- package/src/index.ts +108 -108
- package/src/media/battery.ts +116 -116
- package/src/media/breakpoints.ts +129 -131
- package/src/media/clipboard.ts +80 -80
- package/src/media/device-sensors.ts +158 -158
- package/src/media/geolocation.ts +119 -119
- package/src/media/index.ts +76 -76
- package/src/media/media-query.ts +92 -92
- package/src/media/network.ts +115 -115
- package/src/media/types.ts +177 -177
- package/src/media/viewport.ts +84 -84
- package/src/motion/index.ts +57 -57
- package/src/motion/morph.ts +151 -151
- package/src/motion/parallax.ts +120 -120
- package/src/motion/reduced-motion.ts +66 -66
- package/src/motion/types.ts +271 -271
- package/src/motion/typewriter.ts +164 -164
- package/src/plugin/index.ts +37 -37
- package/src/plugin/registry.ts +284 -269
- package/src/plugin/types.ts +137 -137
- package/src/reactive/async-data.ts +250 -29
- package/src/reactive/computed.ts +144 -130
- package/src/reactive/effect.ts +29 -6
- package/src/reactive/http.ts +790 -0
- package/src/reactive/index.ts +60 -0
- package/src/reactive/pagination.ts +317 -0
- package/src/reactive/polling.ts +179 -0
- package/src/reactive/readonly.ts +52 -8
- package/src/reactive/rest.ts +859 -0
- package/src/reactive/scope.ts +276 -0
- package/src/reactive/signal.ts +61 -1
- package/src/reactive/to-value.ts +71 -0
- package/src/reactive/websocket.ts +849 -0
- package/src/router/bq-link.ts +279 -279
- package/src/router/constraints.ts +204 -201
- package/src/router/index.ts +49 -49
- package/src/router/match.ts +312 -312
- package/src/router/path-pattern.ts +52 -52
- package/src/router/query.ts +38 -38
- package/src/router/router.ts +421 -402
- package/src/router/state.ts +51 -3
- package/src/router/types.ts +139 -139
- package/src/router/use-route.ts +68 -68
- package/src/router/utils.ts +157 -157
- package/src/security/index.ts +12 -12
- package/src/ssr/hydrate.ts +84 -82
- package/src/ssr/index.ts +70 -70
- package/src/ssr/render.ts +508 -508
- package/src/ssr/serialize.ts +296 -296
- package/src/ssr/types.ts +81 -81
- package/src/store/create-store.ts +467 -467
- package/src/store/index.ts +27 -27
- package/src/store/persisted.ts +245 -249
- package/src/store/types.ts +247 -247
- package/src/store/utils.ts +135 -135
- package/src/storybook/index.ts +480 -480
- package/src/testing/index.ts +42 -42
- package/src/testing/testing.ts +593 -593
- package/src/testing/types.ts +170 -170
- package/src/view/custom-directives.ts +28 -30
- package/src/view/evaluate.ts +292 -292
- package/src/view/process.ts +108 -108
- package/dist/a11y-C5QOVvRn.js.map +0 -1
- package/dist/component-CuuTijA6.js.map +0 -1
- package/dist/constraints-3lV9yyBw.js.map +0 -1
- package/dist/core-Cjl7GUu8.js.map +0 -1
- package/dist/core-DnlyjbF2.js +0 -112
- package/dist/core-DnlyjbF2.js.map +0 -1
- package/dist/custom-directives-7wAShnnd.js.map +0 -1
- package/dist/devtools-D2fQLhDN.js.map +0 -1
- package/dist/dnd-B8EgyzaI.js.map +0 -1
- package/dist/env-NeVmr4Gf.js.map +0 -1
- package/dist/forms-C3yovgH9.js +0 -141
- package/dist/forms-C3yovgH9.js.map +0 -1
- package/dist/i18n-BnnhTFOS.js.map +0 -1
- package/dist/media-Di2Ta22s.js.map +0 -1
- package/dist/motion-qPj_TYGv.js.map +0 -1
- package/dist/mount-SM07RUa6.js.map +0 -1
- package/dist/plugin-cPoOHFLY.js.map +0 -1
- package/dist/reactive-Cfv0RK6x.js +0 -233
- package/dist/reactive-Cfv0RK6x.js.map +0 -1
- package/dist/router-BrthaP_z.js +0 -473
- package/dist/router-BrthaP_z.js.map +0 -1
- package/dist/ssr-B2qd_WBB.js.map +0 -1
- package/dist/store-DWpyH6p5.js.map +0 -1
- package/dist/testing-CsqjNUyy.js.map +0 -1
- package/dist/untrack-DJVQQ2WM.js +0 -33
- 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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"}
|