import test from "ava"; import crypto from 'crypto'; import fs from 'fs'; test.beforeEach(async (t) => { const [db, path, provider, errorType] = await connect(); db.exec(` DROP TABLE IF EXISTS users; CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT, email TEXT) `); db.exec( "INSERT INTO users (id, name, email) VALUES (1, 'Alice', 'alice@example.org')" ); db.exec( "INSERT INTO users (id, name, email) VALUES (2, 'Bob', 'bob@example.com')" ); t.context = { db, path, provider, errorType, }; }); test.afterEach.always(async (t) => { // Close the database connection if (t.context.db != undefined) { t.context.db.close(); } // Remove the database file if it exists if (t.context.path) { const walPath = t.context.path + "-wal"; const shmPath = t.context.path + "-shm"; if (fs.existsSync(t.context.path)) { fs.unlinkSync(t.context.path); } if (fs.existsSync(walPath)) { fs.unlinkSync(walPath); } if (fs.existsSync(shmPath)) { fs.unlinkSync(shmPath); } } }); test.serial("Open in-memory database", async (t) => { const [db] = await connect(":memory:"); t.is(db.memory, true); }); // ========================================================================== // Database.exec() // ========================================================================== test.skip("Database.exec() syntax error", async (t) => { const db = t.context.db; const syntaxError = t.throws(() => { db.exec("SYNTAX ERROR"); }, { instanceOf: t.context.errorType, message: 'near "SYNTAX": syntax error', code: 'SQLITE_ERROR' }); const noTableError = t.throws(() => { db.exec("SELECT * FROM missing_table"); }, { instanceOf: t.context.errorType, message: "no such table: missing_table", code: 'SQLITE_ERROR' }); if (t.context.provider === 'libsql') { t.is(noTableError.rawCode, 1) t.is(syntaxError.rawCode, 1) } }); test.serial("Database.exec() after close()", async (t) => { const db = t.context.db; db.close(); t.throws(() => { db.exec("SELECT 1"); }, { instanceOf: TypeError, message: "The database connection is not open" }); }); // ========================================================================== // Database.prepare() // ========================================================================== test.skip("Statement.prepare() syntax error", async (t) => { const db = t.context.db; t.throws(() => { return db.prepare("SYNTAX ERROR"); }, { instanceOf: t.context.errorType, message: 'near "SYNTAX": syntax error' }); }); test.serial("Database.prepare() after close()", async (t) => { const db = t.context.db; db.close(); t.throws(() => { db.prepare("SELECT 1"); }, { instanceOf: TypeError, message: "The database connection is not open" }); }); // ========================================================================== // Database.pragma() // ========================================================================== test.serial("Database.pragma()", async (t) => { const db = t.context.db; db.pragma("cache_size = 2000"); t.deepEqual(db.pragma("cache_size"), [{ "cache_size": 2000 }]); }); test.serial("Database.pragma() after close()", async (t) => { const db = t.context.db; db.close(); t.throws(() => { db.pragma("cache_size = 2000"); }, { instanceOf: TypeError, message: "The database connection is not open" }); }); // ========================================================================== // Database.transaction() // ========================================================================== test.serial("Database.transaction()", async (t) => { const db = t.context.db; const insert = db.prepare( "INSERT INTO users(name, email) VALUES (:name, :email)" ); const insertMany = db.transaction((users) => { t.is(db.inTransaction, true); for (const user of users) insert.run(user); }); t.is(db.inTransaction, false); insertMany([ { name: "Joey", email: "joey@example.org" }, { name: "Sally", email: "sally@example.org" }, { name: "Junior", email: "junior@example.org" }, ]); t.is(db.inTransaction, false); const stmt = db.prepare("SELECT * FROM users WHERE id = ?"); t.is(stmt.get(3).name, "Joey"); t.is(stmt.get(4).name, "Sally"); t.is(stmt.get(5).name, "Junior"); }); test.serial("Database.transaction().immediate()", async (t) => { const db = t.context.db; const insert = db.prepare( "INSERT INTO users(name, email) VALUES (:name, :email)" ); const insertMany = db.transaction((users) => { t.is(db.inTransaction, true); for (const user of users) insert.run(user); }); t.is(db.inTransaction, false); insertMany.immediate([ { name: "Joey", email: "joey@example.org" }, { name: "Sally", email: "sally@example.org" }, { name: "Junior", email: "junior@example.org" }, ]); t.is(db.inTransaction, false); }); // ========================================================================== // Statement.run() // ========================================================================== test.serial("Statement.run() returning rows", async (t) => { const db = t.context.db; const stmt = db.prepare("SELECT 1"); const info = stmt.run(); t.is(info.changes, 0); }); test.serial("Statement.run() [positional]", async (t) => { const db = t.context.db; const stmt = db.prepare("INSERT INTO users(name, email) VALUES (?, ?)"); const info = stmt.run(["Carol", "carol@example.net"]); t.is(info.changes, 1); t.is(info.lastInsertRowid, 3); }); test.serial("Statement.run() [named]", async (t) => { const db = t.context.db; const stmt = db.prepare("INSERT INTO users(name, email) VALUES (@name, @email);"); const info = stmt.run({"name": "Carol", "email": "carol@example.net"}); t.is(info.changes, 1); t.is(info.lastInsertRowid, 3); }); test.skip("Statement.run() with array bind parameter", async (t) => { const db = t.context.db; db.exec(` DROP TABLE IF EXISTS t; CREATE TABLE t (value BLOB); `); const array = [1, 2, 3]; const insertStmt = db.prepare("INSERT INTO t (value) VALUES (?)"); t.throws(() => { insertStmt.run([array]); }, { message: 'SQLite3 can only bind numbers, strings, bigints, buffers, and null' }); }); test.skip("Statement.run() with Float32Array bind parameter", async (t) => { const db = t.context.db; db.exec(` DROP TABLE IF EXISTS t; CREATE TABLE t (value BLOB); `); const array = new Float32Array([1, 2, 3]); const insertStmt = db.prepare("INSERT INTO t (value) VALUES (?)"); insertStmt.run([array]); const selectStmt = db.prepare("SELECT value FROM t"); t.deepEqual(selectStmt.raw().get()[0], Buffer.from(array.buffer)); }); test.skip("Statement.run() for vector feature with Float32Array bind parameter", async (t) => { if (t.context.provider === 'better-sqlite3') { // skip this test for better-sqlite3 t.assert(true); return; } const db = t.context.db; db.exec(` DROP TABLE IF EXISTS t; CREATE TABLE t (embedding FLOAT32(8)); CREATE INDEX t_idx ON t ( libsql_vector_idx(embedding) ); `); const insertStmt = db.prepare("INSERT INTO t VALUES (?)"); insertStmt.run([new Float32Array([1,1,1,1,1,1,1,1])]); insertStmt.run([new Float32Array([-1,-1,-1,-1,-1,-1,-1,-1])]); const selectStmt = db.prepare("SELECT embedding FROM vector_top_k('t_idx', vector('[2,2,2,2,2,2,2,2]'), 1) n JOIN t ON n.rowid = t.rowid"); t.deepEqual(selectStmt.raw().get()[0], Buffer.from(new Float32Array([1,1,1,1,1,1,1,1]).buffer)); // we need to explicitly delete this table because later when sqlite-based (not LibSQL) tests will delete table 't' they will leave 't_idx_shadow' table untouched db.exec(`DROP TABLE t`); }); // ========================================================================== // Statement.get() // ========================================================================== test.serial("Statement.get() [no parameters]", async (t) => { const db = t.context.db; var stmt = 0; stmt = db.prepare("SELECT * FROM users"); t.is(stmt.get().name, "Alice"); t.deepEqual(stmt.raw().get(), [1, 'Alice', 'alice@example.org']); }); test.serial("Statement.get() [positional]", async (t) => { const db = t.context.db; var stmt = 0; stmt = db.prepare("SELECT * FROM users WHERE id = ?"); t.is(stmt.get(0), undefined); t.is(stmt.get([0]), undefined); t.is(stmt.get(1).name, "Alice"); t.is(stmt.get(2).name, "Bob"); stmt = db.prepare("SELECT * FROM users WHERE id = ?1"); t.is(stmt.get({1: 0}), undefined); t.is(stmt.get({1: 1}).name, "Alice"); t.is(stmt.get({1: 2}).name, "Bob"); }); test.serial("Statement.get() [named]", async (t) => { const db = t.context.db; var stmt = undefined; stmt = db.prepare("SELECT :b, :a"); t.deepEqual(stmt.raw().get({ a: 'a', b: 'b' }), ['b', 'a']); stmt = db.prepare("SELECT * FROM users WHERE id = :id"); t.is(stmt.get({ id: 0 }), undefined); t.is(stmt.get({ id: 1 }).name, "Alice"); t.is(stmt.get({ id: 2 }).name, "Bob"); stmt = db.prepare("SELECT * FROM users WHERE id = @id"); t.is(stmt.get({ id: 0 }), undefined); t.is(stmt.get({ id: 1 }).name, "Alice"); t.is(stmt.get({ id: 2 }).name, "Bob"); stmt = db.prepare("SELECT * FROM users WHERE id = $id"); t.is(stmt.get({ id: 0 }), undefined); t.is(stmt.get({ id: 1 }).name, "Alice"); t.is(stmt.get({ id: 2 }).name, "Bob"); }); test.serial("Statement.get() [raw]", async (t) => { const db = t.context.db; const stmt = db.prepare("SELECT * FROM users WHERE id = ?"); t.deepEqual(stmt.raw().get(1), [1, "Alice", "alice@example.org"]); }); test.serial("Statement.get() values", async (t) => { const db = t.context.db; const stmt = db.prepare("SELECT ?").raw(); t.deepEqual(stmt.get(1), [1]); t.deepEqual(stmt.get(Number.MIN_VALUE), [Number.MIN_VALUE]); t.deepEqual(stmt.get(Number.MAX_VALUE), [Number.MAX_VALUE]); t.deepEqual(stmt.get(Number.MAX_SAFE_INTEGER), [Number.MAX_SAFE_INTEGER]); t.deepEqual(stmt.get(9007199254740991n), [9007199254740991]); }); test.serial("Statement.get() [blob]", (t) => { const db = t.context.db; // Create table with blob column db.exec("CREATE TABLE IF NOT EXISTS blobs (id INTEGER PRIMARY KEY, data BLOB)"); // Test inserting and retrieving blob data const binaryData = Buffer.from([0x48, 0x65, 0x6c, 0x6c, 0x6f, 0x20, 0x57, 0x6f, 0x72, 0x6c, 0x64]); // "Hello World" const insertStmt = db.prepare("INSERT INTO blobs (data) VALUES (?)"); insertStmt.run([binaryData]); // Retrieve the blob data const selectStmt = db.prepare("SELECT data FROM blobs WHERE id = 1"); const result = selectStmt.get(); t.truthy(result, "Should return a result"); t.true(Buffer.isBuffer(result.data), "Should return Buffer for blob data"); t.deepEqual(result.data, binaryData, "Blob data should match original"); }); // ========================================================================== // Statement.iterate() // ========================================================================== test.serial("Statement.iterate() [empty]", async (t) => { const db = t.context.db; const stmt = db.prepare("SELECT * FROM users WHERE id = 0"); t.is(stmt.iterate().next().done, true); t.is(stmt.iterate([]).next().done, true); t.is(stmt.iterate({}).next().done, true); }); test.serial("Statement.iterate()", async (t) => { const db = t.context.db; const stmt = db.prepare("SELECT * FROM users"); const expected = [1, 2]; var idx = 0; for (const row of stmt.iterate()) { t.is(row.id, expected[idx++]); } }); // ========================================================================== // Statement.all() // ========================================================================== test.serial("Statement.all()", async (t) => { const db = t.context.db; const stmt = db.prepare("SELECT * FROM users"); const expected = [ { id: 1, name: "Alice", email: "alice@example.org" }, { id: 2, name: "Bob", email: "bob@example.com" }, ]; t.deepEqual(stmt.all(), expected); }); test.serial("Statement.all() [raw]", async (t) => { const db = t.context.db; const stmt = db.prepare("SELECT * FROM users"); const expected = [ [1, "Alice", "alice@example.org"], [2, "Bob", "bob@example.com"], ]; t.deepEqual(stmt.raw().all(), expected); }); test.serial("Statement.all() [pluck]", async (t) => { const db = t.context.db; const stmt = db.prepare("SELECT * FROM users"); const expected = [ 1, 2, ]; t.deepEqual(stmt.pluck().all(), expected); }); test.serial("Statement.all() [default safe integers]", async (t) => { const db = t.context.db; db.defaultSafeIntegers(); const stmt = db.prepare("SELECT * FROM users"); const expected = [ [1n, "Alice", "alice@example.org"], [2n, "Bob", "bob@example.com"], ]; t.deepEqual(stmt.raw().all(), expected); }); test.serial("Statement.all() [statement safe integers]", async (t) => { const db = t.context.db; const stmt = db.prepare("SELECT * FROM users"); stmt.safeIntegers(); const expected = [ [1n, "Alice", "alice@example.org"], [2n, "Bob", "bob@example.com"], ]; t.deepEqual(stmt.raw().all(), expected); }); // ========================================================================== // Statement.raw() // ========================================================================== test.skip("Statement.raw() [failure]", async (t) => { const db = t.context.db; const stmt = db.prepare("INSERT INTO users (id, name, email) VALUES (?, ?, ?)"); t.throws(() => { stmt.raw() }, { message: 'The raw() method is only for statements that return data' }); }); // ========================================================================== // Statement.columns() // ========================================================================== test.serial("Statement.columns()", async (t) => { const db = t.context.db; var stmt = undefined; stmt = db.prepare("SELECT 1"); const columns1 = stmt.columns(); t.is(columns1.length, 1); t.is(columns1[0].name, '1'); // For "SELECT 1", type varies by provider, so just check it exists t.true('type' in columns1[0]); stmt = await db.prepare("SELECT * FROM users WHERE id = ?"); const columns2 = stmt.columns(); t.is(columns2.length, 3); // Check column names and types only t.is(columns2[0].name, "id"); t.is(columns2[0].type, "INTEGER"); t.is(columns2[1].name, "name"); t.is(columns2[1].type, "TEXT"); t.is(columns2[2].name, "email"); t.is(columns2[2].type, "TEXT"); }); test.skip("Timeout option", async (t) => { const timeout = 1000; const path = genDatabaseFilename(); const [conn1] = await connect(path); conn1.exec("CREATE TABLE t(x)"); conn1.exec("BEGIN IMMEDIATE"); conn1.exec("INSERT INTO t VALUES (1)") const options = { timeout }; const [conn2] = await connect(path, options); const start = Date.now(); try { conn2.exec("INSERT INTO t VALUES (1)") } catch (e) { t.is(e.code, "SQLITE_BUSY"); const end = Date.now(); const elapsed = end - start; // Allow some tolerance for the timeout. t.is(elapsed > timeout/2, true); } fs.unlinkSync(path); }); const connect = async (path, options = {}) => { if (!path) { path = genDatabaseFilename(); } const provider = process.env.PROVIDER; if (provider === "turso") { const { Database, SqliteError }= await import("@tursodatabase/database/compat"); const db = new Database(path, options); return [db, path, provider, SqliteError]; } if (provider === "libsql") { const x = await import("libsql"); const db = new x.default(path, options); return [db, path, provider, x.SqliteError]; } if (provider == "better-sqlite3") { const x = await import("better-sqlite3"); const db = x.default(path, options); return [db, path, provider, x.default.SqliteError]; } throw new Error("Unknown provider: " + provider); }; /// Generate a unique database filename const genDatabaseFilename = () => { return `test-${crypto.randomBytes(8).toString('hex')}.db`; };