supastash 0.2.9 → 0.2.11

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

@@ -0,0 +1,50 @@
+/**
+ * Converts a single PostgREST Filter to an RpcFilterNode.
+ * Used so that tableFilters registered via useSupastashFilters are
+ * automatically applied in the batch pull RPC path.
+ */
+function convertFilter(f) {
+    const col = String(f.column);
+    if (f.operator === "is") {
+        return f.value === null
+            ? { col, op: "is_null" }
+            : { col, op: "is_not_null" };
+    }
+    // For "in", the SQL compiler expects a comma-separated string
+    if (f.operator === "in") {
+        const val = Array.isArray(f.value)
+            ? f.value.join(",")
+            : String(f.value ?? "");
+        return { col, op: "in", val };
+    }
+    return {
+        col,
+        op: f.operator,
+        val: f.value,
+    };
+}
+/**
+ * Converts PostgREST-style SupastashFilter[] to RpcFilterNode[].
+ * Supports simple filters and { or: [...] } groups.
+ * Returns an empty array for an empty/undefined input.
+ */
+export function postgrestFiltersToRpc(filters) {
+    if (!filters?.length)
+        return [];
+    const result = [];
+    for (const f of filters) {
+        if ("or" in f) {
+            const nodes = f.or
+                .map(convertFilter)
+                .filter((n) => n !== null);
+            if (nodes.length)
+                result.push({ or: nodes });
+        }
+        else {
+            const node = convertFilter(f);
+            if (node)
+                result.push(node);
+        }
+    }
+    return result;
+}

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

@@ -1,10 +1,13 @@
 import { SupastashFilter } from "../../../types/realtimeData.types";
+import { RpcTableFilters } from "../../../types/rpcFilter.types";
 /**
- * Updates the filter for the given table
- * Non-hook version of useSupastashFilters
+ * Updates the filter for the given table.
+ * Non-hook version of useSupastashFilters.
  *
- * Filters are validated and stored in the tableFilters store
- * @param filters - The filters to update
+ * @param filters - PostgREST filters for the standard pull path. Automatically converted
+ *   and applied in the batch RPC pull path too.
+ * @param rpcFilters - Optional supplemental RPC filter nodes. Only needed for `and` groups
+ *   or other constructs SupastashFilter can't express.
  */
-export declare function updateFilters(filters: SupastashFilter): Promise<void>;
+export declare function updateFilters(filters: SupastashFilter, rpcFilters?: RpcTableFilters): Promise<void>;
 //# sourceMappingURL=updateFilter.d.ts.map

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

@@ -1 +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"}
+{"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;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAOjE;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,eAAe,EACxB,UAAU,CAAC,EAAE,eAAe,iBA6C7B"}

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

@@ -2,15 +2,21 @@ import { filterTracker, tableFilters, tableFiltersUsed, } from "../../../store/t
 import { logWarn } from "../../logs";
 import { ReusedHelpers } from "../../reusedHelpers";
 import { checkIfTableExist } from "../../tableValidator";
+import { updateRpcFilters } from "./updateRpcFilters";
 import { warnOnMisMatch } from "./validateFilters";
 /**
- * Updates the filter for the given table
- * Non-hook version of useSupastashFilters
+ * Updates the filter for the given table.
+ * Non-hook version of useSupastashFilters.
  *
- * Filters are validated and stored in the tableFilters store
- * @param filters - The filters to update
+ * @param filters - PostgREST filters for the standard pull path. Automatically converted
+ *   and applied in the batch RPC pull path too.
+ * @param rpcFilters - Optional supplemental RPC filter nodes. Only needed for `and` groups
+ *   or other constructs SupastashFilter can't express.
  */
