perspective_js/

virtual_server.rs

// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
// ┃ This file is part of the Perspective library, distributed under the terms ┃
// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

use std::cell::UnsafeCell;
use std::future::Future;
use std::pin::Pin;
use std::rc::Rc;
use std::str::FromStr;
use std::sync::{Arc, Mutex};

use indexmap::IndexMap;
use js_sys::{Array, Date, Object, Reflect, Uint8Array};
use perspective_client::proto::{ColumnType, HostedTable};
use perspective_client::virtual_server::{Features, ResultExt, VirtualServerHandler};
use perspective_client::{DescribeError, DescribeVerdict, Description, virtual_server};
use serde::Serialize;
use wasm_bindgen::prelude::*;
use wasm_bindgen_futures::JsFuture;

use crate::JsViewConfig;
use crate::utils::{ApiError, ApiFuture, *};

type HandlerFuture<T> = Pin<Box<dyn Future<Output = T>>>;

#[derive(Debug)]
pub struct JsError(JsValue);

impl std::fmt::Display for JsError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{:?}", self.0)
    }
}

impl std::error::Error for JsError {}

impl From<JsValue> for JsError {
    fn from(value: JsValue) -> Self {
        JsError(value)
    }
}

impl From<JsError> for JsValue {
    fn from(error: JsError) -> Self {
        error.0
    }
}

impl From<serde_wasm_bindgen::Error> for JsError {
    fn from(error: serde_wasm_bindgen::Error) -> Self {
        JsError(error.into())
    }
}

fn jsvalue_to_scalar(val: &JsValue) -> perspective_client::config::Scalar {
    if val.is_null() || val.is_undefined() {
        perspective_client::config::Scalar::Null
    } else if let Some(b) = val.as_bool() {
        perspective_client::config::Scalar::Bool(b)
    } else if let Some(n) = val.as_f64() {
        perspective_client::config::Scalar::Float(n)
    } else if let Some(s) = val.as_string() {
        perspective_client::config::Scalar::String(s)
    } else {
        perspective_client::config::Scalar::Null
    }
}

// This interface is the TypeScript contract for [`JsServerHandler`] below.
// There is no codegen tying the two together - every method dispatched via
// `Reflect::get` in this file MUST be declared here, with the exact argument
// and return types the `Reflect` call sites accept. Keep them in sync when
// editing either.
#[wasm_bindgen(typescript_custom_section)]
const TS_VIRTUAL_SERVER_HANDLER: &'static str = r#"
/**
 * A table hosted by a `VirtualServerHandler`, as returned by
 * `getHostedTables()`. A plain `string` is shorthand for `{ name }`.
 */
export interface VirtualHostedTable {
    name: string;
    index?: string | string[];
    limit?: number;
}

/** One expression's compile error, as reported by `tableDescribe`. */
export interface ExpressionError {
    error_message: string;
    line: number;
    column: number;
}

/** The verdict of `VirtualServerHandler.tableDescribe`. */
export type TableDescription =
    | {
          expression_schema: Record<string, ColumnType>;
          view_schema: Record<string, ColumnType>;
      }
    | {
          expression_schema?: Record<string, ColumnType>;
          expression_errors: Record<string, ExpressionError>;
      }
    | { config_error: string };

/**
 * Handler interface that you implement to provide custom data sources.
 *
 * All methods will be called by the `VirtualServer` when handling protocol
 * messages from Perspective clients. Methods can return values directly or
 * return Promises for asynchronous operations (e.g., database queries).
 * Optional methods fall back to defaults documented per-method.
 */
export interface VirtualServerHandler {
    getHostedTables():
        | (string | VirtualHostedTable)[]
        | Promise<(string | VirtualHostedTable)[]>;
    tableSchema(
        tableId: string,
    ): Record<string, ColumnType> | Promise<Record<string, ColumnType>>;
    tableSize(tableId: string): number | Promise<number>;
    tableMakeView(
        tableId: string,
        viewId: string,
        config: ViewConfigUpdate,
    ): void | Promise<void>;
    viewDelete(viewId: string): void | Promise<void>;
    viewGetData(
        viewId: string,
        config: ViewConfig,
        schema: Record<string, ColumnType>,
        viewport: ViewWindow,
        dataSlice: VirtualDataSlice,
    ): void | Promise<void>;

    /** Defaults to `tableSchema(viewId)`. */
    viewSchema?(
        viewId: string,
        config: ViewConfig,
    ): Record<string, ColumnType> | Promise<Record<string, ColumnType>>;

