sqlite-actor 0.1.4 → 0.1.5

package/README.md

@@ -19,7 +19,7 @@ Currently, `sqlite-actor` bundles the following extensions directly into its WAS
 *(Note: We plan to support more extensions in the future based on user requests. Please open a GitHub issue if you need another extension.)*
 
 ## Features
-- **Zero-Config**: The WASM binary is heavily optimized and compiled directly into the JavaScript bundle. No `.wasm` file fetching is required—just `import` and run.
+- **Zero-Config (Hybrid)**: The WASM binary is inlined as a base64 string for easy use in most environments. For security-restricted environments like Cloudflare Workers, we also export the `.wasm` file directly for ESM imports.
 - **Synchronous API**: Designed for the single-threaded nature of Actors, the SDK is completely synchronous after the initial load.
 - **VFS Bridge**: It uses a memory-first Virtual File System (VFS) to back the database to the actor's provided key-value storage.
 
@@ -51,6 +51,22 @@ export class MyVectorActor {
     return new Response(JSON.stringify(results));
   }
 }
+### Cloudflare Workers / Durable Objects
+
+Cloudflare Workers have a strict "No-Eval" policy that blocks instantiating WASM from a buffer. To use `sqlite-actor` in Workers, you must import the `.wasm` file as an ES module and pass it to `create()`:
+
+```javascript
+import { SqliteActor } from "sqlite-actor";
+import wasmModule from "sqlite-actor/sqlite-actor.wasm";
+
+export class MyVectorActor {
+  async fetch(request) {
+    // Pass the pre-compiled wasmModule to bypass "No-Eval" restrictions
+    const db = await SqliteActor.create(this.state.storage, { wasmModule });
+    
+    // ... use the database
+  }
+}
 ```
 
 ## Development setup (Building from Source)

package/dist/index.js

@@ -33,10 +33,18 @@ export class SqliteActor {
         else if (options?.wasmBinary) {
             config.wasmBinary = options.wasmBinary;
         }
-        else {
+        else if (typeof SQLITE_ACTOR_WASM_BASE64 !== "undefined") {
             config.wasmBinary = base64ToUint8Array(SQLITE_ACTOR_WASM_BASE64);
         }
-        this.wasm = await initSqlite3(config);
+        else {
+            throw new Error("No WASM source provided (wasmModule, wasmBinary, or inlined base64)");
+        }
+        try {
+            this.wasm = await initSqlite3(config);
+        }
+        catch (e) {
+            throw new Error(`Failed to initialize SQLite3 WASM: ${e.message}`);
+        }
         // 2. Pre-load all pages into memory cache for synchronous VFS access
         const metaMaxPageId = await this.kv.get("meta:maxPageId");
         this.maxPageId = metaMaxPageId ? Number(new TextDecoder().decode(metaMaxPageId)) : -1;
@@ -201,6 +209,7 @@ export class SqliteActor {
     }
 }
 function base64ToUint8Array(base64) {
+    // Browser / Cloudflare Workers
     if (typeof atob !== "undefined") {
         const binaryString = atob(base64);
         const bytes = new Uint8Array(binaryString.length);
@@ -209,8 +218,11 @@ function base64ToUint8Array(base64) {
         }
         return bytes;
     }
-    else {
+    // Node.js
+    // @ts-ignore
+    if (typeof Buffer !== "undefined") {
         // @ts-ignore
-        return globalThis.Buffer.from(base64, "base64");
+        return Buffer.from(base64, "base64");
     }
+    throw new Error("No base64 decoder found (atob or Buffer)");
 }

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "sqlite-actor",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "type": "module",
   "description": "SQLite + sqlite-vec vector database for actor platforms",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./sqlite-actor.wasm": "./dist/sqlite-actor.wasm"
+  },
   "files": [
     "dist"
   ],