supastash 0.1.62 → 0.2.1

package/dist/{types → shared/types}/supastashConfig.types.d.ts

@@ -1,17 +1,23 @@
 import { SupabaseClient } from "@supabase/supabase-js";
+import TauriSQLiteDatabaseClient from "@tauri-apps/plugin-sql";
 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"
   | "rn-storage"
   | "rn-nitro"
+  | "tauri"
   | null;
 
 export type SupastashMode = "live" | "ghost";
 
+interface NetworkAdapter {
+  fetch: () => Promise<{ isConnected: boolean | null }>;
+}
+
 export type SupastashConfig<T extends SupastashSQLiteClientTypes> = {
   // --------------------------------------------------
   // Core Database & Client Configuration
@@ -22,6 +28,19 @@ export type SupastashConfig<T extends SupastashSQLiteClientTypes> = {
    */
   dbName: string;
 
+  /**
+   * Network adapter for native platforms.
+   *
+   * On React Native, pass in NetInfo to get reliable connectivity detection.
+   * ```ts
+   * import NetInfo from "@react-native-community/netinfo";
+   * configureSupastash({
+   *   networkAdapter: NetInfo,
+   * });
+   * ```
+   */
+  networkAdapter?: NetworkAdapter | null;
+
   /**
    * Supabase client instance.
    */
@@ -29,6 +48,43 @@ export type SupastashConfig<T extends SupastashSQLiteClientTypes> = {
 
   /**
    * SQLite client adapter.
+   *
+   * @example
+   * for React Native with Expo:
+   * ```ts
+   * import { openDatabaseAsync } from "expo-sqlite";
+   * configureSupastash({
+   *   sqliteClient: { openDatabaseAsync },
+   *   sqliteClientType: "expo",
+   * });
+   * ```
+   *
+   * for React Native with Nitro:
+   * ```ts
+   * import { open } from "react-native-nitro-sqlite";
+   * configureSupastash({
+   *   sqliteClient: { open },
+   *   sqliteClientType: "rn-nitro",
+   * });
+   * ```
+   *
+   * for React Native with SQLite Storage:
+   * ```ts
+   * import { openDatabaseAsync } from "react-native-sqlite-storage";
+   * configureSupastash({
+   *   sqliteClient: { openDatabaseAsync },
+   *   sqliteClientType: "rn-storage",
+   * });
+   * ```
+   *
+   * for Tauri or Desktop:
+   * ```ts
+   * import Database from "@tauri-apps/plugin-sql";
+   * configureSupastash({
+   *   sqliteClient: Database,
+   *   sqliteClientType: "tauri",
+   * });
+   * ```
    */
   sqliteClient: T extends "expo"
     ? ExpoSQLiteClient
@@ -36,8 +92,29 @@ export type SupastashConfig<T extends SupastashSQLiteClientTypes> = {
     ? RNStorageSQLiteClient
     : T extends "rn-nitro"
     ? RNSqliteNitroClient
+    : T extends "tauri"
+    ? TauriSQLiteClient
     : null;
 
+  /**
+   * Runtime platform.
+   *
+   * - "native": React Native environments (iOS, Android)
+   * - "desktop": Desktop runtimes (Tauri, Electron, etc.)
+   *
+   * Determines which adapters (DB, storage, lifecycle) are used.
+   *
+   * @default "native"
+   */
+  platform?: "native" | "desktop";
+
+  /**
+   * Enable this to turn off the simple null handling warning for Nitro SQLite.
+   *
+   * @default false
+   */
+  hasEnabledSimpleNullHandling?: boolean;
+
   /**
    * Type of SQLite client.
    */
@@ -50,7 +127,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 +155,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 +346,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 +355,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.
@@ -241,6 +384,105 @@ interface SupastashSQLiteDatabase {
    */
   execAsync(statements: string): Promise<void>;
 
+  /**
+   * Executes a read query and returns all matching rows.
+   *
+   * Designed for SELECT queries that may return multiple records.
+   * Always resolves to an array (empty if no rows match).
+   *
+   * @param sql - SQL query string. Supports named parameters (e.g. :shopId)
+   * @param params - Optional object of named parameters
+   *
+   * @returns Promise resolving to an array of rows
+   *
+   * @example
+   * await db.query(
+   *   "SELECT * FROM items WHERE shop_id = :shopId",
+   *   { shopId }
+   * );
+   *
+   * @example (no results)
+   * const rows = await db.query("SELECT * FROM items WHERE id = :id", { id: "x" });
+   * // rows = []
+   *
+   * ⚠️ Edge cases:
+   * - Returns [] if no rows found (never null/undefined)
+   * - Throws if SQL is invalid or execution fails
+   * - Missing params should throw (not silently fail)
+   * - Large result sets can impact performance → use LIMIT where possible
+   */
+  query<T = any>(sql: string, params?: Record<string, any>): Promise<T[]>;
+
+  /**
+   * Executes a read query and returns the first row only.
+   *
+   * Useful when exactly one result is expected (e.g. lookup by ID).
+   * Internally behaves like query() but returns only the first match.
+   * Add 'LIMIT 1' to the query if you want to ensure only one row is returned.
+   *
+   * @param sql - SQL query string. Supports named parameters
+   * @param params - Optional object of named parameters
+   *
+   * @returns Promise resolving to a single row, or null if no match is found
+   *
+   * @example
+   * await db.queryOne(
+   *   "SELECT * FROM shops WHERE id = :shopId",
+   *   { shopId }
+   * );
+   *
+   * @example (no result)
+   * const shop = await db.queryOne(...);
+   * // shop = null
+   *
+   * ⚠️ Edge cases:
+   * - Returns null if no rows found
+   * - If multiple rows match, ONLY the first row is returned (no warning)
+   * - You should enforce uniqueness at DB level if only one row is expected
+   * - Same error behavior as query()
+   */
+  queryOne<T = any>(
+    sql: string,
+    params?: Record<string, any>
+  ): Promise<T | null>;
+  /**
+   * Executes a write or mutation statement.
+   *
+   * Intended for INSERT, UPDATE, DELETE, and schema operations.
+   * Does not return result rows.
+   *
+   * @param sql - SQL statement to execute
+   * @param params - Optional object of named parameters
+   *
+   * @returns Promise resolving to execution metadata (driver-dependent)
+   *
+   * @example (insert)
+   * await db.execute(
+   *   "INSERT INTO items (id, name, shop_id) VALUES (:id, :name, :shopId)",
+   *   { id, name, shopId }
+   * );
+   *
+   * @example (update)
+   * await db.execute(
+   *   "UPDATE items SET name = :name WHERE id = :id",
+   *   { id, name }
+   * );
+   *
+   * ⚠️ Edge cases:
+   * - Does NOT return inserted/updated rows
+   *   → use RETURNING clause + query/queryOne if needed
+   *
+   * - Result shape may vary depending on underlying driver
+   *   (e.g. affectedRows, lastInsertId)
+   *
+   * - Should be wrapped in transactions for multi-step operations
+   *
+   * - Throws on constraint violations (e.g. UNIQUE, FOREIGN KEY)
+   */
+  execute(sql: string, params?: Record<string, any>): Promise<any>;
+}
+
+export interface SupastashSQLiteDatabase extends SupastashSQLiteExecutor {
   /**
    * Closes the underlying SQLite connection.
    *
@@ -251,12 +493,21 @@ 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 {
+export interface SupastashSQLiteAdapter<TClient = any> {
   openDatabaseAsync(
     name: string,
-    sqliteClient: ExpoSQLiteClient | RNStorageSQLiteClient | RNSqliteNitroClient
+    sqliteClient: TClient
   ): Promise<SupastashSQLiteDatabase>;
 }
 
@@ -277,7 +528,11 @@ export interface RNStorageSQLiteClient {
 }
 
 export interface RNSqliteNitroClient {
-  open: (options: { name: string; location?: string }) => RNNitroSQLiteDatabase;
+  open: (options: { name: string; location?: string }) => NitroSQLiteConnection;
+}
+
+export interface TauriSQLiteClient extends TauriSQLiteDatabaseClient {
+  load: (path: string) => Promise<TauriSQLiteDatabaseClient>;
 }
 
 export interface SupastashHookReturn {

package/dist/{types → shared/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/shared/utils/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/connection.ts"],"names":[],"mappings":"AAEA,wBAAsB,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAMjD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAehD"}

package/dist/{utils → shared/utils}/connection.js

@@ -1,10 +1,10 @@
-import NetInfo from "@react-native-community/netinfo";
+import { getSupastashConfig } from "../core/config";
 export async function isOnline() {
-    if (!NetInfo)
-        return true;
-    const networkState = await NetInfo.fetch();
-    if (!networkState.isConnected)
-        return false;
+    const config = getSupastashConfig();
+    if (config.networkAdapter)
+        return (await config.networkAdapter.fetch()).isConnected ?? false;
+    if (typeof navigator !== "undefined")
+        return navigator.onLine;
     return true;
 }
 export function isNetworkError(err) {

package/dist/shared/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/shared/utils/errorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../../src/shared/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/shared/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/shared/utils/events/eventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventBus.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/events/eventBus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,iBAAiB,uBAAqB,CAAC"}

package/dist/shared/utils/fetchData/addPayloadToUI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addPayloadToUI.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/fetchData/addPayloadToUI.ts"],"names":[],"mappings":"AAsBA,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,GAAG,GAAG,GAAG,EAAE,EACpB,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,EAC9D,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EACxD,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,QAoBrD"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"createTable.d.ts","sourceRoot":"","sources":["../../../../src/shared/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/shared/utils/fetchData/createTable.js

@@ -0,0 +1,38 @@
+import { getSupastashDb } from "../../db/dbInitializer";
+import log from "../logs";
+import { getRemoteTableSchema } from "../sync/status/remoteSchema";
+import { checkIfTableExist } from "../tableValidator";
+import { mapPgTypeToSQLite } from "./getKeyType";
+import { validatePayload } from "./validatePayload";
+/**
+ * Creates a table in the database
+ * @param table - The name of the table to create
+ * @param payload - The payload of the table
+ */
+export async function createTable(table, payload) {
+    const db = await getSupastashDb();
+    let newPayload = payload;
+    const isTableExist = await checkIfTableExist(table);
+    if (isTableExist)
+        return;
+    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.
+      `);
+    }
+    const columns = tableSchema.map((col) => {
+        return `${col.column_name} ${mapPgTypeToSQLite(col.data_type)} ${col.column_name === "id" ? "PRIMARY KEY" : ""} ${col.is_nullable === "YES" ? "" : "NOT NULL"}`;
+    });
+    validatePayload(newPayload);
+    try {
+        log("Table to be created", columns);
+        // Create the table
+        await db.runAsync(`CREATE TABLE IF NOT EXISTS ${table} (${columns.join(", ")})`);
+    }
+    catch (error) {
+        throw new Error(`Failed to create table ${table}. 
+      Use the 'defineLocalSchema()' function to create the table manually.
+      Error: ${error}`);
+    }
+}

package/dist/shared/utils/fetchData/dataState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataState.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/fetchData/dataState.ts"],"names":[],"mappings":"AAGA,iBAAS,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAQ4B;IACjE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACf,SAAS,CAAC,EAAE,GACT,CAAC,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GACpC,CAAC;CACH,CACF;AAED,eAAe,YAAY,CAAC"}

package/dist/{hooks/supastashData → shared/utils/fetchData}/dataState.js

@@ -1,5 +1,5 @@
 import { useCallback, useSyncExternalStore } from "react";
-import { getSnapshot, subscribe } from "../../utils/fetchData/snapShot";
+import { getSnapshot, subscribe } from "./snapShot";
 function useDataState(table) {
     const stableSubscribe = useCallback((cb) => subscribe(table, cb), [table]);
     const getStableSnapshot = useCallback(() => getSnapshot(table), [table]);

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

@@ -0,0 +1 @@
+{"version":3,"file":"deleteData.d.ts","sourceRoot":"","sources":["../../../../src/shared/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 → shared/utils}/fetchData/deleteData.js

@@ -1,7 +1,7 @@
-import { permanentlyDeleteData } from "../../utils/query/localDbQuery/delete";
-import { checkIfTableExist } from "../../utils/tableValidator";
 import { logError } from "../logs";
+import { permanentlyDeleteData } from "../query/localDbQuery/delete";
 import { refreshScreen } from "../refreshScreenCalls";
+import { checkIfTableExist } from "../tableValidator";
 import { createTable } from "./createTable";
 export async function deleteData(payload, table, shouldFetch = true) {
     if (!shouldFetch)
@@ -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 → shared/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/shared/utils/fetchData/fetchLocalData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchLocalData.d.ts","sourceRoot":"","sources":["../../../../src/shared/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/shared/utils/fetchData/getKeyType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getKeyType.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/fetchData/getKeyType.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,GAAG,GACT,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAuB/C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA8C3D"}

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

@@ -0,0 +1,6 @@
+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: SupastashFilter<R>[], table: string, noChecks?: boolean): Promise<string>;
+//# sourceMappingURL=liteHelpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"liteHelpers.d.ts","sourceRoot":"","sources":["../../../../src/shared/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"}