    /** Defaults to `tableSize(viewId)`. */
    viewSize?(viewId: string): number | Promise<number>;

    /** Defaults to the length of `tableSchema(tableId)`. */
    tableColumnsSize?(tableId: string): number | Promise<number>;

    /** Defaults to the length of `viewSchema(viewId, config)`. */
    viewColumnSize?(
        viewId: string,
        config: ViewConfig,
    ): number | Promise<number>;

    /**
     * Validate a complete view config against a table and report the schema
     * a view built from it would have, without creating one.
     */
    tableDescribe(
        tableId: string,
        config: ViewConfig,
    ): TableDescription | Promise<TableDescription>;

    viewGetMinMax?(
        viewId: string,
        columnName: string,
        config: ViewConfig,
    ): { min: Scalar; max: Scalar } | Promise<{ min: Scalar; max: Scalar }>;

    /**
     * Expand the row at `rowIndex` of a `"rollup"` mode `group_by` view to
     * show its children, each collapsed, returning the number of rows shown.
     * Required when `getFeatures()` declares `expand_collapse`.
     */
    viewExpand?(
        viewId: string,
        config: ViewConfig,
        rowIndex: number,
    ): number | Promise<number>;

    /**
     * Collapse the row at `rowIndex` of a `"rollup"` mode `group_by` view,
     * discarding its descendants' expansion, returning the number of rows
     * hidden. Required when `getFeatures()` declares `expand_collapse`.
     */
    viewCollapse?(
        viewId: string,
        config: ViewConfig,
        rowIndex: number,
    ): number | Promise<number>;

    /**
     * Expand every row of a `"rollup"` mode `group_by` view whose path is no
     * longer than `depth` and collapse the rest. Required when
     * `getFeatures()` declares `expand_collapse`.
     */
    viewSetDepth?(
        viewId: string,
        config: ViewConfig,
        depth: number,
    ): void | Promise<void>;

    /** Defaults to no optional features. */
    getFeatures?(): Features | Promise<Features>;

    /** Defaults to port `0`. */
    tableMakePort?(): number | Promise<number>;

    makeTable?(
        tableId: string,
        data: string | Uint8Array,
    ): void | Promise<void>;
    viewMakeTable?(
        viewId: string,
        tableId: string,
        config: ViewConfig,
        schema?: Record<string, ColumnType>,
    ): void | Promise<void>;
}
"#;

#[wasm_bindgen]
extern "C" {
    #[wasm_bindgen(typescript_type = "VirtualServerHandler")]
    pub type JsVirtualServerHandler;
}

pub struct JsServerHandler(Object);

impl JsServerHandler {
    fn call_method_js(&self, method: &str, args: &Array) -> Result<JsValue, JsError> {
        let func = Reflect::get(&self.0, &JsValue::from_str(method))?;
        let func = func
            .dyn_ref::<js_sys::Function>()
            .ok_or_else(|| JsError(JsValue::from_str(&format!("{} is not a function", method))))?;
        Ok(func.apply(&self.0, args)?)
    }

    /// Calls an optional `(viewId, config, n)` tree method, returning its
    /// numeric result (`0` when it returns nothing).
    fn call_tree_method(
        &self,
        method: &'static str,
        view_id: &str,
        config: &perspective_client::config::ViewConfig,
        arg: u32,
    ) -> impl Future<Output = Result<u32, JsError>> + 'static {
        let has_method = Reflect::get(&self.0, &JsValue::from_str(method))
            .map(|val| !val.is_undefined())
            .unwrap_or(false);

        let handler = self.0.clone();
        let view_id = view_id.to_string();
        let config_value = JsValue::from_serde_ext(config);
        async move {
            if !has_method {
                return Err(JsError(JsValue::from_str(&format!(
                    "{} not implemented",
                    method
                ))));
            }

            let this = JsServerHandler(handler);
            let args = Array::new();
            args.push(&JsValue::from_str(&view_id));
            args.push(&config_value?);
            args.push(&JsValue::from(arg));
            let result = this.call_method_js_async(method, &args).await?;
            Ok(result.as_f64().map_or(0, |x| x as u32))
        }
    }

    async fn call_method_js_async(&self, method: &str, args: &Array) -> Result<JsValue, JsError> {
        let result = self.call_method_js(method, args)?;

        // Check if result is a Promise
        if result.is_instance_of::<js_sys::Promise>() {
            let promise = js_sys::Promise::from(result);
            JsFuture::from(promise).await.map_err(JsError)
        } else {
            Ok(result)
        }
    }
}

