@perspective-dev/client 4.3.0 → 4.4.0

package/dist/esm/perspective.node.d.ts

@@ -35,6 +35,15 @@ export declare function on_hosted_tables_update(cb: () => void): Promise<number>
 export declare function remove_hosted_tables_update(id: number): Promise<void>;
 export declare function system_info(): Promise<perspective_client.SystemInfo>;
 export declare function on_error(callback: Function): Promise<number>;
+/**
+ * Create a read-only table from a JOIN of two source tables.
+ * @param left - The left source table (a Table instance or a table name string).
+ * @param right - The right source table (a Table instance or a table name string).
+ * @param on
+ * @param options - Optional join configuration: { join_type?: "inner"|"left"|"outer", name?: string }
+ * @returns
+ */
+export declare function join(left: perspective_client.Table | string, right: perspective_client.Table | string, on: string, options?: perspective_client.JoinOptions): Promise<perspective_client.Table>;
 /**
  * Create a table from the global Perspective instance.
  * @param init_data
@@ -59,6 +68,7 @@ export declare function createMessageHandler(handler: virtual_server.VirtualServ
 export { perspective_client as wasmModule };
 declare const _default: {
     table: typeof table;
+    join: typeof join;
     websocket: typeof websocket;
     worker: typeof worker;
     get_hosted_table_names: typeof get_hosted_table_names;

package/dist/esm/perspective.node.js

@@ -102,6 +102,40 @@ var Client = class _Client {
     const ret = wasm.client_handle_response(this.__wbg_ptr, addHeapObject(value));
     return takeObject(ret);
   }
+  /**
+   * Creates a new read-only [`Table`] by performing an INNER JOIN on two
+   * source tables. The resulting table is reactive: when either source
+   * table is updated, the join is automatically recomputed.
+   *
+   * # Arguments
+   *
+   * - `left` - The left source table (a [`Table`] instance or a table name
+   *   string).
+   * - `right` - The right source table (a [`Table`] instance or a table name
+   *   string).
+   * - `on` - The column name to join on. Must exist in both tables with the
+   *   same type.
+   * - `options` - Optional join configuration: `{ join_type?: "inner" |
+   *   "left" | "outer", name?: string }`.
+   *
+   * # JavaScript Examples
+   *
+   * ```javascript
+   * const joined = await client.join(orders_table, products_table, "Product ID", { join_type: "left" });
+   * const joined = await client.join("orders", "products", "Product ID", { join_type: "left" });
+   * ```
+   * @param {any} left
+   * @param {any} right
+   * @param {string} on
+   * @param {JoinOptions | null} [options]
+   * @returns {Promise<Table>}
+   */
+  join(left, right, on, options) {
+    const ptr0 = passStringToWasm0(on, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.client_join(this.__wbg_ptr, addHeapObject(left), addHeapObject(right), ptr0, len0, isLikeNone(options) ? 0 : addHeapObject(options));
+    return takeObject(ret);
+  }
   /**
    * @param {Function} send_request
    * @param {Function | null} [close]
@@ -566,6 +600,37 @@ var GenericSQLVirtualServerModel = class {
       wasm.__wbindgen_add_to_stack_pointer(16);
     }
   }
+  /**
+   * Returns the SQL query to get the min and max values of a column.
+   * @param {string} view_id
+   * @param {string} column_name
+   * @param {any} config
+   * @returns {string}
+   */
+  viewGetMinMax(view_id, column_name, config) {
+    try {
+      const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+      const ptr0 = passStringToWasm0(view_id, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+      const len0 = WASM_VECTOR_LEN;
+      const ptr1 = passStringToWasm0(column_name, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+      const len1 = WASM_VECTOR_LEN;
+      wasm.genericsqlvirtualservermodel_viewGetMinMax(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1, addHeapObject(config));
+      var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+      var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+      var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+      var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+      if (r3) {
+        throw takeObject(r2);
+      }
+      var v3 = getCachedStringFromWasm0(r0, r1);
+      if (r0 !== 0) {
+        wasm.__wbindgen_export4(r0, r1, 1);
+      }
+      return v3;
+    } finally {
+      wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+  }
   /**
    * Returns the SQL query to describe a view's schema.
    * @param {string} view_id
@@ -1326,6 +1391,22 @@ var VirtualDataSlice = class _VirtualDataSlice {
     const ptr = this.__destroy_into_raw();
     wasm.__wbg_virtualdataslice_free(ptr, 0);
   }
+  /**
+   * @param {Uint8Array} ipc
+   */
+  fromArrowIpc(ipc) {
+    try {
+      const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+      wasm.virtualdataslice_fromArrowIpc(retptr, this.__wbg_ptr, addHeapObject(ipc));
+      var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+      var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+      if (r1) {
+        throw takeObject(r0);
+      }
+    } finally {
+      wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+  }
   /**
    * @param {ViewConfigUpdate} config
    */
@@ -1867,7 +1948,7 @@ function __wbg_get_imports() {
           const a = state0.a;
           state0.a = 0;
           try {
-            return __wasm_bindgen_func_elem_5713(a, state0.b, arg02, arg12);
+            return __wasm_bindgen_func_elem_10782(a, state0.b, arg02, arg12);
           } finally {
             state0.a = a;
           }
@@ -2027,11 +2108,11 @@ function __wbg_get_imports() {
       console.warn(getObject(arg0));
     },
     __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-      const ret = makeClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_813, __wasm_bindgen_func_elem_1689);
+      const ret = makeClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_838, __wasm_bindgen_func_elem_1727);
       return addHeapObject(ret);
     },
     __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-      const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_3857, __wasm_bindgen_func_elem_3874);
+      const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_3910, __wasm_bindgen_func_elem_3927);
       return addHeapObject(ret);
     },
     __wbindgen_cast_0000000000000003: function(arg0) {
@@ -2080,15 +2161,15 @@ function __wbg_get_imports() {
     "./perspective-js.wasm_bg.js": import0
   };
 }
