@perspective-dev/client 5.6.0 → 5.7.0
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 +5 -1
- package/dist/cdn/perspective.js +3 -2
- package/dist/cdn/perspective.js.map +4 -4
- package/dist/esm/perspective.browser.d.ts +71 -17
- package/dist/esm/perspective.js +2 -2
- package/dist/esm/perspective.js.map +4 -4
- package/dist/esm/perspective.node.d.ts +20 -3
- package/dist/esm/perspective.node.js +694 -34
- package/dist/esm/perspective.node.js.map +4 -4
- package/dist/esm/public_types.d.ts +31 -0
- package/dist/esm/virtual_servers/clickhouse.d.ts +37 -0
- package/dist/esm/virtual_servers/clickhouse.js +1 -1
- package/dist/esm/virtual_servers/clickhouse.js.map +3 -3
- package/dist/esm/virtual_servers/duckdb.d.ts +14 -9
- package/dist/esm/virtual_servers/duckdb.js +1 -1
- package/dist/esm/virtual_servers/duckdb.js.map +3 -3
- package/dist/esm/wasm/cdn.d.ts +12 -0
- package/dist/esm/wasm/decompress.d.ts +1 -0
- package/dist/esm/wasm/migrate.d.ts +40 -0
- package/dist/esm/wasm/registry.d.ts +123 -0
- package/dist/esm/wasm/registry.js +3 -0
- package/dist/esm/wasm/registry.js.map +7 -0
- package/{src/ts/ts-rs/AggSpec.ts → dist/ts-rs/AggSpec.d.ts} +1 -1
- package/{src/ts/ts-rs/Features.ts → dist/ts-rs/Features.d.ts} +16 -6
- package/{src/ts/ts-rs/Filter.ts → dist/ts-rs/Filter.d.ts} +1 -1
- package/{src/ts/ts-rs/FilterTerm.ts → dist/ts-rs/FilterTerm.d.ts} +1 -1
- package/{src/ts/ts-rs/JoinOptions.ts → dist/ts-rs/JoinOptions.d.ts} +1 -1
- package/dist/ts-rs/ListFlatten.d.ts +3 -0
- package/dist/ts-rs/MapFlatten.d.ts +3 -0
- package/{src/ts/ts-rs/OnRemoveData.ts → dist/ts-rs/OnRemoveData.d.ts} +1 -1
- package/{src/ts/ts-rs/OnUpdateData.ts → dist/ts-rs/OnUpdateData.d.ts} +1 -1
- package/{src/ts/ts-rs/OnUpdateOptions.ts → dist/ts-rs/OnUpdateOptions.d.ts} +1 -1
- package/{src/ts/ts-rs/Sort.ts → dist/ts-rs/Sort.d.ts} +1 -1
- package/dist/ts-rs/StructFlatten.d.ts +3 -0
- package/dist/ts-rs/TableIndex.d.ts +9 -0
- package/dist/ts-rs/TableInitOptions.d.ts +65 -0
- package/{src/ts/ts-rs/UpdateOptions.ts → dist/ts-rs/UpdateOptions.d.ts} +1 -1
- package/{src/ts/ts-rs/ViewConfig.ts → dist/ts-rs/ViewConfig.d.ts} +8 -8
- package/{src/ts/ts-rs/ViewConfigUpdate.ts → dist/ts-rs/ViewConfigUpdate.d.ts} +8 -8
- package/{src/ts/ts-rs/WindowAggSpec.ts → dist/ts-rs/WindowAggSpec.d.ts} +1 -1
- package/{src/ts/ts-rs/WindowSort.ts → dist/ts-rs/WindowSort.d.ts} +1 -1
- package/{src/ts/ts-rs/WindowSpec.ts → dist/ts-rs/WindowSpec.d.ts} +1 -1
- package/{src/ts/ts-rs/Windows.ts → dist/ts-rs/Windows.d.ts} +1 -1
- package/dist/wasm/perspective-js.d.ts +121 -54
- package/dist/wasm/perspective-js.js +123 -20
- package/dist/wasm/perspective-js.wasm +0 -0
- package/dist/wasm/perspective-js.wasm.d.ts +10 -6
- package/dist/wasm/perspective-migrate-js.d.ts +41 -0
- package/dist/wasm/perspective-migrate-js.js +524 -0
- package/dist/wasm/perspective-migrate-js.wasm +0 -0
- package/dist/wasm/perspective-migrate-js.wasm.d.ts +8 -0
- package/package.json +30 -15
- package/dist/esm/ts-rs/AggSpec.d.ts +0 -8
- package/dist/esm/ts-rs/Aggregate.d.ts +0 -1
- package/dist/esm/ts-rs/ColumnType.d.ts +0 -4
- package/dist/esm/ts-rs/ColumnWindow.d.ts +0 -4
- package/dist/esm/ts-rs/DeleteOptions.d.ts +0 -6
- package/dist/esm/ts-rs/Expressions.d.ts +0 -3
- package/dist/esm/ts-rs/Features.d.ts +0 -71
- package/dist/esm/ts-rs/Filter.d.ts +0 -2
- package/dist/esm/ts-rs/FilterReducer.d.ts +0 -1
- package/dist/esm/ts-rs/FilterTerm.d.ts +0 -2
- package/dist/esm/ts-rs/GroupRollupMode.d.ts +0 -1
- package/dist/esm/ts-rs/JoinOptions.d.ts +0 -9
- package/dist/esm/ts-rs/JoinType.d.ts +0 -1
- package/dist/esm/ts-rs/ListFlatten.d.ts +0 -1
- package/dist/esm/ts-rs/OnRemoveData.d.ts +0 -6
- package/dist/esm/ts-rs/OnUpdateData.d.ts +0 -6
- package/dist/esm/ts-rs/OnUpdateMode.d.ts +0 -9
- package/dist/esm/ts-rs/OnUpdateOptions.d.ts +0 -7
- package/dist/esm/ts-rs/Scalar.d.ts +0 -5
- package/dist/esm/ts-rs/Sort.d.ts +0 -2
- package/dist/esm/ts-rs/SortDir.d.ts +0 -1
- package/dist/esm/ts-rs/SplitRollupMode.d.ts +0 -9
- package/dist/esm/ts-rs/SystemInfo.d.ts +0 -40
- package/dist/esm/ts-rs/TableInitOptions.d.ts +0 -45
- package/dist/esm/ts-rs/TableReadFormat.d.ts +0 -7
- package/dist/esm/ts-rs/TypedArrayWindow.d.ts +0 -33
- package/dist/esm/ts-rs/UpdateOptions.d.ts +0 -8
- package/dist/esm/ts-rs/ViewConfig.d.ts +0 -24
- package/dist/esm/ts-rs/ViewConfigUpdate.d.ts +0 -116
- package/dist/esm/ts-rs/ViewOnRemoveResp.d.ts +0 -4
- package/dist/esm/ts-rs/ViewOnUpdateResp.d.ts +0 -4
- package/dist/esm/ts-rs/ViewWindow.d.ts +0 -30
- package/dist/esm/ts-rs/WindowAggSpec.d.ts +0 -25
- package/dist/esm/ts-rs/WindowSort.d.ts +0 -7
- package/dist/esm/ts-rs/WindowSortDir.d.ts +0 -6
- package/dist/esm/ts-rs/WindowSpec.d.ts +0 -47
- package/dist/esm/ts-rs/Windows.d.ts +0 -10
- package/src/rust/client.rs +0 -590
- package/src/rust/generic_sql_model.rs +0 -276
- package/src/rust/lib.rs +0 -99
- package/src/rust/table.rs +0 -397
- package/src/rust/table_data.rs +0 -164
- package/src/rust/typed_array.rs +0 -386
- package/src/rust/utils/browser.rs +0 -35
- package/src/rust/utils/console_logger.rs +0 -237
- package/src/rust/utils/errors.rs +0 -274
- package/src/rust/utils/futures.rs +0 -274
- package/src/rust/utils/json.rs +0 -252
- package/src/rust/utils/local_poll_loop.rs +0 -63
- package/src/rust/utils/mod.rs +0 -32
- package/src/rust/utils/serde.rs +0 -46
- package/src/rust/utils/trace_allocator.rs +0 -98
- package/src/rust/view.rs +0 -463
- package/src/rust/virtual_server.rs +0 -991
- package/src/ts/perspective-server.worker.ts +0 -74
- package/src/ts/perspective.browser.ts +0 -380
- package/src/ts/perspective.cdn.ts +0 -28
- package/src/ts/perspective.node.ts +0 -556
- package/src/ts/ts-rs/ListFlatten.ts +0 -3
- package/src/ts/ts-rs/TableInitOptions.ts +0 -42
- package/src/ts/virtual_server.ts +0 -83
- package/src/ts/virtual_servers/clickhouse.ts +0 -533
- package/src/ts/virtual_servers/duckdb.ts +0 -549
- package/src/ts/wasm/browser.ts +0 -134
- package/src/ts/wasm/cdn.ts +0 -32
- package/src/ts/wasm/decompress.ts +0 -64
- package/src/ts/wasm/emscripten_api.ts +0 -91
- package/src/ts/wasm/engine.ts +0 -309
- package/src/ts/wasm/features.ts +0 -31
- package/src/ts/wasm/perspective-server.poly.ts +0 -460
- package/src/ts/websocket.ts +0 -95
- package/tsconfig.json +0 -22
- /package/{src/ts/ts-rs/Aggregate.ts → dist/ts-rs/Aggregate.d.ts} +0 -0
- /package/{src/ts/ts-rs/ColumnType.ts → dist/ts-rs/ColumnType.d.ts} +0 -0
- /package/{src/ts/ts-rs/ColumnWindow.ts → dist/ts-rs/ColumnWindow.d.ts} +0 -0
- /package/{src/ts/ts-rs/DeleteOptions.ts → dist/ts-rs/DeleteOptions.d.ts} +0 -0
- /package/{src/ts/ts-rs/Expressions.ts → dist/ts-rs/Expressions.d.ts} +0 -0
- /package/{src/ts/ts-rs/FilterReducer.ts → dist/ts-rs/FilterReducer.d.ts} +0 -0
- /package/{src/ts/ts-rs/GroupRollupMode.ts → dist/ts-rs/GroupRollupMode.d.ts} +0 -0
- /package/{src/ts/ts-rs/JoinType.ts → dist/ts-rs/JoinType.d.ts} +0 -0
- /package/{src/ts/ts-rs/OnUpdateMode.ts → dist/ts-rs/OnUpdateMode.d.ts} +0 -0
- /package/{src/ts/ts-rs/Scalar.ts → dist/ts-rs/Scalar.d.ts} +0 -0
- /package/{src/ts/ts-rs/SortDir.ts → dist/ts-rs/SortDir.d.ts} +0 -0
- /package/{src/ts/ts-rs/SplitRollupMode.ts → dist/ts-rs/SplitRollupMode.d.ts} +0 -0
- /package/{src/ts/ts-rs/SystemInfo.ts → dist/ts-rs/SystemInfo.d.ts} +0 -0
- /package/{src/ts/ts-rs/TableReadFormat.ts → dist/ts-rs/TableReadFormat.d.ts} +0 -0
- /package/{src/ts/ts-rs/TypedArrayWindow.ts → dist/ts-rs/TypedArrayWindow.d.ts} +0 -0
- /package/{src/ts/ts-rs/ViewOnRemoveResp.ts → dist/ts-rs/ViewOnRemoveResp.d.ts} +0 -0
- /package/{src/ts/ts-rs/ViewOnUpdateResp.ts → dist/ts-rs/ViewOnUpdateResp.d.ts} +0 -0
- /package/{src/ts/ts-rs/ViewWindow.ts → dist/ts-rs/ViewWindow.d.ts} +0 -0
- /package/{src/ts/ts-rs/WindowSortDir.ts → dist/ts-rs/WindowSortDir.d.ts} +0 -0
package/src/rust/client.rs
DELETED
|
@@ -1,590 +0,0 @@
|
|
|
1
|
-
// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
|
|
2
|
-
// ┃ ██████ ██████ ██████ █ █ █ █ █ █▄ ▀███ █ ┃
|
|
3
|
-
// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█ ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄ ▀█ █ ▀▀▀▀▀ ┃
|
|
4
|
-
// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄ █ ▄▄▄▄▄ ┃
|
|
5
|
-
// ┃ █ ██████ █ ▀█▄ █ ██████ █ ███▌▐███ ███████▄ █ ┃
|
|
6
|
-
// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
|
|
7
|
-
// ┃ Copyright (c) 2017, the Perspective Authors. ┃
|
|
8
|
-
// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
|
|
9
|
-
// ┃ This file is part of the Perspective library, distributed under the terms ┃
|
|
10
|
-
// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
|
|
11
|
-
// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
|
|
12
|
-
|
|
13
|
-
use std::error::Error;
|
|
14
|
-
use std::future::Future;
|
|
15
|
-
use std::sync::Arc;
|
|
16
|
-
|
|
17
|
-
use derivative::Derivative;
|
|
18
|
-
use futures::channel::oneshot;
|
|
19
|
-
use js_sys::{Function, Uint8Array};
|
|
20
|
-
#[cfg(doc)]
|
|
21
|
-
use perspective_client::SystemInfo;
|
|
22
|
-
use perspective_client::{
|
|
23
|
-
ClientError, ReconnectCallback, Session, TableData, TableInitOptions, TableRef, asyncfn,
|
|
24
|
-
};
|
|
25
|
-
use wasm_bindgen::prelude::*;
|
|
26
|
-
use wasm_bindgen_derive::TryFromJsValue;
|
|
27
|
-
use wasm_bindgen_futures::{JsFuture, future_to_promise};
|
|
28
|
-
|
|
29
|
-
pub use crate::table::*;
|
|
30
|
-
use crate::utils::{ApiError, ApiResult, JsValueSerdeExt, LocalPollLoop};
|
|
31
|
-
use crate::{TableDataExt, apierror};
|
|
32
|
-
|
|
33
|
-
#[wasm_bindgen]
|
|
34
|
-
extern "C" {
|
|
35
|
-
#[derive(Clone)]
|
|
36
|
-
#[wasm_bindgen(typescript_type = "TableInitOptions")]
|
|
37
|
-
pub type JsTableInitOptions;
|
|
38
|
-
|
|
39
|
-
#[derive(Clone)]
|
|
40
|
-
#[wasm_bindgen(typescript_type = "JoinOptions")]
|
|
41
|
-
pub type JsJoinOptions;
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
async fn js_to_table_ref(val: &JsValue) -> ApiResult<TableRef> {
|
|
45
|
-
if let Some(name) = val.as_string() {
|
|
46
|
-
Ok(TableRef::from(name))
|
|
47
|
-
} else {
|
|
48
|
-
let get_name = js_sys::Reflect::get(val, &wasm_bindgen::intern("get_name").into())
|
|
49
|
-
.map_err(|_| apierror!(TableRefError))?
|
|
50
|
-
.dyn_into::<js_sys::Function>()
|
|
51
|
-
.map_err(|_| apierror!(TableRefError))?;
|
|
52
|
-
|
|
53
|
-
let promise = get_name
|
|
54
|
-
.call0(val)
|
|
55
|
-
.map_err(|_| apierror!(TableRefError))?
|
|
56
|
-
.dyn_into::<js_sys::Promise>()
|
|
57
|
-
.map_err(|_| apierror!(TableRefError))?;
|
|
58
|
-
|
|
59
|
-
let name = wasm_bindgen_futures::JsFuture::from(promise)
|
|
60
|
-
.await
|
|
61
|
-
.map_err(|_| apierror!(TableRefError))?
|
|
62
|
-
.as_string()
|
|
63
|
-
.ok_or_else(|| apierror!(TableRefError))?;
|
|
64
|
-
|
|
65
|
-
Ok(TableRef::from(name))
|
|
66
|
-
}
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
#[wasm_bindgen]
|
|
70
|
-
#[derive(Clone)]
|
|
71
|
-
pub struct ProxySession(perspective_client::ProxySession);
|
|
72
|
-
|
|
73
|
-
#[wasm_bindgen]
|
|
74
|
-
impl ProxySession {
|
|
75
|
-
#[wasm_bindgen(constructor)]
|
|
76
|
-
pub fn new(client: &Client, on_response: &Function) -> Self {
|
|
77
|
-
let poll_loop = LocalPollLoop::new({
|
|
78
|
-
let on_response = on_response.clone();
|
|
79
|
-
move |msg: Vec<u8>| {
|
|
80
|
-
let msg = Uint8Array::from(&msg[..]);
|
|
81
|
-
on_response.call1(&JsValue::UNDEFINED, &JsValue::from(msg))?;
|
|
82
|
-
Ok(JsValue::null())
|
|
83
|
-
}
|
|
84
|
-
});
|
|
85
|
-
// NB: This swallows any errors raised by the inner callback
|
|
86
|
-
let on_response = Box::new(move |msg: &[u8]| {
|
|
87
|
-
wasm_bindgen_futures::spawn_local(poll_loop.poll(msg.to_vec()));
|
|
88
|
-
Ok(())
|
|
89
|
-
});
|
|
90
|
-
Self(perspective_client::ProxySession::new(
|
|
91
|
-
client.client.clone(),
|
|
92
|
-
on_response,
|
|
93
|
-
))
|
|
94
|
-
}
|
|
95
|
-
|
|
96
|
-
#[wasm_bindgen]
|
|
97
|
-
pub async fn handle_request(&self, value: JsValue) -> ApiResult<()> {
|
|
98
|
-
let uint8array = Uint8Array::new(&value);
|
|
99
|
-
let slice = uint8array.to_vec();
|
|
100
|
-
self.0.handle_request(&slice).await?;
|
|
101
|
-
Ok(())
|
|
102
|
-
}
|
|
103
|
-
|
|
104
|
-
pub async fn close(self) {
|
|
105
|
-
self.0.close().await;
|
|
106
|
-
}
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
/// An instance of a [`Client`] is a connection to a single
|
|
110
|
-
/// `perspective_server::Server`, whether locally in-memory or remote over some
|
|
111
|
-
/// transport like a WebSocket.
|
|
112
|
-
///
|
|
113
|
-
/// The browser and node.js libraries both support the `websocket(url)`
|
|
114
|
-
/// constructor, which connects to a remote `perspective_server::Server`
|
|
115
|
-
/// instance over a WebSocket transport.
|
|
116
|
-
///
|
|
117
|
-
/// In the browser, the `worker()` constructor creates a new Web Worker
|
|
118
|
-
/// `perspective_server::Server` and returns a [`Client`] connected to it.
|
|
119
|
-
///
|
|
120
|
-
/// In node.js, a pre-instantied [`Client`] connected synhronously to a global
|
|
121
|
-
/// singleton `perspective_server::Server` is the default module export.
|
|
122
|
-
///
|
|
123
|
-
/// # JavaScript Examples
|
|
124
|
-
///
|
|
125
|
-
/// Create a Web Worker `perspective_server::Server` in the browser and return a
|
|
126
|
-
/// [`Client`] instance connected for it:
|
|
127
|
-
///
|
|
128
|
-
/// ```javascript
|
|
129
|
-
/// import perspective from "@perspective-dev/client";
|
|
130
|
-
/// const client = await perspective.worker();
|
|
131
|
-
/// ```
|
|
132
|
-
///
|
|
133
|
-
/// Create a WebSocket connection to a remote `perspective_server::Server`:
|
|
134
|
-
///
|
|
135
|
-
/// ```javascript
|
|
136
|
-
/// import perspective from "@perspective-dev/client";
|
|
137
|
-
/// const client = await perspective.websocket("ws://locahost:8080/ws");
|
|
138
|
-
/// ```
|
|
139
|
-
///
|
|
140
|
-
/// Access the synchronous client in node.js:
|
|
141
|
-
///
|
|
142
|
-
/// ```javascript
|
|
143
|
-
/// import { default as client } from "@perspective-dev/client";
|
|
144
|
-
/// ```
|
|
145
|
-
#[wasm_bindgen]
|
|
146
|
-
#[derive(TryFromJsValue, Clone)]
|
|
147
|
-
pub struct Client {
|
|
148
|
-
pub(crate) client: perspective_client::Client,
|
|
149
|
-
pub(crate) close: Option<Function>,
|
|
150
|
-
}
|
|
151
|
-
|
|
152
|
-
impl From<perspective_client::Client> for Client {
|
|
153
|
-
fn from(client: perspective_client::Client) -> Self {
|
|
154
|
-
Client {
|
|
155
|
-
client,
|
|
156
|
-
close: None,
|
|
157
|
-
}
|
|
158
|
-
}
|
|
159
|
-
}
|
|
160
|
-
|
|
161
|
-
impl PartialEq for Client {
|
|
162
|
-
fn eq(&self, other: &Self) -> bool {
|
|
163
|
-
self.client.get_name() == other.client.get_name()
|
|
164
|
-
}
|
|
165
|
-
}
|
|
166
|
-
|
|
167
|
-
/// A wrapper around [`js_sys::Function`] to ease async integration for the
|
|
168
|
-
/// `reconnect` argument of [`Client::on_error`] callback.
|
|
169
|
-
#[derive(Derivative)]
|
|
170
|
-
#[derivative(Clone(bound = ""))]
|
|
171
|
-
struct JsReconnect<I>(Arc<dyn Fn(I) -> js_sys::Promise>);
|
|
172
|
-
|
|
173
|
-
// This type is not thread safe, but the JavaScript environment does not allow
|
|
174
|
-
// threading.
|
|
175
|
-
unsafe impl<I> Send for JsReconnect<I> {}
|
|
176
|
-
unsafe impl<I> Sync for JsReconnect<I> {}
|
|
177
|
-
|
|
178
|
-
impl<I> JsReconnect<I> {
|
|
179
|
-
fn run(&self, args: I) -> js_sys::Promise {
|
|
180
|
-
self.0(args)
|
|
181
|
-
}
|
|
182
|
-
|
|
183
|
-
fn run_all(
|
|
184
|
-
&self,
|
|
185
|
-
args: I,
|
|
186
|
-
) -> impl Future<Output = Result<(), Box<dyn Error + Send + Sync + 'static>>>
|
|
187
|
-
+ Send
|
|
188
|
-
+ Sync
|
|
189
|
-
+ 'static
|
|
190
|
-
+ use<I> {
|
|
191
|
-
let (sender, receiver) = oneshot::channel::<Result<(), Box<dyn Error + Send + Sync>>>();
|
|
192
|
-
let p = self.0(args);
|
|
193
|
-
let _ = future_to_promise(async move {
|
|
194
|
-
let result = JsFuture::from(p)
|
|
195
|
-
.await
|
|
196
|
-
.map(|_| ())
|
|
197
|
-
.map_err(|x| format!("{x:?}").into());
|
|
198
|
-
|
|
199
|
-
sender.send(result).unwrap();
|
|
200
|
-
Ok(JsValue::UNDEFINED)
|
|
201
|
-
});
|
|
202
|
-
|
|
203
|
-
async move { receiver.await.unwrap() }
|
|
204
|
-
}
|
|
205
|
-
}
|
|
206
|
-
|
|
207
|
-
impl<F, I> From<F> for JsReconnect<I>
|
|
208
|
-
where
|
|
209
|
-
F: Fn(I) -> js_sys::Promise + 'static,
|
|
210
|
-
{
|
|
211
|
-
fn from(value: F) -> Self {
|
|
212
|
-
JsReconnect(Arc::new(value))
|
|
213
|
-
}
|
|
214
|
-
}
|
|
215
|
-
|
|
216
|
-
impl Client {
|
|
217
|
-
pub fn get_client(&self) -> &'_ perspective_client::Client {
|
|
218
|
-
&self.client
|
|
219
|
-
}
|
|
220
|
-
}
|
|
221
|
-
|
|
222
|
-
#[wasm_bindgen]
|
|
223
|
-
impl Client {
|
|
224
|
-
#[wasm_bindgen(constructor)]
|
|
225
|
-
pub fn new(send_request: Function, close: Option<Function>) -> ApiResult<Self> {
|
|
226
|
-
let send_request = JsReconnect::from(move |mut v: Vec<u8>| {
|
|
227
|
-
let buff2 = unsafe { js_sys::Uint8Array::view_mut_raw(v.as_mut_ptr(), v.len()) };
|
|
228
|
-
send_request
|
|
229
|
-
.call1(&JsValue::UNDEFINED, &buff2)
|
|
230
|
-
.unwrap()
|
|
231
|
-
.unchecked_into::<js_sys::Promise>()
|
|
232
|
-
});
|
|
233
|
-
|
|
234
|
-
let client = perspective_client::Client::new_with_callback(None, move |msg| {
|
|
235
|
-
send_request.run_all(msg)
|
|
236
|
-
})?;
|
|
237
|
-
|
|
238
|
-
Ok(Client { close, client })
|
|
239
|
-
}
|
|
240
|
-
|
|
241
|
-
#[wasm_bindgen]
|
|
242
|
-
pub fn new_proxy_session(&self, on_response: &Function) -> ProxySession {
|
|
243
|
-
ProxySession::new(self, on_response)
|
|
244
|
-
}
|
|
245
|
-
|
|
246
|
-
#[wasm_bindgen]
|
|
247
|
-
pub async fn handle_response(&self, value: &JsValue) -> ApiResult<()> {
|
|
248
|
-
let uint8array = Uint8Array::new(value);
|
|
249
|
-
let slice = uint8array.to_vec();
|
|
250
|
-
self.client.handle_response(&slice).await?;
|
|
251
|
-
Ok(())
|
|
252
|
-
}
|
|
253
|
-
|
|
254
|
-
#[wasm_bindgen]
|
|
255
|
-
pub async fn handle_error(&self, error: String, reconnect: Option<Function>) -> ApiResult<()> {
|
|
256
|
-
self.client
|
|
257
|
-
.handle_error(
|
|
258
|
-
ClientError::Unknown(error),
|
|
259
|
-
reconnect.map(|reconnect| {
|
|
260
|
-
let reconnect =
|
|
261
|
-
JsReconnect::from(move |()| match reconnect.call0(&JsValue::UNDEFINED) {
|
|
262
|
-
Ok(x) => x.unchecked_into::<js_sys::Promise>(),
|
|
263
|
-
Err(e) => {
|
|
264
|
-
// This error may occur when _invoking_ the
|
|
265
|
-
// function
|
|
266
|
-
tracing::warn!("{:?}", e);
|
|
267
|
-
js_sys::Promise::reject(&format!("C {e:?}").into())
|
|
268
|
-
},
|
|
269
|
-
});
|
|
270
|
-
|
|
271
|
-
asyncfn!(reconnect, async move || {
|
|
272
|
-
if let Err(e) = JsFuture::from(reconnect.run(())).await {
|
|
273
|
-
if let Some(e) = e.dyn_ref::<js_sys::Object>() {
|
|
274
|
-
Err(ClientError::Unknown(e.to_string().as_string().unwrap()))
|
|
275
|
-
} else {
|
|
276
|
-
Err(ClientError::Unknown(e.as_string().unwrap()))
|
|
277
|
-
}
|
|
278
|
-
} else {
|
|
279
|
-
Ok(())
|
|
280
|
-
}
|
|
281
|
-
})
|
|
282
|
-
}),
|
|
283
|
-
)
|
|
284
|
-
.await?;
|
|
285
|
-
|
|
286
|
-
Ok(())
|
|
287
|
-
}
|
|
288
|
-
|
|
289
|
-
#[wasm_bindgen]
|
|
290
|
-
pub async fn on_error(&self, callback: Function) -> ApiResult<u32> {
|
|
291
|
-
let callback = JsReconnect::from(
|
|
292
|
-
move |(message, reconnect): (ClientError, Option<ReconnectCallback>)| {
|
|
293
|
-
let cl: Closure<dyn Fn() -> js_sys::Promise> = Closure::new(move || {
|
|
294
|
-
let reconnect = reconnect.clone();
|
|
295
|
-
future_to_promise(async move {
|
|
296
|
-
if let Some(f) = reconnect {
|
|
297
|
-
(*f)().await.map_err(|e| JsValue::from(format!("A {e}")))?;
|
|
298
|
-
}
|
|
299
|
-
|
|
300
|
-
Ok(JsValue::UNDEFINED)
|
|
301
|
-
})
|
|
302
|
-
});
|
|
303
|
-
|
|
304
|
-
if let Err(e) = callback.call2(
|
|
305
|
-
&JsValue::UNDEFINED,
|
|
306
|
-
&JsValue::from(apierror!(ClientError(message))),
|
|
307
|
-
&cl.into_js_value(),
|
|
308
|
-
) {
|
|
309
|
-
tracing::warn!("{:?}", e);
|
|
310
|
-
}
|
|
311
|
-
|
|
312
|
-
js_sys::Promise::resolve(&JsValue::UNDEFINED)
|
|
313
|
-
},
|
|
314
|
-
);
|
|
315
|
-
|
|
316
|
-
let poll_loop = LocalPollLoop::new_async(move |x| JsFuture::from(callback.run(x)));
|
|
317
|
-
let id = self
|
|
318
|
-
.client
|
|
319
|
-
.on_error(asyncfn!(poll_loop, async move |message, reconnect| {
|
|
320
|
-
poll_loop.poll((message, reconnect)).await;
|
|
321
|
-
Ok(())
|
|
322
|
-
}))
|
|
323
|
-
.await?;
|
|
324
|
-
|
|
325
|
-
Ok(id)
|
|
326
|
-
}
|
|
327
|
-
|
|
328
|
-
/// Creates a new [`Table`] from either a _schema_ or _data_.
|
|
329
|
-
///
|
|
330
|
-
/// The [`Client::table`] factory function can be initialized with either a
|
|
331
|
-
/// _schema_ (see [`Table::schema`]), or data in one of these formats:
|
|
332
|
-
///
|
|
333
|
-
/// - Apache Arrow
|
|
334
|
-
/// - CSV
|
|
335
|
-
/// - JSON row-oriented
|
|
336
|
-
/// - JSON column-oriented
|
|
337
|
-
/// - NDJSON
|
|
338
|
-
///
|
|
339
|
-
/// When instantiated with _data_, the schema is inferred from this data.
|
|
340
|
-
/// While this is convenient, inferrence is sometimes imperfect e.g.
|
|
341
|
-
/// when the input is empty, null or ambiguous. For these cases,
|
|
342
|
-
/// [`Client::table`] can first be instantiated with a explicit schema.
|
|
343
|
-
///
|
|
344
|
-
/// When instantiated with a _schema_, the resulting [`Table`] is empty but
|
|
345
|
-
/// with known column names and column types. When subsqeuently
|
|
346
|
-
/// populated with [`Table::update`], these columns will be _coerced_ to
|
|
347
|
-
/// the schema's type. This behavior can be useful when
|
|
348
|
-
/// [`Client::table`]'s column type inferences doesn't work.
|
|
349
|
-
///
|
|
350
|
-
/// The resulting [`Table`] is _virtual_, and invoking its methods
|
|
351
|
-
/// dispatches events to the `perspective_server::Server` this
|
|
352
|
-
/// [`Client`] connects to, where the data is stored and all calculation
|
|
353
|
-
/// occurs.
|
|
354
|
-
///
|
|
355
|
-
/// # Arguments
|
|
356
|
-
///
|
|
357
|
-
/// - `arg` - Either _schema_ or initialization _data_.
|
|
358
|
-
/// - `options` - Optional configuration which provides one of:
|
|
359
|
-
/// - `limit` - The max number of rows the resulting [`Table`] can
|
|
360
|
-
/// store.
|
|
361
|
-
/// - `index` - The column name to use as an _index_ column. If this
|
|
362
|
-
/// `Table` is being instantiated by _data_, this column name must be
|
|
363
|
-
/// present in the data.
|
|
364
|
-
/// - `name` - The name of the table. This will be generated if it is
|
|
365
|
-
/// not provided.
|
|
366
|
-
/// - `format` - The explicit format of the input data, can be one of
|
|
367
|
-
/// `"json"`, `"columns"`, `"csv"` or `"arrow"`. This overrides
|
|
368
|
-
/// language-specific type dispatch behavior, which allows stringified
|
|
369
|
-
/// and byte array alternative inputs.
|
|
370
|
-
///
|
|
371
|
-
/// # JavaScript Examples
|
|
372
|
-
///
|
|
373
|
-
/// Load a CSV from a `string`:
|
|
374
|
-
///
|
|
375
|
-
/// ```javascript
|
|
376
|
-
/// const table = await client.table("x,y\n1,2\n3,4");
|
|
377
|
-
/// ```
|
|
378
|
-
///
|
|
379
|
-
/// Load an Arrow from an `ArrayBuffer`:
|
|
380
|
-
///
|
|
381
|
-
/// ```javascript
|
|
382
|
-
/// import * as fs from "node:fs/promises";
|
|
383
|
-
/// const table2 = await client.table(await fs.readFile("superstore.arrow"));
|
|
384
|
-
/// ```
|
|
385
|
-
///
|
|
386
|
-
/// Load a CSV from a `UInt8Array` (the default for this type is Arrow)
|
|
387
|
-
/// using a format override:
|
|
388
|
-
///
|
|
389
|
-
/// ```javascript
|
|
390
|
-
/// const enc = new TextEncoder();
|
|
391
|
-
/// const table = await client.table(enc.encode("x,y\n1,2\n3,4"), {
|
|
392
|
-
/// format: "csv",
|
|
393
|
-
/// });
|
|
394
|
-
/// ```
|
|
395
|
-
///
|
|
396
|
-
/// Create a table with an `index`:
|
|
397
|
-
///
|
|
398
|
-
/// ```javascript
|
|
399
|
-
/// const table = await client.table(data, { index: "Row ID" });
|
|
400
|
-
/// ```
|
|
401
|
-
#[wasm_bindgen]
|
|
402
|
-
pub async fn table(
|
|
403
|
-
&self,
|
|
404
|
-
value: &JsTableInitData,
|
|
405
|
-
options: Option<JsTableInitOptions>,
|
|
406
|
-
) -> ApiResult<Table> {
|
|
407
|
-
let options = options
|
|
408
|
-
.into_serde_ext::<Option<TableInitOptions>>()?
|
|
409
|
-
.unwrap_or_default();
|
|
410
|
-
|
|
411
|
-
let args = TableData::from_js_value(value, options.format)?;
|
|
412
|
-
Ok(Table(self.client.table(args, options).await?))
|
|
413
|
-
}
|
|
414
|
-
|
|
415
|
-
/// Creates a new read-only [`Table`] by performing an INNER JOIN on two
|
|
416
|
-
/// source tables. The resulting table is reactive: when either source
|
|
417
|
-
/// table is updated, the join is automatically recomputed.
|
|
418
|
-
///
|
|
419
|
-
/// # Arguments
|
|
420
|
-
///
|
|
421
|
-
/// - `left` - The left source table (a [`Table`] instance or a table name
|
|
422
|
-
/// string).
|
|
423
|
-
/// - `right` - The right source table (a [`Table`] instance or a table name
|
|
424
|
-
/// string).
|
|
425
|
-
/// - `on` - The column name to join on. Must exist in both tables with the
|
|
426
|
-
/// same type.
|
|
427
|
-
/// - `options` - Optional join configuration: `{ join_type?: "inner" |
|
|
428
|
-
/// "left" | "outer", name?: string }`.
|
|
429
|
-
///
|
|
430
|
-
/// # JavaScript Examples
|
|
431
|
-
///
|
|
432
|
-
/// ```javascript
|
|
433
|
-
/// const joined = await client.join(orders_table, products_table, "Product ID", { join_type: "left" });
|
|
434
|
-
/// const joined = await client.join("orders", "products", "Product ID", { join_type: "left" });
|
|
435
|
-
/// ```
|
|
436
|
-
#[wasm_bindgen]
|
|
437
|
-
pub async fn join(
|
|
438
|
-
&self,
|
|
439
|
-
left: JsValue,
|
|
440
|
-
right: JsValue,
|
|
441
|
-
on: &str,
|
|
442
|
-
options: Option<JsJoinOptions>,
|
|
443
|
-
) -> ApiResult<Table> {
|
|
444
|
-
let options = options
|
|
445
|
-
.into_serde_ext::<Option<perspective_client::JoinOptions>>()?
|
|
446
|
-
.unwrap_or_default();
|
|
447
|
-
|
|
448
|
-
let left_ref = js_to_table_ref(&left).await?;
|
|
449
|
-
let right_ref = js_to_table_ref(&right).await?;
|
|
450
|
-
Ok(Table(
|
|
451
|
-
self.client.join(left_ref, right_ref, on, options).await?,
|
|
452
|
-
))
|
|
453
|
-
}
|
|
454
|
-
|
|
455
|
-
/// Terminates this [`Client`], cleaning up any [`crate::View`] handles the
|
|
456
|
-
/// [`Client`] has open as well as its callbacks.
|
|
457
|
-
#[wasm_bindgen]
|
|
458
|
-
pub fn terminate(&self) -> ApiResult<JsValue> {
|
|
459
|
-
if let Some(f) = self.close.clone() {
|
|
460
|
-
Ok(f.call0(&JsValue::UNDEFINED)?)
|
|
461
|
-
} else {
|
|
462
|
-
Err(ApiError::new("Client type cannot be terminated"))
|
|
463
|
-
}
|
|
464
|
-
}
|
|
465
|
-
|
|
466
|
-
/// Opens a [`Table`] that is hosted on the `perspective_server::Server`
|
|
467
|
-
/// that is connected to this [`Client`].
|
|
468
|
-
///
|
|
469
|
-
/// The `name` property of [`TableInitOptions`] is used to identify each
|
|
470
|
-
/// [`Table`]. [`Table`] `name`s can be looked up for each [`Client`]
|
|
471
|
-
/// via [`Client::get_hosted_table_names`].
|
|
472
|
-
///
|
|
473
|
-
/// # JavaScript Examples
|
|
474
|
-
///
|
|
475
|
-
/// Get a virtual [`Table`] named "table_one" from this [`Client`]
|
|
476
|
-
///
|
|
477
|
-
/// ```javascript
|
|
478
|
-
/// const tables = await client.open_table("table_one");
|
|
479
|
-
/// ```
|
|
480
|
-
#[wasm_bindgen]
|
|
481
|
-
pub async fn open_table(&self, entity_id: String) -> ApiResult<Table> {
|
|
482
|
-
Ok(Table(self.client.open_table(entity_id).await?))
|
|
483
|
-
}
|
|
484
|
-
|
|
485
|
-
/// Unsafely gets a [`View`] by raw ID, useful for JavaScript multi-threaded
|
|
486
|
-
/// (via Web Worker) context where a standard `View` cannot otherwise be
|
|
487
|
-
/// shared because its wrapper is not serializable.
|
|
488
|
-
///
|
|
489
|
-
/// # Safety
|
|
490
|
-
///
|
|
491
|
-
/// This method is unsafe because the lifetime of a [`View`] is bound to
|
|
492
|
-
/// the [`Client`] which created it.
|
|
493
|
-
///
|
|
494
|
-
/// The caller must guarantee that `entity_id` corresponds to a live
|
|
495
|
-
/// [`crate::View`] on the connected server (obtained from another
|
|
496
|
-
/// [`Client`]'s [`crate::View::get_name`] and forwarded across the
|
|
497
|
-
/// serialization boundary).
|
|
498
|
-
///
|
|
499
|
-
/// # JavaScript Examples
|
|
500
|
-
///
|
|
501
|
-
/// ```javascript
|
|
502
|
-
/// const view = client.__unsafe_open_view(name_from_main_thread);
|
|
503
|
-
/// const cols = await view.to_columns();
|
|
504
|
-
/// ```
|
|
505
|
-
#[wasm_bindgen]
|
|
506
|
-
pub fn __unsafe_open_view(&self, entity_id: String) -> crate::view::View {
|
|
507
|
-
crate::view::View(perspective_client::View::new(
|
|
508
|
-
entity_id,
|
|
509
|
-
self.client.clone(),
|
|
510
|
-
))
|
|
511
|
-
}
|
|
512
|
-
|
|
513
|
-
/// Retrieves the names of all tables that this client has access to.
|
|
514
|
-
///
|
|
515
|
-
/// `name` is a string identifier unique to the [`Table`] (per [`Client`]),
|
|
516
|
-
/// which can be used in conjunction with [`Client::open_table`] to get
|
|
517
|
-
/// a [`Table`] instance without the use of [`Client::table`]
|
|
518
|
-
/// constructor directly (e.g., one created by another [`Client`]).
|
|
519
|
-
///
|
|
520
|
-
/// # JavaScript Examples
|
|
521
|
-
///
|
|
522
|
-
/// ```javascript
|
|
523
|
-
/// const tables = await client.get_hosted_table_names();
|
|
524
|
-
/// ```
|
|
525
|
-
#[wasm_bindgen]
|
|
526
|
-
pub async fn get_hosted_table_names(&self) -> ApiResult<Vec<String>> {
|
|
527
|
-
Ok(self.client.get_hosted_table_names().await?)
|
|
528
|
-
}
|
|
529
|
-
|
|
530
|
-
/// Register a callback which is invoked whenever [`Client::table`] (on this
|
|
531
|
-
/// [`Client`]) or [`Table::delete`] (on a [`Table`] belinging to this
|
|
532
|
-
/// [`Client`]) are called.
|
|
533
|
-
#[wasm_bindgen]
|
|
534
|
-
pub async fn on_hosted_tables_update(&self, on_update_js: Function) -> ApiResult<u32> {
|
|
535
|
-
let poll_loop = LocalPollLoop::new(move |_| on_update_js.call0(&JsValue::UNDEFINED));
|
|
536
|
-
let on_update = Box::new(move || poll_loop.poll(()));
|
|
537
|
-
let id = self.client.on_hosted_tables_update(on_update).await?;
|
|
538
|
-
Ok(id)
|
|
539
|
-
}
|
|
540
|
-
|
|
541
|
-
/// Remove a callback previously registered via
|
|
542
|
-
/// `Client::on_hosted_tables_update`.
|
|
543
|
-
#[wasm_bindgen]
|
|
544
|
-
pub async fn remove_hosted_tables_update(&self, update_id: u32) -> ApiResult<()> {
|
|
545
|
-
self.client.remove_hosted_tables_update(update_id).await?;
|
|
546
|
-
Ok(())
|
|
547
|
-
}
|
|
548
|
-
|
|
549
|
-
/// Provides the [`SystemInfo`] struct, implementation-specific metadata
|
|
550
|
-
/// about the [`perspective_server::Server`] runtime such as Memory and
|
|
551
|
-
/// CPU usage.
|
|
552
|
-
///
|
|
553
|
-
/// For WebAssembly servers, this method includes the WebAssembly heap size.
|
|
554
|
-
///
|
|
555
|
-
/// # JavaScript Examples
|
|
556
|
-
///
|
|
557
|
-
/// ```javascript
|
|
558
|
-
/// const info = await client.system_info();
|
|
559
|
-
/// ```
|
|
560
|
-
#[wasm_bindgen]
|
|
561
|
-
pub async fn system_info(&self) -> ApiResult<JsSystemInfo> {
|
|
562
|
-
let mut info = self.client.system_info().await?;
|
|
563
|
-
|
|
564
|
-
#[cfg(feature = "trace-allocator")]
|
|
565
|
-
if let perspective_client::SystemInfo {
|
|
566
|
-
client_used: None,
|
|
567
|
-
client_heap: None,
|
|
568
|
-
..
|
|
569
|
-
} = &info
|
|
570
|
-
{
|
|
571
|
-
let (client_used, client_heap) = crate::utils::get_used();
|
|
572
|
-
info.client_used = Some(client_used as u64);
|
|
573
|
-
info.client_heap = Some(client_heap as u64);
|
|
574
|
-
};
|
|
575
|
-
|
|
576
|
-
let timestamp = web_sys::window()
|
|
577
|
-
.and_then(|x| x.performance())
|
|
578
|
-
.map(|x| x.now() as u64);
|
|
579
|
-
|
|
580
|
-
info.timestamp = timestamp;
|
|
581
|
-
let record = JsValue::from_serde_ext(&info.cast::<f64>())?;
|
|
582
|
-
Ok(record.unchecked_into())
|
|
583
|
-
}
|
|
584
|
-
}
|
|
585
|
-
|
|
586
|
-
#[wasm_bindgen]
|
|
587
|
-
extern "C" {
|
|
588
|
-
#[wasm_bindgen(typescript_type = "SystemInfo")]
|
|
589
|
-
pub type JsSystemInfo;
|
|
590
|
-
}
|