Function createDatabase

src/db/sqlite-adapter.ts:199–214

(dbPath: string, opts?: { readOnly?: boolean })

 * a process-global would race.
 */
export function createDatabase(dbPath: string, opts?: { readOnly?: boolean }): { db: SqliteDatabase; backend: SqliteBackend } {
  try {
    return { db: new NodeSqliteAdapter(dbPath, opts), backend: 'node-sqlite' };
  } catch (error) {
    // node:sqlite loaded and SQLite itself failed — not a missing-module case.
    const shared = toWslSharedIndexError(error, dbPath);
    if (shared) throw shared;
    const msg = error instanceof Error ? error.message : String(error);
    throw new Error(
      'Failed to open SQLite via the built-in node:sqlite module.\n' +
      'CodeGraph requires node:sqlite (Node.js 22.5+). Install the self-contained\n' +
      'CodeGraph release (it bundles a compatible Node), or run on Node 22.5+.\n' +
      `Underlying error: ${msg}`
    );
  }
}