impl VirtualServerHandler for JsServerHandler {
    type Error = JsError;

    fn get_features(&self) -> HandlerFuture<Result<Features<'_>, Self::Error>> {
        let has_method = Reflect::get(&self.0, &JsValue::from_str("getFeatures"))
            .map(|val| !val.is_undefined())
            .unwrap_or(false);

        if !has_method {
            return Box::pin(async { Ok(Features::default()) });
        }

        let handler = self.0.clone();
        Box::pin(async move {
            let this = JsServerHandler(handler);
            let args = Array::new();
            let result = this.call_method_js_async("getFeatures", &args).await?;
            Ok(serde_wasm_bindgen::from_value(result)?)
        })
    }

    fn get_hosted_tables(&self) -> HandlerFuture<Result<Vec<HostedTable>, Self::Error>> {
        let handler = self.0.clone();
        Box::pin(async move {
            let this = JsServerHandler(handler);
            let args = Array::new();
            let result = this.call_method_js_async("getHostedTables", &args).await?;
            let array = result.dyn_ref::<Array>().ok_or_else(|| {
                JsError(JsValue::from_str("getHostedTables must return an array"))
            })?;

            let mut tables = Vec::new();
            for i in 0..array.length() {
                let item = array.get(i);
                if let Some(s) = item.as_string() {
                    tables.push(HostedTable {
                        entity_id: s,
                        index: Vec::new(),
                        limit: None,
                    });
                } else if item.is_object() {
                    let name = Reflect::get(&item, &JsValue::from_str("name"))?
                        .as_string()
                        .ok_or_else(|| JsError(JsValue::from_str("name must be a string")))?;
                    let index = Reflect::get(&item, &JsValue::from_str("index"))
                        .ok()
                        .map(|v| {
                            if let Some(s) = v.as_string() {
                                vec![s]
                            } else if Array::is_array(&v) {
                                Array::from(&v)
                                    .iter()
                                    .filter_map(|x| x.as_string())
                                    .collect()
                            } else {
                                Vec::new()
                            }
                        })
                        .unwrap_or_default();
                    let limit = Reflect::get(&item, &JsValue::from_str("limit"))
                        .ok()
                        .and_then(|v| v.as_f64().map(|x| x as u32));
                    tables.push(HostedTable {
                        entity_id: name,
                        index,
                        limit,
                    });
                }
            }
            Ok(tables)
        })
    }

    fn table_schema(
        &self,
        table_id: &str,
    ) -> HandlerFuture<Result<IndexMap<String, ColumnType>, Self::Error>> {
        let handler = self.0.clone();
        let table_id = table_id.to_string();
        Box::pin(async move {
            let this = JsServerHandler(handler);
            let args = Array::new();
            args.push(&JsValue::from_str(&table_id));
            let result = this.call_method_js_async("tableSchema", &args).await?;
            let obj = result
                .dyn_ref::<Object>()
                .ok_or_else(|| JsError(JsValue::from_str("tableSchema must return an object")))?;

            let mut schema = IndexMap::new();
            let entries = Object::entries(obj);
            for i in 0..entries.length() {
                let entry = entries.get(i);
                let entry_array = entry.dyn_ref::<Array>().unwrap();
                let key = entry_array.get(0).as_string().unwrap();
                let value = entry_array.get(1).as_string().unwrap();
                schema.insert(key, ColumnType::from_str(&value).unwrap());
            }
            Ok(schema)
        })
    }

    fn table_size(&self, table_id: &str) -> HandlerFuture<Result<u32, Self::Error>> {
        let handler = self.0.clone();
        let table_id = table_id.to_string();
        Box::pin(async move {
            let this = JsServerHandler(handler);
            let args = Array::new();
            args.push(&JsValue::from_str(&table_id));
            let result = this.call_method_js_async("tableSize", &args).await?;
            result
                .as_f64()
                .map(|x| x as u32)
                .ok_or_else(|| JsError(JsValue::from_str("tableSize must return a number")))
        })
    }

    fn table_column_size(&self, view_id: &str) -> HandlerFuture<Result<u32, Self::Error>> {
        let has_method = Reflect::get(&self.0, &JsValue::from_str("tableColumnsSize"))
            .map(|val| !val.is_undefined())
            .unwrap_or(false);

        let handler = self.0.clone();
        let view_id = view_id.to_string();
        Box::pin(async move {
            let this = JsServerHandler(handler);
            let args = Array::new();
            args.push(&JsValue::from_str(&view_id));
            if has_method {
                let result = this.call_method_js_async("tableColumnsSize", &args).await?;
                result.as_f64().map(|x| x as u32).ok_or_else(|| {
                    JsError(JsValue::from_str(
                        "tableColumnsSize must
    return a number",
                    ))
                })
            } else {
                Ok(this.table_schema(view_id.as_str()).await?.len() as u32)
            }
        })
    }

    fn table_describe(
        &mut self,
        table_id: &str,
        config: &perspective_client::config::ViewConfig,
    ) -> HandlerFuture<Result<Result<Description, DescribeError>, Self::Error>> {
        let has_method = Reflect::get(&self.0, &JsValue::from_str("tableDescribe"))
            .map(|val| !val.is_undefined())
            .unwrap_or(false);

        let handler = self.0.clone();
        let table_id = table_id.to_string();
        let config_value = JsValue::from_serde_ext(config);
        Box::pin(async move {
            if !has_method {
                return Err(JsError(JsValue::from_str(
                    "`tableDescribe` is required of a `VirtualServerHandler`",
                )));
            }

            let this = JsServerHandler(handler);
            let args = Array::new();
            args.push(&JsValue::from_str(&table_id));
            args.push(&config_value?);
            let result = this.call_method_js_async("tableDescribe", &args).await?;
            let verdict: DescribeVerdict = result.into_serde_ext().map_err(|e| {
                JsError(JsValue::from_str(&format!(
                    "`tableDescribe` must return a `TableDescription`: {}",
                    e
                )))
            })?;

            Result::<Description, DescribeError>::try_from(verdict)
                .map_err(|e| JsError(JsValue::from_str(&e.to_string())))
        })
    }

    fn table_make_view(
        &mut self,
        table_id: &str,
        view_id: &str,
        config: &mut perspective_client::config::ViewConfigUpdate,
    ) -> HandlerFuture<Result<String, Self::Error>> {
        let handler = self.0.clone();
        let table_id = table_id.to_string();
        let view_id = view_id.to_string();
        let config = config.clone();
        Box::pin(async move {
            let this = JsServerHandler(handler);
            let args = Array::new();
            args.push(&JsValue::from_str(&table_id));
            args.push(&JsValue::from_str(&view_id));
            args.push(&JsValue::from_serde_ext(&config)?);
            let _ = this.call_method_js_async("tableMakeView", &args).await?;
            Ok(view_id.to_string())
        })
    }

    fn view_schema(
        &self,
        view_id: &str,
        config: &perspective_client::config::ViewConfig,
    ) -> HandlerFuture<Result<IndexMap<String, ColumnType>, Self::Error>> {
        let has_view_schema = Reflect::get(&self.0, &JsValue::from_str("viewSchema"))
            .is_ok_and(|v| !v.is_undefined());

        let handler = self.0.clone();
        let view_id = view_id.to_string();
        let config_value = JsValue::from_serde_ext(config).ok();

        Box::pin(async move {
            let this = JsServerHandler(handler);
            let args = Array::new();
            args.push(&JsValue::from_str(&view_id));
            if let Some(cv) = config_value {
                args.push(&cv);
            }

            let result = this
                .call_method_js_async(
                    if has_view_schema {
                        "viewSchema"
                    } else {
                        "tableSchema"
                    },
                    &args,
                )
                .await?;

            let obj = result
                .dyn_ref::<Object>()
                .ok_or_else(|| JsError(JsValue::from_str("viewSchema must return an object")))?;

            let mut schema = IndexMap::new();
            let entries = Object::entries(obj);
            for i in 0..entries.length() {
                let entry = entries.get(i);
                let entry_array = entry.dyn_ref::<Array>().unwrap();
                let key = entry_array.get(0).as_string().unwrap();
                let value = entry_array.get(1).as_string().unwrap();
                schema.insert(key, ColumnType::from_str(&value).unwrap());
            }

            Ok(schema)
        })
    }

    fn view_size(&self, view_id: &str) -> HandlerFuture<Result<u32, Self::Error>> {
        let handler = self.0.clone();
        let view_id = view_id.to_string();
        let has_view_size =
            Reflect::get(&self.0, &JsValue::from_str("viewSize")).is_ok_and(|v| !v.is_undefined());

        Box::pin(async move {
            let this = JsServerHandler(handler);
            let args = Array::new();
            args.push(&JsValue::from_str(&view_id));
            let result = this
                .call_method_js_async(
                    if has_view_size {
                        "viewSize"
                    } else {
                        "tableSize"
                    },
                    &args,
                )
                .await?;

            result
                .as_f64()
                .map(|x| x as u32)
                .ok_or_else(|| JsError(JsValue::from_str("viewSize must return a number")))
        })
    }

    fn view_column_size(
        &self,
        view_id: &str,
        config: &perspective_client::config::ViewConfig,
    ) -> HandlerFuture<Result<u32, Self::Error>> {
        let has_method = Reflect::get(&self.0, &JsValue::from_str("viewColumnSize"))
            .map(|val| !val.is_undefined())
            .unwrap_or(false);

        let handler = self.0.clone();
        let view_id = view_id.to_string();
        let config_value = JsValue::from_serde_ext(config).unwrap();
        let config = config.clone();
        Box::pin(async move {
            let this = JsServerHandler(handler);
            let args = Array::new();
            args.push(&JsValue::from_str(&view_id));
            args.push(&config_value);
            if has_method {
                let result = this.call_method_js_async("viewColumnSize", &args).await?;
                result.as_f64().map(|x| x as u32).ok_or_else(|| {
                    JsError(JsValue::from_str("viewColumnSize must return a number"))
                })
            } else {
                Ok(this.view_schema(view_id.as_str(), &config).await?.len() as u32)
            }
        })
    }

    fn view_delete(&self, view_id: &str) -> HandlerFuture<Result<(), Self::Error>> {
        let handler = self.0.clone();
        let view_id = view_id.to_string();
        Box::pin(async move {
            let this = JsServerHandler(handler);
            let args = Array::new();
            args.push(&JsValue::from_str(&view_id));
            this.call_method_js_async("viewDelete", &args).await?;
            Ok(())
        })
    }

    fn table_make_port(
        &self,
        _req: &perspective_client::proto::TableMakePortReq,
    ) -> HandlerFuture<Result<u32, Self::Error>> {
        let has_method = Reflect::get(&self.0, &JsValue::from_str("tableMakePort"))
            .map(|val| !val.is_undefined())
            .unwrap_or(false);

        if !has_method {
            return Box::pin(async { Ok(0) });
        }

        let handler = self.0.clone();
        Box::pin(async move {
            let this = JsServerHandler(handler);
            let args = Array::new();
            let result = this.call_method_js_async("tableMakePort", &args).await?;
            result
                .as_f64()
                .map(|x| x as u32)
                .ok_or_else(|| JsError(JsValue::from_str("tableMakePort must return a number")))
        })
    }

    fn view_make_table(
        &mut self,
        view_id: &str,
        table_id: &str,
        config: &perspective_client::config::ViewConfig,
        schema: Option<&IndexMap<String, ColumnType>>,
    ) -> HandlerFuture<Result<(), Self::Error>> {
        let has_method = Reflect::get(&self.0, &JsValue::from_str("viewMakeTable"))
            .map(|val| !val.is_undefined())
            .unwrap_or(false);

        if !has_method {
            return Box::pin(async {
                Err(JsError(JsValue::from_str("viewMakeTable not implemented")))
            });
        }

        let handler = self.0.clone();
        let view_id = view_id.to_string();
        let table_id = table_id.to_string();
        let config_value = JsValue::from_serde_ext(config);
        let schema_value = schema.map(|schema| {
            let object = Object::new();
            for (name, ty) in schema {
                let _ = Reflect::set(
                    &object,
                    &JsValue::from_str(name),
                    &JsValue::from_str(&ty.to_string()),
                );
            }

            JsValue::from(object)
        });

        Box::pin(async move {
            let this = JsServerHandler(handler);
            let args = Array::new();
            args.push(&JsValue::from_str(&view_id));
            args.push(&JsValue::from_str(&table_id));
            args.push(&config_value?);
            if let Some(schema_value) = schema_value {
                args.push(&schema_value);
            }

            this.call_method_js_async("viewMakeTable", &args).await?;
            Ok(())
        })
    }

    fn make_table(
        &mut self,
        table_id: &str,
        data: &perspective_client::proto::MakeTableData,
    ) -> HandlerFuture<Result<(), Self::Error>> {
        let has_method = Reflect::get(&self.0, &JsValue::from_str("makeTable"))
            .map(|val| !val.is_undefined())
            .unwrap_or(false);

        if !has_method {
            return Box::pin(async {
                Err(JsError(JsValue::from_str("makeTable not implemented")))
            });
        }

        let handler = self.0.clone();
        let table_id = table_id.to_string();
        use perspective_client::proto::make_table_data::Data;
        let data_value = match &data.data {
            Some(Data::FromCsv(csv)) => JsValue::from_str(csv),
            Some(Data::FromArrow(arrow)) => {
                let uint8array = js_sys::Uint8Array::from(arrow.as_slice());
                JsValue::from(uint8array)
            },
            Some(Data::FromRows(rows)) => JsValue::from_str(rows),
            Some(Data::FromCols(cols)) => JsValue::from_str(cols),
            Some(Data::FromNdjson(ndjson)) => JsValue::from_str(ndjson),
            _ => JsValue::from_str(""),
        };

        Box::pin(async move {
            let this = JsServerHandler(handler);
            let args = Array::new();
            args.push(&JsValue::from_str(&table_id));
            args.push(&data_value);
            this.call_method_js_async("makeTable", &args).await?;
            Ok(())
        })
    }

    fn view_get_min_max(
        &self,
        view_id: &str,
        column_name: &str,
        config: &perspective_client::config::ViewConfig,
    ) -> HandlerFuture<
        Result<
            (
                perspective_client::config::Scalar,
                perspective_client::config::Scalar,
            ),
            Self::Error,
        >,
    > {
        let has_method = Reflect::get(&self.0, &JsValue::from_str("viewGetMinMax"))
            .map(|val| !val.is_undefined())
            .unwrap_or(false);

        if !has_method {
            return Box::pin(async {
                Err(JsError(JsValue::from_str("viewGetMinMax not implemented")))
            });
        }

        let handler = self.0.clone();
        let view_id = view_id.to_string();
        let column_name = column_name.to_string();
        let config_js = JsValue::from_serde_ext(config).unwrap();
        Box::pin(async move {
            let this = JsServerHandler(handler);
            let args = Array::new();
            args.push(&JsValue::from_str(&view_id));
            args.push(&JsValue::from_str(&column_name));
            args.push(&config_js);
            let result = this.call_method_js_async("viewGetMinMax", &args).await?;
            let obj = result.dyn_ref::<Object>().unwrap();
            let min_val = Reflect::get(obj, &JsValue::from_str(wasm_bindgen::intern("min")))?;
            let max_val = Reflect::get(obj, &JsValue::from_str(wasm_bindgen::intern("max")))?;
            Ok((jsvalue_to_scalar(&min_val), jsvalue_to_scalar(&max_val)))
        })
    }

    fn view_expand(
        &mut self,
        view_id: &str,
        config: &perspective_client::config::ViewConfig,
        row_index: u32,
    ) -> HandlerFuture<Result<u32, Self::Error>> {
        Box::pin(self.call_tree_method("viewExpand", view_id, config, row_index))
    }

    fn view_collapse(
        &mut self,
        view_id: &str,
        config: &perspective_client::config::ViewConfig,
        row_index: u32,
    ) -> HandlerFuture<Result<u32, Self::Error>> {
        Box::pin(self.call_tree_method("viewCollapse", view_id, config, row_index))
    }

    fn view_set_depth(
        &mut self,
        view_id: &str,
        config: &perspective_client::config::ViewConfig,
        depth: u32,
    ) -> HandlerFuture<Result<(), Self::Error>> {
        let fut = self.call_tree_method("viewSetDepth", view_id, config, depth);
        Box::pin(async move {
            fut.await?;
            Ok(())
        })
    }

    fn view_get_data(
        &self,
        view_id: &str,
        config: &perspective_client::config::ViewConfig,
        schema: &IndexMap<String, ColumnType>,
        viewport: &perspective_client::proto::ViewPort,
    ) -> HandlerFuture<Result<virtual_server::VirtualDataSlice, Self::Error>> {
        let handler = self.0.clone();
        let view_id = view_id.to_string();
        let window: JsViewPort = viewport.clone().into();
        let config_value = JsValue::from_serde_ext(config).unwrap();
        let window_value = JsValue::from_serde_ext(&window).unwrap();
        let schema_value = JsValue::from_serde_ext(&schema).unwrap();

        Box::pin(async move {
            let this = JsServerHandler(handler);
            let data = VirtualDataSlice::new(config_value.clone().unchecked_into());

            {
                let args = Array::new();
                args.push(&JsValue::from_str(&view_id));
                args.push(&config_value);
                args.push(&schema_value);
                args.push(&window_value);
                args.push(&JsValue::from(data.clone()));
                this.call_method_js_async("viewGetData", &args).await?;
            }

            // Lock the mutex and take ownership of the inner data
            // We can't unwrap the Arc because the JsValue might still hold a
            // reference
            let VirtualDataSlice(_obj, arc) = data;
            let slice = std::mem::take(&mut *arc.lock().unwrap()).unwrap();
            Ok(slice)
        })
    }
}

