supastash 0.1.62 → 0.2.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/desktop/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,kDAAkD,CAAC;AACjF,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,GACxB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EACL,aAAa,EACb,SAAS,EACT,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,SAAS,GACV,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EACL,aAAa,EACb,eAAe,EACf,UAAU,GACX,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,UAAU,GACX,MAAM,gCAAgC,CAAC;AAExC,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,eAAe,GAChB,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,uCAAuC,CAAC;AAE/C,YAAY,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAEjF,YAAY,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,YAAY,EACV,eAAe,EACf,0BAA0B,GAC3B,MAAM,+BAA+B,CAAC"}

package/dist/desktop/index.js

@@ -0,0 +1,21 @@
+export { configureSupastash, getSupastashConfig } from "../shared/core/config";
+export { getSupastashDb } from "../shared/db/dbInitializer";
+export { useSupastashFilters } from "../shared/hooks/supastashFilters";
+export { useSupastashSyncStatus } from "../shared/hooks/syncStatus";
+export { closeSyncGate, isSyncGateClosed, openSyncGate, } from "../shared/store/syncStatus";
+export { supastashEventBus } from "../shared/utils/events/eventBus";
+export { supastash } from "../shared/utils/query/builder";
+export { refreshScreen } from "../shared/utils/refreshScreenCalls";
+export { getSupastashRuntimeMode, reinitializeSupastash, } from "../shared/utils/supastashMode";
+export { getAllTables } from "../shared/utils/sync/getAllTables";
+export { updateFilters } from "../shared/utils/sync/pullFromRemote/updateFilter";
+export { refreshAllTables, refreshTable, refreshTableWithPayload, } from "../shared/utils/sync/refreshTables";
+export { clearSyncCalls, getAllSyncTables, getSyncCall, registerSyncCall, unregisterSyncCall, } from "../shared/utils/sync/registration/syncCalls";
+export { defineLocalSchema } from "./core/schemaManager";
+export { useSupastashData } from "./hooks/supastashData";
+export { useSupastash } from "./hooks/supastashLogic";
+export { syncAllTables, syncTable } from "./hooks/syncEngine";
+export { dropAllTables, dropTable, wipeAllTables, wipeOldDataForAllTables, wipeOldDataForATable, wipeTable, } from "./utils/schema/wipeTables";
+export { fetchOlderPage } from "./utils/sync/pullFromRemote/fetchOlder";
+export { updateLocalDb, upsertChunkData, upsertData, } from "./utils/sync/pullFromRemote/updateLocalDb";
+export { clearAllLocalDeleteLog, clearAllLocalSyncLog, clearLocalDeleteLog, clearLocalSyncLog, clearSyncLog, getLocalDeleteLog, getSyncLog, resetSyncLog, setLocalDeleteLog, setLocalSyncLog, setSyncLog, } from "./utils/sync/status/syncStatus";

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

@@ -1,5 +1,5 @@
-import { PayloadData } from "../../types/query.types";
-import { RealtimeOptions } from "../../types/realtimeData.types";
+import { PayloadData } from "../../../shared/types/query.types";
+import { RealtimeOptions } from "../../../shared/types/realtimeData.types";
 declare function useEventQueues<R>(table: string, options: RealtimeOptions<R>, flushIntervalMs: number): (eventType: string, data: PayloadData) => void;
 export default useEventQueues;
 //# sourceMappingURL=eventQueues.d.ts.map

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/desktop/utils/fetchData/initialFetch.d.ts

@@ -0,0 +1,3 @@
+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)
@@ -29,7 +29,7 @@ export async function receiveData(payload, table, shouldFetch = true, upsertCall
             await upsertCall(payload);
         }
         else {
-            await upsertData(table, payload);
+            await upsertData({ table, record: payload });
         }
         refreshScreen(table);
     }

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/desktop/utils/sync/pullFromRemote/fetchOlder.d.ts

@@ -0,0 +1,44 @@
+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.
+ *
+ * This function performs cursor-based backward pagination by:
+ * - Determining the earliest known local record for the table
+ * - Validating the provided boundary timestamp
+ * - Fetching older records from the server up to the specified limit
+ * - Optionally persisting the results into the local database
+ *
+ * Designed for infinite scroll and historical lookback scenarios.
+ *
+ * @returns An object containing:
+ * - `data`: The fetched records
+ * - `hasMore`: Whether additional older records may exist
+ */
+export declare function fetchOlderPage({ boundaryTs, table, filters, limit, shouldStoreToLocalDb, }: {
+    /**
+     * The timestamp to cap lookback at.
+     */
+    boundaryTs: string;
+    /**
+     * The table to fetch data from.
+     */
+    table: string;
+    /**
+     * The filters to apply to the data.
+     */
+    filters?: SupastashFilter[];
+    /**
+     * The maximum number of records to fetch.
+     */
+    limit: number;
+    /**
+     * The data to store to the database.
+     */
+    shouldStoreToLocalDb?: boolean;
+}): Promise<{
+    hasMore: boolean;
+    data: PayloadData[];
+}>;
+//# sourceMappingURL=fetchOlder.d.ts.map

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/desktop/utils/sync/pullFromRemote/fetchOlder.js

