expo-sqlite 15.0.4 → 15.0.5

package/CHANGELOG.md

@@ -10,6 +10,10 @@
 
 ### 💡 Others
 
+## 15.0.5 — 2024-12-30
+
+_This version does not introduce any user-facing changes._
+
 ## 15.0.4 — 2024-12-26
 
 ### 🐛 Bug fixes
@@ -17,10 +21,12 @@
 - Fixed exceptions when converting empty blob data on iOS. ([#33564](https://github.com/expo/expo/pull/33564) by [@kudo](https://github.com/kudo))
 - Fixed `expo-sqlite/kv-store` async API not being well handled when using AsyncStorage compatible api ([#33847](https://github.com/expo/expo/pull/33847) by [@rtorrente](https://github.com/rtorrente))
 - Fixed `database is locked` error from parallel `kv-store` operations. ([#33834](https://github.com/expo/expo/pull/33834) by [@kudo](https://github.com/kudo))
+- Fixed `database is locked` error while using `kv-store multiGet` function. ([#33873](https://github.com/expo/expo/pull/33873) by [@rtorrente](https://github.com/rtorrente))
 
 ### 💡 Others
 
 - Removed unused `SQLite3Wrapper` code for legacy implementation on Android. ([#33565](https://github.com/expo/expo/pull/33565) by [@kudo](https://github.com/kudo))
+- Enforce input validations in `kv-store` operations. ([#33874](https://github.com/expo/expo/pull/33874) by [@rtorrente](https://github.com/rtorrente))
 
 ## 15.0.3 — 2024-11-12
 

package/android/build.gradle

@@ -3,7 +3,7 @@ import org.apache.tools.ant.taskdefs.condition.Os
 apply plugin: 'com.android.library'
 
 group = 'host.exp.exponent'
-version = '15.0.4'
+version = '15.0.5'
 
 def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
 apply from: expoModulesCorePlugin
@@ -53,7 +53,7 @@ android {
   namespace "expo.modules.sqlite"
   defaultConfig {
     versionCode 18
-    versionName "15.0.4"
+    versionName "15.0.5"
 
     externalNativeBuild {
       cmake {

package/build/Storage.d.ts

@@ -1,3 +1,4 @@
+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.

package/build/Storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../src/Storage.ts"],"names":[],"mappings":"AAEA;;;;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;IAMvD;;;OAGG;IACG,YAAY,CAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,kCAAkC,GACjD,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;IACG,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMpD;;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;IAMvC;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,kCAAkC,GAAG,IAAI;IAgBlF;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAMpC;;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;IAY1D;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAclE;;OAEG;IACG,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAShE;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAShD;;;OAGG;IACG,UAAU,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlE;;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":"AAEA,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"}

package/build/Storage.js

@@ -1,4 +1,13 @@
 import { openDatabaseSync } from './index';
+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}`);
+    }
+}
 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;';
@@ -20,6 +29,7 @@ export class SQLiteStorage {
      * Retrieves the value associated with the given key asynchronously.
      */
     async getItemAsync(key) {
+        checkValidInput(key);
         const db = this.getDbSync();
         const result = await db.getFirstAsync(STATEMENT_GET, key);
         return result?.value ?? null;
@@ -29,12 +39,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();
         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);
                 await tx.runAsync(STATEMENT_SET, key, nextValue);
             });
             return;
@@ -45,6 +57,7 @@ export class SQLiteStorage {
      * Removes the value associated with the given key asynchronously.
      */
     async removeItemAsync(key) {
+        checkValidInput(key);
         const db = this.getDbSync();
         const result = await db.runAsync(STATEMENT_REMOVE, key);
         return result.changes > 0;
@@ -80,6 +93,7 @@ export class SQLiteStorage {
      * Retrieves the value associated with the given key synchronously.
      */
     getItemSync(key) {
+        checkValidInput(key);
         const db = this.getDbSync();
         const result = db.getFirstSync(STATEMENT_GET, key);
         return result?.value ?? null;
@@ -89,12 +103,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);
         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);
                 db.runSync(STATEMENT_SET, key, nextValue);
             });
             return;
@@ -105,6 +121,7 @@ export class SQLiteStorage {
      * Removes the value associated with the given key synchronously.
      */
     removeItemSync(key) {
+        checkValidInput(key);
         const db = this.getDbSync();
         const result = db.runSync(STATEMENT_REMOVE, key);
         return result.changes > 0;
@@ -171,6 +188,7 @@ export class SQLiteStorage {
      * If the existing value is a JSON object, performs a deep merge.
      */
     async mergeItem(key, value) {
+        checkValidInput(key, value);
         await this.setItemAsync(key, (prevValue) => {
             if (prevValue == null) {
                 return value;
@@ -185,15 +203,10 @@ export class SQLiteStorage {
      * Retrieves the values associated with the given keys asynchronously.
      */
     async multiGet(keys) {
-        const db = this.getDbSync();
-        let result = [];
-        await db.withExclusiveTransactionAsync(async (tx) => {
-            result = await Promise.all(keys.map(async (key) => {
-                const row = await tx.getFirstAsync(STATEMENT_GET, key);
-                return [key, row?.value ?? null];
-            }));
-        });
-        return result;
+        return Promise.all(keys.map(async (key) => {
+            checkValidInput(key);
+            return [key, await this.getItemAsync(key)];
+        }));
     }
     /**
      * Sets multiple key-value pairs asynchronously.
@@ -202,6 +215,7 @@ export class SQLiteStorage {
         const db = this.getDbSync();
         await db.withExclusiveTransactionAsync(async (tx) => {
             for (const [key, value] of keyValuePairs) {
+                checkValidInput(key, value);
                 await tx.runAsync(STATEMENT_SET, key, value);
             }
         });
@@ -213,6 +227,7 @@ export class SQLiteStorage {
         const db = this.getDbSync();
         await db.withExclusiveTransactionAsync(async (tx) => {
             for (const key of keys) {
+                checkValidInput(key);
                 await tx.runAsync(STATEMENT_REMOVE, key);
             }
         });
@@ -225,6 +240,7 @@ export class SQLiteStorage {
         const db = this.getDbSync();
         await db.withExclusiveTransactionAsync(async (tx) => {
             for (const [key, value] of keyValuePairs) {
+                checkValidInput(key, value);
                 const prevValue = await tx.getFirstAsync(STATEMENT_GET, key);
                 if (prevValue == null) {
                     await tx.runAsync(STATEMENT_SET, key, value);

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 * 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    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    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        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    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    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    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        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    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    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    const db = this.getDbSync();\n    let result: [string, string | null][] = [];\n    await db.withExclusiveTransactionAsync(async (tx) => {\n      result = await Promise.all(\n        keys.map(async (key) => {\n          const row = await tx.getFirstAsync<{ value: string }>(STATEMENT_GET, key);\n          return [key, row?.value ?? null];\n        })\n      );\n    });\n    return result;\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        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        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        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 { openDatabaseSync, type SQLiteDatabase } from './index';\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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-sqlite",
-  "version": "15.0.4",
+  "version": "15.0.5",
   "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",
@@ -61,5 +61,5 @@
     "react": "*",
     "react-native": "*"
   },
-  "gitHead": "64d037d767a487f402ffd0d7d919aa7e848815ac"
+  "gitHead": "03394549f5401074f21b09c1a648a789bdc35956"
 }

package/src/Storage.ts

@@ -1,5 +1,21 @@
 import { openDatabaseSync, type SQLiteDatabase } from './index';
 
+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}`
+    );
+  }
+}
+
 /**
  * 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.
@@ -32,6 +48,7 @@ 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();
     const result = await db.getFirstAsync<{ value: string }>(STATEMENT_GET, key);
     return result?.value ?? null;
@@ -45,6 +62,7 @@ export class SQLiteStorage {
     key: string,
     value: string | SQLiteStorageSetItemUpdateFunction
   ): Promise<void> {
+    checkValidInput(key, value);
     const db = this.getDbSync();
 
     if (typeof value === 'function') {
@@ -52,6 +70,7 @@ export class SQLiteStorage {
         const prevResult = await tx.getFirstAsync<{ value: string }>(STATEMENT_GET, key);
         const prevValue = prevResult?.value ?? null;
         const nextValue = value(prevValue);
+        checkValidInput(key, nextValue);
         await tx.runAsync(STATEMENT_SET, key, nextValue);
       });
       return;
@@ -64,6 +83,7 @@ export class SQLiteStorage {
    * Removes the value associated with the given key asynchronously.
    */
   async removeItemAsync(key: string): Promise<boolean> {
+    checkValidInput(key);
     const db = this.getDbSync();
     const result = await db.runAsync(STATEMENT_REMOVE, key);
     return result.changes > 0;
@@ -105,6 +125,7 @@ export class SQLiteStorage {
    * Retrieves the value associated with the given key synchronously.
    */
   getItemSync(key: string): string | null {
+    checkValidInput(key);
     const db = this.getDbSync();
     const result = db.getFirstSync<{ value: string }>(STATEMENT_GET, key);
     return result?.value ?? null;
@@ -115,6 +136,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);
     const db = this.getDbSync();
 
     if (typeof value === 'function') {
@@ -122,6 +144,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);
         db.runSync(STATEMENT_SET, key, nextValue);
       });
       return;
@@ -134,6 +157,7 @@ export class SQLiteStorage {
    * Removes the value associated with the given key synchronously.
    */
   removeItemSync(key: string): boolean {
+    checkValidInput(key);
     const db = this.getDbSync();
     const result = db.runSync(STATEMENT_REMOVE, key);
     return result.changes > 0;
@@ -211,6 +235,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);
     await this.setItemAsync(key, (prevValue) => {
       if (prevValue == null) {
         return value;
@@ -226,17 +251,12 @@ export class SQLiteStorage {
    * Retrieves the values associated with the given keys asynchronously.
    */
   async multiGet(keys: string[]): Promise<[string, string | null][]> {
-    const db = this.getDbSync();
-    let result: [string, string | null][] = [];
-    await db.withExclusiveTransactionAsync(async (tx) => {
-      result = await Promise.all(
-        keys.map(async (key) => {
-          const row = await tx.getFirstAsync<{ value: string }>(STATEMENT_GET, key);
-          return [key, row?.value ?? null];
-        })
-      );
-    });
-    return result;
+    return Promise.all(
+      keys.map(async (key): Promise<[string, string | null]> => {
+        checkValidInput(key);
+        return [key, await this.getItemAsync(key)];
+      })
+    );
   }
 
   /**
@@ -246,6 +266,7 @@ export class SQLiteStorage {
     const db = this.getDbSync();
     await db.withExclusiveTransactionAsync(async (tx) => {
       for (const [key, value] of keyValuePairs) {
+        checkValidInput(key, value);
         await tx.runAsync(STATEMENT_SET, key, value);
       }
     });
@@ -258,6 +279,7 @@ export class SQLiteStorage {
     const db = this.getDbSync();
     await db.withExclusiveTransactionAsync(async (tx) => {
       for (const key of keys) {
+        checkValidInput(key);
         await tx.runAsync(STATEMENT_REMOVE, key);
       }
     });
@@ -271,6 +293,7 @@ export class SQLiteStorage {
     const db = this.getDbSync();
     await db.withExclusiveTransactionAsync(async (tx) => {
       for (const [key, value] of keyValuePairs) {
+        checkValidInput(key, value);
         const prevValue = await tx.getFirstAsync<{ value: string }>(STATEMENT_GET, key);
         if (prevValue == null) {
           await tx.runAsync(STATEMENT_SET, key, value);