#[derive(Serialize, PartialEq)]
pub struct JsViewPort {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub start_row: ::core::option::Option<u32>,

    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub start_col: ::core::option::Option<u32>,

    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub end_row: ::core::option::Option<u32>,

    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub end_col: ::core::option::Option<u32>,
}

impl From<perspective_client::proto::ViewPort> for JsViewPort {
    fn from(value: perspective_client::proto::ViewPort) -> Self {
        JsViewPort {
            start_row: value.start_row,
            start_col: value.start_col,
            end_row: value.end_row,
            end_col: value.end_col,
        }
    }
}

#[wasm_bindgen(js_name = "VirtualDataSlice")]
#[derive(Clone)]
pub struct VirtualDataSlice(Object, Arc<Mutex<Option<virtual_server::VirtualDataSlice>>>);

#[wasm_bindgen]
impl VirtualDataSlice {
    #[wasm_bindgen(constructor)]
    pub fn new(config: JsViewConfig) -> Self {
        VirtualDataSlice(
            Object::new(),
            Arc::new(Mutex::new(Some(virtual_server::VirtualDataSlice::new(
                config.into_serde_ext().unwrap(),
            )))),
        )
    }

    #[wasm_bindgen(js_name = "fromArrowIpc")]
    pub fn from_arrow_ipc(&self, ipc: Uint8Array) -> Result<(), JsValue> {
        self.1
            .lock()
            .unwrap()
            .as_mut()
            .unwrap()
            .from_arrow_ipc(&ipc.to_vec())
            .map_err(|e| JsValue::from_str(&e.to_string()))
    }

