@livestore/wa-sqlite 1.0.1-dev.18 → 1.0.1-dev.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livestore/wa-sqlite",
-  "version": "1.0.1-dev.18",
+  "version": "1.0.1-dev.19",
   "type": "module",
   "main": "src/sqlite-api.js",
   "types": "src/types/index.d.ts",

package/src/sqlite-api.js

@@ -280,6 +280,22 @@ export function Factory(Module) {
   //   };
   // })();
 
+  sqlite3.backup = (function() {
+    const fInit = Module.cwrap('sqlite3_backup_init', ...decl('nsns:n'));
+    const fStep = Module.cwrap('sqlite3_backup_step', ...decl('nn:n'));
+    const fFinish = Module.cwrap('sqlite3_backup_finish', ...decl('n:n'));
+    return function(dest, destName, source, sourceName) {
+      verifyDatabase(dest);
+      verifyDatabase(source);
+      const backup = fInit(dest, destName, source, sourceName);
+      if (backup === 0) {
+        throw new SQLiteError('backup failed', SQLite.SQLITE_ERROR);
+      }
+      fStep(backup, -1);
+      return fFinish(backup);
+    };
+  })();
+
   sqlite3.clear_bindings = (function() {
     const fname = 'sqlite3_clear_bindings';
     const f = Module.cwrap(fname, ...decl('n:n'));

package/src/types/index.d.ts

@@ -364,6 +364,35 @@ interface SQLiteAPI {
     // mFlags: number
   ): Uint8Array;
 
+  // sqlite3_backup *sqlite3_backup_init(
+  //   sqlite3 *pDest,                        /* Destination database handle */
+  //   const char *zDestName,                 /* Destination database name */
+  //   sqlite3 *pSource,                      /* Source database handle */
+  //   const char *zSourceName                /* Source database name */
+  // );
+  // int sqlite3_backup_step(sqlite3_backup *p, int nPage);
+  // int sqlite3_backup_finish(sqlite3_backup *p);
+  // int sqlite3_backup_remaining(sqlite3_backup *p);
+  // int sqlite3_backup_pagecount(sqlite3_backup *p);
+
+  backup_init(
+    pDest: number,
+    zDestName: string,
+    pSource: number,
+    zSourceName: string
+  ): number;
+
+  backup_step(p: number, nPage: number): number;
+  backup_finish(p: number): number;
+  backup_remaining(p: number): number;
+  backup_pagecount(p: number): number;
+
+  /**
+   * Combines the `backup_init`, `backup_step`, and `backup_finish` functions.
+   * @returns `SQLITE_OK` (throws exception on error)
+   */
+  backup(pDest: number, zDestName: string, pSource: number, zSourceName: string): number;
+
   /**
    * Reset all bindings on a prepared statement.
    * @see https://www.sqlite.org/c3ref/clear_bindings.html
@@ -1251,6 +1280,12 @@ declare module '@livestore/wa-sqlite/src/VFS.js' {
   }
 }
 
+/** @ignore */
+declare module '@livestore/wa-sqlite/src/FacadeVFS.js' {
+  export type FacadeVFS = any
+}
+  
+
 declare module '@livestore/wa-sqlite/src/examples/AccessHandlePoolVFS.js' {
   import * as VFS from "@livestore/wa-sqlite/src/VFS.js";
   export class AccessHandlePoolVFS extends VFS.Base {