/**
 * This is a WebAssembly build of SQLite with experimental support for
 * writing SQLite virtual file systems and modules (for virtual tables)
 * in Javascript. Also see the
 * [GitHub repository](https://github.com/rhashimoto/wa-sqlite) and the
 * [online demo](https://rhashimoto.github.io/wa-sqlite/demo/).
 * @module
 */

/**
 *  Javascript types that SQLite can use
 *
 * C integer and floating-point types both map to/from Javascript `number`.
 * Blob data can be provided to SQLite as `Uint8Array` or `number[]` (with
 * each element converted to a byte); SQLite always returns blob data as
 * `Uint8Array`
 */
type SQLiteCompatibleType =
  | number
  | string
  | Uint8Array
  | Array<number>
  | bigint
  | null

/**
 * SQLite Virtual File System object
 *
 * Objects with this interface can be passed to {@link SQLiteAPI.vfs_register}
 * to define a new filesystem.
 *
 * There are examples of a synchronous
 * [MemoryVFS.js](https://github.com/rhashimoto/wa-sqlite/blob/master/src/examples/MemoryVFS.js),
 * and asynchronous
 * [MemoryAsyncVFS.js](https://github.com/rhashimoto/wa-sqlite/blob/master/src/examples/MemoryAsyncVFS.js)
 * and
 * [IndexedDbVFS.js](https://github.com/rhashimoto/wa-sqlite/blob/master/src/examples/IndexedDbVFS.js).
 *
 * @see https://sqlite.org/vfs.html
 * @see https://sqlite.org/c3ref/io_methods.html
 */
declare interface SQLiteVFS {
  /** Maximum length of a file path in UTF-8 bytes (default 64) */
  mxPathName?: number

  close(): void
  isReady(): boolean

  /** @see https://sqlite.org/c3ref/io_methods.html */
  xClose(fileId: number): number

  /** @see https://sqlite.org/c3ref/io_methods.html */
  xRead(
    fileId: number,
    pData: number,
    iAmt: number,
    iOffsetLo: number,
    iOffsetHi: number,
  ): number

  /** @see https://sqlite.org/c3ref/io_methods.html */
  xWrite(
    fileId: number,
    pData: number,
    iAmt: number,
    iOffsetLo: number,
    iOffsetHi: number,
  ): number

  /** @see https://sqlite.org/c3ref/io_methods.html */
  xTruncate(fileId: number, iSizeLo: number, iSizeHi): number

  /** @see https://sqlite.org/c3ref/io_methods.html */
  xSync(fileId: number, flags: number): number

  /** @see https://sqlite.org/c3ref/io_methods.html */
  xFileSize(fileId: number, pSize64: number): number

  /** @see https://sqlite.org/c3ref/io_methods.html */
  xLock(fileId: number, flags: number): number

  /** @see https://sqlite.org/c3ref/io_methods.html */
  xUnlock(fileId: number, flags: number): number

  /** @see https://sqlite.org/c3ref/io_methods.html */
  xCheckReservedLock(fileId: number, pResOut: number): number

  /** @see https://sqlite.org/c3ref/io_methods.html */
  xFileControl(fileId: number, flags: number, pOut: number): number

  /** @see https://sqlite.org/c3ref/io_methods.html */
  xDeviceCharacteristics(fileId: number): number

  /** @see https://sqlite.org/c3ref/vfs.html */
  xOpen(
    pVfs: number,
    zName: number,
    pFile: number,
    flags: number,
    pOutFlags: number,
  ): number

  /** @see https://sqlite.org/c3ref/vfs.html */
  xDelete(pVfs: number, zName: number, syncDir: number): number

  /** @see https://sqlite.org/c3ref/vfs.html */
  xAccess(pVfs: number, zName: number, flags: number, pResOut: number): number
}

/**
 * Options object argument for {@link SQLiteAPI.statements}
 */
declare interface SQLitePrepareOptions {
  /**
   * Statement handles prepared and yielded by {@link SQLiteAPI.statements}
   * are normally valid only within the scope of an iteration.
   * Set `unscoped` to `true` to give iterated statements an arbitrary
   * lifetime.
   */
  unscoped?: boolean

  /**
   * SQLITE_PREPARE_* flags
   * @see https://www.sqlite.org/c3ref/c_prepare_normalize.html#sqlitepreparepersistent
   */
  flags?: number
}

/**
 * Javascript wrappers for the SQLite C API (plus a few convenience functions)
 *
 * Function signatures have been slightly modified to be more
 * Javascript-friendly. For the C functions that return an error code,
 * the corresponding Javascript wrapper will throw an exception with a
 * `code` property on an error.
 *
 * Note that a few functions return a Promise in order to accomodate
 * either a synchronous or asynchronous SQLite build, generally those
 * involved with opening/closing a database or executing a statement.
 *
 * To create an instance of the API, follow these steps:
 *
 * ```javascript
 * // Import an ES6 module factory function from one of the
 * // package builds, either 'wa-sqlite.mjs' (synchronous) or
 * // 'wa-sqlite-async.mjs' (asynchronous). You should only
 * // use the asynchronous build if you plan to use an
 * // asynchronous VFS or module.
 * import SQLiteESMFactory from 'wa-sqlite/dist/wa-sqlite.mjs';
 *
 * // Import the Javascript API wrappers.
 * import * as SQLite from 'wa-sqlite';
 *
 * // Use an async function to simplify Promise handling.
 * (async function() {
 *   // Invoke the ES6 module factory to create the SQLite
 *   // Emscripten module. This will fetch and compile the
 *   // .wasm file.
 *   const module = await SQLiteESMFactory();
 *
 *   // Use the module to build the API instance.
 *   const sqlite3 = SQLite.Factory(module);
 *
 *   // Use the API to open and access a database.
 *   const db = await sqlite3.open_v2('myDB');
 *   ...
 * })();
 * ```
 *
 * @see https://sqlite.org/c3ref/funclist.html
 */