    #[wasm_bindgen(js_name = "setCol")]
    pub fn set_col(
        &self,
        dtype: &str,
        name: &str,
        index: u32,
        val: JsValue,
        group_by_index: Option<usize>,
    ) -> Result<(), JsValue> {
        match dtype {
            "string" => self.set_string_col(name, index, val, group_by_index),
            "integer" => self.set_integer_col(name, index, val, group_by_index),
            "float" => self.set_float_col(name, index, val, group_by_index),
            "date" => self.set_datetime_col(name, index, val, group_by_index),
            "datetime" => self.set_datetime_col(name, index, val, group_by_index),
            "boolean" => self.set_boolean_col(name, index, val, group_by_index),
            _ => Err(JsValue::from_str("Unknown type")),
        }
    }

    #[wasm_bindgen(js_name = "setStringCol")]
    pub fn set_string_col(
        &self,
        name: &str,
        index: u32,
        val: JsValue,
        group_by_index: Option<usize>,
    ) -> Result<(), JsValue> {
        if val.is_null() || val.is_undefined() {
            self.1
                .lock()
                .unwrap()
                .as_mut()
                .unwrap()
                .set_col(name, group_by_index, index as usize, None as Option<String>)
                .unwrap();
        } else if let Some(s) = val.as_string() {
            self.1
                .lock()
                .unwrap()
                .as_mut()
                .unwrap()
                .set_col(name, group_by_index, index as usize, Some(s))
                .unwrap();
        } else {
            tracing::error!("Unhandled string value");
        }
        Ok(())
    }

