expo-sqlite 12.1.0 → 12.2.0

package/build/next/NativeStatement.js.map

@@ -1 +1 @@
-{"version":3,"file":"NativeStatement.js","sourceRoot":"","sources":["../../src/next/NativeStatement.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Result of a `runAsync` call.\n */\nexport interface RunResult {\n  /**\n   * The last inserted row ID.\n   */\n  lastInsertRowid: number;\n\n  /**\n   * The number of rows affected.\n   */\n  changes: number;\n}\n\n/**\n * Bind parameters to the prepared statement.\n * You can either pass the parameters in the following forms:\n *\n * @example\n * - Variadic arguments for unnamed parameters.\n * ```ts\n * const statement = await db.prepareAsync('SELECT * FROM test WHERE value = ? AND intValue = ?');\n * await statement.getAsync('test1', 789);\n * ```\n *\n * @example\n * - A single array for unnamed parameters.\n * ```ts\n * const statement = await db.prepareAsync('SELECT * FROM test WHERE value = ? AND intValue = ?');\n * await statement.getAsync(['test1', 789]);\n * ```\n *\n * @example\n * - A single object for [named parameters](https://www.sqlite.org/lang_expr.html)\n *\n *   Through we support multiple named parameter forms like `:VVV`, `@VVV`, and `$VVV`. We recommend using `$VVV` because JavaScript allows using `$` in identifiers without escaping.\n * ```ts\n * const statement = await db.prepareAsync('SELECT * FROM test WHERE value = $value AND intValue = $intValue');\n * await statement.getAsync({ $value: 'test1', $intValue: 789 });\n * ```\n */\nexport type BindValue = string | number | null | boolean;\nexport type BindParams = Record<string, BindValue> | BindValue[];\nexport type VariadicBindParams = BindValue[];\n\nexport type ColumnNames = string[];\nexport type ColumnValues = any[];\ntype AnyDatabase = any;\n\n/**\n * A class that represents an instance of the SQLite statement.\n */\nexport declare class NativeStatement {\n  //#region Asynchronous API\n\n  public arrayRunAsync(database: AnyDatabase, params: BindParams): Promise<RunResult>;\n  public objectRunAsync(database: AnyDatabase, params: BindParams): Promise<RunResult>;\n\n  public arrayGetAsync(\n    database: AnyDatabase,\n    params: BindParams\n  ): Promise<ColumnValues | null | undefined>;\n  public objectGetAsync(\n    database: AnyDatabase,\n    params: BindParams\n  ): Promise<ColumnValues | null | undefined>;\n\n  public arrayGetAllAsync(database: AnyDatabase, params: BindParams): Promise<ColumnValues[]>;\n  public objectGetAllAsync(database: AnyDatabase, params: BindParams): Promise<ColumnValues[]>;\n\n  public getColumnNamesAsync(): Promise<ColumnNames>;\n\n  public resetAsync(database: AnyDatabase): Promise<void>;\n  public finalizeAsync(database: AnyDatabase): Promise<void>;\n\n  //#endregion\n\n  //#region Synchronous API\n\n  public arrayRunSync(database: AnyDatabase, params: BindParams): RunResult;\n  public objectRunSync(database: AnyDatabase, params: BindParams): RunResult;\n\n  public arrayGetSync(database: AnyDatabase, params: BindParams): ColumnValues | null | undefined;\n  public objectGetSync(database: AnyDatabase, params: BindParams): ColumnValues | null | undefined;\n\n  public arrayGetAllSync(database: AnyDatabase, params: BindParams): ColumnValues[];\n  public objectGetAllSync(database: AnyDatabase, params: BindParams): ColumnValues[];\n\n  public getColumnNamesSync(): string[];\n\n  public resetSync(database: AnyDatabase): void;\n  public finalizeSync(database: AnyDatabase): void;\n\n  //#endregion\n}\n"]}
+{"version":3,"file":"NativeStatement.js","sourceRoot":"","sources":["../../src/next/NativeStatement.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Result of a `runAsync` call.\n */\nexport interface RunResult {\n  /**\n   * The last inserted row ID.\n   */\n  lastInsertRowid: number;\n\n  /**\n   * The number of rows affected.\n   */\n  changes: number;\n}\n\n/**\n * Bind parameters to the prepared statement.\n * You can either pass the parameters in the following forms:\n *\n * @example\n * - A single array for unnamed parameters.\n * ```ts\n * const statement = await db.prepareAsync('SELECT * FROM test WHERE value = ? AND intValue = ?');\n * await statement.getAsync(['test1', 789]);\n * ```\n *\n * @example\n * - Variadic arguments for unnamed parameters.\n * ```ts\n * const statement = await db.prepareAsync('SELECT * FROM test WHERE value = ? AND intValue = ?');\n * await statement.getAsync('test1', 789);\n * ```\n *\n * @example\n * - A single object for [named parameters](https://www.sqlite.org/lang_expr.html)\n *\n * We support multiple named parameter forms such as `:VVV`, `@VVV`, and `$VVV`. We recommend using `$VVV` because JavaScript allows using `$` in identifiers without escaping.\n * ```ts\n * const statement = await db.prepareAsync('SELECT * FROM test WHERE value = $value AND intValue = $intValue');\n * await statement.getAsync({ $value: 'test1', $intValue: 789 });\n * ```\n */\nexport type BindValue = string | number | null | boolean;\nexport type BindParams = Record<string, BindValue> | BindValue[];\nexport type VariadicBindParams = BindValue[];\n\nexport type ColumnNames = string[];\nexport type ColumnValues = any[];\ntype AnyDatabase = any;\n\n/**\n * A class that represents an instance of the SQLite statement.\n */\nexport declare class NativeStatement {\n  //#region Asynchronous API\n\n  public arrayRunAsync(database: AnyDatabase, params: BindParams): Promise<RunResult>;\n  public objectRunAsync(database: AnyDatabase, params: BindParams): Promise<RunResult>;\n\n  public arrayGetAsync(\n    database: AnyDatabase,\n    params: BindParams\n  ): Promise<ColumnValues | null | undefined>;\n  public objectGetAsync(\n    database: AnyDatabase,\n    params: BindParams\n  ): Promise<ColumnValues | null | undefined>;\n\n  public arrayGetAllAsync(database: AnyDatabase, params: BindParams): Promise<ColumnValues[]>;\n  public objectGetAllAsync(database: AnyDatabase, params: BindParams): Promise<ColumnValues[]>;\n\n  public getColumnNamesAsync(): Promise<ColumnNames>;\n\n  public resetAsync(database: AnyDatabase): Promise<void>;\n  public finalizeAsync(database: AnyDatabase): Promise<void>;\n\n  //#endregion\n\n  //#region Synchronous API\n\n  public arrayRunSync(database: AnyDatabase, params: BindParams): RunResult;\n  public objectRunSync(database: AnyDatabase, params: BindParams): RunResult;\n\n  public arrayGetSync(database: AnyDatabase, params: BindParams): ColumnValues | null | undefined;\n  public objectGetSync(database: AnyDatabase, params: BindParams): ColumnValues | null | undefined;\n\n  public arrayGetAllSync(database: AnyDatabase, params: BindParams): ColumnValues[];\n  public objectGetAllSync(database: AnyDatabase, params: BindParams): ColumnValues[];\n\n  public getColumnNamesSync(): string[];\n\n  public resetSync(database: AnyDatabase): void;\n  public finalizeSync(database: AnyDatabase): void;\n\n  //#endregion\n}\n"]}