declare interface SQLiteAPI {
  /**
   * Bind a collection of values to a statement
   *
   * This convenience function binds values from either an array or object
   * to a prepared statement with placeholder parameters.
   *
   * Array example using numbered parameters (numbering is implicit in
   * this example):
   * ```
   * const sql = 'INSERT INTO tbl VALUES (?, ?, ?)';
   * for await (const stmt of sqlite3.statements(db, sql) {
   *   sqlite3.bind_collection(stmt, [42, 'hello', null]);
   *   ...
   * }
   * ```
   *
   * Object example using named parameters (':', '@', or '$' prefixes
   * are allowed):
   * ```
   * const sql = 'INSERT INTO tbl VALUES (?, ?, ?)';
   * for await (const stmt of sqlite3.statements(db, sql) {
   *   sqlite3.bind_collection(stmt, {
   *     '@foo': 42,
   *     '@bar': 'hello',
   *     '@baz': null,
   *   });
   *   ...
   * }
   * ```
   *
   * Note that SQLite bindings are indexed beginning with 1, but when
   * binding values from an array `a` the values begin with `a[0]`.
   * @param stmt prepared statement pointer
   * @param bindings
   * @returns `SQLITE_OK` (throws exception on error)
   */
  bind_collection(
    stmt: number,
    bindings:
      | { [index: string]: SQLiteCompatibleType | null }
      | Array<SQLiteCompatibleType | null>,
  ): number

  /**
   * Bind value to prepared statement
   *
   * This convenience function calls the appropriate `bind_*` function
   * based on the type of `value`. Note that binding indices begin with 1.
   * @param stmt prepared statement pointer
   * @param i binding index
   * @param value
   * @returns `SQLITE_OK` (throws exception on error)
   */
  bind(stmt: number, i: number, value: SQLiteCompatibleType | null): number

  /**
   * Bind blob to prepared statement parameter
   *
   * Note that binding indices begin with 1.
   * @see https://www.sqlite.org/c3ref/bind_blob.html
   * @param stmt prepared statement pointer
   * @param i binding index
   * @param value
   * @returns `SQLITE_OK` (throws exception on error)
   */
  bind_blob(stmt: number, i: number, value: Uint8Array | Array<number>): number

  /**
   * Bind number to prepared statement parameter
   *
   * Note that binding indices begin with 1.
   * @see https://www.sqlite.org/c3ref/bind_blob.html
   * @param stmt prepared statement pointer
   * @param i binding index
   * @param value
   * @returns `SQLITE_OK` (throws exception on error)
   */
  bind_double(stmt: number, i: number, value: number): number

  /**
   * Bind number to prepared statement parameter
   *
   * Note that binding indices begin with 1.
   * @see https://www.sqlite.org/c3ref/bind_blob.html
   * @param stmt prepared statement pointer
   * @param i binding index
   * @param value
   * @returns `SQLITE_OK` (throws exception on error)
   */
  bind_int(stmt: number, i: number, value: number): number

  /**
   * Bind number to prepared statement parameter
   *
   * Note that binding indices begin with 1.
   * @see https://www.sqlite.org/c3ref/bind_blob.html
   * @param stmt prepared statement pointer
   * @param i binding index
   * @param value
   * @returns `SQLITE_OK` (throws exception on error)
   */
  bind_int64(stmt: number, i: number, value: bigint): number

  /**
   * Bind null to prepared statement
   *
   * Note that binding indices begin with 1.
   * @see https://www.sqlite.org/c3ref/bind_blob.html
   * @param stmt prepared statement pointer
   * @param i binding index
   * @returns `SQLITE_OK` (throws exception on error)
   */
  bind_null(stmt: number, i: number): number

  /**
   * Get number of bound parameters
   * @see https://www.sqlite.org/c3ref/bind_parameter_count.html
   * @param stmt prepared statement pointer
   * @returns number of statement binding locations
   */
  bind_parameter_count(stmt: number): number

  /**
   * Get name of bound parameter
   *
   * Note that binding indices begin with 1.
   * @see https://www.sqlite.org/c3ref/bind_parameter_name.html
   * @param stmt prepared statement pointer
   * @param i binding index
   * @returns binding name
   */
  bind_parameter_name(stmt: number, i: number): string

  /**
   * Bind string to prepared statement
   *
   * Note that binding indices begin with 1.
   * @see https://www.sqlite.org/c3ref/bind_blob.html
   * @param stmt prepared statement pointer
   * @param i binding index
   * @param value
   * @returns `SQLITE_OK` (throws exception on error)
   */
  bind_text(stmt: number, i: number, value: string): number

  /**
   * Get count of rows modified by last insert/update
   * @see https://www.sqlite.org/c3ref/changes.html
   * @param db database pointer
   * @returns number of rows modified
   */
  changes(db): number

  /**
   * Reset all bindings on a prepared statement.
   * @see https://www.sqlite.org/c3ref/clear_bindings.html
   * @param stmt prepared statement pointer
   * @returns `SQLITE_OK` (throws exception on error)
   */
  clear_bindings(stmt: number): number

  /**
   * https://www.sqlite.org/c3ref/deserialize.html
   * int sqlite3_deserialize(
   *   sqlite3 *db,            The database connection
   *   const char *zSchema,    Which DB to reopen with the deserialization
   *   unsigned char *pData,   The serialized database content
   *   sqlite3_int64 szDb,     Number bytes in the deserialization
   *   sqlite3_int64 szBuf,    Total size of buffer pData[]
   *   unsigned mFlags         Zero or more SQLITE_DESERIALIZE_* flags
   * );
   */
  deserialize(
    db: number,
    zSchema: string,
    pData: Uint8Array,
    szDb: number,
    szBuf: number,
    mFlags: number,
  ): number

  /**
   * unsigned char *sqlite3_serialize(
   *  sqlite3 *db,           The database connection
   *  const char *zSchema,   Which DB to serialize. ex: "main", "temp", ...
   *  sqlite3_int64 *piSize, Write size of the DB here, if not NULL
   *  unsigned int mFlags    Zero or more SQLITE_SERIALIZE_* flags
   * );
   */
  serialize(
    db: number,
    zSchema: string,
    // mFlags: number
  ): Uint8Array

  /**
   * Close database connection
   * @see https://www.sqlite.org/c3ref/close.html
   * @param db database pointer
   * @returns `SQLITE_OK` (throws exception on error)
   */
  close(db): number