@@ -0,0 +1,55 @@
+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
+ * earliest locally stored row.
+ *
+ * This function performs cursor-based backward pagination by:
+ * - Determining the earliest known local record for the table
+ * - Validating the provided boundary timestamp
+ * - Fetching older records from the server up to the specified limit
+ * - Optionally persisting the results into the local database
+ *
+ * Designed for infinite scroll and historical lookback scenarios.
+ *
+ * @returns An object containing:
+ * - `data`: The fetched records
+ * - `hasMore`: Whether additional older records may exist
+ */
+export async function fetchOlderPage({ boundaryTs, table, filters, limit, shouldStoreToLocalDb = true, }) {
+    try {
+        const isGhost = getSupastashConfig().supastashMode === "ghost";
+        if (isGhost) {
+            return { hasMore: false, data: [] };
+        }
+        const lookbackDays = await FetchOlderHelpers.getLookbackDays({
+            table,
+            filters,
+        });
+        if (boundaryTs) {
+            FetchOlderHelpers.validateBoundaryTs({
+                boundaryTs,
+                earliestDate: lookbackDays.createdAt,
+            });
+        }
+        const data = await FetchOlderHelpers.fetchData({
+            table,
+            filters,
+            limit,
+            boundaryTs,
+            earliestDate: lookbackDays.createdAt,
+            earliestId: lookbackDays.id,
+        });
+        if (shouldStoreToLocalDb) {
+            await FetchOlderHelpers.storeToDb({ table, data });
+        }
+        if (data.length > limit) {
+            logWarn(`[Supastash] Pagination overflow detected for table ${table}`);
+        }
+        return { hasMore: data.length === limit, data };
+    }
+    catch (error) {
+        return FetchOlderHelpers.handleError(error);
+    }
+}

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

@@ -0,0 +1,33 @@
+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;
+        earliestDate: string;
+    }): void;
+    getLookbackDays({ table, filters, }: {
+        table: string;
+        filters?: SupastashFilter[];
+    }): Promise<{
+        createdAt: any;
+        id: any;
+    }>;
+    fetchData({ table, filters, limit, earliestDate, boundaryTs, earliestId, }: {
+        table: string;
+        filters?: SupastashFilter[];
+        limit: number;
+        boundaryTs?: string;
+        earliestDate: string;
+        earliestId: string;
+    }): Promise<any[]>;
+    handleError(error: SupastashError): {
+        hasMore: boolean;
+        data: PayloadData[];
+    };
+    storeToDb({ table, data }: {
+        table: string;
+        data: PayloadData[];
+    }): Promise<void>;
+};
+//# sourceMappingURL=fetchOlderHelpers.d.ts.map

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/desktop/utils/sync/pullFromRemote/fetchOlderHelpers.js

@@ -0,0 +1,104 @@
+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 = {
+    validateBoundaryTs({ boundaryTs, earliestDate, }) {
+        const boundaryTsDate = new Date(boundaryTs);
+        if (isNaN(boundaryTsDate.getTime())) {
+            logWarn(`Invalid boundary timestamp: ${boundaryTs}`);
+            throw new SupastashError(`Invalid boundary timestamp: ${boundaryTs}`, "INVALID_BOUNDARY_TS");
+        }
+        if (boundaryTsDate > new Date(earliestDate)) {
+            throw new SupastashError(`Boundary timestamp is more recent than oldest data: ${boundaryTs} > ${earliestDate}`, "BOUNDARY_TS_MORE_RECENT_THAN_OLDEST_DATA");
+        }
+    },
+    async getLookbackDays({ table, filters, }) {
+        // If no cursor, build the SQL filter
+        let sqlFilter = "";
+        if (filters) {
+            for (const filter of filters) {
+                sqlFilter += ReusedHelpers.buildFilterForSql(filter);
+            }
+        }
+        // Fetch the earliest date and id
+        const db = await getSupastashDb();
+        const result = await db.getFirstAsync(`
+        SELECT id, created_at FROM ${table} 
+        ${sqlFilter}
+        ORDER BY created_at ASC, id ASC
+        LIMIT 1
+        `);
+        if (!result)
+            return { createdAt: DEFAULT_DATE, id: DEFAULT_ID };
+        return { createdAt: result.created_at, id: result.id };
+    },
+    async fetchData({ table, filters, limit, earliestDate, boundaryTs, earliestId, }) {
+        const supabase = getSupastashConfig().supabaseClient;
+        if (!supabase)
+            throw new Error(`No supabase client found: ${supabaseClientErr}`);
+        let cursorId = earliestId;
+        let cursorDate = earliestDate;
+        const results = [];
+        let remainingLimit = limit;
+        while (true) {
+            const pageSize = Math.min(1000, remainingLimit);
+            // Build the query
+            let q = supabase
+                .from(table)
+                .select("*")
+                .limit(pageSize)
+                .order("created_at", { ascending: false })
+                .order("id", { ascending: false })
+                .is("deleted_at", null);
+            q = q
+                .or(`created_at.lt.${cursorDate},and(created_at.eq.${cursorDate},id.lt.${cursorId})`)
+                .gte("created_at", boundaryTs ?? DEFAULT_DATE);
+            if (filters) {
+                q = ReusedHelpers.applyFilters(q, filters, table);
+            }
+            const { data, error } = await q;
+            if (error)
+                throw error;
+            if (!data || data.length === 0)
+                break;
+            results.push(...data);
+            const last = data[data.length - 1];
+            cursorId = last.id;
+            cursorDate = last.created_at;
+            if (data.length < pageSize) {
+                break;
+            }
+            if (remainingLimit <= pageSize) {
+                break;
+            }
+            remainingLimit -= pageSize;
+        }
+        return results;
+    },
+    handleError(error) {
+        switch (error.code) {
+            case "INVALID_BOUNDARY_TS":
+                logWarn(error.message);
+                return { hasMore: false, data: [] };
+            case "BOUNDARY_TS_MORE_RECENT_THAN_OLDEST_DATA":
+                logWarn(error.message);
+                return { hasMore: false, data: [] };
+            default:
+                throw error;
+        }
+    },
+    async storeToDb({ table, data }) {
+        if (data.length === 0)
+            return;
+        const db = await getSupastashDb();
+        await db.withTransaction(async (tx) => {
+            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
  */