supastash 0.2.0 → 0.2.1

package/dist/desktop/utils/fetchData/eventQueues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventQueues.d.ts","sourceRoot":"","sources":["../../../../src/desktop/utils/fetchData/eventQueues.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAK3E,iBAAS,cAAc,CAAC,CAAC,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAC3B,eAAe,EAAE,MAAM,eA8CU,MAAM,QAAQ,WAAW,UAgB3D;AAED,eAAe,cAAc,CAAC"}

package/dist/{hooks/supastashData → desktop/utils/fetchData}/eventQueues.js

@@ -1,7 +1,7 @@
 import { useRef } from "react";
-import { deleteData } from "../../utils/fetchData/deleteData";
-import { receiveData } from "../../utils/fetchData/receiveData";
-import useDataState from "./dataState";
+import useDataState from "../../../shared/utils/fetchData/dataState";
+import { deleteData } from "../../../shared/utils/fetchData/deleteData";
+import { receiveData } from "./receiveData";
 function useEventQueues(table, options, flushIntervalMs) {
     const { dataMap } = useDataState(table);
     const insertQueue = useRef([]);

package/dist/{hooks/supastashData → desktop/utils/fetchData}/fetchCalls.d.ts

@@ -1,4 +1,4 @@
-import { RealtimeOptions } from "../../types/realtimeData.types";
+import { RealtimeOptions } from "../../../shared/types/realtimeData.types";
 export declare function fetchCalls<R = any>(table: string, options: RealtimeOptions<R>, initialized: React.RefObject<boolean>): {
     triggerRefresh: () => Promise<void>;
     trigger: () => void;

package/dist/desktop/utils/fetchData/fetchCalls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchCalls.d.ts","sourceRoot":"","sources":["../../../../src/desktop/utils/fetchData/fetchCalls.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,eAAe,EAEhB,MAAM,0CAA0C,CAAC;AAKlD,wBAAgB,UAAU,CAAC,CAAC,GAAG,GAAG,EAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAC3B,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC;;;;;;EA4GtC"}

package/dist/{hooks/supastashData → desktop/utils/fetchData}/fetchCalls.js

@@ -1,9 +1,9 @@
 import { useEffect, useRef, useState } from "react";
-import { syncCalls } from "../../store/syncCalls";
-import { tableFilters, tableFiltersUsed } from "../../store/tableFilters";
-import { fetchLocalData } from "../../utils/fetchData/fetchLocalData";
-import { initialFetch } from "../../utils/fetchData/initialFetch";
-import { logError } from "../../utils/logs";
+import { syncCalls } from "../../../shared/store/syncCalls";
+import { tableFilters, tableFiltersUsed, } from "../../../shared/store/tableFilters";
+import { fetchLocalData } from "../../../shared/utils/fetchData/fetchLocalData";
+import { logError } from "../../../shared/utils/logs";
+import { initialFetch } from "./initialFetch";
 export function fetchCalls(table, options, initialized) {
     const { shouldFetch = true, limit, filter, onPushToRemote, onInsertAndUpdate, useFilterWhileSyncing = true, extraMapKeys, daylength, onlyUseFilterForRealtime, orderBy, orderDesc, sqlFilter, } = options;
     const cancelled = useRef(false);

package/dist/{utils → desktop/utils}/fetchData/initialFetch.d.ts

@@ -1,3 +1,3 @@
-import { SupastashFilter } from "../../types/realtimeData.types";
+import { SupastashFilter } from "../../../shared/types/realtimeData.types";
 export declare function initialFetch(table: string, filter?: SupastashFilter[], onReceiveData?: (payload: any) => Promise<void>, onPushToRemote?: (payload: any[]) => Promise<boolean>): Promise<void>;
 //# sourceMappingURL=initialFetch.d.ts.map

package/dist/desktop/utils/fetchData/initialFetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialFetch.d.ts","sourceRoot":"","sources":["../../../../src/desktop/utils/fetchData/initialFetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAQ3E,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,eAAe,EAAE,EAC1B,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,EAC/C,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,iBAatD"}

package/dist/{utils → desktop/utils}/fetchData/initialFetch.js

@@ -1,7 +1,7 @@
-import { logError } from "../logs";
+import { createTable } from "../../../shared/utils/fetchData/createTable";
+import { logError } from "../../../shared/utils/logs";
 import { updateLocalDb } from "../sync/pullFromRemote/updateLocalDb";
 import { pushLocalDataToRemote } from "../sync/pushLocal/sendUnsyncedToSupabase";
-import { createTable } from "./createTable";
 let isInSync = new Map();
 export async function initialFetch(table, filter, onReceiveData, onPushToRemote) {
     if (isInSync.get(table))

package/dist/{utils → desktop/utils}/fetchData/receiveData.d.ts

@@ -1,3 +1,3 @@
-import { PayloadData } from "../../types/query.types";
+import { PayloadData } from "../../../shared/types/query.types";
 export declare function receiveData(payload: PayloadData, table: string, shouldFetch?: boolean, upsertCall?: (item: any) => void | Promise<void>): Promise<void>;
 //# sourceMappingURL=receiveData.d.ts.map

package/dist/desktop/utils/fetchData/receiveData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receiveData.d.ts","sourceRoot":"","sources":["../../../../src/desktop/utils/fetchData/receiveData.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAShE,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,OAAc,EAC3B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,iBAuCjD"}

package/dist/{utils → desktop/utils}/fetchData/receiveData.js

@@ -1,9 +1,9 @@
-import { getSupastashDb } from "../../db/dbInitializer";
-import { upsertData } from "../../utils/sync/pullFromRemote/updateLocalDb";
-import { checkIfTableExist } from "../../utils/tableValidator";
-import log, { logError } from "../logs";
-import { refreshScreen } from "../refreshScreenCalls";
-import { createTable } from "./createTable";
+import { getSupastashDb } from "../../../shared/db/dbInitializer";
+import { createTable } from "../../../shared/utils/fetchData/createTable";
+import log, { logError } from "../../../shared/utils/logs";
+import { refreshScreen } from "../../../shared/utils/refreshScreenCalls";
+import { checkIfTableExist } from "../../../shared/utils/tableValidator";
+import { upsertData } from "../sync/pullFromRemote/updateLocalDb";
 const DEFAULT_DATE = "1970-01-01T00:00:00Z";
 export async function receiveData(payload, table, shouldFetch = true, upsertCall) {
     if (!shouldFetch)

package/dist/desktop/utils/query/index.d.ts

@@ -0,0 +1,73 @@
+import { CrudMethods, PayloadData, SupastashQuery } from "../../../shared/types/query.types";
+import SupastashCrudBuilder from "../../../shared/utils/query/builder/crud";
+/**
+ * Builder for the supastash query
+ * @param T - The method to call
+ * @param U - Whether to return a single row or multiple rows
+ */
+export declare class SupastashQueryBuilder<T extends CrudMethods, U extends boolean, R> {
+    private readonly query;
+    /**
+     * Constructor for the supastash query builder
+     * @param query - The query to build
+     */
+    constructor(query: SupastashQuery<T, U, R>);
+    /**
+     * Sets the table to query.
+     *
+     * @param table - The table to query.
+     * @returns crud options.
+     */
+    from(table: string): SupastashCrudBuilder<T, U, R>;
+    /**
+     * Executes multiple Supastash operations inside a single SQLite transaction.
+     *
+     * ⚠️ Do NOT call this inside `db.withTransaction(...)`
+     *  or another `supastash.withTransaction(...)`.
+     * Nested transactions are not supported and will throw.
+     *
+     * All queries executed using the provided `tx` builder
+     * will share the same SQLite transaction and `txId`.
+     *
+     * If any operation inside the callback throws,
+     * the entire transaction is rolled back automatically.
+     *
+     * Example:
+     *
+     * await supastash.withTransaction(async (tx) => {
+     *   await tx.from("orders").insert(order).run();
+     *   await tx.from("ledger").insert(ledgerEntry).run();
+     * });
+     *
+     *
+     * In this example, both inserts succeed or both fail.
+     */
+    withTransaction(fn: (tx: SupastashTransactionalBuilder<T, U, R>) => Promise<void> | void): Promise<void>;
+}
+type SupastashTransactionalBuilder<T extends CrudMethods, U extends boolean, R> = Omit<SupastashQueryBuilder<T, U, R>, "withTransaction">;
+export type SupastashTransactionClient = SupastashTransactionalBuilder<CrudMethods, boolean, PayloadData>;
+export type SupastashClient = SupastashTransactionalBuilder<CrudMethods, boolean, PayloadData>;
+/**
+ * Supastash query builder for local-first CRUD operations.
+ *
+ * This builder allows you to construct and execute queries against a local SQLite store
+ * with optional synchronization to Supabase.
+ *
+ * Notes:
+ * - SELECT operations return local data by default unless `sync mode` is set to "remoteOnly".
+ * - `.run()` (alias of `.execute()`) is **required** to finalize and perform the query.
+ * - Use `.run({ viewRemoteResult: true })` to view the remote result from Supabase.
+ * - All operations except DELETE return local data automatically — no need to chain `.select()`.
+ *
+ * @returns A chainable Supastash query instance.
+ *
+ * @example
+ * const result = await supastash
+ *   .from("users")
+ *   .update<T>({ name: "John Doe" })
+ *   .eq("id", "1")
+ *   .run(); // Required to execute the query
+ */
+export declare const supastash: SupastashQueryBuilder<CrudMethods, boolean, any>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/desktop/utils/query/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EAEX,WAAW,EACX,cAAc,EAEf,MAAM,mCAAmC,CAAC;AAE3C,OAAO,oBAAoB,MAAM,0CAA0C,CAAC;AAG5E;;;;GAIG;AACH,qBAAa,qBAAqB,CAChC,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,OAAO,EACjB,CAAC;IAED,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAEhD;;;OAGG;gBACS,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAI1C;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM;IAOlB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,eAAe,CACb,EAAE,EAAE,CAAC,EAAE,EAAE,6BAA6B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAgD3E;AAED,KAAK,6BAA6B,CAChC,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,OAAO,EACjB,CAAC,IACC,IAAI,CAAC,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;AAE5D,MAAM,MAAM,0BAA0B,GAAG,6BAA6B,CACpE,WAAW,EACX,OAAO,EACP,WAAW,CACZ,CAAC;AACF,MAAM,MAAM,eAAe,GAAG,6BAA6B,CACzD,WAAW,EACX,OAAO,EACP,WAAW,CACZ,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,SAAS,kDAyBiC,CAAC"}

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

@@ -0,0 +1,139 @@
+import { getSupastashDb } from "../../../desktop/db/dbInitializer";
+import { txStore } from "../../../shared/store/tx";
+import { generateUUIDv4 } from "../../../shared/utils/genUUID";
+import SupastashCrudBuilder from "../../../shared/utils/query/builder/crud";
+import { queueRemoteCall } from "../../../shared/utils/query/helpers/queueRemote";
+/**
+ * Builder for the supastash query
+ * @param T - The method to call
+ * @param U - Whether to return a single row or multiple rows
+ */
+export class SupastashQueryBuilder {
+    /**
+     * Constructor for the supastash query builder
+     * @param query - The query to build
+     */
+    constructor(query) {
+        this.query = query;
+    }
+    /**
+     * Sets the table to query.
+     *
+     * @param table - The table to query.
+     * @returns crud options.
+     */
+    from(table) {
+        const id = generateUUIDv4();
+        getSupastashDb();
+        const newQuery = { ...this.query, table, id };
+        return new SupastashCrudBuilder(newQuery);
+    }
+    /**
+     * Executes multiple Supastash operations inside a single SQLite transaction.
+     *
+     * ⚠️ Do NOT call this inside `db.withTransaction(...)`
+     *  or another `supastash.withTransaction(...)`.
+     * Nested transactions are not supported and will throw.
+     *
+     * All queries executed using the provided `tx` builder
+     * will share the same SQLite transaction and `txId`.
+     *
+     * If any operation inside the callback throws,
+     * the entire transaction is rolled back automatically.
+     *
+     * Example:
+     *
+     * await supastash.withTransaction(async (tx) => {
+     *   await tx.from("orders").insert(order).run();
+     *   await tx.from("ledger").insert(ledgerEntry).run();
+     * });
+     *
+     *
+     * In this example, both inserts succeed or both fail.
+     */
+    withTransaction(fn) {
+        const query = async () => {
+            // Create a new transaction id
+            const newTxId = generateUUIDv4();
+            try {
+                const db = await getSupastashDb();
+                // Add the transaction to the store
+                txStore[newTxId] = [];
+                // Execute the local calls
+                await db.withTransaction(async (tx) => {
+                    const txQuery = {
+                        ...this.query,
+                        txId: newTxId,
+                        tx,
+                        throwOnError: true, // Throw the error to roll back the transaction
+                    };
+                    const txBuilder = new SupastashQueryBuilder(txQuery);
+                    return fn(txBuilder);
+                });
+                // Execute the remote calls
+                const remoteCalls = txStore[newTxId] ?? [];
+                if (remoteCalls.length > 0) {
+                    const newStates = remoteCalls.map((call) => {
+                        return {
+                            ...call,
+                            txId: null,
+                            tx: null,
+                            withTx: false,
+                            type: "remoteOnly",
+                        };
+                    });
+                    for (const state of newStates) {
+                        queueRemoteCall(state);
+                    }
+                }
+            }
+            finally {
+                // Delete the transaction from the store
+                delete txStore[newTxId];
+            }
+        };
+        return query();
+    }
+}
+/**
+ * Supastash query builder for local-first CRUD operations.
+ *
+ * This builder allows you to construct and execute queries against a local SQLite store
+ * with optional synchronization to Supabase.
+ *
+ * Notes:
+ * - SELECT operations return local data by default unless `sync mode` is set to "remoteOnly".
+ * - `.run()` (alias of `.execute()`) is **required** to finalize and perform the query.
+ * - Use `.run({ viewRemoteResult: true })` to view the remote result from Supabase.
+ * - All operations except DELETE return local data automatically — no need to chain `.select()`.
+ *
+ * @returns A chainable Supastash query instance.
+ *
+ * @example
+ * const result = await supastash
+ *   .from("users")
+ *   .update<T>({ name: "John Doe" })
+ *   .eq("id", "1")
+ *   .run(); // Required to execute the query
+ */
+export const supastash = new SupastashQueryBuilder({
+    id: generateUUIDv4(),
+    table: "",
+    method: "none",
+    payload: null,
+    filters: [],
+    limit: null,
+    select: null,
+    isSingle: false,
+    type: "localFirst",
+    runSelected: false,
+    viewRemoteResult: false,
+    onConflictKeys: ["id"],
+    preserveTimestamp: false,
+    throwOnError: false,
+    fetchPolicy: null,
+    // With tx
+    txId: null,
+    tx: null,
+    withTx: false,
+});

package/dist/desktop/utils/schema/wipeTables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wipeTables.d.ts","sourceRoot":"","sources":["../../../../src/desktop/utils/schema/wipeTables.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,iBAWhD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,iBAWhD;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,kBAalC;AAED;;;;;;;;;;;;;GAaG;AAEH,wBAAsB,aAAa,kBAalC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,iBAyBpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,aAAa,GAAE,MAAM,EAAO,iBAiB7B"}

package/dist/{utils → desktop/utils}/schema/wipeTables.js

@@ -1,7 +1,7 @@
-import { getSupastashDb } from "../../db/dbInitializer";
-import { clearSchemaCache } from "../getTableSchema";
-import log from "../logs";
-import { getAllTables } from "../sync/getAllTables";
+import { getSupastashDb } from "../../../shared/db/dbInitializer";
+import { clearSchemaCache } from "../../../shared/utils/getTableSchema";
+import log from "../../../shared/utils/logs";
+import { getAllTables } from "../../../shared/utils/sync/getAllTables";
 import { clearLocalSyncLog } from "../sync/status/syncStatus";
 /**
  * Wipes a specific table from the local SQLite database and removes its sync metadata.

package/dist/{utils → desktop/utils}/sync/pullFromRemote/fetchOlder.d.ts

@@ -1,5 +1,5 @@
-import { PayloadData } from "../../../types/query.types";
-import { SupastashFilter } from "../../../types/realtimeData.types";
+import { PayloadData } from "../../../../shared/types/query.types";
+import { SupastashFilter } from "../../../../shared/types/realtimeData.types";
 /**
  * Fetches a backward page of records from the server relative to the current
  * earliest locally stored row.

package/dist/desktop/utils/sync/pullFromRemote/fetchOlder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchOlder.d.ts","sourceRoot":"","sources":["../../../../../src/desktop/utils/sync/pullFromRemote/fetchOlder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAI9E;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAAC,EACnC,UAAU,EACV,KAAK,EACL,OAAO,EACP,KAAK,EACL,oBAA2B,GAC5B,EAAE;IACD;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAE5B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,CAwCrD"}

package/dist/{utils → desktop/utils}/sync/pullFromRemote/fetchOlder.js

@@ -1,5 +1,5 @@
-import { getSupastashConfig } from "../../../core/config";
-import { logWarn } from "../../logs";
+import { getSupastashConfig } from "../../../../shared/core/config";
+import { logWarn } from "../../../../shared/utils/logs";
 import { FetchOlderHelpers } from "./fetchOlderHelpers";
 /**
  * Fetches a backward page of records from the server relative to the current

package/dist/{utils → desktop/utils}/sync/pullFromRemote/fetchOlderHelpers.d.ts

@@ -1,6 +1,6 @@
-import { PayloadData } from "../../../types/query.types";
-import { SupastashFilter } from "../../../types/realtimeData.types";
-import { SupastashError } from "../../errorHandler";
+import { PayloadData } from "../../../../shared/types/query.types";
+import { SupastashFilter } from "../../../../shared/types/realtimeData.types";
+import { SupastashError } from "../../../../shared/utils/errorHandler";
 export declare const FetchOlderHelpers: {
     validateBoundaryTs({ boundaryTs, earliestDate, }: {
         boundaryTs: string;

package/dist/desktop/utils/sync/pullFromRemote/fetchOlderHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchOlderHelpers.d.ts","sourceRoot":"","sources":["../../../../../src/desktop/utils/sync/pullFromRemote/fetchOlderHelpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AASvE,eAAO,MAAM,iBAAiB;sDAIzB;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB;yCAmBE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;KAC7B;;;;gFA8BE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;QAC5B,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB;uBAqDkB,cAAc,GAAG;QAClC,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,WAAW,EAAE,CAAC;KACrB;+BAagC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,EAAE,CAAA;KAAE;CAOxE,CAAC"}

package/dist/{utils → desktop/utils}/sync/pullFromRemote/fetchOlderHelpers.js

@@ -1,10 +1,10 @@
-import { getSupastashConfig } from "../../../core/config";
-import { getSupastashDb } from "../../../db/dbInitializer";
-import { ReusedHelpers } from "../../../utils/reusedHelpers";
-import { SupastashError } from "../../errorHandler";
-import { logWarn } from "../../logs";
-import { supabaseClientErr } from "../../supabaseClientErr";
-import { upsertData } from "./updateLocalDb";
+import { getSupastashConfig } from "../../../../shared/core/config";
+import { getSupastashDb } from "../../../../shared/db/dbInitializer";
+import { SupastashError } from "../../../../shared/utils/errorHandler";
+import { logWarn } from "../../../../shared/utils/logs";
+import { ReusedHelpers } from "../../../../shared/utils/reusedHelpers";
+import { supabaseClientErr } from "../../../../shared/utils/supabaseClientErr";
+import { upsertChunkData } from "./updateLocalDb";
 const DEFAULT_DATE = "2000-01-01T00:00:00Z";
 const DEFAULT_ID = "00000000-0000-0000-0000-000000000000";
 export const FetchOlderHelpers = {
@@ -96,15 +96,9 @@ export const FetchOlderHelpers = {
     async storeToDb({ table, data }) {
         if (data.length === 0)
             return;
-        const batchSize = 500;
         const db = await getSupastashDb();
         await db.withTransaction(async (tx) => {
-            for (let i = 0; i < data.length; i++) {
-                await upsertData({ tx, table, record: data[i] });
-                if ((i + 1) % batchSize === 0) {
-                    await new Promise((res) => setTimeout(res, 0));
-                }
-            }
+            await upsertChunkData({ tx, table, records: data });
         });
     },
 };

package/dist/desktop/utils/sync/pullFromRemote/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/desktop/utils/sync/pullFromRemote/index.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,wBAAsB,cAAc,kBAqEnC"}

package/dist/{hooks/syncEngine → desktop/utils/sync}/pullFromRemote/index.js

@@ -1,11 +1,11 @@
-import { getSupastashConfig } from "../../../core/config";
-import { syncCalls } from "../../../store/syncCalls";
-import { tableFilters } from "../../../store/tableFilters";
-import log from "../../../utils/logs";
-import { getAllTables } from "../../../utils/sync/getAllTables";
-import { runLimitedConcurrency } from "../../../utils/sync/pullFromRemote/runLimitedConcurrency";
+import { getSupastashConfig } from "../../../../shared/core/config";
+import { syncCalls } from "../../../../shared/store/syncCalls";
+import { tableFilters } from "../../../../shared/store/tableFilters";
+import log from "../../../../shared/utils/logs";
+import { getAllTables } from "../../../../shared/utils/sync/getAllTables";
+import { runLimitedConcurrency } from "../../../../shared/utils/sync/pullFromRemote/runLimitedConcurrency";
+import { SyncInfoUpdater } from "../../../../shared/utils/sync/queryStatus";
 import { updateLocalDb } from "../../../utils/sync/pullFromRemote/updateLocalDb";
-import { SyncInfoUpdater } from "../../../utils/sync/queryStatus";
 /**
  * Pulls the data from the remote database to the local database
  */

package/dist/{utils → desktop/utils}/sync/pullFromRemote/pullData.d.ts

@@ -1,5 +1,5 @@
-import { PayloadData } from "../../../types/query.types";
-import { SupastashFilter } from "../../../types/realtimeData.types";
+import { PayloadData } from "../../../../shared/types/query.types";
+import { SupastashFilter } from "../../../../shared/types/realtimeData.types";
 /**
  * Pulls data from the remote database for a given table
  * @param table - The table to pull data from

package/dist/desktop/utils/sync/pullFromRemote/pullData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pullData.d.ts","sourceRoot":"","sources":["../../../../../src/desktop/utils/sync/pullFromRemote/pullData.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAW9E;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,EAC7B,KAAK,EACL,OAAO,EACP,OAAO,GACR,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IACV,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,CAAC;CACH,GAAG,IAAI,CAAC,CAmFR"}

package/dist/{utils → desktop/utils}/sync/pullFromRemote/pullData.js

@@ -1,11 +1,11 @@
-import { getSupastashConfig } from "../../../core/config";
-import { getSupastashDb } from "../../../db/dbInitializer";
-import log, { logWarn } from "../../logs";
-import { supabaseClientErr } from "../../supabaseClientErr";
-import { SyncInfoUpdater } from "../queryStatus";
+import { getSupastashConfig } from "../../../../shared/core/config";
+import { getSupastashDb } from "../../../../shared/db/dbInitializer";
+import log, { logWarn } from "../../../../shared/utils/logs";
+import { supabaseClientErr } from "../../../../shared/utils/supabaseClientErr";
+import { logNoUpdates, pageThrough, returnMaxDate, } from "../../../../shared/utils/sync/pullFromRemote/helpers";
+import { SyncInfoUpdater } from "../../../../shared/utils/sync/queryStatus";
 import { computeFilterKey } from "../status/filterKey";
 import { selectSyncStatus } from "../status/repo";
-import { logNoUpdates, pageThrough, returnMaxDate } from "./helpers";
 /**
  * Pulls data from the remote database for a given table
  * @param table - The table to pull data from

package/dist/desktop/utils/sync/pullFromRemote/updateLocalDb.d.ts

@@ -0,0 +1,46 @@
+import { SupastashFilter } from "../../../../shared/types/realtimeData.types";
+import { UpsertDataParams } from "../../../../shared/types/syncEngine.types";
+/**
+ * Updates the local database with the remote changes
+ * @param table - The table to update
+ */
+export declare function updateLocalDb(table: string, filters?: SupastashFilter[], onReceiveData?: (payload: any) => Promise<void>): Promise<void>;
+/**
+ * Upserts a record into the local database
+ * @param table - The table to upsert the record into
+ * @param record - The record to upsert
+ * @param exists - Whether the record already exists in the database
+ */
+export declare function upsertData({ tx, table, record, doesExist, }: UpsertDataParams): Promise<void>;
+/**
+    •	Bulk upserts records into a local SQLite table using a batched, conflict-aware strategy.
+    •
+    •	This function:
+    •		•	Fetches existing id and updated_at values in bulk to avoid per-row queries
+    •		•	Filters incoming records to only include new or more recent entries
+    •		•	Performs batched INSERT ... ON CONFLICT(id) DO UPDATE operations
+    •	while respecting SQLite parameter limits
+    •		•	Updates synced_at for successfully written records
+    •
+    •	Designed for high-performance sync scenarios in offline-first apps.
+    •
+    •	Key guarantees:
+    •		•	Avoids N+1 query patterns (no per-row existence checks)
+    •		•	Minimizes disk I/O pressure via batching
+    •		•	Safe for large datasets when used with chunking
+    •
+    •	Notes:
+    •		•	Assumes id is the primary or unique key
+    •		•	Requires updated_at for conflict resolution (falls back if missing)
+    •		•	Respects SQLite parameter limit (~999 variables per query)
+    •
+    •	@param tx Optional transaction instance. If not provided, a connection is used directly.
+    •	@param table Target table name
+    •	@param records Array of records to upsert
+*/
+export declare function upsertChunkData({ tx, table, records, }: {
+    tx?: any;
+    table: string;
+    records: any[];
+}): Promise<void>;
+//# sourceMappingURL=updateLocalDb.d.ts.map

package/dist/desktop/utils/sync/pullFromRemote/updateLocalDb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateLocalDb.d.ts","sourceRoot":"","sources":["../../../../../src/desktop/utils/sync/pullFromRemote/updateLocalDb.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAiB7E;;;GAGG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,eAAe,EAAE,EAC3B,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,iBAsGhD;AAID;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,EAC/B,EAAE,EACF,KAAK,EACL,MAAM,EACN,SAAS,GACV,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqElC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;EAyBE;AACF,wBAAsB,eAAe,CAAC,EACpC,EAAE,EACF,KAAK,EACL,OAAO,GACR,EAAE;IACD,EAAE,CAAC,EAAE,GAAG,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,GAAG,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgGhB"}