supastash 0.1.61 → 0.2.0

package/dist/types/supastashConfig.types.d.ts

@@ -1,8 +1,8 @@
 import { SupabaseClient } from "@supabase/supabase-js";
 import { SQLiteOpenOptions } from "expo-sqlite";
+import { NitroSQLiteConnection } from "react-native-nitro-sqlite";
+import { SQLiteDatabase as RNStorageSQLiteDatabase } from "react-native-sqlite-storage";
 import { ExpoSQLiteDatabase } from "./expoSqlite.types";
-import { RNNitroSQLiteDatabase } from "./rnNitroSqlite.types";
-import { RNStorageSQLiteDatabase } from "./rnSqliteStorage.types";
 
 export type SupastashSQLiteClientTypes =
   | "expo"
@@ -50,7 +50,7 @@ export type SupastashConfig<T extends SupastashSQLiteClientTypes> = {
   /**
    * Maximum number of rows sent per Supabase write request.
    * Large payloads are automatically split into sequential batches.
-   * Default: 100.
+   * Default: 800.
    */
   supabaseBatchSize?: number;
 
@@ -78,6 +78,72 @@ export type SupastashConfig<T extends SupastashSQLiteClientTypes> = {
     push?: number;
   };
 
+  /**
+   * Controls how Supastash determines incremental synchronization order.
+   *
+   * - "client-side":
+   *   Uses the `updated_at` column as the replication cursor.
+   *   Timestamps are generated by the client and compared during sync.
+   *   This mode is backward-compatible but may allow ordering inconsistencies
+   *   if devices that have been offline for a while push stale data.
+   *
+   * - "server-side":
+   *   Uses a server-controlled `arrived_at` column as the replication cursor.
+   *   The column must exist on the remote table and be enforced via trigger.
+   *   This provides deterministic, server-ordered replication and prevents
+   *   stale offline updates from breaking incremental sync.
+   *
+   * IMPORTANT:
+   * When "server-side" is enabled, Supastash requires the `arrived_at`
+   * column to exist on all synced tables. Sync will fail if missing.
+   *
+   * Recommended for production and distributed offline-first systems.
+   *
+   * @default "client-side"
+   *
+   * Docs: https://0xzekea.github.io/supastash/docs/replication-mode
+   */
+  replicationMode?: "client-side" | "server-side";
+
+  /**
+   * The maximum number of days Supastash will pull data from when syncing.
+   *
+   * Supastash will not request records older than (now - maxSyncLookbackDays),
+   * unless the table is listed in fullSyncTables or has a specific override
+   * in perTableSyncLookbackDays.
+   *
+   * Set to undefined to remove the cap globally.
+   *
+   * Default: 365 days.
+   */
+  maxSyncLookbackDays?: number;
+
+  /**
+   * Optional per-table override for maxSyncLookbackDays.
+   *
+   * Allows you to define a different lookback window (in days) for specific tables.
+   *
+   * If a table is listed here, its value takes precedence over maxSyncLookbackDays.
+   
+   *
+   * Example:
+   * {
+   *   messages: 30,        // only sync last 30 days
+   *   orders: 180,         // sync last 6 months
+   * }
+   */
+  perTableSyncLookbackDays?: Record<string, number | undefined>;
+
+  /**
+   * List of tables that should always sync their full history,
+   * ignoring maxSyncLookbackDays and perTableSyncLookbackDays.
+   *
+   * If a table is included here, no lookback cap will be applied.
+   *
+   * Useful for critical tables where complete cross-checking is required.
+   */
+  fullSyncTables?: string[];
+
   // --------------------------------------------------
   // Sync Engine Toggles & Behavior
   // --------------------------------------------------
@@ -203,7 +269,7 @@ export type SupastashConfig<T extends SupastashSQLiteClientTypes> = {
   supastashMode?: SupastashMode;
 };
 
-interface SupastashSQLiteDatabase {
+export interface SupastashSQLiteExecutor {
   /**
    * Executes a SQL statement without returning any result.
    * Useful for `INSERT`, `UPDATE`, `DELETE`, or `CREATE TABLE` commands.
@@ -212,7 +278,7 @@ interface SupastashSQLiteDatabase {
    * @param params - Optional parameters for the statement
    * @returns A Promise that resolves when the execution is complete
    */
-  runAsync(sql: string, params?: any[]): Promise<void>;
+  runAsync(sql: string, params?: any[]): Promise<any>;
 
   /**
    * Executes a query and returns **all rows** as an array.
@@ -240,7 +306,9 @@ interface SupastashSQLiteDatabase {
    * @returns A Promise that resolves when all statements are executed
    */
   execAsync(statements: string): Promise<void>;
+}
 
+export interface SupastashSQLiteDatabase extends SupastashSQLiteExecutor {
   /**
    * Closes the underlying SQLite connection.
    *
@@ -251,6 +319,15 @@ interface SupastashSQLiteDatabase {
    * Do NOT call this in production app code.
    */
   closeAsync(): Promise<void>;
+
+  /**
+   * Executes a function within a transaction.
+   * @param fn - The function to execute within the transaction
+   * @returns A Promise that resolves when the transaction is complete
+   */
+  withTransaction(
+    fn: (tx: SupastashSQLiteExecutor) => Promise<void> | void
+  ): Promise<void>;
 }
 
 export interface SupastashSQLiteAdapter {
@@ -277,7 +354,7 @@ export interface RNStorageSQLiteClient {
 }
 
 export interface RNSqliteNitroClient {
-  open: (options: { name: string; location?: string }) => RNNitroSQLiteDatabase;
+  open: (options: { name: string; location?: string }) => NitroSQLiteConnection;
 }
 
 export interface SupastashHookReturn {

package/dist/types/syncEngine.types.d.ts

@@ -1,4 +1,6 @@
+import { PayloadData } from "./query.types";
 import { SupastashFilter } from "./realtimeData.types";
+import { SupastashSQLiteExecutor } from "./supastashConfig.types";
 
 export type SyncResult = {
   success: string[]; // IDs that were successfully upserted
@@ -32,16 +34,12 @@ export type SupastashSyncStatus = {
   table_name: string;
   filter_key: string;
   filter_json: string;
-  last_created_at: string;
   last_synced_at: string;
-  last_deleted_at: string;
+  last_synced_at_pk: string | null;
+  last_deleted_at: string | null;
 };
 
-export type PublicScope =
-  | "all"
-  | "last_synced_at"
-  | "last_created_at"
-  | "last_deleted_at";
+export type PublicScope = "all" | "last_synced_at" | "last_deleted_at";
 
 export type CurrentTableInfo = {
   /** Table currently being synced */
@@ -119,3 +117,47 @@ export type SyncInfo = {
   /** Sync information for push operations (local → server) */
   push: SyncInfoItem;
 };
+
+export type ReceivedDataCompleted = {
+  completed: boolean;
+  lastTimestamp: string | undefined;
+  lastId: string | undefined;
+};
+export type ReceivedDataCompletedMap = {
+  [key: string]: {
+    arrived_at: ReceivedDataCompleted;
+    updated_at: ReceivedDataCompleted;
+  };
+};
+
+export type UpsertDataParams = {
+  /**
+   * Optional transaction executor.
+   *
+   * If provided, the upsert will execute within this existing transaction.
+   * This is typically supplied when called inside
+   * `db.withTransaction(...)` or `supastash.withTransaction(...)`.
+   *
+   * If omitted, the upsert will run using the root database executor.
+   */
+  tx?: SupastashSQLiteExecutor;
+
+  /**
+   * The table to perform the upsert on.
+   */
+  table: string;
+
+  /**
+   * The record to insert or update.
+   */
+  record: PayloadData | PayloadData[];
+
+  /**
+   * Optional optimization hint.
+   *
+   * If true, forces UPDATE.
+   * If false, forces INSERT.
+   * If undefined, existence will be determined automatically.
+   */
+  doesExist?: boolean;
+};

package/dist/utils/errorHandler.d.ts

@@ -0,0 +1,6 @@
+export declare class SupastashError extends Error {
+    code?: string;
+    meta?: Record<string, any>;
+    constructor(message: string, code?: string, meta?: Record<string, any>);
+}
+//# sourceMappingURL=errorHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/utils/errorHandler.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBACf,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAMvE"}

package/dist/utils/errorHandler.js

@@ -0,0 +1,8 @@
+export class SupastashError extends Error {
+    constructor(message, code, meta) {
+        super(message);
+        this.name = "SupastashError";
+        this.code = code;
+        this.meta = meta;
+    }
+}

package/dist/utils/fetchData/buildFilter.d.ts

@@ -1,4 +1,8 @@
-import { RealtimeFilter } from "../../types/realtimeData.types";
-export declare function buildFilterString<R = any>(filters: RealtimeFilter<R> | undefined): string | undefined;
-export declare function buildFilterForSql<R = any>(filter: RealtimeFilter<R> | undefined | undefined): string | undefined;
-//# sourceMappingURL=buildFilter.d.ts.map
+import { SupastashFilter } from "../../types/realtimeData.types";
+export declare function buildFilterString<R = any>(
+  filters: SupastashFilter<R> | undefined
+): string | undefined;
+export declare function buildFilterForSql<R = any>(
+  filter: SupastashFilter<R> | SupastashFilter<R> | undefined | undefined
+): string | undefined;
+//# sourceMappingURL=buildFilter.d.ts.map

package/dist/utils/fetchData/buildFilter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildFilter.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchData/buildFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,GAAG,EACvC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,GACrC,MAAM,GAAG,SAAS,CAepB;AAED,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,GAAG,EACvC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,SAAS,GAChD,MAAM,GAAG,SAAS,CAiCpB"}
+{"version":3,"file":"buildFilter.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchData/buildFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,eAAe,EAChB,MAAM,gCAAgC,CAAC;AAExC,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,GAAG,EACvC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,GACrC,MAAM,GAAG,SAAS,CAepB;AAED,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,GAAG,EACvC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,SAAS,GACrE,MAAM,GAAG,SAAS,CAiCpB"}

package/dist/utils/fetchData/createTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createTable.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchData/createTable.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAqDtD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,iBAsCrE"}
+{"version":3,"file":"createTable.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchData/createTable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAOtD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,iBAsCrE"}

package/dist/utils/fetchData/createTable.js

@@ -1,52 +1,9 @@
-import { getSupastashConfig } from "../../core/config";
 import { getSupastashDb } from "../../db/dbInitializer";
-import { tableSchemaData } from "../../store/tableSchemaData";
-import { isNetworkError, isOnline } from "../connection";
 import log from "../logs";
-import { supabaseClientErr } from "../supabaseClientErr";
+import { getRemoteTableSchema } from "../sync/status/remoteSchema";
 import { checkIfTableExist } from "../tableValidator";
 import { mapPgTypeToSQLite } from "./getKeyType";
-import { validatePayload, validatePayloadForTable } from "./validatePayload";
-let errorCount = new Map();
-async function getTableSchema(table) {
-    const config = getSupastashConfig();
-    const supabase = config?.supabaseClient;
-    if (!supabase) {
-        throw new Error(`Supabase client not found, ${supabaseClientErr}`);
-    }
-    if (tableSchemaData.has(table)) {
-        return tableSchemaData.get(table);
-    }
-    if (errorCount.get(table) && (errorCount.get(table) || 0) > 3) {
-        return null;
-    }
-    const isConnected = await isOnline();
-    if (!isConnected) {
-        return null;
-    }
-    const { data, error } = await supabase.rpc("get_table_schema", {
-        table_name: table,
-    });
-    if (error) {
-        if (!isNetworkError(error)) {
-            log(`[Supastash] Error getting table schema for table ${table}: ${error.message}`);
-        }
-        errorCount.set(table, (errorCount.get(table) || 0) + 1);
-        return null;
-    }
-    if (!data || !Array.isArray(data))
-        return null;
-    validatePayloadForTable(data);
-    tableSchemaData.set(table, data);
-    return [
-        ...data,
-        {
-            column_name: "synced_at",
-            data_type: "text",
-            is_nullable: "YES",
-        },
-    ];
-}
+import { validatePayload } from "./validatePayload";
 /**
  * Creates a table in the database
  * @param table - The name of the table to create
@@ -58,7 +15,7 @@ export async function createTable(table, payload) {
     const isTableExist = await checkIfTableExist(table);
     if (isTableExist)
         return;
-    const tableSchema = await getTableSchema(table);
+    const tableSchema = await getRemoteTableSchema(table);
     if (!tableSchema) {
         throw new Error(`[Supastash] Can't create table ${table} because no data was found
         Try creating the table manually using the 'defineLocalSchema()' function.

package/dist/utils/fetchData/deleteData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deleteData.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchData/deleteData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAOtD,wBAAsB,UAAU,CAC9B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,OAAc,iBAqB5B"}
+{"version":3,"file":"deleteData.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchData/deleteData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAOtD,wBAAsB,UAAU,CAC9B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,OAAc,iBAwB5B"}

package/dist/utils/fetchData/deleteData.js

@@ -14,9 +14,12 @@ export async function deleteData(payload, table, shouldFetch = true) {
         if (!payload?.id)
             return;
         // Delete the data
-        await permanentlyDeleteData(table, [
-            { column: "id", operator: "=", value: payload.id },
-        ]);
+        await permanentlyDeleteData({
+            table,
+            filters: [{ column: "id", operator: "=", value: payload.id }],
+            tx: null,
+            throwOnError: true,
+        });
         refreshScreen(table);
     }
     catch (error) {

package/dist/utils/fetchData/fetchLocalData.d.ts

@@ -1,5 +1,5 @@
 import { PayloadData } from "../../types/query.types";
-import { RealtimeFilter } from "../../types/realtimeData.types";
+import { SupastashFilter } from "../../types/realtimeData.types";
 /**
  * Fetches the local data from the database
  * @param table - The table name to fetch from
@@ -7,7 +7,7 @@ import { RealtimeFilter } from "../../types/realtimeData.types";
  * @param limit - Optional limit for rows
  * @param extraMapKeys - Optional fields to group data by
  */
-export declare function fetchLocalData<R = any>(table: string, shouldFetch?: boolean, limit?: number, extraMapKeys?: (keyof R)[], daylength?: number, filter?: RealtimeFilter[], orderBy?: keyof R | string, orderDesc?: boolean): Promise<{
+export declare function fetchLocalData<R = any>(table: string, shouldFetch?: boolean, limit?: number, extraMapKeys?: (keyof R)[], daylength?: number, filter?: SupastashFilter[], orderBy?: keyof R | string, orderDesc?: boolean): Promise<{
     data: PayloadData[];
     dataMap: Map<string, PayloadData>;
     groupedBy: {

package/dist/utils/fetchData/fetchLocalData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetchLocalData.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchData/fetchLocalData.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AA8DhE;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,GAAG,EAC1C,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,OAAc,EAC3B,KAAK,GAAE,MAAY,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAC1B,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,cAAc,EAAE,EACzB,OAAO,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,EAC1B,SAAS,GAAE,OAAc,GACxB,OAAO,CAAC;IACT,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC,SAAS,EAAE;SACR,CAAC,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;KAC9C,CAAC;CACH,GAAG,IAAI,CAAC,CAiGR"}
+{"version":3,"file":"fetchLocalData.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchData/fetchLocalData.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AA8DjE;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,GAAG,EAC1C,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,OAAc,EAC3B,KAAK,GAAE,MAAY,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAC1B,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,eAAe,EAAE,EAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,EAC1B,SAAS,GAAE,OAAc,GACxB,OAAO,CAAC;IACT,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC,SAAS,EAAE;SACR,CAAC,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;KAC9C,CAAC;CACH,GAAG,IAAI,CAAC,CAiGR"}

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

@@ -1,3 +1,3 @@
-import { RealtimeFilter } from "../../types/realtimeData.types";
-export declare function initialFetch(table: string, filter?: RealtimeFilter[], onReceiveData?: (payload: any) => Promise<void>, onPushToRemote?: (payload: any[]) => Promise<boolean>): Promise<void>;
+import { SupastashFilter } from "../../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/utils/fetchData/initialFetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initialFetch.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchData/initialFetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAQhE,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,cAAc,EAAE,EACzB,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"}
+{"version":3,"file":"initialFetch.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchData/initialFetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAQjE,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/fetchData/liteHelpers.d.ts

@@ -1,6 +1,6 @@
-import { RealtimeFilter } from "../../types/realtimeData.types";
+import { SupastashFilter } from "../../types/realtimeData.types";
 export declare function parseJSONColumns<R extends Record<string, any>>(row: R): R;
 export declare function sanitizeTableName(table: string): string;
 export declare function sanitizeOrderBy(orderBy: string): string;
-export declare function buildFilters<R = any>(filters: RealtimeFilter<R>[], table: string, noChecks?: boolean): Promise<string>;
+export declare function buildFilters<R = any>(filters: SupastashFilter<R>[], table: string, noChecks?: boolean): Promise<string>;
 //# sourceMappingURL=liteHelpers.d.ts.map

package/dist/utils/fetchData/liteHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"liteHelpers.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchData/liteHelpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAKhE,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAuBzE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKvD;AAWD,wBAAsB,YAAY,CAAC,CAAC,GAAG,GAAG,EACxC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,EAC5B,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC,MAAM,CAAC,CAqDjB"}
+{"version":3,"file":"liteHelpers.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchData/liteHelpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAKjE,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAuBzE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKvD;AAWD,wBAAsB,YAAY,CAAC,CAAC,GAAG,GAAG,EACxC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,EAC7B,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC,MAAM,CAAC,CAoEjB"}

package/dist/utils/fetchData/liteHelpers.js

@@ -1,6 +1,6 @@
 import { getTableSchema } from "../getTableSchema";
 import { logError, logWarn } from "../logs";
-import { buildFilterForSql } from "./buildFilter";
+import { ReusedHelpers } from "../reusedHelpers";
 export function parseJSONColumns(row) {
     const parsedRow = { ...row };
     const errors = [];
@@ -50,6 +50,18 @@ export async function buildFilters(filters, table, noChecks = false) {
         }
         const filterStringArray = [];
         for (const filter of filters) {
+            if ("or" in filter) {
+                try {
+                    const filterSql = ReusedHelpers.buildFilterForSql(filter);
+                    if (filterSql) {
+                        filterStringArray.push(filterSql);
+                    }
+                }
+                catch (error) {
+                    logError(`[Supastash] Failed to build OR filter for table ${table}:`, error);
+                }
+                continue;
+            }
             if (!filter?.column) {
                 logWarn(`[Supastash] Skipping filter with missing column`);
                 continue;
@@ -60,7 +72,7 @@ export async function buildFilters(filters, table, noChecks = false) {
                 continue;
             }
             try {
-                const filterSql = buildFilterForSql(filter);
+                const filterSql = ReusedHelpers.buildFilterForSql(filter);
                 if (filterSql) {
                     filterStringArray.push(filterSql);
                 }
@@ -78,120 +90,3 @@ export async function buildFilters(filters, table, noChecks = false) {
         return "";
     }
 }
-// export async function fetchData<R = any>({
-//   table,
-//   options,
-//   state,
-//   isLoadMore,
-//   isRefresh,
-// }: FetchOptions<R>): Promise<FetchResult<R> | null> {
-//   const db = await getSupastashDb();
-//   const sanitizedTable = sanitizeTableName(table);
-//   const sanitizedOrderBy = sanitizeOrderBy(options.orderBy ?? "created_at");
-//   const limit = options.pageSize ?? 50;
-//   const orderDirection = options.orderDesc === false ? "ASC" : "DESC";
-//   const enableCursor = options.enableCursor !== false;
-//   try {
-//     const filters = await buildFilters(options.sqlFilter ?? [], sanitizedTable);
-//     const staleTime = options.staleTime ?? 30000;
-//     const isCacheStale = Date.now() - state.lastFetch > staleTime;
-//     if (!isRefresh && !isLoadMore && state.data.length > 0 && !isCacheStale) {
-//       logWarn(`[Supastash] Using cached data for ${table}`);
-//       return null;
-//     }
-//     let query: string;
-//     let params: any[] = [];
-//     if (enableCursor && isLoadMore && state.cursor) {
-//       const operator = orderDirection === "DESC" ? "<" : ">";
-//       const snapshotClause = state.snapshotTime
-//         ? ` AND created_at <= '${state.snapshotTime}'`
-//         : "";
-//       query = `
-//         SELECT * FROM ${sanitizedTable}
-//         WHERE deleted_at IS NULL${filters}${snapshotClause}
-//         AND ${sanitizedOrderBy} ${operator} ?
-//         ORDER BY ${sanitizedOrderBy} ${orderDirection}, id ${orderDirection}
-//         LIMIT ${limit};
-//       `;
-//       params = [state.cursor];
-//     } else {
-//       const snapshotClause =
-//         !isRefresh && state.snapshotTime
-//           ? ` AND created_at <= '${state.snapshotTime}'`
-//           : "";
-//       query = `
-//         SELECT * FROM ${sanitizedTable}
-//         WHERE deleted_at IS NULL${filters}${snapshotClause}
-//         ORDER BY ${sanitizedOrderBy} ${orderDirection}, id ${orderDirection}
-//         LIMIT ${limit};
-//       `;
-//     }
-//     const rows = await db.getAllAsync(query, params);
-//     if (!rows || rows.length === 0) {
-//       return {
-//         data: [],
-//         dataMap: new Map(),
-//         groupedBy: undefined,
-//         hasMore: false,
-//         cursor: null,
-//       };
-//     }
-//     const processed = await processRows<R>(
-//       rows,
-//       options.extraMapKeys,
-//       sanitizedOrderBy
-//     );
-//     const newCursor =
-//       enableCursor && rows.length > 0
-//         ? rows[rows.length - 1][sanitizedOrderBy]
-//         : null;
-//     return {
-//       data: processed.parsed,
-//       dataMap: processed.dataMap,
-//       groupedBy: processed.groupedBy,
-//       hasMore: rows.length === limit,
-//       cursor: newCursor,
-//     };
-//   } catch (error) {
-//     logError(`[Supastash] Failed to fetch data from ${table}:`, error);
-//     throw error;
-//   }
-// }
-async function processRows(rows, extraMapKeys, orderByColumn) {
-    const parsed = [];
-    const dataMap = new Map();
-    const groupedBy = {};
-    for (const row of rows) {
-        try {
-            const parsedRow = parseJSONColumns(row);
-            parsed.push(parsedRow);
-            dataMap.set(row.id, parsedRow);
-            if (extraMapKeys?.length) {
-                for (const key of extraMapKeys) {
-                    if (key === "id") {
-                        logWarn(`[Supastash] Key 'id' is redundant - use dataMap.get(id)`);
-                        continue;
-                    }
-                    if (parsedRow[key] == null) {
-                        logWarn(`[Supastash] Item ${parsedRow.id} missing ${String(key)}`);
-                        continue;
-                    }
-                    const groupVal = parsedRow[key];
-                    if (!groupedBy[key])
-                        groupedBy[key] = new Map();
-                    if (!groupedBy[key].has(groupVal))
-                        groupedBy[key].set(groupVal, []);
-                    groupedBy[key].get(groupVal).push(parsedRow);
-                }
-            }
-        }
-        catch (error) {
-            logError(`[Supastash] Failed to process row:`, error, row);
-        }
-    }
-    return {
-        parsed,
-        dataMap,
-        groupedBy: Object.keys(groupedBy).length > 0 ? groupedBy : undefined,
-    };
-}

package/dist/utils/fetchData/realTimeCall.js

@@ -2,12 +2,12 @@ import { useEffect, useMemo, useState } from "react";
 import { getSupastashConfig } from "../../core/config";
 import { supastashEventBus } from "../events/eventBus";
 import { logError } from "../logs";
+import { ReusedHelpers } from "../reusedHelpers";
 import { supabaseClientErr } from "../supabaseClientErr";
-import { buildFilterString } from "./buildFilter";
 const hasRegistered = new Map();
 const useRealtimeData = (table, queueHandler, options, initialized, realtime) => {
     const { lazy, shouldFetch } = options;
-    const filterString = useMemo(() => buildFilterString(options.filter), [options.filter]);
+    const filterString = useMemo(() => ReusedHelpers.buildFilterString(options.filter), [options.filter]);
     const subKey = useMemo(() => `${table}:${filterString ?? ""}`, [table, filterString]);
     const [version, setVersion] = useState(0);
     useEffect(() => {

package/dist/utils/fetchData/receiveData.js

@@ -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/utils/query/builder/crud.d.ts

@@ -18,27 +18,27 @@ export default class SupastashCrudBuilder<T extends CrudMethods, U extends boole
      * @param data - The data to insert. Could be a single object or an array of objects.
      * @returns filter options.
      */
-    insert<Z = any>(data: R): SupastashFilterBuilder<"insert", false, R, Z>;
+    insert<Z = any>(data: R): Omit<SupastashFilterBuilder<"insert", false, R, Z>, "cacheFirst">;
     /**
      * Sets the method to update.
      *
      * @param data - The data to update.
      * @returns filter options.
      */
-    update<Z = any>(data: R): SupastashFilterBuilder<"update", false, R, Z>;
+    update<Z = any>(data: R): Omit<SupastashFilterBuilder<"update", false, R, Z>, "cacheFirst" | "run" | "go" | "execute">;
     /**
      * Sets the method to delete.
      *
      * @returns filter options.
      */
-    delete<Z = any>(): SupastashFilterBuilder<"delete", false, R, Z>;
+    delete<Z = any>(): Omit<SupastashFilterBuilder<"delete", false, R, Z>, "cacheFirst">;
     /**
      * Sets the method to select.
      *
      * @param column - The column to select.
      * @returns filter options.
      */
-    select<Z = any>(column?: string): SupastashFilterBuilder<"select", false, R, Z>;
+    select<Z = any>(column?: string): Omit<SupastashFilterBuilder<"select", false, R, Z>, "withTx">;
     /**
      * Sets the method to upsert.
      *
@@ -59,6 +59,6 @@ export default class SupastashCrudBuilder<T extends CrudMethods, U extends boole
      */
     upsert<Z = any>(data: R | R[], options?: {
         onConflictKeys?: string[];
-    }): SupastashFilterBuilder<"upsert", false, R, Z>;
+    }): Omit<SupastashFilterBuilder<"upsert", false, R, Z>, "cacheFirst">;
 }
 //# sourceMappingURL=crud.d.ts.map

package/dist/utils/query/builder/crud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/builder/crud.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,sBAAsB,MAAM,WAAW,CAAC;AAE/C;;;;GAIG;AAEH,MAAM,CAAC,OAAO,OAAO,oBAAoB,CACvC,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,OAAO,EACjB,CAAC;IAMW,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJlC;;;OAGG;gBAC0B,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC;IAWvB;;;;;OAKG;IACH,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC;IAWvB;;;;OAIG;IACH,MAAM,CAAC,CAAC,GAAG,GAAG;IAUd;;;;;OAKG;IACH,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM;IAW/B;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CAWvE"}
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/builder/crud.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,sBAAsB,MAAM,WAAW,CAAC;AAE/C;;;;GAIG;AAEH,MAAM,CAAC,OAAO,OAAO,oBAAoB,CACvC,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,OAAO,EACjB,CAAC;IAMW,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJlC;;;OAGG;gBAC0B,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC,GAQhB,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC;IAGxE;;;;;OAKG;IACH,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC,GAQhB,IAAI,CACP,sBAAsB,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAC7C,YAAY,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CACxC;IAGH;;;;OAIG;IACH,MAAM,CAAC,CAAC,GAAG,GAAG,KAOP,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC;IAGxE;;;;;OAKG;IACH,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,GAQxB,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC;IAGpE;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAS/D,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC;CAEzE"}