Skip to content

Commit 0230271

Browse files
committed
docs(driver-sql): say where the read-only judgement's refusal is thrown from on the probe, leaving SqliteDatabaseFileError's own doc as it stands
Claude-Session: https://claude.ai/code/session_01QK6pdbxKZiHdFApL8RYVh9 Co-authored-by: Claude <noreply@anthropic.com>
1 parent 28ea203 commit 0230271

1 file changed

Lines changed: 5 additions & 6 deletions

File tree

‎packages/drivers/driver-sql/src/sqlite-database-file.ts‎

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,8 @@ import { dirname, isAbsolute, resolve } from 'node:path';
1010
* Thrown by `SqlDriver.connect()`, so the boot's connect refusal (ADR-0062 D5,
1111
* `datasource '<name>': connect failed — <reason>`) carries the path and the
1212
* operating system's own answer instead of waiting for a plugin start timeout.
13-
* Under `sqliteAbsentFile: 'empty-in-memory'` it is thrown earlier, by
14-
* {@link probeAbsentSqliteDatabaseFile} — so by `resolveSqliteAbsentFileTarget`
15-
* and the `SqlDriver` constructor — for a file that can be neither opened nor
16-
* created (#24961). `code` is the underlying error's (`ENOENT`, `EACCES`,
17-
* `ENOTDIR`, `SQLITE_CANTOPEN`, …) and `cause` the error itself.
13+
* `code` is the underlying error's (`ENOENT`, `EACCES`, `ENOTDIR`,
14+
* `SQLITE_CANTOPEN`, …) and `cause` the error itself.
1815
*/
1916
export class SqliteDatabaseFileError extends Error {
2017
readonly code: string | undefined;
@@ -84,7 +81,9 @@ export async function makeDatabaseDirectory(dir: string): Promise<void> {
8481
* Does the SQLite database file `filename` exist, or is it absent in a way a
8582
* boot that may write could bring into existence? Answered WITHOUT writing
8683
* anything, and thrown as a {@link SqliteDatabaseFileError} when it is neither
87-
* (#24961).
84+
* (#24961) — so under `sqliteAbsentFile: 'empty-in-memory'` that error comes
85+
* from `resolveSqliteAbsentFileTarget`, and from the `SqlDriver` constructor,
86+
* before any `connect()`.
8887
*
8988
* The read-only twin of {@link makeDatabaseDirectory}, for
9089
* `sqliteAbsentFile: 'empty-in-memory'`, whose contract is that the filesystem

0 commit comments

Comments
 (0)