Provide a better-sqlite3 module backed by bun:sqlite

docs/runtime/sqlite.mdx

@@ -714,7 +714,7 @@ class Statement<ReturnType, ParamsType> {
 
   columnNames: string[]; // the column names of the result set
   columnTypes: string[]; // types based on actual values in first row (call .get()/.all() first)
-  declaredTypes: (string | null)[]; // types from CREATE TABLE schema (call .get()/.all() first)
+  declaredTypes: (string | null)[]; // types from CREATE TABLE schema
   paramsCount: number; // the number of parameters expected by the statement
   native: any; // the native object representing the statement
 

packages/bun-types/sqlite.d.ts

@@ -829,25 +829,22 @@ declare module "bun:sqlite" {
      * - The exact type string declared in the `CREATE TABLE` statement
      * - `null` for columns without declared types, such as expressions and computed columns
      *
-     * The statement must be executed at least once before accessing this
-     * property. Available for both read-only and read-write statements.
+     * Available immediately after `prepare()`; the statement does not need to
+     * be executed first. Available for both read-only and read-write statements.
      *
      * @example
      * ```ts
      * // For table columns:
      * const stmt = db.prepare("SELECT id, name, weight FROM products");
-     * stmt.get();
      * console.log(stmt.declaredTypes);
      * // => ["INTEGER", "TEXT", "REAL"]
      *
      * // For expressions (no declared types):
      * const exprStmt = db.prepare("SELECT length('bun') AS str_length");
-     * exprStmt.get();
      * console.log(exprStmt.declaredTypes);
      * // => [null]
      * ```
      *
-     * @throws Error if statement hasn't been executed
      * @since Bun v1.2.13
      */
     readonly declaredTypes: Array<string | null>;

scripts/handle-crash-patterns.ts

@@ -35,7 +35,7 @@ else if (
   closeAction = {
     reason: "not_planned",
     comment: `Duplicate of #4290.
-better-sqlite3 is not supported yet in Bun due to missing V8 C++ APIs. For now, you can try [bun:sqlite](https://bun.com/docs/api/sqlite) for an almost drop-in replacement.`,
+Bun cannot load the better-sqlite3 native addon because it uses V8 C++ APIs that Bun does not implement. In current Bun releases \`require("better-sqlite3")\` resolves to a built-in module backed by [bun:sqlite](https://bun.com/docs/api/sqlite); please upgrade Bun and use \`require("better-sqlite3")\` directly instead of loading the \`.node\` file.`,
   };
 }
 

src/codegen/internal-module-registry-scanner.ts

@@ -15,7 +15,7 @@ export function createInternalModuleRegistry(basedir: string) {
   for (let i = 0; i < moduleList.length; i++) {
     const prefix = moduleList[i].startsWith("node/")
       ? "node:"
-      : moduleList[i].startsWith("bun:")
+      : moduleList[i].startsWith("bun/")
         ? "bun:"
         : moduleList[i].startsWith("internal/")
           ? "internal/"
@@ -64,7 +64,7 @@ export function createInternalModuleRegistry(basedir: string) {
 
   const requireTransformer = (specifier: string, from: string) => {
     const directMatch = internalRegistry.get(specifier);
-    if (directMatch) return codegenRequireId(`${directMatch}/*${specifier}*/`);
+    if (directMatch !== undefined) return codegenRequireId(`${directMatch}/*${specifier}*/`);
 
     const relativeMatch =
       resolveSyncOrNull(specifier, path.join(basedir, path.dirname(from))) ?? resolveSyncOrNull(specifier, basedir);

src/install/default-trusted-dependencies.txt

@@ -114,7 +114,6 @@ azure-functions-core-tools
 azure-streamanalytics-cicd
 backport
 bcrypt
-better-sqlite3
 bigint-buffer
 blake-hash
 bs-platform

src/js/bun/sqlite.ts

@@ -110,6 +110,7 @@ interface CppSQLStatement {
   paramsCount: number;
   columnTypes: string[];
   declaredTypes: (string | null)[];
+  readonly: boolean;
   safeIntegers: boolean;
 }
 
@@ -614,7 +615,7 @@ class Database implements SqliteTypes.Database {
       exclusive: {
         value: wrapTransaction(fn, db, controller.exclusive),
       },
-      database: { value: this, enumerable: true },
+      database: { value: self ?? this, enumerable: true },
     };
 
     defineProperties(properties.default.value, properties);