1.1.0

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@endeavorance/prequel",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "exports": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "scripts": {

src/prequel.ts

@@ -105,6 +105,8 @@ export class Prequel {
 	public db: Database;
 	public kv: PrequelKVStore;
 	public tables: Record<string, Table<unknown>> = {};
+	public query: typeof Database.prototype.query;
+	public uncachedQuery: typeof Database.prototype.prepare;
 
 	/**
 	 * Creates a new Prequel database instance.
@@ -112,6 +114,8 @@ export class Prequel {
 	 */
 	constructor(filename = ":memory:") {
 		this.db = new Database(filename);
+		this.query = this.db.query.bind(this.db);
+		this.uncachedQuery = this.db.prepare.bind(this.db);
 		this.db.exec("PRAGMA foreign_keys=ON");
 		this.kv = new PrequelKVStore(this, "PrequelManagedKVStore");
 	}

src/table.ts

@@ -27,12 +27,10 @@ export class PrequelEmptyResultsError extends Error {
 }
 
 /** An arbitrarily shaped Row */
-interface ArbitraryRow {
-	[key: string]: ColumnValue;
-}
+type ArbitraryRow = Record<string, ColumnValue>;
 
-function shapeForQuery<T>(obj: Partial<T>): Record<string, ColumnValue> {
-	const asInsertDataShape: Record<string, ColumnValue> = {};
+function shapeForQuery<T>(obj: Partial<T>): ArbitraryRow {
+	const asInsertDataShape: ArbitraryRow = {};
 
 	const keys = Object.keys(obj);
 
@@ -72,6 +70,8 @@ export class Table<RowShape> {
 	private _sizeQuery: Statement<{ count: number }, []>;
 	private _truncateQuery: Statement<void, []>;
 
+	public query: typeof Database.prototype.query;
+
 	constructor(
 		db: Database | Prequel,
 		name: string,
@@ -85,6 +85,7 @@ export class Table<RowShape> {
 		this._name = name;
 		this._columnDefinitions = normalizeColumns(cols);
 		this._columnNames = Object.keys(this._columnDefinitions);
+		this.query = this._db.query.bind(this._db);
 
 		const columnSQLParts: string[] = [];
 		const updateColumnSQLParts: string[] = [];
@@ -211,6 +212,12 @@ export class Table<RowShape> {
 		return query.get(asInsertDataShape) as RowShape;
 	}
 
+	public insertWithout<OmitKeys extends keyof RowShape>(
+		rowWithKeysOmitted: Omit<RowShape, OmitKeys>,
+	): RowShape {
+		return this.insertPartial(rowWithKeysOmitted as Partial<RowShape>);
+	}
+
 	/**
 	 * Updates a row in the table with the provided data.
 	 *

test/prequel.test.ts

@@ -135,3 +135,11 @@ test("kv store can set and retrieve arbitrary values", () => {
 	expect(pq.kv.get<{ enabled: boolean }>("config")).toEqual({ enabled: true });
 	expect(pq.kv.get<string[]>("list")).toEqual(["a", "b", "c"]);
 });
+
+test(".query() creates a cached statement", () => {
+	const pq = new Prequel();
+	const query = pq.query("SELECT 1");
+
+	expect(query).toBeDefined();
+	expect(query).toBe(pq.query("SELECT 1"));
+});

test/table.test.ts

@@ -138,6 +138,22 @@ test(".insertPartial() inserts a partial row", () => {
 	});
 });
 
+test(".insertWithout() inserts a partial row with type safety", () => {
+	const table = makeTestTable();
+	table.insertWithout<"user_id">({
+		name: "Jack",
+	});
+
+	const lookup = table.db.prepare<UserWithID, string>(
+		`SELECT * FROM ${table} WHERE name = ?`,
+	);
+	const found = lookup.get("Jack");
+	expect(found).toEqual({
+		user_id: 1,
+		name: "Jack",
+	});
+});
+
 test(".count() gets the current number of rows in the table", () => {
 	const table = makeTestTable();
 	table.insertPartial({ name: "Jack" });
@@ -167,6 +183,12 @@ test(".findAll() returns the full table", () => {
 	expect(allUsers[2]).toEqual({ user_id: 3, name: "Sayid" });
 });
 
+test(".query() returns a prepared statement for the table", () => {
+	const table = makeTestTable();
+	const query = table.query("SELECT * FROM Users WHERE name = ?");
+	expect(query).toBeDefined();
+});
+
 test(".findOneWhere() returns a row based on basic criteria", () => {
 	const table = makeTestTable();
 	table.insertPartial({ name: "Jack" });

test/wrapped-row.ts

@@ -7,10 +7,6 @@ interface User {
 	name: string;
 }
 
-interface SerializedUser {
-	name: string;
-}
-
 const db = new Database();
 const table = new Table<User>(db, "Users", {
 	id: {