@cereusdb/minimal 0.3.0 → 0.4.0

package/dist/wasm/cereusdb.js

@@ -31,6 +31,60 @@ export class CereusDB {
         }
 
     }
+    /**
+     * Create (`create = true`) or attach a persistent database. Returns the
+     * database (catalog) name.
+     * @param {string} location
+     * @param {string | null | undefined} name
+     * @param {boolean} create
+     * @param {boolean} if_not_exists
+     * @returns {Promise<string>}
+     */
+    attach_database(location, name, create, if_not_exists) {
+        const ptr0 = passStringToWasm0(location, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        var ptr1 = isLikeNone(name) ? 0 : passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len1 = WASM_VECTOR_LEN;
+        let ret;
+        __wbg_termination_guard();
+        try {
+            ret = wasm.cereusdb_attach_database(this.__wbg_ptr, ptr0, len0, ptr1, len1, create, if_not_exists);;
+        } catch(e) {
+            __wbg_handle_catch(e);
+        }
+        return ret;
+    }
+    /**
+     * Describe all databases, schemas, tables and views as a JSON string.
+     * @returns {Promise<string>}
+     */
+    catalog_json() {
+        let ret;
+        __wbg_termination_guard();
+        try {
+            ret = wasm.cereusdb_catalog_json(this.__wbg_ptr);;
+        } catch(e) {
+            __wbg_handle_catch(e);
+        }
+        return ret;
+    }
+    /**
+     * Rewrite every table of a persistent database into a single segment.
+     * @param {string} name
+     * @returns {Promise<void>}
+     */
+    compact_database(name) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        let ret;
+        __wbg_termination_guard();
+        try {
+            ret = wasm.cereusdb_compact_database(this.__wbg_ptr, ptr0, len0);;
+        } catch(e) {
+            __wbg_handle_catch(e);
+        }
+        return ret;
+    }
     /**
      * Create a new CereusDB instance.
      * Initializes DataFusion context and registers all spatial functions.
@@ -50,7 +104,45 @@ export class CereusDB {
         return CereusDB.__wrap(ret[0]);
     }
     /**
-     * Drop a registered table.
+     * Detach a persistent database after writing pending changes.
+     * @param {string} name
+     * @param {boolean} if_exists
+     * @returns {Promise<void>}
+     */
+    detach_database(name, if_exists) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        let ret;
+        __wbg_termination_guard();
+        try {
+            ret = wasm.cereusdb_detach_database(this.__wbg_ptr, ptr0, len0, if_exists);;
+        } catch(e) {
+            __wbg_handle_catch(e);
+        }
+        return ret;
+    }
+    /**
+     * Drop a database by name or location URL. Persistent databases are
+     * deleted from storage.
+     * @param {string} target
+     * @param {boolean} if_exists
+     * @returns {Promise<void>}
+     */
+    drop_database(target, if_exists) {
+        const ptr0 = passStringToWasm0(target, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        let ret;
+        __wbg_termination_guard();
+        try {
+            ret = wasm.cereusdb_drop_database(this.__wbg_ptr, ptr0, len0, if_exists);;
+        } catch(e) {
+            __wbg_handle_catch(e);
+        }
+        return ret;
+    }
+    /**
+     * Drop a registered table. Call `flush()` to write the change when the
+     * table belongs to a persistent database.
      * @param {string} table_name
      */
     drop_table(table_name) {
@@ -67,6 +159,111 @@ export class CereusDB {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * Run a query and encode the result as GeoParquet. `options` may set
+     * `compression` and `rowGroupSize`.
+     * @param {string} query
+     * @param {any} options
+     * @returns {Promise<Uint8Array>}
+     */
+    export_geoparquet(query, options) {
+        const ptr0 = passStringToWasm0(query, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        let ret;
+        __wbg_termination_guard();
+        try {
+            ret = wasm.cereusdb_export_geoparquet(this.__wbg_ptr, ptr0, len0, options);;
+        } catch(e) {
+            __wbg_handle_catch(e);
+        }
+        return ret;
+    }
+    /**
+     * Write all pending changes of attached persistent databases.
+     * @returns {Promise<void>}
+     */
+    flush() {
+        let ret;
+        __wbg_termination_guard();
+        try {
+            ret = wasm.cereusdb_flush(this.__wbg_ptr);;
+        } catch(e) {
+            __wbg_handle_catch(e);
+        }
+        return ret;
+    }
+    /**
+     * Insert Arrow IPC data (stream or file format) into a table, matching
+     * columns by name. Returns the number of inserted rows.
+     * @param {string} table_name
+     * @param {Uint8Array} data
+     * @returns {Promise<number>}
+     */
+    insert_arrow(table_name, data) {
+        const ptr0 = passStringToWasm0(table_name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
+        const len1 = WASM_VECTOR_LEN;
+        let ret;
+        __wbg_termination_guard();
+        try {
+            ret = wasm.cereusdb_insert_arrow(this.__wbg_ptr, ptr0, len0, ptr1, len1);;
+        } catch(e) {
+            __wbg_handle_catch(e);
+        }
+        return ret;
+    }
+    /**
+     * Database locations stored in the backend for `scheme`, attached or not.
+     * @param {string} scheme
+     * @returns {Promise<any>}
+     */
+    list_database_locations(scheme) {
+        const ptr0 = passStringToWasm0(scheme, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        let ret;
+        __wbg_termination_guard();
+        try {
+            ret = wasm.cereusdb_list_database_locations(this.__wbg_ptr, ptr0, len0);;
+        } catch(e) {
+            __wbg_handle_catch(e);
+        }
+        return ret;
+    }
+    /**
+     * List all tables and views as `catalog.schema.table`.
+     * @returns {any}
+     */
+    qualified_tables() {
+        let ret;
+        __wbg_termination_guard();
+        try {
+            ret = wasm.cereusdb_qualified_tables(this.__wbg_ptr);;
+        } catch(e) {
+            __wbg_handle_catch(e);
+        }
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
+    /**
+     * Set the function `(filename, bytes, mimeType)` that receives files
+     * written by `COPY ... TO`. `null` removes it.
+     * @param {any} handler
+     */
+    register_export_handler(handler) {
+        let ret;
+        __wbg_termination_guard();
+        try {
+            ret = wasm.cereusdb_register_export_handler(this.__wbg_ptr, handler);;
+        } catch(e) {
+            __wbg_handle_catch(e);
+        }
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
     /**
      * Register a GeoJSON string as a named table.
      * @param {string} table_name
@@ -215,6 +412,26 @@ export class CereusDB {
         }
         return ret;
     }
+    /**
+     * Register the storage backend used for database locations with the given
+     * URL scheme (for example `opfs`).
+     * @param {string} scheme
+     * @param {any} backend
+     */
+    register_storage_backend(scheme, backend) {
+        const ptr0 = passStringToWasm0(scheme, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        let ret;
+        __wbg_termination_guard();
+        try {
+            ret = wasm.cereusdb_register_storage_backend(this.__wbg_ptr, ptr0, len0, backend);;
+        } catch(e) {
+            __wbg_handle_catch(e);
+        }
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
     /**
      * Execute a SQL query.
      * Returns results as Arrow IPC bytes (Uint8Array).
@@ -314,6 +531,14 @@ const import9 = __wasi;
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
+        __wbg_Error_83742b46f01ce22d: function(arg0, arg1) {
+            const ret = Error(getStringFromWasm0(arg0, arg1));
+            return ret;
+        },
+        __wbg_Number_a5a435bd7bbec835: function(arg0) {
+            const ret = Number(arg0);
+            return ret;
+        },
         __wbg_String_8564e559799eccda: function(arg0, arg1) {
             const ret = String(arg1);
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -321,6 +546,17 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
+        __wbg___wbindgen_bigint_get_as_i64_447a76b5c6ef7bda: function(arg0, arg1) {
+            const v = arg1;
+            const ret = typeof(v) === 'bigint' ? v : undefined;
+            getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+        },
+        __wbg___wbindgen_boolean_get_c0f3f60bac5a78d1: function(arg0) {
+            const v = arg0;
+            const ret = typeof(v) === 'boolean' ? v : undefined;
+            return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
+        },
         __wbg___wbindgen_debug_string_5398f5bb970e0daa: function(arg0, arg1) {
             const ret = debugString(arg1);
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -328,20 +564,63 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
+        __wbg___wbindgen_in_41dbb8413020e076: function(arg0, arg1) {
+            const ret = arg0 in arg1;
+            return ret;
+        },
+        __wbg___wbindgen_is_bigint_e2141d4f045b7eda: function(arg0) {
+            const ret = typeof(arg0) === 'bigint';
+            return ret;
+        },
         __wbg___wbindgen_is_function_3c846841762788c1: function(arg0) {
             const ret = typeof(arg0) === 'function';
             return ret;
         },
+        __wbg___wbindgen_is_null_0b605fc6b167c56f: function(arg0) {
+            const ret = arg0 === null;
+            return ret;
+        },
+        __wbg___wbindgen_is_object_781bc9f159099513: function(arg0) {
+            const val = arg0;
+            const ret = typeof(val) === 'object' && val !== null;
+            return ret;
+        },
         __wbg___wbindgen_is_undefined_52709e72fb9f179c: function(arg0) {
             const ret = arg0 === undefined;
             return ret;
         },
+        __wbg___wbindgen_jsval_eq_ee31bfad3e536463: function(arg0, arg1) {
+            const ret = arg0 === arg1;
+            return ret;
+        },
+        __wbg___wbindgen_jsval_loose_eq_5bcc3bed3c69e72b: function(arg0, arg1) {
+            const ret = arg0 == arg1;
+            return ret;
+        },
+        __wbg___wbindgen_number_get_34bb9d9dcfa21373: function(arg0, arg1) {
+            const obj = arg1;
+            const ret = typeof(obj) === 'number' ? obj : undefined;
+            getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+        },
+        __wbg___wbindgen_string_get_395e606bd0ee4427: function(arg0, arg1) {
+            const obj = arg1;
+            const ret = typeof(obj) === 'string' ? obj : undefined;
+            var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            var len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
         __wbg___wbindgen_throw_6ddd609b62940d55: function(arg0, arg1) {
             throw new WebAssembly.Exception(__wbindgen_wrapped_jstag, [new Error(getStringFromWasm0(arg0, arg1))]);
         },
         __wbg__wbg_cb_unref_6b5b6b8576d35cb1: function(arg0) {
             arg0._wbg_cb_unref();
         },
+        __wbg_apply_ac9afb97ca32f169: function(arg0, arg1, arg2) {
+            const ret = arg0.apply(arg1, arg2);
+            return ret;
+        },
         __wbg_arrayBuffer_eb8e9ca620af2a19: function(arg0) {
             const ret = arg0.arrayBuffer();
             return ret;
@@ -350,6 +629,10 @@ function __wbg_get_imports() {
             const ret = arg0.call(arg1, arg2);
             return ret;
         },
+        __wbg_call_f858478a02f9600f: function(arg0, arg1, arg2, arg3, arg4) {
+            const ret = arg0.call(arg1, arg2, arg3, arg4);
+            return ret;
+        },
         __wbg_error_a6fa202b58aa1cd3: function(arg0, arg1) {
             let deferred0_0;
             let deferred0_1;
@@ -374,6 +657,10 @@ function __wbg_get_imports() {
             const ret = arg0.fetch(arg1);
             return ret;
         },
+        __wbg_from_4bdf88943703fd48: function(arg0) {
+            const ret = Array.from(arg0);
+            return ret;
+        },
         __wbg_getRandomValues_3f44b700395062e5: function(arg0, arg1) {
             globalThis.crypto.getRandomValues(getArrayU8FromWasm0(arg0, arg1));
         },
@@ -384,6 +671,28 @@ function __wbg_get_imports() {
             const ret = arg0.getTime();
             return ret;
         },
+        __wbg_get_3ef1eba1850ade27: function(arg0, arg1) {
+            const ret = Reflect.get(arg0, arg1);
+            return ret;
+        },
+        __wbg_get_unchecked_329cfe50afab7352: function(arg0, arg1) {
+            const ret = arg0[arg1 >>> 0];
+            return ret;
+        },
+        __wbg_get_with_ref_key_6412cf3094599694: function(arg0, arg1) {
+            const ret = arg0[arg1];
+            return ret;
+        },
+        __wbg_instanceof_ArrayBuffer_101e2bf31071a9f6: function(arg0) {
+            let result;
+            try {
+                result = arg0 instanceof ArrayBuffer;
+            } catch (_) {
+                result = false;
+            }
+            const ret = result;
+            return ret;
+        },
         __wbg_instanceof_Response_9b4d9fd451e051b1: function(arg0) {
             let result;
             try {
@@ -394,6 +703,16 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
+        __wbg_instanceof_Uint8Array_740438561a5b956d: function(arg0) {
+            let result;
+            try {
+                result = arg0 instanceof Uint8Array;
+            } catch (_) {
+                result = false;
+            }
+            const ret = result;
+            return ret;
+        },
         __wbg_instanceof_Window_23e677d2c6843922: function(arg0) {
             let result;
             try {
@@ -404,6 +723,18 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
+        __wbg_isArray_33b91feb269ff46e: function(arg0) {
+            const ret = Array.isArray(arg0);
+            return ret;
+        },
+        __wbg_isSafeInteger_ecd6a7f9c3e053cd: function(arg0) {
+            const ret = Number.isSafeInteger(arg0);
+            return ret;
+        },
+        __wbg_length_b3416cf66a5452c8: function(arg0) {
+            const ret = arg0.length;
+            return ret;
+        },
         __wbg_length_ea16607d7b61445b: function(arg0) {
             const ret = arg0.length;
             return ret;
@@ -431,6 +762,10 @@ function __wbg_get_imports() {
             const ret = new Object();
             return ret;
         },
+        __wbg_new_from_slice_22da9388ac046e50: function(arg0, arg1) {
+            const ret = new Uint8Array(getArrayU8FromWasm0(arg0, arg1));
+            return ret;
+        },
         __wbg_new_typed_aaaeaf29cf802876: function(arg0, arg1) {
             try {
                 var state0 = {a: arg0, b: arg1};
@@ -449,6 +784,10 @@ function __wbg_get_imports() {
                 state0.a = state0.b = 0;
             }
         },
+        __wbg_new_typed_bccac67128ed885a: function() {
+            const ret = new Array();
+            return ret;
+        },
         __wbg_new_with_length_825018a1616e9e55: function(arg0) {
             const ret = new Uint8Array(arg0 >>> 0);
             return ret;
@@ -472,6 +811,10 @@ function __wbg_get_imports() {
         __wbg_prototypesetcall_d62e5099504357e6: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
         },
+        __wbg_push_e87b0e732085a946: function(arg0, arg1) {
+            const ret = arg0.push(arg1);
+            return ret;
+        },
         __wbg_queueMicrotask_0c399741342fb10f: function(arg0) {
             const ret = arg0.queueMicrotask;
             return ret;
@@ -530,16 +873,29 @@ function __wbg_get_imports() {
             const ret = arg0.then(arg1, arg2);
             return ret;
         },
+        __wbg_warn_69424c2d92a2fa73: function(arg0) {
+            console.warn(arg0);
+        },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 4534, function: Function { arguments: [Externref], shim_idx: 20198, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 4167, function: Function { arguments: [Externref], shim_idx: 20855, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h8db467765ce434ac, wasm_bindgen__convert__closures_____invoke__h7573a8a64f443504);
             return ret;
         },
-        __wbindgen_cast_0000000000000002: function(arg0, arg1) {
+        __wbindgen_cast_0000000000000002: function(arg0) {
+            // Cast intrinsic for `F64 -> Externref`.
+            const ret = arg0;
+            return ret;
+        },
+        __wbindgen_cast_0000000000000003: function(arg0, arg1) {
             // Cast intrinsic for `Ref(String) -> Externref`.
             const ret = getStringFromWasm0(arg0, arg1);
             return ret;
         },
+        __wbindgen_cast_0000000000000004: function(arg0) {
+            // Cast intrinsic for `U64 -> Externref`.
+            const ret = BigInt.asUintN(64, arg0);
+            return ret;
+        },
         __wbindgen_init_externref_table: function() {
             const table = wasm.__wbindgen_externrefs;
             const offset = table.grow(4);

package/dist/wasm/cereusdb_bg.wasm.d.ts

@@ -10,8 +10,19 @@ export const __libc_malloc: (a: number) => number;
 export const malloc: (a: number) => number;
 export const __wbg_cereusdb_free: (a: number, b: number) => void;
 export const _abort_js: () => void;
+export const cereusdb_attach_database: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => any;
+export const cereusdb_catalog_json: (a: number) => any;
+export const cereusdb_compact_database: (a: number, b: number, c: number) => any;
 export const cereusdb_create: () => [number, number, number];
+export const cereusdb_detach_database: (a: number, b: number, c: number, d: number) => any;
+export const cereusdb_drop_database: (a: number, b: number, c: number, d: number) => any;
 export const cereusdb_drop_table: (a: number, b: number, c: number) => [number, number];
+export const cereusdb_export_geoparquet: (a: number, b: number, c: number, d: any) => any;
+export const cereusdb_flush: (a: number) => any;
+export const cereusdb_insert_arrow: (a: number, b: number, c: number, d: number, e: number) => any;
+export const cereusdb_list_database_locations: (a: number, b: number, c: number) => any;
+export const cereusdb_qualified_tables: (a: number) => [number, number, number];
+export const cereusdb_register_export_handler: (a: number, b: any) => [number, number];
 export const cereusdb_register_geojson: (a: number, b: number, c: number, d: number, e: number) => [number, number];
 export const cereusdb_register_geotiff_buffer: (a: number, b: number, c: number, d: number, e: number) => [number, number];
 export const cereusdb_register_object_stores: (a: number, b: any) => [number, number];
@@ -19,6 +30,7 @@ export const cereusdb_register_parquet_buffer: (a: number, b: number, c: number,
 export const cereusdb_register_parquet_table: (a: number, b: number, c: number, d: number, e: number, f: any) => any;
 export const cereusdb_register_raster_buffer: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
 export const cereusdb_register_remote_parquet: (a: number, b: number, c: number, d: number, e: number) => any;
+export const cereusdb_register_storage_backend: (a: number, b: number, c: number, d: any) => [number, number];
 export const cereusdb_sql: (a: number, b: number, c: number) => any;
 export const cereusdb_sql_json: (a: number, b: number, c: number) => any;
 export const cereusdb_tables: (a: number) => [number, number, number];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cereusdb/minimal",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Minimal CereusDB browser package with GEOS-backed spatial SQL",
   "type": "module",
   "main": "./dist/index.js",