@breeztech/breez-sdk-spark 0.10.0 → 0.11.0-dev2

package/bundler/breez_sdk_spark_wasm_bg.js

@@ -221,6 +221,43 @@ function debugString(val) {
     // TODO we could test for more things here, like `Set`s and `Map`s.
     return className;
 }
+/**
+ * Creates a default PostgreSQL storage configuration with sensible defaults.
+ *
+ * Default values (from pg.Pool):
+ * - `maxPoolSize`: 10
+ * - `createTimeoutSecs`: 0 (no timeout)
+ * - `recycleTimeoutSecs`: 10 (10 seconds idle before disconnect)
+ * @param {string} connection_string
+ * @returns {PostgresStorageConfig}
+ */
+export function defaultPostgresStorageConfig(connection_string) {
+    const ptr0 = passStringToWasm0(connection_string, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.defaultPostgresStorageConfig(ptr0, len0);
+    return ret;
+}
+
+/**
+ * Creates a default external signer from a mnemonic phrase.
+ *
+ * This creates a signer that can be used with `connectWithSigner` or `SdkBuilder.newWithSigner`.
+ * @returns {Promise<SparkStatus>}
+ */
+export function getSparkStatus() {
+    const ret = wasm.getSparkStatus();
+    return ret;
+}
+
+/**
+ * @param {Network} network
+ * @returns {Config}
+ */
+export function defaultConfig(network) {
+    const ret = wasm.defaultConfig(network);
+    return ret;
+}
+
 /**
  * @param {Logger} logger
  * @param {string | null} [filter]
@@ -257,15 +294,6 @@ export function defaultExternalSigner(mnemonic, passphrase, network, key_set_con
     return DefaultSigner.__wrap(ret[0]);
 }
 
-/**
- * @param {Network} network
- * @returns {Config}
- */
-export function defaultConfig(network) {
-    const ret = wasm.defaultConfig(network);
-    return ret;
-}
-
 /**
  * @param {ConnectRequest} request
  * @returns {Promise<BreezSdk>}
@@ -288,17 +316,6 @@ export function connectWithSigner(config, signer, storage_dir) {
     return ret;
 }
 
-/**
- * Creates a default external signer from a mnemonic phrase.
- *
- * This creates a signer that can be used with `connectWithSigner` or `SdkBuilder.newWithSigner`.
- * @returns {Promise<SparkStatus>}
- */
-export function getSparkStatus() {
-    const ret = wasm.getSparkStatus();
-    return ret;
-}
-
 function passArray8ToWasm0(arg, malloc) {
     const ptr = malloc(arg.length * 1, 1) >>> 0;
     getUint8ArrayMemory0().set(arg, ptr / 1);
@@ -317,15 +334,15 @@ export function task_worker_entry_point(ptr) {
 }
 
 function __wbg_adapter_64(arg0, arg1) {
-    wasm._dyn_core__ops__function__FnMut_____Output___R_as_wasm_bindgen__closure__WasmClosure___describe__invoke__hce61e5994b0c00ad(arg0, arg1);
+    wasm._dyn_core__ops__function__FnMut_____Output___R_as_wasm_bindgen__closure__WasmClosure___describe__invoke__h2ac8515d28de5817(arg0, arg1);
 }
 
 function __wbg_adapter_67(arg0, arg1, arg2) {
-    wasm.closure1048_externref_shim(arg0, arg1, arg2);
+    wasm.closure1068_externref_shim(arg0, arg1, arg2);
 }
 
-function __wbg_adapter_285(arg0, arg1, arg2, arg3) {
-    wasm.closure642_externref_shim(arg0, arg1, arg2, arg3);
+function __wbg_adapter_301(arg0, arg1, arg2, arg3) {
+    wasm.closure651_externref_shim(arg0, arg1, arg2, arg3);
 }
 
 const __wbindgen_enum_ReadableStreamType = ["bytes"];
@@ -380,6 +397,14 @@ export class BreezSdk {
         const ret = wasm.breezsdk_lnurlAuth(this.__wbg_ptr, request_data);
         return ret;
     }
+    /**
+     * @param {AddContactRequest} request
+     * @returns {Promise<Contact>}
+     */
+    addContact(request) {
+        const ret = wasm.breezsdk_addContact(this.__wbg_ptr, request);
+        return ret;
+    }
     /**
      * @param {BuyBitcoinRequest} request
      * @returns {Promise<BuyBitcoinResponse>}
@@ -436,6 +461,14 @@ export class BreezSdk {
         const ret = wasm.breezsdk_claimDeposit(this.__wbg_ptr, request);
         return ret;
     }
+    /**
+     * @param {ListContactsRequest} request
+     * @returns {Promise<Contact[]>}
+     */
+    listContacts(request) {
+        const ret = wasm.breezsdk_listContacts(this.__wbg_ptr, request);
+        return ret;
+    }
     /**
      * @param {ListPaymentsRequest} request
      * @returns {Promise<ListPaymentsResponse>}
@@ -444,6 +477,16 @@ export class BreezSdk {
         const ret = wasm.breezsdk_listPayments(this.__wbg_ptr, request);
         return ret;
     }
+    /**
+     * @param {string} id
+     * @returns {Promise<void>}
+     */
+    deleteContact(id) {
+        const ptr0 = passStringToWasm0(id, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.breezsdk_deleteContact(this.__wbg_ptr, ptr0, len0);
+        return ret;
+    }
     /**
      * @param {LnurlWithdrawRequest} request
      * @returns {Promise<LnurlWithdrawResponse>}
@@ -460,6 +503,14 @@ export class BreezSdk {
         const ret = wasm.breezsdk_refundDeposit(this.__wbg_ptr, request);
         return ret;
     }
+    /**
+     * @param {UpdateContactRequest} request
+     * @returns {Promise<Contact>}
+     */
+    updateContact(request) {
+        const ret = wasm.breezsdk_updateContact(this.__wbg_ptr, request);
+        return ret;
+    }
     /**
      * @returns {Promise<ListFiatRatesResponse>}
      */
@@ -1099,6 +1150,15 @@ export class SdkBuilder {
         const ret = wasm.sdkbuilder_withPaymentObserver(ptr, payment_observer);
         return SdkBuilder.__wrap(ret);
     }
+    /**
+     * @param {PostgresStorageConfig} config
+     * @returns {SdkBuilder}
+     */
+    withPostgresStorage(config) {
+        const ptr = this.__destroy_into_raw();
+        const ret = wasm.sdkbuilder_withPostgresStorage(ptr, config);
+        return SdkBuilder.__wrap(ret);
+    }
     /**
      * @param {string} url
      * @param {ChainApiType} api_type
@@ -1353,6 +1413,11 @@ export function __wbg_createDefaultStorage_458aa01b5eaead27() { return handleErr
     return ret;
 }, arguments) };
 
+export function __wbg_createPostgresStorage_46770cbf8e947f9e() { return handleError(function (arg0, arg1) {
+    const ret = createPostgresStorage(arg0, arg1);
+    return ret;
+}, arguments) };
+
 export function __wbg_crypto_574e78ad8b13b65f(arg0) {
     const ret = arg0.crypto;
     return ret;
@@ -1371,6 +1436,19 @@ export function __wbg_deleteCachedItem_ff3c84380e94360b() { return handleError(f
     }
 }, arguments) };
 
+export function __wbg_deleteContact_04d635b32c469d83() { return handleError(function (arg0, arg1, arg2) {
+    let deferred0_0;
+    let deferred0_1;
+    try {
+        deferred0_0 = arg1;
+        deferred0_1 = arg2;
+        const ret = arg0.deleteContact(getStringFromWasm0(arg1, arg2));
+        return ret;
+    } finally {
+        wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
+    }
+}, arguments) };
+
 export function __wbg_deleteDeposit_72ec826e7c3c3ccf() { return handleError(function (arg0, arg1, arg2, arg3) {
     let deferred0_0;
     let deferred0_1;
@@ -1534,6 +1612,19 @@ export function __wbg_getCachedItem_de40d6348815c7b9() { return handleError(func
     }
 }, arguments) };
 
+export function __wbg_getContact_b7300737e5dee01b() { return handleError(function (arg0, arg1, arg2) {
+    let deferred0_0;
+    let deferred0_1;
+    try {
+        deferred0_0 = arg1;
+        deferred0_1 = arg2;
+        const ret = arg0.getContact(getStringFromWasm0(arg1, arg2));
+        return ret;
+    } finally {
+        wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
+    }
+}, arguments) };
+
 export function __wbg_getPaymentById_c23144bfc404b2fc() { return handleError(function (arg0, arg1, arg2) {
     let deferred0_0;
     let deferred0_1;
@@ -1699,6 +1790,11 @@ export function __wbg_identityPublicKey_c8b35005055a3df0() { return handleError(
     return ret;
 }, arguments) };
 
+export function __wbg_insertContact_33c214012213409d() { return handleError(function (arg0, arg1) {
+    const ret = arg0.insertContact(arg1);
+    return ret;
+}, arguments) };
+
 export function __wbg_insertPaymentMetadata_0c4ebdcde694d29b() { return handleError(function (arg0, arg1, arg2, arg3) {
     let deferred0_0;
     let deferred0_1;
@@ -1819,6 +1915,11 @@ export function __wbg_length_e2d2a49132c1b256(arg0) {
     return ret;
 };
 
+export function __wbg_listContacts_5b4d38a57743b713() { return handleError(function (arg0, arg1) {
+    const ret = arg0.listContacts(arg1);
+    return ret;
+}, arguments) };
+
 export function __wbg_listDeposits_7ca6e22afc06d560() { return handleError(function (arg0) {
     const ret = arg0.listDeposits();
     return ret;
@@ -1876,7 +1977,7 @@ export function __wbg_new_23a2665fac83c611(arg0, arg1) {
             const a = state0.a;
             state0.a = 0;
             try {
-                return __wbg_adapter_285(a, state0.b, arg0, arg1);
+                return __wbg_adapter_301(a, state0.b, arg0, arg1);
             } finally {
                 state0.a = a;
             }
@@ -2401,13 +2502,13 @@ export function __wbindgen_cb_drop(arg0) {
     return ret;
 };
 
-export function __wbindgen_closure_wrapper11704(arg0, arg1, arg2) {
-    const ret = makeMutClosure(arg0, arg1, 817, __wbg_adapter_64);
+export function __wbindgen_closure_wrapper11838(arg0, arg1, arg2) {
+    const ret = makeMutClosure(arg0, arg1, 828, __wbg_adapter_64);
     return ret;
 };
 
-export function __wbindgen_closure_wrapper13627(arg0, arg1, arg2) {
-    const ret = makeMutClosure(arg0, arg1, 1049, __wbg_adapter_67);
+export function __wbindgen_closure_wrapper13801(arg0, arg1, arg2) {
+    const ret = makeMutClosure(arg0, arg1, 1069, __wbg_adapter_67);
     return ret;
 };
 

package/bundler/breez_sdk_spark_wasm_bg.wasm.d.ts

@@ -5,6 +5,7 @@ export const __wbg_breezsdk_free: (a: number, b: number) => void;
 export const __wbg_defaultsigner_free: (a: number, b: number) => void;
 export const __wbg_sdkbuilder_free: (a: number, b: number) => void;
 export const __wbg_tokenissuer_free: (a: number, b: number) => void;
+export const breezsdk_addContact: (a: number, b: any) => any;
 export const breezsdk_addEventListener: (a: number, b: any) => any;
 export const breezsdk_buyBitcoin: (a: number, b: any) => any;
 export const breezsdk_cancelLeafOptimization: (a: number) => any;
@@ -12,6 +13,7 @@ export const breezsdk_checkLightningAddressAvailable: (a: number, b: any) => any
 export const breezsdk_checkMessage: (a: number, b: any) => any;
 export const breezsdk_claimDeposit: (a: number, b: any) => any;
 export const breezsdk_claimHtlcPayment: (a: number, b: any) => any;
+export const breezsdk_deleteContact: (a: number, b: number, c: number) => any;
 export const breezsdk_deleteLightningAddress: (a: number) => any;
 export const breezsdk_disconnect: (a: number) => any;
 export const breezsdk_fetchConversionLimits: (a: number, b: any) => any;
@@ -22,6 +24,7 @@ export const breezsdk_getPayment: (a: number, b: any) => any;
 export const breezsdk_getTokenIssuer: (a: number) => number;
 export const breezsdk_getTokensMetadata: (a: number, b: any) => any;
 export const breezsdk_getUserSettings: (a: number) => any;
+export const breezsdk_listContacts: (a: number, b: any) => any;
 export const breezsdk_listFiatCurrencies: (a: number) => any;
 export const breezsdk_listFiatRates: (a: number) => any;
 export const breezsdk_listPayments: (a: number, b: any) => any;
@@ -41,11 +44,13 @@ export const breezsdk_sendPayment: (a: number, b: any) => any;
 export const breezsdk_signMessage: (a: number, b: any) => any;
 export const breezsdk_startLeafOptimization: (a: number) => void;
 export const breezsdk_syncWallet: (a: number, b: any) => any;
+export const breezsdk_updateContact: (a: number, b: any) => any;
 export const breezsdk_updateUserSettings: (a: number, b: any) => any;
 export const connect: (a: any) => any;
 export const connectWithSigner: (a: any, b: any, c: number, d: number) => any;
 export const defaultConfig: (a: any) => any;
 export const defaultExternalSigner: (a: number, b: number, c: number, d: number, e: any, f: number) => [number, number, number];
+export const defaultPostgresStorageConfig: (a: number, b: number) => any;
 export const defaultsigner_aggregateFrost: (a: number, b: any) => any;
 export const defaultsigner_decryptEcies: (a: number, b: number, c: number, d: number, e: number) => any;
 export const defaultsigner_derivePublicKey: (a: number, b: number, c: number) => any;
@@ -77,6 +82,7 @@ export const sdkbuilder_withFiatService: (a: number, b: any) => number;
 export const sdkbuilder_withKeySet: (a: number, b: any) => number;
 export const sdkbuilder_withLnurlClient: (a: number, b: any) => number;
 export const sdkbuilder_withPaymentObserver: (a: number, b: any) => number;
+export const sdkbuilder_withPostgresStorage: (a: number, b: any) => number;
 export const sdkbuilder_withRestChainService: (a: number, b: number, c: number, d: any, e: number) => number;
 export const sdkbuilder_withStorage: (a: number, b: any) => number;
 export const tokenissuer_burnIssuerToken: (a: number, b: any) => any;
@@ -113,7 +119,7 @@ export const __wbindgen_export_5: WebAssembly.Table;
 export const __externref_drop_slice: (a: number, b: number) => void;
 export const __wbindgen_export_7: WebAssembly.Table;
 export const __externref_table_dealloc: (a: number) => void;
-export const _dyn_core__ops__function__FnMut_____Output___R_as_wasm_bindgen__closure__WasmClosure___describe__invoke__hce61e5994b0c00ad: (a: number, b: number) => void;
-export const closure1048_externref_shim: (a: number, b: number, c: any) => void;
-export const closure642_externref_shim: (a: number, b: number, c: any, d: any) => void;
+export const _dyn_core__ops__function__FnMut_____Output___R_as_wasm_bindgen__closure__WasmClosure___describe__invoke__h2ac8515d28de5817: (a: number, b: number) => void;
+export const closure1068_externref_shim: (a: number, b: number, c: any) => void;
+export const closure651_externref_shim: (a: number, b: number, c: any, d: any) => void;
 export const __wbindgen_start: () => void;

package/bundler/storage/index.js

@@ -409,6 +409,16 @@ class MigrationManager {
           }
         },
       },
+      {
+        name: "Create contacts store",
+        upgrade: (db) => {
+          if (!db.objectStoreNames.contains("contacts")) {
+            const contactsStore = db.createObjectStore("contacts", { keyPath: "id" });
+            contactsStore.createIndex("name_identifier", ["name", "paymentIdentifier"], { unique: false });
+            contactsStore.createIndex("name", "name", { unique: false });
+          }
+        }
+      },
       {
         name: "Clear cached lightning address for LnurlInfo schema change",
         upgrade: (db, transaction) => {
@@ -441,7 +451,7 @@ class IndexedDBStorage {
     this.db = null;
     this.migrationManager = null;
     this.logger = logger;
-    this.dbVersion = 13; // Current schema version
+    this.dbVersion = 14; // Current schema version
   }
 
   /**
@@ -461,8 +471,7 @@ class IndexedDBStorage {
 
       request.onerror = () => {
         const error = new StorageError(
-          `Failed to open IndexedDB: ${
-            request.error?.message || "Unknown error"
+          `Failed to open IndexedDB: ${request.error?.message || "Unknown error"
           }`,
           request.error
         );
@@ -537,8 +546,7 @@ class IndexedDBStorage {
       request.onerror = () => {
         reject(
           new StorageError(
-            `Failed to get cached item '${key}': ${
-              request.error?.message || "Unknown error"
+            `Failed to get cached item '${key}': ${request.error?.message || "Unknown error"
             }`,
             request.error
           )
@@ -562,8 +570,7 @@ class IndexedDBStorage {
       request.onerror = () => {
         reject(
           new StorageError(
-            `Failed to set cached item '${key}': ${
-              request.error?.message || "Unknown error"
+            `Failed to set cached item '${key}': ${request.error?.message || "Unknown error"
             }`,
             request.error
           )
@@ -587,8 +594,7 @@ class IndexedDBStorage {
       request.onerror = () => {
         reject(
           new StorageError(
-            `Failed to delete cached item '${key}': ${
-              request.error?.message || "Unknown error"
+            `Failed to delete cached item '${key}': ${request.error?.message || "Unknown error"
             }`,
             request.error
           )
@@ -758,8 +764,7 @@ class IndexedDBStorage {
       cursorRequest.onerror = () => {
         reject(
           new StorageError(
-            `Failed to list payments (request: ${JSON.stringify(request)}: ${
-              cursorRequest.error?.message || "Unknown error"
+            `Failed to list payments (request: ${JSON.stringify(request)}: ${cursorRequest.error?.message || "Unknown error"
             }`,
             cursorRequest.error
           )
@@ -789,8 +794,7 @@ class IndexedDBStorage {
       request.onerror = () => {
         reject(
           new StorageError(
-            `Failed to insert payment '${payment.id}': ${
-              request.error?.message || "Unknown error"
+            `Failed to insert payment '${payment.id}': ${request.error?.message || "Unknown error"
             }`,
             request.error
           )
@@ -853,8 +857,7 @@ class IndexedDBStorage {
       paymentRequest.onerror = () => {
         reject(
           new StorageError(
-            `Failed to get payment by id '${id}': ${
-              paymentRequest.error?.message || "Unknown error"
+            `Failed to get payment by id '${id}': ${paymentRequest.error?.message || "Unknown error"
             }`,
             paymentRequest.error
           )
@@ -918,8 +921,7 @@ class IndexedDBStorage {
       paymentRequest.onerror = () => {
         reject(
           new StorageError(
-            `Failed to get payment by invoice '${invoice}': ${
-              paymentRequest.error?.message || "Unknown error"
+            `Failed to get payment by invoice '${invoice}': ${paymentRequest.error?.message || "Unknown error"
             }`,
             paymentRequest.error
           )
@@ -1084,8 +1086,7 @@ class IndexedDBStorage {
       cursorRequest.onerror = () => {
         reject(
           new StorageError(
-            `Failed to get payments by parent ids: ${
-              cursorRequest.error?.message || "Unknown error"
+            `Failed to get payments by parent ids: ${cursorRequest.error?.message || "Unknown error"
             }`,
             cursorRequest.error
           )
@@ -1129,8 +1130,7 @@ class IndexedDBStorage {
         putRequest.onerror = () => {
           reject(
             new StorageError(
-              `Failed to set payment metadata for '${paymentId}': ${
-                putRequest.error?.message || "Unknown error"
+              `Failed to set payment metadata for '${paymentId}': ${putRequest.error?.message || "Unknown error"
               }`,
               putRequest.error
             )
@@ -1140,8 +1140,7 @@ class IndexedDBStorage {
       getRequest.onerror = () => {
         reject(
           new StorageError(
-            `Failed to get existing payment metadata for '${paymentId}': ${
-              getRequest.error?.message || "Unknown error"
+            `Failed to get existing payment metadata for '${paymentId}': ${getRequest.error?.message || "Unknown error"
             }`,
             getRequest.error
           )
@@ -1178,8 +1177,7 @@ class IndexedDBStorage {
       request.onerror = () => {
         reject(
           new StorageError(
-            `Failed to add deposit '${txid}:${vout}': ${
-              request.error?.message || "Unknown error"
+            `Failed to add deposit '${txid}:${vout}': ${request.error?.message || "Unknown error"
             }`,
             request.error
           )
@@ -1205,8 +1203,7 @@ class IndexedDBStorage {
       request.onerror = () => {
         reject(
           new StorageError(
-            `Failed to delete deposit '${txid}:${vout}': ${
-              request.error?.message || "Unknown error"
+            `Failed to delete deposit '${txid}:${vout}': ${request.error?.message || "Unknown error"
             }`,
             request.error
           )
@@ -1240,8 +1237,7 @@ class IndexedDBStorage {
       request.onerror = () => {
         reject(
           new StorageError(
-            `Failed to list deposits: ${
-              request.error?.message || "Unknown error"
+            `Failed to list deposits: ${request.error?.message || "Unknown error"
             }`,
             request.error
           )
@@ -1293,8 +1289,7 @@ class IndexedDBStorage {
         putRequest.onerror = () => {
           reject(
             new StorageError(
-              `Failed to update deposit '${txid}:${vout}': ${
-                putRequest.error?.message || "Unknown error"
+              `Failed to update deposit '${txid}:${vout}': ${putRequest.error?.message || "Unknown error"
               }`,
               putRequest.error
             )
@@ -1305,8 +1300,7 @@ class IndexedDBStorage {
       getRequest.onerror = () => {
         reject(
           new StorageError(
-            `Failed to get deposit '${txid}:${vout}' for update: ${
-              getRequest.error?.message || "Unknown error"
+            `Failed to get deposit '${txid}:${vout}' for update: ${getRequest.error?.message || "Unknown error"
             }`,
             getRequest.error
           )
@@ -1354,8 +1348,7 @@ class IndexedDBStorage {
         request.onerror = () => {
           reject(
             new StorageError(
-              `Failed to add lnurl metadata for payment hash '${
-                item.paymentHash
+              `Failed to add lnurl metadata for payment hash '${item.paymentHash
               }': ${request.error?.message || "Unknown error"}`,
               request.error
             )
@@ -1841,6 +1834,144 @@ class IndexedDBStorage {
     });
   }
 
+  // ===== Contact Operations =====
+
+  async listContacts(request) {
+    if (!this.db) {
+      throw new StorageError("Database not initialized");
+    }
+
+    const actualOffset = request.offset !== null && request.offset !== undefined ? request.offset : 0;
+    const actualLimit = request.limit !== null && request.limit !== undefined ? request.limit : 4294967295;
+
+    return new Promise((resolve, reject) => {
+      const transaction = this.db.transaction("contacts", "readonly");
+      const store = transaction.objectStore("contacts");
+      const nameIndex = store.index("name");
+
+      const contacts = [];
+      let count = 0;
+      let skipped = 0;
+
+      const cursorRequest = nameIndex.openCursor();
+
+      cursorRequest.onsuccess = (event) => {
+        const cursor = event.target.result;
+
+        if (!cursor || count >= actualLimit) {
+          resolve(contacts);
+          return;
+        }
+
+        if (skipped < actualOffset) {
+          skipped++;
+          cursor.continue();
+          return;
+        }
+
+        contacts.push(cursor.value);
+        count++;
+        cursor.continue();
+      };
+
+      cursorRequest.onerror = () => {
+        reject(
+          new StorageError(
+            `Failed to list contacts: ${cursorRequest.error?.message || "Unknown error"}`,
+            cursorRequest.error
+          )
+        );
+      };
+    });
+  }
+
+  async getContact(id) {
+    if (!this.db) {
+      throw new StorageError("Database not initialized");
+    }
+
+    return new Promise((resolve, reject) => {
+      const transaction = this.db.transaction("contacts", "readonly");
+      const store = transaction.objectStore("contacts");
+      const request = store.get(id);
+
+      request.onsuccess = () => {
+        resolve(request.result || null);
+      };
+
+      request.onerror = () => {
+        reject(
+          new StorageError(
+            `Failed to get contact '${id}': ${request.error?.message || "Unknown error"}`,
+            request.error
+          )
+        );
+      };
+    });
+  }
+
+  async insertContact(contact) {
+    if (!this.db) {
+      throw new StorageError("Database not initialized");
+    }
+
+    return new Promise((resolve, reject) => {
+      const transaction = this.db.transaction("contacts", "readwrite");
+      const store = transaction.objectStore("contacts");
+
+      // Preserve created_at from existing record on update
+      const getRequest = store.get(contact.id);
+      getRequest.onsuccess = () => {
+        const existingById = getRequest.result;
+        const toStore = existingById
+          ? { ...contact, createdAt: existingById.createdAt }
+          : contact;
+
+        const putRequest = store.put(toStore);
+        putRequest.onsuccess = () => resolve();
+        putRequest.onerror = () => {
+          reject(
+            new StorageError(
+              `Inserting contact failed: ${putRequest.error?.name || "Unknown error"} - ${putRequest.error?.message || ""}`,
+              putRequest.error
+            )
+          );
+        };
+      };
+      getRequest.onerror = () => {
+        reject(
+          new StorageError(
+            `Failed to check existing contact: ${getRequest.error?.message || "Unknown error"}`,
+            getRequest.error
+          )
+        );
+      };
+    });
+  }
+
+  async deleteContact(id) {
+    if (!this.db) {
+      throw new StorageError("Database not initialized");
+    }
+
+    return new Promise((resolve, reject) => {
+      const transaction = this.db.transaction("contacts", "readwrite");
+      const store = transaction.objectStore("contacts");
+      const request = store.delete(id);
+
+      request.onsuccess = () => resolve();
+
+      request.onerror = () => {
+        reject(
+          new StorageError(
+            `Failed to delete contact '${id}': ${request.error?.message || "Unknown error"}`,
+            request.error
+          )
+        );
+      };
+    });
+  }
+
   // ===== Private Helper Methods =====
 
   _matchesFilters(payment, request) {