supastash 0.1.61 → 0.2.0

package/dist/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/utils/sync/status/repo.d.ts

@@ -1,10 +1,10 @@
-import { RealtimeFilter } from "../../../types/realtimeData.types";
+import { SupastashFilter } from "../../../types/realtimeData.types";
 import { SupastashSQLiteDatabase } from "../../../types/supastashConfig.types";
 import { SupastashSyncStatus } from "../../../types/syncEngine.types";
 export declare function ensureSyncMarksTable(): Promise<void>;
 export declare function selectMarks(db: SupastashSQLiteDatabase, table: string, filterKey: string): Promise<SupastashSyncStatus | null>;
-export declare function selectSyncStatus(db: SupastashSQLiteDatabase, table: string, tableFilters?: RealtimeFilter[]): Promise<SupastashSyncStatus>;
-export declare function upsertMarks(db: SupastashSQLiteDatabase, row: Partial<SupastashSyncStatus>): Promise<void>;
-export declare function resetColumn(db: SupastashSQLiteDatabase, table: string, filterKey: string, col: "last_synced_at" | "last_created_at" | "last_deleted_at", value: string, filterJson: string): Promise<void>;
-export declare function deleteMarks(db: SupastashSQLiteDatabase, table: string, filterKey?: string): Promise<void>;
+export declare function selectSyncStatus(db: SupastashSQLiteDatabase, table: string, tableFilters?: SupastashFilter[]): Promise<SupastashSyncStatus>;
+export declare function upsertMarks(db: SupastashSQLiteDatabase, row: Partial<SupastashSyncStatus>): Promise<any>;
+export declare function resetColumn(db: SupastashSQLiteDatabase, table: string, filterKey: string, col: "last_synced_at" | "last_deleted_at", value: string, filterJson: string): Promise<any>;
+export declare function deleteMarks(db: SupastashSQLiteDatabase, table: string, filterKey?: string): Promise<any>;
 //# sourceMappingURL=repo.d.ts.map

package/dist/utils/sync/status/repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../../../src/utils/sync/status/repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAmCtE,wBAAsB,oBAAoB,kBAEzC;AAED,wBAAsB,WAAW,CAC/B,EAAE,EAAE,uBAAuB,EAC3B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,uCAMlB;AAED,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,uBAAuB,EAC3B,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,cAAc,EAAE,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAoB9B;AAED,wBAAsB,WAAW,CAC/B,EAAE,EAAE,uBAAuB,EAC3B,GAAG,EAAE,OAAO,CAAC,mBAAmB,CAAC,iBAgClC;AAED,wBAAsB,WAAW,CAC/B,EAAE,EAAE,uBAAuB,EAC3B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,EAC7D,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,iBAWnB;AAED,wBAAsB,WAAW,CAC/B,EAAE,EAAE,uBAAuB,EAC3B,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,iBAUnB"}
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../../../src/utils/sync/status/repo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAuDtE,wBAAsB,oBAAoB,kBAEzC;AAED,wBAAsB,WAAW,CAC/B,EAAE,EAAE,uBAAuB,EAC3B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,uCAOlB;AAED,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,uBAAuB,EAC3B,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,eAAe,EAAE,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAoB9B;AAED,wBAAsB,WAAW,CAC/B,EAAE,EAAE,uBAAuB,EAC3B,GAAG,EAAE,OAAO,CAAC,mBAAmB,CAAC,gBA8BlC;AAED,wBAAsB,WAAW,CAC/B,EAAE,EAAE,uBAAuB,EAC3B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,gBAAgB,GAAG,iBAAiB,EACzC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,gBAYnB;AAED,wBAAsB,WAAW,CAC/B,EAAE,EAAE,uBAAuB,EAC3B,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,gBASnB"}

package/dist/utils/sync/status/repo.js

@@ -1,33 +1,53 @@
+import { getSupastashConfig } from "../../../core/config";
 import { logWarn } from "../../logs";
 import { createSyncStatusTable } from "../../schema/createSyncStatus";
 import { computeFilterKey } from "./filterKey";
 const OLD_DATE = "2000-01-01T00:00:00Z";