    #[wasm_bindgen(js_name = "setIntegerCol")]
    pub fn set_integer_col(
        &self,
        name: &str,
        index: u32,
        val: JsValue,
        group_by_index: Option<usize>,
    ) -> Result<(), JsValue> {
        if val.is_null() || val.is_undefined() {
            self.1
                .lock()
                .unwrap()
                .as_mut()
                .unwrap()
                .set_col(name, group_by_index, index as usize, None as Option<i32>)
                .unwrap();
        } else if let Some(n) = val.as_f64() {
            self.1
                .lock()
                .unwrap()
                .as_mut()
                .unwrap()
                .set_col(name, group_by_index, index as usize, Some(n as i32))
                .unwrap();
        } else {
            tracing::error!("Unhandled integer value");
        }
        Ok(())
    }

    #[wasm_bindgen(js_name = "setFloatCol")]
    pub fn set_float_col(
        &self,
        name: &str,
        index: u32,
        val: JsValue,
        group_by_index: Option<usize>,
    ) -> Result<(), JsValue> {
        if val.is_null() || val.is_undefined() {
            self.1
                .lock()
                .unwrap()
                .as_mut()
                .unwrap()
                .set_col(name, group_by_index, index as usize, None as Option<f64>)
                .unwrap();
        } else if let Some(n) = val.as_f64() {
            self.1
                .lock()
                .unwrap()
                .as_mut()
                .unwrap()
                .set_col(name, group_by_index, index as usize, Some(n))
                .unwrap();
        } else {
            tracing::error!("Unhandled float value");
        }
        Ok(())
    }