  /**
   * Call the appropriate `column_*` function based on the column type
   *
   * The type is determined by calling {@link column_type}, which may
   * not match the type declared in `CREATE TABLE`. Note that if the column
   * value is a blob then as with `column_blob` the result may be invalid
   * after the next SQLite call; copy if it needs to be retained.
   *
   * Integer values are returned as Number if within the min/max safe
   * integer bounds, otherwise they are returned as BigInt.
   * @param stmt prepared statement pointer
   * @param i column index
   * @returns column value
   */
  column(stmt: number, i: number): SQLiteCompatibleType

  /**
   * Extract a column value from a row after a prepared statment {@link step}
   *
   * The contents of the returned buffer may be invalid after the
   * next SQLite call. Make a copy of the data (e.g. with `.slice()`)
   * if longer retention is required.
   * @see https://www.sqlite.org/c3ref/column_blob.html
   * @param stmt prepared statement pointer
   * @param i column index
   * @returns column value
   */
  column_blob(stmt: number, i: number): Uint8Array

  /**
   * Get storage size for column text or blob
   * @see https://www.sqlite.org/c3ref/column_blob.html
   * @param stmt prepared statement pointer
   * @param i column index
   * @returns number of bytes in column text or blob
   */
  column_bytes(stmt: number, i: number): number

  /**
   * Get number of columns for a prepared statement
   * @see https://www.sqlite.org/c3ref/column_blob.html
   * @param stmt prepared statement pointer
   * @returns number of columns
   */
  column_count(stmt: number): number

  /**
   * Extract a column value from a row after a prepared statment {@link step}
   * @see https://www.sqlite.org/c3ref/column_blob.html
   * @param stmt prepared statement pointer
   * @param i column index
   * @returns column value
   */
  column_double(stmt: number, i: number): number

  /**
   * Extract a column value from a row after a prepared statment {@link step}
   * @see https://www.sqlite.org/c3ref/column_blob.html
   * @param stmt prepared statement pointer
   * @param i column index
   * @returns column value
   */
  column_int(stmt: number, i: number): number

  /**
   * Extract a column value from a row after a prepared statment {@link step}
   * @see https://www.sqlite.org/c3ref/column_blob.html
   * @param stmt prepared statement pointer
   * @param i column index
   * @returns column value
   */
  column_int64(stmt: number, i: number): bigint

  /**
   * Get a column name for a prepared statement
   * @see https://www.sqlite.org/c3ref/column_blob.html
   * @param stmt prepared statement pointer
   * @param i column index
   * @returns column name
   */
  column_name(stmt: number, i: number): string

  /**
   * Get names for all columns of a prepared statement
   *
   * This is a convenience function that calls {@link column_count} and
   * {@link column_name}.
   * @param stmt
   * @returns array of column names
   */
  column_names(stmt: number): Array<string>

  /**
   * Extract a column value from a row after a prepared statment {@link step}
   * @see https://www.sqlite.org/c3ref/column_blob.html
   * @param stmt prepared statement pointer
   * @param i column index
   * @returns column value
   */
  column_text(stmt: number, i: number): string

  /**
   * Get column type for a prepared statement
   *
   * Note that this type may not match the type declared in `CREATE TABLE`.
   * @see https://www.sqlite.org/c3ref/column_blob.html
   * @param stmt prepared statement pointer
   * @param i column index
   * @returns enumeration value for type
   */
  column_type(stmt: number, i: number): number

  /**
   * Register a commit hook
   *
   * @see https://www.sqlite.org/c3ref/commit_hook.html
   *
   * @param db database pointer
   * @param callback If a non-zero value is returned, commit is converted into
   * a rollback; disables callback when null
   */
  commit_hook(db: number, callback: (() => number) | null): void

  /**
   * Create or redefine SQL functions
   *
   * The application data passed is ignored. Use closures instead.
   *
   * If any callback function returns a Promise, that function must
   * be declared `async`, i.e. it must allow use of `await`.
   * @see https://sqlite.org/c3ref/create_function.html
   * @param db database pointer
   * @param zFunctionName
   * @param nArg number of function arguments
   * @param eTextRep text encoding (and other flags)
   * @param pApp application data (ignored)
   * @param xFunc
   * @param xStep
   * @param xFinal
   * @returns `SQLITE_OK` (throws exception on error)
   */
  create_function(
    db: number,
    zFunctionName: string,
    nArg: number,
    eTextRep: number,
    pApp: number,
    xFunc?: (context: number, values: Uint32Array) => void,
    xStep?: (context: number, values: Uint32Array) => void,
    xFinal?: (context: number) => void,
  ): number

  /**
   * Get number of columns in current row of a prepared statement
   * @see https://www.sqlite.org/c3ref/data_count.html
   * @param stmt prepared statement pointer
   * @returns number of columns
   */
  data_count(stmt: number): number

  /**
   * One-step query execution interface
   *
   * The implementation of this function uses {@link row}, which makes a
   * copy of blobs and returns BigInt for integers outside the safe integer
   * bounds for Number.
   * @see https://www.sqlite.org/c3ref/exec.html
   * @param db database pointer
   * @param zSQL queries
   * @returns An array of rows, each containing an array of column values
   */
  exec(db: number, zSQL: string): Array<Array<any>>

  /**
   * One-step query execution interface
   *
   * The implementation of this function uses {@link row}, which makes a
   * copy of blobs and returns BigInt for integers outside the safe integer
   * bounds for Number.
   * @see https://www.sqlite.org/c3ref/exec.html
   * @param db database pointer
   * @param zSQL queries
   * @returns An iterator of rows, each containing an array of column values
   */
  execIterator(
    db: number,
    zSQL: string,
  ): Iterable<Array<any> & { readonly columns: Array<string> }>

  /**
   * Destroy a prepared statement object compiled by {@link statements}
   * with the `unscoped` option set to `true`
   *
   * This function does *not* throw on error.
   * @see https://www.sqlite.org/c3ref/finalize.html
   * @param stmt prepared statement pointer
   * @returns Promise resolving to `SQLITE_OK` or error status
   */
  finalize(stmt: number): number

