doc: document close() error when in a sqlite callback

trivikr · trivikr · commit 45b067e6e2cb · 2026-08-06T17:43:25.000Z
Signed-off-by: Trivikram Kamat &lt;16024985+trivikr@users.noreply.github.com&gt;
diff --git a/doc/api/sqlite.md b/doc/api/sqlite.md
@@ -295,7 +295,10 @@ added: v22.5.0
 -->
 
 Closes the database connection. An exception is thrown if the database is not
-open. This method is a wrapper around [`sqlite3_close_v2()`][].
+open. An [`ERR_INVALID_STATE`][] error is thrown if the method is called while a
+statement is executing, for example from a user-defined function, an aggregate
+function, or an authorizer callback. This method is a wrapper around
+[`sqlite3_close_v2()`][].
 
 ### `database.loadExtension(path[, entryPoint])`
 