    #[wasm_bindgen(js_name = "setBooleanCol")]
    pub fn set_boolean_col(
        &self,
        name: &str,
        index: u32,
        val: JsValue,
        group_by_index: Option<usize>,
    ) -> Result<(), JsValue> {
        if val.is_null() || val.is_undefined() {
            self.1
                .lock()
                .unwrap()
                .as_mut()
                .unwrap()
                .set_col(name, group_by_index, index as usize, None as Option<bool>)
                .unwrap();
        } else if let Some(b) = val.as_bool() {
            self.1
                .lock()
                .unwrap()
                .as_mut()
                .unwrap()
                .set_col(name, group_by_index, index as usize, Some(b))
                .unwrap();
        } else {
            tracing::error!("Unhandled boolean value");
        }
        Ok(())
    }

    #[wasm_bindgen(js_name = "setDatetimeCol")]
    pub fn set_datetime_col(
        &self,
        name: &str,
        index: u32,
        val: JsValue,
        group_by_index: Option<usize>,
    ) -> Result<(), JsValue> {
        if val.is_null() || val.is_undefined() {
            self.1
                .lock()
                .unwrap()
                .as_mut()
                .unwrap()
                .set_col(name, group_by_index, index as usize, None as Option<i64>)
                .unwrap();
        } else if let Some(date) = val.dyn_ref::<Date>() {
            let timestamp = date.get_time() as i64;
            self.1
                .lock()
                .unwrap()
                .as_mut()
                .unwrap()
                .set_col(name, group_by_index, index as usize, Some(timestamp))
                .unwrap();
        } else if let Some(n) = val.as_f64() {
            self.1
                .lock()
                .unwrap()
                .as_mut()
                .unwrap()
                .set_col(name, group_by_index, index as usize, Some(n as i64))
                .unwrap();
        } else {
            tracing::error!("Unhandled datetime value");
        }

        Ok(())
    }
}

