@legendapp/state 3.0.0-beta.2 → 3.0.0-beta.20

package/sync-plugins/keel.d.ts

@@ -1,5 +1,5 @@
-import { SyncedGetSetSubscribeBaseParams, OnErrorRetryParams, SyncedSetParams } from '@legendapp/state/sync';
-import { SyncedCrudPropsBase, SyncedCrudReturnType, CrudAsOption, SyncedCrudPropsSingle, CrudResult, SyncedCrudPropsMany } from '@legendapp/state/sync-plugins/crud';
+import { SyncedGetSetSubscribeBaseParams } from '@legendapp/state/sync';
+import { CrudErrorParams, SyncedCrudPropsBase, SyncedCrudReturnType, CrudAsOption, SyncedCrudPropsSingle, CrudResult, SyncedCrudPropsMany } from '@legendapp/state/sync-plugins/crud';
 
 interface KeelObjectBase {
     id: string;
@@ -13,6 +13,7 @@ type APIError = {
     type: string;
     message: string;
     requestId?: string;
+    error?: unknown;
 };
 type APIResult<T> = Result<T, APIError>;
 type Data<T> = {
@@ -24,7 +25,6 @@ type Err<U> = {
     error: U;
 };
 type Result<T, U> = NonNullable<Data<T> | Err<U>>;
-declare function generateKeelId(): string;
 interface KeelGetParams {
 }
 interface KeelListParams<Where = {}> {
@@ -62,7 +62,7 @@ interface SyncedKeelPropsManyWhere<TRemote extends {
 }, TLocal, AOption extends CrudAsOption, Where extends Record<string, any>> extends SyncedKeelPropsManyBase<TRemote, TLocal, AOption> {
     list?: (params: KeelListParams<NoInfer<Where>>) => Promise<CrudResult<APIResult<{
         results: TRemote[];
-        pageInfo: any;
+        pageInfo?: any;
     }>>>;
     where?: Where | (() => Where);
 }
@@ -71,7 +71,7 @@ interface SyncedKeelPropsManyNoWhere<TRemote extends {
 }, TLocal, AOption extends CrudAsOption> extends SyncedKeelPropsManyBase<TRemote, TLocal, AOption> {
     list?: (params: KeelListParams<{}>) => Promise<CrudResult<APIResult<{
         results: TRemote[];
-        pageInfo: any;
+        pageInfo?: any;
     }>>>;
     where?: never | {};
 }
@@ -88,12 +88,8 @@ interface SyncedKeelPropsSingle<TRemote extends {
     list?: never;
     as?: never;
 }
-interface ErrorDetails {
-    type: 'create' | 'update' | 'delete';
-    params: SyncedSetParams<any>;
-    input: any;
+interface KeelErrorParams extends CrudErrorParams {
     action: string;
-    error: APIResult<any>['error'];
 }
 interface SyncedKeelPropsBase<TRemote extends {
     id: string;
@@ -102,7 +98,7 @@ interface SyncedKeelPropsBase<TRemote extends {
     create?: (i: NoInfer<Partial<TRemote>>) => Promise<APIResult<NoInfer<TRemote>>>;
     update?: (params: {
         where: any;
-        values?: Partial<TRemote>;
+        values?: Partial<NoInfer<TRemote>>;
     }) => Promise<APIResult<TRemote>>;
     delete?: (params: {
         id: string;
@@ -113,7 +109,7 @@ interface SyncedKeelPropsBase<TRemote extends {
     };
     refreshAuth?: () => void | Promise<void>;
     requireAuth?: boolean;
-    onError?: (error: Error, retryParams: OnErrorRetryParams, details: ErrorDetails) => void;
+    onError?: (error: Error, params: KeelErrorParams) => void;
 }
 declare function syncedKeel<TRemote extends {
     id: string;
@@ -122,4 +118,4 @@ declare function syncedKeel<TRemote extends {
     id: string;
 }, TLocal = TRemote, TOption extends CrudAsOption = 'object', Where extends Record<string, any> = {}>(props: SyncedKeelPropsBase<TRemote, TLocal> & SyncedKeelPropsMany<TRemote, TLocal, TOption, Where>): SyncedCrudReturnType<TLocal, Exclude<TOption, 'value'>>;
 
-export { type KeelClient, type KeelGetParams, type KeelKey, KeelKeys, type KeelListParams, type KeelObjectBase, type KeelRealtimePlugin, type OmitKeelBuiltins, type SyncedKeelPropsBase, generateKeelId, syncedKeel };
+export { type KeelClient, type KeelErrorParams, type KeelGetParams, type KeelKey, KeelKeys, type KeelListParams, type KeelObjectBase, type KeelRealtimePlugin, type OmitKeelBuiltins, type SyncedKeelPropsBase, syncedKeel };

package/sync-plugins/keel.js

@@ -1,18 +1,11 @@
 'use strict';
 
 var state = require('@legendapp/state');
+var sync = require('@legendapp/state/sync');
 var crud = require('@legendapp/state/sync-plugins/crud');
-var ksuid = require('ksuid');
-
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
-
-var ksuid__default = /*#__PURE__*/_interopDefault(ksuid);
 
 // src/sync-plugins/keel.ts
 var KeelKeys = ["createdAt", "updatedAt"];
-function generateKeelId() {
-  return ksuid__default.default.randomSync().string;
-}
 var modifiedClients = /* @__PURE__ */ new WeakSet();
 var isAuthed$ = state.observable(false);
 var isAuthing$ = state.observable(false);
@@ -52,12 +45,17 @@ async function ensureAuthToken(props, force) {
   }
   return isAuthed;
 }
-async function handleApiError(props, error, retry) {
+async function handleApiError(props, error) {
+  var _a;
   if (error.type === "unauthorized" || error.type === "forbidden") {
     console.warn("Keel token expired, refreshing...");
     isAuthed$.set(false);
     await ensureAuthToken(props);
+    return true;
+  } else if (((_a = error.error) == null ? void 0 : _a.message) === "Failed to fetch") {
+    throw error.error;
   }
+  return false;
 }
 function convertObjectToCreate(item) {
   const cloned = {};
@@ -97,7 +95,7 @@ function setupRealtime(props) {
   }
 }
 var NumPerPage = 200;
-async function getAllPages(props, listFn, params) {
+async function getAllPages(props, listFn, params, listParams, onError) {
   const allData = [];
   let pageInfo = void 0;
   const { first: firstParam } = params;
@@ -113,8 +111,17 @@ async function getAllPages(props, listFn, params) {
     if (ret) {
       const { data, error } = ret;
       if (error) {
-        await handleApiError(props, error);
-        throw new Error(error.message);
+        const handled = await handleApiError(props, error);
+        if (!handled) {
+          const err = new Error(error.message, { cause: { error } });
+          onError(err, {
+            getParams: listParams,
+            type: "get",
+            source: "list",
+            action: listFn.name || listFn.toString(),
+            retry: listParams
+          });
+        }
       } else if (data) {
         pageInfo = data.pageInfo;
         allData.push(...data.results);
@@ -138,7 +145,6 @@ function syncedKeel(props) {
     fieldDeleted,
     realtime,
     mode,
-    onError,
     requireAuth = true,
     ...rest
   } = props;
@@ -158,7 +164,7 @@ function syncedKeel(props) {
     }
   } : void 0;
   const list = listParam ? async (listParams) => {
-    const { lastSync } = listParams;
+    const { lastSync, onError } = listParams;
     const queryBySync = !!lastSync && changesSince === "last-sync";
     const where = Object.assign(
       queryBySync ? { updatedAt: { after: new Date(lastSync + 1) } } : {},
@@ -166,14 +172,14 @@ function syncedKeel(props) {
     );
     const params = { where, first };
     realtimeState.current = {};
-    const promise = getAllPages(props, listParam, params);
+    const promise = getAllPages(props, listParam, params, listParams, onError);
     if (realtime) {
       setupSubscribe(listParams);
     }
     return promise;
   } : void 0;
   const get = getParam ? async (getParams) => {
-    const { refresh } = getParams;
+    const { refresh, onError } = getParams;
     realtimeState.current = {};
     const promise = getParam({ refresh });
     if (realtime) {
@@ -181,7 +187,17 @@ function syncedKeel(props) {
     }
     const { data, error } = await promise;
     if (error) {
-      throw new Error(error.message);
+      const handled = await handleApiError(props, error);
+      if (!handled) {
+        const err = new Error(error.message, { cause: { error } });
+        onError(err, {
+          getParams,
+          type: "get",
+          source: "get",
+          action: getParam.name || getParam.toString(),
+          retry: getParams
+        });
+      }
     } else {
       return data;
     }
@@ -198,7 +214,7 @@ function syncedKeel(props) {
   };
   const handleSetError = async (error, params, input, fn, from) => {
     var _a, _b;
-    const { retryNum, update: update2 } = params;
+    const { update: update2, onError } = params;
     if (from === "create" && ((_a = error.message) == null ? void 0 : _a.includes("for the unique")) && ((_b = error.message) == null ? void 0 : _b.includes("must be unique"))) {
       if (__DEV__) {
         console.log("Creating duplicate data already saved, just ignore.");
@@ -208,28 +224,25 @@ function syncedKeel(props) {
         value: {},
         mode: "assign"
       });
-    } else if (from === "delete") {
-      if (error.message === "record not found") {
-        if (__DEV__) {
-          console.log("Deleting non-existing data, just ignore.");
-        }
-        params.cancelRetry = true;
-      }
-    } else if (error.type === "bad_request") {
-      onError == null ? void 0 : onError(new Error(error.message), params, {
-        error,
-        params,
-        input,
-        type: from,
-        action: fn.name || fn.toString()
-      });
-      if (retryNum > 4) {
-        params.cancelRetry = true;
+    } else if (from === "delete" && error.message === "record not found") {
+      if (__DEV__) {
+        console.log("Deleting non-existing data, just ignore.");
       }
-      throw new Error(error.message, { cause: { input } });
+      params.cancelRetry = true;
     } else {
-      await handleApiError(props, error);
-      throw new Error(error.message, { cause: { input } });
+      const handled = await handleApiError(props, error);
+      if (!handled) {
+        const err = new Error(error.message, { cause: { error } });
+        onError(err, {
+          setParams: params,
+          input,
+          type: "set",
+          source: from,
+          action: fn.name || fn.toString(),
+          retry: params,
+          revert: sync.createRevertChanges(params.value$, params.changes)
+        });
+      }
     }
   };
   const create = createParam ? async (input, params) => {
@@ -274,6 +287,7 @@ function syncedKeel(props) {
   } : subscribeParam;
   return crud.syncedCrud({
     ...rest,
+    // Workaround for type errors
     as: asType,
     mode: mode || "merge",
     list,
@@ -298,12 +312,9 @@ function syncedKeel(props) {
     changesSince,
     updatePartial: true,
     subscribe,
-    generateId: generateKeelId,
-    // @ts-expect-error This errors because of the get/list union type
     get
   });
 }
 
 exports.KeelKeys = KeelKeys;
-exports.generateKeelId = generateKeelId;
 exports.syncedKeel = syncedKeel;

package/sync-plugins/keel.mjs

@@ -1,12 +1,9 @@
 import { observable, isFunction, when, batch, isEmpty } from '@legendapp/state';
+import { createRevertChanges } from '@legendapp/state/sync';
 import { syncedCrud } from '@legendapp/state/sync-plugins/crud';
-import ksuid from 'ksuid';
 
 // src/sync-plugins/keel.ts
 var KeelKeys = ["createdAt", "updatedAt"];
-function generateKeelId() {
-  return ksuid.randomSync().string;
-}
 var modifiedClients = /* @__PURE__ */ new WeakSet();
 var isAuthed$ = observable(false);
 var isAuthing$ = observable(false);
@@ -46,12 +43,17 @@ async function ensureAuthToken(props, force) {
   }
   return isAuthed;
 }
-async function handleApiError(props, error, retry) {
+async function handleApiError(props, error) {
+  var _a;
   if (error.type === "unauthorized" || error.type === "forbidden") {
     console.warn("Keel token expired, refreshing...");
     isAuthed$.set(false);
     await ensureAuthToken(props);
+    return true;
+  } else if (((_a = error.error) == null ? void 0 : _a.message) === "Failed to fetch") {
+    throw error.error;
   }
+  return false;
 }
 function convertObjectToCreate(item) {
   const cloned = {};
@@ -91,7 +93,7 @@ function setupRealtime(props) {
   }
 }
 var NumPerPage = 200;
-async function getAllPages(props, listFn, params) {
+async function getAllPages(props, listFn, params, listParams, onError) {
   const allData = [];
   let pageInfo = void 0;
   const { first: firstParam } = params;
@@ -107,8 +109,17 @@ async function getAllPages(props, listFn, params) {
     if (ret) {
       const { data, error } = ret;
       if (error) {
-        await handleApiError(props, error);
-        throw new Error(error.message);
+        const handled = await handleApiError(props, error);
+        if (!handled) {
+          const err = new Error(error.message, { cause: { error } });
+          onError(err, {
+            getParams: listParams,
+            type: "get",
+            source: "list",
+            action: listFn.name || listFn.toString(),
+            retry: listParams
+          });
+        }
       } else if (data) {
         pageInfo = data.pageInfo;
         allData.push(...data.results);
@@ -132,7 +143,6 @@ function syncedKeel(props) {
     fieldDeleted,
     realtime,
     mode,
-    onError,
     requireAuth = true,
     ...rest
   } = props;
@@ -152,7 +162,7 @@ function syncedKeel(props) {
     }
   } : void 0;
   const list = listParam ? async (listParams) => {
-    const { lastSync } = listParams;
+    const { lastSync, onError } = listParams;
     const queryBySync = !!lastSync && changesSince === "last-sync";
     const where = Object.assign(
       queryBySync ? { updatedAt: { after: new Date(lastSync + 1) } } : {},
@@ -160,14 +170,14 @@ function syncedKeel(props) {
     );
     const params = { where, first };
     realtimeState.current = {};
-    const promise = getAllPages(props, listParam, params);
+    const promise = getAllPages(props, listParam, params, listParams, onError);
     if (realtime) {
       setupSubscribe(listParams);
     }
     return promise;
   } : void 0;
   const get = getParam ? async (getParams) => {
-    const { refresh } = getParams;
+    const { refresh, onError } = getParams;
     realtimeState.current = {};
     const promise = getParam({ refresh });
     if (realtime) {
@@ -175,7 +185,17 @@ function syncedKeel(props) {
     }
     const { data, error } = await promise;
     if (error) {
-      throw new Error(error.message);
+      const handled = await handleApiError(props, error);
+      if (!handled) {
+        const err = new Error(error.message, { cause: { error } });
+        onError(err, {
+          getParams,
+          type: "get",
+          source: "get",
+          action: getParam.name || getParam.toString(),
+          retry: getParams
+        });
+      }
     } else {
       return data;
     }
@@ -192,7 +212,7 @@ function syncedKeel(props) {
   };
   const handleSetError = async (error, params, input, fn, from) => {
     var _a, _b;
-    const { retryNum, update: update2 } = params;
+    const { update: update2, onError } = params;
     if (from === "create" && ((_a = error.message) == null ? void 0 : _a.includes("for the unique")) && ((_b = error.message) == null ? void 0 : _b.includes("must be unique"))) {
       if (__DEV__) {
         console.log("Creating duplicate data already saved, just ignore.");
@@ -202,28 +222,25 @@ function syncedKeel(props) {
         value: {},
         mode: "assign"
       });
-    } else if (from === "delete") {
-      if (error.message === "record not found") {
-        if (__DEV__) {
-          console.log("Deleting non-existing data, just ignore.");
-        }
-        params.cancelRetry = true;
-      }
-    } else if (error.type === "bad_request") {
-      onError == null ? void 0 : onError(new Error(error.message), params, {
-        error,
-        params,
-        input,
-        type: from,
-        action: fn.name || fn.toString()
-      });
-      if (retryNum > 4) {
-        params.cancelRetry = true;
+    } else if (from === "delete" && error.message === "record not found") {
+      if (__DEV__) {
+        console.log("Deleting non-existing data, just ignore.");
       }
-      throw new Error(error.message, { cause: { input } });
+      params.cancelRetry = true;
     } else {
-      await handleApiError(props, error);
-      throw new Error(error.message, { cause: { input } });
+      const handled = await handleApiError(props, error);
+      if (!handled) {
+        const err = new Error(error.message, { cause: { error } });
+        onError(err, {
+          setParams: params,
+          input,
+          type: "set",
+          source: from,
+          action: fn.name || fn.toString(),
+          retry: params,
+          revert: createRevertChanges(params.value$, params.changes)
+        });
+      }
     }
   };
   const create = createParam ? async (input, params) => {
@@ -268,6 +285,7 @@ function syncedKeel(props) {
   } : subscribeParam;
   return syncedCrud({
     ...rest,
+    // Workaround for type errors
     as: asType,
     mode: mode || "merge",
     list,
@@ -292,10 +310,8 @@ function syncedKeel(props) {
     changesSince,
     updatePartial: true,
     subscribe,
-    generateId: generateKeelId,
-    // @ts-expect-error This errors because of the get/list union type
     get
   });
 }
 
-export { KeelKeys, generateKeelId, syncedKeel };
+export { KeelKeys, syncedKeel };

package/sync-plugins/supabase.d.mts

@@ -1,9 +1,9 @@
 import { Observable } from '@legendapp/state';
 import { SyncedOptions, SyncedOptionsGlobal, SyncedGetParams } from '@legendapp/state/sync';
 import { SyncedCrudPropsBase, CrudAsOption, SyncedCrudReturnType, SyncedCrudPropsMany } from '@legendapp/state/sync-plugins/crud';
-import { PostgrestQueryBuilder, PostgrestFilterBuilder } from '@supabase/postgrest-js';
-import { SupabaseClient, PostgrestSingleResponse } from '@supabase/supabase-js';
 import { FunctionsResponse } from '@supabase/functions-js';
+import { PostgrestFilterBuilder, PostgrestQueryBuilder } from '@supabase/postgrest-js';
+import { SupabaseClient, PostgrestSingleResponse } from '@supabase/supabase-js';
 
 type DatabaseOf<Client extends SupabaseClient> = Client extends SupabaseClient<infer TDB> ? TDB : never;
 type SchemaNameOf<Client extends SupabaseClient> = keyof DatabaseOf<Client>;
@@ -29,7 +29,7 @@ interface SyncedSupabaseProps<Client extends SupabaseClient<any, any>, Collectio
     supabase?: Client;
     collection: Collection;
     schema?: SchemaName;
-    select?: (query: PostgrestQueryBuilder<SupabaseSchemaOf<Client>, SupabaseTableOf<Client, SchemaName>[Collection], Collection>) => PostgrestFilterBuilder<SupabaseSchemaOf<Client>, TRemote, TRemote[], Collection, []>;
+    select?: never;
     filter?: (select: PostgrestFilterBuilder<SupabaseSchemaOf<Client>, TRemote, TRemote[], Collection, []>, params: SyncedGetParams<TRemote>) => PostgrestFilterBuilder<SupabaseSchemaOf<Client>, TRemote, TRemote[], Collection, []>;
     actions?: ('create' | 'read' | 'update' | 'delete')[];
     realtime?: boolean | {
@@ -42,8 +42,12 @@ interface SyncedSupabaseProps<Client extends SupabaseClient<any, any>, Collectio
     update?: (...params: Parameters<Required<SyncedCrudPropsBase<TRemote>>['update']>) => PromiseLike<PostgrestSingleResponse<TRemote>> | Promise<FunctionsResponse<NoInfer<TRemote>>>;
     delete?: (...params: Parameters<Required<SyncedCrudPropsBase<TRemote>>['delete']>) => PromiseLike<PostgrestSingleResponse<TRemote>> | Promise<FunctionsResponse<NoInfer<TRemote>>>;
 }
+interface SyncedSupabasePropsWithSelect<Client extends SupabaseClient<any, any>, Collection extends SupabaseCollectionOf<Client, SchemaName>, SchemaName extends SchemaNameOf<Client> = 'public', TOption extends CrudAsOption = 'object', TRemote extends SupabaseRowOf<Client, Collection, SchemaName> = SupabaseRowOf<Client, Collection, SchemaName>, TLocal = TRemote> extends Omit<SyncedSupabaseProps<Client, Collection, SchemaName, TOption, TRemote, TLocal>, 'select'> {
+    select: (query: PostgrestQueryBuilder<SupabaseSchemaOf<Client>, SupabaseTableOf<Client, SchemaName>[Collection], Collection>) => PostgrestFilterBuilder<SupabaseSchemaOf<Client>, TRemote, TRemote[], Collection, []>;
+}
 declare function getSyncedSupabaseConfiguration(): SyncedSupabaseConfiguration;
 declare function configureSyncedSupabase(config: SyncedSupabaseConfiguration): void;
+declare function syncedSupabase<Client extends SupabaseClient<any, any>, Collection extends SupabaseCollectionOf<Client, SchemaName> & string, SchemaName extends SchemaNameOf<Client> = 'public', AsOption extends CrudAsOption = 'object', TRemote = SupabaseRowOf<Client, Collection, SchemaName>, TLocal = TRemote>(props: SyncedSupabasePropsWithSelect<Client, Collection, SchemaName, AsOption, TRemote, TLocal>): SyncedCrudReturnType<TLocal, AsOption>;
 declare function syncedSupabase<Client extends SupabaseClient<any, any>, Collection extends SupabaseCollectionOf<Client, SchemaName> & string, SchemaName extends SchemaNameOf<Client> = 'public', AsOption extends CrudAsOption = 'object', TRemote extends SupabaseRowOf<Client, Collection, SchemaName> = SupabaseRowOf<Client, Collection, SchemaName>, TLocal = TRemote>(props: SyncedSupabaseProps<Client, Collection, SchemaName, AsOption, TRemote, TLocal>): SyncedCrudReturnType<TLocal, AsOption>;
 
 export { type SupabaseCollectionOf, type SupabaseRowOf, type SupabaseSchemaOf, type SupabaseTableOf, type SyncedSupabaseConfig, type SyncedSupabaseConfiguration, configureSyncedSupabase, getSyncedSupabaseConfiguration, syncedSupabase };

package/sync-plugins/supabase.d.ts

@@ -1,9 +1,9 @@
 import { Observable } from '@legendapp/state';
 import { SyncedOptions, SyncedOptionsGlobal, SyncedGetParams } from '@legendapp/state/sync';
 import { SyncedCrudPropsBase, CrudAsOption, SyncedCrudReturnType, SyncedCrudPropsMany } from '@legendapp/state/sync-plugins/crud';
-import { PostgrestQueryBuilder, PostgrestFilterBuilder } from '@supabase/postgrest-js';
-import { SupabaseClient, PostgrestSingleResponse } from '@supabase/supabase-js';
 import { FunctionsResponse } from '@supabase/functions-js';
+import { PostgrestFilterBuilder, PostgrestQueryBuilder } from '@supabase/postgrest-js';
+import { SupabaseClient, PostgrestSingleResponse } from '@supabase/supabase-js';
 
 type DatabaseOf<Client extends SupabaseClient> = Client extends SupabaseClient<infer TDB> ? TDB : never;
 type SchemaNameOf<Client extends SupabaseClient> = keyof DatabaseOf<Client>;
@@ -29,7 +29,7 @@ interface SyncedSupabaseProps<Client extends SupabaseClient<any, any>, Collectio
     supabase?: Client;
     collection: Collection;
     schema?: SchemaName;
-    select?: (query: PostgrestQueryBuilder<SupabaseSchemaOf<Client>, SupabaseTableOf<Client, SchemaName>[Collection], Collection>) => PostgrestFilterBuilder<SupabaseSchemaOf<Client>, TRemote, TRemote[], Collection, []>;
+    select?: never;
     filter?: (select: PostgrestFilterBuilder<SupabaseSchemaOf<Client>, TRemote, TRemote[], Collection, []>, params: SyncedGetParams<TRemote>) => PostgrestFilterBuilder<SupabaseSchemaOf<Client>, TRemote, TRemote[], Collection, []>;
     actions?: ('create' | 'read' | 'update' | 'delete')[];
     realtime?: boolean | {
@@ -42,8 +42,12 @@ interface SyncedSupabaseProps<Client extends SupabaseClient<any, any>, Collectio
     update?: (...params: Parameters<Required<SyncedCrudPropsBase<TRemote>>['update']>) => PromiseLike<PostgrestSingleResponse<TRemote>> | Promise<FunctionsResponse<NoInfer<TRemote>>>;
     delete?: (...params: Parameters<Required<SyncedCrudPropsBase<TRemote>>['delete']>) => PromiseLike<PostgrestSingleResponse<TRemote>> | Promise<FunctionsResponse<NoInfer<TRemote>>>;
 }
+interface SyncedSupabasePropsWithSelect<Client extends SupabaseClient<any, any>, Collection extends SupabaseCollectionOf<Client, SchemaName>, SchemaName extends SchemaNameOf<Client> = 'public', TOption extends CrudAsOption = 'object', TRemote extends SupabaseRowOf<Client, Collection, SchemaName> = SupabaseRowOf<Client, Collection, SchemaName>, TLocal = TRemote> extends Omit<SyncedSupabaseProps<Client, Collection, SchemaName, TOption, TRemote, TLocal>, 'select'> {
+    select: (query: PostgrestQueryBuilder<SupabaseSchemaOf<Client>, SupabaseTableOf<Client, SchemaName>[Collection], Collection>) => PostgrestFilterBuilder<SupabaseSchemaOf<Client>, TRemote, TRemote[], Collection, []>;
+}
 declare function getSyncedSupabaseConfiguration(): SyncedSupabaseConfiguration;
 declare function configureSyncedSupabase(config: SyncedSupabaseConfiguration): void;
+declare function syncedSupabase<Client extends SupabaseClient<any, any>, Collection extends SupabaseCollectionOf<Client, SchemaName> & string, SchemaName extends SchemaNameOf<Client> = 'public', AsOption extends CrudAsOption = 'object', TRemote = SupabaseRowOf<Client, Collection, SchemaName>, TLocal = TRemote>(props: SyncedSupabasePropsWithSelect<Client, Collection, SchemaName, AsOption, TRemote, TLocal>): SyncedCrudReturnType<TLocal, AsOption>;
 declare function syncedSupabase<Client extends SupabaseClient<any, any>, Collection extends SupabaseCollectionOf<Client, SchemaName> & string, SchemaName extends SchemaNameOf<Client> = 'public', AsOption extends CrudAsOption = 'object', TRemote extends SupabaseRowOf<Client, Collection, SchemaName> = SupabaseRowOf<Client, Collection, SchemaName>, TLocal = TRemote>(props: SyncedSupabaseProps<Client, Collection, SchemaName, AsOption, TRemote, TLocal>): SyncedCrudReturnType<TLocal, AsOption>;
 
 export { type SupabaseCollectionOf, type SupabaseRowOf, type SupabaseSchemaOf, type SupabaseTableOf, type SyncedSupabaseConfig, type SyncedSupabaseConfiguration, configureSyncedSupabase, getSyncedSupabaseConfiguration, syncedSupabase };