supastash 0.1.52 → 0.1.54

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

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

@@ -15,6 +15,7 @@ let _config = {
         useFiltersFromStore: true,
     },
     listeners: 250,
+    supabaseBatchSize: 100,
     debugMode: true,
     syncPolicy: DEFAULT_POLICY,
     fieldEnforcement: DEFAULT_FIELDS,

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

@@ -13,8 +13,23 @@ export type SupastashSQLiteClientTypes =
 export type SupastashMode = "live" | "ghost";
 
 export type SupastashConfig<T extends SupastashSQLiteClientTypes> = {
+  // --------------------------------------------------
+  // Core Database & Client Configuration
+  // --------------------------------------------------
+
+  /**
+   * Name of the local SQLite database.
+   */
   dbName: string;
+
+  /**
+   * Supabase client instance.
+   */
   supabaseClient: SupabaseClient<any, "public", any> | null;
+
+  /**
+   * SQLite client adapter.
+   */
   sqliteClient: T extends "expo"
     ? ExpoSQLiteClient
     : T extends "rn-storage"
@@ -22,23 +37,111 @@ export type SupastashConfig<T extends SupastashSQLiteClientTypes> = {
     : T extends "rn-nitro"
     ? RNSqliteNitroClient
     : null;
+
+  /**
+   * Type of SQLite client.
+   */
   sqliteClientType: T;
-  excludeTables?: { pull?: string[]; push?: string[] };
+
+  // --------------------------------------------------
+  // Supabase Write Batching
+  // --------------------------------------------------
+
+  /**
+   * Maximum number of rows sent per Supabase write request.
+   * Large payloads are automatically split into sequential batches.
+   * Default: 100.
+   */
+  supabaseBatchSize?: number;
+
+  // --------------------------------------------------
+  // Table Inclusion / Exclusion Rules
+  // --------------------------------------------------
+
+  /**
+   * Control which tables are included in pull and push sync operations.
+   */
+  excludeTables?: {
+    pull?: string[];
+    push?: string[];
+  };
+
+  // --------------------------------------------------
+  // Sync Polling Intervals
+  // --------------------------------------------------
+
+  /**
+   * Background sync polling intervals (in milliseconds).
+   */
   pollingInterval?: {
     pull?: number;
     push?: number;
   };
+
+  // --------------------------------------------------
+  // Sync Engine Toggles & Behavior
+  // --------------------------------------------------
+
+  /**
+   * High-level switches controlling sync behavior.
+   */
   syncEngine?: {
     push?: boolean;
     pull?: boolean;
     useFiltersFromStore?: boolean;
   };
+
+  // --------------------------------------------------
+  // Supabase Realtime Configuration
+  // --------------------------------------------------
+
+  /**
+   * Maximum number of active event listeners.
+   */
   listeners?: number;
+
+  // --------------------------------------------------
+  // Schema Initialization Hook
+  // --------------------------------------------------
+
+  /**
+   * Called once after local database initialization.
+   * Intended for defineLocalSchema calls.
+   */
   onSchemaInit?: () => Promise<void>;
+
+  // --------------------------------------------------
+  // Debugging & Diagnostics
+  // --------------------------------------------------
+
+  /**
+   * Enables verbose logging for sync and database operations.
+   */
   debugMode?: boolean;
 
+  // --------------------------------------------------
+  // Conflict Resolution & Retry Policy
+  // --------------------------------------------------
+
+  /**
+   * Defines how Supastash classifies and handles sync conflicts.
+   */
   syncPolicy?: SupastashSyncPolicy;
+
+  // --------------------------------------------------
+  // Field Validation & Auto-Fill Enforcement
+  // --------------------------------------------------
+
   fieldEnforcement?: FieldEnforcement;
+
+  // --------------------------------------------------
+  // Conflict Cleanup Behavior
+  // --------------------------------------------------
+
+  /**
+   * When true, local rows involved in non-retryable conflicts
+   * will be deleted instead of retained.
+   */
   deleteConflictedRows?: boolean;
   /**
    * The path to the RPC function to use for upserts.

package/dist/utils/query/helpers/queueRemote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queueRemote.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/helpers/queueRemote.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EACX,cAAc,EACf,MAAM,4BAA4B,CAAC;AA0CpC,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,OAAO,EAAE,CAAC,EACzE,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC,CAYlB"}
+{"version":3,"file":"queueRemote.d.ts","sourceRoot":"","sources":["../../../../src/utils/query/helpers/queueRemote.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,WAAW,EACX,cAAc,EACf,MAAM,4BAA4B,CAAC;AA0CpC,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,OAAO,EAAE,CAAC,EACzE,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC,CAYlB"}

package/dist/utils/query/helpers/queueRemote.js

@@ -1,3 +1,4 @@
+import { getSupastashConfig } from "../../../core/config";
 import { isOnline } from "../../../utils/connection";
 import { log, logWarn } from "../../../utils/logs";
 import { getQueryStatusFromDb } from "../../../utils/sync/queryStatus";
@@ -44,6 +45,25 @@ function scheduleBatch() {
         batchTimer = null;
     }, BATCH_DELAY);
 }
+async function executeSupabaseCall(state) {
+    const config = getSupastashConfig();
+    const payload = state.payload;
+    if (!Array.isArray(payload)) {
+        return querySupabase(state, true);
+    }
+    const batchSize = config.supabaseBatchSize ?? 100;
+    for (let i = 0; i < payload.length; i += batchSize) {
+        const chunk = payload.slice(i, i + batchSize);
+        const result = await querySupabase({
+            ...state,
+            payload: chunk,
+        }, true);
+        if (result.error) {
+            return result;
+        }
+    }
+    return { error: null };
+}
 async function processBatch() {
     if (isProcessing || batchQueue.length === 0)
         return;
@@ -76,7 +96,7 @@ async function processBatch() {
                     continue;
                 }
                 calledOfflineRetries.delete(opKey);
-                const { error } = await querySupabase({ ...state }, true);
+                const { error } = await executeSupabaseCall(state);
                 if (!error) {
                     successfulCalls.add(opKey);
                     retryCount.delete(opKey);

package/dist/utils/sync/pullFromRemote/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/utils/sync/pullFromRemote/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAqBnE,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,KAAK,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,kBAiDA;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,WAAW,EAAE,EACnB,GAAG,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAC9C,MAAM,GAAG,IAAI,CAUf;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,QAczC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/utils/sync/pullFromRemote/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAqBnE,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,KAAK,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,kBA2CA;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,WAAW,EAAE,EACnB,GAAG,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAC9C,MAAM,GAAG,IAAI,CAUf;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,QAczC"}

package/dist/utils/sync/pullFromRemote/helpers.js

@@ -28,10 +28,15 @@ export async function pageThrough(base) {
         let q = supabase
             .from(table)
             .select(select)
-            .gte(base.tsCol, cursorTs)
             .order(base.tsCol, { ascending: true })
             .order("id", { ascending: true })
             .limit(PAGE_SIZE);
+        if (cursorId) {
+            q = q.or(`${base.tsCol}.gt.${cursorTs},and(${base.tsCol}.eq.${cursorTs},id.gt.${cursorId})`);
+        }
+        else {
+            q = q.gte(base.tsCol, cursorTs);
+        }
         if (!base.includeDeleted)
             q = q.is("deleted_at", null);
         if (filters) {
@@ -42,12 +47,7 @@ export async function pageThrough(base) {
             throw error;
         if (!data || data.length === 0)
             break;
-        const page = results.length === 0
-            ? data.filter((r) => !(r[base.tsCol] === cursorTs &&
-                typeof r.id === "string" &&
-                r.id === cursorId))
-            : data;
-        results.push(...page);
+        results.push(...data);
         if (data.length < PAGE_SIZE)
             break;
         const last = data[data.length - 1];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supastash",
-  "version": "0.1.52",
+  "version": "0.1.54",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",