supastash 0.1.62 → 0.2.1

package/dist/{utils → shared/utils}/sync/pullFromRemote/helpers.js

@@ -1,8 +1,8 @@
 import { getSupastashConfig } from "../../../core/config";
 import { RECEIVED_DATA_COMPLETED_MAP, RECEIVED_DATA_THRESHOLD, } from "../../../store/syncStatus";
 import log from "../../logs";
+import { ReusedHelpers } from "../../reusedHelpers";
 import { supabaseClientErr } from "../../supabaseClientErr";
-import isValidFilter from "./validateFilters";
 const RANDOM_OLD_DATE = "2000-01-01T00:00:00Z";
 const PAGE_SIZE = RECEIVED_DATA_THRESHOLD;
 const MAX_PAGE_SIZE = 2000;
@@ -10,15 +10,6 @@ const timesPulled = new Map();
 const lastPulled = new Map();
 const DEFAULT_MAX_PULL_ATTEMPTS = 150;
 const DEFAULT_PK = "00000000-0000-0000-0000-000000000000";
-function applyFilters(q, filters, table) {
-    for (const f of filters) {
-        if (!isValidFilter([f])) {
-            throw new Error(`Invalid syncFilter: ${JSON.stringify(f)} for ${table}`);
-        }
-        q = q[f.operator](f.column, f.value);
-    }
-    return q;
-}
 export async function pageThrough(base) {
     const supabase = getSupastashConfig().supabaseClient;
     if (!supabase)
@@ -34,7 +25,11 @@ export async function pageThrough(base) {
     let cursorId = base.previousPk ?? lastWork.lastId;
     let lastDataSize = 0;
     const { table, filters = [], select = "*" } = base;
+    const maxSyncLookBack = getMaxSyncLookBack({ table });
     while (true) {
+        const ts = maxSyncLookBack && Date.parse(cursorTs) < Date.parse(maxSyncLookBack)
+            ? maxSyncLookBack
+            : cursorTs;
         let q = supabase
             .from(table)
             .select(select)
@@ -42,13 +37,13 @@ export async function pageThrough(base) {
             .order("id", { ascending: true })
             .limit(PAGE_SIZE);
         if (cursorId) {
-            q = q.or(`${base.tsCol}.gt.${cursorTs},and(${base.tsCol}.eq.${cursorTs},id.gt.${cursorId})`);
+            q = q.or(`${base.tsCol}.gt.${ts},and(${base.tsCol}.eq.${ts},id.gt.${cursorId})`);
         }
         else {
-            q = q.gte(base.tsCol, cursorTs);
+            q = q.gte(base.tsCol, ts);
         }
-        if (filters) {
-            q = applyFilters(q, filters, table);
+        if (filters && filters.length > 0) {
+            q = ReusedHelpers.applyFilters(q, filters, table);
         }
         const { data, error } = await q;
         if (error)
@@ -150,3 +145,14 @@ export function setReceivedDataCompleted({ batchId, col, completed, }) {
 export function deleteReceivedDataCompleted(batchId) {
     delete RECEIVED_DATA_COMPLETED_MAP[batchId];
 }
+export function getMaxSyncLookBack({ table, }) {
+    const cfg = getSupastashConfig();
+    if (cfg.fullSyncTables?.includes(table)) {
+        return undefined;
+    }
+    const perTable = cfg.perTableSyncLookbackDays?.[table];
+    const days = perTable !== undefined ? perTable : cfg.maxSyncLookbackDays;
+    if (days === undefined)
+        return undefined;
+    return new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
+}

package/dist/shared/utils/sync/pullFromRemote/runLimitedConcurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runLimitedConcurrency.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/sync/pullFromRemote/runLimitedConcurrency.ts"],"names":[],"mappings":"AAEA,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,EAChC,CAAC,EAAE,MAAM,EACT,IAAI,CAAC,EAAE;IACL,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD,GACA,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAmC1D"}

package/dist/{utils → shared/utils}/sync/pullFromRemote/runLimitedConcurrency.js

@@ -1,4 +1,4 @@
-import { logWarn } from "../../../utils/logs";
+import { logWarn } from "../../logs";
 export async function runLimitedConcurrency(tasks, n, opts) {
     const total = tasks.length;
     if (!total || n <= 0)

package/dist/shared/utils/sync/pullFromRemote/stringifyFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringifyFields.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/sync/pullFromRemote/stringifyFields.ts"],"names":[],"mappings":"AAIA,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,OAcjD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,OAMxC"}

package/dist/{utils → shared/utils}/sync/pullFromRemote/updateFilter.d.ts

@@ -1,4 +1,4 @@
-import { SupastashFilter } from "../../../types/supastashFilters.types";
+import { SupastashFilter } from "../../../types/realtimeData.types";
 /**
  * Updates the filter for the given table
  * Non-hook version of useSupastashFilters

package/dist/shared/utils/sync/pullFromRemote/updateFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateFilter.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/sync/pullFromRemote/updateFilter.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAMpE;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,iBAwC3D"}

package/dist/{utils → shared/utils}/sync/pullFromRemote/updateFilter.js

@@ -1,7 +1,8 @@
 import { filterTracker, tableFilters, tableFiltersUsed, } from "../../../store/tableFilters";
 import { logWarn } from "../../logs";
+import { ReusedHelpers } from "../../reusedHelpers";
 import { checkIfTableExist } from "../../tableValidator";
-import isValidFilter, { warnOnMisMatch } from "./validateFilters";
+import { warnOnMisMatch } from "./validateFilters";
 /**
  * Updates the filter for the given table
  * Non-hook version of useSupastashFilters
@@ -26,8 +27,9 @@ export async function updateFilters(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/shared/utils/sync/pullFromRemote/validateFilters.d.ts

@@ -0,0 +1,3 @@
+import { SupastashFilter } from "../../../types/realtimeData.types";
+export declare function warnOnMisMatch<R = any>(table: string, filters: SupastashFilter<R>[]): void;
+//# sourceMappingURL=validateFilters.d.ts.map

package/dist/shared/utils/sync/pullFromRemote/validateFilters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateFilters.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/sync/pullFromRemote/validateFilters.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAOpE,wBAAgB,cAAc,CAAC,CAAC,GAAG,GAAG,EACpC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,QA2D9B"}

package/dist/shared/utils/sync/pullFromRemote/validateFilters.js

@@ -0,0 +1,49 @@
+import { filterTracker } from "../../../store/tableFilters";
+import { logWarn } from "../../logs";
+const tablesWarned = new Set();
+const debounceWarnTime = 2000;
+let debounceWarnTimeout = null;
+export function warnOnMisMatch(table, filters) {
+    const existingFilters = filterTracker.get(table);
+    let hasMismatch = false;
+    if (existingFilters) {
+        const maxLength = Math.max(existingFilters.length, filters.length);
+        for (let i = 0; i < maxLength; i++) {
+            const oldFilter = existingFilters[i];
+            const newFilter = filters[i];
+            if ("or" in oldFilter || "or" in newFilter) {
+                if ("or" in oldFilter && "or" in newFilter) {
+                    if (oldFilter.or.length !== newFilter.or.length) {
+                        hasMismatch = true;
+                        break;
+                    }
+                }
+                continue;
+            }
+            if (!oldFilter || !newFilter) {
+                hasMismatch = true;
+                break;
+            }
+            if (oldFilter.column !== newFilter.column ||
+                oldFilter.operator !== newFilter.operator) {
+                hasMismatch = true;
+                break;
+            }
+        }
+    }
+    if (hasMismatch) {
+        tablesWarned.add(table);
+        if (debounceWarnTimeout) {
+            clearTimeout(debounceWarnTimeout);
+        }
+        debounceWarnTimeout = setTimeout(() => {
+            logWarn(`[Supastash] Conflicting filters detected for table(s): ${Array.from(tablesWarned).join(", ")}. 
+          Multiple sync calls registered different filters for the same table. 
+          The last registered filter will be used, overriding previous ones. 
+          Ensure each table is registered with a single, consistent filter to avoid unintended data scope.`);
+            tablesWarned.clear();
+            debounceWarnTimeout = null;
+        }, debounceWarnTime);
+    }
+    filterTracker.set(table, filters);
+}

package/dist/shared/utils/sync/pushLocal/deleteChunks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteChunks.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/sync/pushLocal/deleteChunks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AA6DzD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,WAAW,EAAE,iBAc/B"}

package/dist/{utils → shared/utils}/sync/pushLocal/deleteChunks.js

@@ -12,11 +12,13 @@ const SQL_CHUNK = 999;
  */
 async function permanentlyDeleteLocally(table, ids) {
     const db = await getSupastashDb();
-    for (let i = 0; i < ids.length; i += SQL_CHUNK) {
-        const slice = ids.slice(i, i + SQL_CHUNK);
-        const placeholders = slice.map(() => "?").join(", ");
-        await db.runAsync(`DELETE FROM ${table} WHERE id IN (${placeholders})`, slice);
-    }
+    await db.withTransaction(async (tx) => {
+        for (let i = 0; i < ids.length; i += SQL_CHUNK) {
+            const slice = ids.slice(i, i + SQL_CHUNK);
+            const placeholders = slice.map(() => "?").join(", ");
+            await tx.runAsync(`DELETE FROM ${table} WHERE id IN (${placeholders})`, slice);
+        }
+    });
 }
 /**
  * Deletes a chunk of data from the remote database

package/dist/shared/utils/sync/pushLocal/getAllUnsyncedData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAllUnsyncedData.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/sync/pushLocal/getAllUnsyncedData.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAwCzD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,CAe/B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,CAM/B"}

package/dist/shared/utils/sync/pushLocal/getAllUnsyncedData.js

@@ -0,0 +1,53 @@
+import { getSupastashDb } from "../../../db/dbInitializer";
+import { getTableSchema } from "../../getTableSchema";
+import log from "../../logs";
+import { getRemoteTableSchema } from "../status/remoteSchema";
+const sharedKeysCache = new Map();
+async function getRemoteKeys(table) {
+    if (sharedKeysCache.has(table)) {
+        return sharedKeysCache.get(table);
+    }
+    const remoteSchema = await getRemoteTableSchema(table);
+    if (!remoteSchema)
+        return null;
+    const remoteKeys = remoteSchema.map((col) => col.column_name);
+    const localSchema = await getTableSchema(table);
+    if (!localSchema)
+        return null;
+    const localKeys = localSchema;
+    const sharedKeys = remoteKeys.filter((key) => localKeys.includes(key));
+    const missingKeys = remoteKeys.filter((key) => !localKeys.includes(key) && key !== "synced_at" && key !== "arrived_at");
+    if (missingKeys.length > 0) {
+        log(`[Supastash] Missing keys for table ${table}: ${missingKeys.join(", ")}`);
+    }
+    sharedKeysCache.set(table, sharedKeys);
+    return sharedKeys.length ? sharedKeys : null;
+}
+/**
+ * Gets all unsynced data from a table
+ * @param table - The table to get the data from
+ * @returns The unsynced data
+ */
+export async function getAllUnsyncedData(table) {
+    const db = await getSupastashDb();
+    const remoteKeys = await getRemoteKeys(table);
+    if (!remoteKeys) {
+        const query = `SELECT * FROM ${table} WHERE synced_at IS NULL AND deleted_at IS NULL`;
+        const data = await db.getAllAsync(query);
+        return data ?? null;
+    }
+    const columns = remoteKeys.join(", ");
+    const query = `SELECT ${columns} FROM ${table} WHERE synced_at IS NULL AND deleted_at IS NULL`;
+    const data = await db.getAllAsync(query);
+    return data ?? null;
+}
+/**
+ * Gets all deleted data from a table
+ * @param table - The table to get the data from
+ * @returns The deleted data
+ */
+export async function getAllDeletedData(table) {
+    const db = await getSupastashDb();
+    const data = await db.getAllAsync(`SELECT deleted_at, id FROM ${table} WHERE deleted_at IS NOT NULL`);
+    return data ?? null;
+}

package/dist/shared/utils/sync/pushLocal/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/sync/pushLocal/normalize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAE1D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,WA0B7C"}

package/dist/shared/utils/sync/pushLocal/parseFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseFields.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/sync/pushLocal/parseFields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,OAgBjD"}

package/dist/{utils → shared/utils}/sync/queryStatus.d.ts

@@ -37,7 +37,7 @@ export declare function getTableStatus(table: string): {
  *          "pending" if any table is syncing,
  *          "synced" if all tables are fully synced
  */
-export declare function getSupastashStatus(): "error" | "pending" | "synced";
+export declare function getSupastashStatus(): "pending" | "error" | "synced";
 declare function snapshot(): SyncInfo;
 export declare const SyncInfoUpdater: {
     setInProgress: ({ action, type, }: {

package/dist/shared/utils/sync/queryStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryStatus.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/sync/queryStatus.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAGtE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,QAYxC;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,MAAM,iBAgBvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM;;;;;EAwB3C;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,mCAcjC;AAID,iBAAS,QAAQ,IAAI,QAAQ,CAE5B;AAKD,eAAO,MAAM,eAAe;uCAIvB;QACD,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;QACzB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB;4CAUE;QACD,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB;2CAUE;QACD,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB;wCAUE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB;mDAgBE;QACD,GAAG,EAAE,MAAM,YAAY,CAAC;QACxB,KAAK,EAAE,YAAY,CAAC,MAAM,YAAY,CAAC,CAAC;QACxC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;KACf;qDAqBE;QACD,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;KACf;wDAiBE;QACD,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;KACf;oCAc+B;QAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;uCAWrE;QACD,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;KACf;wEAqBE;QACD,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,KAAK,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;sBAiCiB;QAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;;CAe5C,CAAC"}

package/dist/shared/utils/sync/refreshTables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refreshTables.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/sync/refreshTables.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,QASzC;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,SAE/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,QAGrD"}

package/dist/shared/utils/sync/registration/syncCalls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncCalls.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/sync/registration/syncCalls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAG5D;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,EAChB,EAAE,aAAqB,EAAE,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,QAO5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,QAE/C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;GAEG;AACH,wBAAgB,cAAc,SAE7B"}

package/dist/{utils → shared/utils}/sync/registration/syncCalls.js

@@ -1,5 +1,5 @@
 import { syncCalls } from "../../../store/syncCalls";
-import log from "../../../utils/logs";
+import log from "../../logs";
 /**
  * Register a sync call (push/pull) for a given table.
  * Prevents overriding existing entries unless allowOverride = true.

package/dist/shared/utils/sync/status/remoteSchema.d.ts

@@ -0,0 +1,4 @@
+import { TableSchema } from "../../../types/realtimeData.types";
+export declare function appendSyncedAt(schema: TableSchema[]): TableSchema[];
+export declare function getRemoteTableSchema(table: string): Promise<TableSchema[] | null>;
+//# sourceMappingURL=remoteSchema.d.ts.map

package/dist/shared/utils/sync/status/remoteSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteSchema.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/sync/status/remoteSchema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AA4HhE,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,iBASnD;AAID,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,CAkD/B"}

package/dist/shared/utils/sync/status/remoteSchema.js

@@ -0,0 +1,140 @@
+import { getSupastashConfig } from "../../../core/config";
+import { getSupastashDb } from "../../../db/dbInitializer";
+import { tableSchemaData } from "../../../store/tableSchemaData";
+import { isNetworkError, isOnline } from "../../connection";
+import log, { logWarn } from "../../logs";
+const SERVER_SIDE_DOCS_URL = `https://0xzekea.github.io/supastash/docs/getting-started/#%EF%B8%8F-server-side-setup-for-filtered-pulls`;
+async function ensureRemoteSchemaTableExists() {
+    const db = await getSupastashDb();
+    await db.execAsync(`CREATE TABLE IF NOT EXISTS supastash_remote_table_schema (
+    table_name TEXT PRIMARY KEY,
+    schema_json TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );`);
+}
+function validatePayloadForTable(payload, tableName) {
+    const columnsMap = new Map();
+    payload.forEach((col) => {
+        columnsMap.set(col.column_name, col);
+    });
+    const id = columnsMap.get("id");
+    if (!id ||
+        !["uuid", "text"].includes(id.data_type) ||
+        id.is_nullable === "YES") {
+        throw new Error(`Column 'id' must be uuid/text and NOT NULL for table ${tableName}`);
+    }
+    const timestampType = ["timestamp with time zone", "timestamptz"];
+    const updatedAt = columnsMap.get("updated_at");
+    if (!updatedAt) {
+        throw new Error(`'updated_at' must be present on table ${tableName}
+      See docs ${SERVER_SIDE_DOCS_URL}
+      `);
+    }
+    if (!timestampType.includes(updatedAt.data_type)) {
+        logWarn(`'updated_at' must be of type "timestamptz" on table ${tableName}. Current type: ${updatedAt.data_type}. This can cause inconsistencies in the sync logic.`);
+    }
+    const createdAt = columnsMap.get("created_at");
+    if (!createdAt) {
+        throw new Error(`'created_at' must be present on table ${tableName}
+      See docs ${SERVER_SIDE_DOCS_URL}
+      `);
+    }
+    if (!timestampType.includes(createdAt.data_type)) {
+        logWarn(`'created_at' must be of type "timestamptz" on table ${tableName}. Current type: ${createdAt.data_type}. This can cause inconsistencies in the sync logic.`);
+    }
+    const deletedAt = columnsMap.get("deleted_at");
+    if (!deletedAt) {
+        throw new Error(`'deleted_at' must be present on table ${tableName}
+      See docs ${SERVER_SIDE_DOCS_URL}
+      `);
+    }
+    if (!timestampType.includes(deletedAt.data_type)) {
+        logWarn(`'deleted_at' must be of type "timestamptz" on table ${tableName}. Current type: ${deletedAt.data_type}. This can cause inconsistencies in the sync logic.`);
+    }
+    const cfg = getSupastashConfig();
+    if (cfg.replicationMode === "server-side") {
+        const arrivedAt = columnsMap.get("arrived_at");
+        if (!arrivedAt) {
+            throw new Error(`'arrived_at' must be present on table ${tableName}
+        See docs ${SERVER_SIDE_DOCS_URL}
+        `);
+        }
+        if (!timestampType.includes(arrivedAt.data_type)) {
+            logWarn(`'arrived_at' must be of type "timestamptz" on table ${tableName}. Current type: ${arrivedAt.data_type}. This can cause inconsistencies in the sync logic.`);
+        }
+    }
+}
+async function upsertRemoteSchema(table, schema) {
+    const payload = JSON.stringify(schema);
+    const db = await getSupastashDb();
+    await db.runAsync(`
+      INSERT INTO supastash_remote_table_schema (table_name, schema_json, updated_at)
+      VALUES (?, ?, datetime('now'))
+      ON CONFLICT(table_name)
+      DO UPDATE SET
+        schema_json = excluded.schema_json,
+        updated_at = excluded.updated_at;
+      `, [table, payload]);
+}
+async function getLocalSchema(table) {
+    const db = await getSupastashDb();
+    const row = await db.getFirstAsync(`
+      SELECT schema_json
+      FROM supastash_remote_table_schema
+      WHERE table_name = ?
+      `, [table]);
+    if (!row)
+        return null;
+    return JSON.parse(row.schema_json);
+}
+export function appendSyncedAt(schema) {
+    return [
+        ...schema,
+        {
+            column_name: "synced_at",
+            data_type: "text",
+            is_nullable: "YES",
+        },
+    ];
+}
+const localSchemaCache = new Map();
+export async function getRemoteTableSchema(table) {
+    const config = getSupastashConfig();
+    const supabase = config?.supabaseClient;
+    if (!supabase) {
+        throw new Error(`Supabase client not found`);
+    }
+    // 1. Memory cache
+    if (tableSchemaData.has(table)) {
+        return appendSyncedAt(tableSchemaData.get(table));
+    }
+    await ensureRemoteSchemaTableExists();
+    const online = await isOnline();
+    // 2. If offline → SQLite fallback
+    if (!online) {
+        if (localSchemaCache.has(table)) {
+            return appendSyncedAt(localSchemaCache.get(table));
+        }
+        const local = await getLocalSchema(table);
+        if (!local)
+            return null;
+        localSchemaCache.set(table, local);
+        return appendSyncedAt(local);
+    }
+    // 3. Remote fetch
+    const { data, error } = await supabase.rpc("get_table_schema", {
+        table_name: table,
+    });
+    if (error || !Array.isArray(data)) {
+        if (error && !isNetworkError(error)) {
+            log(`[Supastash] Error getting remote keys for table ${table} on public schema: ${error.message}
+      You can find more information in the Supastash docs: ${SERVER_SIDE_DOCS_URL}`);
+        }
+        return null;
+    }
+    validatePayloadForTable(data, table);
+    // 4. Persist
+    await upsertRemoteSchema(table, data);
+    tableSchemaData.set(table, data);
+    return appendSyncedAt(data);
+}

package/dist/shared/utils/sync/status/syncUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncUpdate.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/sync/status/syncUpdate.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,iBAczE"}

package/dist/shared/utils/tableValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableValidator.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/tableValidator.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU3E;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,iBAOxD"}

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "supastash",
-  "version": "0.1.62",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "version": "0.2.1",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "type": "module",
   "files": [
     "dist"
   ],
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "react-native": "./dist/native/index.js",
+      "browser": "./dist/desktop/index.js",
+      "node": "./dist/desktop/index.js",
+      "default": "./dist/desktop/index.js"
     }
   },
   "sideEffects": false,
@@ -22,14 +23,13 @@
     "test": "jest"
   },
   "devDependencies": {
+    "@tauri-apps/plugin-sql": "^2.4.0",
     "@testing-library/react-native": "^13.2.0",
     "@types/better-sqlite3": "^7.6.13",
     "@types/jest": "^29.5.14",
     "@types/node": "^22.15.21",
-    "@types/react-native-sqlite-storage": ">=6.0.0 <7.0.0",
+    "@types/react-native-sqlite-storage": "^6.0.5",
     "better-sqlite3": "^11.10.0",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.4.1",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.2",
     "vite": "^6.3.5",
@@ -38,6 +38,8 @@
   "peerDependencies": {
     "@react-native-community/netinfo": ">=9.0.0 <12.0.0",
     "@supabase/supabase-js": ">=2.0.0 <3.0.0",
+    "@tauri-apps/plugin-sql": ">=2.0.0 <3.0.0",
+    "expo-crypto": "^13.0.2",
     "expo-sqlite": ">=15.0.0 <16.0.0",
     "react": ">=18.0.0 <20.0.0",
     "react-native": ">=0.71.0 <0.82.0",
@@ -53,6 +55,18 @@
     },
     "react-native-sqlite-storage": {
       "optional": true
+    },
+    "@tauri-apps/plugin-sql": {
+      "optional": true
+    },
+    "@react-native-community/netinfo": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    },
+    "expo-crypto": {
+      "optional": true
     }
   },
   "repository": {
@@ -70,11 +84,14 @@
     "react-native",
     "sqlite",
     "offline-first",
-    "sync"
+    "sync",
+    "tauri",
+    "rust",
+    "database",
+    "database-bridge"
   ],
-  "description": "Offline-first sync engine for Supabase in React Native using SQLite",
+  "description": "Offline-first sync engine for Supabase, built for React Native and desktop JavaScript apps using SQLite.",
   "dependencies": {
-    "expo-crypto": "^13.0.2",
     "fast-deep-equal": "^3.1.3"
   }
 }

package/dist/constants/syncDefaults.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"syncDefaults.d.ts","sourceRoot":"","sources":["../../src/constants/syncDefaults.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAExC,eAAO,MAAM,cAAc,EAAE,mBAU5B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,gBAO5B,CAAC;AAEF,eAAO,MAAM,kBAAkB,MAAM,CAAC"}

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

@@ -1 +0,0 @@
-{"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"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/schemaManager/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAMxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,qBAAqB,EAC7B,oBAAoB,UAAQ,iBAyF7B"}

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

@@ -1,3 +0,0 @@
-import { SupastashSQLiteAdapter } from "../../types/supastashConfig.types";
-export declare const SQLiteAdapterExpo: SupastashSQLiteAdapter;
-//# sourceMappingURL=expo_sqlite.d.ts.map

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

@@ -1 +0,0 @@
-{"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"}

package/dist/db/adapters/expo_sqlite.js

@@ -1,24 +0,0 @@
-export const SQLiteAdapterExpo = {
-    async openDatabaseAsync(name, sqliteClient) {
-        const db = await sqliteClient.openDatabaseAsync(name);
-        return {
-            runAsync: async (sql, params) => {
-                await db.runAsync(sql, params ?? []);
-            },
-            execAsync: async (statement) => {
-                await db.execAsync(statement);
-            },
-            getAllAsync: async (sql, params) => {
-                const result = await db.getAllAsync(sql, params ?? []);
-                return result ?? [];
-            },
-            getFirstAsync: async (sql, params) => {
-                const result = await db.getFirstAsync(sql, params ?? []);
-                return result ?? null;
-            },
-            closeAsync: async () => {
-                await db.closeAsync?.();
-            },
-        };
-    },
-};

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

@@ -1,3 +0,0 @@
-import { SupastashSQLiteAdapter } from "../../types/supastashConfig.types";
-export declare const SQLiteAdapterNitro: SupastashSQLiteAdapter;
-//# sourceMappingURL=rn_nitro.d.ts.map

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

@@ -1 +0,0 @@
-{"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"}

package/dist/db/adapters/rn_nitro.js

@@ -1,34 +0,0 @@
-import { logWarn } from "../../utils/logs";
-export const SQLiteAdapterNitro = {
-    async openDatabaseAsync(name, sqliteClient) {
-        //Enable simple null handling for Nitro SQLite
-        const nitro = require("react-native-nitro-sqlite");
-        if (nitro?.enableSimpleNullHandling) {
-            nitro.enableSimpleNullHandling();
-        }
-        else {
-            logWarn("[Supastash] Simple null handling is not enabled for Nitro SQLite", "Please update your react-native-nitro-sqlite version to 9.1.3 or higher");
-        }
-        const db = await sqliteClient.open({ name, location: "default" });
-        return {
-            runAsync: async (sql, params) => {
-                await db.executeAsync(sql, params ?? []);
-            },
-            execAsync: async (statement) => {
-                await db.executeAsync(statement);
-            },
-            getAllAsync: async (sql, params) => {
-                const result = await db.executeAsync(sql, params ?? []);
-                const mainResult = result.rows?._array ?? [];
-                return mainResult;
-            },
-            getFirstAsync: async (sql, params) => {
-                const result = await db.executeAsync(sql, params ?? []);
-                return result.rows?._array?.[0] ?? null;
-            },
-            closeAsync: async () => {
-                await db.close?.();
-            },
-        };
-    },
-};

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

@@ -1,3 +0,0 @@
-import { SupastashSQLiteAdapter } from "../../types/supastashConfig.types";
-export declare const SQLiteAdapterStorage: SupastashSQLiteAdapter;
-//# sourceMappingURL=rn_sqlite_storage.d.ts.map

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

@@ -1 +0,0 @@
-{"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"}