supastash 0.1.61 → 0.2.0

package/README.md

@@ -15,6 +15,15 @@
 
 ---
 
+> 🔴 **NEW — Replication Mode**
+>
+> Improves sync ordering and prevents missed updates in distributed offline systems.  
+> ⚠️ Must read if your app supports multiple devices or long offline sessions.
+>
+> 👉 Learn more: https://0xzekea.github.io/supastash/docs/replication-mode
+
+---
+
 ## ✨ Features
 
 - 🔁 **Two-way sync** (Supabase ↔ SQLite)
@@ -91,8 +100,8 @@ configureSupastash({
       id: "TEXT PRIMARY KEY",
       name: "TEXT",
       email: "TEXT",
-      created_at: "TIMESTAMP",
-      updated_at: "TIMESTAMP",
+      created_at: "TEXT NOT NULL",
+      updated_at: "TEXT NOT NULL",
     });
   },
 
@@ -173,9 +182,12 @@ useSupastashFilters({
 - Your Supabase tables must have:
 
   - A primary key `id` (string or UUID)
-  - `timestamptz` columns for `created_at`, `updated_at`, and `deleted_at`
 
-- Run this SQL in Supabase to allow schema reflection:
+  - `timestamptz` columns for `created_at`, `updated_at`, and `deleted_at`
+  - If using `replicationMode: "server-side"`(Recommended), you must also add:
+    - `arrived_at timestamptz NOT NULL DEFAULT now()`
+    - A server trigger to enforce `arrived_at` updates
+  - Run this SQL in Supabase to allow schema reflection:
 
 ```sql
 create or replace function get_table_schema(table_name text)
@@ -206,7 +218,7 @@ const { data: orders } = useSupatashData("orders", {
 
 ## 🔄 How Sync Works
 
-- Tracks rows using `updated_at`, `deleted_at`, and `created_at`
+- Tracks rows using a replication cursor (`updated_at` by default, or `arrived_at` in server-side mode)
 - Batches changes in background and retries failed ones
 - Local cache backed by Supabase
 - Runs pull/push jobs efficiently using staged task pipelines

package/dist/core/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/config/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,0BAA0B,EAC3B,MAAM,mCAAmC,CAAC;AA6B3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,0BAA0B,EACrE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG;IAAE,gBAAgB,EAAE,CAAC,CAAA;CAAE,QAuCrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,SAAS,0BAA0B,KACjC,eAAe,CAAC,CAAC,CAAC,CAEtB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,SAAS,0BAA0B,EACpC,MAAM,EAAE;IACR,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG;QAC9B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;KAC3B,CAAC;CACH,QAEA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/config/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,0BAA0B,EAC3B,MAAM,mCAAmC,CAAC;AAiC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,0BAA0B,EACrE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG;IAAE,gBAAgB,EAAE,CAAC,CAAA;CAAE,QAuCrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,SAAS,0BAA0B,KACjC,eAAe,CAAC,CAAC,CAAC,CAEtB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,SAAS,0BAA0B,EACpC,MAAM,EAAE;IACR,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG;QAC9B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;KAC3B,CAAC;CACH,QAEA"}

package/dist/core/config/index.js

@@ -14,8 +14,12 @@ let _config = {
         pull: true,
         useFiltersFromStore: true,
     },
+    replicationMode: "client-side",
+    maxSyncLookbackDays: 365,
+    perTableSyncLookbackDays: undefined,
+    fullSyncTables: [],
     listeners: 250,
-    supabaseBatchSize: 100,
+    supabaseBatchSize: 800,
     debugMode: true,
     syncPolicy: DEFAULT_POLICY,
     fieldEnforcement: DEFAULT_FIELDS,

package/dist/db/adapters/expo_sqlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expo_sqlite.d.ts","sourceRoot":"","sources":["../../../src/db/adapters/expo_sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EAEvB,MAAM,mCAAmC,CAAC;AAE3C,eAAO,MAAM,iBAAiB,EAAE,sBAkC/B,CAAC"}
+{"version":3,"file":"expo_sqlite.d.ts","sourceRoot":"","sources":["../../../src/db/adapters/expo_sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EAGvB,MAAM,mCAAmC,CAAC;AAE3C,eAAO,MAAM,iBAAiB,EAAE,sBAoD/B,CAAC"}

package/dist/db/adapters/expo_sqlite.js

@@ -19,6 +19,17 @@ export const SQLiteAdapterExpo = {
             closeAsync: async () => {
                 await db.closeAsync?.();
             },
+            withTransaction: async (fn) => {
+                return await db.withTransactionAsync(async () => {
+                    const txExecutor = {
+                        runAsync: async (sql, params) => await db.runAsync(sql, params ?? []),
+                        execAsync: async (statement) => await db.execAsync(statement),
+                        getAllAsync: async (sql, params) => await db.getAllAsync(sql, params ?? []),
+                        getFirstAsync: async (sql, params) => await db.getFirstAsync(sql, params ?? []),
+                    };
+                    return await fn(txExecutor);
+                });
+            },
         };
     },
 };

package/dist/db/adapters/rn_nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rn_nitro.d.ts","sourceRoot":"","sources":["../../../src/db/adapters/rn_nitro.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EAEvB,MAAM,mCAAmC,CAAC;AAG3C,eAAO,MAAM,kBAAkB,EAAE,sBA6ChC,CAAC"}
+{"version":3,"file":"rn_nitro.d.ts","sourceRoot":"","sources":["../../../src/db/adapters/rn_nitro.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EAGvB,MAAM,mCAAmC,CAAC;AAG3C,eAAO,MAAM,kBAAkB,EAAE,sBA2EhC,CAAC"}

package/dist/db/adapters/rn_nitro.js

@@ -29,6 +29,26 @@ export const SQLiteAdapterNitro = {
             closeAsync: async () => {
                 await db.close?.();
             },
+            withTransaction: async (fn) => {
+                await db.transaction(async (tx) => {
+                    const txExecutor = {
+                        runAsync: async (sql, params) => await tx.executeAsync(sql, params ?? []),
+                        execAsync: async (statement) => {
+                            await tx.executeAsync(statement);
+                        },
+                        getAllAsync: async (sql, params) => {
+                            const result = await tx.executeAsync(sql, params ?? []);
+                            const mainResult = result.rows?._array ?? [];
+                            return mainResult;
+                        },
+                        getFirstAsync: async (sql, params) => {
+                            const result = await tx.executeAsync(sql, params ?? []);
+                            return result.rows?._array?.[0] ?? null;
+                        },
+                    };
+                    return await fn(txExecutor);
+                });
+            },
         };
     },
 };

package/dist/db/adapters/rn_sqlite_storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rn_sqlite_storage.d.ts","sourceRoot":"","sources":["../../../src/db/adapters/rn_sqlite_storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EAEvB,MAAM,mCAAmC,CAAC;AAE3C,eAAO,MAAM,oBAAoB,EAAE,sBAmClC,CAAC"}
+{"version":3,"file":"rn_sqlite_storage.d.ts","sourceRoot":"","sources":["../../../src/db/adapters/rn_sqlite_storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EAGvB,MAAM,mCAAmC,CAAC;AAE3C,eAAO,MAAM,oBAAoB,EAAE,sBA+ElC,CAAC"}

package/dist/db/adapters/rn_sqlite_storage.js

@@ -20,6 +20,33 @@ export const SQLiteAdapterStorage = {
             closeAsync: async () => {
                 await db.close?.();
             },
+            withTransaction: async (fn) => {
+                await db.transaction(async (tx) => {
+                    const txExecutor = {
+                        runAsync: async (sql, params) => {
+                            await tx.executeSql(sql, params ?? []);
+                        },
+                        execAsync: async (statement) => {
+                            await tx.executeSql(statement);
+                        },
+                        getAllAsync: async (sql, params) => {
+                            const [, resultSet] = await tx.executeSql(sql, params ?? []);
+                            const rows = [];
+                            for (let i = 0; i < resultSet.rows.length; i++) {
+                                rows.push(resultSet.rows.item(i));
+                            }
+                            return rows;
+                        },
+                        getFirstAsync: async (sql, params) => {
+                            const [, resultSet] = await tx.executeSql(sql, params ?? []);
+                            if (resultSet.rows.length === 0)
+                                return null;
+                            return resultSet.rows.item(0);
+                        },
+                    };
+                    return await fn(txExecutor);
+                });
+            },
         };
     },
 };

package/dist/hooks/supastashData/fetchCalls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetchCalls.d.ts","sourceRoot":"","sources":["../../../src/hooks/supastashData/fetchCalls.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,eAAe,EAChB,MAAM,gCAAgC,CAAC;AAKxC,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"}
+{"version":3,"file":"fetchCalls.d.ts","sourceRoot":"","sources":["../../../src/hooks/supastashData/fetchCalls.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,eAAe,EAEhB,MAAM,gCAAgC,CAAC;AAKxC,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/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/supastashData/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,eAAe,EACf,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAWxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,GAAG,EACtC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,eAAoB,GAC5B,mBAAmB,CAAC,CAAC,CAAC,CA4FxB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/supastashData/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,eAAe,EACf,mBAAmB,EAEpB,MAAM,gCAAgC,CAAC;AAWxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,GAAG,EACtC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,eAAoB,GAC5B,mBAAmB,CAAC,CAAC,CAAC,CAqGxB"}

package/dist/hooks/supastashData/index.js

@@ -2,8 +2,8 @@ import { useEffect, useMemo, useRef } from "react";
 import { AppState } from "react-native";
 import { localCache } from "../../store/localCache";
 import { supastashEventBus } from "../../utils/events/eventBus";
-import { buildFilterString } from "../../utils/fetchData/buildFilter";
 import useRealtimeData from "../../utils/fetchData/realTimeCall";
+import { ReusedHelpers } from "../../utils/reusedHelpers";
 import { isTrulyNullish } from "../../utils/serializer";
 import useDataState from "./dataState";
 import useEventQueues from "./eventQueues";
@@ -80,11 +80,19 @@ export function useSupastashData(table, options = {}) {
     const { dataMap, data, groupedBy, } = useDataState(table);
     const queueHandler = useEventQueues(table, options, flushIntervalMs);
     const { triggerRefresh, trigger, cancel, initialFetchAndSync, isFetching } = fetchCalls(table, options, hasTriggeredRef);
-    const subKey = useMemo(() => `${table}:${buildFilterString(filter)}`, [table, filter]);
+    const subKey = useMemo(() => `${table}:${ReusedHelpers.buildFilterString(filter)}`, [table, filter]);
     const isAnyNullish = useMemo(() => {
-        if (!options.sqlFilter)
+        if (!options.sqlFilter?.length)
             return false;
-        return options.sqlFilter.some((filter) => isTrulyNullish(filter.value) && filter.operator !== "is");
+        const check = (filter) => {
+            if (!filter || typeof filter !== "object")
+                return false;
+            if ("or" in filter) {
+                return filter.or?.some(check) ?? false;
+            }
+            return isTrulyNullish(filter.value) && filter.operator !== "is";
+        };
+        return options.sqlFilter.some(check);
     }, [options.sqlFilter]);
     useEffect(() => {
         if (!shouldFetch || (lazy && !hasTriggeredRef.current))

package/dist/hooks/supastashData/realtimeSubscription.js

@@ -2,9 +2,9 @@
 import NetInfo from "@react-native-community/netinfo";
 import { useCallback, useEffect, useRef } from "react";
 import { getSupastashConfig } from "../../core/config";
-import { buildFilterString } from "../../utils/fetchData/buildFilter";
 import { RealtimeManager } from "../../utils/fetchData/realTimeManager";
 import { logError } from "../../utils/logs";
+import { ReusedHelpers } from "../../utils/reusedHelpers";
 import { supabaseClientErr } from "../../utils/supabaseClientErr";
 const generateHookId = () => `hook_${Date.now()}_${Math.random().toString(36)}`;
 function useRealtimeSubscription(table, queueHandler, options, initialized, realtime) {
@@ -36,7 +36,7 @@ function useRealtimeSubscription(table, queueHandler, options, initialized, real
         if (!isConnected) {
             if (isSubscribedRef.current) {
                 const filterString = options.filter
-                    ? buildFilterString(options.filter)
+                    ? ReusedHelpers.buildFilterString(options.filter)
                     : undefined;
                 RealtimeManager.unsubscribe(table, hookId, filterString);
                 isSubscribedRef.current = false;
@@ -50,7 +50,7 @@ function useRealtimeSubscription(table, queueHandler, options, initialized, real
                 (!options.lazy || initialized));
             if (shouldSubscribe && !isSubscribedRef.current) {
                 const filterString = options.filter
-                    ? buildFilterString(options.filter)
+                    ? ReusedHelpers.buildFilterString(options.filter)
                     : undefined;
                 RealtimeManager.subscribe(table, hookId, queueHandler, filterString);
                 isSubscribedRef.current = true;
@@ -63,7 +63,7 @@ function useRealtimeSubscription(table, queueHandler, options, initialized, real
             return;
         }
         const filterString = options.filter
-            ? buildFilterString(options.filter)
+            ? ReusedHelpers.buildFilterString(options.filter)
             : undefined;
         const unsubscribeStatus = RealtimeManager.onStatusChange(handleStatusChange);
         const unsubscribeNetInfo = NetInfo.addEventListener(({ isConnected }) => {

package/dist/hooks/supastashData/registerSub.d.ts

@@ -1,4 +1,4 @@
-import { RealtimeFilter } from "../../types/realtimeData.types";
-export declare function registerSub(table: string, filter?: RealtimeFilter): boolean;
-export declare function unregisterSub(table: string, filter?: RealtimeFilter): void;
+import { SupastashFilter } from "../../types/realtimeData.types";
+export declare function registerSub(table: string, filter?: SupastashFilter): boolean;
+export declare function unregisterSub(table: string, filter?: SupastashFilter): void;
 //# sourceMappingURL=registerSub.d.ts.map

package/dist/hooks/supastashData/registerSub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registerSub.d.ts","sourceRoot":"","sources":["../../../src/hooks/supastashData/registerSub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAKhE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAQ3E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAQ1E"}
+{"version":3,"file":"registerSub.d.ts","sourceRoot":"","sources":["../../../src/hooks/supastashData/registerSub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAKjE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAQ5E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI,CAQ3E"}

package/dist/hooks/supastashData/registerSub.js

@@ -1,7 +1,7 @@
-import { buildFilterString } from "../../utils/fetchData/buildFilter";
+import { ReusedHelpers } from "../../utils/reusedHelpers";
 const subRegistry = {};
 export function registerSub(table, filter) {
-    const key = `${table}::${buildFilterString(filter) ?? ""}`;
+    const key = `${table}::${ReusedHelpers.buildFilterString(filter) ?? ""}`;
     if (subRegistry[key]) {
         subRegistry[key]++;
         return true;
@@ -10,7 +10,7 @@ export function registerSub(table, filter) {
     return false;
 }
 export function unregisterSub(table, filter) {
-    const key = `${table}::${buildFilterString(filter) ?? ""}`;
+    const key = `${table}::${ReusedHelpers.buildFilterString(filter) ?? ""}`;
     if (subRegistry[key]) {
         subRegistry[key]--;
         if (subRegistry[key] <= 0) {

package/dist/hooks/supastashFilters/index.d.ts

@@ -1,4 +1,4 @@
-import { SupastashFilter } from "../../types/supastashFilters.types";
+import { SupastashFilter } from "../../types/realtimeData.types";
 /**
  * useSupastashFilters
  *
@@ -27,7 +27,7 @@ import { SupastashFilter } from "../../types/supastashFilters.types";
  * ```
  *
  * @param {SupastashFilter} filters - An object where each key is a table name, and its value is
- *   an array of `RealtimeFilter` objects that define the filter criteria for that table's pull sync.
+ *   an array of `SupastashFilter` objects that define the filter criteria for that table's pull sync.
  *
  * @note This hook does not re-run unless the `filters` object reference changes.
  *       To force re-evaluation, pass a fresh object (not just mutated data).

package/dist/hooks/supastashFilters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/supastashFilters/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAOrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,eAAe,QAuD5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/supastashFilters/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAMjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,eAAe,QAwD5D"}

package/dist/hooks/supastashFilters/index.js

@@ -1,7 +1,8 @@
 import { useEffect } from "react";
 import { filterTracker, tableFilters, tableFiltersUsed, } from "../../store/tableFilters";
 import { logWarn } from "../../utils/logs";
-import isValidFilter, { warnOnMisMatch, } from "../../utils/sync/pullFromRemote/validateFilters";
+import { ReusedHelpers } from "../../utils/reusedHelpers";
+import { warnOnMisMatch } from "../../utils/sync/pullFromRemote/validateFilters";
 import { checkIfTableExist } from "../../utils/tableValidator";
 /**
  * useSupastashFilters
@@ -31,7 +32,7 @@ import { checkIfTableExist } from "../../utils/tableValidator";
  * ```
  *
  * @param {SupastashFilter} filters - An object where each key is a table name, and its value is
- *   an array of `RealtimeFilter` objects that define the filter criteria for that table's pull sync.
+ *   an array of `SupastashFilter` objects that define the filter criteria for that table's pull sync.
  *
  * @note This hook does not re-run unless the `filters` object reference changes.
  *       To force re-evaluation, pass a fresh object (not just mutated data).
@@ -62,8 +63,9 @@ export function useSupastashFilters(filters) {
                     logWarn(`Table '${table}' does not exist; skipping filters`);
                     continue;
                 }
-                const raw = filters[table] ?? [];
-                const valid = raw.filter((f) => isValidFilter([f]));
+                const raw = (filters[table] ??
+                    []);
+                const valid = raw.filter((f) => ReusedHelpers.isValidFilter([f]));
                 if (!valid.length) {
                     tableFilters.delete(table);
                     tableFiltersUsed.delete(table);

package/dist/hooks/supastashLiteQuery/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/supastashLiteQuery/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAUhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAiDM;AACN,wBAAgB,qBAAqB,CAAC,CAAC,GAAG,GAAG,EAC3C,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,gBAAgB,CAAC,CAAC,CAAM,GAChC,eAAe,CAAC,CAAC,CAAC,CAiFpB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/supastashLiteQuery/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAWhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAiDM;AACN,wBAAgB,qBAAqB,CAAC,CAAC,GAAG,GAAG,EAC3C,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,gBAAgB,CAAC,CAAC,CAAM,GAChC,eAAe,CAAC,CAAC,CAAC,CA0FpB"}

package/dist/hooks/supastashLiteQuery/index.js

@@ -109,9 +109,19 @@ export function useSupastashLiteQuery(table, options = {}) {
         loadMore();
     }, [loadMore]);
     const isAnyNullish = useMemo(() => {
-        if (!options.sqlFilter)
+        if (!options.sqlFilter?.length)
             return false;
-        return options.sqlFilter.some((filter) => isTrulyNullish(filter.value) && filter.operator !== "is");
+        const check = (filter) => {
+            if (!filter || typeof filter !== "object")
+                return false;
+            if ("or" in filter) {
+                return filter.or?.some(check) ?? false;
+            }
+            else {
+                return isTrulyNullish(filter.value) && filter.operator !== "is";
+            }
+        };
+        return options.sqlFilter.some(check);
     }, [options.sqlFilter]);
     return { data, loadMore, loading, hasMore, reset };
 }

package/dist/hooks/syncEngine/pushLocal/index.js

@@ -59,7 +59,7 @@ export async function pushLocalData() {
                 });
             }
             catch (e) {
-                const msg = e?.code ?? e?.name ?? String(e);
+                const msg = e?.message ?? e?.code ?? e?.name ?? String(e);
                 SyncInfoUpdater.markLogError({
                     type: "push",
                     table,

package/dist/index.d.ts

@@ -13,6 +13,7 @@ export { refreshScreen } from "./utils/refreshScreenCalls";
 export { dropAllTables, dropTable, wipeAllTables, wipeOldDataForAllTables, wipeOldDataForATable, wipeTable, } from "./utils/schema/wipeTables";
 export { getSupastashRuntimeMode, reinitializeSupastash, } from "./utils/supastashMode";
 export { getAllTables } from "./utils/sync/getAllTables";
+export { fetchOlderPage } from "./utils/sync/pullFromRemote/fetchOlder";
 export { updateFilters } from "./utils/sync/pullFromRemote/updateFilter";
 export { updateLocalDb, upsertData, } from "./utils/sync/pullFromRemote/updateLocalDb";
 export { refreshAllTables, refreshTable, refreshTableWithPayload, } from "./utils/sync/refreshTables";
@@ -20,5 +21,6 @@ export { clearSyncCalls, getAllSyncTables, getSyncCall, registerSyncCall, unregi
 export { clearAllLocalDeleteLog, clearAllLocalSyncLog, clearLocalDeleteLog, clearLocalSyncLog, clearSyncLog, getLocalDeleteLog, getSyncLog, resetSyncLog, setLocalDeleteLog, setLocalSyncLog, setSyncLog, } from "./utils/sync/status/syncStatus";
 export type { CrudMethods } from "./types/query.types";
 export type { RealtimeOptions, SupastashDataResult, SupastashFilter, } from "./types/realtimeData.types";
-export type { SupastashConfig, SupastashHookReturn, SupastashSQLiteClientTypes, SupastashSQLiteDatabase, } from "./types/supastashConfig.types";
+export type { SupastashConfig, SupastashHookReturn, SupastashSQLiteClientTypes, SupastashSQLiteDatabase, SupastashSQLiteExecutor, } from "./types/supastashConfig.types";
+export type { SupastashClient, SupastashTransactionClient, } from "./utils/query/builder";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,aAAa,EACb,SAAS,EACT,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,SAAS,GACV,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AACzE,OAAO,EACL,aAAa,EACb,UAAU,GACX,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,qCAAqC,CAAC;AAC7C,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,qBAAqB,CAAC;AACvD,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,eAAe,GAChB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,aAAa,EACb,SAAS,EACT,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,SAAS,GACV,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AACzE,OAAO,EACL,aAAa,EACb,UAAU,GACX,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,qCAAqC,CAAC;AAC7C,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,qBAAqB,CAAC;AACvD,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,eAAe,GAChB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,eAAe,EACf,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -14,6 +14,7 @@ export { refreshScreen } from "./utils/refreshScreenCalls";
 export { dropAllTables, dropTable, wipeAllTables, wipeOldDataForAllTables, wipeOldDataForATable, wipeTable, } from "./utils/schema/wipeTables";
 export { getSupastashRuntimeMode, reinitializeSupastash, } from "./utils/supastashMode";
 export { getAllTables } from "./utils/sync/getAllTables";
+export { fetchOlderPage } from "./utils/sync/pullFromRemote/fetchOlder";
 export { updateFilters } from "./utils/sync/pullFromRemote/updateFilter";
 export { updateLocalDb, upsertData, } from "./utils/sync/pullFromRemote/updateLocalDb";
 export { refreshAllTables, refreshTable, refreshTableWithPayload, } from "./utils/sync/refreshTables";

package/dist/store/tableFilters.d.ts

@@ -1,5 +1,5 @@
-import { RealtimeFilter } from "../types/realtimeData.types";
+import { SupastashFilter } from "../types/realtimeData.types";
 export declare const tableFiltersUsed: Set<string>;
-export declare const filterTracker: Map<string, RealtimeFilter[]>;
-export declare const tableFilters: Map<string, RealtimeFilter[]>;
+export declare const filterTracker: Map<string, SupastashFilter[]>;
+export declare const tableFilters: Map<string, SupastashFilter[]>;
 //# sourceMappingURL=tableFilters.d.ts.map

package/dist/store/tableFilters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tableFilters.d.ts","sourceRoot":"","sources":["../../src/store/tableFilters.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,eAAO,MAAM,gBAAgB,aAAoB,CAAC;AAClD,eAAO,MAAM,aAAa,+BAAsC,CAAC;AAEjE,eAAO,MAAM,YAAY,+BAAsC,CAAC"}
+{"version":3,"file":"tableFilters.d.ts","sourceRoot":"","sources":["../../src/store/tableFilters.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,eAAO,MAAM,gBAAgB,aAAoB,CAAC;AAClD,eAAO,MAAM,aAAa,gCAAuC,CAAC;AAElE,eAAO,MAAM,YAAY,gCAAuC,CAAC"}

package/dist/store/tx.d.ts

@@ -0,0 +1,3 @@
+import { CrudMethods, PayloadData, SupastashQuery } from "../types/query.types";
+export declare const txStore: Record<string, SupastashQuery<CrudMethods, boolean, PayloadData>[]>;
+//# sourceMappingURL=tx.d.ts.map

package/dist/store/tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx.d.ts","sourceRoot":"","sources":["../../src/store/tx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,eAAO,MAAM,OAAO,EAAS,MAAM,CACjC,MAAM,EACN,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,CACpD,CAAC"}

package/dist/store/tx.js

@@ -0,0 +1 @@
+export const txStore = {};

package/dist/types/expoSqlite.types.d.ts

@@ -1,4 +1,6 @@
-export interface ExpoSQLiteDatabase {
+import type { SQLiteDatabase, SQLiteRunResult } from "expo-sqlite";
+
+export interface ExpoSQLiteDatabase extends SQLiteDatabase {
   runAsync<T = any>(
     statement: string,
     params: SQLiteBindParams
@@ -44,15 +46,3 @@ export type SQLiteBindBlobParams = Record<string, Uint8Array>;
 export type SQLiteColumnNames = string[];
 export type SQLiteColumnValues = any[];
 export type SQLiteAnyDatabase = any;
-
-export interface SQLiteRunResult {
-  /**
-   * The last inserted row ID. Returned from the [`sqlite3_last_insert_rowid()`](https://www.sqlite.org/c3ref/last_insert_rowid.html) function.
-   */
-  lastInsertRowId: number;
-
-  /**
-   * The number of rows affected. Returned from the [`sqlite3_changes()`](https://www.sqlite.org/c3ref/changes.html) function.
-   */
-  changes: number;
-}

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 export type { SupastashQueryResult, SupastashResult } from "./query.types";
 export type { SupastashDataHook, SupastashDataResult, } from "./realtimeData.types";
-export type { SupastashConfig, SupastashSQLiteClientTypes, } from "./supastashConfig.types";
+export type { SupastashConfig, SupastashSQLiteClientTypes, SupastashSQLiteDatabase, SupastashSQLiteExecutor, } from "./supastashConfig.types";
 export type { SyncResult, TableSchema } from "./syncEngine.types";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC3E,YAAY,EACV,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC3E,YAAY,EACV,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/types/liteQuery.types.d.ts

@@ -1,4 +1,4 @@
-import { RealtimeFilter } from "./realtimeData.types";
+import { SupastashFilter } from "./realtimeData.types";
 
 /**
  * LiteQueryOptions
@@ -44,7 +44,7 @@ export type LiteQueryOptions<R = any> = {
    *   }
    * ]
    */
-  sqlFilter?: RealtimeFilter<R>[];
+  sqlFilter?: SupastashFilter<R>[];
 };
 
 export interface LiteQueryResult<R> {

package/dist/types/query.types.d.ts

@@ -1,6 +1,7 @@
 import { PostgrestError, PostgrestSingleResponse } from "@supabase/supabase-js";
+import { SupastashSQLiteExecutor } from "./supastashConfig.types";
 
-type SupabaseResult<T> = PostgrestSingleResponse<T>;
+export type SupabaseResult<T> = PostgrestSingleResponse<T>;
 export type PayloadData = any;
 
 export type SupabaseQueryReturn<U extends boolean, Z> = U extends true
@@ -50,6 +51,12 @@ export interface SupastashQuery<
   viewRemoteResult: boolean;
   onConflictKeys?: string[];
   preserveTimestamp: boolean;
+  throwOnError: boolean;
+  fetchPolicy: FetchPolicy | null;
+  // With tx
+  txId: string | null;
+  tx: SupastashSQLiteExecutor | null;
+  withTx: boolean;
 }
 
 export interface CrudReturnValue {
@@ -95,6 +102,8 @@ export type SyncMode =
   | "localOnly"
   | "remoteOnly";
 
+export type FetchPolicy = "localFirst" | "remoteFirst";
+
 export type SupastashQueryResult<
   T extends CrudMethods,
   U extends boolean,
@@ -135,6 +144,13 @@ export type QueryBuilder<
   // Transitions to U = true when called
   single(): QueryBuilder<T, true, R, Z>;
 
+  /**
+   * Throws an error if the query fails.
+   *
+   * @returns more filter options.
+   */
+  throwOnError(): QueryBuilder<T, U, R, Z>;
+
   // Executes the query
   execute<V extends boolean = false>(
     options?: ExecuteOptions & { viewRemoteResult?: V }
@@ -168,3 +184,10 @@ export interface ExecuteOptions {
    */
   debug?: boolean;
 }
+
+interface BatchedCall<T extends CrudMethods, U extends boolean, R> {
+  state: SupastashQuery<T, U, R>;
+  opKey: string;
+  resolve: (success: boolean) => void;
+  reject: (error: any) => void;
+}

package/dist/types/realtimeData.types.d.ts

@@ -8,13 +8,17 @@ export type FilterOperator =
   | "in"
   | "is";
 
-export type RealtimeFilter<R = any> = {
+export type Filter<R = any> = {
   column: keyof R;
   operator: FilterOperator;
   value: string | number | null | boolean | (string | number)[];
 };
 
-export type SupastashFilter<R = any> = RealtimeFilter<R>;
+export type SupastashFilter<R = any> =
+  | Filter<R>
+  | {
+      or: Filter<R>[];
+    };
 
 export interface RealtimeOptions<R = any> {
   /**
@@ -88,7 +92,7 @@ export interface RealtimeOptions<R = any> {
    * @example
    * sqlFilter: [{ column: "user_id", operator: "eq", value: "123" }]
    */
-  sqlFilter?: RealtimeFilter<R>[];
+  sqlFilter?: SupastashFilter<R>[];
 
   /**
    * Clears the shared cache for this table when the hook mounts.
@@ -115,7 +119,7 @@ export interface RealtimeOptions<R = any> {
    *   value: "123"
    * }
    */
-  filter?: RealtimeFilter<R>;
+  filter?: SupastashFilter<R>;
 
   /**
    * If true, only use the filter for the realtime subscription stream.