mirror of
https://github.com/aljazceru/turso.git
synced 2026-02-03 23:34:24 +01:00
02db72cc2c
This rewrites the JavaScript bindings completely by exposing only primitive operations from Rust NAPI-RS code. For example, there is prepare(), bind(), and step(), but high level interfaces like all() and get() are implemented in JavaScript. We're doing this so that we can implement async interfaces in the JavaScript layer instead of having to bring in Tokio.
@tursodatabase/turso
The next evolution of SQLite: A high-performance, SQLite-compatible database library for Node.js
Features
- SQLite Compatible: Drop-in replacement for better-sqlite3 with familiar API
- High Performance: Built with Rust for maximum speed and efficiency
- In-Process: No network overhead, runs directly in your Node.js process
- TypeScript Support: Full TypeScript definitions included
- Cross-Platform: Supports Linux, macOS, Windows and browsers (through WebAssembly)
- Transaction Support: Full ACID transactions with rollback support
- Prepared Statements: Optimized query execution with parameter binding
Installation
npm install @tursodatabase/turso
Quick Start
In-Memory Database
import Database from '@tursodatabase/turso';
// Create an in-memory database
const db = new Database(':memory:');
// Create a table
db.exec('CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT, email TEXT)');
// Insert data
const insert = db.prepare('INSERT INTO users (name, email) VALUES (?, ?)');
insert.run('Alice', 'alice@example.com');
insert.run('Bob', 'bob@example.com');
// Query data
const users = db.prepare('SELECT * FROM users').all();
console.log(users);
// Output: [
// { id: 1, name: 'Alice', email: 'alice@example.com' },
// { id: 2, name: 'Bob', email: 'bob@example.com' }
// ]
File-Based Database
import Database from '@tursodatabase/turso';
// Create or open a database file
const db = new Database('my-database.db');
// Create a table
db.exec(`
CREATE TABLE IF NOT EXISTS posts (
id INTEGER PRIMARY KEY AUTOINCREMENT,
title TEXT NOT NULL,
content TEXT,
created_at DATETIME DEFAULT CURRENT_TIMESTAMP
)
`);
// Insert a post
const insertPost = db.prepare('INSERT INTO posts (title, content) VALUES (?, ?)');
const result = insertPost.run('Hello World', 'This is my first blog post!');
console.log(`Inserted post with ID: ${result.lastInsertRowid}`);
API Reference
License
MIT