-const cleanDate = (date, table) => {
+const SYNC_STATUS_TABLE = "supastash_sync_marks";
+const SERVER_SYNC_STATUS_TABLE = "supastash_server_sync_marks";
+const getSyncStatusTable = () => {
+    const cfg = getSupastashConfig();
+    return cfg.replicationMode === "server-side"
+        ? SERVER_SYNC_STATUS_TABLE
+        : SYNC_STATUS_TABLE;
+};
+const cleanDate = ({ date, table, column, }) => {
     const original = date || OLD_DATE;
     const d = new Date(original);
     if (Number.isNaN(d?.getTime?.())) {
-        logWarn(`[Supastash] Invalid date string found on deleted_at column for ${table}: ${original}`);
+        logWarn(`[Supastash] Invalid date string found on the ${column} column for ${table}: ${original}`);
         return original;
     }
     return original;
 };
 const cleanSyncStatus = (syncStatus) => {
+    const cfg = getSupastashConfig();
+    const lastSyncedAtColumn = cfg.replicationMode === "server-side" ? "arrived_at" : "updated_at";
     return {
         ...syncStatus,
-        last_created_at: cleanDate(syncStatus.last_created_at, syncStatus.table_name),
-        last_synced_at: cleanDate(syncStatus.last_synced_at, syncStatus.table_name),
-        last_deleted_at: cleanDate(syncStatus.last_deleted_at || OLD_DATE, syncStatus.table_name),
+        last_synced_at: cleanDate({
+            date: syncStatus.last_synced_at,
+            table: syncStatus.table_name,
+            column: lastSyncedAtColumn,
+        }),
+        last_deleted_at: cleanDate({
+            date: syncStatus.last_deleted_at || OLD_DATE,
+            table: syncStatus.table_name,
+            column: "deleted_at",
+        }),
     };
 };
 export async function ensureSyncMarksTable() {
     await createSyncStatusTable();
 }
 export async function selectMarks(db, table, filterKey) {
-    return db.getFirstAsync(`SELECT * FROM supastash_sync_marks WHERE table_name=? AND filter_key=?`, [table, filterKey]);
+    const syncStatusTable = getSyncStatusTable();
+    return db.getFirstAsync(`SELECT * FROM ${syncStatusTable} WHERE table_name=? AND filter_key=?`, [table, filterKey]);
 }
 export async function selectSyncStatus(db, table, tableFilters) {
     const filterKey = await computeFilterKey(tableFilters ?? []);
-    const result = await db.getFirstAsync(`SELECT * FROM supastash_sync_marks WHERE table_name=? AND filter_key=?`, [table, filterKey]);
+    const syncStatusTable = getSyncStatusTable();
+    const result = await db.getFirstAsync(`SELECT * FROM ${syncStatusTable} WHERE table_name=? AND filter_key=?`, [table, filterKey]);
     if (result) {
         return cleanSyncStatus(result);
     }
@@ -35,35 +55,34 @@ export async function selectSyncStatus(db, table, tableFilters) {
         table_name: table,
         filter_key: filterKey,
         filter_json: "{}",
-        last_created_at: OLD_DATE,
         last_synced_at: OLD_DATE,
         last_synced_at_pk: null,
         last_deleted_at: OLD_DATE,
     };
 }
 export async function upsertMarks(db, row) {
-    const { table_name, filter_key, filter_json = null, last_created_at = null, last_synced_at = null, last_deleted_at = null, last_synced_at_pk = null, } = row;
-    return db.runAsync(`INSERT INTO supastash_sync_marks
-       (table_name, filter_key, filter_json, last_created_at, last_synced_at, last_deleted_at, updated_at, last_synced_at_pk)
-       VALUES (?,?,?,?,?,?,datetime('now'),?)
+    const { table_name, filter_key, filter_json = null, last_synced_at = null, last_deleted_at = null, last_synced_at_pk = null, } = row;
+    const syncStatusTable = getSyncStatusTable();
+    return db.runAsync(`INSERT INTO ${syncStatusTable}
+       (table_name, filter_key, filter_json, last_synced_at, last_deleted_at, updated_at, last_synced_at_pk)
+       VALUES (?,?,?,?,?,datetime('now'),?)
        ON CONFLICT(table_name, filter_key) DO UPDATE SET
          filter_json     = excluded.filter_json,
-         last_created_at = COALESCE(excluded.last_created_at, supastash_sync_marks.last_created_at),
-         last_synced_at  = COALESCE(excluded.last_synced_at,  supastash_sync_marks.last_synced_at),
-         last_deleted_at = COALESCE(excluded.last_deleted_at, supastash_sync_marks.last_deleted_at),
+         last_synced_at  = COALESCE(excluded.last_synced_at,  ${syncStatusTable}.last_synced_at),
+         last_deleted_at = COALESCE(excluded.last_deleted_at, ${syncStatusTable}.last_deleted_at),
          updated_at      = datetime('now'),
-         last_synced_at_pk = COALESCE(excluded.last_synced_at_pk, supastash_sync_marks.last_synced_at_pk)`, [
+         last_synced_at_pk = COALESCE(excluded.last_synced_at_pk, ${syncStatusTable}.last_synced_at_pk)`, [
         table_name,
         filter_key,
         filter_json,
-        last_created_at,
         last_synced_at,
         last_deleted_at,
         last_synced_at_pk,
     ]);
 }
 export async function resetColumn(db, table, filterKey, col, value, filterJson) {
-    return db.runAsync(`INSERT INTO supastash_sync_marks (table_name, filter_key, filter_json, ${col}, updated_at)
+    const syncStatusTable = getSyncStatusTable();
+    return db.runAsync(`INSERT INTO ${syncStatusTable} (table_name, filter_key, filter_json, ${col}, updated_at)
        VALUES (?,?,?,?,datetime('now'))
        ON CONFLICT(table_name, filter_key) DO UPDATE SET
          filter_json = excluded.filter_json,
@@ -71,9 +90,8 @@ export async function resetColumn(db, table, filterKey, col, value, filterJson)
          updated_at  = datetime('now')`, [table, filterKey, filterJson, value]);
 }
 export async function deleteMarks(db, table, filterKey) {
+    const syncStatusTable = getSyncStatusTable();
     return filterKey
-        ? db.runAsync(`DELETE FROM supastash_sync_marks WHERE table_name=? AND filter_key=?`, [table, filterKey])
-        : db.runAsync(`DELETE FROM supastash_sync_marks WHERE table_name=?`, [
-            table,
-        ]);
+        ? db.runAsync(`DELETE FROM ${syncStatusTable} WHERE table_name=? AND filter_key=?`, [table, filterKey])
+        : db.runAsync(`DELETE FROM ${syncStatusTable} WHERE table_name=?`, [table]);
 }

package/dist/utils/sync/status/services.d.ts

@@ -1,4 +1,4 @@
-import { RealtimeFilter } from "../../../types/realtimeData.types";
+import { SupastashFilter } from "../../../types/realtimeData.types";
 import { PublicScope, SupastashSyncStatus } from "../../../types/syncEngine.types";
 /**
  * Gets the supastash sync status for a given table and filters
@@ -6,9 +6,8 @@ import { PublicScope, SupastashSyncStatus } from "../../../types/syncEngine.type
  * @param filters - The filters to apply to the sync status
  * @returns The supastash sync status
  */
-export declare function getSupastashSyncStatus(table: string, filters?: RealtimeFilter[]): Promise<SupastashSyncStatus | null>;
-export declare function setSupastashSyncStatus(table: string, filters: RealtimeFilter[] | undefined, opts: {
-    lastCreatedAt?: string | null;
+export declare function getSupastashSyncStatus(table: string, filters?: SupastashFilter[]): Promise<SupastashSyncStatus | null>;
+export declare function setSupastashSyncStatus(table: string, filters: SupastashFilter[] | undefined, opts: {
     lastSyncedAt?: string | null;
     lastDeletedAt?: string | null;
     lastSyncedAtPk?: string | null;
@@ -21,12 +20,12 @@ export declare function setSupastashSyncStatus(table: string, filters: RealtimeF
  * @param scope - The scope to reset the sync status for
  * @returns The supastash sync status
  */
-export declare function resetSupastashSyncStatus(table: string, filters: RealtimeFilter[] | undefined, scope?: PublicScope): Promise<void>;
+export declare function resetSupastashSyncStatus(table: string, filters: SupastashFilter[] | undefined, scope?: PublicScope): Promise<void>;
 /**
  * Clears the supastash sync status for a given table and filters
  * @param table - The name of the table to clear the sync status for
  * @param filters - The filters to apply to the sync status
  * @returns The supastash sync status
  */
-export declare function clearSupastashSyncStatus(table: string, filters?: RealtimeFilter[]): Promise<void>;
+export declare function clearSupastashSyncStatus(table: string, filters?: SupastashFilter[]): Promise<void>;
 //# sourceMappingURL=services.d.ts.map

package/dist/utils/sync/status/services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../../src/utils/sync/status/services.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EACL,WAAW,EACX,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAmBzC;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,EAAE,GACzB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAWrC;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EACrC,IAAI,EAAE;IACJ,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,iBA+CF;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EACrC,KAAK,GAAE,WAAmB,iBAoB3B;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,EAAE,iBAY3B"}
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../../src/utils/sync/status/services.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EACL,WAAW,EACX,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAmBzC;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,eAAe,EAAE,GAC1B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAWrC;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EAAE,GAAG,SAAS,EACtC,IAAI,EAAE;IACJ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,iBAyCF;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EAAE,GAAG,SAAS,EACtC,KAAK,GAAE,WAAmB,iBAmB3B;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,eAAe,EAAE,iBAY5B"}

package/dist/utils/sync/status/services.js

@@ -39,9 +39,6 @@ export async function setSupastashSyncStatus(table, filters, opts) {
         const fk = await computeFilterKey(filterToUse, ns);
         const filterJson = canonicalizeFilters(filterToUse);
         const existing = await selectMarks(db, table, fk);
-        const nextLastCreated = opts.lastCreatedAt !== undefined
-            ? maxIso(opts.lastCreatedAt, existing?.last_created_at ?? null)
-            : existing?.last_created_at ?? null;
         const nextLastSynced = opts.lastSyncedAt !== undefined
             ? maxIso(opts.lastSyncedAt, existing?.last_synced_at ?? null)
             : existing?.last_synced_at ?? null;
@@ -53,11 +50,10 @@ export async function setSupastashSyncStatus(table, filters, opts) {
             filter_key: fk,
             filter_json: filterJson,
             last_synced_at_pk: opts.lastSyncedAtPk ?? undefined,
-            last_created_at: nextLastCreated ?? undefined,
             last_synced_at: nextLastSynced ?? undefined,
             last_deleted_at: nextLastDeleted ?? undefined,
         });
-        if (!opts.lastCreatedAt && !opts.lastSyncedAt && !opts.lastDeletedAt) {
+        if (!opts.lastSyncedAt && !opts.lastDeletedAt) {
             logWarn(`[Supastash] setSupastashSyncStatus(${table}): no fields provided`);
         }
     }
@@ -81,7 +77,6 @@ export async function resetSupastashSyncStatus(table, filters, scope = "all") {
         const filterJson = canonicalizeFilters(filterToUse);
         if (scope === "all") {
             await resetColumn(db, table, fk, "last_synced_at", OLD_DATE, filterJson);
-            await resetColumn(db, table, fk, "last_created_at", OLD_DATE, filterJson);
             await resetColumn(db, table, fk, "last_deleted_at", OLD_DATE, filterJson);
         }
         else {

package/dist/utils/sync/status/syncStatus.d.ts

@@ -1,4 +1,4 @@
-import { RealtimeFilter } from "../../../types/realtimeData.types";
+import { SupastashFilter } from "../../../types/realtimeData.types";
 import { PublicScope, SupastashSyncStatus } from "../../../types/syncEngine.types";
 /**
  * Clears the sync log for a specific table.
@@ -32,7 +32,6 @@ export declare function clearAllLocalSyncLog(): Promise<void>;
  * return {
  *    table_name: "users",
  *    last_synced_at: "2021-01-01T00:00:00.000Z",
- *    last_created_at: "2021-01-01T00:00:00.000Z",
  *    last_deleted_at: "2021-01-01T00:00:00.000Z",
  *    filter_key: "1234567890",
  *    filter_json: "[...]",
@@ -55,8 +54,7 @@ export declare function getSyncLog(tableName: string): Promise<SupastashSyncStat
  *   lastSyncedAtPk: "00000000-0000-0000-0000-000000000000",
  * });
  */
-export declare function setSyncLog(table: string, filters: RealtimeFilter[] | undefined, opts: {
-    lastCreatedAt?: string | null;
+export declare function setSyncLog(table: string, filters: SupastashFilter[] | undefined, opts: {
     lastSyncedAt?: string | null;
     lastDeletedAt?: string | null;
     lastSyncedAtPk?: string | null;
@@ -68,11 +66,11 @@ export declare function setSyncLog(table: string, filters: RealtimeFilter[] | un
  * @param table - Table to reset.
  * @param filters - Optional filters for a scoped reset.
  * @param scope - Field(s) to reset: "all" (default),
- *   "last_synced_at", "last_created_at", or "last_deleted_at".
+ *   "last_synced_at", or "last_deleted_at".
  * @example
  * await resetSyncLog("users", undefined, "all");
  */
-export declare function resetSyncLog(table: string, filters: RealtimeFilter[] | undefined, scope?: PublicScope): Promise<void>;
+export declare function resetSyncLog(table: string, filters: SupastashFilter[] | undefined, scope?: PublicScope): Promise<void>;
 /**
  * Deletes the sync log entry for a table (and optional filter key).
  *
@@ -81,7 +79,7 @@ export declare function resetSyncLog(table: string, filters: RealtimeFilter[] |
  * @example
  * await clearSyncLog("users");
  */
-export declare function clearSyncLog(table: string, filters?: RealtimeFilter[]): Promise<void>;
+export declare function clearSyncLog(table: string, filters?: SupastashFilter[]): Promise<void>;
 /** ------------------- DEPRECATED 🗑 Local Sync & Delete Log ------------------- */
 /**
  * @deprecated Use `setSyncLog` instead.

package/dist/utils/sync/status/syncStatus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"syncStatus.d.ts","sourceRoot":"","sources":["../../../../src/utils/sync/status/syncStatus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EACL,WAAW,EACX,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAYzC;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,iBAExD;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,kBAIzC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CASrC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EACrC,IAAI,EAAE;IACJ,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,iBAOF;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EACrC,KAAK,GAAE,WAAmB,iBAO3B;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,iBAM3E;AAED,oFAAoF;AAEpF;;;GAGG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,MAAM,iBAGvB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,iBAE1D;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,kBAE3C;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,iBAExD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,iBAGtB"}
+{"version":3,"file":"syncStatus.d.ts","sourceRoot":"","sources":["../../../../src/utils/sync/status/syncStatus.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EACL,WAAW,EACX,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAkBzC;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,iBAExD;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,kBAKzC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CASrC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EAAE,GAAG,SAAS,EACtC,IAAI,EAAE;IACJ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,iBAOF;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EAAE,GAAG,SAAS,EACtC,KAAK,GAAE,WAAmB,iBAO3B;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,iBAM5E;AAED,oFAAoF;AAEpF;;;GAGG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,MAAM,iBAGvB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,iBAE1D;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,kBAE3C;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,iBAExD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,iBAGtB"}

package/dist/utils/sync/status/syncStatus.js

@@ -1,8 +1,16 @@
+import { getSupastashConfig } from "../../../core/config";
 import { getSupastashDb } from "../../../db/dbInitializer";
 import { logError } from "../../logs";
 import { createSyncStatusTable } from "../../schema/createSyncStatus";
 import { clearSupastashSyncStatus, getSupastashSyncStatus, resetSupastashSyncStatus, setSupastashSyncStatus, } from "./services";
 const SYNC_STATUS_TABLE = "supastash_sync_marks";
+const SERVER_SYNC_STATUS_TABLE = "supastash_server_sync_marks";
+const getSyncStatusTable = () => {
+    const cfg = getSupastashConfig();
+    return cfg.replicationMode === "server-side"
+        ? SERVER_SYNC_STATUS_TABLE
+        : SYNC_STATUS_TABLE;
+};
 /**
  * Clears the sync log for a specific table.
  *
@@ -27,7 +35,8 @@ export async function clearLocalSyncLog(tableName) {
  */
 export async function clearAllLocalSyncLog() {
     const db = await getSupastashDb();
-    await db.runAsync(`DROP TABLE IF EXISTS ${SYNC_STATUS_TABLE}`);
+    const syncStatusTable = getSyncStatusTable();
+    await db.runAsync(`DROP TABLE IF EXISTS ${syncStatusTable}`);
     await createSyncStatusTable();
 }
 /**
@@ -41,7 +50,6 @@ export async function clearAllLocalSyncLog() {
  * return {
  *    table_name: "users",
  *    last_synced_at: "2021-01-01T00:00:00.000Z",
- *    last_created_at: "2021-01-01T00:00:00.000Z",
  *    last_deleted_at: "2021-01-01T00:00:00.000Z",
  *    filter_key: "1234567890",
  *    filter_json: "[...]",
@@ -87,7 +95,7 @@ export async function setSyncLog(table, filters, opts) {
  * @param table - Table to reset.
  * @param filters - Optional filters for a scoped reset.
  * @param scope - Field(s) to reset: "all" (default),
- *   "last_synced_at", "last_created_at", or "last_deleted_at".
+ *   "last_synced_at", or "last_deleted_at".
  * @example
  * await resetSyncLog("users", undefined, "all");
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supastash",
-  "version": "0.1.61",
+  "version": "0.2.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
@@ -26,7 +26,7 @@
     "@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",

package/dist/types/supastashFilters.types.d.ts

@@ -1,3 +0,0 @@
-import { RealtimeFilter } from "./realtimeData.types";
-
-type SupastashFilter = Record<string, RealtimeFilter[]>;