supastash 0.1.62 → 0.2.0

package/dist/utils/query/helpers/localDb/upsertMany.js

@@ -35,7 +35,7 @@ export async function upsertMany(items, opts, state) {
     }
     const upserted = [];
     const remotePayload = [];
-    const run = async () => {
+    const run = async (db) => {
         for (let i = 0; i < items.length; i++) {
             const input = items[i] ?? {};
             const row = { ...input };
@@ -120,7 +120,14 @@ export async function upsertMany(items, opts, state) {
         }
     };
     try {
-        await run();
+        if (opts.withTx) {
+            await db.withTransaction(async (tx) => {
+                await run(tx);
+            });
+        }
+        else {
+            await run(opts.tx ?? db);
+        }
         const newState = { ...state, payload: remotePayload };
         if (remoteCalls.includes(newState.type)) {
             queueRemoteCall(newState);

package/dist/utils/query/helpers/mainQueryHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mainQueryHelpers.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/helpers/mainQueryHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACf,MAAM,4BAA4B,CAAC;AAOpC,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACZ,IAAI,CAUN;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GACtB,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,CAc5B;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,WAAW,EAAE,CAAC,EAAE,CAAC,EAC3E,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAChD,YAAY,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,GAC7C,CAAC,KAAK,GAAG;IAAE,aAAa,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC,GAAG,IAAI,CAwBrD;AAED,wBAAsB,eAAe,CACnC,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,OAAO,EACjB,CAAC,EACD,CAAC,EAED,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC7B,OAAO,CAAC;IACT,WAAW,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACjD,YAAY,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;CAChD,CAAC,CAkED"}
+{"version":3,"file":"mainQueryHelpers.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/helpers/mainQueryHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACf,MAAM,4BAA4B,CAAC;AAOpC,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACZ,IAAI,CAUN;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GACtB,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,CAc5B;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,WAAW,EAAE,CAAC,EAAE,CAAC,EAC3E,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAChD,YAAY,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,GAC7C,CAAC,KAAK,GAAG;IAAE,aAAa,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC,GAAG,IAAI,CAwBrD;AAmDD,wBAAsB,eAAe,CACnC,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,OAAO,EACjB,CAAC,EACD,CAAC,EAED,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC7B,OAAO,CAAC;IACT,WAAW,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACjD,YAAY,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;CAChD,CAAC,CAiED"}

package/dist/utils/query/helpers/mainQueryHelpers.js

@@ -46,20 +46,45 @@ export function getCommonError(table, method, localResult, remoteResult) {
     }
     return null;
 }
-export async function runSyncStrategy(state) {
-    const { type } = state;
+async function handleSelect(state) {
     let localResult = null;
     let remoteResult = null;
-    if (state.method === "select") {
-        if (state.type.includes("remote")) {
+    const isEmpty = (result) => result?.error ||
+        !result?.data ||
+        (Array.isArray(result.data) && result.data.length === 0);
+    if (state.fetchPolicy === "localFirst") {
+        localResult = await queryLocalDb(state);
+        if (isEmpty(localResult)) {
             remoteResult = await querySupabase(state);
-            localResult = await queryLocalDb(state);
-            return { localResult, remoteResult };
         }
-        else {
+        return { localResult, remoteResult };
+    }
+    if (state.fetchPolicy === "remoteFirst") {
+        remoteResult = await querySupabase(state);
+        if (isEmpty(remoteResult)) {
             localResult = await queryLocalDb(state);
-            return { localResult, remoteResult };
+            return { localResult, remoteResult: null };
         }
+        return { localResult: null, remoteResult };
+    }
+    if (state.type === "remoteFirst") {
+        remoteResult = await querySupabase(state);
+        localResult = await queryLocalDb(state);
+        return { localResult, remoteResult };
+    }
+    if (state.type === "remoteOnly") {
+        remoteResult = await querySupabase(state);
+        return { localResult, remoteResult: null };
+    }
+    localResult = await queryLocalDb(state);
+    return { localResult, remoteResult };
+}
+export async function runSyncStrategy(state) {
+    const { type } = state;
+    let localResult = null;
+    let remoteResult = null;
+    if (state.method === "select") {
+        return await handleSelect(state);
     }
     const isUpsert = state.method === "upsert";
     switch (type) {
@@ -71,9 +96,14 @@ export async function runSyncStrategy(state) {
             break;
         case "localFirst":
             localResult = await queryLocalDb(state);
+            // If we are in a transaction, we don't want to queue a remote call
+            // Remote calls are handled write after the transaction is committed
+            if (state.txId)
+                return { localResult, remoteResult: null };
             if (state.viewRemoteResult) {
                 if (isUpsert) {
                     logWarn("Cannot view remote result for upserts. Data will still be synced.");
+                    queueRemoteCall(state);
                     return { localResult, remoteResult: null };
                 }
                 remoteResult = await querySupabase(state);

package/dist/utils/query/helpers/queueRemote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queueRemote.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/helpers/queueRemote.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,WAAW,EACX,cAAc,EACf,MAAM,4BAA4B,CAAC;AA0CpC,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,OAAO,EAAE,CAAC,EACzE,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC,CAYlB"}
+{"version":3,"file":"queueRemote.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/helpers/queueRemote.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,WAAW,EACX,cAAc,EACf,MAAM,4BAA4B,CAAC;AAuCpC,wBAAsB,eAAe,CACnC,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,OAAO,EACjB,CAAC,EACD,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAalD"}

package/dist/utils/query/helpers/queueRemote.js

@@ -1,13 +1,12 @@
 import { getSupastashConfig } from "../../../core/config";
 import { isOnline } from "../../../utils/connection";
+import { generateUUIDv4 } from "../../../utils/genUUID";
 import { log, logWarn } from "../../../utils/logs";
 import { getQueryStatusFromDb } from "../../../utils/sync/queryStatus";
 import { supastashEventBus } from "../../events/eventBus";
 import { querySupabase } from "../remoteQuery/supabaseQuery";
 let batchQueue = [];
 let isProcessing = false;
-let batchTimer = null;
-const BATCH_DELAY = 10;
 const MAX_RETRIES = 3;
 const MAX_OFFLINE_RETRIES = 5;
 const retryCount = new Map();
@@ -24,26 +23,24 @@ function delay(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
 function generateOpKey(state) {
-    return `${state.table}_${state.method}_${state.id}_${JSON.stringify(state.payload)}`;
+    return state.id ? state.id : generateUUIDv4();
 }
-export function queueRemoteCall(state) {
-    return new Promise((resolve, reject) => {
+export async function queueRemoteCall(state) {
+    return new Promise(async (resolve, reject) => {
+        void reject;
         const opKey = generateOpKey(state);
         if (successfulCalls.has(opKey)) {
             resolve(true);
             return;
         }
         batchQueue.push({ state, opKey, resolve, reject });
-        scheduleBatch();
+        await startWorkerIfNeeded();
     });
 }
-function scheduleBatch() {
-    if (batchTimer)
+async function startWorkerIfNeeded() {
+    if (isProcessing)
         return;
-    batchTimer = setTimeout(() => {
-        processBatch();
-        batchTimer = null;
-    }, BATCH_DELAY);
+    await processQueue();
 }
 async function executeSupabaseCall(state) {
     const config = getSupastashConfig();
@@ -51,7 +48,7 @@ async function executeSupabaseCall(state) {
     if (!Array.isArray(payload)) {
         return querySupabase(state, true);
     }
-    const batchSize = config.supabaseBatchSize ?? 100;
+    const batchSize = config.supabaseBatchSize ?? 800;
     for (let i = 0; i < payload.length; i += batchSize) {
         const chunk = payload.slice(i, i + batchSize);
         const result = await querySupabase({
@@ -64,19 +61,21 @@ async function executeSupabaseCall(state) {
     }
     return { error: null };
 }
-async function processBatch() {
-    if (isProcessing || batchQueue.length === 0)
+async function processQueue() {
+    if (isProcessing)
         return;
     isProcessing = true;
-    const batch = [...batchQueue];
-    batchQueue = [];
-    for (const call of batch) {
-        const { state, opKey, resolve, reject } = call;
+    while (batchQueue.length > 0) {
+        const call = batchQueue[0];
+        const { state, opKey, resolve } = call;
         if (successfulCalls.has(opKey)) {
+            batchQueue.shift();
             resolve(true);
             continue;
         }
         try {
+            let shouldRemove = false;
+            let isSuccess = false;
             while ((retryCount.get(opKey) ?? 0) <= MAX_RETRIES) {
                 const isConnected = await isOnline();
                 if (!isConnected) {
@@ -85,11 +84,12 @@ async function processBatch() {
                     if (offlineRetries > MAX_OFFLINE_RETRIES) {
                         if (!seenFailureLog.has(opKey)) {
                             seenFailureLog.add(opKey);
-                            log(`[Supastash] Offline — persisted locally, will retry later: ${opKey}`);
+                            log(`[Supastash] Offline — persisted locally, will retry later:  ${state.table} with ${state.method} `);
                         }
                         await getQueryStatusFromDb(state.table);
                         supastashEventBus.emit("updateSyncStatus");
-                        resolve(false);
+                        shouldRemove = true;
+                        isSuccess = false;
                         break;
                     }
                     await delay(1000);
@@ -101,7 +101,8 @@ async function processBatch() {
                     successfulCalls.add(opKey);
                     retryCount.delete(opKey);
                     log(`[Supastash] Synced item on ${state.table} with ${state.method} to supabase`);
-                    resolve(true);
+                    shouldRemove = true;
+                    isSuccess = true;
                     break;
                 }
                 else {
@@ -112,7 +113,8 @@ async function processBatch() {
                             seenFailureLog.add(opKey);
                             logWarn(`[Supastash] Duplicate key on ${state.table} (op=${state.method}) — seems already synced; will retry on next full sync: id=${state.id ?? "-"}`);
                         }
-                        resolve(true);
+                        shouldRemove = true;
+                        isSuccess = true;
                         break;
                     }
                     if (currentRetries >= MAX_RETRIES) {
@@ -120,18 +122,25 @@ async function processBatch() {
                             seenFailureLog.add(opKey);
                             logWarn(`[Supastash] Gave up on ${state.table} with ${state.method} after ${MAX_RETRIES} retries — will retry on next sync \nError message: ${error.message}`);
                         }
-                        resolve(false);
+                        shouldRemove = true;
+                        isSuccess = false;
                         break;
                     }
                     await delay(1000 * (currentRetries + 1));
                 }
             }
+            if (shouldRemove) {
+                batchQueue.shift();
+                resolve(isSuccess);
+            }
         }
         catch (err) {
             if (!seenFailureLog.has(opKey)) {
                 seenFailureLog.add(opKey);
                 logWarn(`[Supastash] Unexpected error processing ${opKey} — ${String(err.message ?? err)}`);
             }
+            batchQueue.shift();
+            resolve(false);
         }
     }
     isProcessing = false;

package/dist/utils/query/localDbQuery/delete.d.ts

@@ -1,16 +1,22 @@
-import { FilterCalls, SupatashDeleteResult, SyncMode } from "../../../types/query.types";
+import { CrudMethods, FilterCalls, SupastashQuery, SupatashDeleteResult } from "../../../types/query.types";
+import { SupastashSQLiteExecutor } from "../../../types/supastashConfig.types";
 /**
  * Soft delete: Sets `deleted_at` timestamp based on provided filters.
  * @param table - The name of the table to delete from
  * @param filters - The filters to apply to the delete query
  * @returns The result of the delete query
  */
-export declare function deleteData<Z = any>(table: string, filters: FilterCalls[] | null, syncMode?: SyncMode): Promise<SupatashDeleteResult<Z>>;
+export declare function deleteData<Z = any>(state: SupastashQuery<CrudMethods, boolean, Z>): Promise<SupatashDeleteResult<Z>>;
 /**
  * Hard delete: Permanently removes a row by its `id`.
  * @param table - The name of the table to delete from
  * @param id - The id of the row to delete
  * @returns The result of the delete query
  */
-export declare function permanentlyDeleteData<R = any>(table: string, filters: FilterCalls[] | null): Promise<SupatashDeleteResult<R>>;
+export declare function permanentlyDeleteData<R = any>({ table, filters, tx, throwOnError, }: {
+    table: string;
+    filters: FilterCalls[] | null;
+    tx: SupastashSQLiteExecutor | null;
+    throwOnError?: boolean;
+}): Promise<SupatashDeleteResult<R>>;
 //# sourceMappingURL=delete.d.ts.map

package/dist/utils/query/localDbQuery/delete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/localDbQuery/delete.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,QAAQ,EACT,MAAM,4BAA4B,CAAC;AAKpC;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,GAAG,EACtC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,EAC7B,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CA+BlC;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,GAAG,GAAG,EACjD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAkBlC"}
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/localDbQuery/delete.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,WAAW,EACX,cAAc,EACd,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAK/E;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,GAAG,EACtC,KAAK,EAAE,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,GAC7C,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAuClC;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,GAAG,GAAG,EAAE,EACnD,KAAK,EACL,OAAO,EACP,EAAE,EACF,YAAmB,GACpB,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC9B,EAAE,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAmBnC"}

package/dist/utils/query/localDbQuery/delete.js

@@ -8,25 +8,34 @@ import { buildWhereClause } from "../helpers/remoteDb/queryFilterBuilder";
  * @param filters - The filters to apply to the delete query
  * @returns The result of the delete query
  */
-export async function deleteData(table, filters, syncMode) {
+export async function deleteData(state) {
+    const { table, filters, tx, type: syncMode } = state;
     await assertTableExists(table);
     const { clause, values: filterValues } = buildWhereClause(filters ?? []);
     try {
-        const db = await getSupastashDb();
+        const db = tx ?? (await getSupastashDb());
         const timeStamp = new Date().toISOString();
         const itemsToBeDeleted = await db.getAllAsync(`SELECT * FROM ${table} ${clause}`, filterValues);
         await db.runAsync(`UPDATE ${table} SET deleted_at = ?, updated_at = ?, synced_at = NULL ${clause}`, [timeStamp, timeStamp, ...filterValues]);
         if (syncMode === "localOnly" || syncMode === "remoteFirst") {
-            permanentlyDeleteData(table, filters);
+            await permanentlyDeleteData({
+                table,
+                filters,
+                tx,
+                throwOnError: state.throwOnError,
+            });
         }
         return { error: null, data: itemsToBeDeleted };
     }
     catch (error) {
         logError(`[Supastash] ${error}`);
+        if (state.throwOnError)
+            throw error;
         return {
             error: {
                 message: error instanceof Error ? error.message : String(error),
             },
+            data: null,
         };
     }
 }
@@ -36,16 +45,18 @@ export async function deleteData(table, filters, syncMode) {
  * @param id - The id of the row to delete
  * @returns The result of the delete query
  */
-export async function permanentlyDeleteData(table, filters) {
+export async function permanentlyDeleteData({ table, filters, tx, throwOnError = true, }) {
     await assertTableExists(table);
     try {
-        const db = await getSupastashDb();
+        const db = tx ?? (await getSupastashDb());
         const { clause, values: filterValues } = buildWhereClause(filters ?? []);
         await db.runAsync(`DELETE FROM ${table} ${clause}`, filterValues);
         return { error: null };
     }
     catch (error) {
         logError(`[Supastash] ${error}`);
+        if (throwOnError)
+            throw error;
         return {
             error: {
                 message: error instanceof Error ? error.message : String(error),

package/dist/utils/query/localDbQuery/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/localDbQuery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACf,MAAM,4BAA4B,CAAC;AAGpC;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,OAAO,EACjB,CAAC,EACD,CAAC,EACD,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAmCvE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/localDbQuery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACf,MAAM,4BAA4B,CAAC;AAGpC;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,OAAO,EACjB,CAAC,EACD,CAAC,EACD,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAYvE"}

package/dist/utils/query/localDbQuery/index.js

@@ -5,11 +5,11 @@ import getLocalMethod from "../helpers/localDb/getLocalMethod";
  * @returns The result of the query
  */
 export async function queryLocalDb(state) {
-    const { table, method, payload, filters, limit, select, isSingle, onConflictKeys, preserveTimestamp, type, } = state;
+    const { method } = state;
     if (!method) {
-        throw new Error("Method is required for local call");
+        throw new Error("[Supastash] Method is required for local call");
     }
-    const query = getLocalMethod(table, method, select, payload, filters, limit, isSingle, state, onConflictKeys, type, preserveTimestamp);
+    const query = getLocalMethod(state);
     const result = await query();
     return result;
 }

package/dist/utils/query/localDbQuery/insert.d.ts

@@ -1,4 +1,4 @@
-import { PayloadListResult, PayloadResult, SyncMode } from "../../../types/query.types";
+import { CrudMethods, PayloadListResult, PayloadResult, SupastashQuery } from "../../../types/query.types";
 /**
  * Inserts data locally, sets synced_at to null pending update to remote server
  *
@@ -6,5 +6,5 @@ import { PayloadListResult, PayloadResult, SyncMode } from "../../../types/query
  * @param payload - The payload to insert
  * @returns a data / error object
  */
-export declare function insertData<T extends boolean, R, Z>(table: string, payload: R[] | null, syncMode?: SyncMode, isSingle?: T): Promise<T extends true ? PayloadResult<Z> : PayloadListResult<Z>>;
+export declare function insertData<T extends boolean, R, Z>(state: SupastashQuery<CrudMethods, boolean, R>): Promise<T extends true ? PayloadResult<Z> : PayloadListResult<Z>>;
 //# sourceMappingURL=insert.d.ts.map

package/dist/utils/query/localDbQuery/insert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"insert.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/localDbQuery/insert.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,QAAQ,EACT,MAAM,4BAA4B,CAAC;AAKpC;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC,EACtD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,EACnB,QAAQ,CAAC,EAAE,QAAQ,EACnB,QAAQ,CAAC,EAAE,CAAC,GACX,OAAO,CAAC,CAAC,SAAS,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CA8BnE"}
+{"version":3,"file":"insert.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/localDbQuery/insert.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,cAAc,EACf,MAAM,4BAA4B,CAAC;AAKpC;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC,EACtD,KAAK,EAAE,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,GAC7C,OAAO,CAAC,CAAC,SAAS,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAwCnE"}

package/dist/utils/query/localDbQuery/insert.js

@@ -8,17 +8,18 @@ import { insertMany } from "../helpers/localDb/insertMany";
  * @param payload - The payload to insert
  * @returns a data / error object
  */
-export async function insertData(table, payload, syncMode, isSingle) {
-    if (!table)
-        throw new Error("Table name was not provided for an insert call");
-    if (!payload)
-        throw new Error(`Payload data was not provided for an insert call on ${table}`);
+export async function insertData(state) {
+    const { table, tx, type: syncMode, isSingle, withTx, payload, } = state;
     try {
+        if (!payload)
+            throw new Error(`[Supastash] Payload data was not provided for an insert call on ${table}`);
         await assertTableExists(table);
         const inserted = await insertMany(payload, {
             table,
             syncMode,
             returnInsertedRows: true,
+            withTx: withTx,
+            tx,
         });
         return {
             error: null,
@@ -27,6 +28,8 @@ export async function insertData(table, payload, syncMode, isSingle) {
     }
     catch (error) {
         logError(`[Supastash] ${error}`);
+        if (state.throwOnError)
+            throw error;
         return {
             error: {
                 message: error instanceof Error ? error.message : String(error),

package/dist/utils/query/localDbQuery/select.d.ts

@@ -1,4 +1,4 @@
-import { FilterCalls, PayloadListResult, PayloadResult } from "../../../types/query.types";
+import { CrudMethods, PayloadListResult, PayloadResult, SupastashQuery } from "../../../types/query.types";
 /**
  * Selects one or many rows from the local database.
  *
@@ -9,5 +9,5 @@ import { FilterCalls, PayloadListResult, PayloadResult } from "../../../types/qu
  * @param isSingle - Whether to return a single row or multiple rows
  * @returns a data / error object
  */
-export declare function selectData<T extends boolean, R, Z>(table: string, select: string, filters: FilterCalls[] | null, limit: number | null, isSingle: T): Promise<T extends true ? PayloadResult<Z> : PayloadListResult<Z>>;
+export declare function selectData<T extends boolean, R, Z>(state: SupastashQuery<CrudMethods, boolean, R>): Promise<T extends true ? PayloadResult<Z> : PayloadListResult<Z>>;
 //# sourceMappingURL=select.d.ts.map

package/dist/utils/query/localDbQuery/select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/localDbQuery/select.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,aAAa,EACd,MAAM,4BAA4B,CAAC;AAMpC;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC,EACtD,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,EAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,QAAQ,EAAE,CAAC,GACV,OAAO,CAAC,CAAC,SAAS,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAoCnE"}
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/localDbQuery/select.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,cAAc,EACf,MAAM,4BAA4B,CAAC;AAMpC;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC,EACtD,KAAK,EAAE,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,GAC7C,OAAO,CAAC,CAAC,SAAS,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAuCnE"}

package/dist/utils/query/localDbQuery/select.js

@@ -13,7 +13,8 @@ import { buildWhereClause } from "../helpers/remoteDb/queryFilterBuilder";
  * @param isSingle - Whether to return a single row or multiple rows
  * @returns a data / error object
  */
-export async function selectData(table, select, filters, limit, isSingle) {
+export async function selectData(state) {
+    const { table, filters, limit, isSingle, tx, select } = state;
     if (!table)
         throw new Error("Table name was not provided for a select call");
     await assertTableExists(table);
@@ -21,7 +22,7 @@ export async function selectData(table, select, filters, limit, isSingle) {
     const limitClause = limit ? `LIMIT ${limit}` : "";
     const query = `SELECT ${select} FROM ${table} ${clause} ${limitClause}`;
     try {
-        const db = await getSupastashDb();
+        const db = tx ?? (await getSupastashDb());
         let data;
         if (isSingle) {
             const result = await db.getFirstAsync(query, filterValues);
@@ -35,6 +36,8 @@ export async function selectData(table, select, filters, limit, isSingle) {
     }
     catch (error) {
         logError(`[Supastash] ${error}`);
+        if (state.throwOnError)
+            throw error;
         return {
             error: {
                 message: error instanceof Error ? error.message : String(error),

package/dist/utils/query/localDbQuery/update.d.ts

@@ -1,4 +1,4 @@
-import { FilterCalls, PayloadListResult, PayloadResult, SyncMode } from "../../../types/query.types";
+import { CrudMethods, PayloadListResult, PayloadResult, SupastashQuery } from "../../../types/query.types";
 /**
  * Updates data locally, sets synced_at to null pending update to remote server
  *
@@ -7,5 +7,5 @@ import { FilterCalls, PayloadListResult, PayloadResult, SyncMode } from "../../.
  * @param filters - The filters to apply to the update query
  * @returns a data / error object
  */
-export declare function updateData<T extends boolean, R, Z>(table: string, payload: R | null, filters: FilterCalls[] | null, syncMode?: SyncMode, isSingle?: T, preserveTimestamp?: boolean): Promise<T extends true ? PayloadResult<Z> : PayloadListResult<Z>>;
+export declare function updateData<T extends boolean, R, Z>(state: SupastashQuery<CrudMethods, boolean, R>): Promise<T extends true ? PayloadResult<Z> : PayloadListResult<Z>>;
 //# sourceMappingURL=update.d.ts.map

package/dist/utils/query/localDbQuery/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/localDbQuery/update.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EAEX,iBAAiB,EACjB,aAAa,EACb,QAAQ,EACT,MAAM,4BAA4B,CAAC;AASpC;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC,EACtD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,GAAG,IAAI,EACjB,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,EAC7B,QAAQ,CAAC,EAAE,QAAQ,EACnB,QAAQ,CAAC,EAAE,CAAC,EACZ,iBAAiB,CAAC,EAAE,OAAO,GAC1B,OAAO,CAAC,CAAC,SAAS,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CA+EnE"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/localDbQuery/update.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EAEX,iBAAiB,EACjB,aAAa,EACb,cAAc,EACf,MAAM,4BAA4B,CAAC;AASpC;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC,EACtD,KAAK,EAAE,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,GAC7C,OAAO,CAAC,CAAC,SAAS,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CA0FnE"}

package/dist/utils/query/localDbQuery/update.js

@@ -14,7 +14,8 @@ const warned = new Set();
  * @param filters - The filters to apply to the update query
  * @returns a data / error object
  */
-export async function updateData(table, payload, filters, syncMode, isSingle, preserveTimestamp) {
+export async function updateData(state) {
+    const { table, payload, filters, type: syncMode, isSingle, preserveTimestamp, tx, } = state;
     if (!payload)
         throw new Error(`Payload data was not provided for an update call on ${table}`);
     if (!table)
@@ -48,7 +49,7 @@ export async function updateData(table, payload, filters, syncMode, isSingle, pr
         .map((c) => getSafeValue(newPayload[c]));
     const { clause, values: filterValues } = buildWhereClause(filters ?? []);
     try {
-        const db = await getSupastashDb();
+        const db = tx ?? (await getSupastashDb());
         await db.runAsync(`UPDATE ${table} SET ${cols} ${clause}`, [
             ...values,
             ...filterValues,
@@ -68,6 +69,8 @@ export async function updateData(table, payload, filters, syncMode, isSingle, pr
     }
     catch (error) {
         logError(`[Supastash] ${error}`);
+        if (state.throwOnError)
+            throw error;
         return {
             error: {
                 message: error instanceof Error ? error.message : String(error),

package/dist/utils/query/localDbQuery/upsert.d.ts

@@ -1,9 +1,9 @@
-import { CrudMethods, PayloadListResult, PayloadResult, SupastashQuery, SyncMode } from "../../../types/query.types";
+import { CrudMethods, PayloadListResult, PayloadResult, SupastashQuery } from "../../../types/query.types";
 /**
  * Performs upsert-like logic on local DB:
  * - If a row with the same ID exists, it is updated.
  * - Otherwise, it is inserted.
  * Returns all the rows that were upserted.
  */
-export declare function upsertData<T extends boolean, R, Z>(table: string, payload: R | R[] | null, state: SupastashQuery<CrudMethods, T, R>, syncMode?: SyncMode, isSingle?: T, onConflictKeys?: string[], preserveTimestamp?: boolean): Promise<T extends true ? PayloadResult<Z> : PayloadListResult<Z>>;
+export declare function upsertData<T extends boolean, R, Z>(state: SupastashQuery<CrudMethods, boolean, R>): Promise<T extends true ? PayloadResult<Z> : PayloadListResult<Z>>;
 //# sourceMappingURL=upsert.d.ts.map

package/dist/utils/query/localDbQuery/upsert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upsert.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/localDbQuery/upsert.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,QAAQ,EACT,MAAM,4BAA4B,CAAC;AAOpC;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC,EACtD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EACvB,KAAK,EAAE,cAAc,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,EACxC,QAAQ,CAAC,EAAE,QAAQ,EACnB,QAAQ,CAAC,EAAE,CAAC,EACZ,cAAc,GAAE,MAAM,EAAW,EACjC,iBAAiB,CAAC,EAAE,OAAO,GAC1B,OAAO,CAAC,CAAC,SAAS,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAkCnE"}
+{"version":3,"file":"upsert.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/localDbQuery/upsert.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,cAAc,EACf,MAAM,4BAA4B,CAAC;AAOpC;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC,EACtD,KAAK,EAAE,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,GAC7C,OAAO,CAAC,CAAC,SAAS,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CA+CnE"}

package/dist/utils/query/localDbQuery/upsert.js

@@ -8,9 +8,10 @@ const warned = new Set();
  * - Otherwise, it is inserted.
  * Returns all the rows that were upserted.
  */
-export async function upsertData(table, payload, state, syncMode, isSingle, onConflictKeys = ["id"], preserveTimestamp) {
-    if (!payload || !table)
-        throw new Error("Table and payload are required for upsert.");
+export async function upsertData(state) {
+    const { table, payload, type: syncMode, isSingle, onConflictKeys, preserveTimestamp, } = state;
+    if (!payload)
+        throw new Error(`[Supastash] Payload data was not provided for an upsert call on ${table}`);
     await assertTableExists(table);
     const items = Array.isArray(payload) ? payload : [payload];
     try {
@@ -20,6 +21,8 @@ export async function upsertData(table, payload, state, syncMode, isSingle, onCo
             returnRows: true,
             onConflictKeys,
             preserveTimestamp,
+            withTx: state.withTx,
+            tx: state.tx,
         }, state);
         return {
             error: null,
@@ -28,6 +31,8 @@ export async function upsertData(table, payload, state, syncMode, isSingle, onCo
     }
     catch (error) {
         logError(`[Supastash] ${error}`);
+        if (state.throwOnError)
+            throw error;
         return {
             error: {
                 message: error instanceof Error ? error.message : String(error),

package/dist/utils/query/remoteQuery/supabaseQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"supabaseQuery.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/remoteQuery/supabaseQuery.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACf,MAAM,4BAA4B,CAAC;AAWpC;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC,EACzD,KAAK,EAAE,cAAc,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,EACxC,SAAS,UAAQ,GAChB,OAAO,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAsNpC"}
+{"version":3,"file":"supabaseQuery.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/remoteQuery/supabaseQuery.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACf,MAAM,4BAA4B,CAAC;AAWpC;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC,EACzD,KAAK,EAAE,cAAc,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,EACxC,SAAS,UAAQ,GAChB,OAAO,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CA0NpC"}

package/dist/utils/query/remoteQuery/supabaseQuery.js

@@ -125,6 +125,9 @@ export async function querySupabase(state, isBatched = false) {
         (viewRemoteResult || type === "remoteOnly")) {
         filterQuery = filterQuery.select();
     }
+    if (state.throwOnError) {
+        filterQuery = filterQuery.throwOnError();
+    }
     const result = await filterQuery;
     const db = await getSupastashDb();
     if (result.error) {
@@ -162,7 +165,7 @@ export async function querySupabase(state, isBatched = false) {
                 ...filterValues,
             ]);
             if (method === "delete") {
-                await permanentlyDeleteData(table, filters);
+                await permanentlyDeleteData({ table, filters, tx: state.tx });
             }
         }
         refreshScreen(table);

package/dist/utils/reusedHelpers.d.ts

@@ -0,0 +1,8 @@
+import { SupastashFilter } from "../types/realtimeData.types";
+export declare const ReusedHelpers: {
+    isValidFilter<R = any>(filters: SupastashFilter<R>[]): boolean;
+    applyFilters(q: any, filters: SupastashFilter[], table: string): any;
+    buildFilterString<R = any>(filter: SupastashFilter<R> | undefined): string | undefined;
+    buildFilterForSql<R = any>(filter: SupastashFilter<R> | undefined): string | undefined;
+};
+//# sourceMappingURL=reusedHelpers.d.ts.map

package/dist/utils/reusedHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reusedHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/reusedHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAa9D,eAAO,MAAM,aAAa;kBACV,CAAC,iBAAiB,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO;oBA8C9C,GAAG,WAAW,eAAe,EAAE,SAAS,MAAM;sBAoC5C,CAAC,gBACT,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,GACrC,MAAM,GAAG,SAAS;sBA4CH,CAAC,gBACT,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,GACrC,MAAM,GAAG,SAAS;CAkDtB,CAAC"}