  /**
   * Test for autocommit mode
   * @see https://sqlite.org/c3ref/get_autocommit.html
   * @param db database pointer
   * @returns Non-zero if autocommit mode is on, zero otherwise
   */
  get_autocommit(db: number): number

  /**
   * Get SQLite library version
   * @see https://www.sqlite.org/c3ref/libversion.html
   * @returns version string, e.g. '3.35.5'
   */
  libversion(): string

  /**
   * Get SQLite library version
   * @see https://www.sqlite.org/c3ref/libversion.html
   * @returns version number, e.g. 3035005
   */
  libversion_number(): number

  /**
   * Set a usage limit on a connection.
   * @see https://www.sqlite.org/c3ref/limit.html
   * @param db database pointer
   * @param id limit category
   * @param newVal
   * @returns previous setting
   */
  limit(db: number, id: number, newVal: number): number

  /**
   * Opening a new database connection.
   *
   * Note that this function differs from the C API in that it
   * returns the Promise-wrapped database pointer (instead of a
   * result code).
   * @see https://sqlite.org/c3ref/open.html
   * @param zFilename
   * @param iFlags `SQLite.SQLITE_OPEN_CREATE | SQLite.SQLITE_OPEN_READWRITE` (0x6) if omitted
   * @param zVfs VFS name
   * @returns Promise-wrapped database pointer.
   */
  open_v2(zFilename: string, iFlags?: number, zVfs?: string): number

  /**
   * Specify callback to be invoked between long-running queries
   *
   * The application data passed is ignored. Use closures instead.
   *
   * If any callback function returns a Promise, that function must
   * be declared `async`, i.e. it must allow use of `await`.
   * @param db database pointer
   * @param nProgressOps target number of database operations between handler invocations
   * @param handler
   * @param userData
   */
  progress_handler(
    db: number,
    nProgressOps: number,
    handler: (userData: any) => number,
    userData,
  )

  /**
   * Reset a prepared statement object
   * @see https://www.sqlite.org/c3ref/reset.html
   * @param stmt prepared statement pointer
   * @returns Promise-wrapped `SQLITE_OK` (rejects on error)
   */
  reset(stmt: number): number

  /**
   * Convenience function to call `result_*` based of the type of `value`
   * @param context context pointer
   * @param value
   */
  result(context: number, value: (SQLiteCompatibleType | number[]) | null): void

  /**
   * Set the result of a function or vtable column
   * @see https://sqlite.org/c3ref/result_blob.html
   * @param context context pointer
   * @param value
   */
  result_blob(context: number, value: Uint8Array | number[]): void

  /**
   * Set the result of a function or vtable column
   * @see https://sqlite.org/c3ref/result_blob.html
   * @param context context pointer
   * @param value
   */
  result_double(context: number, value: number): void

  /**
   * Set the result of a function or vtable column
   * @see https://sqlite.org/c3ref/result_blob.html
   * @param context context pointer
   * @param value
   */
  result_int(context: number, value: number): void

  /**
   * Set the result of a function or vtable column
   * @see https://sqlite.org/c3ref/result_blob.html
   * @param context context pointer
   * @param value
   */
  result_int64(context: number, value: bigint): void

  /**
   * Set the result of a function or vtable column
   * @see https://sqlite.org/c3ref/result_blob.html
   * @param context context pointer
   */
  result_null(context: number): void

  /**
   * Set the result of a function or vtable column
   * @see https://sqlite.org/c3ref/result_blob.html
   * @param context context pointer
   * @param value
   */
  result_text(context: number, value: string): void

  /**
   * Get all column data for a row from a prepared statement step
   *
   * This convenience function will return a copy of any blob, unlike
   * {@link column_blob} which returns a value referencing volatile WASM
   * memory with short validity. Like {@link column}, it will return a
   * BigInt for integers outside the safe integer bounds for Number.
   * @param stmt prepared statement pointer
   * @returns row data
   */
  row(stmt: number): Array<SQLiteCompatibleType | null>

  /**
   * Register a callback function that is invoked to authorize certain SQL statement actions.
   * @see https://www.sqlite.org/c3ref/set_authorizer.html
   * @param db database pointer
   * @param authFunction
   * @param userData
   */
  set_authorizer(
    db: number,
    authFunction: (
      userData: any,
      iActionCode: number,
      param3: string | null,
      param4: string | null,
      param5: string | null,
      param6: string | null,
    ) => number,
    userData: any,
  ): number

  /**
   * Get statement SQL
   * @see https://www.sqlite.org/c3ref/expanded_sql.html
   * @param stmt prepared statement pointer
   * @returns SQL
   */
  sql(stmt: number): string

  /**
   * SQL statement iterator
   *
   * This function manages statement compilation by creating an async
   * iterator that yields a prepared statement handle on each iteration.
   * It is typically used with a `for await` loop (in an async function),
   * like this:
   * ```javascript
   * // Compile one statement on each iteration of this loop.
   * for await (const stmt of sqlite3.statements(db, sql)) {
   *   // Bind parameters here if using SQLite placeholders.
   *
   *   // Execute the statement with this loop.
   *   while (await sqlite3.step(stmt) === SQLite.SQLITE_ROW) {
   *     // Collect row data here.
   *   }
   *
   *   // Change bindings, reset, and execute again if desired.
   * }
   * ```
   *
   * By default, the lifetime of a yielded prepared statement is managed
   * automatically by the iterator, ending at the end of each iteration.
   * {@link finalize} should *not* be called on a statement provided by
   * the iterator unless the `unscoped` option is set to `true` (that
   * option is provided for applications that wish to manage statement
   * lifetimes manually).
   *
   * If using the iterator manually, i.e. by calling its `next`
   * method, be sure to call the `return` method if iteration
   * is abandoned before completion (`for await` and other implicit
   * traversals provided by Javascript do this automatically)
   * to ensure that all allocated resources are released.
   * @see https://www.sqlite.org/c3ref/prepare.html
   * @param db database pointer
   * @param sql
   * @param options
   */
  statements(
    db: number,
    sql: string,
    options?: SQLitePrepareOptions,
  ): Iterable<number>

