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

package/package.json

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

package/src/sqlite-api.js

@@ -249,19 +249,53 @@ export function Factory(Module) {
     };
   })();
 
+  const SQLITE_SERIALIZE_NOCOPY = 0x0_01
+
   sqlite3.serialize = (function() {
     const fname = 'sqlite3_serialize';
     const f = Module.cwrap(fname, ...decl('nsnn:n'));
-    return function(db, schema, flags) {
+    return function(db, schema) {
       verifyDatabase(db);
       const piSize = tmpPtr[0];
-      const address = f(db, schema, piSize, flags);
+      let address = f(db, schema, piSize, 0);
+      if (address === 0) {
+        address = f(db, schema, piSize, SQLITE_SERIALIZE_NOCOPY);
+      }
       const size = Module.getValue(piSize, '*');
       const result = Module.HEAPU8.subarray(address, address + size);
       return result;
     };
   })();
 
+  // sqlite3.serialize = (function() {
+  //   const fname = 'sqlite3_serialize';
+  //   const f = Module.cwrap(fname, ...decl('nsnn:n'));
+  //   return function(db, schema, flags) {
+  //     verifyDatabase(db);
+  //     const piSize = tmpPtr[0];
+  //     const address = f(db, schema, piSize, flags);
+  //     const size = Module.getValue(piSize, '*');
+  //     const result = Module.HEAPU8.subarray(address, address + size);
+  //     return result;
+  //   };
+  // })();
+
+  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

@@ -361,9 +361,38 @@ interface SQLiteAPI {
   serialize(
     db: number,
     zSchema: string,
-    mFlags: number
+    // 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 {