-function __wasm_bindgen_func_elem_1689(arg0, arg1) {
-  const ret = wasm.__wasm_bindgen_func_elem_1689(arg0, arg1);
+function __wasm_bindgen_func_elem_1727(arg0, arg1) {
+  const ret = wasm.__wasm_bindgen_func_elem_1727(arg0, arg1);
   return takeObject(ret);
 }
-function __wasm_bindgen_func_elem_3874(arg0, arg1, arg2) {
-  wasm.__wasm_bindgen_func_elem_3874(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_3927(arg0, arg1, arg2) {
+  wasm.__wasm_bindgen_func_elem_3927(arg0, arg1, addHeapObject(arg2));
 }
-function __wasm_bindgen_func_elem_5713(arg0, arg1, arg2, arg3) {
-  wasm.__wasm_bindgen_func_elem_5713(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_10782(arg0, arg1, arg2, arg3) {
+  wasm.__wasm_bindgen_func_elem_10782(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }
 var ClientFinalization = typeof FinalizationRegistry === "undefined" ? { register: () => {
 }, unregister: () => {
@@ -3057,6 +3138,9 @@ function system_info() {
 function on_error(callback) {
   return SYNC_CLIENT.on_error(callback);
 }
+function join(left, right, on, options) {
+  return SYNC_CLIENT.join(left, right, on, options);
+}
 function table(init_data, options) {
   return SYNC_CLIENT.table(init_data, options);
 }
@@ -3102,6 +3186,7 @@ function createMessageHandler2(handler) {
 }
 var perspective_node_default = {
   table,
+  join,
   websocket: websocket2,
   worker,
   get_hosted_table_names,
@@ -3124,6 +3209,7 @@ export {
   cwd_static_file_handler,
   perspective_node_default as default,
   get_hosted_table_names,
+  join,
   make_client,
   make_session,
   on_error,