Method open

src/db/index.ts:127–154

* Open an existing database

(dbPath: string)

   * Open an existing database
   */
  static open(dbPath: string): DatabaseConnection {
    if (!fs.existsSync(dbPath)) {
      throw new Error(`Database not found: ${dbPath}`);
    }

    const { db, backend } = createDatabase(dbPath);

    configureConnection(db);

    // Check and run migrations if needed
    const conn = new DatabaseConnection(db, dbPath, backend);
    const currentVersion = getCurrentVersion(db);

    if (currentVersion < CURRENT_SCHEMA_VERSION) {
      runMigrations(db, currentVersion);
    }

    // Self-heal a bulk-load window that never closed (crash between
    // beginBulkNodeLoad and endBulkNodeLoad): the FTS triggers are missing and
    // nodes_fts is stale. Rebuild + recreate so search stays in sync.
    conn.healBulkNodeLoad();

    // Self-heal a killed session's leftover oversized WAL (#1431) — one
    // statSync when healthy, off-thread checkpoint+truncate when not.
    void conn.healOversizedWal();

    return conn;
  }

  /**
   * FTS maintenance triggers dropped/recreated around a bulk load.