  /**
   * Evaluate an SQL statement
   * @see https://www.sqlite.org/c3ref/step.html
   * @param stmt prepared statement pointer
   * @returns Promise resolving to `SQLITE_ROW` or `SQLITE_DONE`
   * (rejects on error)
   */
  step(stmt: number): number

  /**
   * Register an update hook
   *
   * The callback is invoked whenever a row is updated, inserted, or deleted
   * in a rowid table on this connection.
   * @see https://www.sqlite.org/c3ref/update_hook.html
   *
   * updateType is one of:
   * - SQLITE_DELETE: 9
   * - SQLITE_INSERT: 18
   * - SQLITE_UPDATE: 23
   * @see https://www.sqlite.org/c3ref/c_alter_table.html
   *
   * @param db database pointer
   * @param callback
   */
  update_hook(
    db: number,
    callback: (
      updateType: number,
      dbName: string | null,
      tblName: string | null,
      rowid: bigint,
    ) => void,
  ): void

  /**
   * Extract a value from `sqlite3_value`
   *
   * This is a convenience function that calls the appropriate `value_*`
   * function based on its type. Note that if the value is a blob then as
   * with `value_blob` the result may be invalid after the next SQLite call.
   *
   * Integer values are returned as Number if within the min/max safe
   * integer bounds, otherwise they are returned as BigInt.
   * @param pValue `sqlite3_value` pointer
   * @returns value
   */
  value(pValue: number): SQLiteCompatibleType

  /**
   * Extract a value from `sqlite3_value`
   *
   * The contents of the returned buffer may be invalid after the
   * next SQLite call. Make a copy of the data (e.g. with `.slice()`)
   * if longer retention is required.
   * @see https://sqlite.org/c3ref/value_blob.html
   * @param pValue `sqlite3_value` pointer
   * @returns value
   */
  value_blob(pValue: number): Uint8Array

  /**
   * Get blob or text size for value
   * @see https://sqlite.org/c3ref/value_blob.html
   * @param pValue `sqlite3_value` pointer
   * @returns size
   */
  value_bytes(pValue: number): number

  /**
   * Extract a value from `sqlite3_value`
   * @see https://sqlite.org/c3ref/value_blob.html
   * @param pValue `sqlite3_value` pointer
   * @returns value
   */
  value_double(pValue: number): number

  /**
   * Extract a value from `sqlite3_value`
   * @see https://sqlite.org/c3ref/value_blob.html
   * @param pValue `sqlite3_value` pointer
   * @returns value
   */
  value_int(pValue: number): number

  /**
   * Extract a value from `sqlite3_value`
   * @see https://sqlite.org/c3ref/value_blob.html
   * @param pValue `sqlite3_value` pointer
   * @returns value
   */
  value_int64(pValue: number): bigint

  /**
   * Extract a value from `sqlite3_value`
   * @see https://sqlite.org/c3ref/value_blob.html
   * @param pValue `sqlite3_value` pointer
   * @returns value
   */
  value_text(pValue: number): string

  /**
   * Get type of `sqlite3_value`
   * @see https://sqlite.org/c3ref/value_blob.html
   * @param pValue `sqlite3_value` pointer
   * @returns enumeration value for type
   */
  value_type(pValue: number): number

  /**
   * Register a new Virtual File System.
   *
   * @see https://www.sqlite.org/c3ref/vfs_find.html
   * @param vfs VFS object
   * @param makeDefault
   * @returns `SQLITE_OK` (throws exception on error)
   */
  vfs_register(vfs: SQLiteVFS, makeDefault?: boolean): number
}

