@rainlanguage/sqlite-web 0.0.2 → 0.0.4

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rainlanguage/sqlite-web",
   "type": "module",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "repository": {
     "type": "git",
     "url": "https://github.com/rainlanguage/sqlite-web"

package/sqlite_web.d.ts

@@ -1,64 +1,103 @@
 /* tslint:disable */
 /* eslint-disable */
-export type WasmEncodedResult<T> = { value: T; error: undefined } | { value: undefined; error: WasmEncodedError };
-
 export interface WasmEncodedError {
     msg: string;
     readableMsg: string;
 }
 
+export type WasmEncodedResult<T> = { value: T; error: undefined } | { value: undefined; error: WasmEncodedError };
+
+
 export class SQLiteWasmDatabase {
-  private constructor();
-  free(): void;
-  /**
-   * Create a new database connection with fully embedded worker
-   */
-  static new(db_name: string): Promise<WasmEncodedResult<SQLiteWasmDatabase>>;
-  /**
-   * Execute a SQL query (optionally parameterized via JS Array)
-   *
-   * Passing `undefined`/`null` from JS maps to `None`.
-   */
-  query(sql: string, params?: Array<any> | null): Promise<WasmEncodedResult<string>>;
-  wipeAndRecreate(): Promise<WasmEncodedResult<void>>;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Append up to 512 KiB of SQL text. Chunks may split a SQL statement,
+     * but must contain valid UTF-16 without splitting a surrogate pair.
+     * The dump's outer BEGIN/COMMIT statements are accepted but owned by the worker.
+     */
+    appendSqlDumpChunk(id: string, sql: any): Promise<WasmEncodedResult<string>>;
+    /**
+     * Begin an atomic SQL dump import. Append bounded text chunks, then finish
+     * to commit. SQL validation/execution failures and cancellation roll back.
+     * Worker loss during finish can leave the commit outcome unknown, including
+     * when the coordinator returns an error; check or reset before retrying.
+     */
+    beginSqlDumpImport(): Promise<WasmEncodedResult<string>>;
+    /**
+     * Roll back the active import.
+     */
+    cancelSqlDumpImport(id: string): Promise<WasmEncodedResult<string>>;
+    /**
+     * Commit all imported statements. A partial trailing statement rolls back.
+     */
+    finishSqlDumpImport(id: string): Promise<WasmEncodedResult<string>>;
+    /**
+     * Create a new database connection with fully embedded worker
+     */
+    static new(db_name: string): Promise<WasmEncodedResult<SQLiteWasmDatabase>>;
+    /**
+     * Execute a SQL query (optionally parameterized via JS Array)
+     *
+     * Passing `undefined`/`null` from JS maps to `None`.
+     */
+    query(sql: string, params?: Array<any> | null): Promise<WasmEncodedResult<string>>;
+    /**
+     * Execute a list of single SQL statements atomically as one worker job.
+     *
+     * Each item must be `{ sql: string, params?: Array }`. Do not include
+     * transaction-control statements; the worker owns the transaction.
+     */
+    transaction(statements: Array<any>): Promise<WasmEncodedResult<string>>;
+    wipeAndRecreate(): Promise<WasmEncodedResult<void>>;
 }
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
-  readonly memory: WebAssembly.Memory;
-  readonly __wbg_sqlitewasmdatabase_free: (a: number, b: number) => void;
-  readonly sqlitewasmdatabase_new: (a: number, b: number) => any;
-  readonly sqlitewasmdatabase_query: (a: number, b: number, c: number, d: number) => any;
-  readonly sqlitewasmdatabase_wipeAndRecreate: (a: number) => any;
-  readonly __wbindgen_malloc: (a: number, b: number) => number;
-  readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
-  readonly __wbindgen_exn_store: (a: number) => void;
-  readonly __externref_table_alloc: () => number;
-  readonly __wbindgen_export_4: WebAssembly.Table;
-  readonly __wbindgen_export_5: WebAssembly.Table;
-  readonly closure37_externref_shim: (a: number, b: number, c: any) => void;
-  readonly closure21_externref_shim: (a: number, b: number, c: any, d: any) => void;
-  readonly __wbindgen_start: () => void;
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_sqlitewasmdatabase_free: (a: number, b: number) => void;
+    readonly sqlitewasmdatabase_appendSqlDumpChunk: (a: number, b: number, c: number, d: any) => any;
+    readonly sqlitewasmdatabase_beginSqlDumpImport: (a: number) => any;
+    readonly sqlitewasmdatabase_cancelSqlDumpImport: (a: number, b: number, c: number) => any;
+    readonly sqlitewasmdatabase_finishSqlDumpImport: (a: number, b: number, c: number) => any;
+    readonly sqlitewasmdatabase_new: (a: number, b: number) => any;
+    readonly sqlitewasmdatabase_query: (a: number, b: number, c: number, d: number) => any;
+    readonly sqlitewasmdatabase_transaction: (a: number, b: any) => any;
+    readonly sqlitewasmdatabase_wipeAndRecreate: (a: number) => any;
+    readonly wasm_bindgen__convert__closures_____invoke__h662cc5297105c4a7: (a: number, b: number, c: any) => [number, number];
+    readonly wasm_bindgen__convert__closures_____invoke__h3fea4067346f5309: (a: number, b: number, c: any, d: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h27ec19c17abe8f50: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h78dad3b4b0b34364: (a: number, b: number) => void;
+    readonly __wbindgen_malloc: (a: number, b: number) => number;
+    readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_exn_store: (a: number) => void;
+    readonly __externref_table_alloc: () => number;
+    readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __wbindgen_destroy_closure: (a: number, b: number) => void;
+    readonly __externref_table_dealloc: (a: number) => void;
+    readonly __wbindgen_start: () => void;
 }
 
 export type SyncInitInput = BufferSource | WebAssembly.Module;
+
 /**
-* Instantiates the given `module`, which can either be bytes or
-* a precompiled `WebAssembly.Module`.
-*
-* @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
-*
-* @returns {InitOutput}
-*/
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
 export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
 
 /**
-* If `module_or_path` is {RequestInfo} or {URL}, makes a request and
-* for everything else, calls `WebAssembly.instantiate` directly.
-*
-* @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
-*
-* @returns {Promise<InitOutput>}
-*/
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
 export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;