@livestore/wa-sqlite 1.0.1-dev.4 → 1.0.1-dev.6

package/package.json

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

package/src/sqlite-api.js

@@ -249,6 +249,19 @@ export function Factory(Module) {
     };
   })();
 
+  sqlite3.serialize = (function() {
+    const fname = 'sqlite3_serialize';
+    const f = Module.cwrap(fname, ...decl('nsnn:n'));
+    return function(db, schema, piSize, flags) {
+      verifyDatabase(db);
+      // TODO alloc + free memory for result?
+      const address = f(db, schema, piSize, flags);
+      const result = Module.HEAPU8.subarray(address, address + piSize);
+
+      return result;
+    };
+  })();
+
   sqlite3.clear_bindings = (function() {
     const fname = 'sqlite3_clear_bindings';
     const f = Module.cwrap(fname, ...decl('n:n'));

package/src/types/index.d.ts

@@ -15,7 +15,7 @@
  * each element converted to a byte); SQLite always returns blob data as
  * `Uint8Array`
  */
-export type SQLiteCompatibleType = number|string|Uint8Array|Array<number>|bigint|null;
+type SQLiteCompatibleType = number|string|Uint8Array|Array<number>|bigint|null;
 
 /**
  * SQLite Virtual File System object
@@ -33,7 +33,7 @@ export type SQLiteCompatibleType = number|string|Uint8Array|Array<number>|bigint
  * @see https://sqlite.org/vfs.html
  * @see https://sqlite.org/c3ref/io_methods.html
  */
-export interface SQLiteVFS {
+interface SQLiteVFS {
   /** Maximum length of a file path in UTF-8 bytes (default 64) */
   mxPathName?: number;
 
@@ -178,7 +178,7 @@ declare interface SQLitePrepareOptions {
  * 
  * @see https://sqlite.org/c3ref/funclist.html
  */
-export interface SQLiteAPI {
+interface SQLiteAPI {
   /**
    * Bind a collection of values to a statement
    * 
@@ -341,7 +341,6 @@ export interface SQLiteAPI {
    *   unsigned mFlags         Zero or more SQLITE_DESERIALIZE_* flags
    * );
    */
-
   deserialize(
     db: number,
     zSchema: string,
@@ -351,6 +350,21 @@ export interface SQLiteAPI {
     mFlags: number
   ): number;
 
+  /**
+   * unsigned char *sqlite3_serialize(
+   *  sqlite3 *db,           The database connection
+   *  const char *zSchema,   Which DB to serialize. ex: "main", "temp", ...
+   *  sqlite3_int64 *piSize, Write size of the DB here, if not NULL
+   *  unsigned int mFlags    Zero or more SQLITE_SERIALIZE_* flags
+   * );
+   */
+  serialize(
+    db: number,
+    zSchema: string,
+    piSize: number,
+    mFlags: number
+  ): Uint8Array;
+
   /**
    * Reset all bindings on a prepared statement.
    * @see https://www.sqlite.org/c3ref/clear_bindings.html
@@ -843,6 +857,11 @@ export interface SQLiteAPI {
   vfs_register(vfs: SQLiteVFS, makeDefault?: boolean): number;
 }
 
+declare module '@livestore/wa-sqlite' {
+  export type SQLiteAPI_ = SQLiteAPI;
+  export type SQLiteVFS_ = SQLiteVFS;
+}
+
 /** @ignore */
 declare module '@livestore/wa-sqlite/src/sqlite-constants.js' {
   export const SQLITE_OK: 0;