/** @ignore */
declare module "@effect/wa-sqlite/src/sqlite-constants.js" {
  export const SQLITE_OK: 0
  export const SQLITE_ERROR: 1
  export const SQLITE_INTERNAL: 2
  export const SQLITE_PERM: 3
  export const SQLITE_ABORT: 4
  export const SQLITE_BUSY: 5
  export const SQLITE_LOCKED: 6
  export const SQLITE_NOMEM: 7
  export const SQLITE_READONLY: 8
  export const SQLITE_INTERRUPT: 9
  export const SQLITE_IOERR: 10
  export const SQLITE_CORRUPT: 11
  export const SQLITE_NOTFOUND: 12
  export const SQLITE_FULL: 13
  export const SQLITE_CANTOPEN: 14
  export const SQLITE_PROTOCOL: 15
  export const SQLITE_EMPTY: 16
  export const SQLITE_SCHEMA: 17
  export const SQLITE_TOOBIG: 18
  export const SQLITE_CONSTRAINT: 19
  export const SQLITE_MISMATCH: 20
  export const SQLITE_MISUSE: 21
  export const SQLITE_NOLFS: 22
  export const SQLITE_AUTH: 23
  export const SQLITE_FORMAT: 24
  export const SQLITE_RANGE: 25
  export const SQLITE_NOTADB: 26
  export const SQLITE_NOTICE: 27
  export const SQLITE_WARNING: 28
  export const SQLITE_ROW: 100
  export const SQLITE_DONE: 101
  export const SQLITE_IOERR_ACCESS: 3338
  export const SQLITE_IOERR_CHECKRESERVEDLOCK: 3594
  export const SQLITE_IOERR_CLOSE: 4106
  export const SQLITE_IOERR_DATA: 8202
  export const SQLITE_IOERR_DELETE: 2570
  export const SQLITE_IOERR_DELETE_NOENT: 5898
  export const SQLITE_IOERR_DIR_FSYNC: 1290
  export const SQLITE_IOERR_FSTAT: 1802
  export const SQLITE_IOERR_FSYNC: 1034
  export const SQLITE_IOERR_GETTEMPPATH: 6410
  export const SQLITE_IOERR_LOCK: 3850
  export const SQLITE_IOERR_NOMEM: 3082
  export const SQLITE_IOERR_READ: 266
  export const SQLITE_IOERR_RDLOCK: 2314
  export const SQLITE_IOERR_SEEK: 5642
  export const SQLITE_IOERR_SHORT_READ: 522
  export const SQLITE_IOERR_TRUNCATE: 1546
  export const SQLITE_IOERR_UNLOCK: 2058
  export const SQLITE_IOERR_VNODE: 6922
  export const SQLITE_IOERR_WRITE: 778
  export const SQLITE_IOERR_BEGIN_ATOMIC: 7434
  export const SQLITE_IOERR_COMMIT_ATOMIC: 7690
  export const SQLITE_IOERR_ROLLBACK_ATOMIC: 7946
  export const SQLITE_CONSTRAINT_CHECK: 275
  export const SQLITE_CONSTRAINT_COMMITHOOK: 531
  export const SQLITE_CONSTRAINT_FOREIGNKEY: 787
  export const SQLITE_CONSTRAINT_FUNCTION: 1043
  export const SQLITE_CONSTRAINT_NOTNULL: 1299
  export const SQLITE_CONSTRAINT_PINNED: 2835
  export const SQLITE_CONSTRAINT_PRIMARYKEY: 1555
  export const SQLITE_CONSTRAINT_ROWID: 2579
  export const SQLITE_CONSTRAINT_TRIGGER: 1811
  export const SQLITE_CONSTRAINT_UNIQUE: 2067
  export const SQLITE_CONSTRAINT_VTAB: 2323
  export const SQLITE_OPEN_READONLY: 1
  export const SQLITE_OPEN_READWRITE: 2
  export const SQLITE_OPEN_CREATE: 4
  export const SQLITE_OPEN_DELETEONCLOSE: 8
  export const SQLITE_OPEN_EXCLUSIVE: 16
  export const SQLITE_OPEN_AUTOPROXY: 32
  export const SQLITE_OPEN_URI: 64
  export const SQLITE_OPEN_MEMORY: 128
  export const SQLITE_OPEN_MAIN_DB: 256
  export const SQLITE_OPEN_TEMP_DB: 512
  export const SQLITE_OPEN_TRANSIENT_DB: 1024
  export const SQLITE_OPEN_MAIN_JOURNAL: 2048
  export const SQLITE_OPEN_TEMP_JOURNAL: 4096
  export const SQLITE_OPEN_SUBJOURNAL: 8192
  export const SQLITE_OPEN_SUPER_JOURNAL: 16384
  export const SQLITE_OPEN_NOMUTEX: 32768
  export const SQLITE_OPEN_FULLMUTEX: 65536
  export const SQLITE_OPEN_SHAREDCACHE: 131072
  export const SQLITE_OPEN_PRIVATECACHE: 262144
  export const SQLITE_OPEN_WAL: 524288
  export const SQLITE_OPEN_NOFOLLOW: 16777216
  export const SQLITE_LOCK_NONE: 0
  export const SQLITE_LOCK_SHARED: 1
  export const SQLITE_LOCK_RESERVED: 2
  export const SQLITE_LOCK_PENDING: 3
  export const SQLITE_LOCK_EXCLUSIVE: 4
  export const SQLITE_IOCAP_ATOMIC: 1
  export const SQLITE_IOCAP_ATOMIC512: 2
  export const SQLITE_IOCAP_ATOMIC1K: 4
  export const SQLITE_IOCAP_ATOMIC2K: 8
  export const SQLITE_IOCAP_ATOMIC4K: 16
  export const SQLITE_IOCAP_ATOMIC8K: 32
  export const SQLITE_IOCAP_ATOMIC16K: 64
  export const SQLITE_IOCAP_ATOMIC32K: 128
  export const SQLITE_IOCAP_ATOMIC64K: 256
  export const SQLITE_IOCAP_SAFE_APPEND: 512
  export const SQLITE_IOCAP_SEQUENTIAL: 1024
  export const SQLITE_IOCAP_UNDELETABLE_WHEN_OPEN: 2048
  export const SQLITE_IOCAP_POWERSAFE_OVERWRITE: 4096
  export const SQLITE_IOCAP_IMMUTABLE: 8192
  export const SQLITE_IOCAP_BATCH_ATOMIC: 16384
  export const SQLITE_ACCESS_EXISTS: 0
  export const SQLITE_ACCESS_READWRITE: 1
  export const SQLITE_ACCESS_READ: 2
  export const SQLITE_FCNTL_LOCKSTATE: 1
  export const SQLITE_FCNTL_GET_LOCKPROXYFILE: 2
  export const SQLITE_FCNTL_SET_LOCKPROXYFILE: 3
  export const SQLITE_FCNTL_LAST_ERRNO: 4
  export const SQLITE_FCNTL_SIZE_HINT: 5
  export const SQLITE_FCNTL_CHUNK_SIZE: 6
  export const SQLITE_FCNTL_FILE_POINTER: 7
  export const SQLITE_FCNTL_SYNC_OMITTED: 8
  export const SQLITE_FCNTL_WIN32_AV_RETRY: 9
  export const SQLITE_FCNTL_PERSIST_WAL: 10
  export const SQLITE_FCNTL_OVERWRITE: 11
  export const SQLITE_FCNTL_VFSNAME: 12
  export const SQLITE_FCNTL_POWERSAFE_OVERWRITE: 13
  export const SQLITE_FCNTL_PRAGMA: 14
  export const SQLITE_FCNTL_BUSYHANDLER: 15
  export const SQLITE_FCNTL_TEMPFILENAME: 16
  export const SQLITE_FCNTL_MMAP_SIZE: 18
  export const SQLITE_FCNTL_TRACE: 19
  export const SQLITE_FCNTL_HAS_MOVED: 20
  export const SQLITE_FCNTL_SYNC: 21
  export const SQLITE_FCNTL_COMMIT_PHASETWO: 22
  export const SQLITE_FCNTL_WIN32_SET_HANDLE: 23
  export const SQLITE_FCNTL_WAL_BLOCK: 24
  export const SQLITE_FCNTL_ZIPVFS: 25
  export const SQLITE_FCNTL_RBU: 26
  export const SQLITE_FCNTL_VFS_POINTER: 27
  export const SQLITE_FCNTL_JOURNAL_POINTER: 28
  export const SQLITE_FCNTL_WIN32_GET_HANDLE: 29
  export const SQLITE_FCNTL_PDB: 30
  export const SQLITE_FCNTL_BEGIN_ATOMIC_WRITE: 31
  export const SQLITE_FCNTL_COMMIT_ATOMIC_WRITE: 32
  export const SQLITE_FCNTL_ROLLBACK_ATOMIC_WRITE: 33
  export const SQLITE_FCNTL_LOCK_TIMEOUT: 34
  export const SQLITE_FCNTL_DATA_VERSION: 35
  export const SQLITE_FCNTL_SIZE_LIMIT: 36
  export const SQLITE_FCNTL_CKPT_DONE: 37
  export const SQLITE_FCNTL_RESERVE_BYTES: 38
  export const SQLITE_FCNTL_CKPT_START: 39
  export const SQLITE_INTEGER: 1
  export const SQLITE_FLOAT: 2
  export const SQLITE_TEXT: 3
  export const SQLITE_BLOB: 4
  export const SQLITE_NULL: 5
  export const SQLITE_STATIC: 0
  export const SQLITE_TRANSIENT: -1
  export const SQLITE_UTF8: 1
  export const SQLITE_UTF16LE: 2
  export const SQLITE_UTF16BE: 3
  export const SQLITE_UTF16: 4
  export const SQLITE_INDEX_CONSTRAINT_EQ: 2
  export const SQLITE_INDEX_CONSTRAINT_GT: 4
  export const SQLITE_INDEX_CONSTRAINT_LE: 8
  export const SQLITE_INDEX_CONSTRAINT_LT: 16
  export const SQLITE_INDEX_CONSTRAINT_GE: 32
  export const SQLITE_INDEX_CONSTRAINT_MATCH: 64
  export const SQLITE_INDEX_CONSTRAINT_LIKE: 65
  export const SQLITE_INDEX_CONSTRAINT_GLOB: 66
  export const SQLITE_INDEX_CONSTRAINT_REGEXP: 67
  export const SQLITE_INDEX_CONSTRAINT_NE: 68
  export const SQLITE_INDEX_CONSTRAINT_ISNOT: 69
  export const SQLITE_INDEX_CONSTRAINT_ISNOTNULL: 70
  export const SQLITE_INDEX_CONSTRAINT_ISNULL: 71
  export const SQLITE_INDEX_CONSTRAINT_IS: 72
  export const SQLITE_INDEX_CONSTRAINT_FUNCTION: 150
  export const SQLITE_INDEX_SCAN_UNIQUE: 1
  export const SQLITE_DETERMINISTIC: 0x000000800
  export const SQLITE_DIRECTONLY: 0x000080000
  export const SQLITE_SUBTYPE: 0x000100000
  export const SQLITE_INNOCUOUS: 0x000200000
  export const SQLITE_SYNC_NORMAL: 0x00002
  export const SQLITE_SYNC_FULL: 0x00003
  export const SQLITE_SYNC_DATAONLY: 0x00010
  export const SQLITE_CREATE_INDEX: 1
  export const SQLITE_CREATE_TABLE: 2
  export const SQLITE_CREATE_TEMP_INDEX: 3
  export const SQLITE_CREATE_TEMP_TABLE: 4
  export const SQLITE_CREATE_TEMP_TRIGGER: 5
  export const SQLITE_CREATE_TEMP_VIEW: 6
  export const SQLITE_CREATE_TRIGGER: 7
  export const SQLITE_CREATE_VIEW: 8
  export const SQLITE_DELETE: 9
  export const SQLITE_DROP_INDEX: 10
  export const SQLITE_DROP_TABLE: 11
  export const SQLITE_DROP_TEMP_INDEX: 12
  export const SQLITE_DROP_TEMP_TABLE: 13
  export const SQLITE_DROP_TEMP_TRIGGER: 14
  export const SQLITE_DROP_TEMP_VIEW: 15
  export const SQLITE_DROP_TRIGGER: 16
  export const SQLITE_DROP_VIEW: 17
  export const SQLITE_INSERT: 18
  export const SQLITE_PRAGMA: 19
  export const SQLITE_READ: 20
  export const SQLITE_SELECT: 21
  export const SQLITE_TRANSACTION: 22
  export const SQLITE_UPDATE: 23
  export const SQLITE_ATTACH: 24
  export const SQLITE_DETACH: 25
  export const SQLITE_ALTER_TABLE: 26
  export const SQLITE_REINDEX: 27
  export const SQLITE_ANALYZE: 28
  export const SQLITE_CREATE_VTABLE: 29
  export const SQLITE_DROP_VTABLE: 30
  export const SQLITE_FUNCTION: 31
  export const SQLITE_SAVEPOINT: 32
  export const SQLITE_COPY: 0
  export const SQLITE_RECURSIVE: 33
  export const SQLITE_DENY: 1
  export const SQLITE_IGNORE: 2
  export const SQLITE_LIMIT_LENGTH: 0
  export const SQLITE_LIMIT_SQL_LENGTH: 1
  export const SQLITE_LIMIT_COLUMN: 2
  export const SQLITE_LIMIT_EXPR_DEPTH: 3
  export const SQLITE_LIMIT_COMPOUND_SELECT: 4
  export const SQLITE_LIMIT_VDBE_OP: 5
  export const SQLITE_LIMIT_FUNCTION_ARG: 6
  export const SQLITE_LIMIT_ATTACHED: 7
  export const SQLITE_LIMIT_LIKE_PATTERN_LENGTH: 8
  export const SQLITE_LIMIT_VARIABLE_NUMBER: 9
  export const SQLITE_LIMIT_TRIGGER_DEPTH: 10
  export const SQLITE_LIMIT_WORKER_THREADS: 11
  export const SQLITE_PREPARE_PERSISTENT: 0x01
  export const SQLITE_PREPARE_NORMALIZED: 0x02
  export const SQLITE_PREPARE_NO_VTAB: 0x04
}