package/build/next/Statement.d.ts

@@ -2,7 +2,7 @@ import { NativeDatabase } from './NativeDatabase';
 import { BindParams, BindValue, NativeStatement, RunResult, VariadicBindParams, type ColumnNames, type ColumnValues } from './NativeStatement';
 export { BindParams, BindValue, RunResult, VariadicBindParams };
 /**
- * A prepared statement returned by `Database.prepareAsync()` that can be binded with parameters and executed.
+ * A prepared statement returned by [`Database.prepareAsync()`](#prepareasyncsource) or [`Database.prepareSync()`](#preparesyncsource) that can be binded with parameters and executed.
  */
 export declare class Statement {
     private readonly nativeDatabase;
@@ -10,40 +10,48 @@ export declare class Statement {
     constructor(nativeDatabase: NativeDatabase, nativeStatement: NativeStatement);
     /**
      * Run the prepared statement and return the result.
-     *
-     * @param params @see `BindParams`
+     * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.
      */
-    runAsync(...params: VariadicBindParams): Promise<RunResult>;
     runAsync(params: BindParams): Promise<RunResult>;
+    /**
+     * @hidden
+     */
+    runAsync(...params: VariadicBindParams): Promise<RunResult>;
     /**
      * Iterate the prepared statement and return results as an async iterable.
-     *
-     * @param params @see `BindParams`
-     *
+     * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.
      * @example
      * ```ts
      * const statement = await db.prepareAsync('SELECT * FROM test');
      * for await (const row of statement.eachAsync<any>()) {
      *   console.log(row);
      * }
+     * await statement.finalizeAsync();
      * ```
      */
-    eachAsync<T>(...params: VariadicBindParams): AsyncIterableIterator<T>;
     eachAsync<T>(params: BindParams): AsyncIterableIterator<T>;
+    /**
+     * @hidden
+     */
+    eachAsync<T>(...params: VariadicBindParams): AsyncIterableIterator<T>;
     /**
      * Get one row from the prepared statement.
-     *
-     * @param params @see `BindParams`
+     * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.
      */
-    getAsync<T>(...params: VariadicBindParams): Promise<T | null>;
     getAsync<T>(params: BindParams): Promise<T | null>;
+    /**
+     * @hidden
+     */
+    getAsync<T>(...params: VariadicBindParams): Promise<T | null>;
     /**
      * Get all rows from the prepared statement.
-     *
-     * @param params @see `BindParams`
+     * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.
      */
-    allAsync<T>(...params: VariadicBindParams): Promise<T[]>;
     allAsync<T>(params: BindParams): Promise<T[]>;
+    /**
+     * @hidden
+     */
+    allAsync<T>(...params: VariadicBindParams): Promise<T[]>;
     /**
      * Get the column names of the prepared statement.
      */
@@ -59,48 +67,44 @@ export declare class Statement {
     finalizeAsync(): Promise<void>;
     /**
      * Run the prepared statement and return the result.
-     *
-     * > **Note:** Running heavy tasks with this function can block the JavaScript thread, affecting performance.
-     *
-     * @param params @see `BindParams`
+     * > **Note:** Running heavy tasks with this function can block the JavaScript thread and affect performance.
+     * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.
      */
-    runSync(...params: VariadicBindParams): RunResult;
     runSync(params: BindParams): RunResult;
+    /**
+     * @hidden
+     */
+    runSync(...params: VariadicBindParams): RunResult;
     /**
      * Iterate the prepared statement and return results as an iterable.
-     *
-     * > **Note:** Running heavy tasks with this function can block the JavaScript thread, affecting performance.
-     *
-     * @param params @see `BindParams`
-     *
-     * @example
-     * ```ts
-     * const statement = await db.prepareSync('SELECT * FROM test');
-     * for (const row of statement.eachSync<any>()) {
-     *   console.log(row);
-     * }
-     * ```
+     * > **Note:** Running heavy tasks with this function can block the JavaScript thread and affect performance.
+     * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.
      */
-    eachSync<T>(...params: VariadicBindParams): IterableIterator<T>;
     eachSync<T>(params: BindParams): IterableIterator<T>;
+    /**
+     * @hidden
+     */
+    eachSync<T>(...params: VariadicBindParams): IterableIterator<T>;
     /**
      * Get one row from the prepared statement.
-     *
-     * > **Note:** Running heavy tasks with this function can block the JavaScript thread, affecting performance.
-     *
-     * @param params @see `BindParams`
+     * > **Note:** Running heavy tasks with this function can block the JavaScript thread and affect performance.
+     * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.
      */
-    getSync<T>(...params: VariadicBindParams): T | null;
     getSync<T>(params: BindParams): T | null;
+    /**
+     * @hidden
+     */
+    getSync<T>(...params: VariadicBindParams): T | null;
     /**
      * Get all rows from the prepared statement.
-     *
-     * > **Note:** Running heavy tasks with this function can block the JavaScript thread, affecting performance.
-     *
-     * @param params @see `BindParams`
+     * > **Note:** Running heavy tasks with this function can block the JavaScript thread and affect performance.
+     * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.
      */
-    allSync<T>(...params: VariadicBindParams): T[];
     allSync<T>(params: BindParams): T[];
+    /**
+     * @hidden
+     */
+    allSync<T>(...params: VariadicBindParams): T[];
     /**
      * Get the column names of the prepared statement.
      */

package/build/next/Statement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Statement.d.ts","sourceRoot":"","sources":["../../src/next/Statement.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Statement.d.ts","sourceRoot":"","sources":["../../src/next/Statement.ts"],"names":[],"mappings":"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"}

package/build/next/Statement.js

@@ -1,5 +1,5 @@
 /**
- * A prepared statement returned by `Database.prepareAsync()` that can be binded with parameters and executed.
+ * A prepared statement returned by [`Database.prepareAsync()`](#prepareasyncsource) or [`Database.prepareSync()`](#preparesyncsource) that can be binded with parameters and executed.
  */
 export class Statement {
     nativeDatabase;

package/build/next/Statement.js.map

@@ -1 +1 @@
-{"version":3,"file":"Statement.js","sourceRoot":"","sources":["../../src/next/Statement.ts"],"names":[],"mappings":"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","sourcesContent":["import { NativeDatabase } from './NativeDatabase';\nimport {\n  BindParams,\n  BindValue,\n  NativeStatement,\n  RunResult,\n  VariadicBindParams,\n  type ColumnNames,\n  type ColumnValues,\n} from './NativeStatement';\n\nexport { BindParams, BindValue, RunResult, VariadicBindParams };\n\n/**\n * A prepared statement returned by `Database.prepareAsync()` that can be binded with parameters and executed.\n */\nexport class Statement {\n  constructor(\n    private readonly nativeDatabase: NativeDatabase,\n    private readonly nativeStatement: NativeStatement\n  ) {}\n\n  //#region Asynchronous API\n\n  /**\n   * Run the prepared statement and return the result.\n   *\n   * @param params @see `BindParams`\n   */\n  public runAsync(...params: VariadicBindParams): Promise<RunResult>;\n  public runAsync(params: BindParams): Promise<RunResult>;\n  public async runAsync(...params: unknown[]): Promise<RunResult> {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    if (shouldPassAsObject) {\n      return await this.nativeStatement.objectRunAsync(this.nativeDatabase, bindParams);\n    } else {\n      return await this.nativeStatement.arrayRunAsync(this.nativeDatabase, bindParams);\n    }\n  }\n\n  /**\n   * Iterate the prepared statement and return results as an async iterable.\n   *\n   * @param params @see `BindParams`\n   *\n   * @example\n   * ```ts\n   * const statement = await db.prepareAsync('SELECT * FROM test');\n   * for await (const row of statement.eachAsync<any>()) {\n   *   console.log(row);\n   * }\n   * ```\n   */\n  public eachAsync<T>(...params: VariadicBindParams): AsyncIterableIterator<T>;\n  public eachAsync<T>(params: BindParams): AsyncIterableIterator<T>;\n  public async *eachAsync<T>(...params: unknown[]): AsyncIterableIterator<T> {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    const func = shouldPassAsObject\n      ? this.nativeStatement.objectGetAsync.bind(this.nativeStatement)\n      : this.nativeStatement.arrayGetAsync.bind(this.nativeStatement);\n\n    const columnNames = await this.getColumnNamesAsync();\n    let result = null;\n    do {\n      result = await func(this.nativeDatabase, bindParams);\n      if (result != null) {\n        yield composeRow<T>(columnNames, result);\n      }\n    } while (result != null);\n  }\n\n  /**\n   * Get one row from the prepared statement.\n   *\n   * @param params @see `BindParams`\n   */\n  public getAsync<T>(...params: VariadicBindParams): Promise<T | null>;\n  public getAsync<T>(params: BindParams): Promise<T | null>;\n  public async getAsync<T>(...params: unknown[]): Promise<T | null> {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    const columnNames = await this.getColumnNamesAsync();\n    const columnValues = shouldPassAsObject\n      ? await this.nativeStatement.objectGetAsync(this.nativeDatabase, bindParams)\n      : await this.nativeStatement.arrayGetAsync(this.nativeDatabase, bindParams);\n    return columnValues != null ? composeRow<T>(columnNames, columnValues) : null;\n  }\n\n  /**\n   * Get all rows from the prepared statement.\n   *\n   * @param params @see `BindParams`\n   */\n  public allAsync<T>(...params: VariadicBindParams): Promise<T[]>;\n  public allAsync<T>(params: BindParams): Promise<T[]>;\n  public async allAsync<T>(...params: unknown[]): Promise<T[]> {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    const columnNames = await this.getColumnNamesAsync();\n    const columnValuesList = shouldPassAsObject\n      ? await this.nativeStatement.objectGetAllAsync(this.nativeDatabase, bindParams)\n      : await this.nativeStatement.arrayGetAllAsync(this.nativeDatabase, bindParams);\n    return composeRows<T>(columnNames, columnValuesList);\n  }\n\n  /**\n   * Get the column names of the prepared statement.\n   */\n  public getColumnNamesAsync(): Promise<string[]> {\n    return this.nativeStatement.getColumnNamesAsync();\n  }\n\n  /**\n   * Reset the prepared statement cursor.\n   */\n  public async resetAsync(): Promise<void> {\n    await this.nativeStatement.resetAsync(this.nativeDatabase);\n  }\n\n  /**\n   * Finalize the prepared statement.\n   * > **Note:** Remember to finalize the prepared statement whenever you call `prepareAsync()` to avoid resource leaks.\n   */\n  public async finalizeAsync(): Promise<void> {\n    await this.nativeStatement.finalizeAsync(this.nativeDatabase);\n  }\n\n  //#endregion\n\n  //#region Synchronous API\n\n  /**\n   * Run the prepared statement and return the result.\n   *\n   * > **Note:** Running heavy tasks with this function can block the JavaScript thread, affecting performance.\n   *\n   * @param params @see `BindParams`\n   */\n  public runSync(...params: VariadicBindParams): RunResult;\n  public runSync(params: BindParams): RunResult;\n  public runSync(...params: unknown[]): RunResult {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    if (shouldPassAsObject) {\n      return this.nativeStatement.objectRunSync(this.nativeDatabase, bindParams);\n    } else {\n      return this.nativeStatement.arrayRunSync(this.nativeDatabase, bindParams);\n    }\n  }\n\n  /**\n   * Iterate the prepared statement and return results as an iterable.\n   *\n   * > **Note:** Running heavy tasks with this function can block the JavaScript thread, affecting performance.\n   *\n   * @param params @see `BindParams`\n   *\n   * @example\n   * ```ts\n   * const statement = await db.prepareSync('SELECT * FROM test');\n   * for (const row of statement.eachSync<any>()) {\n   *   console.log(row);\n   * }\n   * ```\n   */\n  public eachSync<T>(...params: VariadicBindParams): IterableIterator<T>;\n  public eachSync<T>(params: BindParams): IterableIterator<T>;\n  public *eachSync<T>(...params: unknown[]): IterableIterator<T> {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    const func = shouldPassAsObject\n      ? this.nativeStatement.objectGetSync.bind(this.nativeStatement)\n      : this.nativeStatement.arrayGetSync.bind(this.nativeStatement);\n\n    const columnNames = this.getColumnNamesSync();\n    let result = null;\n    do {\n      result = func(this.nativeDatabase, bindParams);\n      if (result != null) {\n        yield composeRow<T>(columnNames, result);\n      }\n    } while (result != null);\n  }\n\n  /**\n   * Get one row from the prepared statement.\n   *\n   * > **Note:** Running heavy tasks with this function can block the JavaScript thread, affecting performance.\n   *\n   * @param params @see `BindParams`\n   */\n  public getSync<T>(...params: VariadicBindParams): T | null;\n  public getSync<T>(params: BindParams): T | null;\n  public getSync<T>(...params: unknown[]): T | null {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    const columnNames = this.getColumnNamesSync();\n    const columnValues = shouldPassAsObject\n      ? this.nativeStatement.objectGetSync(this.nativeDatabase, bindParams)\n      : this.nativeStatement.arrayGetSync(this.nativeDatabase, bindParams);\n    return columnValues != null ? composeRow<T>(columnNames, columnValues) : null;\n  }\n\n  /**\n   * Get all rows from the prepared statement.\n   *\n   * > **Note:** Running heavy tasks with this function can block the JavaScript thread, affecting performance.\n   *\n   * @param params @see `BindParams`\n   */\n  public allSync<T>(...params: VariadicBindParams): T[];\n  public allSync<T>(params: BindParams): T[];\n  public allSync<T>(...params: unknown[]): T[] {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    const columnNames = this.getColumnNamesSync();\n    const columnValuesList = shouldPassAsObject\n      ? this.nativeStatement.objectGetAllSync(this.nativeDatabase, bindParams)\n      : this.nativeStatement.arrayGetAllSync(this.nativeDatabase, bindParams);\n    return composeRows<T>(columnNames, columnValuesList);\n  }\n\n  /**\n   * Get the column names of the prepared statement.\n   */\n  public getColumnNamesSync(): string[] {\n    return this.nativeStatement.getColumnNamesSync();\n  }\n\n  /**\n   * Reset the prepared statement cursor.\n   */\n  public resetSync(): void {\n    this.nativeStatement.resetSync(this.nativeDatabase);\n  }\n\n  /**\n   * Finalize the prepared statement.\n   *\n   * > **Note:** Remember to finalize the prepared statement whenever you call `prepareSync()` to avoid resource leaks.\n   *\n   */\n  public finalizeSync(): void {\n    this.nativeStatement.finalizeSync(this.nativeDatabase);\n  }\n\n  //#endregion\n}\n\n/**\n * Normalize the bind params to an array or object.\n * @hidden\n */\nexport function normalizeParams(...params: any[]): {\n  params: BindParams;\n  shouldPassAsObject: boolean;\n} {\n  let bindParams = params.length > 1 ? params : (params[0] as BindParams);\n  if (bindParams == null) {\n    bindParams = [];\n  }\n  if (typeof bindParams !== 'object') {\n    bindParams = [bindParams];\n  }\n  const shouldPassAsObject = !Array.isArray(bindParams);\n  return {\n    params: bindParams,\n    shouldPassAsObject,\n  };\n}\n\n/**\n * Compose `columnNames` and `columnValues` to an row object.\n * @hidden\n */\nexport function composeRow<T>(columnNames: ColumnNames, columnValues: ColumnValues): T {\n  const row = {};\n  if (columnNames.length !== columnValues.length) {\n    throw new Error(\n      `Column names and values count mismatch. Names: ${columnNames.length}, Values: ${columnValues.length}`\n    );\n  }\n  for (let i = 0; i < columnNames.length; i++) {\n    row[columnNames[i]] = columnValues[i];\n  }\n  return row as T;\n}\n\n/**\n * Compose `columnNames` and `columnValuesList` to an array of row objects.\n * @hidden\n */\nexport function composeRows<T>(columnNames: ColumnNames, columnValuesList: ColumnValues[]): T[] {\n  if (columnValuesList.length === 0) {\n    return [];\n  }\n  if (columnNames.length !== columnValuesList[0].length) {\n    // We only check the first row because SQLite returns the same column count for all rows.\n    throw new Error(\n      `Column names and values count mismatch. Names: ${columnNames.length}, Values: ${columnValuesList[0].length}`\n    );\n  }\n  const results: T[] = [];\n  for (const columnValues of columnValuesList) {\n    const row = {};\n    for (let i = 0; i < columnNames.length; i++) {\n      row[columnNames[i]] = columnValues[i];\n    }\n    results.push(row as T);\n  }\n  return results;\n}\n"]}
+{"version":3,"file":"Statement.js","sourceRoot":"","sources":["../../src/next/Statement.ts"],"names":[],"mappings":"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","sourcesContent":["import { NativeDatabase } from './NativeDatabase';\nimport {\n  BindParams,\n  BindValue,\n  NativeStatement,\n  RunResult,\n  VariadicBindParams,\n  type ColumnNames,\n  type ColumnValues,\n} from './NativeStatement';\n\nexport { BindParams, BindValue, RunResult, VariadicBindParams };\n\n/**\n * A prepared statement returned by [`Database.prepareAsync()`](#prepareasyncsource) or [`Database.prepareSync()`](#preparesyncsource) that can be binded with parameters and executed.\n */\nexport class Statement {\n  constructor(\n    private readonly nativeDatabase: NativeDatabase,\n    private readonly nativeStatement: NativeStatement\n  ) {}\n\n  //#region Asynchronous API\n\n  /**\n   * Run the prepared statement and return the result.\n   * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.\n   */\n  public runAsync(params: BindParams): Promise<RunResult>;\n  /**\n   * @hidden\n   */\n  public runAsync(...params: VariadicBindParams): Promise<RunResult>;\n  public async runAsync(...params: unknown[]): Promise<RunResult> {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    if (shouldPassAsObject) {\n      return await this.nativeStatement.objectRunAsync(this.nativeDatabase, bindParams);\n    } else {\n      return await this.nativeStatement.arrayRunAsync(this.nativeDatabase, bindParams);\n    }\n  }\n\n  /**\n   * Iterate the prepared statement and return results as an async iterable.\n   * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.\n   * @example\n   * ```ts\n   * const statement = await db.prepareAsync('SELECT * FROM test');\n   * for await (const row of statement.eachAsync<any>()) {\n   *   console.log(row);\n   * }\n   * await statement.finalizeAsync();\n   * ```\n   */\n  public eachAsync<T>(params: BindParams): AsyncIterableIterator<T>;\n  /**\n   * @hidden\n   */\n  public eachAsync<T>(...params: VariadicBindParams): AsyncIterableIterator<T>;\n  public async *eachAsync<T>(...params: unknown[]): AsyncIterableIterator<T> {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    const func = shouldPassAsObject\n      ? this.nativeStatement.objectGetAsync.bind(this.nativeStatement)\n      : this.nativeStatement.arrayGetAsync.bind(this.nativeStatement);\n\n    const columnNames = await this.getColumnNamesAsync();\n    let result = null;\n    do {\n      result = await func(this.nativeDatabase, bindParams);\n      if (result != null) {\n        yield composeRow<T>(columnNames, result);\n      }\n    } while (result != null);\n  }\n\n  /**\n   * Get one row from the prepared statement.\n   * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.\n   */\n  public getAsync<T>(params: BindParams): Promise<T | null>;\n  /**\n   * @hidden\n   */\n  public getAsync<T>(...params: VariadicBindParams): Promise<T | null>;\n  public async getAsync<T>(...params: unknown[]): Promise<T | null> {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    const columnNames = await this.getColumnNamesAsync();\n    const columnValues = shouldPassAsObject\n      ? await this.nativeStatement.objectGetAsync(this.nativeDatabase, bindParams)\n      : await this.nativeStatement.arrayGetAsync(this.nativeDatabase, bindParams);\n    return columnValues != null ? composeRow<T>(columnNames, columnValues) : null;\n  }\n\n  /**\n   * Get all rows from the prepared statement.\n   * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.\n   */\n  public allAsync<T>(params: BindParams): Promise<T[]>;\n  /**\n   * @hidden\n   */\n  public allAsync<T>(...params: VariadicBindParams): Promise<T[]>;\n  public async allAsync<T>(...params: unknown[]): Promise<T[]> {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    const columnNames = await this.getColumnNamesAsync();\n    const columnValuesList = shouldPassAsObject\n      ? await this.nativeStatement.objectGetAllAsync(this.nativeDatabase, bindParams)\n      : await this.nativeStatement.arrayGetAllAsync(this.nativeDatabase, bindParams);\n    return composeRows<T>(columnNames, columnValuesList);\n  }\n\n  /**\n   * Get the column names of the prepared statement.\n   */\n  public getColumnNamesAsync(): Promise<string[]> {\n    return this.nativeStatement.getColumnNamesAsync();\n  }\n\n  /**\n   * Reset the prepared statement cursor.\n   */\n  public async resetAsync(): Promise<void> {\n    await this.nativeStatement.resetAsync(this.nativeDatabase);\n  }\n\n  /**\n   * Finalize the prepared statement.\n   * > **Note:** Remember to finalize the prepared statement whenever you call `prepareAsync()` to avoid resource leaks.\n   */\n  public async finalizeAsync(): Promise<void> {\n    await this.nativeStatement.finalizeAsync(this.nativeDatabase);\n  }\n\n  //#endregion\n\n  //#region Synchronous API\n\n  /**\n   * Run the prepared statement and return the result.\n   * > **Note:** Running heavy tasks with this function can block the JavaScript thread and affect performance.\n   * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.\n   */\n  public runSync(params: BindParams): RunResult;\n  /**\n   * @hidden\n   */\n  public runSync(...params: VariadicBindParams): RunResult;\n  public runSync(...params: unknown[]): RunResult {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    if (shouldPassAsObject) {\n      return this.nativeStatement.objectRunSync(this.nativeDatabase, bindParams);\n    } else {\n      return this.nativeStatement.arrayRunSync(this.nativeDatabase, bindParams);\n    }\n  }\n\n  /**\n   * Iterate the prepared statement and return results as an iterable.\n   * > **Note:** Running heavy tasks with this function can block the JavaScript thread and affect performance.\n   * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.\n   */\n  public eachSync<T>(params: BindParams): IterableIterator<T>;\n  /**\n   * @hidden\n   */\n  public eachSync<T>(...params: VariadicBindParams): IterableIterator<T>;\n  public *eachSync<T>(...params: unknown[]): IterableIterator<T> {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    const func = shouldPassAsObject\n      ? this.nativeStatement.objectGetSync.bind(this.nativeStatement)\n      : this.nativeStatement.arrayGetSync.bind(this.nativeStatement);\n\n    const columnNames = this.getColumnNamesSync();\n    let result = null;\n    do {\n      result = func(this.nativeDatabase, bindParams);\n      if (result != null) {\n        yield composeRow<T>(columnNames, result);\n      }\n    } while (result != null);\n  }\n\n  /**\n   * Get one row from the prepared statement.\n   * > **Note:** Running heavy tasks with this function can block the JavaScript thread and affect performance.\n   * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.\n   */\n  public getSync<T>(params: BindParams): T | null;\n  /**\n   * @hidden\n   */\n  public getSync<T>(...params: VariadicBindParams): T | null;\n  public getSync<T>(...params: unknown[]): T | null {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    const columnNames = this.getColumnNamesSync();\n    const columnValues = shouldPassAsObject\n      ? this.nativeStatement.objectGetSync(this.nativeDatabase, bindParams)\n      : this.nativeStatement.arrayGetSync(this.nativeDatabase, bindParams);\n    return columnValues != null ? composeRow<T>(columnNames, columnValues) : null;\n  }\n\n  /**\n   * Get all rows from the prepared statement.\n   * > **Note:** Running heavy tasks with this function can block the JavaScript thread and affect performance.\n   * @param params The parameters to bind to the prepared statement. You can pass values in array, object, or variadic arguments. See [`BindValue`](#bindvalue) for more information about binding values.\n   */\n  public allSync<T>(params: BindParams): T[];\n  /**\n   * @hidden\n   */\n  public allSync<T>(...params: VariadicBindParams): T[];\n  public allSync<T>(...params: unknown[]): T[] {\n    const { params: bindParams, shouldPassAsObject } = normalizeParams(...params);\n    const columnNames = this.getColumnNamesSync();\n    const columnValuesList = shouldPassAsObject\n      ? this.nativeStatement.objectGetAllSync(this.nativeDatabase, bindParams)\n      : this.nativeStatement.arrayGetAllSync(this.nativeDatabase, bindParams);\n    return composeRows<T>(columnNames, columnValuesList);\n  }\n\n  /**\n   * Get the column names of the prepared statement.\n   */\n  public getColumnNamesSync(): string[] {\n    return this.nativeStatement.getColumnNamesSync();\n  }\n\n  /**\n   * Reset the prepared statement cursor.\n   */\n  public resetSync(): void {\n    this.nativeStatement.resetSync(this.nativeDatabase);\n  }\n\n  /**\n   * Finalize the prepared statement.\n   *\n   * > **Note:** Remember to finalize the prepared statement whenever you call `prepareSync()` to avoid resource leaks.\n   *\n   */\n  public finalizeSync(): void {\n    this.nativeStatement.finalizeSync(this.nativeDatabase);\n  }\n\n  //#endregion\n}\n\n/**\n * Normalize the bind params to an array or object.\n * @hidden\n */\nexport function normalizeParams(...params: any[]): {\n  params: BindParams;\n  shouldPassAsObject: boolean;\n} {\n  let bindParams = params.length > 1 ? params : (params[0] as BindParams);\n  if (bindParams == null) {\n    bindParams = [];\n  }\n  if (typeof bindParams !== 'object') {\n    bindParams = [bindParams];\n  }\n  const shouldPassAsObject = !Array.isArray(bindParams);\n  return {\n    params: bindParams,\n    shouldPassAsObject,\n  };\n}\n\n/**\n * Compose `columnNames` and `columnValues` to an row object.\n * @hidden\n */\nexport function composeRow<T>(columnNames: ColumnNames, columnValues: ColumnValues): T {\n  const row = {};\n  if (columnNames.length !== columnValues.length) {\n    throw new Error(\n      `Column names and values count mismatch. Names: ${columnNames.length}, Values: ${columnValues.length}`\n    );\n  }\n  for (let i = 0; i < columnNames.length; i++) {\n    row[columnNames[i]] = columnValues[i];\n  }\n  return row as T;\n}\n\n/**\n * Compose `columnNames` and `columnValuesList` to an array of row objects.\n * @hidden\n */\nexport function composeRows<T>(columnNames: ColumnNames, columnValuesList: ColumnValues[]): T[] {\n  if (columnValuesList.length === 0) {\n    return [];\n  }\n  if (columnNames.length !== columnValuesList[0].length) {\n    // We only check the first row because SQLite returns the same column count for all rows.\n    throw new Error(\n      `Column names and values count mismatch. Names: ${columnNames.length}, Values: ${columnValuesList[0].length}`\n    );\n  }\n  const results: T[] = [];\n  for (const columnValues of columnValuesList) {\n    const row = {};\n    for (let i = 0; i < columnNames.length; i++) {\n      row[columnNames[i]] = columnValues[i];\n    }\n    results.push(row as T);\n  }\n  return results;\n}\n"]}

package/build/next/hooks.d.ts

@@ -30,6 +30,31 @@ export interface SQLiteProviderProps {
      */
     errorHandler?: (error: Error) => void;
 }
+/**
+ * Context.Provider component that provides a SQLite database to all children.
+ * All descendants of this component will be able to access the database using the [`useSQLiteContext`](#usesqlitecontext) hook.
+ */
 export declare function SQLiteProvider({ dbName, options, children, initHandler, loadingFallback, errorHandler, }: SQLiteProviderProps): JSX.Element | null;
+/**
+ * A global hook for accessing the SQLite database across components.
+ * This hook should only be used within a [`<SQLiteProvider>`](#sqliteprovider) component.
+ *
+ * @example
+ * ```tsx
+ * export default function App() {
+ *   return (
+ *     <SQLiteProvider dbName="test.db">
+ *       <Main />
+ *     </SQLiteProvider>
+ *   );
+ * }
+ *
+ * export function Main() {
+ *   const db = useSQLiteContext();
+ *   console.log('sqlite version', db.getSync('SELECT sqlite_version()'));
+ *   return <View />
+ * }
+ * ```
+ */
 export declare function useSQLiteContext(): Database;
 //# sourceMappingURL=hooks.d.ts.map

package/build/next/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/next/hooks.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiE,MAAM,OAAO,CAAC;AAEtF,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAE1B;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;OAGG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAElC;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACvC;AAMD,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,OAAO,EACP,QAAQ,EACR,WAAW,EACX,eAAe,EACf,YAAY,GACb,EAAE,mBAAmB,sBAkDrB;AAGD,wBAAgB,gBAAgB,aAM/B"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/next/hooks.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiE,MAAM,OAAO,CAAC;AAEtF,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAE1B;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;OAGG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAElC;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACvC;AAOD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,OAAO,EACP,QAAQ,EACR,WAAW,EACX,eAAe,EACf,YAAY,GACb,EAAE,mBAAmB,sBAkDrB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,CAM3C"}

package/build/next/hooks.js

@@ -1,8 +1,13 @@
 import React, { createContext, useContext, useEffect, useRef, useState } from 'react';
 import { openDatabaseAsync } from './Database';
-// Create a context for the SQLite database
+/**
+ * Create a context for the SQLite database
+ */
 const SQLiteContext = createContext(null);
-// Create a provider component
+/**
+ * Context.Provider component that provides a SQLite database to all children.
+ * All descendants of this component will be able to access the database using the [`useSQLiteContext`](#usesqlitecontext) hook.
+ */
 export function SQLiteProvider({ dbName, options, children, initHandler, loadingFallback, errorHandler, }) {
     const databaseRef = useRef(null);
     const [loading, setLoading] = useState(true);
@@ -49,7 +54,27 @@ export function SQLiteProvider({ dbName, options, children, initHandler, loading
     }
     return <SQLiteContext.Provider value={databaseRef.current}>{children}</SQLiteContext.Provider>;
 }
-// Create a hook for accessing the SQLite database context
+/**
+ * A global hook for accessing the SQLite database across components.
+ * This hook should only be used within a [`<SQLiteProvider>`](#sqliteprovider) component.
+ *
+ * @example
+ * ```tsx
+ * export default function App() {
+ *   return (
+ *     <SQLiteProvider dbName="test.db">
+ *       <Main />
+ *     </SQLiteProvider>
+ *   );
+ * }
+ *
+ * export function Main() {
+ *   const db = useSQLiteContext();
+ *   console.log('sqlite version', db.getSync('SELECT sqlite_version()'));
+ *   return <View />
+ * }
+ * ```
+ */
 export function useSQLiteContext() {
     const context = useContext(SQLiteContext);
     if (context == null) {

package/build/next/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/next/hooks.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtF,OAAO,EAAE,iBAAiB,EAAiB,MAAM,YAAY,CAAC;AAsC9D,2CAA2C;AAC3C,MAAM,aAAa,GAAG,aAAa,CAAkB,IAAI,CAAC,CAAC;AAE3D,8BAA8B;AAC9B,MAAM,UAAU,cAAc,CAAC,EAC7B,MAAM,EACN,OAAO,EACP,QAAQ,EACR,WAAW,EACX,eAAe,EACf,YAAY,GACQ;IACpB,MAAM,WAAW,GAAG,MAAM,CAAkB,IAAI,CAAC,CAAC;IAClD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,SAAS,CAAC,GAAG,EAAE;QACb,KAAK,UAAU,KAAK;YAClB,IAAI;gBACF,MAAM,EAAE,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACpD,IAAI,WAAW,IAAI,IAAI,EAAE;oBACvB,MAAM,WAAW,CAAC,EAAE,CAAC,CAAC;iBACvB;gBACD,WAAW,CAAC,OAAO,GAAG,EAAE,CAAC;gBACzB,UAAU,CAAC,KAAK,CAAC,CAAC;aACnB;YAAC,OAAO,CAAC,EAAE;gBACV,QAAQ,CAAC,CAAC,CAAC,CAAC;aACb;QACH,CAAC;QAED,KAAK,UAAU,QAAQ,CAAC,EAAmB;YACzC,IAAI;gBACF,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC;aACxB;YAAC,OAAO,CAAC,EAAE;gBACV,QAAQ,CAAC,CAAC,CAAC,CAAC;aACb;QACH,CAAC;QAED,KAAK,EAAE,CAAC;QAER,OAAO,GAAG,EAAE;YACV,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC;YAC/B,QAAQ,CAAC,EAAE,CAAC,CAAC;YACb,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3B,UAAU,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAEnC,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,MAAM,OAAO,GACX,YAAY;YACZ,CAAC,CAAC,CAAC,EAAE,EAAE;gBACL,MAAM,CAAC,CAAC;YACV,CAAC,CAAC,CAAC;QACL,OAAO,CAAC,KAAK,CAAC,CAAC;KAChB;IAED,IAAI,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE;QACnC,OAAO,eAAe,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;KAChE;IACD,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;AACjG,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IAC1C,IAAI,OAAO,IAAI,IAAI,EAAE;QACnB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;KAC5E;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import React, { createContext, useContext, useEffect, useRef, useState } from 'react';\n\nimport { openDatabaseAsync, type Database } from './Database';\nimport type { OpenOptions } from './NativeDatabase';\n\nexport interface SQLiteProviderProps {\n  /**\n   * The name of the database file to open.\n   */\n  dbName: string;\n\n  /**\n   * Open options.\n   */\n  options?: OpenOptions;\n\n  /**\n   * The children to render.\n   */\n  children: React.ReactNode;\n\n  /**\n   * A custom initialization handler to run before rendering the children.\n   * You can use this to run database migrations or other setup tasks.\n   */\n  initHandler?: (db: Database) => Promise<void>;\n\n  /**\n   * A custom loading fallback to render before the database is ready.\n   * @default null\n   */\n  loadingFallback?: React.ReactNode;\n\n  /**\n   * Handle errors from SQLiteProvider.\n   * @default rethrow the error\n   */\n  errorHandler?: (error: Error) => void;\n}\n\n// Create a context for the SQLite database\nconst SQLiteContext = createContext<Database | null>(null);\n\n// Create a provider component\nexport function SQLiteProvider({\n  dbName,\n  options,\n  children,\n  initHandler,\n  loadingFallback,\n  errorHandler,\n}: SQLiteProviderProps) {\n  const databaseRef = useRef<Database | null>(null);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    async function setup() {\n      try {\n        const db = await openDatabaseAsync(dbName, options);\n        if (initHandler != null) {\n          await initHandler(db);\n        }\n        databaseRef.current = db;\n        setLoading(false);\n      } catch (e) {\n        setError(e);\n      }\n    }\n\n    async function teardown(db: Database | null) {\n      try {\n        await db?.closeAsync();\n      } catch (e) {\n        setError(e);\n      }\n    }\n\n    setup();\n\n    return () => {\n      const db = databaseRef.current;\n      teardown(db);\n      databaseRef.current = null;\n      setLoading(true);\n    };\n  }, [dbName, options, initHandler]);\n\n  if (error != null) {\n    const handler =\n      errorHandler ??\n      ((e) => {\n        throw e;\n      });\n    handler(error);\n  }\n\n  if (loading || !databaseRef.current) {\n    return loadingFallback != null ? <>{loadingFallback}</> : null;\n  }\n  return <SQLiteContext.Provider value={databaseRef.current}>{children}</SQLiteContext.Provider>;\n}\n\n// Create a hook for accessing the SQLite database context\nexport function useSQLiteContext() {\n  const context = useContext(SQLiteContext);\n  if (context == null) {\n    throw new Error('useSQLiteContext must be used within a <SQLiteProvider>');\n  }\n  return context;\n}\n"]}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/next/hooks.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtF,OAAO,EAAE,iBAAiB,EAAiB,MAAM,YAAY,CAAC;AAsC9D;;GAEG;AACH,MAAM,aAAa,GAAG,aAAa,CAAkB,IAAI,CAAC,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,MAAM,EACN,OAAO,EACP,QAAQ,EACR,WAAW,EACX,eAAe,EACf,YAAY,GACQ;IACpB,MAAM,WAAW,GAAG,MAAM,CAAkB,IAAI,CAAC,CAAC;IAClD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,SAAS,CAAC,GAAG,EAAE;QACb,KAAK,UAAU,KAAK;YAClB,IAAI;gBACF,MAAM,EAAE,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACpD,IAAI,WAAW,IAAI,IAAI,EAAE;oBACvB,MAAM,WAAW,CAAC,EAAE,CAAC,CAAC;iBACvB;gBACD,WAAW,CAAC,OAAO,GAAG,EAAE,CAAC;gBACzB,UAAU,CAAC,KAAK,CAAC,CAAC;aACnB;YAAC,OAAO,CAAC,EAAE;gBACV,QAAQ,CAAC,CAAC,CAAC,CAAC;aACb;QACH,CAAC;QAED,KAAK,UAAU,QAAQ,CAAC,EAAmB;YACzC,IAAI;gBACF,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC;aACxB;YAAC,OAAO,CAAC,EAAE;gBACV,QAAQ,CAAC,CAAC,CAAC,CAAC;aACb;QACH,CAAC;QAED,KAAK,EAAE,CAAC;QAER,OAAO,GAAG,EAAE;YACV,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC;YAC/B,QAAQ,CAAC,EAAE,CAAC,CAAC;YACb,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3B,UAAU,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAEnC,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,MAAM,OAAO,GACX,YAAY;YACZ,CAAC,CAAC,CAAC,EAAE,EAAE;gBACL,MAAM,CAAC,CAAC;YACV,CAAC,CAAC,CAAC;QACL,OAAO,CAAC,KAAK,CAAC,CAAC;KAChB;IAED,IAAI,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE;QACnC,OAAO,eAAe,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;KAChE;IACD,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;AACjG,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IAC1C,IAAI,OAAO,IAAI,IAAI,EAAE;QACnB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;KAC5E;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import React, { createContext, useContext, useEffect, useRef, useState } from 'react';\n\nimport { openDatabaseAsync, type Database } from './Database';\nimport type { OpenOptions } from './NativeDatabase';\n\nexport interface SQLiteProviderProps {\n  /**\n   * The name of the database file to open.\n   */\n  dbName: string;\n\n  /**\n   * Open options.\n   */\n  options?: OpenOptions;\n\n  /**\n   * The children to render.\n   */\n  children: React.ReactNode;\n\n  /**\n   * A custom initialization handler to run before rendering the children.\n   * You can use this to run database migrations or other setup tasks.\n   */\n  initHandler?: (db: Database) => Promise<void>;\n\n  /**\n   * A custom loading fallback to render before the database is ready.\n   * @default null\n   */\n  loadingFallback?: React.ReactNode;\n\n  /**\n   * Handle errors from SQLiteProvider.\n   * @default rethrow the error\n   */\n  errorHandler?: (error: Error) => void;\n}\n\n/**\n * Create a context for the SQLite database\n */\nconst SQLiteContext = createContext<Database | null>(null);\n\n/**\n * Context.Provider component that provides a SQLite database to all children.\n * All descendants of this component will be able to access the database using the [`useSQLiteContext`](#usesqlitecontext) hook.\n */\nexport function SQLiteProvider({\n  dbName,\n  options,\n  children,\n  initHandler,\n  loadingFallback,\n  errorHandler,\n}: SQLiteProviderProps) {\n  const databaseRef = useRef<Database | null>(null);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    async function setup() {\n      try {\n        const db = await openDatabaseAsync(dbName, options);\n        if (initHandler != null) {\n          await initHandler(db);\n        }\n        databaseRef.current = db;\n        setLoading(false);\n      } catch (e) {\n        setError(e);\n      }\n    }\n\n    async function teardown(db: Database | null) {\n      try {\n        await db?.closeAsync();\n      } catch (e) {\n        setError(e);\n      }\n    }\n\n    setup();\n\n    return () => {\n      const db = databaseRef.current;\n      teardown(db);\n      databaseRef.current = null;\n      setLoading(true);\n    };\n  }, [dbName, options, initHandler]);\n\n  if (error != null) {\n    const handler =\n      errorHandler ??\n      ((e) => {\n        throw e;\n      });\n    handler(error);\n  }\n\n  if (loading || !databaseRef.current) {\n    return loadingFallback != null ? <>{loadingFallback}</> : null;\n  }\n  return <SQLiteContext.Provider value={databaseRef.current}>{children}</SQLiteContext.Provider>;\n}\n\n/**\n * A global hook for accessing the SQLite database across components.\n * This hook should only be used within a [`<SQLiteProvider>`](#sqliteprovider) component.\n *\n * @example\n * ```tsx\n * export default function App() {\n *   return (\n *     <SQLiteProvider dbName=\"test.db\">\n *       <Main />\n *     </SQLiteProvider>\n *   );\n * }\n *\n * export function Main() {\n *   const db = useSQLiteContext();\n *   console.log('sqlite version', db.getSync('SELECT sqlite_version()'));\n *   return <View />\n * }\n * ```\n */\nexport function useSQLiteContext(): Database {\n  const context = useContext(SQLiteContext);\n  if (context == null) {\n    throw new Error('useSQLiteContext must be used within a <SQLiteProvider>');\n  }\n  return context;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-sqlite",
-  "version": "12.1.0",
+  "version": "12.2.0",
   "description": "Provides access to a database that can be queried through a WebSQL-like API (https://www.w3.org/TR/webdatabase/). The database is persisted across restarts of your app.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -46,5 +46,5 @@
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "d6ca9109f1f9113bde6c2a9fe82974cc64cf8756"
+  "gitHead": "3142a086578deffd8704a8f1b6f0f661527d836c"
 }