-export async function updateFilters(filters) {
+export async function updateFilters(filters, rpcFilters) {
+    if (rpcFilters) {
+        await updateRpcFilters(rpcFilters);
+    }
     const incoming = Object.keys(filters ?? {});
     // Remove stale tables
     for (const t of Array.from(tableFilters.keys())) {

package/dist/shared/utils/sync/pullFromRemote/updateRpcFilters.d.ts

@@ -0,0 +1,12 @@
+import { RpcTableFilters } from "../../../types/rpcFilter.types";
+/**
+ * Registers explicit RPC filter nodes for the batch pull path (useBatchPullSync: true).
+ *
+ * Only needed for constructs SupastashFilter can't express (e.g. `and` groups).
+ * Filters registered via useSupastashFilters / updateFilters are automatically
+ * converted and applied in the batch path — no separate call needed for those.
+ *
+ * Called automatically by useSupastashFilters / updateFilters.
+ */
+export declare function updateRpcFilters(filters?: RpcTableFilters): Promise<void>;
+//# sourceMappingURL=updateRpcFilters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"updateRpcFilters.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/sync/pullFromRemote/updateRpcFilters.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAIhF;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B/E"}

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

@@ -0,0 +1,36 @@
+import { rpcTableFilters } from "../../../store/rpcTableFilters";
+import { logWarn } from "../../logs";
+import { checkIfTableExist } from "../../tableValidator";
+/**
+ * Registers explicit RPC filter nodes for the batch pull path (useBatchPullSync: true).
+ *
+ * Only needed for constructs SupastashFilter can't express (e.g. `and` groups).
+ * Filters registered via useSupastashFilters / updateFilters are automatically
+ * converted and applied in the batch path — no separate call needed for those.
+ *
+ * Called automatically by useSupastashFilters / updateFilters.
+ */
+export async function updateRpcFilters(filters) {
+    const incoming = Object.keys(filters ?? {});
+    // Remove stale tables no longer in the incoming set
+    for (const t of Array.from(rpcTableFilters.keys())) {
+        if (!incoming.includes(t)) {
+            rpcTableFilters.delete(t);
+        }
+    }
+    if (!incoming.length)
+        return;
+    const existence = await Promise.all(incoming.map(async (t) => [t, await checkIfTableExist(t)]));
+    for (const [table, exists] of existence) {
+        if (!exists) {
+            logWarn(`[Supastash] Table '${table}' does not exist; skipping RPC filters`);
+            continue;
+        }
+        const nodes = (filters[table] ?? []);
+        if (!nodes.length) {
+            rpcTableFilters.delete(table);
+            continue;
+        }
+        rpcTableFilters.set(table, nodes.map((n) => ({ ...n })));
+    }
+}

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

@@ -1,4 +1,16 @@
 import { TableSchema } from "../../../types/realtimeData.types";
 export declare function appendSyncedAt(schema: TableSchema[]): TableSchema[];
+/**
+ * Fetches column metadata for all supplied tables in a single RPC call
+ * and warms both the in-memory cache and the SQLite fallback store.
+ *
+ * Requires `useBatchSchemaFetch: true` in config and the
+ * `get_table_schemas` Postgres function to be deployed.
+ *
+ * Tables already in the memory cache are skipped.
+ * Validation errors for individual tables are logged and skipped —
+ * they will surface as normal errors when that table is first used.
+ */
+export declare function prefetchRemoteTableSchemas(tables: string[]): Promise<void>;
 export declare function getRemoteTableSchema(table: string): Promise<TableSchema[] | null>;
 //# sourceMappingURL=remoteSchema.d.ts.map

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

@@ -1 +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"}
+{"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;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,CAkD/B"}

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

@@ -98,6 +98,52 @@ export function appendSyncedAt(schema) {
     ];
 }
 const localSchemaCache = new Map();
+/**
+ * Fetches column metadata for all supplied tables in a single RPC call
+ * and warms both the in-memory cache and the SQLite fallback store.
+ *
+ * Requires `useBatchSchemaFetch: true` in config and the
+ * `get_table_schemas` Postgres function to be deployed.
+ *
+ * Tables already in the memory cache are skipped.
+ * Validation errors for individual tables are logged and skipped —
+ * they will surface as normal errors when that table is first used.
+ */
+export async function prefetchRemoteTableSchemas(tables) {
+    const config = getSupastashConfig();
+    const supabase = config?.supabaseClient;
+    if (!supabase)
+        return;
+    const online = await isOnline();
+    if (!online)
+        return;
+    const toFetch = tables.filter((t) => !tableSchemaData.has(t));
+    if (!toFetch.length)
+        return;
+    const { data, error } = await supabase.rpc("get_table_schemas", {
+        p_tables: toFetch,
+    });
+    if (error || !data) {
+        if (error && !isNetworkError(error)) {
+            log(`[Supastash] Error batch-fetching table schemas: ${error.message}
+      You can find more information in the Supastash docs: ${SERVER_SIDE_DOCS_URL}`);
+        }
+        return;
+    }
+    await ensureRemoteSchemaTableExists();
+    for (const [table, schema] of Object.entries(data)) {
+        if (!Array.isArray(schema))
+            continue;
+        try {
+            validatePayloadForTable(schema, table);
+            await upsertRemoteSchema(table, schema);
+            tableSchemaData.set(table, schema);
+        }
+        catch (e) {
+            logWarn(`[Supastash] Schema validation failed for "${table}" during batch fetch: ${e?.message}`);
+        }
+    }
+}
 export async function getRemoteTableSchema(table) {
     const config = getSupastashConfig();
     const supabase = config?.supabaseClient;

package/package.json

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