declare module "@effect/wa-sqlite" {
  export * from "@effect/wa-sqlite/src/sqlite-constants.js"

  /**
   * @ignore
   * Builds a Javascript API from the Emscripten module. This API is still
   * low-level and closely corresponds to the C API exported by the module,
   * but differs in some specifics like throwing exceptions on errors.
   * @param {*} Module SQLite module
   * @returns {SQLiteAPI}
   */
  export function Factory(Module: any): SQLiteAPI

  export class SQLiteError extends Error {
    constructor(message: any, code: any)
    code: any
  }
}

/** @ignore */
declare module "@effect/wa-sqlite/dist/wa-sqlite.mjs" {
  function ModuleFactory(config?: object): Promise<any>
  export = ModuleFactory
}

/** @ignore */
declare module "@effect/wa-sqlite/dist/wa-sqlite-async.mjs" {
  function ModuleFactory(config?: object): Promise<any>
  export = ModuleFactory
}

/** @ignore */
declare module "@effect/wa-sqlite/src/VFS.js" {
  export * from "@effect/wa-sqlite/src/sqlite-constants.js"

  export class Base {
    mxPathName: number
    /**
     * @param {number} fileId
     * @returns {number}
     */
    xClose(fileId: number): number
    /**
     * @param {number} fileId
     * @param {Uint8Array} pData
     * @param {number} iOffset
     * @returns {number}
     */
    xRead(
      fileId: number,
      pData: {
        size: number
        value: Uint8Array
      },
      iOffset: number,
    ): number
    /**
     * @param {number} fileId
     * @param {Uint8Array} pData
     * @param {number} iOffset
     * @returns {number}
     */
    xWrite(
      fileId: number,
      pData: {
        size: number
        value: Uint8Array
      },
      iOffset: number,
    ): number
    /**
     * @param {number} fileId
     * @param {number} iSize
     * @returns {number}
     */
    xTruncate(fileId: number, iSize: number): number
    /**
     * @param {number} fileId
     * @param {*} flags
     * @returns {number}
     */
    xSync(fileId: number, flags: any): number
    /**
     * @param {number} fileId
     * @param {DataView} pSize64
     * @returns {number}
     */
    xFileSize(fileId: number, pSize64: DataView): number
    /**
     * @param {number} fileId
     * @param {number} flags
     * @returns {number}
     */
    xLock(fileId: number, flags: number): number
    /**
     * @param {number} fileId
     * @param {number} flags
     * @returns {number}
     */
    xUnlock(fileId: number, flags: number): number
    /**
     * @param {number} fileId
     * @param {DataView} pResOut
     * @returns {number}
     */
    xCheckReservedLock(fileId: number, pResOut: DataView): number
    /**
     * @param {number} fileId
     * @param {number} flags
     * @param {DataView} pArg
     * @returns {number}
     */
    xFileControl(fileId: number, flags: number, pArg: DataView): number
    /**
     * @param {number} fileId
     * @returns {number}
     */
    xSectorSize(fileId: number): number
    /**
     * @param {number} fileId
     * @returns {number}
     */
    xDeviceCharacteristics(fileId: number): number
    /**
     * @param {string?} name
     * @param {number} fileId
     * @param {number} flags
     * @param {DataView} pOutFlags
     * @returns {number}
     */
    xOpen(
      name: string | null,
      fileId: number,
      flags: number,
      pOutFlags: DataView,
    ): number
    /**
     *
     * @param {string} name
     * @param {number} syncDir
     * @returns {number}
     */
    xDelete(name: string, syncDir: number): number
    /**
     * @param {string} name
     * @param {number} flags
     * @param {DataView} pResOut
     * @returns {number}
     */
    xAccess(name: string, flags: number, pResOut: DataView): number
    /**
     * Handle asynchronous operation. This implementation will be overriden on
     * registration by an Asyncify build.
     * @param {function(): number} f
     * @returns {number}
     */
    handleAsync(f: () => number): number
  }
}

