@skillsmith/core 0.4.8 → 0.4.10

package/dist/tests/db/database-abstraction.test.js

@@ -0,0 +1,208 @@
+/**
+ * SMI-2180: Database Abstraction Layer Tests
+ *
+ * Tests the database interface contracts and driver implementations.
+ * These tests should pass with any conforming driver (better-sqlite3, sql.js).
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { createDatabaseSync, createDatabaseAsync, detectAvailableDrivers, getBestDriver, } from '../../src/db/createDatabase.js';
+import { isBetterSqlite3Available, BetterSqlite3Database, } from '../../src/db/drivers/betterSqlite3Driver.js';
+describe('Database Abstraction Layer', () => {
+    describe('Driver Detection', () => {
+        it('should detect available drivers', () => {
+            const drivers = detectAvailableDrivers();
+            expect(drivers).toBeInstanceOf(Array);
+            expect(drivers.length).toBeGreaterThan(0);
+            // Each driver should have required fields
+            for (const driver of drivers) {
+                expect(driver).toHaveProperty('type');
+                expect(driver).toHaveProperty('available');
+                expect(typeof driver.available).toBe('boolean');
+            }
+        });
+        it('should get best available driver', () => {
+            const best = getBestDriver();
+            // In Docker environment, better-sqlite3 should be available
+            if (isBetterSqlite3Available()) {
+                expect(best).toBe('better-sqlite3');
+            }
+        });
+        it('should detect better-sqlite3 availability', () => {
+            const available = isBetterSqlite3Available();
+            expect(typeof available).toBe('boolean');
+        });
+    });
+    describe('Database Interface Contract', () => {
+        let db;
+        beforeEach(() => {
+            // Skip if no driver available
+            if (!isBetterSqlite3Available()) {
+                return;
+            }
+            db = createDatabaseSync(':memory:');
+        });
+        afterEach(() => {
+            if (db?.open) {
+                db.close();
+            }
+        });
+        it('should create in-memory database', () => {
+            if (!isBetterSqlite3Available())
+                return;
+            expect(db).toBeDefined();
+            expect(db.open).toBe(true);
+            expect(db.memory).toBe(true);
+        });
+        it('should execute raw SQL', () => {
+            if (!isBetterSqlite3Available())
+                return;
+            expect(() => {
+                db.exec(`
+          CREATE TABLE test (
+            id INTEGER PRIMARY KEY,
+            name TEXT NOT NULL
+          )
+        `);
+            }).not.toThrow();
+        });
+        it('should prepare and execute statements', () => {
+            if (!isBetterSqlite3Available())
+                return;
+            db.exec('CREATE TABLE test (id INTEGER PRIMARY KEY, name TEXT)');
+            const insertStmt = db.prepare('INSERT INTO test (name) VALUES (?)');
+            const result = insertStmt.run('Alice');
+            expect(result.changes).toBe(1);
+            expect(result.lastInsertRowid).toBe(1);
+        });
+        it('should query single row with get()', () => {
+            if (!isBetterSqlite3Available())
+                return;
+            db.exec('CREATE TABLE test (id INTEGER PRIMARY KEY, name TEXT)');
+            db.exec("INSERT INTO test (name) VALUES ('Alice'), ('Bob')");
+            const stmt = db.prepare('SELECT * FROM test WHERE name = ?');
+            const row = stmt.get('Alice');
+            expect(row).toEqual({ id: 1, name: 'Alice' });
+        });
+        it('should return undefined for non-existent row', () => {
+            if (!isBetterSqlite3Available())
+                return;
+            db.exec('CREATE TABLE test (id INTEGER PRIMARY KEY, name TEXT)');
+            const stmt = db.prepare('SELECT * FROM test WHERE name = ?');
+            const row = stmt.get('NonExistent');
+            expect(row).toBeUndefined();
+        });
+        it('should query multiple rows with all()', () => {
+            if (!isBetterSqlite3Available())
+                return;
+            db.exec('CREATE TABLE test (id INTEGER PRIMARY KEY, name TEXT)');
+            db.exec("INSERT INTO test (name) VALUES ('Alice'), ('Bob'), ('Charlie')");
+            const stmt = db.prepare('SELECT * FROM test');
+            const rows = stmt.all();
+            expect(rows).toHaveLength(3);
+            expect(rows[0].name).toBe('Alice');
+            expect(rows[1].name).toBe('Bob');
+            expect(rows[2].name).toBe('Charlie');
+        });
+        it('should iterate over rows with iterate()', () => {
+            if (!isBetterSqlite3Available())
+                return;
+            db.exec('CREATE TABLE test (id INTEGER PRIMARY KEY, name TEXT)');
+            db.exec("INSERT INTO test (name) VALUES ('Alice'), ('Bob')");
+            const stmt = db.prepare('SELECT * FROM test');
+            const names = [];
+            for (const row of stmt.iterate()) {
+                names.push(row.name);
+            }
+            expect(names).toEqual(['Alice', 'Bob']);
+        });
+        it('should execute transactions', () => {
+            if (!isBetterSqlite3Available())
+                return;
+            db.exec('CREATE TABLE test (id INTEGER PRIMARY KEY, balance INTEGER)');
+            db.exec('INSERT INTO test (balance) VALUES (100), (50)');
+            const transfer = () => {
+                const withdraw = db.prepare('UPDATE test SET balance = balance - ? WHERE id = ?');
+                const deposit = db.prepare('UPDATE test SET balance = balance + ? WHERE id = ?');
+                withdraw.run(30, 1);
+                deposit.run(30, 2);
+                return 'success';
+            };
+            // transaction() returns a callable function
+            const txn = db.transaction(transfer);
+            const result = txn();
+            expect(result).toBe('success');
+            // Verify balances
+            const stmt = db.prepare('SELECT balance FROM test WHERE id = ?');
+            expect(stmt.get(1)?.balance).toBe(70);
+            expect(stmt.get(2)?.balance).toBe(80);
+        });
+        it('should execute pragma statements', () => {
+            if (!isBetterSqlite3Available())
+                return;
+            // Set pragma
+            db.pragma('foreign_keys = ON');
+            // Get pragma value
+            const result = db.pragma('foreign_keys');
+            expect(result).toBeDefined();
+        });
+        it('should close database', () => {
+            if (!isBetterSqlite3Available())
+                return;
+            expect(db.open).toBe(true);
+            db.close();
+            expect(db.open).toBe(false);
+        });
+        it('should expose database properties', () => {
+            if (!isBetterSqlite3Available())
+                return;
+            expect(db.name).toBe(':memory:');
+            expect(db.memory).toBe(true);
+            expect(db.readonly).toBe(false);
+        });
+    });
+    describe('Async Database Creation', () => {
+        it('should create database asynchronously', async () => {
+            if (!isBetterSqlite3Available())
+                return;
+            const db = await createDatabaseAsync(':memory:');
+            expect(db).toBeDefined();
+            expect(db.open).toBe(true);
+            db.close();
+        });
+    });
+    describe('BetterSqlite3Database Wrapper', () => {
+        it('should provide access to native instance', () => {
+            if (!isBetterSqlite3Available())
+                return;
+            const db = createDatabaseSync(':memory:');
+            expect(db).toBeInstanceOf(BetterSqlite3Database);
+            const native = db.native;
+            expect(native).toBeDefined();
+            expect(native.open).toBe(true);
+            db.close();
+        });
+    });
+    describe('Error Handling', () => {
+        it('should throw on invalid SQL', () => {
+            if (!isBetterSqlite3Available())
+                return;
+            const db = createDatabaseSync(':memory:');
+            expect(() => {
+                db.exec('INVALID SQL STATEMENT');
+            }).toThrow();
+            db.close();
+        });
+        it('should throw on constraint violation', () => {
+            if (!isBetterSqlite3Available())
+                return;
+            const db = createDatabaseSync(':memory:');
+            db.exec('CREATE TABLE test (id INTEGER PRIMARY KEY, name TEXT UNIQUE)');
+            db.exec("INSERT INTO test (name) VALUES ('Alice')");
+            expect(() => {
+                db.exec("INSERT INTO test (name) VALUES ('Alice')");
+            }).toThrow();
+            db.close();
+        });
+    });
+});
+//# sourceMappingURL=database-abstraction.test.js.map

package/dist/tests/db/database-abstraction.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-abstraction.test.js","sourceRoot":"","sources":["../../../tests/db/database-abstraction.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAEpE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,GACd,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,6CAA6C,CAAA;AAEpD,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,OAAO,GAAG,sBAAsB,EAAE,CAAA;YACxC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;YACrC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;YAEzC,0CAA0C;YAC1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;gBACrC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAA;gBAC1C,MAAM,CAAC,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACjD,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,IAAI,GAAG,aAAa,EAAE,CAAA;YAC5B,4DAA4D;YAC5D,IAAI,wBAAwB,EAAE,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;YACrC,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,SAAS,GAAG,wBAAwB,EAAE,CAAA;YAC5C,MAAM,CAAC,OAAO,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC1C,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;QAC3C,IAAI,EAAY,CAAA;QAEhB,UAAU,CAAC,GAAG,EAAE;YACd,8BAA8B;YAC9B,IAAI,CAAC,wBAAwB,EAAE,EAAE,CAAC;gBAChC,OAAM;YACR,CAAC;YACD,EAAE,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAA;QACrC,CAAC,CAAC,CAAA;QAEF,SAAS,CAAC,GAAG,EAAE;YACb,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;gBACb,EAAE,CAAC,KAAK,EAAE,CAAA;YACZ,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;YACxB,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC1B,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9B,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;YAChC,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,MAAM,CAAC,GAAG,EAAE;gBACV,EAAE,CAAC,IAAI,CAAC;;;;;SAKP,CAAC,CAAA;YACJ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;QAClB,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,EAAE,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAA;YAEhE,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAC3B,oCAAoC,CACrC,CAAA;YACD,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YAEtC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAC9B,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACxC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,EAAE,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAA;YAChE,EAAE,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAA;YAE5D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAA+B,mCAAmC,CAAC,CAAA;YAC1F,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YAE7B,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;QAC/C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,EAAE,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAA;YAEhE,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAA+B,mCAAmC,CAAC,CAAA;YAC1F,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;YAEnC,MAAM,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,CAAA;QAC7B,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,EAAE,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAA;YAChE,EAAE,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAA;YAEzE,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAA+B,oBAAoB,CAAC,CAAA;YAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAEvB,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;YAC5B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAClC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAChC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACtC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,EAAE,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAA;YAChE,EAAE,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAA;YAE5D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAA+B,oBAAoB,CAAC,CAAA;YAC3E,MAAM,KAAK,GAAa,EAAE,CAAA;YAE1B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACtB,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;QACzC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,EAAE,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAA;YACtE,EAAE,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAA;YAExD,MAAM,QAAQ,GAAG,GAAG,EAAE;gBACpB,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,oDAAoD,CAAC,CAAA;gBACjF,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,oDAAoD,CAAC,CAAA;gBAEhF,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;gBACnB,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;gBAElB,OAAO,SAAS,CAAA;YAClB,CAAC,CAAA;YAED,4CAA4C;YAC5C,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;YACpC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAA;YACpB,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAE9B,kBAAkB;YAClB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAsB,uCAAuC,CAAC,CAAA;YACrF,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACrC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACvC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,aAAa;YACb,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAA;YAE9B,mBAAmB;YACnB,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;YACxC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;QAC9B,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;YAC/B,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC1B,EAAE,CAAC,KAAK,EAAE,CAAA;YACV,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC7B,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YAChC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC5B,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACjC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;YACrD,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,MAAM,EAAE,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAA;YAChD,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;YACxB,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC1B,EAAE,CAAC,KAAK,EAAE,CAAA;QACZ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;QAC7C,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,MAAM,EAAE,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAA;YACzC,MAAM,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAA;YAEhD,MAAM,MAAM,GAAI,EAA4B,CAAC,MAAM,CAAA;YACnD,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;YAC5B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAE9B,EAAE,CAAC,KAAK,EAAE,CAAA;QACZ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,MAAM,EAAE,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAA;YAEzC,MAAM,CAAC,GAAG,EAAE;gBACV,EAAE,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;YAClC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;YAEZ,EAAE,CAAC,KAAK,EAAE,CAAA;QACZ,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,IAAI,CAAC,wBAAwB,EAAE;gBAAE,OAAM;YAEvC,MAAM,EAAE,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAA;YACzC,EAAE,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAA;YACvE,EAAE,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAA;YAEnD,MAAM,CAAC,GAAG,EAAE;gBACV,EAAE,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAA;YACrD,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;YAEZ,EAAE,CAAC,KAAK,EAAE,CAAA;QACZ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/tests/db/fts5-support.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SMI-2182: FTS5 Support Test
+ *
+ * Tests whether the current sql.js installation has FTS5 support.
+ * FTS5 is required for full-text search capabilities.
+ *
+ * Standard sql.js builds do NOT include FTS5 by default.
+ * If this test fails, we need to build a custom sql.js with FTS5 enabled.
+ *
+ * @see https://github.com/niclaslindstedt/sql.js-fts5
+ * @see https://www.sqlite.org/fts5.html
+ */
+export {};
+//# sourceMappingURL=fts5-support.test.d.ts.map

