✨ feat: Configure Vite to produce a single, minified library output

Author: haroonwaves

README.md

@@ -52,10 +52,9 @@ await db.ready();
 
 // 3. Use the table() API
 // The '$' symbol is automatically replaced by the table name ('users')
-const users = db.table('users');
 
 // Create Table
-await users.exec(`
+await db.table('users').exec(`
   CREATE TABLE IF NOT EXISTS $ (
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     name TEXT NOT NULL,
@@ -64,10 +63,12 @@ await users.exec(`
 `);
 
 // Insert (Fully typed params are not enforced yet, but return types are)
-await users.run('INSERT INTO $ (name, email) VALUES (?, ?)', ['Alice', 'alice@dev.com']);
+await db
+	.table('users')
+	.run('INSERT INTO $ (name, email) VALUES (?, ?)', ['Alice', 'alice@dev.com']);
 
 // Query (Returns User[])
-const allUsers = await users.query('SELECT * FROM $');
+const allUsers = await db.table('users').query('SELECT * FROM $');
 ```
 
 ## Configuration
@@ -119,24 +120,34 @@ Key interfaces for better TypeScript integration.
 
 ```typescript
 interface SQLiteWASMConfig {
-	filename: string;
+	filename: string; // Required: Database file name
 	vfs?: {
-		type?: 'opfs' | 'opfs-sahpool' | 'memdb';
+		type?: 'opfs' | 'opfs-sahpool' | 'memdb'; // Default: 'opfs'
+		poolConfig?: {
+			// Only used when type is 'opfs-sahpool'
+			initialCapacity?: number; // Default: 3
+			clearOnInit?: boolean; // Default: false
+			name?: string; // Default: 'sqlite-wasm-pool'
+		};
 	};
 	pragma?: {
-		journal_mode?: 'DELETE' | 'TRUNCATE' | 'PERSIST' | 'MEMORY' | 'WAL' | 'OFF';
-		synchronous?: 'OFF' | 'NORMAL' | 'FULL' | 'EXTRA';
-		temp_store?: 'DEFAULT' | 'FILE' | 'MEMORY';
-		foreign_keys?: 'ON' | 'OFF';
+		journal_mode?: 'DELETE' | 'TRUNCATE' | 'PERSIST' | 'MEMORY' | 'WAL' | 'OFF'; // Default: 'WAL'
+		synchronous?: 'OFF' | 'NORMAL' | 'FULL' | 'EXTRA'; // Default: 'NORMAL'
+		temp_store?: 'DEFAULT' | 'FILE' | 'MEMORY'; // Default: 'MEMORY'
+		foreign_keys?: 'ON' | 'OFF'; // Default: undefined (not set)
 	};
 	logging?: {
-		filterSqlTrace?: boolean;
-		print?: (message: string) => void;
-		printErr?: (message: string) => void;
+		filterSqlTrace?: boolean; // Default: true
+		print?: (message: string) => void; // Default: console.log
+		printErr?: (message: string) => void; // Default: console.error
 	};
 }
 ```
 
+> **Note:** The `opfs` VFS requires your server to set COOP/COEP headers
+> (`Cross-Origin-Opener-Policy: same-origin` and `Cross-Origin-Embedder-Policy: require-corp`). If
+> these headers are not available, use `opfs-sahpool` instead, which works without them.
+
 ### `RunResult`
 
 Returned by `run()` and `table().run()`.

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@haroonwaves/sqlite-wasm-easy",
-	"version": "0.2.2",
+	"version": "0.2.5",
 	"description": "A simple, zero-config wrapper around @sqlite.org/sqlite-wasm",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -10,9 +10,6 @@
 		".": {
 			"import": "./dist/index.js",
 			"types": "./dist/index.d.ts"
-		},
-		"./worker": {
-			"import": "./dist/worker.js"
 		}
 	},
 	"files": [

src/worker/sqliteWorker.ts

@@ -72,7 +72,15 @@ async function openDatabase(filename: string) {
 	} else if (vfsType === 'memdb') {
 		db = new sqlite3.oo1.DB(':memory:', 'c');
 	} else {
-		// Fallback to default database
+		// Check if OpfsDb is available (requires COOP/COEP headers)
+		if (typeof sqlite3.oo1.OpfsDb !== 'function') {
+			throw new Error(
+				'OPFS VFS is not available. This usually means your server is not configured with ' +
+					'the required COOP/COEP headers (Cross-Origin-Opener-Policy: same-origin, ' +
+					"Cross-Origin-Embedder-Policy: require-corp). Consider using 'opfs-sahpool' instead, " +
+					'which does not require these headers.'
+			);
+		}
 		db = new sqlite3.oo1.OpfsDb(filename, 'c');
 	}
 

vite.config.ts

@@ -1,33 +1,51 @@
-import { defineConfig } from 'vite';
+import { defineConfig, type Plugin } from 'vite';
 import { resolve } from 'path';
 import { fileURLToPath } from 'url';
+import { rmSync } from 'fs';
 import dts from 'vite-plugin-dts';
 
 const __dirname = fileURLToPath(new URL('.', import.meta.url));
 
+// Plugin to clean up extra assets generated by @sqlite.org/sqlite-wasm
+function cleanupAssets(): Plugin {
+	return {
+		name: 'cleanup-assets',
+		closeBundle() {
+			// Remove the assets folder containing duplicate SQLite workers
+			// Everything is inlined via ?worker&inline, so these aren't needed
+			try {
+				rmSync(resolve(__dirname, 'dist/assets'), { recursive: true, force: true });
+			} catch {
+				// Ignore if folder doesn't exist
+			}
+		},
+	};
+}
+
 export default defineConfig({
 	root: '.', // Root directory for dev server
-	plugins: [dts({ rollupTypes: true })],
+	plugins: [dts({ rollupTypes: true }), cleanupAssets()],
 	build: {
 		lib: {
-			entry: {
-				index: resolve(__dirname, 'src/index.ts'),
-				worker: resolve(__dirname, 'src/worker/sqliteWorker.ts'),
-			},
+			// Only export the main entry - worker is inlined via ?worker&inline
+			entry: resolve(__dirname, 'src/index.ts'),
 			formats: ['es'],
-			fileName: (format, entryName) => `${entryName}.js`,
+			fileName: () => 'index.js',
 		},
 		rollupOptions: {
-			// Don't mark sqlite-wasm as external - bundle it into the worker
-			// so the inlined worker is self-contained and works offline
 			output: {
-				preserveModules: false,
+				// Prevent code splitting - everything in one file
+				manualChunks: undefined,
+				inlineDynamicImports: true,
 			},
 		},
 		target: 'es2022',
 		outDir: 'dist',
 		emptyOutDir: true,
-		sourcemap: true,
+		// Disable source maps for smaller production builds
+		sourcemap: false,
+		// Minify for smaller output
+		minify: 'esbuild',
 	},
 	server: {
 		open: '/examples/basic.html', // Auto-open examples on dev server start