/** @ignore */
declare module "@effect/wa-sqlite/src/examples/IndexedDbVFS.js" {
  import * as VFS from "@effect/wa-sqlite/src/VFS.js"
  export class IndexedDbVFS extends VFS.Base {
    /**
     * @param {string} idbName Name of IndexedDB database.
     */
    constructor(idbName?: string)
    name: string
    mapIdToFile: Map<any, any>
    cacheSize: number
    db: any
    close(): void
    /**
     * Delete a file from IndexedDB.
     * @param {string} name
     */
    deleteFile(name: string): void
    /**
     * Forcibly clear an orphaned file lock.
     * @param {string} name
     */
    forceClearLock(name: string): void
    _getStore(mode?: string): any
    /**
     * Returns the key for file metadata.
     * @param {string} name
     * @returns
     */
    _metaKey(name: string): string
    /**
     * Returns the key for file block data.
     * @param {string} name
     * @param {number} index
     * @returns
     */
    _blockKey(name: string, index: number): string
    _getBlock(store: any, file: any, index: any): any
    _putBlock(store: any, file: any, index: any, blockData: any): void
    _purgeCache(store: any, file: any, size?: number): void
    _flushCache(store: any, file: any): void
    _sync(file: any): void
    /**
     * Helper function that deletes all keys greater or equal to `key`
     * provided they start with `prefix`.
     * @param {string} key
     * @param {string} [prefix]
     * @returns
     */
    _delete(key: string, prefix?: string): any
  }
}

/** @ignore */
declare module "@effect/wa-sqlite/src/examples/MemoryVFS.js" {
  import * as VFS from "@effect/wa-sqlite/src/VFS.js"
  /** @ignore */
  export class MemoryVFS extends VFS.Base {
    name: string
    mapNameToFile: Map<any, any>
    mapIdToFile: Map<any, any>
  }
}

/** @ignore */
declare module "@effect/wa-sqlite/src/examples/tag.js" {
  /**
   * @ignore
   * Template tag builder. This function creates a tag with an API and
   * database from the same module, then the tag can be used like this:
   * ```
   * const sql = tag(sqlite3, db);
   * const results = await sql`
   *   SELECT 1 + 1;
   *   SELECT 6 * 7;
   * `;
   * ```
   * The returned Promise value contains an array of results for each
   * SQL statement that produces output. Each result is an object with
   * properties `columns` (array of names) and `rows` (array of array
   * of values).
   * @param {SQLiteAPI} sqlite3
   * @param {number} db
   * @returns {function(TemplateStringsArray, ...any): Promise<object[]>}
   */
  export function tag(
    sqlite3: any,
    db: number,
  ): (arg0: TemplateStringsArray, ...args: any[]) => object[]
}