#[wasm_bindgen]
pub struct VirtualServer(Rc<UnsafeCell<virtual_server::VirtualServer<JsServerHandler>>>);

#[wasm_bindgen]
impl VirtualServer {
    #[wasm_bindgen(constructor)]
    pub fn new(handler: JsVirtualServerHandler) -> Result<VirtualServer, JsValue> {
        Ok(VirtualServer(Rc::new(UnsafeCell::new(
            virtual_server::VirtualServer::new(JsServerHandler(handler.unchecked_into())),
        ))))
    }

    #[wasm_bindgen(js_name = "handleRequest")]
    pub fn handle_request(&self, bytes: &[u8]) -> ApiFuture<Vec<u8>> {
        let bytes = bytes.to_vec();
        let server = self.0.clone();

        ApiFuture::new(async move {
            // SAFETY:
            // - WASM is single-threaded
            // - JS re-entrancy is allowed by design
            // - VirtualServer must tolerate re-entrant mutation
            let result = unsafe {
                (&mut *server.as_ref().get())
                    .handle_request(bytes::Bytes::from(bytes))
                    .await
            };

            match result.get_internal_error() {
                Ok(x) => Ok(x.to_vec()),
                Err(Ok(x)) => Err(ApiError::from(JsValue::from(x))),
                Err(Err(x)) => Err(ApiError::from(JsValue::from_str(&x))),
            }
        })
    }
}