package/dist/tests/db/fts5-support.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts5-support.test.d.ts","sourceRoot":"","sources":["../../../tests/db/fts5-support.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/tests/db/fts5-support.test.js

@@ -0,0 +1,128 @@
+/**
+ * SMI-2182: FTS5 Support Test
+ *
+ * Tests whether the current sql.js installation has FTS5 support.
+ * FTS5 is required for full-text search capabilities.
+ *
+ * Standard sql.js builds do NOT include FTS5 by default.
+ * If this test fails, we need to build a custom sql.js with FTS5 enabled.
+ *
+ * @see https://github.com/niclaslindstedt/sql.js-fts5
+ * @see https://www.sqlite.org/fts5.html
+ */
+import { describe, it, expect, afterEach } from 'vitest';
+// Track database for cleanup
+let db = null;
+/**
+ * Load fts5-sql-bundle WASM module directly for this test
+ * fts5-sql-bundle has a built-in locateFile that correctly resolves the WASM file
+ */
+async function loadSqlJs() {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const module = (await import('fts5-sql-bundle'));
+    const initSqlJs = module.default || module;
+    return initSqlJs();
+}
+describe('FTS5 Support Detection', () => {
+    afterEach(() => {
+        if (db) {
+            db.close();
+            db = null;
+        }
+    });
+    it('should detect FTS5 availability in sql.js', async () => {
+        const SQL = await loadSqlJs();
+        db = new SQL.Database();
+        let fts5Available = false;
+        let errorMessage = '';
+        try {
+            // Attempt to create an FTS5 virtual table
+            db.run(`
+        CREATE VIRTUAL TABLE test_fts USING fts5(content);
+      `);
+            fts5Available = true;
+            // If successful, test insertion and MATCH query
+            db.run(`INSERT INTO test_fts (content) VALUES ('hello world');`);
+            db.run(`INSERT INTO test_fts (content) VALUES ('goodbye world');`);
+            db.run(`INSERT INTO test_fts (content) VALUES ('hello there');`);
+            // Run a MATCH query
+            const stmt = db.prepare(`SELECT content FROM test_fts WHERE test_fts MATCH 'hello';`);
+            const results = [];
+            while (stmt.step()) {
+                const row = stmt.get();
+                results.push(row[0]);
+            }
+            stmt.free();
+            // Verify MATCH query works
+            expect(results).toHaveLength(2);
+            expect(results).toContain('hello world');
+            expect(results).toContain('hello there');
+            console.log('\n========================================');
+            console.log('FTS5 IS AVAILABLE in sql.js');
+            console.log('----------------------------------------');
+            console.log('FTS5 virtual table creation: SUCCESS');
+            console.log('FTS5 INSERT operations: SUCCESS');
+            console.log('FTS5 MATCH query: SUCCESS');
+            console.log(`  - Found ${results.length} results for "hello"`);
+            console.log('========================================\n');
+        }
+        catch (error) {
+            fts5Available = false;
+            errorMessage = error instanceof Error ? error.message : String(error);
+            console.log('\n========================================');
+            console.log('FTS5 IS NOT AVAILABLE in sql.js');
+            console.log('----------------------------------------');
+            console.log(`Error: ${errorMessage}`);
+            console.log('');
+            console.log('RECOMMENDATION: Build custom sql.js with FTS5');
+            console.log('See: https://github.com/niclaslindstedt/sql.js-fts5');
+            console.log('Or: Build from source with -DSQLITE_ENABLE_FTS5');
+            console.log('========================================\n');
+        }
+        // Report the result - test passes either way to show the detection result
+        console.log(`\nFTS5 Support: ${fts5Available ? 'YES' : 'NO'}`);
+        // Make this an informational test that always passes
+        // The real assertion is whether we need a custom build
+        expect(true).toBe(true);
+    });
+    it('should report SQLite compile options', async () => {
+        const SQL = await loadSqlJs();
+        db = new SQL.Database();
+        // Query compile options to see what's enabled
+        const stmt = db.prepare('PRAGMA compile_options;');
+        const options = [];
+        while (stmt.step()) {
+            const row = stmt.get();
+            options.push(row[0]);
+        }
+        stmt.free();
+        console.log('\n========================================');
+        console.log('SQLite Compile Options in sql.js');
+        console.log('----------------------------------------');
+        options.forEach((opt) => {
+            console.log(`  - ${opt}`);
+        });
+        console.log('========================================\n');
+        // Check for FTS-related options
+        const hasFts3 = options.some((opt) => opt.includes('FTS3'));
+        const hasFts4 = options.some((opt) => opt.includes('FTS4'));
+        const hasFts5 = options.some((opt) => opt.includes('FTS5'));
+        console.log(`FTS3: ${hasFts3 ? 'ENABLED' : 'NOT FOUND'}`);
+        console.log(`FTS4: ${hasFts4 ? 'ENABLED' : 'NOT FOUND'}`);
+        console.log(`FTS5: ${hasFts5 ? 'ENABLED' : 'NOT FOUND'}`);
+        // This test always passes - it's for reporting purposes
+        expect(options.length).toBeGreaterThan(0);
+    });
+    it('should report SQLite version', async () => {
+        const SQL = await loadSqlJs();
+        db = new SQL.Database();
+        const stmt = db.prepare('SELECT sqlite_version();');
+        stmt.step();
+        const version = stmt.get()[0];
+        stmt.free();
+        console.log(`\nSQLite Version: ${version}`);
+        expect(version).toBeDefined();
+        expect(version).toMatch(/^\d+\.\d+\.\d+$/);
+    });
+});
+//# sourceMappingURL=fts5-support.test.js.map

package/dist/tests/db/fts5-support.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts5-support.test.js","sourceRoot":"","sources":["../../../tests/db/fts5-support.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/db/schema-async.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * SMI-2206: Async Schema Functions Tests
+ *
+ * Tests for async database initialization with WASM fallback support.
+ * These tests verify that createDatabaseAsync and openDatabaseAsync work
+ * correctly with automatic driver selection.
+ */
+export {};
+//# sourceMappingURL=schema-async.test.d.ts.map

package/dist/tests/db/schema-async.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-async.test.d.ts","sourceRoot":"","sources":["../../../tests/db/schema-async.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}