lazy-sparql-result-reader 1.0.0 → 1.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ioannis Nezis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,102 @@
+<h1 align="center">
+  lazy-sparql-result-reader
+</h1>
+
+<div align="center">
+    <a href="https://www.npmjs.com/package/lazy-sparql-result-reader">
+        <img alt="npm" src="https://img.shields.io/npm/v/lazy-sparql-result-reader" />
+    </a>
+    <a href="https://crates.io/crates/lazy-sparql-result-reader">
+        <img alt="crates.io" src="https://img.shields.io/crates/v/lazy-sparql-result-reader.svg" />
+    </a>
+</div>
+
+A fast SPARQL results parser for JavaScript and TypeScript, compiled from Rust via WebAssembly.  
+It reads streamed SPARQL query results and calls a callback for each parsed batch of bindings.
+
+---
+
+## Features
+
+- Processes streaming SPARQL results efficiently.
+- Calls a JavaScript callback for each batch of parsed bindings.
+- Written in Rust for speed and reliability.
+- Fully compatible with TypeScript.
+
+---
+
+
+## Usage Example
+
+### 1. Install dependencies
+
+```bash
+npm install  lazy-sparql-result-reader vite @vitejs/plugin-wasm
+```
+
+### 2. Configure Vite for WASM
+
+Create or update vite.config.ts:
+
+```bash
+import { defineConfig } from 'vite';
+import wasm from '@vitejs/plugin-wasm';
+
+export default defineConfig({
+  plugins: [wasm()],
+});
+```
+
+This allows Vite to correctly load WebAssembly modules.
+
+### 3. Use the parser in your app
+
+```ts
+import init, { read } from "lazy-sparql-result-reader?init";
+
+// Initialize the WASM module
+await init();
+
+fetch("https://qlever.dev/api/wikidata", {
+  method: 'POST',
+  headers: {
+    "Accept": "application/sparql-results+json",
+    "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
+  },
+  body: new URLSearchParams({
+    query: "SELECT * {?s ?p ?o} LIMIT 1000",
+  })
+})
+.then(async response => {
+  if (!response.ok) {
+    throw new Error(`SPARQL request failed: ${response.status}`);
+  }
+  const stream = response.body; // ReadableStream of the SPARQL JSON results
+  if (!stream) throw new Error("Response has no body stream");
+  // Parse the streamed results with the WASM parser
+  await read(stream, 100, (bindings) => {
+    console.log("Received batch of bindings:", bindings);
+  });
+})
+.catch((err) => {
+  console.error("Error fetching or parsing SPARQL results:", err);
+});
+```
+
+## Notes
+
+- The **first callback invocation** contains the **SPARQL head**, i.e., the variable names in the result set.
+- Subsequent callback invocations contain batches of bindings as they are parsed.
+- `batch_size` controls how many bindings are buffered before each callback.
+- Ensure your environment supports **ReadableStream** (modern browsers or Node.js >= 18).
+
+This setup allows your JS/TS application to process **streaming SPARQL results** efficiently,  
+with immediate access to the head and incremental batches of bindings.
+
+## License
+
+This project is licensed under the **MIT** License.
+
+You are free to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software, under the conditions of the MIT License.
+
+For full details, see the [LICENSE](./LICENSE) file.

package/lazy_sparql_result_reader.d.ts

@@ -16,7 +16,6 @@ export interface InitOutput {
   readonly __wbindgen_exn_store: (a: number) => void;
   readonly __externref_table_alloc: () => number;
   readonly __wbindgen_externrefs: WebAssembly.Table;
-  readonly __wbindgen_free: (a: number, b: number, c: number) => void;
   readonly __wbindgen_start: () => void;
 }
 

package/lazy_sparql_result_reader.js

@@ -308,26 +308,6 @@ function __wbg_get_imports() {
         const ret = arg0.call(arg1);
         return ret;
     }, arguments) };
