From 25c5cd6d831cf448dc9393e079aac67f8e007b1e Mon Sep 17 00:00:00 2001
From: Rob Hogan <robhogan@meta.com>
Date: Fri, 23 Jan 2026 03:14:00 -0800
Subject: [PATCH] Add Flow lib defs for node:sqlite

Summary:
This diff adds Flow type definitions for the `node:sqlite` module, Node.js's built-in SQLite database interface added experimentally in v22.5.0.

**Module Overview:**

The `node:sqlite` module provides synchronous SQLite database operations, enabling embedded database functionality without external dependencies.

**Core Classes:**

1. **DatabaseSync** - Main database interface
   - `constructor(location: string, options?: DatabaseSyncOptions)`
   - `exec(sql: string)` - Execute SQL without returning results
   - `prepare(sql: string)` - Create prepared statement
   - `close()` / `open()` - Manage connection lifecycle
   - `function()` - Register custom SQL functions
   - `createSession()` / `applyChangeset()` - Session/changeset support
   - https://nodejs.org/api/sqlite.html#class-databasesync

2. **StatementSync** - Prepared statement interface
   - `all(...params)` - Return all rows as array
   - `get(...params)` - Return first row
   - `run(...params)` - Execute and return changes/lastInsertRowid
   - `iterate(...params)` - Return iterator over rows
   - `expandedSQL` / `sourceSQL` - SQL inspection
   - https://nodejs.org/api/sqlite.html#class-statementsync

3. **Session** - Change tracking interface
   - `changeset()` - Get changes as Uint8Array
   - `patchset()` - Get minimal changes
   - `close()` - End session

**References:**
- Node.js sqlite module documentation: https://nodejs.org/api/sqlite.html

**Stability:** Experimental (added in v22.5.0)

Changelog: [Internal]

Reviewed By: GijsWeterings

Differential Revision: D90764441
---
 flow-typed/environment/node.js | 125 ++++++++++++++++++++++++++++++++-
 1 file changed, 122 insertions(+), 3 deletions(-)

diff --git a/flow-typed/environment/node.js b/flow-typed/environment/node.js
index 62f89f8abec4..e8daca3a50c8 100644
--- a/flow-typed/environment/node.js
+++ b/flow-typed/environment/node.js
@@ -3348,6 +3348,125 @@ declare module 'querystring' {
   declare function unescape(str: string, decodeSpaces?: boolean): string;
 }
 
+/**
+ * Node.js sqlite module (only available with node: prefix)
+ * @since v22.5.0
+ */
+declare module 'node:sqlite' {
+  declare export type SupportedValueType =
+    | null
+    | number
+    | bigint
+    | string
+    | Uint8Array;
+
+  declare export type DatabaseSyncOptions = Readonly<{
+    open?: boolean,
+    enableForeignKeyConstraints?: boolean,
+    enableDoubleQuotedStringLiterals?: boolean,
+    readOnly?: boolean,
+    allowExtension?: boolean,
+  }>;
+
+  declare export type CreateSessionOptions = Readonly<{
+    table?: string,
+    db?: string,
+  }>;
+
+  declare export type ApplyChangesetOptions = Readonly<{
+    filter?: (tableName: string) => boolean,
+    onConflict?: number,
+  }>;
+
+  declare export type FunctionOptions = Readonly<{
+    deterministic?: boolean,
+    directOnly?: boolean,
+    useBigIntArguments?: boolean,
+    varargs?: boolean,
+  }>;
+
+  declare export type StatementResultingChanges = {
+    changes: number | bigint,
+    lastInsertRowid: number | bigint,
+  };
+
+  declare export interface Session {
+    changeset(): Uint8Array;
+    patchset(): Uint8Array;
+    close(): void;
+  }
+
+  declare export class StatementSync {
+    all(...anonymousParameters: ReadonlyArray<SupportedValueType>): Array<any>;
+    all(
+      namedParameters: {[key: string]: SupportedValueType, ...},
+      ...anonymousParameters: ReadonlyArray<SupportedValueType>
+    ): Array<any>;
+
+    +expandedSQL: string;
+
+    get(...anonymousParameters: ReadonlyArray<SupportedValueType>): any;
+    get(
+      namedParameters: {[key: string]: SupportedValueType, ...},
+      ...anonymousParameters: ReadonlyArray<SupportedValueType>
+    ): any;
+
+    iterate(
+      ...anonymousParameters: ReadonlyArray<SupportedValueType>
+    ): Iterator<any>;
+    iterate(
+      namedParameters: {[key: string]: SupportedValueType, ...},
+      ...anonymousParameters: ReadonlyArray<SupportedValueType>
+    ): Iterator<any>;
+
+    run(
+      ...anonymousParameters: ReadonlyArray<SupportedValueType>
+    ): StatementResultingChanges;
+    run(
+      namedParameters: {[key: string]: SupportedValueType, ...},
+      ...anonymousParameters: ReadonlyArray<SupportedValueType>
+    ): StatementResultingChanges;
+
+    setAllowBareNamedParameters(enabled: boolean): void;
+    setReadBigInts(enabled: boolean): void;
+
+    +sourceSQL: string;
+  }
+
+  declare export class DatabaseSync {
+    constructor(location: string, options?: DatabaseSyncOptions): void;
+
+    close(): void;
+    loadExtension(path: string): void;
+    enableLoadExtension(allow: boolean): void;
+    exec(sql: string): void;
+
+    function(
+      name: string,
+      options: FunctionOptions,
+      func: (...args: ReadonlyArray<SupportedValueType>) => SupportedValueType,
+    ): void;
+    function(
+      name: string,
+      func: (...args: ReadonlyArray<SupportedValueType>) => SupportedValueType,
+    ): void;
+
+    open(): void;
+    prepare(sql: string): StatementSync;
+    createSession(options?: CreateSessionOptions): Session;
+    applyChangeset(
+      changeset: Uint8Array,
+      options?: ApplyChangesetOptions,
+    ): boolean;
+  }
+
+  declare export var constants: {|
+    +SQLITE_CHANGESET_OMIT: number,
+    +SQLITE_CHANGESET_REPLACE: number,
+    +SQLITE_CHANGESET_ABORT: number,
+  |};
+}
+
 type readline$InterfaceCompleter = (
   line: string,
 ) =>
@@ -5042,16 +5161,16 @@ declare module 'v8' {
     version: number,
     startTime: number,
     endTime: number,
-    statistics: $ReadOnlyArray<{
+    statistics: ReadonlyArray<{
       gcType: string,
       cost: number,
       beforeGC: {
         heapStatistics: HeapStatistics,
-        heapSpaceStatistics: $ReadOnlyArray<HeapSpaceStatistics>,
+        heapSpaceStatistics: ReadonlyArray<HeapSpaceStatistics>,
       },
       afterGC: {
         heapStatistics: HeapStatistics,
-        heapSpaceStatistics: $ReadOnlyArray<HeapSpaceStatistics>,
+        heapSpaceStatistics: ReadonlyArray<HeapSpaceStatistics>,
       },
     }>,
   };