First() returns null instead of D1_NORESULTS

.changeset/five-lizards-try.md

@@ -0,0 +1,5 @@
+---
+"d1-orm": patch
+---
+
+Chore: Make first() return null on a D1_NORESULTS error, as it's inconsistent with local and remote, and that error is near meaningless.

src/model.ts

@@ -164,20 +164,27 @@ export class Model<T extends object> {
 
 	/**
 	 * @param options The options for the query, see {@link GenerateQueryOptions}
-	 * @returns Returns the first row that matches the where clause.
+	 * @returns Returns the first row that matches the where clause, or null if no rows match.
 	 */
 	public async First(
 		options: Pick<GenerateQueryOptions<T>, "where">
-	): Promise<T> {
+	): Promise<T | null> {
 		const statement = GenerateQuery(
 			QueryType.SELECT,
 			this.tableName,
 			Object.assign(options, { limit: 1 })
 		);
-		return this.#D1Orm
-			.prepare(statement.query)
-			.bind(...statement.bindings)
-			.first();
+		try {
+			return this.#D1Orm
+				.prepare(statement.query)
+				.bind(...statement.bindings)
+				.first();
+		} catch (e) {
+			if ((e as Error).message === "D1_NORESULTS") {
+				return null;
+			}
+			throw e;
+		}
 	}
 
 	/**