@xata.io/client 0.0.0-alpha.vf231460 → 0.0.0-alpha.vf28813b

package/dist/index.d.ts

@@ -6,6 +6,9 @@ declare type FetchImpl = (url: string, init?: {
     ok: boolean;
     status: number;
     json(): Promise<any>;
+    headers?: {
+        get(name: string): string | null;
+    };
 }>;
 declare type WorkspaceApiUrlBuilder = (path: string, pathParams: Record<string, string>) => string;
 declare type FetcherExtraProps = {
@@ -19,11 +22,36 @@ declare type ErrorWrapper<TError> = TError | {
     payload: string;
 };
 
+interface CacheImpl {
+    defaultQueryTTL: number;
+    getAll(): Promise<Record<string, unknown>>;
+    get: <T>(key: string) => Promise<T | null>;
+    set: <T>(key: string, value: T) => Promise<void>;
+    delete: (key: string) => Promise<void>;
+    clear: () => Promise<void>;
+}
+interface SimpleCacheOptions {
+    max?: number;
+    defaultQueryTTL?: number;
+}
+declare class SimpleCache implements CacheImpl {
+    #private;
+    capacity: number;
+    defaultQueryTTL: number;
+    constructor(options?: SimpleCacheOptions);
+    getAll(): Promise<Record<string, unknown>>;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+
 declare abstract class XataPlugin {
     abstract build(options: XataPluginOptions): unknown | Promise<unknown>;
 }
 declare type XataPluginOptions = {
     getFetchProps: () => Promise<FetcherExtraProps>;
+    cache: CacheImpl;
 };
 
 /**
@@ -94,22 +122,32 @@ declare type WorkspaceMembers = {
  * @pattern ^ik_[a-zA-Z0-9]+
  */
 declare type InviteKey = string;
+/**
+ * Metadata of databases
+ */
+declare type DatabaseMetadata = {
+    name: string;
+    displayName: string;
+    createdAt: DateTime;
+    numberOfBranches: number;
+    ui?: {
+        color?: string;
+    };
+};
 declare type ListDatabasesResponse = {
-    databases?: {
-        name: string;
-        displayName: string;
-        createdAt: DateTime;
-        numberOfBranches: number;
-        ui?: {
-            color?: string;
-        };
-    }[];
+    databases?: DatabaseMetadata[];
 };
 declare type ListBranchesResponse = {
     databaseName: string;
     displayName: string;
     branches: Branch[];
 };
+declare type ListGitBranchesResponse = {
+    mapping: {
+        gitBranch: string;
+        xataBranch: string;
+    }[];
+};
 declare type Branch = {
     name: string;
     createdAt: DateTime;
@@ -158,7 +196,7 @@ declare type Table = {
  */
 declare type Column = {
     name: string;
-    type: 'bool' | 'int' | 'float' | 'string' | 'text' | 'email' | 'multiple' | 'link' | 'object';
+    type: 'bool' | 'int' | 'float' | 'string' | 'text' | 'email' | 'multiple' | 'link' | 'object' | 'datetime';
     link?: {
         table: string;
     };
@@ -234,6 +272,21 @@ declare type SortExpression = string[] | {
     [key: string]: SortOrder;
 }[];
 declare type SortOrder = 'asc' | 'desc';
+/**
+ * Maximum [Levenshtein distance](https://en.wikipedia.org/wiki/Levenshtein_distance) for the search terms. The Levenshtein
+ * distance is the number of one charcter changes needed to make two strings equal. The default is 1, meaning that single
+ * character typos per word are tollerated by search. You can set it to 0 to remove the typo tollerance or set it to 2
+ * to allow two typos in a word.
+ *
+ * @default 1
+ * @maximum 2
+ * @minimum 0
+ */
+declare type FuzzinessExpression = number;
+/**
+ * If the prefix type is set to "disabled" (the default), the search only matches full words. If the prefix type is set to "phrase", the search will return results that match prefixes of the search phrase.
+ */
+declare type PrefixExpression = 'phrase' | 'disabled';
 /**
  * @minProperties 1
  */
@@ -247,6 +300,48 @@ declare type FilterExpression = {
 } & {
     [key: string]: FilterColumn;
 };
+declare type HighlightExpression = {
+    enabled?: boolean;
+    encodeHTML?: boolean;
+};
+/**
+ * Booster Expression
+ *
+ * @x-go-type xata.BoosterExpression
+ */
+declare type BoosterExpression = {
+    valueBooster?: ValueBooster$1;
+} | {
+    numericBooster?: NumericBooster$1;
+} | {
+    dateBooster?: DateBooster$1;
+};
+/**
+ * Boost records with a particular value for a column.
+ */
+declare type ValueBooster$1 = {
+    column: string;
+    value: string | number | boolean;
+    factor: number;
+};
+/**
+ * Boost records based on the value of a numeric column.
+ */
+declare type NumericBooster$1 = {
+    column: string;
+    factor: number;
+};
+/**
+ * Boost records based on the value of a datetime column. It is configured via "origin", "scale", and "decay". The further away from the "origin",
+ * the more the score is decayed. The decay function uses an exponential function. For example if origin is "now", and scale is 10 days and decay is 0.5, it
+ * should be interpreted as: a record with a date 10 days before/after origin will score 2 times less than a record with the date at origin.
+ */
+declare type DateBooster$1 = {
+    column: string;
+    origin?: string;
+    scale: string;
+    decay: number;
+};
 declare type FilterList = FilterExpression | FilterExpression[];
 declare type FilterColumn = FilterColumnIncludes | FilterPredicate | FilterList;
 /**
@@ -303,7 +398,24 @@ declare type PageConfig = {
     size?: number;
     offset?: number;
 };
-declare type ColumnsFilter = string[];
+declare type ColumnsProjection = string[];
+/**
+ * Xata Table Record Metadata
+ */
+declare type RecordMeta = {
+    id: RecordID;
+    xata: {
+        version: number;
+        table?: string;
+        highlight?: {
+            [key: string]: string[] | {
+                [key: string]: any;
+            };
+        };
+        score?: number;
+        warnings?: string[];
+    };
+};
 /**
  * @pattern [a-zA-Z0-9_-~:]+
  */
@@ -325,16 +437,9 @@ declare type RecordsMetadata = {
     };
 };
 /**
- * Xata Table Record
+ * Xata Table Record Metadata
  */
-declare type XataRecord$1 = {
-    id: RecordID;
-    xata: {
-        version: number;
-        table?: string;
-        warnings?: string[];
-    };
-} & {
+declare type XataRecord$1 = RecordMeta & {
     [key: string]: any;
 };
 
@@ -352,8 +457,10 @@ type schemas_InviteID = InviteID;
 type schemas_WorkspaceInvite = WorkspaceInvite;
 type schemas_WorkspaceMembers = WorkspaceMembers;
 type schemas_InviteKey = InviteKey;
+type schemas_DatabaseMetadata = DatabaseMetadata;
 type schemas_ListDatabasesResponse = ListDatabasesResponse;
 type schemas_ListBranchesResponse = ListBranchesResponse;
+type schemas_ListGitBranchesResponse = ListGitBranchesResponse;
 type schemas_Branch = Branch;
 type schemas_BranchMetadata = BranchMetadata;
 type schemas_DBBranch = DBBranch;
@@ -374,7 +481,11 @@ type schemas_TableMigration = TableMigration;
 type schemas_ColumnMigration = ColumnMigration;
 type schemas_SortExpression = SortExpression;
 type schemas_SortOrder = SortOrder;
+type schemas_FuzzinessExpression = FuzzinessExpression;
+type schemas_PrefixExpression = PrefixExpression;
 type schemas_FilterExpression = FilterExpression;
+type schemas_HighlightExpression = HighlightExpression;
+type schemas_BoosterExpression = BoosterExpression;
 type schemas_FilterList = FilterList;
 type schemas_FilterColumn = FilterColumn;
 type schemas_FilterColumnIncludes = FilterColumnIncludes;
@@ -384,7 +495,8 @@ type schemas_FilterPredicateRangeOp = FilterPredicateRangeOp;
 type schemas_FilterRangeValue = FilterRangeValue;
 type schemas_FilterValue = FilterValue;
 type schemas_PageConfig = PageConfig;
-type schemas_ColumnsFilter = ColumnsFilter;
+type schemas_ColumnsProjection = ColumnsProjection;
+type schemas_RecordMeta = RecordMeta;
 type schemas_RecordID = RecordID;
 type schemas_TableRename = TableRename;
 type schemas_RecordsMetadata = RecordsMetadata;
@@ -404,8 +516,10 @@ declare namespace schemas {
     schemas_WorkspaceInvite as WorkspaceInvite,
     schemas_WorkspaceMembers as WorkspaceMembers,
     schemas_InviteKey as InviteKey,
+    schemas_DatabaseMetadata as DatabaseMetadata,
     schemas_ListDatabasesResponse as ListDatabasesResponse,
     schemas_ListBranchesResponse as ListBranchesResponse,
+    schemas_ListGitBranchesResponse as ListGitBranchesResponse,
     schemas_Branch as Branch,
     schemas_BranchMetadata as BranchMetadata,
     schemas_DBBranch as DBBranch,
@@ -426,7 +540,14 @@ declare namespace schemas {
     schemas_ColumnMigration as ColumnMigration,
     schemas_SortExpression as SortExpression,
     schemas_SortOrder as SortOrder,
+    schemas_FuzzinessExpression as FuzzinessExpression,
+    schemas_PrefixExpression as PrefixExpression,
     schemas_FilterExpression as FilterExpression,
+    schemas_HighlightExpression as HighlightExpression,
+    schemas_BoosterExpression as BoosterExpression,
+    ValueBooster$1 as ValueBooster,
+    NumericBooster$1 as NumericBooster,
+    DateBooster$1 as DateBooster,
     schemas_FilterList as FilterList,
     schemas_FilterColumn as FilterColumn,
     schemas_FilterColumnIncludes as FilterColumnIncludes,
@@ -436,7 +557,8 @@ declare namespace schemas {
     schemas_FilterRangeValue as FilterRangeValue,
     schemas_FilterValue as FilterValue,
     schemas_PageConfig as PageConfig,
-    schemas_ColumnsFilter as ColumnsFilter,
+    schemas_ColumnsProjection as ColumnsProjection,
+    schemas_RecordMeta as RecordMeta,
     schemas_RecordID as RecordID,
     schemas_TableRename as TableRename,
     schemas_RecordsMetadata as RecordsMetadata,
@@ -471,11 +593,17 @@ declare type BulkError = {
         status?: number;
     }[];
 };
+declare type BulkInsertResponse = {
+    recordIDs: string[];
+} | {
+    records: XataRecord$1[];
+};
 declare type BranchMigrationPlan = {
     version: number;
     migration: BranchMigration;
 };
-declare type RecordUpdateResponse = {
+declare type RecordResponse = XataRecord$1;
+declare type RecordUpdateResponse = XataRecord$1 | {
     id: string;
     xata: {
         version: number;
@@ -499,7 +627,9 @@ type responses_SimpleError = SimpleError;
 type responses_BadRequestError = BadRequestError;
 type responses_AuthError = AuthError;
 type responses_BulkError = BulkError;
+type responses_BulkInsertResponse = BulkInsertResponse;
 type responses_BranchMigrationPlan = BranchMigrationPlan;
+type responses_RecordResponse = RecordResponse;
 type responses_RecordUpdateResponse = RecordUpdateResponse;
 type responses_QueryResponse = QueryResponse;
 type responses_SearchResponse = SearchResponse;
@@ -510,7 +640,9 @@ declare namespace responses {
     responses_BadRequestError as BadRequestError,
     responses_AuthError as AuthError,
     responses_BulkError as BulkError,
+    responses_BulkInsertResponse as BulkInsertResponse,
     responses_BranchMigrationPlan as BranchMigrationPlan,
+    responses_RecordResponse as RecordResponse,
     responses_RecordUpdateResponse as RecordUpdateResponse,
     responses_QueryResponse as QueryResponse,
     responses_SearchResponse as SearchResponse,
@@ -816,6 +948,9 @@ declare type InviteWorkspaceMemberError = ErrorWrapper<{
 } | {
     status: 404;
     payload: SimpleError;
+} | {
+    status: 409;
+    payload: SimpleError;
 }>;
 declare type InviteWorkspaceMemberRequestBody = {
     email: string;
@@ -829,6 +964,34 @@ declare type InviteWorkspaceMemberVariables = {
  * Invite some user to join the workspace with the given role
  */
 declare const inviteWorkspaceMember: (variables: InviteWorkspaceMemberVariables) => Promise<WorkspaceInvite>;
+declare type UpdateWorkspaceMemberInvitePathParams = {
+    workspaceId: WorkspaceID;
+    inviteId: InviteID;
+};
+declare type UpdateWorkspaceMemberInviteError = ErrorWrapper<{
+    status: 400;
+    payload: BadRequestError;
+} | {
+    status: 401;
+    payload: AuthError;
+} | {
+    status: 404;
+    payload: SimpleError;
+} | {
+    status: 422;
+    payload: SimpleError;
+}>;
+declare type UpdateWorkspaceMemberInviteRequestBody = {
+    role: Role;
+};
+declare type UpdateWorkspaceMemberInviteVariables = {
+    body: UpdateWorkspaceMemberInviteRequestBody;
+    pathParams: UpdateWorkspaceMemberInvitePathParams;
+} & FetcherExtraProps;
+/**
+ * This operation provides a way to update an existing invite. Updates are performed in-place; they do not change the invite link, the expiry time, nor do they re-notify the recipient of the invite.
+ */
+declare const updateWorkspaceMemberInvite: (variables: UpdateWorkspaceMemberInviteVariables) => Promise<WorkspaceInvite>;
 declare type CancelWorkspaceMemberInvitePathParams = {
     workspaceId: WorkspaceID;
     inviteId: InviteID;
@@ -982,6 +1145,184 @@ declare type DeleteDatabaseVariables = {
  * Delete a database and all of its branches and tables permanently.
  */
 declare const deleteDatabase: (variables: DeleteDatabaseVariables) => Promise<undefined>;
+declare type GetDatabaseMetadataPathParams = {
+    dbName: DBName;
+    workspace: string;
+};
+declare type GetDatabaseMetadataError = ErrorWrapper<{
+    status: 400;
+    payload: BadRequestError;
+} | {
+    status: 401;
+    payload: AuthError;
+} | {
+    status: 404;
+    payload: SimpleError;
+}>;
+declare type GetDatabaseMetadataVariables = {
+    pathParams: GetDatabaseMetadataPathParams;
+} & FetcherExtraProps;
+/**
+ * Retrieve metadata of the given database
+ */
+declare const getDatabaseMetadata: (variables: GetDatabaseMetadataVariables) => Promise<DatabaseMetadata>;
+declare type GetGitBranchesMappingPathParams = {
+    dbName: DBName;
+    workspace: string;
+};
+declare type GetGitBranchesMappingError = ErrorWrapper<{
+    status: 400;
+    payload: BadRequestError;
+} | {
+    status: 401;
+    payload: AuthError;
+}>;
+declare type GetGitBranchesMappingVariables = {
+    pathParams: GetGitBranchesMappingPathParams;
+} & FetcherExtraProps;
+/**
+ * Lists all the git branches in the mapping, and their associated Xata branches.
+ *
+ * Example response:
+ *
+ * ```json
+ * {
+ *   "mappings": [
+ *       {
+ *         "gitBranch": "main",
+ *         "xataBranch": "main"
+ *       },
+ *       {
+ *         "gitBranch": "gitBranch1",
+ *         "xataBranch": "xataBranch1"
+ *       }
+ *       {
+ *         "gitBranch": "xataBranch2",
+ *         "xataBranch": "xataBranch2"
+ *       }
+ *   ]
+ * }
+ * ```
+ */
+declare const getGitBranchesMapping: (variables: GetGitBranchesMappingVariables) => Promise<ListGitBranchesResponse>;
+declare type AddGitBranchesEntryPathParams = {
+    dbName: DBName;
+    workspace: string;
+};
+declare type AddGitBranchesEntryError = ErrorWrapper<{
+    status: 400;
+    payload: BadRequestError;
+} | {
+    status: 401;
+    payload: AuthError;
+}>;
+declare type AddGitBranchesEntryResponse = {
+    warning?: string;
+};
+declare type AddGitBranchesEntryRequestBody = {
+    gitBranch: string;
+    xataBranch: BranchName;
+};
+declare type AddGitBranchesEntryVariables = {
+    body: AddGitBranchesEntryRequestBody;
+    pathParams: AddGitBranchesEntryPathParams;
+} & FetcherExtraProps;
+/**
+ * Adds an entry to the mapping of git branches to Xata branches. The git branch and the Xata branch must be present in the body of the request. If the Xata branch doesn't exist, a 400 error is returned.
+ *
+ * If the git branch is already present in the mapping, the old entry is overwritten, and a warning message is included in the response. If the git branch is added and didn't exist before, the response code is 204. If the git branch existed and it was overwritten, the response code is 201.
+ *
+ * Example request:
+ *
+ * ```json
+ * // POST https://tutorial-ng7s8c.xata.sh/dbs/demo/gitBranches
+ * {
+ *   "gitBranch": "fix/bug123",
+ *   "xataBranch": "fix_bug"
+ * }
+ * ```
+ */
+declare const addGitBranchesEntry: (variables: AddGitBranchesEntryVariables) => Promise<AddGitBranchesEntryResponse>;
+declare type RemoveGitBranchesEntryPathParams = {
+    dbName: DBName;
+    workspace: string;
+};
+declare type RemoveGitBranchesEntryQueryParams = {
+    gitBranch: string;
+};
+declare type RemoveGitBranchesEntryError = ErrorWrapper<{
+    status: 400;
+    payload: BadRequestError;
+} | {
+    status: 401;
+    payload: AuthError;
+}>;
+declare type RemoveGitBranchesEntryVariables = {
+    pathParams: RemoveGitBranchesEntryPathParams;
+    queryParams: RemoveGitBranchesEntryQueryParams;
+} & FetcherExtraProps;
+/**
+ * Removes an entry from the mapping of git branches to Xata branches. The name of the git branch must be passed as a query parameter. If the git branch is not found, the endpoint returns a 404 status code.
+ *
+ * Example request:
+ *
+ * ```json
+ * // DELETE https://tutorial-ng7s8c.xata.sh/dbs/demo/gitBranches?gitBranch=fix%2Fbug123
+ * ```
+ */
+declare const removeGitBranchesEntry: (variables: RemoveGitBranchesEntryVariables) => Promise<undefined>;
+declare type ResolveBranchPathParams = {
+    dbName: DBName;
+    workspace: string;
+};
+declare type ResolveBranchQueryParams = {
+    gitBranch?: string;
+    fallbackBranch?: string;
+};
+declare type ResolveBranchError = ErrorWrapper<{
+    status: 400;
+    payload: BadRequestError;
+} | {
+    status: 401;
+    payload: AuthError;
+}>;
+declare type ResolveBranchResponse = {
+    branch: string;
+    reason: {
+        code: 'FOUND_IN_MAPPING' | 'BRANCH_EXISTS' | 'FALLBACK_BRANCH' | 'DEFAULT_BRANCH';
+        message: string;
+    };
+};
+declare type ResolveBranchVariables = {
+    pathParams: ResolveBranchPathParams;
+    queryParams?: ResolveBranchQueryParams;
+} & FetcherExtraProps;
+/**
+ * In order to resolve the database branch, the following algorithm is used:
+ * * if the `gitBranch` was provided and is found in the [git branches mapping](/api-reference/dbs/db_name/gitBranches), the associated Xata branch is returned
+ * * else, if a Xata branch with the exact same name as `gitBranch` exists, return it
+ * * else, if `fallbackBranch` is provided and a branch with that name exists, return it
+ * * else, return the default branch of the DB (`main` or the first branch)
+ *
+ * Example call:
+ *
+ * ```json
+ * // GET https://tutorial-ng7s8c.xata.sh/dbs/demo/dbs/demo/resolveBranch?gitBranch=test&fallbackBranch=tsg
+ * ```
+ *
+ * Example response:
+ *
+ * ```json
+ * {
+ *   "branch": "main",
+ *   "reason": {
+ *     "code": "DEFAULT_BRANCH",
+ *     "message": "Default branch for this database (main)"
+ *   }
+ * }
+ * ```
+ */
+declare const resolveBranch: (variables: ResolveBranchVariables) => Promise<ResolveBranchResponse>;
 declare type GetBranchDetailsPathParams = {
     dbBranchName: DBBranchName;
     workspace: string;
@@ -1017,6 +1358,10 @@ declare type CreateBranchError = ErrorWrapper<{
     status: 404;
     payload: SimpleError;
 }>;
+declare type CreateBranchResponse = {
+    databaseName: string;
+    branchName: string;
+};
 declare type CreateBranchRequestBody = {
     from?: string;
     metadata?: BranchMetadata;
@@ -1026,7 +1371,7 @@ declare type CreateBranchVariables = {
     pathParams: CreateBranchPathParams;
     queryParams?: CreateBranchQueryParams;
 } & FetcherExtraProps;
-declare const createBranch: (variables: CreateBranchVariables) => Promise<undefined>;
+declare const createBranch: (variables: CreateBranchVariables) => Promise<CreateBranchResponse>;
 declare type DeleteBranchPathParams = {
     dbBranchName: DBBranchName;
     workspace: string;
@@ -1213,13 +1558,17 @@ declare type CreateTableError = ErrorWrapper<{
     status: 422;
     payload: SimpleError;
 }>;
+declare type CreateTableResponse = {
+    branchName: string;
+    tableName: string;
+};
 declare type CreateTableVariables = {
     pathParams: CreateTablePathParams;
 } & FetcherExtraProps;
 /**
  * Creates a new table with the given name. Returns 422 if a table with the same name already exists.
  */
-declare const createTable: (variables: CreateTableVariables) => Promise<undefined>;
+declare const createTable: (variables: CreateTableVariables) => Promise<CreateTableResponse>;
 declare type DeleteTablePathParams = {
     dbBranchName: DBBranchName;
     tableName: TableName;
@@ -1266,8 +1615,9 @@ declare type UpdateTableVariables = {
  *
  * In the example below, we rename a table from “users” to “people”:
  *
- * ```jsx
- * PATCH /db/test:main/tables/users
+ * ```json
+ * // PATCH /db/test:main/tables/users
+ *
  * {
  *   "name": "people"
  * }
@@ -1451,6 +1801,9 @@ declare type InsertRecordPathParams = {
     tableName: TableName;
     workspace: string;
 };
+declare type InsertRecordQueryParams = {
+    columns?: ColumnsProjection;
+};
 declare type InsertRecordError = ErrorWrapper<{
     status: 400;
     payload: BadRequestError;
@@ -1461,20 +1814,15 @@ declare type InsertRecordError = ErrorWrapper<{
     status: 404;
     payload: SimpleError;
 }>;
-declare type InsertRecordResponse = {
-    id: string;
-    xata: {
-        version: number;
-    };
-};
 declare type InsertRecordVariables = {
     body?: Record<string, any>;
     pathParams: InsertRecordPathParams;
+    queryParams?: InsertRecordQueryParams;
 } & FetcherExtraProps;
 /**
  * Insert a new Record into the Table
  */
-declare const insertRecord: (variables: InsertRecordVariables) => Promise<InsertRecordResponse>;
+declare const insertRecord: (variables: InsertRecordVariables) => Promise<RecordUpdateResponse>;
 declare type InsertRecordWithIDPathParams = {
     dbBranchName: DBBranchName;
     tableName: TableName;
@@ -1482,6 +1830,7 @@ declare type InsertRecordWithIDPathParams = {
     workspace: string;
 };
 declare type InsertRecordWithIDQueryParams = {
+    columns?: ColumnsProjection;
     createOnly?: boolean;
     ifVersion?: number;
 };
@@ -1514,6 +1863,7 @@ declare type UpdateRecordWithIDPathParams = {
     workspace: string;
 };
 declare type UpdateRecordWithIDQueryParams = {
+    columns?: ColumnsProjection;
     ifVersion?: number;
 };
 declare type UpdateRecordWithIDError = ErrorWrapper<{
@@ -1542,6 +1892,7 @@ declare type UpsertRecordWithIDPathParams = {
     workspace: string;
 };
 declare type UpsertRecordWithIDQueryParams = {
+    columns?: ColumnsProjection;
     ifVersion?: number;
 };
 declare type UpsertRecordWithIDError = ErrorWrapper<{
@@ -1569,6 +1920,9 @@ declare type DeleteRecordPathParams = {
     recordId: RecordID;
     workspace: string;
 };
+declare type DeleteRecordQueryParams = {
+    columns?: ColumnsProjection;
+};
 declare type DeleteRecordError = ErrorWrapper<{
     status: 400;
     payload: BadRequestError;
@@ -1581,14 +1935,18 @@ declare type DeleteRecordError = ErrorWrapper<{
 }>;
 declare type DeleteRecordVariables = {
     pathParams: DeleteRecordPathParams;
+    queryParams?: DeleteRecordQueryParams;
 } & FetcherExtraProps;
-declare const deleteRecord: (variables: DeleteRecordVariables) => Promise<undefined>;
+declare const deleteRecord: (variables: DeleteRecordVariables) => Promise<XataRecord$1>;
 declare type GetRecordPathParams = {
     dbBranchName: DBBranchName;
     tableName: TableName;
     recordId: RecordID;
     workspace: string;
 };
+declare type GetRecordQueryParams = {
+    columns?: ColumnsProjection;
+};
 declare type GetRecordError = ErrorWrapper<{
     status: 400;
     payload: BadRequestError;
@@ -1599,12 +1957,9 @@ declare type GetRecordError = ErrorWrapper<{
     status: 404;
     payload: SimpleError;
 }>;
-declare type GetRecordRequestBody = {
-    columns?: ColumnsFilter;
-};
 declare type GetRecordVariables = {
-    body?: GetRecordRequestBody;
     pathParams: GetRecordPathParams;
+    queryParams?: GetRecordQueryParams;
 } & FetcherExtraProps;
 /**
  * Retrieve record by ID
@@ -1615,6 +1970,9 @@ declare type BulkInsertTableRecordsPathParams = {
     tableName: TableName;
     workspace: string;
 };
+declare type BulkInsertTableRecordsQueryParams = {
+    columns?: ColumnsProjection;
+};
 declare type BulkInsertTableRecordsError = ErrorWrapper<{
     status: 400;
     payload: BulkError;
@@ -1624,21 +1982,22 @@ declare type BulkInsertTableRecordsError = ErrorWrapper<{
 } | {
     status: 404;
     payload: SimpleError;
+} | {
+    status: 422;
+    payload: SimpleError;
 }>;
-declare type BulkInsertTableRecordsResponse = {
-    recordIDs: string[];
-};
 declare type BulkInsertTableRecordsRequestBody = {
     records: Record<string, any>[];
 };
 declare type BulkInsertTableRecordsVariables = {
     body: BulkInsertTableRecordsRequestBody;
     pathParams: BulkInsertTableRecordsPathParams;
+    queryParams?: BulkInsertTableRecordsQueryParams;
 } & FetcherExtraProps;
 /**
  * Bulk insert records
  */
-declare const bulkInsertTableRecords: (variables: BulkInsertTableRecordsVariables) => Promise<BulkInsertTableRecordsResponse>;
+declare const bulkInsertTableRecords: (variables: BulkInsertTableRecordsVariables) => Promise<BulkInsertResponse>;
 declare type QueryTablePathParams = {
     dbBranchName: DBBranchName;
     tableName: TableName;
@@ -1658,7 +2017,7 @@ declare type QueryTableRequestBody = {
     filter?: FilterExpression;
     sort?: SortExpression;
     page?: PageConfig;
-    columns?: ColumnsFilter;
+    columns?: ColumnsProjection;
 };
 declare type QueryTableVariables = {
     body?: QueryTableRequestBody;
@@ -1675,7 +2034,7 @@ declare type QueryTableVariables = {
  * {
  *   "columns": [...],
  *   "filter": {
- *     "$all": [...]
+ *     "$all": [...],
  *     "$any": [...]
  *     ...
  *   },
@@ -1721,7 +2080,11 @@ declare type QueryTableVariables = {
  *           "link": {
  *             "table": "users"
  *           }
- *         }
+ *         },
+ *         {
+ *           "name": "foundedDate",
+ *           "type": "datetime"
+ *         },
  *       ]
  *     },
  *     {
@@ -1809,7 +2172,7 @@ declare type QueryTableVariables = {
  * {
  *   "name": "Kilian",
  *   "address": {
- *     "street": "New street",
+ *     "street": "New street"
  *   }
  * }
  * ```
@@ -1818,10 +2181,7 @@ declare type QueryTableVariables = {
  *
  * ```json
  * {
- *   "columns": [
- *     "*",
- *     "team.name"
- *   ]
+ *   "columns": ["*", "team.name"]
  * }
  * ```
  *
@@ -1839,7 +2199,7 @@ declare type QueryTableVariables = {
  *   "team": {
  *     "id": "XX",
  *     "xata": {
- *       "version": 0,
+ *       "version": 0
  *     },
  *     "name": "first team"
  *   }
@@ -1850,10 +2210,7 @@ declare type QueryTableVariables = {
  *
  * ```json
  * {
- *   "columns": [
- *     "*",
- *     "team.*"
- *   ]
+ *   "columns": ["*", "team.*"]
  * }
  * ```
  *
@@ -1871,10 +2228,11 @@ declare type QueryTableVariables = {
  *   "team": {
  *     "id": "XX",
  *     "xata": {
- *       "version": 0,
+ *       "version": 0
  *     },
  *     "name": "first team",
- *     "code": "A1"
+ *     "code": "A1",
+ *     "foundedDate": "2020-03-04T10:43:54.32Z"
  *   }
  * }
  * ```
@@ -1889,7 +2247,7 @@ declare type QueryTableVariables = {
  *   `$none`, etc.
  *
  * All operators start with an `$` to differentiate them from column names
- * (which are not allowed to start with an dollar sign).
+ * (which are not allowed to start with a dollar sign).
  *
  * #### Exact matching and control operators
  *
@@ -1920,7 +2278,7 @@ declare type QueryTableVariables = {
  * ```json
  * {
  *   "filter": {
- *       "name": "r2",
+ *     "name": "r2"
  *   }
  * }
  * ```
@@ -1942,7 +2300,7 @@ declare type QueryTableVariables = {
  * ```json
  * {
  *   "filter": {
- *       "settings.plan": "free",
+ *     "settings.plan": "free"
  *   }
  * }
  * ```
@@ -1952,8 +2310,8 @@ declare type QueryTableVariables = {
  *   "filter": {
  *     "settings": {
  *       "plan": "free"
- *     },
- *   },
+ *     }
+ *   }
  * }
  * ```
  *
@@ -1962,8 +2320,8 @@ declare type QueryTableVariables = {
  * ```json
  * {
  *   "filter": {
- *     "settings.plan": {"$any": ["free", "paid"]}
- *   },
+ *     "settings.plan": { "$any": ["free", "paid"] }
+ *   }
  * }
  * ```
  *
@@ -1972,9 +2330,9 @@ declare type QueryTableVariables = {
  * ```json
  * {
  *   "filter": {
- *       "settings.dark": true,
- *       "settings.plan": "free",
- *   },
+ *     "settings.dark": true,
+ *     "settings.plan": "free"
+ *   }
  * }
  * ```
  *
@@ -1985,11 +2343,11 @@ declare type QueryTableVariables = {
  * ```json
  * {
  *   "filter": {
- *       "$any": {
- *         "settings.dark": true,
- *         "settings.plan": "free"
- *       }
- *   },
+ *     "$any": {
+ *       "settings.dark": true,
+ *       "settings.plan": "free"
+ *     }
+ *   }
  * }
  * ```
  *
@@ -2000,10 +2358,10 @@ declare type QueryTableVariables = {
  *   "filter": {
  *     "$any": [
  *       {
- *         "name": "r1",
+ *         "name": "r1"
  *       },
  *       {
- *         "name": "r2",
+ *         "name": "r2"
  *       }
  *     ]
  *   }
@@ -2015,7 +2373,7 @@ declare type QueryTableVariables = {
  * ```json
  * {
  *   "filter": {
- *     "$exists": "settings",
+ *     "$exists": "settings"
  *   }
  * }
  * ```
@@ -2027,10 +2385,10 @@ declare type QueryTableVariables = {
  *   "filter": {
  *     "$all": [
  *       {
- *         "$exists": "settings",
+ *         "$exists": "settings"
  *       },
  *       {
- *         "$exists": "name",
+ *         "$exists": "name"
  *       }
  *     ]
  *   }
@@ -2042,7 +2400,7 @@ declare type QueryTableVariables = {
  * ```json
  * {
  *   "filter": {
- *     "$notExists": "settings",
+ *     "$notExists": "settings"
  *   }
  * }
  * ```
@@ -2069,43 +2427,59 @@ declare type QueryTableVariables = {
  * {
  *   "filter": {
  *     "<column_name>": {
- *         "$pattern": "v*alue*"
+ *       "$pattern": "v*alu?"
  *     }
  *   }
  * }
  * ```
  *
+ * The `$pattern` operator accepts two wildcard characters:
+ * * `*` matches zero or more characters
+ * * `?` matches exactly one character
+ *
+ * If you want to match a string that contains a wildcard character, you can escape them using a backslash (`\`). You can escape a backslash by usign another backslash.
+ *
  * We could also have `$endsWith` and `$startsWith` operators:
  *
  * ```json
  * {
  *   "filter": {
  *     "<column_name>": {
- *         "$endsWith": ".gz"
+ *       "$endsWith": ".gz"
  *     },
  *     "<column_name>": {
- *         "$startsWith": "tmp-"
+ *       "$startsWith": "tmp-"
  *     }
  *   }
  * }
  * ```
  *
- * #### Numeric ranges
+ * #### Numeric or datetime ranges
  *
  * ```json
  * {
  *   "filter": {
- *       "<column_name>": {
- *         "$ge": 0,
- *         "$lt": 100
- *       }
+ *     "<column_name>": {
+ *       "$ge": 0,
+ *       "$lt": 100
+ *     }
+ *   }
+ * }
+ * ```
+ * Date ranges support the same operators, with the date using the format defined in
+ * [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339):
+ * ```json
+ * {
+ *   "filter": {
+ *     "<column_name>": {
+ *       "$gt": "2019-10-12T07:20:50.52Z",
+ *       "$lt": "2021-10-12T07:20:50.52Z"
+ *     }
  *   }
  * }
  * ```
- *
  * The supported operators are `$gt`, `$lt`, `$ge`, `$le`.
  *
- *
  * #### Negations
  *
  * A general `$not` operator can inverse any operation.
@@ -2130,22 +2504,28 @@ declare type QueryTableVariables = {
  * {
  *   "filter": {
  *     "$not": {
- *       "$any": [{
- *         "<column_name1>": "value1"
- *       }, {
- *         "$all": [{
- *           "<column_name2>": "value2"
- *         }, {
- *           "<column_name3>": "value3"
- *         }]
- *       }]
- *     }
- *   }
- * }
- * ```
- *
- * The `$not: { $any: {}}` can be shorted using the `$none` operator:
- *
+ *       "$any": [
+ *         {
+ *           "<column_name1>": "value1"
+ *         },
+ *         {
+ *           "$all": [
+ *             {
+ *               "<column_name2>": "value2"
+ *             },
+ *             {
+ *               "<column_name3>": "value3"
+ *             }
+ *           ]
+ *         }
+ *       ]
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * The `$not: { $any: {}}` can be shorted using the `$none` operator:
+ *
  * ```json
  * {
  *   "filter": {
@@ -2193,8 +2573,8 @@ declare type QueryTableVariables = {
  *     "<array name>": {
  *       "$includes": {
  *         "$all": [
- *           {"$contains": "label"},
- *           {"$not": {"$endsWith": "-debug"}}
+ *           { "$contains": "label" },
+ *           { "$not": { "$endsWith": "-debug" } }
  *         ]
  *       }
  *     }
@@ -2214,9 +2594,7 @@ declare type QueryTableVariables = {
  * {
  *   "filter": {
  *     "settings.labels": {
- *       "$includesAll": [
- *         {"$contains": "label"},
- *       ]
+ *       "$includesAll": [{ "$contains": "label" }]
  *     }
  *   }
  * }
@@ -2264,7 +2642,6 @@ declare type QueryTableVariables = {
  * }
  * ```
  *
- *
  * ### Pagination
  *
  * We offer cursor pagination and offset pagination. The offset pagination is limited
@@ -2330,8 +2707,8 @@ declare type QueryTableVariables = {
  * can be queried by update `page.after` to the returned cursor while keeping the
  * `page.before` cursor from the first range query.
  *
- * The `filter` , `columns`,  `sort` , and `page.size` configuration will be
- * encoded with the cursor.  The pagination request will be invalid if
+ * The `filter` , `columns`, `sort` , and `page.size` configuration will be
+ * encoded with the cursor. The pagination request will be invalid if
  * `filter` or `sort` is set. The columns returned and page size can be changed
  * anytime by passing the `columns` or `page.size` settings to the next query.
  *
@@ -2368,6 +2745,41 @@ declare type QueryTableVariables = {
  * ```
  */
 declare const queryTable: (variables: QueryTableVariables) => Promise<QueryResponse>;
+declare type SearchTablePathParams = {
+    dbBranchName: DBBranchName;
+    tableName: TableName;
+    workspace: string;
+};
+declare type SearchTableError = ErrorWrapper<{
+    status: 400;
+    payload: BadRequestError;
+} | {
+    status: 401;
+    payload: AuthError;
+} | {
+    status: 404;
+    payload: SimpleError;
+}>;
+declare type SearchTableRequestBody = {
+    query: string;
+    fuzziness?: FuzzinessExpression;
+    prefix?: PrefixExpression;
+    filter?: FilterExpression;
+    highlight?: HighlightExpression;
+    boosters?: BoosterExpression[];
+};
+declare type SearchTableVariables = {
+    body: SearchTableRequestBody;
+    pathParams: SearchTablePathParams;
+} & FetcherExtraProps;
+/**
+ * Run a free text search operation in a particular table.
+ *
+ * The endpoint accepts a `query` parameter that is used for the free text search and a set of structured filters (via the `filter` parameter) that are applied before the search. The `filter` parameter uses the same syntax as the [query endpoint](/api-reference/db/db_branch_name/tables/table_name/) with the following exceptions:
+ * * filters `$contains`, `$startsWith`, `$endsWith` don't work on columns of type `text`
+ * * filtering on columns of type `multiple` is currently unsupported
+ */
+declare const searchTable: (variables: SearchTableVariables) => Promise<SearchResponse>;
 declare type SearchBranchPathParams = {
     dbBranchName: DBBranchName;
     workspace: string;
@@ -2383,9 +2795,14 @@ declare type SearchBranchError = ErrorWrapper<{
     payload: SimpleError;
 }>;
 declare type SearchBranchRequestBody = {
-    tables?: string[];
+    tables?: (string | {
+        table: string;
+        filter?: FilterExpression;
+        boosters?: BoosterExpression[];
+    })[];
     query: string;
-    fuzziness?: number;
+    fuzziness?: FuzzinessExpression;
+    highlight?: HighlightExpression;
 };
 declare type SearchBranchVariables = {
     body: SearchBranchRequestBody;
@@ -2414,6 +2831,7 @@ declare const operationsByTag: {
         updateWorkspaceMemberRole: (variables: UpdateWorkspaceMemberRoleVariables) => Promise<undefined>;
         removeWorkspaceMember: (variables: RemoveWorkspaceMemberVariables) => Promise<undefined>;
         inviteWorkspaceMember: (variables: InviteWorkspaceMemberVariables) => Promise<WorkspaceInvite>;
+        updateWorkspaceMemberInvite: (variables: UpdateWorkspaceMemberInviteVariables) => Promise<WorkspaceInvite>;
         cancelWorkspaceMemberInvite: (variables: CancelWorkspaceMemberInviteVariables) => Promise<undefined>;
         resendWorkspaceMemberInvite: (variables: ResendWorkspaceMemberInviteVariables) => Promise<undefined>;
         acceptWorkspaceMemberInvite: (variables: AcceptWorkspaceMemberInviteVariables) => Promise<undefined>;
@@ -2422,11 +2840,16 @@ declare const operationsByTag: {
         getDatabaseList: (variables: GetDatabaseListVariables) => Promise<ListDatabasesResponse>;
         createDatabase: (variables: CreateDatabaseVariables) => Promise<CreateDatabaseResponse>;
         deleteDatabase: (variables: DeleteDatabaseVariables) => Promise<undefined>;
+        getGitBranchesMapping: (variables: GetGitBranchesMappingVariables) => Promise<ListGitBranchesResponse>;
+        addGitBranchesEntry: (variables: AddGitBranchesEntryVariables) => Promise<AddGitBranchesEntryResponse>;
+        removeGitBranchesEntry: (variables: RemoveGitBranchesEntryVariables) => Promise<undefined>;
+        resolveBranch: (variables: ResolveBranchVariables) => Promise<ResolveBranchResponse>;
     };
     branch: {
         getBranchList: (variables: GetBranchListVariables) => Promise<ListBranchesResponse>;
+        getDatabaseMetadata: (variables: GetDatabaseMetadataVariables) => Promise<DatabaseMetadata>;
         getBranchDetails: (variables: GetBranchDetailsVariables) => Promise<DBBranch>;
-        createBranch: (variables: CreateBranchVariables) => Promise<undefined>;
+        createBranch: (variables: CreateBranchVariables) => Promise<CreateBranchResponse>;
         deleteBranch: (variables: DeleteBranchVariables) => Promise<undefined>;
         updateBranchMetadata: (variables: UpdateBranchMetadataVariables) => Promise<undefined>;
         getBranchMetadata: (variables: GetBranchMetadataVariables) => Promise<BranchMetadata>;
@@ -2436,7 +2859,7 @@ declare const operationsByTag: {
         getBranchStats: (variables: GetBranchStatsVariables) => Promise<GetBranchStatsResponse>;
     };
     table: {
-        createTable: (variables: CreateTableVariables) => Promise<undefined>;
+        createTable: (variables: CreateTableVariables) => Promise<CreateTableResponse>;
         deleteTable: (variables: DeleteTableVariables) => Promise<undefined>;
         updateTable: (variables: UpdateTableVariables) => Promise<undefined>;
         getTableSchema: (variables: GetTableSchemaVariables) => Promise<GetTableSchemaResponse>;
@@ -2448,14 +2871,15 @@ declare const operationsByTag: {
         updateColumn: (variables: UpdateColumnVariables) => Promise<MigrationIdResponse>;
     };
     records: {
-        insertRecord: (variables: InsertRecordVariables) => Promise<InsertRecordResponse>;
+        insertRecord: (variables: InsertRecordVariables) => Promise<RecordUpdateResponse>;
         insertRecordWithID: (variables: InsertRecordWithIDVariables) => Promise<RecordUpdateResponse>;
         updateRecordWithID: (variables: UpdateRecordWithIDVariables) => Promise<RecordUpdateResponse>;
         upsertRecordWithID: (variables: UpsertRecordWithIDVariables) => Promise<RecordUpdateResponse>;
-        deleteRecord: (variables: DeleteRecordVariables) => Promise<undefined>;
+        deleteRecord: (variables: DeleteRecordVariables) => Promise<XataRecord$1>;
         getRecord: (variables: GetRecordVariables) => Promise<XataRecord$1>;
-        bulkInsertTableRecords: (variables: BulkInsertTableRecordsVariables) => Promise<BulkInsertTableRecordsResponse>;
+        bulkInsertTableRecords: (variables: BulkInsertTableRecordsVariables) => Promise<BulkInsertResponse>;
         queryTable: (variables: QueryTableVariables) => Promise<QueryResponse>;
+        searchTable: (variables: SearchTableVariables) => Promise<SearchResponse>;
         searchBranch: (variables: SearchBranchVariables) => Promise<SearchResponse>;
     };
 };
@@ -2472,6 +2896,9 @@ interface XataApiClientOptions {
     apiKey?: string;
     host?: HostProvider;
 }
+/**
+ * @deprecated Use XataApiPlugin instead
+ */
 declare class XataApiClient {
     #private;
     constructor(options?: XataApiClientOptions);
@@ -2504,6 +2931,7 @@ declare class WorkspaceApi {
     updateWorkspaceMemberRole(workspaceId: WorkspaceID, userId: UserID, role: Role): Promise<void>;
     removeWorkspaceMember(workspaceId: WorkspaceID, userId: UserID): Promise<void>;
     inviteWorkspaceMember(workspaceId: WorkspaceID, email: string, role: Role): Promise<WorkspaceInvite>;
+    updateWorkspaceMemberInvite(workspaceId: WorkspaceID, inviteId: InviteID, role: Role): Promise<WorkspaceInvite>;
     cancelWorkspaceMemberInvite(workspaceId: WorkspaceID, inviteId: InviteID): Promise<void>;
     resendWorkspaceMemberInvite(workspaceId: WorkspaceID, inviteId: InviteID): Promise<void>;
     acceptWorkspaceMemberInvite(workspaceId: WorkspaceID, inviteKey: InviteKey): Promise<void>;
@@ -2514,13 +2942,17 @@ declare class DatabaseApi {
     getDatabaseList(workspace: WorkspaceID): Promise<ListDatabasesResponse>;
     createDatabase(workspace: WorkspaceID, dbName: DBName, options?: CreateDatabaseRequestBody): Promise<CreateDatabaseResponse>;
     deleteDatabase(workspace: WorkspaceID, dbName: DBName): Promise<void>;
+    getGitBranchesMapping(workspace: WorkspaceID, dbName: DBName): Promise<ListGitBranchesResponse>;
+    addGitBranchesEntry(workspace: WorkspaceID, dbName: DBName, body: AddGitBranchesEntryRequestBody): Promise<AddGitBranchesEntryResponse>;
+    removeGitBranchesEntry(workspace: WorkspaceID, dbName: DBName, gitBranch: string): Promise<void>;
+    resolveBranch(workspace: WorkspaceID, dbName: DBName, gitBranch?: string, fallbackBranch?: string): Promise<ResolveBranchResponse>;
 }
 declare class BranchApi {
     private extraProps;
     constructor(extraProps: FetcherExtraProps);
     getBranchList(workspace: WorkspaceID, dbName: DBName): Promise<ListBranchesResponse>;
     getBranchDetails(workspace: WorkspaceID, database: DBName, branch: BranchName): Promise<DBBranch>;
-    createBranch(workspace: WorkspaceID, database: DBName, branch: BranchName, from?: string, options?: CreateBranchRequestBody): Promise<void>;
+    createBranch(workspace: WorkspaceID, database: DBName, branch: BranchName, from?: string, options?: CreateBranchRequestBody): Promise<CreateBranchResponse>;
     deleteBranch(workspace: WorkspaceID, database: DBName, branch: BranchName): Promise<void>;
     updateBranchMetadata(workspace: WorkspaceID, database: DBName, branch: BranchName, metadata?: BranchMetadata): Promise<void>;
     getBranchMetadata(workspace: WorkspaceID, database: DBName, branch: BranchName): Promise<BranchMetadata>;
@@ -2532,7 +2964,7 @@ declare class BranchApi {
 declare class TableApi {
     private extraProps;
     constructor(extraProps: FetcherExtraProps);
-    createTable(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName): Promise<void>;
+    createTable(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName): Promise<CreateTableResponse>;
     deleteTable(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName): Promise<void>;
     updateTable(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName, options: UpdateTableRequestBody): Promise<void>;
     getTableSchema(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName): Promise<GetTableSchemaResponse>;
@@ -2546,14 +2978,15 @@ declare class TableApi {
 declare class RecordsApi {
     private extraProps;
     constructor(extraProps: FetcherExtraProps);
-    insertRecord(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName, record: Record<string, any>): Promise<InsertRecordResponse>;
+    insertRecord(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName, record: Record<string, any>, options?: InsertRecordQueryParams): Promise<RecordUpdateResponse>;
     insertRecordWithID(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName, recordId: RecordID, record: Record<string, any>, options?: InsertRecordWithIDQueryParams): Promise<RecordUpdateResponse>;
     updateRecordWithID(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName, recordId: RecordID, record: Record<string, any>, options?: UpdateRecordWithIDQueryParams): Promise<RecordUpdateResponse>;
     upsertRecordWithID(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName, recordId: RecordID, record: Record<string, any>, options?: UpsertRecordWithIDQueryParams): Promise<RecordUpdateResponse>;
-    deleteRecord(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName, recordId: RecordID): Promise<void>;
-    getRecord(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName, recordId: RecordID, options?: GetRecordRequestBody): Promise<XataRecord$1>;
-    bulkInsertTableRecords(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName, records: Record<string, any>[]): Promise<BulkInsertTableRecordsResponse>;
+    deleteRecord(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName, recordId: RecordID, options?: DeleteRecordQueryParams): Promise<RecordUpdateResponse>;
+    getRecord(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName, recordId: RecordID, options?: GetRecordQueryParams): Promise<XataRecord$1>;
+    bulkInsertTableRecords(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName, records: Record<string, any>[], options?: BulkInsertTableRecordsQueryParams): Promise<BulkInsertResponse>;
     queryTable(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName, query: QueryTableRequestBody): Promise<QueryResponse>;
+    searchTable(workspace: WorkspaceID, database: DBName, branch: BranchName, tableName: TableName, query: SearchTableRequestBody): Promise<SearchResponse>;
     searchBranch(workspace: WorkspaceID, database: DBName, branch: BranchName, query: SearchBranchRequestBody): Promise<SearchResponse>;
 }
 
@@ -2567,28 +3000,29 @@ declare type UnionToIntersection<T> = (T extends any ? (x: T) => any : never) ex
 declare type If<Condition, Then, Else> = Condition extends true ? Then : Else;
 declare type IsObject<T> = T extends Record<string, any> ? true : false;
 declare type IsArray<T> = T extends Array<any> ? true : false;
-declare type NonEmptyArray<T> = T[] & {
-    0: T;
-};
 declare type RequiredBy<T, K extends keyof T> = T & {
     [P in K]-?: NonNullable<T[P]>;
 };
 declare type GetArrayInnerType<T extends readonly any[]> = T[number];
 declare type SingleOrArray<T> = T | T[];
-declare type Dictionary<T> = Record<string, T>;
+declare type OmitBy<T, K extends keyof T> = T extends any ? Omit<T, K> : never;
+declare type Without<T, U> = {
+    [P in Exclude<keyof T, keyof U>]?: never;
+};
+declare type ExclusiveOr<T, U> = T | U extends object ? (Without<T, U> & U) | (Without<U, T> & T) : T | U;
 
 declare type SelectableColumn<O, RecursivePath extends any[] = []> = '*' | 'id' | DataProps<O> | NestedColumns<O, RecursivePath>;
-declare type SelectedPick<O extends XataRecord, Key extends SelectableColumn<O>[]> = XataRecord & UnionToIntersection<Values<{
-    [K in Key[number]]: NestedValueAtColumn<O, K> & XataRecord;
+declare type SelectedPick<O extends XataRecord, Key extends SelectableColumn<O>[]> = XataRecord<O> & UnionToIntersection<Values<{
+    [K in Key[number]]: NestedValueAtColumn<O, K> & XataRecord<O>;
 }>>;
-declare type ValueAtColumn<O, P extends SelectableColumn<O>> = P extends '*' ? Values<O> : P extends 'id' ? string : P extends keyof O ? O[P] : P extends `${infer K}.${infer V}` ? K extends keyof O ? Values<O[K] extends XataRecord ? (V extends SelectableColumn<O[K]> ? {
-    V: ValueAtColumn<O[K], V>;
-} : never) : O[K]> : never : never;
+declare type ValueAtColumn<O, P extends SelectableColumn<O>> = P extends '*' ? Values<O> : P extends 'id' ? string : P extends keyof O ? O[P] : P extends `${infer K}.${infer V}` ? K extends keyof O ? Values<NonNullable<O[K]> extends infer Item ? Item extends Record<string, any> ? V extends SelectableColumn<Item> ? {
+    V: ValueAtColumn<Item, V>;
+} : never : O[K] : never> : never : never;
 declare type MAX_RECURSION = 5;
 declare type NestedColumns<O, RecursivePath extends any[]> = RecursivePath['length'] extends MAX_RECURSION ? never : If<IsObject<O>, Values<{
-    [K in DataProps<O>]: If<IsArray<NonNullable<O[K]>>, K, // If the property is an array, we stop recursion. We don't support object arrays yet
-    If<IsObject<NonNullable<O[K]>>, NonNullable<O[K]> extends XataRecord ? SelectableColumn<NonNullable<O[K]>, [...RecursivePath, O[K]]> extends string ? K | `${K}.${SelectableColumn<NonNullable<O[K]>, [...RecursivePath, O[K]]>}` : never : `${K}.${StringKeys<NonNullable<O[K]>> | '*'}`, // This allows usage of objects that are not links
-    K>>;
+    [K in DataProps<O>]: NonNullable<O[K]> extends infer Item ? If<IsArray<Item>, K, // If the property is an array, we stop recursion. We don't support object arrays yet
+    If<IsObject<Item>, Item extends XataRecord ? SelectableColumn<Item, [...RecursivePath, Item]> extends infer Column ? Column extends string ? K | `${K}.${Column}` : never : never : Item extends Date ? K : `${K}.${StringKeys<Item> | '*'}`, // This allows usage of objects that are not links
+    K>> : never;
 }>, never>;
 declare type DataProps<O> = Exclude<StringKeys<O>, StringKeys<XataRecord>>;
 declare type NestedValueAtColumn<O, Key extends SelectableColumn<O>> = Key extends `${infer N}.${infer M}` ? N extends DataProps<O> ? {
@@ -2615,27 +3049,37 @@ interface BaseData {
 /**
  * Represents a persisted record from the database.
  */
-interface XataRecord extends Identifiable {
+interface XataRecord<OriginalRecord extends XataRecord<any> = XataRecord<any>> extends Identifiable {
     /**
-     * Metadata of this record.
+     * Get metadata of this record.
      */
-    xata: {
-        /**
-         * Number that is increased every time the record is updated.
-         */
-        version: number;
-    };
+    getMetadata(): XataRecordMetadata;
     /**
      * Retrieves a refreshed copy of the current record from the database.
+     * @param columns The columns to retrieve. If not specified, all first level properties are retrieved.
+     * @returns The persisted record with the selected columns.
      */
-    read(): Promise<Readonly<SelectedPick<this, ['*']>> | null>;
+    read<K extends SelectableColumn<OriginalRecord>>(columns: K[]): Promise<Readonly<SelectedPick<OriginalRecord, typeof columns>> | null>;
+    /**
+     * Retrieves a refreshed copy of the current record from the database.
+     * @returns The persisted record with all first level properties.
+     */
+    read(): Promise<Readonly<SelectedPick<OriginalRecord, ['*']>> | null>;
     /**
      * Performs a partial update of the current record. On success a new object is
      * returned and the current object is not mutated.
-     * @param data The columns and their values that have to be updated.
-     * @returns A new record containing the latest values for all the columns of the current record.
+     * @param partialUpdate The columns and their values that have to be updated.
+     * @param columns The columns to retrieve. If not specified, all first level properties are retrieved.
+     * @returns The persisted record with the selected columns.
+     */
+    update<K extends SelectableColumn<OriginalRecord>>(partialUpdate: Partial<EditableData<Omit<OriginalRecord, keyof XataRecord>>>, columns: K[]): Promise<Readonly<SelectedPick<OriginalRecord, typeof columns>>>;
+    /**
+     * Performs a partial update of the current record. On success a new object is
+     * returned and the current object is not mutated.
+     * @param partialUpdate The columns and their values that have to be updated.
+     * @returns The persisted record with all first level properties.
      */
-    update(partialUpdate: Partial<EditableData<Omit<this, keyof XataRecord>>>): Promise<Readonly<SelectedPick<this, ['*']>>>;
+    update(partialUpdate: Partial<EditableData<Omit<OriginalRecord, keyof XataRecord>>>): Promise<Readonly<SelectedPick<OriginalRecord, ['*']>>>;
     /**
      * Performs a deletion of the current record in the database.
      *
@@ -2647,23 +3091,36 @@ declare type Link<Record extends XataRecord> = Omit<XataRecord, 'read' | 'update
     /**
      * Retrieves a refreshed copy of the current record from the database.
      */
-    read(): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
+    read<K extends SelectableColumn<Record>>(columns?: K[]): Promise<Readonly<SelectedPick<Record, typeof columns extends SelectableColumn<Record>[] ? typeof columns : ['*']>> | null>;
     /**
      * Performs a partial update of the current record. On success a new object is
      * returned and the current object is not mutated.
-     * @param data The columns and their values that have to be updated.
+     * @param partialUpdate The columns and their values that have to be updated.
      * @returns A new record containing the latest values for all the columns of the current record.
      */
-    update(partialUpdate: Partial<EditableData<Omit<Record, keyof XataRecord>>>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    update<K extends SelectableColumn<Record>>(partialUpdate: Partial<EditableData<Omit<Record, keyof XataRecord>>>, columns?: K[]): Promise<Readonly<SelectedPick<Record, typeof columns extends SelectableColumn<Record>[] ? typeof columns : ['*']>>>;
+    /**
+     * Performs a deletion of the current record in the database.
+     *
+     * @throws If the record was already deleted or if an error happened while performing the deletion.
+     */
+    delete(): Promise<void>;
+};
+declare type XataRecordMetadata = {
+    /**
+     * Number that is increased every time the record is updated.
+     */
+    version: number;
+    warnings?: string[];
 };
 declare function isIdentifiable(x: any): x is Identifiable & Record<string, unknown>;
 declare function isXataRecord(x: any): x is XataRecord & Record<string, unknown>;
 declare type EditableData<O extends BaseData> = {
     [K in keyof O]: O[K] extends XataRecord ? {
         id: string;
-    } : NonNullable<O[K]> extends XataRecord ? {
+    } | string : NonNullable<O[K]> extends XataRecord ? {
         id: string;
-    } | null | undefined : O[K];
+    } | string | null | undefined : O[K];
 };
 
 /**
@@ -2739,8 +3196,8 @@ declare type ValueTypeFilters<T> = T | T extends string ? StringTypeFilter : T e
     ],
 }
 */
-declare type AggregatorFilter<Record> = {
-    [key in '$all' | '$any' | '$not' | '$none']?: SingleOrArray<Filter<Record>>;
+declare type AggregatorFilter<T> = {
+    [key in '$all' | '$any' | '$not' | '$none']?: SingleOrArray<Filter<T>>;
 };
 /**
  * Existance filter
@@ -2755,10 +3212,88 @@ declare type BaseApiFilter<Record> = PropertyAccessFilter<Record> | AggregatorFi
  * Injects the Api filters on nested properties
  * Example: { filter: { settings: { plan: { $any: ['free', 'trial'] } } } }
  */
-declare type NestedApiFilter<T> = T extends Record<string, any> ? {
+declare type NestedApiFilter<T> = {
     [key in keyof T]?: T[key] extends Record<string, any> ? SingleOrArray<Filter<T[key]>> : PropertyFilter<T[key]>;
-} : PropertyFilter<T>;
-declare type Filter<Record> = BaseApiFilter<Record> | NestedApiFilter<Record>;
+};
+declare type Filter<T> = T extends Record<string, any> ? BaseApiFilter<T> | NestedApiFilter<T> : PropertyFilter<T>;
+
+declare type DateBooster = {
+    origin?: string;
+    scale: string;
+    decay: number;
+};
+declare type NumericBooster = {
+    factor: number;
+};
+declare type ValueBooster<T extends string | number | boolean> = {
+    value: T;
+    factor: number;
+};
+declare type Boosters<O extends XataRecord> = Values<{
+    [K in SelectableColumn<O>]: NonNullable<ValueAtColumn<O, K>> extends Date ? {
+        dateBooster: {
+            column: K;
+        } & DateBooster;
+    } : NonNullable<ValueAtColumn<O, K>> extends number ? ExclusiveOr<{
+        numericBooster?: {
+            column: K;
+        } & NumericBooster;
+    }, {
+        valueBooster?: {
+            column: K;
+        } & ValueBooster<number>;
+    }> : NonNullable<ValueAtColumn<O, K>> extends string | boolean ? {
+        valueBooster: {
+            column: K;
+        } & ValueBooster<NonNullable<ValueAtColumn<O, K>>>;
+    } : never;
+}>;
+
+declare type SearchOptions<Schemas extends Record<string, BaseData>, Tables extends StringKeys<Schemas>> = {
+    fuzziness?: FuzzinessExpression;
+    prefix?: PrefixExpression;
+    highlight?: HighlightExpression;
+    tables?: Array<Tables | Values<{
+        [Model in GetArrayInnerType<NonNullable<Tables[]>>]: {
+            table: Model;
+            filter?: Filter<SelectedPick<Schemas[Model] & XataRecord, ['*']>>;
+            boosters?: Boosters<Schemas[Model] & XataRecord>[];
+        };
+    }>>;
+};
+declare type SearchPluginResult<Schemas extends Record<string, BaseData>> = {
+    all: <Tables extends StringKeys<Schemas>>(query: string, options?: SearchOptions<Schemas, Tables>) => Promise<Values<{
+        [Model in ExtractTables<Schemas, Tables, GetArrayInnerType<NonNullable<NonNullable<typeof options>['tables']>>>]: {
+            table: Model;
+            record: Awaited<SearchXataRecord<SelectedPick<Schemas[Model] & XataRecord, ['*']>>>;
+        };
+    }>[]>;
+    byTable: <Tables extends StringKeys<Schemas>>(query: string, options?: SearchOptions<Schemas, Tables>) => Promise<{
+        [Model in ExtractTables<Schemas, Tables, GetArrayInnerType<NonNullable<NonNullable<typeof options>['tables']>>>]?: Awaited<SearchXataRecord<SelectedPick<Schemas[Model] & XataRecord, ['*']>>[]>;
+    }>;
+};
+declare class SearchPlugin<Schemas extends Record<string, BaseData>> extends XataPlugin {
+    #private;
+    private db;
+    constructor(db: SchemaPluginResult<Schemas>, schemaTables?: Schemas.Table[]);
+    build({ getFetchProps }: XataPluginOptions): SearchPluginResult<Schemas>;
+}
+declare type SearchXataRecord<Record extends XataRecord> = Omit<Record, 'getMetadata'> & {
+    getMetadata: () => XataRecordMetadata & SearchExtraProperties;
+};
+declare type SearchExtraProperties = {
+    table: string;
+    highlight?: {
+        [key: string]: string[] | {
+            [key: string]: any;
+        };
+    };
+    score?: number;
+};
+declare type ReturnTable<Table, Tables> = Table extends Tables ? Table : never;
+declare type ExtractTables<Schemas extends Record<string, BaseData>, Tables extends StringKeys<Schemas>, TableOptions extends GetArrayInnerType<NonNullable<NonNullable<SearchOptions<Schemas, Tables>>['tables']>>> = TableOptions extends `${infer Table}` ? ReturnTable<Table, Tables> : TableOptions extends {
+    table: infer Table;
+} ? ReturnTable<Table, Tables> : never;
 
 declare type SortDirection = 'asc' | 'desc';
 declare type SortFilterExtended<T extends XataRecord> = {
@@ -2770,12 +3305,21 @@ declare type SortFilterBase<T extends XataRecord> = {
     [Key in StringKeys<T>]: SortDirection;
 };
 
-declare type QueryOptions<T extends XataRecord> = {
-    page?: PaginationOptions;
-    columns?: NonEmptyArray<SelectableColumn<T>>;
+declare type BaseOptions<T extends XataRecord> = {
+    columns?: SelectableColumn<T>[];
+    cache?: number;
+};
+declare type CursorQueryOptions = {
+    pagination?: CursorNavigationOptions & OffsetNavigationOptions;
+    filter?: never;
+    sort?: never;
+};
+declare type OffsetQueryOptions<T extends XataRecord> = {
+    pagination?: OffsetNavigationOptions;
     filter?: FilterExpression;
     sort?: SortFilter<T> | SortFilter<T>[];
 };
+declare type QueryOptions<T extends XataRecord> = BaseOptions<T> & (CursorQueryOptions | OffsetQueryOptions<T>);
 /**
  * Query objects contain the information of all filters, sorting, etc. to be included in the database query.
  *
@@ -2785,9 +3329,10 @@ declare type QueryOptions<T extends XataRecord> = {
 declare class Query<Record extends XataRecord, Result extends XataRecord = Record> implements Paginable<Record, Result> {
     #private;
     readonly meta: PaginationQueryMeta;
-    readonly records: Result[];
-    constructor(repository: Repository<Record> | null, table: string, data: Partial<QueryOptions<Record>>, parent?: Partial<QueryOptions<Record>>);
+    readonly records: RecordArray<Result>;
+    constructor(repository: Repository<Record> | null, table: string, data: Partial<QueryOptions<Record>>, rawParent?: Partial<QueryOptions<Record>>);
     getQueryOptions(): QueryOptions<Record>;
+    key(): string;
     /**
      * Builds a new query object representing a logical OR between the given subqueries.
      * @param queries An array of subqueries.
@@ -2817,18 +3362,28 @@ declare class Query<Record extends XataRecord, Result extends XataRecord = Recor
      *
      * ```
      * query.filter("columnName", columnValue)
-     * query.filter({
-     *   "columnName": columnValue
-     * })
+     * query.filter("columnName", operator(columnValue)) // Use gt, gte, lt, lte, startsWith,...
+     * ```
+     *
+     * @param column The name of the column to filter.
+     * @param value The value to filter.
+     * @returns A new Query object.
+     */
+    filter<F extends SelectableColumn<Record>>(column: F, value: Filter<ValueAtColumn<Record, F>>): Query<Record, Result>;
+    /**
+     * Builds a new query object adding one or more constraints. Examples:
+     *
+     * ```
+     * query.filter({ "columnName": columnValue })
      * query.filter({
      *   "columnName": operator(columnValue) // Use gt, gte, lt, lte, startsWith,...
      * })
      * ```
      *
+     * @param filters A filter object
      * @returns A new Query object.
      */
     filter(filters: Filter<Record>): Query<Record, Result>;
-    filter<F extends SelectableColumn<Record>>(column: F, value: Filter<ValueAtColumn<Record, F>>): Query<Record, Result>;
     /**
      * Builds a new query with a new sort option.
      * @param column The column name.
@@ -2841,43 +3396,149 @@ declare class Query<Record extends XataRecord, Result extends XataRecord = Recor
      * @param columns Array of column names to be returned by the query.
      * @returns A new Query object.
      */
-    select<K extends SelectableColumn<Record>>(columns: NonEmptyArray<K>): Query<Record, SelectedPick<Record, NonEmptyArray<K>>>;
+    select<K extends SelectableColumn<Record>>(columns: K[]): Query<Record, SelectedPick<Record, K[]>>;
+    /**
+     * Get paginated results
+     *
+     * @returns A page of results
+     */
     getPaginated(): Promise<Page<Record, Result>>;
-    getPaginated(options: Omit<QueryOptions<Record>, 'columns'>): Promise<Page<Record, Result>>;
+    /**
+     * Get paginated results
+     *
+     * @param options Pagination options
+     * @returns A page of results
+     */
+    getPaginated(options: OmitBy<QueryOptions<Record>, 'columns'>): Promise<Page<Record, Result>>;
+    /**
+     * Get paginated results
+     *
+     * @param options Pagination options
+     * @returns A page of results
+     */
     getPaginated<Options extends RequiredBy<QueryOptions<Record>, 'columns'>>(options: Options): Promise<Page<Record, SelectedPick<Record, typeof options['columns']>>>;
+    /**
+     * Get results in an iterator
+     *
+     * @async
+     * @returns Async interable of results
+     */
     [Symbol.asyncIterator](): AsyncIterableIterator<Result>;
-    getIterator(chunk: number): AsyncGenerator<Result[]>;
-    getIterator(chunk: number, options: Omit<QueryOptions<Record>, 'columns' | 'page'>): AsyncGenerator<Result[]>;
-    getIterator<Options extends RequiredBy<Omit<QueryOptions<Record>, 'page'>, 'columns'>>(chunk: number, options: Options): AsyncGenerator<SelectedPick<Record, typeof options['columns']>[]>;
+    /**
+     * Build an iterator of results
+     *
+     * @returns Async generator of results array
+     */
+    getIterator(): AsyncGenerator<Result[]>;
+    /**
+     * Build an iterator of results
+     *
+     * @param options Pagination options with batchSize
+     * @returns Async generator of results array
+     */
+    getIterator(options: OmitBy<QueryOptions<Record>, 'columns' | 'pagination'> & {
+        batchSize?: number;
+    }): AsyncGenerator<Result[]>;
+    /**
+     * Build an iterator of results
+     *
+     * @param options Pagination options with batchSize
+     * @returns Async generator of results array
+     */
+    getIterator<Options extends RequiredBy<OmitBy<QueryOptions<Record>, 'pagination'>, 'columns'> & {
+        batchSize?: number;
+    }>(options: Options): AsyncGenerator<SelectedPick<Record, typeof options['columns']>[]>;
+    /**
+     * Performs the query in the database and returns a set of results.
+     * @returns An array of records from the database.
+     */
+    getMany(): Promise<RecordArray<Result>>;
     /**
      * Performs the query in the database and returns a set of results.
      * @param options Additional options to be used when performing the query.
      * @returns An array of records from the database.
      */
-    getMany(): Promise<Result[]>;
-    getMany(options: Omit<QueryOptions<Record>, 'columns'>): Promise<Result[]>;
-    getMany<Options extends RequiredBy<QueryOptions<Record>, 'columns'>>(options: Options): Promise<SelectedPick<Record, typeof options['columns']>[]>;
+    getMany<Options extends RequiredBy<QueryOptions<Record>, 'columns'>>(options: Options): Promise<RecordArray<SelectedPick<Record, typeof options['columns']>>>;
+    /**
+     * Performs the query in the database and returns a set of results.
+     * @param options Additional options to be used when performing the query.
+     * @returns An array of records from the database.
+     */
+    getMany(options: OmitBy<QueryOptions<Record>, 'columns'>): Promise<RecordArray<Result>>;
+    /**
+     * Performs the query in the database and returns all the results.
+     * Warning: If there are a large number of results, this method can have performance implications.
+     * @returns An array of records from the database.
+     */
+    getAll(): Promise<Result[]>;
     /**
      * Performs the query in the database and returns all the results.
      * Warning: If there are a large number of results, this method can have performance implications.
      * @param options Additional options to be used when performing the query.
      * @returns An array of records from the database.
      */
-    getAll(chunk?: number): Promise<Result[]>;
-    getAll(chunk: number | undefined, options: Omit<QueryOptions<Record>, 'columns' | 'page'>): Promise<Result[]>;
-    getAll<Options extends RequiredBy<Omit<QueryOptions<Record>, 'page'>, 'columns'>>(chunk: number | undefined, options: Options): Promise<SelectedPick<Record, typeof options['columns']>[]>;
+    getAll<Options extends RequiredBy<OmitBy<QueryOptions<Record>, 'pagination'>, 'columns'> & {
+        batchSize?: number;
+    }>(options: Options): Promise<SelectedPick<Record, typeof options['columns']>[]>;
+    /**
+     * Performs the query in the database and returns all the results.
+     * Warning: If there are a large number of results, this method can have performance implications.
+     * @param options Additional options to be used when performing the query.
+     * @returns An array of records from the database.
+     */
+    getAll(options: OmitBy<QueryOptions<Record>, 'columns' | 'pagination'> & {
+        batchSize?: number;
+    }): Promise<Result[]>;
+    /**
+     * Performs the query in the database and returns the first result.
+     * @returns The first record that matches the query, or null if no record matched the query.
+     */
+    getFirst(): Promise<Result | null>;
+    /**
+     * Performs the query in the database and returns the first result.
+     * @param options Additional options to be used when performing the query.
+     * @returns The first record that matches the query, or null if no record matched the query.
+     */
+    getFirst<Options extends RequiredBy<OmitBy<QueryOptions<Record>, 'pagination'>, 'columns'>>(options: Options): Promise<SelectedPick<Record, typeof options['columns']> | null>;
     /**
      * Performs the query in the database and returns the first result.
      * @param options Additional options to be used when performing the query.
      * @returns The first record that matches the query, or null if no record matched the query.
      */
-    getOne(): Promise<Result | null>;
-    getOne(options: Omit<QueryOptions<Record>, 'columns' | 'page'>): Promise<Result | null>;
-    getOne<Options extends RequiredBy<Omit<QueryOptions<Record>, 'page'>, 'columns'>>(options: Options): Promise<SelectedPick<Record, typeof options['columns']> | null>;
+    getFirst(options: OmitBy<QueryOptions<Record>, 'columns' | 'pagination'>): Promise<Result | null>;
+    /**
+     * Builds a new query object adding a cache TTL in milliseconds.
+     * @param ttl The cache TTL in milliseconds.
+     * @returns A new Query object.
+     */
+    cache(ttl: number): Query<Record, Result>;
+    /**
+     * Retrieve next page of records
+     *
+     * @returns A new page object.
+     */
     nextPage(size?: number, offset?: number): Promise<Page<Record, Result>>;
+    /**
+     * Retrieve previous page of records
+     *
+     * @returns A new page object
+     */
     previousPage(size?: number, offset?: number): Promise<Page<Record, Result>>;
+    /**
+     * Retrieve first page of records
+     *
+     * @returns A new page object
+     */
     firstPage(size?: number, offset?: number): Promise<Page<Record, Result>>;
+    /**
+     * Retrieve last page of records
+     *
+     * @returns A new page object
+     */
     lastPage(size?: number, offset?: number): Promise<Page<Record, Result>>;
+    /**
+     * @returns Boolean indicating if there is a next page
+     */
     hasNextPage(): boolean;
 }
 
@@ -2889,7 +3550,7 @@ declare type PaginationQueryMeta = {
 };
 interface Paginable<Record extends XataRecord, Result extends XataRecord = Record> {
     meta: PaginationQueryMeta;
-    records: Result[];
+    records: RecordArray<Result>;
     nextPage(size?: number, offset?: number): Promise<Page<Record, Result>>;
     previousPage(size?: number, offset?: number): Promise<Page<Record, Result>>;
     firstPage(size?: number, offset?: number): Promise<Page<Record, Result>>;
@@ -2909,7 +3570,7 @@ declare class Page<Record extends XataRecord, Result extends XataRecord = Record
     /**
      * The set of results for this page.
      */
-    readonly records: Result[];
+    readonly records: RecordArray<Result>;
     constructor(query: Query<Record, Result>, meta: PaginationQueryMeta, records?: Result[]);
     /**
      * Retrieves the next page of results.
@@ -2957,44 +3618,154 @@ declare type OffsetNavigationOptions = {
     size?: number;
     offset?: number;
 };
-declare type PaginationOptions = CursorNavigationOptions & OffsetNavigationOptions;
 declare const PAGINATION_MAX_SIZE = 200;
-declare const PAGINATION_DEFAULT_SIZE = 200;
+declare const PAGINATION_DEFAULT_SIZE = 20;
 declare const PAGINATION_MAX_OFFSET = 800;
 declare const PAGINATION_DEFAULT_OFFSET = 0;
+declare function isCursorPaginationOptions(options: Record<string, unknown> | undefined | null): options is CursorNavigationOptions;
+declare class RecordArray<Result extends XataRecord> extends Array<Result> {
+    #private;
+    constructor(page: Paginable<any, Result>, overrideRecords?: Result[]);
+    static parseConstructorParams(...args: any[]): any[];
+    toArray(): Result[];
+    map<U>(callbackfn: (value: Result, index: number, array: Result[]) => U, thisArg?: any): U[];
+    /**
+     * Retrieve next page of records
+     *
+     * @returns A new array of objects
+     */
+    nextPage(size?: number, offset?: number): Promise<RecordArray<Result>>;
+    /**
+     * Retrieve previous page of records
+     *
+     * @returns A new array of objects
+     */
+    previousPage(size?: number, offset?: number): Promise<RecordArray<Result>>;
+    /**
+     * Retrieve first page of records
+     *
+     * @returns A new array of objects
+     */
+    firstPage(size?: number, offset?: number): Promise<RecordArray<Result>>;
+    /**
+     * Retrieve last page of records
+     *
+     * @returns A new array of objects
+     */
+    lastPage(size?: number, offset?: number): Promise<RecordArray<Result>>;
+    /**
+     * @returns Boolean indicating if there is a next page
+     */
+    hasNextPage(): boolean;
+}
 
-declare type TableLink = string[];
-declare type LinkDictionary = Dictionary<TableLink[]>;
 /**
  * Common interface for performing operations on a table.
  */
 declare abstract class Repository<Data extends BaseData, Record extends XataRecord = Data & XataRecord> extends Query<Record, Readonly<SelectedPick<Record, ['*']>>> {
-    abstract create(object: EditableData<Data> & Partial<Identifiable>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    abstract create<K extends SelectableColumn<Record>>(object: Omit<EditableData<Data>, 'id'> & Partial<Identifiable>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    abstract create(object: Omit<EditableData<Data>, 'id'> & Partial<Identifiable>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    /**
+     * Creates a single record in the table with a unique id.
+     * @param id The unique id.
+     * @param object Object containing the column names with their values to be stored in the table.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns The full persisted record.
+     */
+    abstract create<K extends SelectableColumn<Record>>(id: string, object: Omit<EditableData<Data>, 'id'>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
      * Creates a single record in the table with a unique id.
      * @param id The unique id.
      * @param object Object containing the column names with their values to be stored in the table.
      * @returns The full persisted record.
      */
-    abstract create(id: string, object: EditableData<Data>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    abstract create(id: string, object: Omit<EditableData<Data>, 'id'>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     /**
      * Creates multiple records in the table.
      * @param objects Array of objects with the column names and the values to be stored in the table.
-     * @returns Array of the persisted records.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns Array of the persisted records in order.
+     */
+    abstract create<K extends SelectableColumn<Record>>(objects: Array<Omit<EditableData<Data>, 'id'> & Partial<Identifiable>>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
+    /**
+     * Creates multiple records in the table.
+     * @param objects Array of objects with the column names and the values to be stored in the table.
+     * @returns Array of the persisted records in order.
      */
-    abstract create(objects: Array<EditableData<Data> & Partial<Identifiable>>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
+    abstract create(objects: Array<Omit<EditableData<Data>, 'id'> & Partial<Identifiable>>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
+    /**
+     * Queries a single record from the table given its unique id.
+     * @param id The unique id.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns The persisted record for the given id or null if the record could not be found.
+     */
+    abstract read<K extends SelectableColumn<Record>>(id: string, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns> | null>>;
     /**
      * Queries a single record from the table given its unique id.
      * @param id The unique id.
      * @returns The persisted record for the given id or null if the record could not be found.
      */
     abstract read(id: string): Promise<Readonly<SelectedPick<Record, ['*']> | null>>;
+    /**
+     * Queries multiple records from the table given their unique id.
+     * @param ids The unique ids array.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns The persisted records for the given ids in order (if a record could not be found null is returned).
+     */
+    abstract read<K extends SelectableColumn<Record>>(ids: string[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
+    /**
+     * Queries multiple records from the table given their unique id.
+     * @param ids The unique ids array.
+     * @returns The persisted records for the given ids in order (if a record could not be found null is returned).
+     */
+    abstract read(ids: string[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
+    /**
+     * Queries a single record from the table by the id in the object.
+     * @param object Object containing the id of the record.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns The persisted record for the given id or null if the record could not be found.
+     */
+    abstract read<K extends SelectableColumn<Record>>(object: Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns> | null>>;
+    /**
+     * Queries a single record from the table by the id in the object.
+     * @param object Object containing the id of the record.
+     * @returns The persisted record for the given id or null if the record could not be found.
+     */
+    abstract read(object: Identifiable): Promise<Readonly<SelectedPick<Record, ['*']> | null>>;
+    /**
+     * Queries multiple records from the table by the ids in the objects.
+     * @param objects Array of objects containing the ids of the records.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns The persisted records for the given ids in order (if a record could not be found null is returned).
+     */
+    abstract read<K extends SelectableColumn<Record>>(objects: Identifiable[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
+    /**
+     * Queries multiple records from the table by the ids in the objects.
+     * @param objects Array of objects containing the ids of the records.
+     * @returns The persisted records for the given ids in order (if a record could not be found null is returned).
+     */
+    abstract read(objects: Identifiable[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
+    /**
+     * Partially update a single record.
+     * @param object An object with its id and the columns to be updated.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns The full persisted record.
+     */
+    abstract update<K extends SelectableColumn<Record>>(object: Partial<EditableData<Data>> & Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
      * Partially update a single record.
      * @param object An object with its id and the columns to be updated.
      * @returns The full persisted record.
      */
     abstract update(object: Partial<EditableData<Data>> & Identifiable): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    /**
+     * Partially update a single record given its unique id.
+     * @param id The unique id.
+     * @param object The column names and their values that have to be updated.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns The full persisted record.
+     */
+    abstract update<K extends SelectableColumn<Record>>(id: string, object: Partial<EditableData<Data>>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
      * Partially update a single record given its unique id.
      * @param id The unique id.
@@ -3005,9 +3776,24 @@ declare abstract class Repository<Data extends BaseData, Record extends XataReco
     /**
      * Partially updates multiple records.
      * @param objects An array of objects with their ids and columns to be updated.
-     * @returns Array of the persisted records.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns Array of the persisted records in order.
+     */
+    abstract update<K extends SelectableColumn<Record>>(objects: Array<Partial<EditableData<Data>> & Identifiable>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
+    /**
+     * Partially updates multiple records.
+     * @param objects An array of objects with their ids and columns to be updated.
+     * @returns Array of the persisted records in order.
      */
     abstract update(objects: Array<Partial<EditableData<Data>> & Identifiable>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
+    /**
+     * Creates or updates a single record. If a record exists with the given id,
+     * it will be update, otherwise a new record will be created.
+     * @param object Object containing the column names with their values to be persisted in the table.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns The full persisted record.
+     */
+    abstract createOrUpdate<K extends SelectableColumn<Record>>(object: EditableData<Data> & Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
      * Creates or updates a single record. If a record exists with the given id,
      * it will be update, otherwise a new record will be created.
@@ -3015,6 +3801,15 @@ declare abstract class Repository<Data extends BaseData, Record extends XataReco
      * @returns The full persisted record.
      */
     abstract createOrUpdate(object: EditableData<Data> & Identifiable): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    /**
+     * Creates or updates a single record. If a record exists with the given id,
+     * it will be update, otherwise a new record will be created.
+     * @param id A unique id.
+     * @param object The column names and the values to be persisted.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns The full persisted record.
+     */
+    abstract createOrUpdate<K extends SelectableColumn<Record>>(id: string, object: Omit<EditableData<Data>, 'id'>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
      * Creates or updates a single record. If a record exists with the given id,
      * it will be update, otherwise a new record will be created.
@@ -3022,7 +3817,15 @@ declare abstract class Repository<Data extends BaseData, Record extends XataReco
      * @param object The column names and the values to be persisted.
      * @returns The full persisted record.
      */
-    abstract createOrUpdate(id: string, object: EditableData<Data>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    abstract createOrUpdate(id: string, object: Omit<EditableData<Data>, 'id'>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    /**
+     * Creates or updates a single record. If a record exists with the given id,
+     * it will be update, otherwise a new record will be created.
+     * @param objects Array of objects with the column names and the values to be stored in the table.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns Array of the persisted records.
+     */
+    abstract createOrUpdate<K extends SelectableColumn<Record>>(objects: Array<EditableData<Data> & Identifiable>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
     /**
      * Creates or updates a single record. If a record exists with the given id,
      * it will be update, otherwise a new record will be created.
@@ -3061,8 +3864,12 @@ declare abstract class Repository<Data extends BaseData, Record extends XataReco
      * @returns The found records.
      */
     abstract search(query: string, options?: {
-        fuzziness?: number;
-    }): Promise<SelectedPick<Record, ['*']>[]>;
+        fuzziness?: FuzzinessExpression;
+        prefix?: PrefixExpression;
+        highlight?: HighlightExpression;
+        filter?: Filter<Record>;
+        boosters?: Boosters<Record>[];
+    }): Promise<SearchXataRecord<SelectedPick<Record, ['*']>>[]>;
     abstract query<Result extends XataRecord>(query: Query<Record, Result>): Promise<Page<Record, Result>>;
 }
 declare class RestRepository<Data extends BaseData, Record extends XataRecord = Data & XataRecord> extends Query<Record, SelectedPick<Record, ['*']>> implements Repository<Data, Record> {
@@ -3070,27 +3877,100 @@ declare class RestRepository<Data extends BaseData, Record extends XataRecord =
     db: SchemaPluginResult<any>;
     constructor(options: {
         table: string;
-        links?: LinkDictionary;
-        getFetchProps: () => Promise<FetcherExtraProps>;
         db: SchemaPluginResult<any>;
+        pluginOptions: XataPluginOptions;
+        schemaTables?: Table[];
     });
-    create(object: EditableData<Data>): Promise<SelectedPick<Record, ['*']>>;
-    create(recordId: string, object: EditableData<Data>): Promise<SelectedPick<Record, ['*']>>;
-    create(objects: EditableData<Data>[]): Promise<SelectedPick<Record, ['*']>[]>;
-    read(recordId: string): Promise<SelectedPick<Record, ['*']> | null>;
+    create(object: EditableData<Data>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    create(recordId: string, object: EditableData<Data>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    create(objects: EditableData<Data>[]): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
+    create<K extends SelectableColumn<Record>>(object: EditableData<Data>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    create<K extends SelectableColumn<Record>>(recordId: string, object: EditableData<Data>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    create<K extends SelectableColumn<Record>>(objects: EditableData<Data>[], columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
+    read(recordId: string): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
+    read(recordIds: string[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>>>>;
+    read(object: Identifiable): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
+    read(objects: Identifiable[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>>>>;
+    read<K extends SelectableColumn<Record>>(recordId: string, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
+    read<K extends SelectableColumn<Record>>(recordIds: string[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>>>>;
+    read<K extends SelectableColumn<Record>>(object: Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
+    read<K extends SelectableColumn<Record>>(objects: Identifiable[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>>>>;
     update(object: Partial<EditableData<Data>> & Identifiable): Promise<SelectedPick<Record, ['*']>>;
     update(recordId: string, object: Partial<EditableData<Data>>): Promise<SelectedPick<Record, ['*']>>;
     update(objects: Array<Partial<EditableData<Data>> & Identifiable>): Promise<SelectedPick<Record, ['*']>[]>;
+    update<K extends SelectableColumn<Record>>(object: Partial<EditableData<Data>> & Identifiable, columns: K[]): Promise<SelectedPick<Record, typeof columns>>;
+    update<K extends SelectableColumn<Record>>(recordId: string, object: Partial<EditableData<Data>>, columns: K[]): Promise<SelectedPick<Record, typeof columns>>;
+    update<K extends SelectableColumn<Record>>(objects: Array<Partial<EditableData<Data>> & Identifiable>, columns: K[]): Promise<SelectedPick<Record, typeof columns>[]>;
     createOrUpdate(object: EditableData<Data>): Promise<SelectedPick<Record, ['*']>>;
     createOrUpdate(recordId: string, object: EditableData<Data>): Promise<SelectedPick<Record, ['*']>>;
     createOrUpdate(objects: EditableData<Data>[]): Promise<SelectedPick<Record, ['*']>[]>;
-    delete(recordId: string | Identifiable | Array<string | Identifiable>): Promise<void>;
+    createOrUpdate<K extends SelectableColumn<Record>>(object: EditableData<Data>, columns: K[]): Promise<SelectedPick<Record, typeof columns>>;
+    createOrUpdate<K extends SelectableColumn<Record>>(recordId: string, object: EditableData<Data>, columns: K[]): Promise<SelectedPick<Record, typeof columns>>;
+    createOrUpdate<K extends SelectableColumn<Record>>(objects: EditableData<Data>[], columns: K[]): Promise<SelectedPick<Record, typeof columns>[]>;
+    delete(a: string | Identifiable | Array<string | Identifiable>): Promise<void>;
     search(query: string, options?: {
-        fuzziness?: number;
-    }): Promise<SelectedPick<Record, ['*']>[]>;
+        fuzziness?: FuzzinessExpression;
+        prefix?: PrefixExpression;
+        highlight?: HighlightExpression;
+        filter?: Filter<Record>;
+        boosters?: Boosters<Record>[];
+    }): Promise<any>;
     query<Result extends XataRecord>(query: Query<Record, Result>): Promise<Page<Record, Result>>;
 }
 
+declare type BaseSchema = {
+    name: string;
+    columns: readonly ({
+        name: string;
+        type: Column['type'];
+    } | {
+        name: string;
+        type: 'link';
+        link: {
+            table: string;
+        };
+    } | {
+        name: string;
+        type: 'object';
+        columns: {
+            name: string;
+            type: string;
+        }[];
+    })[];
+};
+declare type SchemaInference<T extends readonly BaseSchema[]> = T extends never[] ? Record<string, Record<string, any>> : T extends readonly unknown[] ? T[number] extends {
+    name: string;
+    columns: readonly unknown[];
+} ? {
+    [K in T[number]['name']]: TableType<T[number], K>;
+} : never : never;
+declare type TableType<Tables, TableName> = Tables & {
+    name: TableName;
+} extends infer Table ? Table extends {
+    name: string;
+    columns: infer Columns;
+} ? Columns extends readonly unknown[] ? Columns[number] extends {
+    name: string;
+    type: string;
+} ? Identifiable & {
+    [K in Columns[number]['name']]?: PropertyType<Tables, Columns[number], K>;
+} : never : never : never : never;
+declare type PropertyType<Tables, Properties, PropertyName> = Properties & {
+    name: PropertyName;
+} extends infer Property ? Property extends {
+    name: string;
+    type: infer Type;
+    link?: {
+        table: infer LinkedTable;
+    };
+    columns?: infer ObjectColumns;
+} ? (Type extends 'string' | 'text' | 'email' ? string : Type extends 'int' | 'float' ? number : Type extends 'bool' ? boolean : Type extends 'datetime' ? Date : Type extends 'multiple' ? string[] : Type extends 'object' ? ObjectColumns extends readonly unknown[] ? ObjectColumns[number] extends {
+    name: string;
+    type: string;
+} ? {
+    [K in ObjectColumns[number]['name']]?: PropertyType<Tables, ObjectColumns[number], K>;
+} : never : never : Type extends 'link' ? TableType<Tables, LinkedTable> & XataRecord : never) | null : never : never;
+
 /**
  * Operator to restrict results to only values that are greater than the given value.
  */
@@ -3166,46 +4046,17 @@ declare const includesAny: <T>(value: T) => ArrayFilter<T>;
 
 declare type SchemaDefinition = {
     table: string;
-    links?: LinkDictionary;
 };
 declare type SchemaPluginResult<Schemas extends Record<string, BaseData>> = {
     [Key in keyof Schemas]: Repository<Schemas[Key]>;
+} & {
+    [key: string]: Repository<XataRecord$1>;
 };
 declare class SchemaPlugin<Schemas extends Record<string, BaseData>> extends XataPlugin {
     #private;
-    private links?;
-    private tableNames?;
-    constructor(links?: LinkDictionary | undefined, tableNames?: string[] | undefined);
-    build(options: XataPluginOptions): SchemaPluginResult<Schemas>;
-}
-
-declare type SearchOptions<Schemas extends Record<string, BaseData>, Tables extends StringKeys<Schemas>> = {
-    fuzziness?: number;
-    tables?: Tables[];
-};
-declare type SearchPluginResult<Schemas extends Record<string, BaseData>> = {
-    all: <Tables extends StringKeys<Schemas>>(query: string, options?: SearchOptions<Schemas, Tables>) => Promise<Values<{
-        [Model in GetArrayInnerType<NonNullable<NonNullable<typeof options>['tables']>>]: {
-            table: Model;
-            record: Awaited<SelectedPick<Schemas[Model] & SearchXataRecord, ['*']>>;
-        };
-    }>[]>;
-    byTable: <Tables extends StringKeys<Schemas>>(query: string, options?: SearchOptions<Schemas, Tables>) => Promise<{
-        [Model in GetArrayInnerType<NonNullable<NonNullable<typeof options>['tables']>>]?: Awaited<SelectedPick<Schemas[Model] & SearchXataRecord, ['*']>[]>;
-    }>;
-};
-declare class SearchPlugin<Schemas extends Record<string, BaseData>> extends XataPlugin {
-    #private;
-    private db;
-    private links;
-    constructor(db: SchemaPluginResult<Schemas>, links: LinkDictionary);
-    build({ getFetchProps }: XataPluginOptions): SearchPluginResult<Schemas>;
+    constructor(schemaTables?: Schemas.Table[]);
+    build(pluginOptions: XataPluginOptions): SchemaPluginResult<Schemas>;
 }
-declare type SearchXataRecord = XataRecord & {
-    xata: {
-        table: string;
-    };
-};
 
 declare type BranchStrategyValue = string | undefined | null;
 declare type BranchStrategyBuilder = () => BranchStrategyValue | Promise<BranchStrategyValue>;
@@ -3217,18 +4068,19 @@ declare type BaseClientOptions = {
     apiKey?: string;
     databaseURL?: string;
     branch?: BranchStrategyOption;
+    cache?: CacheImpl;
 };
 declare const buildClient: <Plugins extends Record<string, XataPlugin> = {}>(plugins?: Plugins | undefined) => ClientConstructor<Plugins>;
 interface ClientConstructor<Plugins extends Record<string, XataPlugin>> {
-    new <Schemas extends Record<string, BaseData>>(options?: Partial<BaseClientOptions>, links?: LinkDictionary): Omit<{
-        db: Awaited<ReturnType<SchemaPlugin<Schemas>['build']>>;
-        search: Awaited<ReturnType<SearchPlugin<Schemas>['build']>>;
+    new <T extends readonly BaseSchema[]>(options?: Partial<BaseClientOptions>, schemaTables?: T): Omit<{
+        db: Awaited<ReturnType<SchemaPlugin<SchemaInference<NonNullable<typeof schemaTables>>>['build']>>;
+        search: Awaited<ReturnType<SearchPlugin<SchemaInference<NonNullable<typeof schemaTables>>>['build']>>;
     }, keyof Plugins> & {
         [Key in StringKeys<NonNullable<Plugins>>]: Awaited<ReturnType<NonNullable<Plugins>[Key]['build']>>;
     };
 }
 declare const BaseClient_base: ClientConstructor<{}>;
-declare class BaseClient extends BaseClient_base<Record<string, any>> {
+declare class BaseClient extends BaseClient_base<[]> {
 }
 
 declare type BranchResolutionOptions = {
@@ -3236,7 +4088,7 @@ declare type BranchResolutionOptions = {
     apiKey?: string;
     fetchImpl?: FetchImpl;
 };
-declare function getCurrentBranchName(options?: BranchResolutionOptions): Promise<string | undefined>;
+declare function getCurrentBranchName(options?: BranchResolutionOptions): Promise<string>;
 declare function getCurrentBranchDetails(options?: BranchResolutionOptions): Promise<DBBranch | null>;
 declare function getDatabaseURL(): string | undefined;
 
@@ -3247,4 +4099,4 @@ declare class XataError extends Error {
     constructor(message: string, status: number);
 }
 
-export { AcceptWorkspaceMemberInviteError, AcceptWorkspaceMemberInvitePathParams, AcceptWorkspaceMemberInviteVariables, AddTableColumnError, AddTableColumnPathParams, AddTableColumnVariables, BaseClient, BaseClientOptions, BaseData, BulkInsertTableRecordsError, BulkInsertTableRecordsPathParams, BulkInsertTableRecordsRequestBody, BulkInsertTableRecordsResponse, BulkInsertTableRecordsVariables, CancelWorkspaceMemberInviteError, CancelWorkspaceMemberInvitePathParams, CancelWorkspaceMemberInviteVariables, ClientConstructor, CreateBranchError, CreateBranchPathParams, CreateBranchQueryParams, CreateBranchRequestBody, CreateBranchVariables, CreateDatabaseError, CreateDatabasePathParams, CreateDatabaseRequestBody, CreateDatabaseResponse, CreateDatabaseVariables, CreateTableError, CreateTablePathParams, CreateTableVariables, CreateUserAPIKeyError, CreateUserAPIKeyPathParams, CreateUserAPIKeyResponse, CreateUserAPIKeyVariables, CreateWorkspaceError, CreateWorkspaceVariables, CursorNavigationOptions, DeleteBranchError, DeleteBranchPathParams, DeleteBranchVariables, DeleteColumnError, DeleteColumnPathParams, DeleteColumnVariables, DeleteDatabaseError, DeleteDatabasePathParams, DeleteDatabaseVariables, DeleteRecordError, DeleteRecordPathParams, DeleteRecordVariables, DeleteTableError, DeleteTablePathParams, DeleteTableVariables, DeleteUserAPIKeyError, DeleteUserAPIKeyPathParams, DeleteUserAPIKeyVariables, DeleteUserError, DeleteUserVariables, DeleteWorkspaceError, DeleteWorkspacePathParams, DeleteWorkspaceVariables, EditableData, ExecuteBranchMigrationPlanError, ExecuteBranchMigrationPlanPathParams, ExecuteBranchMigrationPlanRequestBody, ExecuteBranchMigrationPlanVariables, FetchImpl, FetcherExtraProps, GetBranchDetailsError, GetBranchDetailsPathParams, GetBranchDetailsVariables, GetBranchListError, GetBranchListPathParams, GetBranchListVariables, GetBranchMetadataError, GetBranchMetadataPathParams, GetBranchMetadataVariables, GetBranchMigrationHistoryError, GetBranchMigrationHistoryPathParams, GetBranchMigrationHistoryRequestBody, GetBranchMigrationHistoryResponse, GetBranchMigrationHistoryVariables, GetBranchMigrationPlanError, GetBranchMigrationPlanPathParams, GetBranchMigrationPlanVariables, GetBranchStatsError, GetBranchStatsPathParams, GetBranchStatsResponse, GetBranchStatsVariables, GetColumnError, GetColumnPathParams, GetColumnVariables, GetDatabaseListError, GetDatabaseListPathParams, GetDatabaseListVariables, GetRecordError, GetRecordPathParams, GetRecordRequestBody, GetRecordVariables, GetTableColumnsError, GetTableColumnsPathParams, GetTableColumnsResponse, GetTableColumnsVariables, GetTableSchemaError, GetTableSchemaPathParams, GetTableSchemaResponse, GetTableSchemaVariables, GetUserAPIKeysError, GetUserAPIKeysResponse, GetUserAPIKeysVariables, GetUserError, GetUserVariables, GetWorkspaceError, GetWorkspaceMembersListError, GetWorkspaceMembersListPathParams, GetWorkspaceMembersListVariables, GetWorkspacePathParams, GetWorkspaceVariables, GetWorkspacesListError, GetWorkspacesListResponse, GetWorkspacesListVariables, Identifiable, InsertRecordError, InsertRecordPathParams, InsertRecordResponse, InsertRecordVariables, InsertRecordWithIDError, InsertRecordWithIDPathParams, InsertRecordWithIDQueryParams, InsertRecordWithIDVariables, InviteWorkspaceMemberError, InviteWorkspaceMemberPathParams, InviteWorkspaceMemberRequestBody, InviteWorkspaceMemberVariables, LinkDictionary, OffsetNavigationOptions, operationsByTag as Operations, PAGINATION_DEFAULT_OFFSET, PAGINATION_DEFAULT_SIZE, PAGINATION_MAX_OFFSET, PAGINATION_MAX_SIZE, Page, Paginable, PaginationOptions, PaginationQueryMeta, Query, QueryTableError, QueryTablePathParams, QueryTableRequestBody, QueryTableVariables, RemoveWorkspaceMemberError, RemoveWorkspaceMemberPathParams, RemoveWorkspaceMemberVariables, Repository, ResendWorkspaceMemberInviteError, ResendWorkspaceMemberInvitePathParams, ResendWorkspaceMemberInviteVariables, responses as Responses, RestRepository, SchemaDefinition, SchemaPlugin, SchemaPluginResult, schemas as Schemas, SearchBranchError, SearchBranchPathParams, SearchBranchRequestBody, SearchBranchVariables, SearchOptions, SearchPlugin, SearchPluginResult, SelectableColumn, SelectedPick, SetTableSchemaError, SetTableSchemaPathParams, SetTableSchemaRequestBody, SetTableSchemaVariables, UpdateBranchMetadataError, UpdateBranchMetadataPathParams, UpdateBranchMetadataVariables, UpdateColumnError, UpdateColumnPathParams, UpdateColumnRequestBody, UpdateColumnVariables, UpdateRecordWithIDError, UpdateRecordWithIDPathParams, UpdateRecordWithIDQueryParams, UpdateRecordWithIDVariables, UpdateTableError, UpdateTablePathParams, UpdateTableRequestBody, UpdateTableVariables, UpdateUserError, UpdateUserVariables, UpdateWorkspaceError, UpdateWorkspaceMemberRoleError, UpdateWorkspaceMemberRolePathParams, UpdateWorkspaceMemberRoleRequestBody, UpdateWorkspaceMemberRoleVariables, UpdateWorkspacePathParams, UpdateWorkspaceVariables, UpsertRecordWithIDError, UpsertRecordWithIDPathParams, UpsertRecordWithIDQueryParams, UpsertRecordWithIDVariables, ValueAtColumn, XataApiClient, XataApiClientOptions, XataApiPlugin, XataError, XataPlugin, XataPluginOptions, XataRecord, acceptWorkspaceMemberInvite, addTableColumn, buildClient, bulkInsertTableRecords, cancelWorkspaceMemberInvite, contains, createBranch, createDatabase, createTable, createUserAPIKey, createWorkspace, deleteBranch, deleteColumn, deleteDatabase, deleteRecord, deleteTable, deleteUser, deleteUserAPIKey, deleteWorkspace, endsWith, executeBranchMigrationPlan, exists, ge, getAPIKey, getBranchDetails, getBranchList, getBranchMetadata, getBranchMigrationHistory, getBranchMigrationPlan, getBranchStats, getColumn, getCurrentBranchDetails, getCurrentBranchName, getDatabaseList, getDatabaseURL, getRecord, getTableColumns, getTableSchema, getUser, getUserAPIKeys, getWorkspace, getWorkspaceMembersList, getWorkspacesList, gt, gte, includes, includesAll, includesAny, includesNone, insertRecord, insertRecordWithID, inviteWorkspaceMember, is, isIdentifiable, isNot, isXataRecord, le, lt, lte, notExists, operationsByTag, pattern, queryTable, removeWorkspaceMember, resendWorkspaceMemberInvite, searchBranch, setTableSchema, startsWith, updateBranchMetadata, updateColumn, updateRecordWithID, updateTable, updateUser, updateWorkspace, updateWorkspaceMemberRole, upsertRecordWithID };
+export { AcceptWorkspaceMemberInviteError, AcceptWorkspaceMemberInvitePathParams, AcceptWorkspaceMemberInviteVariables, AddGitBranchesEntryError, AddGitBranchesEntryPathParams, AddGitBranchesEntryRequestBody, AddGitBranchesEntryResponse, AddGitBranchesEntryVariables, AddTableColumnError, AddTableColumnPathParams, AddTableColumnVariables, BaseClient, BaseClientOptions, BaseData, BaseSchema, BulkInsertTableRecordsError, BulkInsertTableRecordsPathParams, BulkInsertTableRecordsQueryParams, BulkInsertTableRecordsRequestBody, BulkInsertTableRecordsVariables, CacheImpl, CancelWorkspaceMemberInviteError, CancelWorkspaceMemberInvitePathParams, CancelWorkspaceMemberInviteVariables, ClientConstructor, CreateBranchError, CreateBranchPathParams, CreateBranchQueryParams, CreateBranchRequestBody, CreateBranchResponse, CreateBranchVariables, CreateDatabaseError, CreateDatabasePathParams, CreateDatabaseRequestBody, CreateDatabaseResponse, CreateDatabaseVariables, CreateTableError, CreateTablePathParams, CreateTableResponse, CreateTableVariables, CreateUserAPIKeyError, CreateUserAPIKeyPathParams, CreateUserAPIKeyResponse, CreateUserAPIKeyVariables, CreateWorkspaceError, CreateWorkspaceVariables, CursorNavigationOptions, DeleteBranchError, DeleteBranchPathParams, DeleteBranchVariables, DeleteColumnError, DeleteColumnPathParams, DeleteColumnVariables, DeleteDatabaseError, DeleteDatabasePathParams, DeleteDatabaseVariables, DeleteRecordError, DeleteRecordPathParams, DeleteRecordQueryParams, DeleteRecordVariables, DeleteTableError, DeleteTablePathParams, DeleteTableVariables, DeleteUserAPIKeyError, DeleteUserAPIKeyPathParams, DeleteUserAPIKeyVariables, DeleteUserError, DeleteUserVariables, DeleteWorkspaceError, DeleteWorkspacePathParams, DeleteWorkspaceVariables, EditableData, ExecuteBranchMigrationPlanError, ExecuteBranchMigrationPlanPathParams, ExecuteBranchMigrationPlanRequestBody, ExecuteBranchMigrationPlanVariables, FetchImpl, FetcherExtraProps, GetBranchDetailsError, GetBranchDetailsPathParams, GetBranchDetailsVariables, GetBranchListError, GetBranchListPathParams, GetBranchListVariables, GetBranchMetadataError, GetBranchMetadataPathParams, GetBranchMetadataVariables, GetBranchMigrationHistoryError, GetBranchMigrationHistoryPathParams, GetBranchMigrationHistoryRequestBody, GetBranchMigrationHistoryResponse, GetBranchMigrationHistoryVariables, GetBranchMigrationPlanError, GetBranchMigrationPlanPathParams, GetBranchMigrationPlanVariables, GetBranchStatsError, GetBranchStatsPathParams, GetBranchStatsResponse, GetBranchStatsVariables, GetColumnError, GetColumnPathParams, GetColumnVariables, GetDatabaseListError, GetDatabaseListPathParams, GetDatabaseListVariables, GetDatabaseMetadataError, GetDatabaseMetadataPathParams, GetDatabaseMetadataVariables, GetGitBranchesMappingError, GetGitBranchesMappingPathParams, GetGitBranchesMappingVariables, GetRecordError, GetRecordPathParams, GetRecordQueryParams, GetRecordVariables, GetTableColumnsError, GetTableColumnsPathParams, GetTableColumnsResponse, GetTableColumnsVariables, GetTableSchemaError, GetTableSchemaPathParams, GetTableSchemaResponse, GetTableSchemaVariables, GetUserAPIKeysError, GetUserAPIKeysResponse, GetUserAPIKeysVariables, GetUserError, GetUserVariables, GetWorkspaceError, GetWorkspaceMembersListError, GetWorkspaceMembersListPathParams, GetWorkspaceMembersListVariables, GetWorkspacePathParams, GetWorkspaceVariables, GetWorkspacesListError, GetWorkspacesListResponse, GetWorkspacesListVariables, Identifiable, InsertRecordError, InsertRecordPathParams, InsertRecordQueryParams, InsertRecordVariables, InsertRecordWithIDError, InsertRecordWithIDPathParams, InsertRecordWithIDQueryParams, InsertRecordWithIDVariables, InviteWorkspaceMemberError, InviteWorkspaceMemberPathParams, InviteWorkspaceMemberRequestBody, InviteWorkspaceMemberVariables, Link, OffsetNavigationOptions, operationsByTag as Operations, PAGINATION_DEFAULT_OFFSET, PAGINATION_DEFAULT_SIZE, PAGINATION_MAX_OFFSET, PAGINATION_MAX_SIZE, Page, Paginable, PaginationQueryMeta, Query, QueryTableError, QueryTablePathParams, QueryTableRequestBody, QueryTableVariables, RecordArray, RemoveGitBranchesEntryError, RemoveGitBranchesEntryPathParams, RemoveGitBranchesEntryQueryParams, RemoveGitBranchesEntryVariables, RemoveWorkspaceMemberError, RemoveWorkspaceMemberPathParams, RemoveWorkspaceMemberVariables, Repository, ResendWorkspaceMemberInviteError, ResendWorkspaceMemberInvitePathParams, ResendWorkspaceMemberInviteVariables, ResolveBranchError, ResolveBranchPathParams, ResolveBranchQueryParams, ResolveBranchResponse, ResolveBranchVariables, responses as Responses, RestRepository, SchemaDefinition, SchemaInference, SchemaPlugin, SchemaPluginResult, schemas as Schemas, SearchBranchError, SearchBranchPathParams, SearchBranchRequestBody, SearchBranchVariables, SearchOptions, SearchPlugin, SearchPluginResult, SearchTableError, SearchTablePathParams, SearchTableRequestBody, SearchTableVariables, SearchXataRecord, SelectableColumn, SelectedPick, SetTableSchemaError, SetTableSchemaPathParams, SetTableSchemaRequestBody, SetTableSchemaVariables, SimpleCache, SimpleCacheOptions, UpdateBranchMetadataError, UpdateBranchMetadataPathParams, UpdateBranchMetadataVariables, UpdateColumnError, UpdateColumnPathParams, UpdateColumnRequestBody, UpdateColumnVariables, UpdateRecordWithIDError, UpdateRecordWithIDPathParams, UpdateRecordWithIDQueryParams, UpdateRecordWithIDVariables, UpdateTableError, UpdateTablePathParams, UpdateTableRequestBody, UpdateTableVariables, UpdateUserError, UpdateUserVariables, UpdateWorkspaceError, UpdateWorkspaceMemberInviteError, UpdateWorkspaceMemberInvitePathParams, UpdateWorkspaceMemberInviteRequestBody, UpdateWorkspaceMemberInviteVariables, UpdateWorkspaceMemberRoleError, UpdateWorkspaceMemberRolePathParams, UpdateWorkspaceMemberRoleRequestBody, UpdateWorkspaceMemberRoleVariables, UpdateWorkspacePathParams, UpdateWorkspaceVariables, UpsertRecordWithIDError, UpsertRecordWithIDPathParams, UpsertRecordWithIDQueryParams, UpsertRecordWithIDVariables, ValueAtColumn, XataApiClient, XataApiClientOptions, XataApiPlugin, XataError, XataPlugin, XataPluginOptions, XataRecord, acceptWorkspaceMemberInvite, addGitBranchesEntry, addTableColumn, buildClient, bulkInsertTableRecords, cancelWorkspaceMemberInvite, contains, createBranch, createDatabase, createTable, createUserAPIKey, createWorkspace, deleteBranch, deleteColumn, deleteDatabase, deleteRecord, deleteTable, deleteUser, deleteUserAPIKey, deleteWorkspace, endsWith, executeBranchMigrationPlan, exists, ge, getAPIKey, getBranchDetails, getBranchList, getBranchMetadata, getBranchMigrationHistory, getBranchMigrationPlan, getBranchStats, getColumn, getCurrentBranchDetails, getCurrentBranchName, getDatabaseList, getDatabaseMetadata, getDatabaseURL, getGitBranchesMapping, getRecord, getTableColumns, getTableSchema, getUser, getUserAPIKeys, getWorkspace, getWorkspaceMembersList, getWorkspacesList, gt, gte, includes, includesAll, includesAny, includesNone, insertRecord, insertRecordWithID, inviteWorkspaceMember, is, isCursorPaginationOptions, isIdentifiable, isNot, isXataRecord, le, lt, lte, notExists, operationsByTag, pattern, queryTable, removeGitBranchesEntry, removeWorkspaceMember, resendWorkspaceMemberInvite, resolveBranch, searchBranch, searchTable, setTableSchema, startsWith, updateBranchMetadata, updateColumn, updateRecordWithID, updateTable, updateUser, updateWorkspace, updateWorkspaceMemberInvite, updateWorkspaceMemberRole, upsertRecordWithID };