flatsql 0.3.6 → 0.3.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flatsql",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "SQL queries over raw FlatBuffer storage - zero conversion, real-time indexing, pure streaming",
   "type": "module",
   "main": "dist/index.js",
@@ -13,7 +13,12 @@
     "./wasm": {
       "types": "./wasm/index.d.ts",
       "import": "./wasm/index.js"
-    }
+    },
+    "./wasi": {
+      "types": "./wasm/wasi.d.ts",
+      "import": "./wasm/wasi.js"
+    },
+    "./wasi.wasm": "./wasm/flatsql-wasi.wasm"
   },
   "files": [
     "dist",

package/wasm/wasi.d.ts

@@ -0,0 +1,11 @@
+export interface FlatSQLWASILoadOptions {
+  url?: string | URL;
+  path?: string;
+  as?: 'arrayBuffer' | 'uint8array';
+}
+
+export declare function getFlatSQLWASIURL(): URL;
+
+export declare function loadFlatSQLWASI(
+  options?: FlatSQLWASILoadOptions
+): Promise<ArrayBuffer | Uint8Array>;

package/wasm/wasi.js

@@ -0,0 +1,51 @@
+const DEFAULT_WASI_URL = new URL('./flatsql-wasi.wasm', import.meta.url);
+
+/**
+ * Resolve the packaged FlatSQL WASI module URL.
+ */
+export function getFlatSQLWASIURL() {
+  return DEFAULT_WASI_URL;
+}
+
+async function readViaFsPath(path) {
+  const fs = await import('node:fs/promises');
+  return new Uint8Array(await fs.readFile(path));
+}
+
+/**
+ * Load the packaged FlatSQL WASI module bytes.
+ *
+ * @param {{
+ *   url?: string | URL,
+ *   path?: string,
+ *   as?: 'arrayBuffer' | 'uint8array'
+ * }} [options]
+ * @returns {Promise<ArrayBuffer | Uint8Array>}
+ */
+export async function loadFlatSQLWASI(options = {}) {
+  const as = options.as === 'uint8array' ? 'uint8array' : 'arrayBuffer';
+
+  let bytes;
+  if (options.path) {
+    bytes = await readViaFsPath(options.path);
+  } else {
+    const wasmUrl = options.url ? new URL(options.url, import.meta.url) : DEFAULT_WASI_URL;
+
+    if (wasmUrl.protocol === 'file:') {
+      const { fileURLToPath } = await import('node:url');
+      bytes = await readViaFsPath(fileURLToPath(wasmUrl));
+    } else {
+      const response = await fetch(wasmUrl);
+      if (!response.ok) {
+        throw new Error(`Failed to load flatsql-wasi.wasm: ${response.status}`);
+      }
+      bytes = new Uint8Array(await response.arrayBuffer());
+    }
+  }
+
+  if (as === 'uint8array') {
+    return bytes;
+  }
+
+  return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+}