expo-sqlite 15.2.8 → 15.2.10

package/CHANGELOG.md

@@ -10,6 +10,21 @@
 
 ### 💡 Others
 
+## 15.2.10 — 2025-05-08
+
+### 🐛 Bug fixes
+
+- Fixed parallel issue for `Statement.executeAsync`. ([#36674](https://github.com/expo/expo/pull/36674) by [@kudo](https://github.com/kudo))
+
+### 💡 Others
+
+- Avoided synchronous API calls for `kv-store`. ([#36669](https://github.com/expo/expo/pull/36669) by [@kudo](https://github.com/kudo))
+- Improved synchronous APIs on web. ([#36670](https://github.com/expo/expo/pull/36670) by [@kudo](https://github.com/kudo))
+
+## 15.2.9 — 2025-04-30
+
+_This version does not introduce any user-facing changes._
+
 ## 15.2.8 — 2025-04-30
 
 ### 📚 3rd party library updates

package/android/build.gradle

@@ -45,13 +45,13 @@ def reactNativeArchitectures() {
 }
 
 group = 'host.exp.exponent'
-version = '15.2.8'
+version = '15.2.10'
 
 android {
   namespace "expo.modules.sqlite"
   defaultConfig {
     versionCode 18
-    versionName "15.2.8"
+    versionName "15.2.10"
     buildConfigField "boolean", "USE_LIBSQL", project.ext.USE_LIBSQL.toString()
 
     externalNativeBuild {

package/android/src/main/java/expo/modules/sqlite/SQLiteModule.kt

@@ -367,44 +367,49 @@ class SQLiteModule : Module() {
   private fun run(statement: NativeStatement, database: NativeDatabase, bindParams: Map<String, Any>, bindBlobParams: Map<String, ByteArray>, shouldPassAsArray: Boolean): Map<String, Any> {
     maybeThrowForClosedDatabase(database)
     maybeThrowForFinalizedStatement(statement)
-    statement.ref.sqlite3_reset()
-    statement.ref.sqlite3_clear_bindings()
-    for ((key, param) in bindParams) {
-      val index = getBindParamIndex(statement, key, shouldPassAsArray)
-      if (index > 0) {
-        // expo-modules-core AnyTypeConverter casts JavaScript Number to Kotlin Double,
-        // here to cast as Long if the value is an integer.
-        val normalizedParam =
-          if (param is Double && param.toDouble() % 1.0 == 0.0) {
-            param.toLong()
-          } else {
-            param
-          }
-        statement.ref.bindStatementParam(index, normalizedParam)
+
+    // The statement with parameter bindings is stateful,
+    // we have to guard with a critical section for thread safety.
+    synchronized(statement) {
+      statement.ref.sqlite3_reset()
+      statement.ref.sqlite3_clear_bindings()
+      for ((key, param) in bindParams) {
+        val index = getBindParamIndex(statement, key, shouldPassAsArray)
+        if (index > 0) {
+          // expo-modules-core AnyTypeConverter casts JavaScript Number to Kotlin Double,
+          // here to cast as Long if the value is an integer.
+          val normalizedParam =
+            if (param is Double && param.toDouble() % 1.0 == 0.0) {
+              param.toLong()
+            } else {
+              param
+            }
+          statement.ref.bindStatementParam(index, normalizedParam)
+        }
       }
-    }
-    for ((key, param) in bindBlobParams) {
-      val index = getBindParamIndex(statement, key, shouldPassAsArray)
-      if (index > 0) {
-        statement.ref.bindStatementParam(index, param)
+      for ((key, param) in bindBlobParams) {
+        val index = getBindParamIndex(statement, key, shouldPassAsArray)
+        if (index > 0) {
+          statement.ref.bindStatementParam(index, param)
+        }
       }
-    }
 
-    val ret = statement.ref.sqlite3_step()
-    if (ret != NativeDatabaseBinding.SQLITE_ROW && ret != NativeDatabaseBinding.SQLITE_DONE) {
-      throw SQLiteErrorException(database.ref.convertSqlLiteErrorToString())
-    }
-    val firstRowValues: SQLiteColumnValues =
-      if (ret == NativeDatabaseBinding.SQLITE_ROW) {
-        statement.ref.getColumnValues()
-      } else {
-        arrayListOf()
+      val ret = statement.ref.sqlite3_step()
+      if (ret != NativeDatabaseBinding.SQLITE_ROW && ret != NativeDatabaseBinding.SQLITE_DONE) {
+        throw SQLiteErrorException(database.ref.convertSqlLiteErrorToString())
       }
-    return mapOf(
-      "lastInsertRowId" to database.ref.sqlite3_last_insert_rowid().toInt(),
-      "changes" to database.ref.sqlite3_changes(),
-      "firstRowValues" to firstRowValues
-    )
+      val firstRowValues: SQLiteColumnValues =
+        if (ret == NativeDatabaseBinding.SQLITE_ROW) {
+          statement.ref.getColumnValues()
+        } else {
+          arrayListOf()
+        }
+      return mapOf(
+        "lastInsertRowId" to database.ref.sqlite3_last_insert_rowid().toInt(),
+        "changes" to database.ref.sqlite3_changes(),
+        "firstRowValues" to firstRowValues
+      )
+    }
   }
 
   @Throws(AccessClosedResourceException::class, InvalidConvertibleException::class, SQLiteErrorException::class)

package/build/Storage.d.ts

@@ -1,7 +1,3 @@
-/**
- * @hidden
- */
-export declare function checkValidInput(...input: unknown[]): void;
 /**
  * Update function for the [`setItemAsync()`](#setitemasynckey-value) or [`setItemSync()`](#setitemsynckey-value) method. It computes the new value based on the previous value. The function returns the new value to set for the key.
  * @param prevValue The previous value associated with the key, or `null` if the key was not set.
@@ -14,6 +10,7 @@ export type SQLiteStorageSetItemUpdateFunction = (prevValue: string | null) => s
 export declare class SQLiteStorage {
     private readonly databaseName;
     private db;
+    private readonly awaitLock;
     constructor(databaseName: string);
     /**
      * Retrieves the value associated with the given key asynchronously.
@@ -111,12 +108,15 @@ export declare class SQLiteStorage {
      * Alias for [`closeAsync()`](#closeasync-1) method.
      */
     close(): Promise<void>;
+    private getDbAsync;
     private getDbSync;
+    private maybeMigrateDbAsync;
     private maybeMigrateDbSync;
     /**
      * Recursively merge two JSON objects.
      */
     private static mergeDeep;
+    private checkValidInput;
 }
 /**
  * This default instance of the [`SQLiteStorage`](#sqlitestorage-1) class is used as a drop-in replacement for the `AsyncStorage` module from [`@react-native-async-storage/async-storage`](https://github.com/react-native-async-storage/async-storage).

package/build/Storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../src/Storage.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAclD;AAED;;;;GAIG;AACH,MAAM,MAAM,kCAAkC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAC;AAatF;;GAEG;AACH,qBAAa,aAAa;IAGZ,OAAO,CAAC,QAAQ,CAAC,YAAY;IAFzC,OAAO,CAAC,EAAE,CAA+B;gBAEZ,YAAY,EAAE,MAAM;IAIjD;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAOvD;;;OAGG;IACG,YAAY,CAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,kCAAkC,GACjD,OAAO,CAAC,IAAI,CAAC;IAkBhB;;OAEG;IACG,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOpD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAM1C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAMpC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOvC;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,kCAAkC,GAAG,IAAI;IAkBlF;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAOpC;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAM1B;;OAEG;IACH,SAAS,IAAI,OAAO;IAMpB;;OAEG;IACH,SAAS,IAAI,IAAI;IAWjB;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIlD;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,kCAAkC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7F;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIrC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;OAGG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1D;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IASlE;;OAEG;IACG,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhE;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhD;;;OAGG;IACG,UAAU,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBlE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;CA4BzB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,eAAyC,CAAC;AAEnE,eAAe,YAAY,CAAC;AAE5B;;GAEG;AACH,eAAO,MAAM,OAAO,eAAe,CAAC"}
+{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../src/Storage.ts"],"names":[],"mappings":"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"}

package/build/Storage.js

@@ -1,16 +1,5 @@
-import { openDatabaseSync } from './index';
-/**
- * @hidden
- */
-export function checkValidInput(...input) {
-    const [key, value] = input;
-    if (typeof key !== 'string') {
-        throw new Error(`[SQLiteStorage] Using ${typeof key} type for key is not supported. Use string instead. Key passed: ${key}`);
-    }
-    if (input.length > 1 && typeof value !== 'string' && typeof value !== 'function') {
-        throw new Error(`[SQLiteStorage] Using ${typeof value} type for value is not supported. Use string instead. Key passed: ${key}. Value passed : ${value}`);
-    }
-}
+import AwaitLock from 'await-lock';
+import { openDatabaseAsync, openDatabaseSync } from './index';
 const DATABASE_VERSION = 1;
 const STATEMENT_GET = 'SELECT value FROM storage WHERE key = ?;';
 const STATEMENT_SET = 'INSERT INTO storage (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value;';
@@ -24,6 +13,7 @@ const MIGRATION_STATEMENT_0 = 'CREATE TABLE IF NOT EXISTS storage (key TEXT PRIM
 export class SQLiteStorage {
     databaseName;
     db = null;
+    awaitLock = new AwaitLock();
     constructor(databaseName) {
         this.databaseName = databaseName;
     }
@@ -32,8 +22,8 @@ export class SQLiteStorage {
      * Retrieves the value associated with the given key asynchronously.
      */
     async getItemAsync(key) {
-        checkValidInput(key);
-        const db = this.getDbSync();
+        this.checkValidInput(key);
+        const db = await this.getDbAsync();
         const result = await db.getFirstAsync(STATEMENT_GET, key);
         return result?.value ?? null;
     }
@@ -42,14 +32,14 @@ export class SQLiteStorage {
      * If a function is provided, it computes the new value based on the previous value.
      */
     async setItemAsync(key, value) {
-        checkValidInput(key, value);
-        const db = this.getDbSync();
+        this.checkValidInput(key, value);
+        const db = await this.getDbAsync();
         if (typeof value === 'function') {
             await db.withExclusiveTransactionAsync(async (tx) => {
                 const prevResult = await tx.getFirstAsync(STATEMENT_GET, key);
                 const prevValue = prevResult?.value ?? null;
                 const nextValue = value(prevValue);
-                checkValidInput(key, nextValue);
+                this.checkValidInput(key, nextValue);
                 await tx.runAsync(STATEMENT_SET, key, nextValue);
             });
             return;
@@ -60,8 +50,8 @@ export class SQLiteStorage {
      * Removes the value associated with the given key asynchronously.
      */
     async removeItemAsync(key) {
-        checkValidInput(key);
-        const db = this.getDbSync();
+        this.checkValidInput(key);
+        const db = await this.getDbAsync();
         const result = await db.runAsync(STATEMENT_REMOVE, key);
         return result.changes > 0;
     }
@@ -69,7 +59,7 @@ export class SQLiteStorage {
      * Retrieves all keys stored in the storage asynchronously.
      */
     async getAllKeysAsync() {
-        const db = this.getDbSync();
+        const db = await this.getDbAsync();
         const result = await db.getAllAsync(STATEMENT_GET_ALL_KEYS);
         return result.map(({ key }) => key);
     }
@@ -77,7 +67,7 @@ export class SQLiteStorage {
      * Clears all key-value pairs from the storage asynchronously.
      */
     async clearAsync() {
-        const db = this.getDbSync();
+        const db = await this.getDbAsync();
         const result = await db.runAsync(STATEMENT_CLEAR);
         return result.changes > 0;
     }
@@ -85,9 +75,15 @@ export class SQLiteStorage {
      * Closes the database connection asynchronously.
      */
     async closeAsync() {
-        if (this.db) {
-            await this.db.closeAsync();
-            this.db = null;
+        await this.awaitLock.acquireAsync();
+        try {
+            if (this.db) {
+                await this.db.closeAsync();
+                this.db = null;
+            }
+        }
+        finally {
+            this.awaitLock.release();
         }
     }
     //#endregion
@@ -96,7 +92,7 @@ export class SQLiteStorage {
      * Retrieves the value associated with the given key synchronously.
      */
     getItemSync(key) {
-        checkValidInput(key);
+        this.checkValidInput(key);
         const db = this.getDbSync();
         const result = db.getFirstSync(STATEMENT_GET, key);
         return result?.value ?? null;
@@ -106,14 +102,14 @@ export class SQLiteStorage {
      * If a function is provided, it computes the new value based on the previous value.
      */
     setItemSync(key, value) {
-        checkValidInput(key, value);
+        this.checkValidInput(key, value);
         const db = this.getDbSync();
         if (typeof value === 'function') {
             db.withTransactionSync(() => {
                 const prevResult = db.getFirstSync(STATEMENT_GET, key);
                 const prevValue = prevResult?.value ?? null;
                 const nextValue = value(prevValue);
-                checkValidInput(key, nextValue);
+                this.checkValidInput(key, nextValue);
                 db.runSync(STATEMENT_SET, key, nextValue);
             });
             return;
@@ -124,7 +120,7 @@ export class SQLiteStorage {
      * Removes the value associated with the given key synchronously.
      */
     removeItemSync(key) {
-        checkValidInput(key);
+        this.checkValidInput(key);
         const db = this.getDbSync();
         const result = db.runSync(STATEMENT_REMOVE, key);
         return result.changes > 0;
@@ -191,7 +187,7 @@ export class SQLiteStorage {
      * If the existing value is a JSON object, performs a deep merge.
      */
     async mergeItem(key, value) {
-        checkValidInput(key, value);
+        this.checkValidInput(key, value);
         await this.setItemAsync(key, (prevValue) => {
             if (prevValue == null) {
                 return value;
@@ -207,7 +203,7 @@ export class SQLiteStorage {
      */
     async multiGet(keys) {
         return Promise.all(keys.map(async (key) => {
-            checkValidInput(key);
+            this.checkValidInput(key);
             return [key, await this.getItemAsync(key)];
         }));
     }
@@ -215,10 +211,10 @@ export class SQLiteStorage {
      * Sets multiple key-value pairs asynchronously.
      */
     async multiSet(keyValuePairs) {
-        const db = this.getDbSync();
+        const db = await this.getDbAsync();
         await db.withExclusiveTransactionAsync(async (tx) => {
             for (const [key, value] of keyValuePairs) {
-                checkValidInput(key, value);
+                this.checkValidInput(key, value);
                 await tx.runAsync(STATEMENT_SET, key, value);
             }
         });
@@ -227,10 +223,10 @@ export class SQLiteStorage {
      * Removes the values associated with the given keys asynchronously.
      */
     async multiRemove(keys) {
-        const db = this.getDbSync();
+        const db = await this.getDbAsync();
         await db.withExclusiveTransactionAsync(async (tx) => {
             for (const key of keys) {
-                checkValidInput(key);
+                this.checkValidInput(key);
                 await tx.runAsync(STATEMENT_REMOVE, key);
             }
         });
@@ -240,10 +236,10 @@ export class SQLiteStorage {
      * If existing values are JSON objects, performs a deep merge.
      */
     async multiMerge(keyValuePairs) {
-        const db = this.getDbSync();
+        const db = await this.getDbAsync();
         await db.withExclusiveTransactionAsync(async (tx) => {
             for (const [key, value] of keyValuePairs) {
-                checkValidInput(key, value);
+                this.checkValidInput(key, value);
                 const prevValue = await tx.getFirstAsync(STATEMENT_GET, key);
                 if (prevValue == null) {
                     await tx.runAsync(STATEMENT_SET, key, value);
@@ -264,6 +260,20 @@ export class SQLiteStorage {
     }
     //#endregion
     //#region Internals
+    async getDbAsync() {
+        await this.awaitLock.acquireAsync();
+        try {
+            if (!this.db) {
+                const db = await openDatabaseAsync(this.databaseName);
+                await this.maybeMigrateDbAsync(db);
+                this.db = db;
+            }
+        }
+        finally {
+            this.awaitLock.release();
+        }
+        return this.db;
+    }
     getDbSync() {
         if (!this.db) {
             const db = openDatabaseSync(this.databaseName);
@@ -272,6 +282,20 @@ export class SQLiteStorage {
         }
         return this.db;
     }
+    maybeMigrateDbAsync(db) {
+        return db.withTransactionAsync(async () => {
+            const result = await db.getFirstAsync('PRAGMA user_version');
+            let currentDbVersion = result?.user_version ?? 0;
+            if (currentDbVersion >= DATABASE_VERSION) {
+                return;
+            }
+            if (currentDbVersion === 0) {
+                await db.execAsync(MIGRATION_STATEMENT_0);
+                currentDbVersion = 1;
+            }
+            await db.execAsync(`PRAGMA user_version = ${DATABASE_VERSION}`);
+        });
+    }
     maybeMigrateDbSync(db) {
         db.withTransactionSync(() => {
             const result = db.getFirstSync('PRAGMA user_version');
@@ -313,6 +337,15 @@ export class SQLiteStorage {
         }
         return output;
     }
+    checkValidInput(...input) {
+        const [key, value] = input;
+        if (typeof key !== 'string') {
+            throw new Error(`[SQLiteStorage] Using ${typeof key} type for key is not supported. Use string instead. Key passed: ${key}`);
+        }
+        if (input.length > 1 && typeof value !== 'string' && typeof value !== 'function') {
+            throw new Error(`[SQLiteStorage] Using ${typeof value} type for value is not supported. Use string instead. Key passed: ${key}. Value passed : ${value}`);
+        }
+    }
 }
 /**
  * This default instance of the [`SQLiteStorage`](#sqlitestorage-1) class is used as a drop-in replacement for the `AsyncStorage` module from [`@react-native-async-storage/async-storage`](https://github.com/react-native-async-storage/async-storage).

package/build/Storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"Storage.js","sourceRoot":"","sources":["../src/Storage.ts"],"names":[],"mappings":"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","sourcesContent":["import { openDatabaseSync, type SQLiteDatabase } from './index';\n\n/**\n * @hidden\n */\nexport function checkValidInput(...input: unknown[]) {\n  const [key, value] = input;\n\n  if (typeof key !== 'string') {\n    throw new Error(\n      `[SQLiteStorage] Using ${typeof key} type for key is not supported. Use string instead. Key passed: ${key}`\n    );\n  }\n\n  if (input.length > 1 && typeof value !== 'string' && typeof value !== 'function') {\n    throw new Error(\n      `[SQLiteStorage] Using ${typeof value} type for value is not supported. Use string instead. Key passed: ${key}. Value passed : ${value}`\n    );\n  }\n}\n\n/**\n * Update function for the [`setItemAsync()`](#setitemasynckey-value) or [`setItemSync()`](#setitemsynckey-value) method. It computes the new value based on the previous value. The function returns the new value to set for the key.\n * @param prevValue The previous value associated with the key, or `null` if the key was not set.\n * @returns The new value to set for the key.\n */\nexport type SQLiteStorageSetItemUpdateFunction = (prevValue: string | null) => string;\n\nconst DATABASE_VERSION = 1;\nconst STATEMENT_GET = 'SELECT value FROM storage WHERE key = ?;';\nconst STATEMENT_SET =\n  'INSERT INTO storage (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value;';\nconst STATEMENT_REMOVE = 'DELETE FROM storage WHERE key = ?;';\nconst STATEMENT_GET_ALL_KEYS = 'SELECT key FROM storage;';\nconst STATEMENT_CLEAR = 'DELETE FROM storage;';\n\nconst MIGRATION_STATEMENT_0 =\n  'CREATE TABLE IF NOT EXISTS storage (key TEXT PRIMARY KEY NOT NULL, value TEXT);';\n\n/**\n * Key-value store backed by SQLite. This class accepts a `databaseName` parameter in its constructor, which is the name of the database file to use for the storage.\n */\nexport class SQLiteStorage {\n  private db: SQLiteDatabase | null = null;\n\n  constructor(private readonly databaseName: string) {}\n\n  //#region Asynchronous API\n\n  /**\n   * Retrieves the value associated with the given key asynchronously.\n   */\n  async getItemAsync(key: string): Promise<string | null> {\n    checkValidInput(key);\n    const db = this.getDbSync();\n    const result = await db.getFirstAsync<{ value: string }>(STATEMENT_GET, key);\n    return result?.value ?? null;\n  }\n\n  /**\n   * Sets the value for the given key asynchronously.\n   * If a function is provided, it computes the new value based on the previous value.\n   */\n  async setItemAsync(\n    key: string,\n    value: string | SQLiteStorageSetItemUpdateFunction\n  ): Promise<void> {\n    checkValidInput(key, value);\n    const db = this.getDbSync();\n\n    if (typeof value === 'function') {\n      await db.withExclusiveTransactionAsync(async (tx) => {\n        const prevResult = await tx.getFirstAsync<{ value: string }>(STATEMENT_GET, key);\n        const prevValue = prevResult?.value ?? null;\n        const nextValue = value(prevValue);\n        checkValidInput(key, nextValue);\n        await tx.runAsync(STATEMENT_SET, key, nextValue);\n      });\n      return;\n    }\n\n    await db.runAsync(STATEMENT_SET, key, value);\n  }\n\n  /**\n   * Removes the value associated with the given key asynchronously.\n   */\n  async removeItemAsync(key: string): Promise<boolean> {\n    checkValidInput(key);\n    const db = this.getDbSync();\n    const result = await db.runAsync(STATEMENT_REMOVE, key);\n    return result.changes > 0;\n  }\n\n  /**\n   * Retrieves all keys stored in the storage asynchronously.\n   */\n  async getAllKeysAsync(): Promise<string[]> {\n    const db = this.getDbSync();\n    const result = await db.getAllAsync<{ key: string }>(STATEMENT_GET_ALL_KEYS);\n    return result.map(({ key }) => key);\n  }\n\n  /**\n   * Clears all key-value pairs from the storage asynchronously.\n   */\n  async clearAsync(): Promise<boolean> {\n    const db = this.getDbSync();\n    const result = await db.runAsync(STATEMENT_CLEAR);\n    return result.changes > 0;\n  }\n\n  /**\n   * Closes the database connection asynchronously.\n   */\n  async closeAsync(): Promise<void> {\n    if (this.db) {\n      await this.db.closeAsync();\n      this.db = null;\n    }\n  }\n\n  //#endregion\n\n  //#region Synchronous API\n\n  /**\n   * Retrieves the value associated with the given key synchronously.\n   */\n  getItemSync(key: string): string | null {\n    checkValidInput(key);\n    const db = this.getDbSync();\n    const result = db.getFirstSync<{ value: string }>(STATEMENT_GET, key);\n    return result?.value ?? null;\n  }\n\n  /**\n   * Sets the value for the given key synchronously.\n   * If a function is provided, it computes the new value based on the previous value.\n   */\n  setItemSync(key: string, value: string | SQLiteStorageSetItemUpdateFunction): void {\n    checkValidInput(key, value);\n    const db = this.getDbSync();\n\n    if (typeof value === 'function') {\n      db.withTransactionSync(() => {\n        const prevResult = db.getFirstSync<{ value: string }>(STATEMENT_GET, key);\n        const prevValue = prevResult?.value ?? null;\n        const nextValue = value(prevValue);\n        checkValidInput(key, nextValue);\n        db.runSync(STATEMENT_SET, key, nextValue);\n      });\n      return;\n    }\n\n    db.runSync(STATEMENT_SET, key, value);\n  }\n\n  /**\n   * Removes the value associated with the given key synchronously.\n   */\n  removeItemSync(key: string): boolean {\n    checkValidInput(key);\n    const db = this.getDbSync();\n    const result = db.runSync(STATEMENT_REMOVE, key);\n    return result.changes > 0;\n  }\n\n  /**\n   * Retrieves all keys stored in the storage synchronously.\n   */\n  getAllKeysSync(): string[] {\n    const db = this.getDbSync();\n    const result = db.getAllSync<{ key: string }>(STATEMENT_GET_ALL_KEYS);\n    return result.map(({ key }) => key);\n  }\n\n  /**\n   * Clears all key-value pairs from the storage synchronously.\n   */\n  clearSync(): boolean {\n    const db = this.getDbSync();\n    const result = db.runSync(STATEMENT_CLEAR);\n    return result.changes > 0;\n  }\n\n  /**\n   * Closes the database connection synchronously.\n   */\n  closeSync(): void {\n    if (this.db) {\n      this.db.closeSync();\n      this.db = null;\n    }\n  }\n\n  //#endregion\n\n  //#region react-native-async-storage compatible API\n\n  /**\n   * Alias for [`getItemAsync()`](#getitemasynckey) method.\n   */\n  async getItem(key: string): Promise<string | null> {\n    return this.getItemAsync(key);\n  }\n\n  /**\n   * Alias for [`setItemAsync()`](#setitemasynckey-value).\n   */\n  async setItem(key: string, value: string | SQLiteStorageSetItemUpdateFunction): Promise<void> {\n    await this.setItemAsync(key, value);\n  }\n\n  /**\n   * Alias for [`removeItemAsync()`](#removeitemasynckey) method.\n   */\n  async removeItem(key: string): Promise<void> {\n    await this.removeItemAsync(key);\n  }\n\n  /**\n   * Alias for [`getAllKeysAsync()`](#getallkeysasync) method.\n   */\n  async getAllKeys(): Promise<string[]> {\n    return this.getAllKeysAsync();\n  }\n\n  /**\n   * Alias for [`clearAsync()`](#clearasync) method.\n   */\n  async clear(): Promise<void> {\n    await this.clearAsync();\n  }\n\n  /**\n   * Merges the given value with the existing value for the given key asynchronously.\n   * If the existing value is a JSON object, performs a deep merge.\n   */\n  async mergeItem(key: string, value: string): Promise<void> {\n    checkValidInput(key, value);\n    await this.setItemAsync(key, (prevValue) => {\n      if (prevValue == null) {\n        return value;\n      }\n      const prevJSON = JSON.parse(prevValue);\n      const newJSON = JSON.parse(value);\n      const mergedJSON = SQLiteStorage.mergeDeep(prevJSON, newJSON);\n      return JSON.stringify(mergedJSON);\n    });\n  }\n\n  /**\n   * Retrieves the values associated with the given keys asynchronously.\n   */\n  async multiGet(keys: string[]): Promise<[string, string | null][]> {\n    return Promise.all(\n      keys.map(async (key): Promise<[string, string | null]> => {\n        checkValidInput(key);\n        return [key, await this.getItemAsync(key)];\n      })\n    );\n  }\n\n  /**\n   * Sets multiple key-value pairs asynchronously.\n   */\n  async multiSet(keyValuePairs: [string, string][]): Promise<void> {\n    const db = this.getDbSync();\n    await db.withExclusiveTransactionAsync(async (tx) => {\n      for (const [key, value] of keyValuePairs) {\n        checkValidInput(key, value);\n        await tx.runAsync(STATEMENT_SET, key, value);\n      }\n    });\n  }\n\n  /**\n   * Removes the values associated with the given keys asynchronously.\n   */\n  async multiRemove(keys: string[]): Promise<void> {\n    const db = this.getDbSync();\n    await db.withExclusiveTransactionAsync(async (tx) => {\n      for (const key of keys) {\n        checkValidInput(key);\n        await tx.runAsync(STATEMENT_REMOVE, key);\n      }\n    });\n  }\n\n  /**\n   * Merges multiple key-value pairs asynchronously.\n   * If existing values are JSON objects, performs a deep merge.\n   */\n  async multiMerge(keyValuePairs: [string, string][]): Promise<void> {\n    const db = this.getDbSync();\n    await db.withExclusiveTransactionAsync(async (tx) => {\n      for (const [key, value] of keyValuePairs) {\n        checkValidInput(key, value);\n        const prevValue = await tx.getFirstAsync<{ value: string }>(STATEMENT_GET, key);\n        if (prevValue == null) {\n          await tx.runAsync(STATEMENT_SET, key, value);\n          continue;\n        }\n        const prevJSON = JSON.parse(prevValue.value);\n        const newJSON = JSON.parse(value);\n        const mergedJSON = SQLiteStorage.mergeDeep(prevJSON, newJSON);\n        await tx.runAsync(STATEMENT_SET, key, JSON.stringify(mergedJSON));\n      }\n    });\n  }\n\n  /**\n   * Alias for [`closeAsync()`](#closeasync-1) method.\n   */\n  async close(): Promise<void> {\n    await this.closeAsync();\n  }\n\n  //#endregion\n\n  //#region Internals\n\n  private getDbSync(): SQLiteDatabase {\n    if (!this.db) {\n      const db = openDatabaseSync(this.databaseName);\n      this.maybeMigrateDbSync(db);\n      this.db = db;\n    }\n    return this.db;\n  }\n\n  private maybeMigrateDbSync(db: SQLiteDatabase) {\n    db.withTransactionSync(() => {\n      const result = db.getFirstSync<{ user_version: number }>('PRAGMA user_version');\n      let currentDbVersion = result?.user_version ?? 0;\n      if (currentDbVersion >= DATABASE_VERSION) {\n        return;\n      }\n      if (currentDbVersion === 0) {\n        db.execSync(MIGRATION_STATEMENT_0);\n        currentDbVersion = 1;\n      }\n      db.execSync(`PRAGMA user_version = ${DATABASE_VERSION}`);\n    });\n  }\n\n  /**\n   * Recursively merge two JSON objects.\n   */\n  private static mergeDeep(target: any, source: any): any {\n    if (typeof target !== 'object' || target === null) {\n      return source;\n    }\n\n    if (typeof source !== 'object' || source === null) {\n      return target;\n    }\n\n    const output = { ...target };\n\n    for (const key of Object.keys(source)) {\n      if (source[key] instanceof Array) {\n        if (!output[key]) {\n          output[key] = [];\n        }\n        output[key] = output[key].concat(source[key]);\n      } else if (typeof source[key] === 'object') {\n        output[key] = this.mergeDeep(target[key], source[key]);\n      } else {\n        output[key] = source[key];\n      }\n    }\n\n    return output;\n  }\n\n  //#endregion\n}\n\n/**\n * This default instance of the [`SQLiteStorage`](#sqlitestorage-1) class is used as a drop-in replacement for the `AsyncStorage` module from [`@react-native-async-storage/async-storage`](https://github.com/react-native-async-storage/async-storage).\n */\nexport const AsyncStorage = new SQLiteStorage('ExpoSQLiteStorage');\n\nexport default AsyncStorage;\n\n/**\n * Alias for [`AsyncStorage`](#sqliteasyncstorage), given the storage not only offers asynchronous methods.\n */\nexport const Storage = AsyncStorage;\n"]}
+{"version":3,"file":"Storage.js","sourceRoot":"","sources":["../src/Storage.ts"],"names":[],"mappings":"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","sourcesContent":["import AwaitLock from 'await-lock';\n\nimport { openDatabaseAsync, openDatabaseSync, type SQLiteDatabase } from './index';\n\n/**\n * Update function for the [`setItemAsync()`](#setitemasynckey-value) or [`setItemSync()`](#setitemsynckey-value) method. It computes the new value based on the previous value. The function returns the new value to set for the key.\n * @param prevValue The previous value associated with the key, or `null` if the key was not set.\n * @returns The new value to set for the key.\n */\nexport type SQLiteStorageSetItemUpdateFunction = (prevValue: string | null) => string;\n\nconst DATABASE_VERSION = 1;\nconst STATEMENT_GET = 'SELECT value FROM storage WHERE key = ?;';\nconst STATEMENT_SET =\n  'INSERT INTO storage (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value;';\nconst STATEMENT_REMOVE = 'DELETE FROM storage WHERE key = ?;';\nconst STATEMENT_GET_ALL_KEYS = 'SELECT key FROM storage;';\nconst STATEMENT_CLEAR = 'DELETE FROM storage;';\n\nconst MIGRATION_STATEMENT_0 =\n  'CREATE TABLE IF NOT EXISTS storage (key TEXT PRIMARY KEY NOT NULL, value TEXT);';\n\n/**\n * Key-value store backed by SQLite. This class accepts a `databaseName` parameter in its constructor, which is the name of the database file to use for the storage.\n */\nexport class SQLiteStorage {\n  private db: SQLiteDatabase | null = null;\n  private readonly awaitLock = new AwaitLock();\n\n  constructor(private readonly databaseName: string) {}\n\n  //#region Asynchronous API\n\n  /**\n   * Retrieves the value associated with the given key asynchronously.\n   */\n  async getItemAsync(key: string): Promise<string | null> {\n    this.checkValidInput(key);\n    const db = await this.getDbAsync();\n    const result = await db.getFirstAsync<{ value: string }>(STATEMENT_GET, key);\n    return result?.value ?? null;\n  }\n\n  /**\n   * Sets the value for the given key asynchronously.\n   * If a function is provided, it computes the new value based on the previous value.\n   */\n  async setItemAsync(\n    key: string,\n    value: string | SQLiteStorageSetItemUpdateFunction\n  ): Promise<void> {\n    this.checkValidInput(key, value);\n    const db = await this.getDbAsync();\n\n    if (typeof value === 'function') {\n      await db.withExclusiveTransactionAsync(async (tx) => {\n        const prevResult = await tx.getFirstAsync<{ value: string }>(STATEMENT_GET, key);\n        const prevValue = prevResult?.value ?? null;\n        const nextValue = value(prevValue);\n        this.checkValidInput(key, nextValue);\n        await tx.runAsync(STATEMENT_SET, key, nextValue);\n      });\n      return;\n    }\n\n    await db.runAsync(STATEMENT_SET, key, value);\n  }\n\n  /**\n   * Removes the value associated with the given key asynchronously.\n   */\n  async removeItemAsync(key: string): Promise<boolean> {\n    this.checkValidInput(key);\n    const db = await this.getDbAsync();\n    const result = await db.runAsync(STATEMENT_REMOVE, key);\n    return result.changes > 0;\n  }\n\n  /**\n   * Retrieves all keys stored in the storage asynchronously.\n   */\n  async getAllKeysAsync(): Promise<string[]> {\n    const db = await this.getDbAsync();\n    const result = await db.getAllAsync<{ key: string }>(STATEMENT_GET_ALL_KEYS);\n    return result.map(({ key }) => key);\n  }\n\n  /**\n   * Clears all key-value pairs from the storage asynchronously.\n   */\n  async clearAsync(): Promise<boolean> {\n    const db = await this.getDbAsync();\n    const result = await db.runAsync(STATEMENT_CLEAR);\n    return result.changes > 0;\n  }\n\n  /**\n   * Closes the database connection asynchronously.\n   */\n  async closeAsync(): Promise<void> {\n    await this.awaitLock.acquireAsync();\n    try {\n      if (this.db) {\n        await this.db.closeAsync();\n        this.db = null;\n      }\n    } finally {\n      this.awaitLock.release();\n    }\n  }\n\n  //#endregion\n\n  //#region Synchronous API\n\n  /**\n   * Retrieves the value associated with the given key synchronously.\n   */\n  getItemSync(key: string): string | null {\n    this.checkValidInput(key);\n    const db = this.getDbSync();\n    const result = db.getFirstSync<{ value: string }>(STATEMENT_GET, key);\n    return result?.value ?? null;\n  }\n\n  /**\n   * Sets the value for the given key synchronously.\n   * If a function is provided, it computes the new value based on the previous value.\n   */\n  setItemSync(key: string, value: string | SQLiteStorageSetItemUpdateFunction): void {\n    this.checkValidInput(key, value);\n    const db = this.getDbSync();\n\n    if (typeof value === 'function') {\n      db.withTransactionSync(() => {\n        const prevResult = db.getFirstSync<{ value: string }>(STATEMENT_GET, key);\n        const prevValue = prevResult?.value ?? null;\n        const nextValue = value(prevValue);\n        this.checkValidInput(key, nextValue);\n        db.runSync(STATEMENT_SET, key, nextValue);\n      });\n      return;\n    }\n\n    db.runSync(STATEMENT_SET, key, value);\n  }\n\n  /**\n   * Removes the value associated with the given key synchronously.\n   */\n  removeItemSync(key: string): boolean {\n    this.checkValidInput(key);\n    const db = this.getDbSync();\n    const result = db.runSync(STATEMENT_REMOVE, key);\n    return result.changes > 0;\n  }\n\n  /**\n   * Retrieves all keys stored in the storage synchronously.\n   */\n  getAllKeysSync(): string[] {\n    const db = this.getDbSync();\n    const result = db.getAllSync<{ key: string }>(STATEMENT_GET_ALL_KEYS);\n    return result.map(({ key }) => key);\n  }\n\n  /**\n   * Clears all key-value pairs from the storage synchronously.\n   */\n  clearSync(): boolean {\n    const db = this.getDbSync();\n    const result = db.runSync(STATEMENT_CLEAR);\n    return result.changes > 0;\n  }\n\n  /**\n   * Closes the database connection synchronously.\n   */\n  closeSync(): void {\n    if (this.db) {\n      this.db.closeSync();\n      this.db = null;\n    }\n  }\n\n  //#endregion\n\n  //#region react-native-async-storage compatible API\n\n  /**\n   * Alias for [`getItemAsync()`](#getitemasynckey) method.\n   */\n  async getItem(key: string): Promise<string | null> {\n    return this.getItemAsync(key);\n  }\n\n  /**\n   * Alias for [`setItemAsync()`](#setitemasynckey-value).\n   */\n  async setItem(key: string, value: string | SQLiteStorageSetItemUpdateFunction): Promise<void> {\n    await this.setItemAsync(key, value);\n  }\n\n  /**\n   * Alias for [`removeItemAsync()`](#removeitemasynckey) method.\n   */\n  async removeItem(key: string): Promise<void> {\n    await this.removeItemAsync(key);\n  }\n\n  /**\n   * Alias for [`getAllKeysAsync()`](#getallkeysasync) method.\n   */\n  async getAllKeys(): Promise<string[]> {\n    return this.getAllKeysAsync();\n  }\n\n  /**\n   * Alias for [`clearAsync()`](#clearasync) method.\n   */\n  async clear(): Promise<void> {\n    await this.clearAsync();\n  }\n\n  /**\n   * Merges the given value with the existing value for the given key asynchronously.\n   * If the existing value is a JSON object, performs a deep merge.\n   */\n  async mergeItem(key: string, value: string): Promise<void> {\n    this.checkValidInput(key, value);\n    await this.setItemAsync(key, (prevValue) => {\n      if (prevValue == null) {\n        return value;\n      }\n      const prevJSON = JSON.parse(prevValue);\n      const newJSON = JSON.parse(value);\n      const mergedJSON = SQLiteStorage.mergeDeep(prevJSON, newJSON);\n      return JSON.stringify(mergedJSON);\n    });\n  }\n\n  /**\n   * Retrieves the values associated with the given keys asynchronously.\n   */\n  async multiGet(keys: string[]): Promise<[string, string | null][]> {\n    return Promise.all(\n      keys.map(async (key): Promise<[string, string | null]> => {\n        this.checkValidInput(key);\n        return [key, await this.getItemAsync(key)];\n      })\n    );\n  }\n\n  /**\n   * Sets multiple key-value pairs asynchronously.\n   */\n  async multiSet(keyValuePairs: [string, string][]): Promise<void> {\n    const db = await this.getDbAsync();\n    await db.withExclusiveTransactionAsync(async (tx) => {\n      for (const [key, value] of keyValuePairs) {\n        this.checkValidInput(key, value);\n        await tx.runAsync(STATEMENT_SET, key, value);\n      }\n    });\n  }\n\n  /**\n   * Removes the values associated with the given keys asynchronously.\n   */\n  async multiRemove(keys: string[]): Promise<void> {\n    const db = await this.getDbAsync();\n    await db.withExclusiveTransactionAsync(async (tx) => {\n      for (const key of keys) {\n        this.checkValidInput(key);\n        await tx.runAsync(STATEMENT_REMOVE, key);\n      }\n    });\n  }\n\n  /**\n   * Merges multiple key-value pairs asynchronously.\n   * If existing values are JSON objects, performs a deep merge.\n   */\n  async multiMerge(keyValuePairs: [string, string][]): Promise<void> {\n    const db = await this.getDbAsync();\n    await db.withExclusiveTransactionAsync(async (tx) => {\n      for (const [key, value] of keyValuePairs) {\n        this.checkValidInput(key, value);\n        const prevValue = await tx.getFirstAsync<{ value: string }>(STATEMENT_GET, key);\n        if (prevValue == null) {\n          await tx.runAsync(STATEMENT_SET, key, value);\n          continue;\n        }\n        const prevJSON = JSON.parse(prevValue.value);\n        const newJSON = JSON.parse(value);\n        const mergedJSON = SQLiteStorage.mergeDeep(prevJSON, newJSON);\n        await tx.runAsync(STATEMENT_SET, key, JSON.stringify(mergedJSON));\n      }\n    });\n  }\n\n  /**\n   * Alias for [`closeAsync()`](#closeasync-1) method.\n   */\n  async close(): Promise<void> {\n    await this.closeAsync();\n  }\n\n  //#endregion\n\n  //#region Internals\n\n  private async getDbAsync(): Promise<SQLiteDatabase> {\n    await this.awaitLock.acquireAsync();\n    try {\n      if (!this.db) {\n        const db = await openDatabaseAsync(this.databaseName);\n        await this.maybeMigrateDbAsync(db);\n        this.db = db;\n      }\n    } finally {\n      this.awaitLock.release();\n    }\n    return this.db;\n  }\n\n  private getDbSync(): SQLiteDatabase {\n    if (!this.db) {\n      const db = openDatabaseSync(this.databaseName);\n      this.maybeMigrateDbSync(db);\n      this.db = db;\n    }\n    return this.db;\n  }\n\n  private maybeMigrateDbAsync(db: SQLiteDatabase) {\n    return db.withTransactionAsync(async () => {\n      const result = await db.getFirstAsync<{ user_version: number }>('PRAGMA user_version');\n      let currentDbVersion = result?.user_version ?? 0;\n      if (currentDbVersion >= DATABASE_VERSION) {\n        return;\n      }\n      if (currentDbVersion === 0) {\n        await db.execAsync(MIGRATION_STATEMENT_0);\n        currentDbVersion = 1;\n      }\n      await db.execAsync(`PRAGMA user_version = ${DATABASE_VERSION}`);\n    });\n  }\n\n  private maybeMigrateDbSync(db: SQLiteDatabase) {\n    db.withTransactionSync(() => {\n      const result = db.getFirstSync<{ user_version: number }>('PRAGMA user_version');\n      let currentDbVersion = result?.user_version ?? 0;\n      if (currentDbVersion >= DATABASE_VERSION) {\n        return;\n      }\n      if (currentDbVersion === 0) {\n        db.execSync(MIGRATION_STATEMENT_0);\n        currentDbVersion = 1;\n      }\n      db.execSync(`PRAGMA user_version = ${DATABASE_VERSION}`);\n    });\n  }\n\n  /**\n   * Recursively merge two JSON objects.\n   */\n  private static mergeDeep(target: any, source: any): any {\n    if (typeof target !== 'object' || target === null) {\n      return source;\n    }\n\n    if (typeof source !== 'object' || source === null) {\n      return target;\n    }\n\n    const output = { ...target };\n\n    for (const key of Object.keys(source)) {\n      if (source[key] instanceof Array) {\n        if (!output[key]) {\n          output[key] = [];\n        }\n        output[key] = output[key].concat(source[key]);\n      } else if (typeof source[key] === 'object') {\n        output[key] = this.mergeDeep(target[key], source[key]);\n      } else {\n        output[key] = source[key];\n      }\n    }\n\n    return output;\n  }\n\n  private checkValidInput(...input: unknown[]) {\n    const [key, value] = input;\n\n    if (typeof key !== 'string') {\n      throw new Error(\n        `[SQLiteStorage] Using ${typeof key} type for key is not supported. Use string instead. Key passed: ${key}`\n      );\n    }\n\n    if (input.length > 1 && typeof value !== 'string' && typeof value !== 'function') {\n      throw new Error(\n        `[SQLiteStorage] Using ${typeof value} type for value is not supported. Use string instead. Key passed: ${key}. Value passed : ${value}`\n      );\n    }\n  }\n\n  //#endregion\n}\n\n/**\n * This default instance of the [`SQLiteStorage`](#sqlitestorage-1) class is used as a drop-in replacement for the `AsyncStorage` module from [`@react-native-async-storage/async-storage`](https://github.com/react-native-async-storage/async-storage).\n */\nexport const AsyncStorage = new SQLiteStorage('ExpoSQLiteStorage');\n\nexport default AsyncStorage;\n\n/**\n * Alias for [`AsyncStorage`](#sqliteasyncstorage), given the storage not only offers asynchronous methods.\n */\nexport const Storage = AsyncStorage;\n"]}

package/expo-module.config.json

@@ -5,12 +5,6 @@
   },
   "android": {
     "modules": ["expo.modules.sqlite.SQLiteModule"],
-    "shouldUsePublicationScriptPath": "android/shouldUsePublication.groovy",
-    "publication": {
-      "groupId": "host.exp.exponent",
-      "artifactId": "expo.modules.sqlite",
-      "version": "15.2.8",
-      "repository": "local-maven-repo"
-    }
+    "shouldUsePublicationScriptPath": "android/shouldUsePublication.groovy"
   }
 }

package/ios/NativeStatement.swift

@@ -6,6 +6,7 @@ final class NativeStatement: SharedObject, Equatable {
   var pointer: OpaquePointer?
   var isFinalized = false
   var extraPointer: OpaquePointer?
+  internal let lock = DispatchSemaphore(value: 1)
 
   // MARK: - Equatable
 

package/ios/SQLiteModule.swift

@@ -371,6 +371,13 @@ public final class SQLiteModule: Module {
     try maybeThrowForClosedDatabase(database)
     try maybeThrowForFinalizedStatement(statement)
 
+    // The statement with parameter bindings is stateful,
+    // we have to guard with a critical section for thread safety.
+    statement.lock.wait()
+    defer {
+      statement.lock.signal()
+    }
+
     exsqlite3_reset(statement.pointer)
     exsqlite3_clear_bindings(statement.pointer)
     for (key, param) in bindParams {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-sqlite",
-  "version": "15.2.8",
+  "version": "15.2.10",
   "description": "Provides access to a database using SQLite (https://www.sqlite.org/). The database is persisted across restarts of your app.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -48,12 +48,14 @@
   "jest": {
     "preset": "expo-module-scripts"
   },
-  "dependencies": {},
+  "dependencies": {
+    "await-lock": "^2.2.2"
+  },
   "devDependencies": {
     "@testing-library/react-native": "^13.1.0",
     "@types/better-sqlite3": "^7.6.6",
     "better-sqlite3": "^11.6.0",
-    "expo-module-scripts": "^4.1.5",
+    "expo-module-scripts": "^4.1.7",
     "react-error-boundary": "^4.0.11"
   },
   "peerDependencies": {
@@ -61,5 +63,5 @@
     "react": "*",
     "react-native": "*"
   },
-  "gitHead": "bb2cf89d99a9d7f70b07419cc36cdf80c2764217"
+  "gitHead": "49c9d53cf0a9fc8179d1c8f5268beadd141f70ca"
 }

package/src/Storage.ts

@@ -1,23 +1,6 @@
-import { openDatabaseSync, type SQLiteDatabase } from './index';
+import AwaitLock from 'await-lock';
 
-/**
- * @hidden
- */
-export function checkValidInput(...input: unknown[]) {
-  const [key, value] = input;
-
-  if (typeof key !== 'string') {
-    throw new Error(
-      `[SQLiteStorage] Using ${typeof key} type for key is not supported. Use string instead. Key passed: ${key}`
-    );
-  }
-
-  if (input.length > 1 && typeof value !== 'string' && typeof value !== 'function') {
-    throw new Error(
-      `[SQLiteStorage] Using ${typeof value} type for value is not supported. Use string instead. Key passed: ${key}. Value passed : ${value}`
-    );
-  }
-}
+import { openDatabaseAsync, openDatabaseSync, type SQLiteDatabase } from './index';
 
 /**
  * Update function for the [`setItemAsync()`](#setitemasynckey-value) or [`setItemSync()`](#setitemsynckey-value) method. It computes the new value based on the previous value. The function returns the new value to set for the key.
@@ -42,6 +25,7 @@ const MIGRATION_STATEMENT_0 =
  */
 export class SQLiteStorage {
   private db: SQLiteDatabase | null = null;
+  private readonly awaitLock = new AwaitLock();
 
   constructor(private readonly databaseName: string) {}
 
@@ -51,8 +35,8 @@ export class SQLiteStorage {
    * Retrieves the value associated with the given key asynchronously.
    */
   async getItemAsync(key: string): Promise<string | null> {
-    checkValidInput(key);
-    const db = this.getDbSync();
+    this.checkValidInput(key);
+    const db = await this.getDbAsync();
     const result = await db.getFirstAsync<{ value: string }>(STATEMENT_GET, key);
     return result?.value ?? null;
   }
@@ -65,15 +49,15 @@ export class SQLiteStorage {
     key: string,
     value: string | SQLiteStorageSetItemUpdateFunction
   ): Promise<void> {
-    checkValidInput(key, value);
-    const db = this.getDbSync();
+    this.checkValidInput(key, value);
+    const db = await this.getDbAsync();
 
     if (typeof value === 'function') {
       await db.withExclusiveTransactionAsync(async (tx) => {
         const prevResult = await tx.getFirstAsync<{ value: string }>(STATEMENT_GET, key);
         const prevValue = prevResult?.value ?? null;
         const nextValue = value(prevValue);
-        checkValidInput(key, nextValue);
+        this.checkValidInput(key, nextValue);
         await tx.runAsync(STATEMENT_SET, key, nextValue);
       });
       return;
@@ -86,8 +70,8 @@ export class SQLiteStorage {
    * Removes the value associated with the given key asynchronously.
    */
   async removeItemAsync(key: string): Promise<boolean> {
-    checkValidInput(key);
-    const db = this.getDbSync();
+    this.checkValidInput(key);
+    const db = await this.getDbAsync();
     const result = await db.runAsync(STATEMENT_REMOVE, key);
     return result.changes > 0;
   }
@@ -96,7 +80,7 @@ export class SQLiteStorage {
    * Retrieves all keys stored in the storage asynchronously.
    */
   async getAllKeysAsync(): Promise<string[]> {
-    const db = this.getDbSync();
+    const db = await this.getDbAsync();
     const result = await db.getAllAsync<{ key: string }>(STATEMENT_GET_ALL_KEYS);
     return result.map(({ key }) => key);
   }
@@ -105,7 +89,7 @@ export class SQLiteStorage {
    * Clears all key-value pairs from the storage asynchronously.
    */
   async clearAsync(): Promise<boolean> {
-    const db = this.getDbSync();
+    const db = await this.getDbAsync();
     const result = await db.runAsync(STATEMENT_CLEAR);
     return result.changes > 0;
   }
@@ -114,9 +98,14 @@ export class SQLiteStorage {
    * Closes the database connection asynchronously.
    */
   async closeAsync(): Promise<void> {
-    if (this.db) {
-      await this.db.closeAsync();
-      this.db = null;
+    await this.awaitLock.acquireAsync();
+    try {
+      if (this.db) {
+        await this.db.closeAsync();
+        this.db = null;
+      }
+    } finally {
+      this.awaitLock.release();
     }
   }
 
@@ -128,7 +117,7 @@ export class SQLiteStorage {
    * Retrieves the value associated with the given key synchronously.
    */
   getItemSync(key: string): string | null {
-    checkValidInput(key);
+    this.checkValidInput(key);
     const db = this.getDbSync();
     const result = db.getFirstSync<{ value: string }>(STATEMENT_GET, key);
     return result?.value ?? null;
@@ -139,7 +128,7 @@ export class SQLiteStorage {
    * If a function is provided, it computes the new value based on the previous value.
    */
   setItemSync(key: string, value: string | SQLiteStorageSetItemUpdateFunction): void {
-    checkValidInput(key, value);
+    this.checkValidInput(key, value);
     const db = this.getDbSync();
 
     if (typeof value === 'function') {
@@ -147,7 +136,7 @@ export class SQLiteStorage {
         const prevResult = db.getFirstSync<{ value: string }>(STATEMENT_GET, key);
         const prevValue = prevResult?.value ?? null;
         const nextValue = value(prevValue);
-        checkValidInput(key, nextValue);
+        this.checkValidInput(key, nextValue);
         db.runSync(STATEMENT_SET, key, nextValue);
       });
       return;
@@ -160,7 +149,7 @@ export class SQLiteStorage {
    * Removes the value associated with the given key synchronously.
    */
   removeItemSync(key: string): boolean {
-    checkValidInput(key);
+    this.checkValidInput(key);
     const db = this.getDbSync();
     const result = db.runSync(STATEMENT_REMOVE, key);
     return result.changes > 0;
@@ -238,7 +227,7 @@ export class SQLiteStorage {
    * If the existing value is a JSON object, performs a deep merge.
    */
   async mergeItem(key: string, value: string): Promise<void> {
-    checkValidInput(key, value);
+    this.checkValidInput(key, value);
     await this.setItemAsync(key, (prevValue) => {
       if (prevValue == null) {
         return value;
@@ -256,7 +245,7 @@ export class SQLiteStorage {
   async multiGet(keys: string[]): Promise<[string, string | null][]> {
     return Promise.all(
       keys.map(async (key): Promise<[string, string | null]> => {
-        checkValidInput(key);
+        this.checkValidInput(key);
         return [key, await this.getItemAsync(key)];
       })
     );
@@ -266,10 +255,10 @@ export class SQLiteStorage {
    * Sets multiple key-value pairs asynchronously.
    */
   async multiSet(keyValuePairs: [string, string][]): Promise<void> {
-    const db = this.getDbSync();
+    const db = await this.getDbAsync();
     await db.withExclusiveTransactionAsync(async (tx) => {
       for (const [key, value] of keyValuePairs) {
-        checkValidInput(key, value);
+        this.checkValidInput(key, value);
         await tx.runAsync(STATEMENT_SET, key, value);
       }
     });
@@ -279,10 +268,10 @@ export class SQLiteStorage {
    * Removes the values associated with the given keys asynchronously.
    */
   async multiRemove(keys: string[]): Promise<void> {
-    const db = this.getDbSync();
+    const db = await this.getDbAsync();
     await db.withExclusiveTransactionAsync(async (tx) => {
       for (const key of keys) {
-        checkValidInput(key);
+        this.checkValidInput(key);
         await tx.runAsync(STATEMENT_REMOVE, key);
       }
     });
@@ -293,10 +282,10 @@ export class SQLiteStorage {
    * If existing values are JSON objects, performs a deep merge.
    */
   async multiMerge(keyValuePairs: [string, string][]): Promise<void> {
-    const db = this.getDbSync();
+    const db = await this.getDbAsync();
     await db.withExclusiveTransactionAsync(async (tx) => {
       for (const [key, value] of keyValuePairs) {
-        checkValidInput(key, value);
+        this.checkValidInput(key, value);
         const prevValue = await tx.getFirstAsync<{ value: string }>(STATEMENT_GET, key);
         if (prevValue == null) {
           await tx.runAsync(STATEMENT_SET, key, value);
@@ -321,6 +310,20 @@ export class SQLiteStorage {
 
   //#region Internals
 
+  private async getDbAsync(): Promise<SQLiteDatabase> {
+    await this.awaitLock.acquireAsync();
+    try {
+      if (!this.db) {
+        const db = await openDatabaseAsync(this.databaseName);
+        await this.maybeMigrateDbAsync(db);
+        this.db = db;
+      }
+    } finally {
+      this.awaitLock.release();
+    }
+    return this.db;
+  }
+
   private getDbSync(): SQLiteDatabase {
     if (!this.db) {
       const db = openDatabaseSync(this.databaseName);
@@ -330,6 +333,21 @@ export class SQLiteStorage {
     return this.db;
   }
 
+  private maybeMigrateDbAsync(db: SQLiteDatabase) {
+    return db.withTransactionAsync(async () => {
+      const result = await db.getFirstAsync<{ user_version: number }>('PRAGMA user_version');
+      let currentDbVersion = result?.user_version ?? 0;
+      if (currentDbVersion >= DATABASE_VERSION) {
+        return;
+      }
+      if (currentDbVersion === 0) {
+        await db.execAsync(MIGRATION_STATEMENT_0);
+        currentDbVersion = 1;
+      }
+      await db.execAsync(`PRAGMA user_version = ${DATABASE_VERSION}`);
+    });
+  }
+
   private maybeMigrateDbSync(db: SQLiteDatabase) {
     db.withTransactionSync(() => {
       const result = db.getFirstSync<{ user_version: number }>('PRAGMA user_version');
@@ -375,6 +393,22 @@ export class SQLiteStorage {
     return output;
   }
 
+  private checkValidInput(...input: unknown[]) {
+    const [key, value] = input;
+
+    if (typeof key !== 'string') {
+      throw new Error(
+        `[SQLiteStorage] Using ${typeof key} type for key is not supported. Use string instead. Key passed: ${key}`
+      );
+    }
+
+    if (input.length > 1 && typeof value !== 'string' && typeof value !== 'function') {
+      throw new Error(
+        `[SQLiteStorage] Using ${typeof value} type for value is not supported. Use string instead. Key passed: ${key}. Value passed : ${value}`
+      );
+    }
+  }
+
   //#endregion
 }
 

package/web/WorkerChannel.ts

@@ -37,7 +37,7 @@ export function sendWorkerResult({
     const { lockBuffer, resultBuffer } = syncTrait;
     const lock = new Int32Array(lockBuffer);
     const resultArray = new Uint8Array(resultBuffer);
-    const resultJson = result ? serialize({ result }) : serialize({ error });
+    const resultJson = error != null ? serialize({ error }) : serialize({ result });
     const resultBytes = new TextEncoder().encode(resultJson);
     const length = resultBytes.length;
     resultArray.set(new Uint32Array([length]), 0);
@@ -117,13 +117,23 @@ export function invokeWorkerSync<T extends SQLiteWorkerMessageType & keyof Resul
   });
 
   let i = 0;
+  // @ts-expect-error: Remove this when TypeScript supports Atomics.pause
+  const useAtomicsPause = typeof Atomics.pause === 'function';
   while (Atomics.load(lock, 0) === PENDING) {
-    // NOTE(kudo): Unfortunate busy loop,
-    // because we don't have a way for main thread to yield its execution to other callbacks.
-    // Maybe we can wait for [`Atomics.pause`](https://github.com/tc39/proposal-atomics-microwait) to be implemented.
     ++i;
-    if (i > 1000000000) {
-      throw new Error('Sync operation timeout');
+
+    if (useAtomicsPause) {
+      if (i > 1_000_000) {
+        throw new Error('Sync operation timeout');
+      }
+      // @ts-expect-error: Remove this when TypeScript supports Atomics.pause
+      Atomics.pause();
+    } else {
+      // NOTE(kudo): Unfortunate for the busy loop,
+      // because we don't have a way for main thread to yield its execution to other callbacks.
+      if (i > 1000_000_000) {
+        throw new Error('Sync operation timeout');
+      }
     }
   }
 

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8-sources.jar.md5

@@ -1 +0,0 @@
-bb2978541a06d96c8c2180a09fe4aedc

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8-sources.jar.sha1

@@ -1 +0,0 @@
-1e52a7388cd71d0ad044ecd2658b8f7a89496240

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8-sources.jar.sha256

@@ -1 +0,0 @@
-df4580eb041e8620081acf960e64263a63771e856a40cc5ee17fa654fe3672da

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8-sources.jar.sha512

@@ -1 +0,0 @@
-4917cf35bb225309902a2482186f53d3cdde720c66d66ecf0dfa7aa42684a6ac4af424f8ea0e2bc7f7095b6301c1560ccb1fe9b224d8179e86e73e2c0a4c96c1

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8.aar.md5

@@ -1 +0,0 @@
-17a83d0d04765f8cadda48e88a48b683

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8.aar.sha1

@@ -1 +0,0 @@
-373c2a5b48f8c86abf1a2c022bf19461e156f976

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8.aar.sha256

@@ -1 +0,0 @@
-12c296c7b073a3619de123a5780a8f448c21d0ec477741729ae3e22969147991

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8.aar.sha512

@@ -1 +0,0 @@
-c70d17eeafa0bb42f27a0e06919ee3e04a96a88ed852002640fc02d834602d86b622cefb08fa6e181d73758f9eb9f80c021f94161d8fae0ce5f6490261c3cd82

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8.module

@@ -1,87 +0,0 @@
-{
-  "formatVersion": "1.1",
-  "component": {
-    "group": "host.exp.exponent",
-    "module": "expo.modules.sqlite",
-    "version": "15.2.8",
-    "attributes": {
-      "org.gradle.status": "release"
-    }
-  },
-  "createdBy": {
-    "gradle": {
-      "version": "8.13"
-    }
-  },
-  "variants": [
-    {
-      "name": "releaseVariantReleaseApiPublication",
-      "attributes": {
-        "org.gradle.category": "library",
-        "org.gradle.dependency.bundling": "external",
-        "org.gradle.libraryelements": "aar",
-        "org.gradle.usage": "java-api"
-      },
-      "files": [
-        {
-          "name": "expo.modules.sqlite-15.2.8.aar",
-          "url": "expo.modules.sqlite-15.2.8.aar",
-          "size": 3758068,
-          "sha512": "c70d17eeafa0bb42f27a0e06919ee3e04a96a88ed852002640fc02d834602d86b622cefb08fa6e181d73758f9eb9f80c021f94161d8fae0ce5f6490261c3cd82",
-          "sha256": "12c296c7b073a3619de123a5780a8f448c21d0ec477741729ae3e22969147991",
-          "sha1": "373c2a5b48f8c86abf1a2c022bf19461e156f976",
-          "md5": "17a83d0d04765f8cadda48e88a48b683"
-        }
-      ]
-    },
-    {
-      "name": "releaseVariantReleaseRuntimePublication",
-      "attributes": {
-        "org.gradle.category": "library",
-        "org.gradle.dependency.bundling": "external",
-        "org.gradle.libraryelements": "aar",
-        "org.gradle.usage": "java-runtime"
-      },
-      "dependencies": [
-        {
-          "group": "org.jetbrains.kotlin",
-          "module": "kotlin-stdlib-jdk7",
-          "version": {
-            "requires": "2.0.21"
-          }
-        }
-      ],
-      "files": [
-        {
-          "name": "expo.modules.sqlite-15.2.8.aar",
-          "url": "expo.modules.sqlite-15.2.8.aar",
-          "size": 3758068,
-          "sha512": "c70d17eeafa0bb42f27a0e06919ee3e04a96a88ed852002640fc02d834602d86b622cefb08fa6e181d73758f9eb9f80c021f94161d8fae0ce5f6490261c3cd82",
-          "sha256": "12c296c7b073a3619de123a5780a8f448c21d0ec477741729ae3e22969147991",
-          "sha1": "373c2a5b48f8c86abf1a2c022bf19461e156f976",
-          "md5": "17a83d0d04765f8cadda48e88a48b683"
-        }
-      ]
-    },
-    {
-      "name": "releaseVariantReleaseSourcePublication",
-      "attributes": {
-        "org.gradle.category": "documentation",
-        "org.gradle.dependency.bundling": "external",
-        "org.gradle.docstype": "sources",
-        "org.gradle.usage": "java-runtime"
-      },
-      "files": [
-        {
-          "name": "expo.modules.sqlite-15.2.8-sources.jar",
-          "url": "expo.modules.sqlite-15.2.8-sources.jar",
-          "size": 11071,
-          "sha512": "4917cf35bb225309902a2482186f53d3cdde720c66d66ecf0dfa7aa42684a6ac4af424f8ea0e2bc7f7095b6301c1560ccb1fe9b224d8179e86e73e2c0a4c96c1",
-          "sha256": "df4580eb041e8620081acf960e64263a63771e856a40cc5ee17fa654fe3672da",
-          "sha1": "1e52a7388cd71d0ad044ecd2658b8f7a89496240",
-          "md5": "bb2978541a06d96c8c2180a09fe4aedc"
-        }
-      ]
-    }
-  ]
-}

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8.module.md5

@@ -1 +0,0 @@
-56ae0dd0cc3d17700730d494fadce084

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8.module.sha1

@@ -1 +0,0 @@
-e799389f28969ed5dbdbf0249ede84761ae646ff

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8.module.sha256

@@ -1 +0,0 @@
-6e100e76f2d2aa965f62c2fad77288bddff9869753ed5e8ccdfce17906806125

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8.module.sha512

@@ -1 +0,0 @@
-51467664d410566ae09beedec81353d9beca8e1fd09ffef3d7162032cc0e3b0788778d84d390e6074bb93ef938f23a5adf8a4a6bff7c28154c69a38dd59ca4cd

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8.pom

@@ -1,35 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-  <!-- This module was also published with a richer model, Gradle metadata,  -->
-  <!-- which should be used instead. Do not delete the following line which  -->
-  <!-- is to indicate to Gradle or any Gradle module metadata file consumer  -->
-  <!-- that they should prefer consuming it instead. -->
-  <!-- do_not_remove: published-with-gradle-metadata -->
-  <modelVersion>4.0.0</modelVersion>
-  <groupId>host.exp.exponent</groupId>
-  <artifactId>expo.modules.sqlite</artifactId>
-  <version>15.2.8</version>
-  <packaging>aar</packaging>
-  <name>expo.modules.sqlite</name>
-  <url>https://github.com/expo/expo</url>
-  <licenses>
-    <license>
-      <name>MIT License</name>
-      <url>https://github.com/expo/expo/blob/main/LICENSE</url>
-    </license>
-  </licenses>
-  <scm>
-    <connection>https://github.com/expo/expo.git</connection>
-    <developerConnection>https://github.com/expo/expo.git</developerConnection>
-    <url>https://github.com/expo/expo</url>
-  </scm>
-  <dependencies>
-    <dependency>
-      <groupId>org.jetbrains.kotlin</groupId>
-      <artifactId>kotlin-stdlib-jdk7</artifactId>
-      <version>2.0.21</version>
-      <scope>runtime</scope>
-    </dependency>
-  </dependencies>
-</project>

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8.pom.md5

@@ -1 +0,0 @@
-158a424ea2c64707a7502dd6c053ba6b

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8.pom.sha1

@@ -1 +0,0 @@
-f2105f606d51a0265372320bc66e8336bf647a05

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8.pom.sha256

@@ -1 +0,0 @@
-45a08465c72f5ceda3d441237f7c67107c35de4346f494564bbe8675231370dc

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/15.2.8/expo.modules.sqlite-15.2.8.pom.sha512

@@ -1 +0,0 @@
-e915ce90a954d2b9d2da8ed0381fadc4b12c04023855483f256b935efd253cb909290d5b92a125249adfe7fac2ea9a0f2cbe45f838fa0349f954dd48261a16dd

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/maven-metadata.xml

@@ -1,13 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<metadata>
-  <groupId>host.exp.exponent</groupId>
-  <artifactId>expo.modules.sqlite</artifactId>
-  <versioning>
-    <latest>15.2.8</latest>
-    <release>15.2.8</release>
-    <versions>
-      <version>15.2.8</version>
-    </versions>
-    <lastUpdated>20250430004833</lastUpdated>
-  </versioning>
-</metadata>

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/maven-metadata.xml.md5

@@ -1 +0,0 @@
-34281fd770bcfdde100e2a826b84cf11

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/maven-metadata.xml.sha1

@@ -1 +0,0 @@
-521b94cad30343107562622504b4bfb0e937031c

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/maven-metadata.xml.sha256

@@ -1 +0,0 @@
-e492abde13ac3e8aad89adf146ddbee7429cd0db1db14908ac2925de2f8ad0c6

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/maven-metadata.xml.sha512

@@ -1 +0,0 @@
-79efeb5cd7f3446b05cc5f58154f3ba85c92a28f8eb49f3ac2c6475756d6e13aabe136a0ba5a9caae3275ee22f4f191184dc92c9c2a9265b8d3f137816db31bf