-    imports.wbg.__wbg_debug_9ad80675faf0c9cf = function(arg0, arg1, arg2, arg3) {
-        console.debug(arg0, arg1, arg2, arg3);
-    };
-    imports.wbg.__wbg_error_7534b8e9a36f1ab4 = function(arg0, arg1) {
-        let deferred0_0;
-        let deferred0_1;
-        try {
-            deferred0_0 = arg0;
-            deferred0_1 = arg1;
-            console.error(getStringFromWasm0(arg0, arg1));
-        } finally {
-            wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
-        }
-    };
-    imports.wbg.__wbg_error_7bc7d576a6aaf855 = function(arg0) {
-        console.error(arg0);
-    };
-    imports.wbg.__wbg_error_ad1ecdacd1bb600d = function(arg0, arg1, arg2, arg3) {
-        console.error(arg0, arg1, arg2, arg3);
-    };
     imports.wbg.__wbg_getReader_b6676f6d8b326942 = function(arg0) {
         const ret = arg0.getReader();
         return ret;
@@ -336,16 +316,10 @@ function __wbg_get_imports() {
         const ret = Reflect.get(arg0, arg1);
         return ret;
     }, arguments) };
-    imports.wbg.__wbg_info_b7fa8ce2e59d29c6 = function(arg0, arg1, arg2, arg3) {
-        console.info(arg0, arg1, arg2, arg3);
-    };
     imports.wbg.__wbg_length_22ac23eaec9d8053 = function(arg0) {
         const ret = arg0.length;
         return ret;
     };
-    imports.wbg.__wbg_log_f614673762e98966 = function(arg0, arg1, arg2, arg3) {
-        console.log(arg0, arg1, arg2, arg3);
-    };
     imports.wbg.__wbg_new_1ba21ce319a06297 = function() {
         const ret = new Object();
         return ret;
@@ -358,10 +332,6 @@ function __wbg_get_imports() {
         const ret = new Uint8Array(arg0);
         return ret;
     };
-    imports.wbg.__wbg_new_8a6f238a6ece86ea = function() {
-        const ret = new Error();
-        return ret;
-    };
     imports.wbg.__wbg_new_b546ae120718850e = function() {
         const ret = new Map();
         return ret;
@@ -416,13 +386,6 @@ function __wbg_get_imports() {
         const ret = arg0.set(arg1, arg2);
         return ret;
     };
-    imports.wbg.__wbg_stack_0ed75d68575b0f3c = function(arg0, arg1) {
-        const ret = arg1.stack;
-        const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-        const len1 = WASM_VECTOR_LEN;
-        getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
-        getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
-    };
     imports.wbg.__wbg_static_accessor_GLOBAL_769e6b65d6557335 = function() {
         const ret = typeof global === 'undefined' ? null : global;
         return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
@@ -447,16 +410,13 @@ function __wbg_get_imports() {
         const ret = arg0.then(arg1);
         return ret;
     };
-    imports.wbg.__wbg_warn_165ef4f6bcfc05e7 = function(arg0, arg1, arg2, arg3) {
-        console.warn(arg0, arg1, arg2, arg3);
-    };
     imports.wbg.__wbindgen_cast_2241b6af4c4b2941 = function(arg0, arg1) {
         // Cast intrinsic for `Ref(String) -> Externref`.
         const ret = getStringFromWasm0(arg0, arg1);
         return ret;
     };
-    imports.wbg.__wbindgen_cast_27d8f2a9ce018ee0 = function(arg0, arg1) {
-        // Cast intrinsic for `Closure(Closure { dtor_idx: 43, function: Function { arguments: [Externref], shim_idx: 44, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+    imports.wbg.__wbindgen_cast_c6111fef16576abb = function(arg0, arg1) {
+        // Cast intrinsic for `Closure(Closure { dtor_idx: 40, function: Function { arguments: [Externref], shim_idx: 41, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
         const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h9431bfc0c26898f5, wasm_bindgen__convert__closures_____invoke__h53040b977ccf16ad);
         return ret;
     };

package/package.json

@@ -1,7 +1,13 @@
 {
   "name": "lazy-sparql-result-reader",
   "type": "module",
-  "version": "1.0.0",
+  "description": "A lazy sparql result reader",
+  "version": "1.1.1",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/IoannisNezis/Lazy-SPARQL-result-reader"
+  },
   "files": [
     "lazy_sparql_result_reader_bg.wasm",
     "lazy_sparql_result_reader.js",