@xata.io/client 0.0.0-alpha.vfc692f9 → 0.0.0-alpha.vfcd664d

package/dist/index.mjs

@@ -1,3 +1,25 @@
+const defaultTrace = async (_name, fn, _options) => {
+  return await fn({
+    setAttributes: () => {
+      return;
+    }
+  });
+};
+const TraceAttributes = {
+  KIND: "xata.trace.kind",
+  VERSION: "xata.sdk.version",
+  TABLE: "xata.table",
+  HTTP_REQUEST_ID: "http.request_id",
+  HTTP_STATUS_CODE: "http.status_code",
+  HTTP_HOST: "http.host",
+  HTTP_SCHEME: "http.scheme",
+  HTTP_USER_AGENT: "http.user_agent",
+  HTTP_METHOD: "http.method",
+  HTTP_URL: "http.url",
+  HTTP_ROUTE: "http.route",
+  HTTP_TARGET: "http.target"
+};
+
 function notEmpty(value) {
   return value !== null && value !== void 0;
 }
@@ -16,6 +38,9 @@ function isString(value) {
 function isStringArray(value) {
   return isDefined(value) && Array.isArray(value) && value.every(isString);
 }
+function isNumber(value) {
+  return isDefined(value) && typeof value === "number";
+}
 function toBase64(value) {
   try {
     return btoa(value);
@@ -24,6 +49,17 @@ function toBase64(value) {
     return buf.from(value).toString("base64");
   }
 }
+function deepMerge(a, b) {
+  const result = { ...a };
+  for (const [key, value] of Object.entries(b)) {
+    if (isObject(value) && isObject(result[key])) {
+      result[key] = deepMerge(result[key], value);
+    } else {
+      result[key] = value;
+    }
+  }
+  return result;
+}
 
 function getEnvironment() {
   try {
@@ -121,12 +157,14 @@ function getFetchImplementation(userFetch) {
   const globalFetch = typeof fetch !== "undefined" ? fetch : void 0;
   const fetchImpl = userFetch ?? globalFetch;
   if (!fetchImpl) {
-    throw new Error(`The \`fetch\` option passed to the Xata client is resolving to a falsy value and may not be correctly imported.`);
+    throw new Error(
+      `Couldn't find \`fetch\`. Install a fetch implementation such as \`node-fetch\` and pass it explicitly.`
+    );
   }
   return fetchImpl;
 }
 
-const VERSION = "0.0.0-alpha.vfc692f9";
+const VERSION = "0.0.0-alpha.vfcd664d";
 
 class ErrorWithCause extends Error {
   constructor(message, options) {
@@ -177,18 +215,24 @@ const resolveUrl = (url, queryParams = {}, pathParams = {}) => {
   }, {});
   const query = new URLSearchParams(cleanQueryParams).toString();
   const queryString = query.length > 0 ? `?${query}` : "";
-  return url.replace(/\{\w*\}/g, (key) => pathParams[key.slice(1, -1)]) + queryString;
+  const cleanPathParams = Object.entries(pathParams).reduce((acc, [key, value]) => {
+    return { ...acc, [key]: encodeURIComponent(String(value ?? "")).replace("%3A", ":") };
+  }, {});
+  return url.replace(/\{\w*\}/g, (key) => cleanPathParams[key.slice(1, -1)]) + queryString;
 };
 function buildBaseUrl({
+  endpoint,
   path,
   workspacesApiUrl,
   apiUrl,
-  pathParams
+  pathParams = {}
 }) {
-  if (!pathParams?.workspace)
-    return `${apiUrl}${path}`;
-  const url = typeof workspacesApiUrl === "string" ? `${workspacesApiUrl}${path}` : workspacesApiUrl(path, pathParams);
-  return url.replace("{workspaceId}", pathParams.workspace);
+  if (endpoint === "dataPlane") {
+    const url = isString(workspacesApiUrl) ? `${workspacesApiUrl}${path}` : workspacesApiUrl(path, pathParams);
+    const urlWithWorkspace = isString(pathParams.workspace) ? url.replace("{workspaceId}", String(pathParams.workspace)) : url;
+    return isString(pathParams.region) ? urlWithWorkspace.replace("{region}", String(pathParams.region)) : urlWithWorkspace;
+  }
+  return `${apiUrl}${path}`;
 }
 function hostHeader(url) {
   const pattern = /.*:\/\/(?<host>[^/]+).*/;
@@ -204,271 +248,229 @@ async function fetch$1({
   queryParams,
   fetchImpl,
   apiKey,
+  endpoint,
   apiUrl,
-  workspacesApiUrl
+  workspacesApiUrl,
+  trace,
+  signal,
+  clientID,
+  sessionID
 }) {
-  const baseUrl = buildBaseUrl({ path, workspacesApiUrl, pathParams, apiUrl });
-  const fullUrl = resolveUrl(baseUrl, queryParams, pathParams);
-  const url = fullUrl.includes("localhost") ? fullUrl.replace(/^[^.]+\./, "http://") : fullUrl;
-  const response = await fetchImpl(url, {
-    method: method.toUpperCase(),
-    body: body ? JSON.stringify(body) : void 0,
-    headers: {
-      "Content-Type": "application/json",
-      "User-Agent": `Xata client-ts/${VERSION}`,
-      ...headers,
-      ...hostHeader(fullUrl),
-      Authorization: `Bearer ${apiKey}`
-    }
-  });
-  if (response.status === 204) {
-    return {};
-  }
-  const requestId = response.headers?.get("x-request-id") ?? void 0;
+  return trace(
+    `${method.toUpperCase()} ${path}`,
+    async ({ setAttributes }) => {
+      const baseUrl = buildBaseUrl({ endpoint, path, workspacesApiUrl, pathParams, apiUrl });
+      const fullUrl = resolveUrl(baseUrl, queryParams, pathParams);
+      const url = fullUrl.includes("localhost") ? fullUrl.replace(/^[^.]+\./, "http://") : fullUrl;
+      setAttributes({
+        [TraceAttributes.HTTP_URL]: url,
+        [TraceAttributes.HTTP_TARGET]: resolveUrl(path, queryParams, pathParams)
+      });
+      const response = await fetchImpl(url, {
+        method: method.toUpperCase(),
+        body: body ? JSON.stringify(body) : void 0,
+        headers: {
+          "Content-Type": "application/json",
+          "User-Agent": `Xata client-ts/${VERSION}`,
+          "X-Xata-Client-ID": clientID ?? "",
+          "X-Xata-Session-ID": sessionID ?? "",
+          ...headers,
+          ...hostHeader(fullUrl),
+          Authorization: `Bearer ${apiKey}`
+        },
+        signal
+      });
+      if (response.status === 204) {
+        return {};
+      }
+      const { host, protocol } = parseUrl(response.url);
+      const requestId = response.headers?.get("x-request-id") ?? void 0;
+      setAttributes({
+        [TraceAttributes.KIND]: "http",
+        [TraceAttributes.HTTP_REQUEST_ID]: requestId,
+        [TraceAttributes.HTTP_STATUS_CODE]: response.status,
+        [TraceAttributes.HTTP_HOST]: host,
+        [TraceAttributes.HTTP_SCHEME]: protocol?.replace(":", "")
+      });
+      try {
+        const jsonResponse = await response.json();
+        if (response.ok) {
+          return jsonResponse;
+        }
+        throw new FetcherError(response.status, jsonResponse, requestId);
+      } catch (error) {
+        throw new FetcherError(response.status, error, requestId);
+      }
+    },
+    { [TraceAttributes.HTTP_METHOD]: method.toUpperCase(), [TraceAttributes.HTTP_ROUTE]: path }
+  );
+}
+function parseUrl(url) {
   try {
-    const jsonResponse = await response.json();
-    if (response.ok) {
-      return jsonResponse;
-    }
-    throw new FetcherError(response.status, jsonResponse, requestId);
+    const { host, protocol } = new URL(url);
+    return { host, protocol };
   } catch (error) {
-    throw new FetcherError(response.status, error, requestId);
+    return {};
   }
 }
 
-const getUser = (variables) => fetch$1({ url: "/user", method: "get", ...variables });
-const updateUser = (variables) => fetch$1({ url: "/user", method: "put", ...variables });
-const deleteUser = (variables) => fetch$1({ url: "/user", method: "delete", ...variables });
-const getUserAPIKeys = (variables) => fetch$1({
-  url: "/user/keys",
-  method: "get",
-  ...variables
-});
-const createUserAPIKey = (variables) => fetch$1({
-  url: "/user/keys/{keyName}",
-  method: "post",
-  ...variables
-});
-const deleteUserAPIKey = (variables) => fetch$1({
-  url: "/user/keys/{keyName}",
-  method: "delete",
-  ...variables
-});
-const createWorkspace = (variables) => fetch$1({
-  url: "/workspaces",
-  method: "post",
-  ...variables
-});
-const getWorkspacesList = (variables) => fetch$1({
-  url: "/workspaces",
-  method: "get",
-  ...variables
-});
-const getWorkspace = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}",
-  method: "get",
-  ...variables
-});
-const updateWorkspace = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}",
-  method: "put",
-  ...variables
-});
-const deleteWorkspace = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}",
-  method: "delete",
-  ...variables
-});
-const getWorkspaceMembersList = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}/members",
-  method: "get",
-  ...variables
-});
-const updateWorkspaceMemberRole = (variables) => fetch$1({ url: "/workspaces/{workspaceId}/members/{userId}", method: "put", ...variables });
-const removeWorkspaceMember = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}/members/{userId}",
-  method: "delete",
-  ...variables
-});
-const inviteWorkspaceMember = (variables) => fetch$1({ url: "/workspaces/{workspaceId}/invites", method: "post", ...variables });
-const updateWorkspaceMemberInvite = (variables) => fetch$1({ url: "/workspaces/{workspaceId}/invites/{inviteId}", method: "patch", ...variables });
-const cancelWorkspaceMemberInvite = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}/invites/{inviteId}",
-  method: "delete",
-  ...variables
-});
-const resendWorkspaceMemberInvite = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}/invites/{inviteId}/resend",
-  method: "post",
-  ...variables
-});
-const acceptWorkspaceMemberInvite = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}/invites/{inviteKey}/accept",
-  method: "post",
-  ...variables
-});
-const getDatabaseList = (variables) => fetch$1({
-  url: "/dbs",
-  method: "get",
-  ...variables
-});
-const getBranchList = (variables) => fetch$1({
-  url: "/dbs/{dbName}",
-  method: "get",
-  ...variables
-});
-const createDatabase = (variables) => fetch$1({
-  url: "/dbs/{dbName}",
-  method: "put",
-  ...variables
-});
-const deleteDatabase = (variables) => fetch$1({
+const dataPlaneFetch = async (options) => fetch$1({ ...options, endpoint: "dataPlane" });
+
+const dEPRECATEDgetDatabaseList = (variables, signal) => dataPlaneFetch({ url: "/dbs", method: "get", ...variables, signal });
+const getBranchList = (variables, signal) => dataPlaneFetch({
   url: "/dbs/{dbName}",
-  method: "delete",
-  ...variables
-});
-const getGitBranchesMapping = (variables) => fetch$1({ url: "/dbs/{dbName}/gitBranches", method: "get", ...variables });
-const addGitBranchesEntry = (variables) => fetch$1({ url: "/dbs/{dbName}/gitBranches", method: "post", ...variables });
-const removeGitBranchesEntry = (variables) => fetch$1({ url: "/dbs/{dbName}/gitBranches", method: "delete", ...variables });
-const resolveBranch = (variables) => fetch$1({
-  url: "/dbs/{dbName}/resolveBranch",
   method: "get",
-  ...variables
+  ...variables,
+  signal
 });
-const getBranchDetails = (variables) => fetch$1({
+const dEPRECATEDcreateDatabase = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}", method: "put", ...variables, signal });
+const dEPRECATEDdeleteDatabase = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}", method: "delete", ...variables, signal });
+const dEPRECATEDgetDatabaseMetadata = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/metadata", method: "get", ...variables, signal });
+const dEPRECATEDupdateDatabaseMetadata = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/metadata", method: "patch", ...variables, signal });
+const getBranchDetails = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}",
   method: "get",
-  ...variables
+  ...variables,
+  signal
 });
-const createBranch = (variables) => fetch$1({ url: "/db/{dbBranchName}", method: "put", ...variables });
-const deleteBranch = (variables) => fetch$1({
+const createBranch = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}", method: "put", ...variables, signal });
+const deleteBranch = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}",
   method: "delete",
-  ...variables
+  ...variables,
+  signal
 });
-const updateBranchMetadata = (variables) => fetch$1({
+const updateBranchMetadata = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/metadata",
   method: "put",
-  ...variables
+  ...variables,
+  signal
 });
-const getBranchMetadata = (variables) => fetch$1({
+const getBranchMetadata = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/metadata",
   method: "get",
-  ...variables
+  ...variables,
+  signal
 });
-const getBranchMigrationHistory = (variables) => fetch$1({ url: "/db/{dbBranchName}/migrations", method: "get", ...variables });
-const executeBranchMigrationPlan = (variables) => fetch$1({ url: "/db/{dbBranchName}/migrations/execute", method: "post", ...variables });
-const getBranchMigrationPlan = (variables) => fetch$1({ url: "/db/{dbBranchName}/migrations/plan", method: "post", ...variables });
-const getBranchStats = (variables) => fetch$1({
+const getBranchStats = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/stats",
   method: "get",
-  ...variables
+  ...variables,
+  signal
 });
-const createTable = (variables) => fetch$1({
+const getGitBranchesMapping = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/gitBranches", method: "get", ...variables, signal });
+const addGitBranchesEntry = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/gitBranches", method: "post", ...variables, signal });
+const removeGitBranchesEntry = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/gitBranches", method: "delete", ...variables, signal });
+const resolveBranch = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/resolveBranch", method: "get", ...variables, signal });
+const getBranchMigrationHistory = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/migrations", method: "get", ...variables, signal });
+const getBranchMigrationPlan = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/migrations/plan", method: "post", ...variables, signal });
+const executeBranchMigrationPlan = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/migrations/execute", method: "post", ...variables, signal });
+const branchTransaction = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/transaction", method: "post", ...variables, signal });
+const queryMigrationRequests = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/migrations/query", method: "post", ...variables, signal });
+const createMigrationRequest = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/migrations", method: "post", ...variables, signal });
+const getMigrationRequest = (variables, signal) => dataPlaneFetch({
+  url: "/dbs/{dbName}/migrations/{mrNumber}",
+  method: "get",
+  ...variables,
+  signal
+});
+const updateMigrationRequest = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/migrations/{mrNumber}", method: "patch", ...variables, signal });
+const listMigrationRequestsCommits = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/migrations/{mrNumber}/commits", method: "post", ...variables, signal });
+const compareMigrationRequest = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/migrations/{mrNumber}/compare", method: "post", ...variables, signal });
+const getMigrationRequestIsMerged = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/migrations/{mrNumber}/merge", method: "get", ...variables, signal });
+const mergeMigrationRequest = (variables, signal) => dataPlaneFetch({
+  url: "/dbs/{dbName}/migrations/{mrNumber}/merge",
+  method: "post",
+  ...variables,
+  signal
+});
+const getBranchSchemaHistory = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/schema/history", method: "post", ...variables, signal });
+const compareBranchWithUserSchema = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/schema/compare", method: "post", ...variables, signal });
+const compareBranchSchemas = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/schema/compare/{branchName}", method: "post", ...variables, signal });
+const updateBranchSchema = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/schema/update", method: "post", ...variables, signal });
+const previewBranchSchemaEdit = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/schema/preview", method: "post", ...variables, signal });
+const applyBranchSchemaEdit = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/schema/apply", method: "post", ...variables, signal });
+const createTable = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}",
   method: "put",
-  ...variables
+  ...variables,
+  signal
 });
-const deleteTable = (variables) => fetch$1({
+const deleteTable = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}",
   method: "delete",
-  ...variables
+  ...variables,
+  signal
 });
-const updateTable = (variables) => fetch$1({
-  url: "/db/{dbBranchName}/tables/{tableName}",
-  method: "patch",
-  ...variables
-});
-const getTableSchema = (variables) => fetch$1({
+const updateTable = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}", method: "patch", ...variables, signal });
+const getTableSchema = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/schema",
   method: "get",
-  ...variables
-});
-const setTableSchema = (variables) => fetch$1({
-  url: "/db/{dbBranchName}/tables/{tableName}/schema",
-  method: "put",
-  ...variables
+  ...variables,
+  signal
 });
-const getTableColumns = (variables) => fetch$1({
+const setTableSchema = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/schema", method: "put", ...variables, signal });
+const getTableColumns = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/columns",
   method: "get",
-  ...variables
-});
-const addTableColumn = (variables) => fetch$1({
-  url: "/db/{dbBranchName}/tables/{tableName}/columns",
-  method: "post",
-  ...variables
+  ...variables,
+  signal
 });
-const getColumn = (variables) => fetch$1({
+const addTableColumn = (variables, signal) => dataPlaneFetch(
+  { url: "/db/{dbBranchName}/tables/{tableName}/columns", method: "post", ...variables, signal }
+);
+const getColumn = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/columns/{columnName}",
   method: "get",
-  ...variables
-});
-const deleteColumn = (variables) => fetch$1({
-  url: "/db/{dbBranchName}/tables/{tableName}/columns/{columnName}",
-  method: "delete",
-  ...variables
+  ...variables,
+  signal
 });
-const updateColumn = (variables) => fetch$1({
+const updateColumn = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/columns/{columnName}", method: "patch", ...variables, signal });
+const deleteColumn = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/columns/{columnName}",
-  method: "patch",
-  ...variables
-});
-const insertRecord = (variables) => fetch$1({ url: "/db/{dbBranchName}/tables/{tableName}/data", method: "post", ...variables });
-const insertRecordWithID = (variables) => fetch$1({ url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}", method: "put", ...variables });
-const updateRecordWithID = (variables) => fetch$1({ url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}", method: "patch", ...variables });
-const upsertRecordWithID = (variables) => fetch$1({ url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}", method: "post", ...variables });
-const deleteRecord = (variables) => fetch$1({
-  url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}",
   method: "delete",
-  ...variables
+  ...variables,
+  signal
 });
-const getRecord = (variables) => fetch$1({
+const insertRecord = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/data", method: "post", ...variables, signal });
+const getRecord = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}",
   method: "get",
-  ...variables
+  ...variables,
+  signal
 });
-const bulkInsertTableRecords = (variables) => fetch$1({ url: "/db/{dbBranchName}/tables/{tableName}/bulk", method: "post", ...variables });
-const queryTable = (variables) => fetch$1({
+const insertRecordWithID = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}", method: "put", ...variables, signal });
+const updateRecordWithID = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}", method: "patch", ...variables, signal });
+const upsertRecordWithID = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}", method: "post", ...variables, signal });
+const deleteRecord = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}", method: "delete", ...variables, signal });
+const bulkInsertTableRecords = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/bulk", method: "post", ...variables, signal });
+const queryTable = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/query",
   method: "post",
-  ...variables
+  ...variables,
+  signal
 });
-const searchTable = (variables) => fetch$1({
-  url: "/db/{dbBranchName}/tables/{tableName}/search",
+const searchBranch = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/search",
   method: "post",
-  ...variables
+  ...variables,
+  signal
 });
-const searchBranch = (variables) => fetch$1({
-  url: "/db/{dbBranchName}/search",
+const searchTable = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/tables/{tableName}/search",
   method: "post",
-  ...variables
+  ...variables,
+  signal
 });
-const operationsByTag = {
-  users: { getUser, updateUser, deleteUser, getUserAPIKeys, createUserAPIKey, deleteUserAPIKey },
-  workspaces: {
-    createWorkspace,
-    getWorkspacesList,
-    getWorkspace,
-    updateWorkspace,
-    deleteWorkspace,
-    getWorkspaceMembersList,
-    updateWorkspaceMemberRole,
-    removeWorkspaceMember,
-    inviteWorkspaceMember,
-    updateWorkspaceMemberInvite,
-    cancelWorkspaceMemberInvite,
-    resendWorkspaceMemberInvite,
-    acceptWorkspaceMemberInvite
-  },
+const summarizeTable = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/summarize", method: "post", ...variables, signal });
+const aggregateTable = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/aggregate", method: "post", ...variables, signal });
+const operationsByTag$2 = {
   database: {
-    getDatabaseList,
-    createDatabase,
-    deleteDatabase,
-    getGitBranchesMapping,
-    addGitBranchesEntry,
-    removeGitBranchesEntry,
-    resolveBranch
+    dEPRECATEDgetDatabaseList,
+    dEPRECATEDcreateDatabase,
+    dEPRECATEDdeleteDatabase,
+    dEPRECATEDgetDatabaseMetadata,
+    dEPRECATEDupdateDatabaseMetadata
   },
   branch: {
     getBranchList,
@@ -477,10 +479,42 @@ const operationsByTag = {
     deleteBranch,
     updateBranchMetadata,
     getBranchMetadata,
+    getBranchStats,
+    getGitBranchesMapping,
+    addGitBranchesEntry,
+    removeGitBranchesEntry,
+    resolveBranch
+  },
+  migrations: {
     getBranchMigrationHistory,
-    executeBranchMigrationPlan,
     getBranchMigrationPlan,
-    getBranchStats
+    executeBranchMigrationPlan,
+    getBranchSchemaHistory,
+    compareBranchWithUserSchema,
+    compareBranchSchemas,
+    updateBranchSchema,
+    previewBranchSchemaEdit,
+    applyBranchSchemaEdit
+  },
+  records: {
+    branchTransaction,
+    insertRecord,
+    getRecord,
+    insertRecordWithID,
+    updateRecordWithID,
+    upsertRecordWithID,
+    deleteRecord,
+    bulkInsertTableRecords
+  },
+  migrationRequests: {
+    queryMigrationRequests,
+    createMigrationRequest,
+    getMigrationRequest,
+    updateMigrationRequest,
+    listMigrationRequestsCommits,
+    compareMigrationRequest,
+    getMigrationRequestIsMerged,
+    mergeMigrationRequest
   },
   table: {
     createTable,
@@ -491,27 +525,150 @@ const operationsByTag = {
     getTableColumns,
     addTableColumn,
     getColumn,
-    deleteColumn,
-    updateColumn
+    updateColumn,
+    deleteColumn
   },
-  records: {
-    insertRecord,
-    insertRecordWithID,
-    updateRecordWithID,
-    upsertRecordWithID,
-    deleteRecord,
-    getRecord,
-    bulkInsertTableRecords,
-    queryTable,
-    searchTable,
-    searchBranch
+  searchAndFilter: { queryTable, searchBranch, searchTable, summarizeTable, aggregateTable }
+};
+
+const controlPlaneFetch = async (options) => fetch$1({ ...options, endpoint: "controlPlane" });
+
+const getUser = (variables, signal) => controlPlaneFetch({
+  url: "/user",
+  method: "get",
+  ...variables,
+  signal
+});
+const updateUser = (variables, signal) => controlPlaneFetch({
+  url: "/user",
+  method: "put",
+  ...variables,
+  signal
+});
+const deleteUser = (variables, signal) => controlPlaneFetch({
+  url: "/user",
+  method: "delete",
+  ...variables,
+  signal
+});
+const getUserAPIKeys = (variables, signal) => controlPlaneFetch({
+  url: "/user/keys",
+  method: "get",
+  ...variables,
+  signal
+});
+const createUserAPIKey = (variables, signal) => controlPlaneFetch({
+  url: "/user/keys/{keyName}",
+  method: "post",
+  ...variables,
+  signal
+});
+const deleteUserAPIKey = (variables, signal) => controlPlaneFetch({
+  url: "/user/keys/{keyName}",
+  method: "delete",
+  ...variables,
+  signal
+});
+const getWorkspacesList = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces",
+  method: "get",
+  ...variables,
+  signal
+});
+const createWorkspace = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces",
+  method: "post",
+  ...variables,
+  signal
+});
+const getWorkspace = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces/{workspaceId}",
+  method: "get",
+  ...variables,
+  signal
+});
+const updateWorkspace = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces/{workspaceId}",
+  method: "put",
+  ...variables,
+  signal
+});
+const deleteWorkspace = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces/{workspaceId}",
+  method: "delete",
+  ...variables,
+  signal
+});
+const getWorkspaceMembersList = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/members", method: "get", ...variables, signal });
+const updateWorkspaceMemberRole = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/members/{userId}", method: "put", ...variables, signal });
+const removeWorkspaceMember = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces/{workspaceId}/members/{userId}",
+  method: "delete",
+  ...variables,
+  signal
+});
+const inviteWorkspaceMember = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/invites", method: "post", ...variables, signal });
+const updateWorkspaceMemberInvite = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/invites/{inviteId}", method: "patch", ...variables, signal });
+const cancelWorkspaceMemberInvite = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/invites/{inviteId}", method: "delete", ...variables, signal });
+const acceptWorkspaceMemberInvite = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/invites/{inviteKey}/accept", method: "post", ...variables, signal });
+const resendWorkspaceMemberInvite = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/invites/{inviteId}/resend", method: "post", ...variables, signal });
+const getDatabaseList = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces/{workspaceId}/dbs",
+  method: "get",
+  ...variables,
+  signal
+});
+const createDatabase = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/dbs/{dbName}", method: "put", ...variables, signal });
+const deleteDatabase = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces/{workspaceId}/dbs/{dbName}",
+  method: "delete",
+  ...variables,
+  signal
+});
+const getDatabaseMetadata = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/dbs/{dbName}", method: "get", ...variables, signal });
+const updateDatabaseMetadata = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/dbs/{dbName}", method: "patch", ...variables, signal });
+const listRegions = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces/{workspaceId}/regions",
+  method: "get",
+  ...variables,
+  signal
+});
+const operationsByTag$1 = {
+  users: { getUser, updateUser, deleteUser },
+  authentication: { getUserAPIKeys, createUserAPIKey, deleteUserAPIKey },
+  workspaces: {
+    getWorkspacesList,
+    createWorkspace,
+    getWorkspace,
+    updateWorkspace,
+    deleteWorkspace,
+    getWorkspaceMembersList,
+    updateWorkspaceMemberRole,
+    removeWorkspaceMember
+  },
+  invites: {
+    inviteWorkspaceMember,
+    updateWorkspaceMemberInvite,
+    cancelWorkspaceMemberInvite,
+    acceptWorkspaceMemberInvite,
+    resendWorkspaceMemberInvite
+  },
+  databases: {
+    getDatabaseList,
+    createDatabase,
+    deleteDatabase,
+    getDatabaseMetadata,
+    updateDatabaseMetadata,
+    listRegions
   }
 };
 
+const operationsByTag = deepMerge(operationsByTag$2, operationsByTag$1);
+
 function getHostUrl(provider, type) {
-  if (isValidAlias(provider)) {
+  if (isHostProviderAlias(provider)) {
     return providers[provider][type];
-  } else if (isValidBuilder(provider)) {
+  } else if (isHostProviderBuilder(provider)) {
     return provider[type];
   }
   throw new Error("Invalid API provider");
@@ -519,19 +676,38 @@ function getHostUrl(provider, type) {
 const providers = {
   production: {
     main: "https://api.xata.io",
-    workspaces: "https://{workspaceId}.xata.sh"
+    workspaces: "https://{workspaceId}.{region}.xata.sh"
   },
   staging: {
     main: "https://staging.xatabase.co",
-    workspaces: "https://{workspaceId}.staging.xatabase.co"
+    workspaces: "https://{workspaceId}.staging.{region}.xatabase.co"
   }
 };
-function isValidAlias(alias) {
+function isHostProviderAlias(alias) {
   return isString(alias) && Object.keys(providers).includes(alias);
 }
-function isValidBuilder(builder) {
+function isHostProviderBuilder(builder) {
   return isObject(builder) && isString(builder.main) && isString(builder.workspaces);
 }
+function parseProviderString(provider = "production") {
+  if (isHostProviderAlias(provider)) {
+    return provider;
+  }
+  const [main, workspaces] = provider.split(",");
+  if (!main || !workspaces)
+    return null;
+  return { main, workspaces };
+}
+function parseWorkspacesUrlParts(url) {
+  if (!isString(url))
+    return null;
+  const regex = /(?:https:\/\/)?([^.]+)(?:\.([^.]+))?\.xata\.sh.*/;
+  const regexStaging = /(?:https:\/\/)?([^.]+)\.staging(?:\.([^.]+))?\.xatabase\.co.*/;
+  const match = url.match(regex) || url.match(regexStaging);
+  if (!match)
+    return null;
+  return { workspace: match[1], region: match[2] ?? "eu-west-1" };
+}
 
 var __accessCheck$7 = (obj, member, msg) => {
   if (!member.has(obj))
@@ -557,7 +733,8 @@ class XataApiClient {
     __privateAdd$7(this, _extraProps, void 0);
     __privateAdd$7(this, _namespaces, {});
     const provider = options.host ?? "production";
-    const apiKey = options?.apiKey ?? getAPIKey();
+    const apiKey = options.apiKey ?? getAPIKey();
+    const trace = options.trace ?? defaultTrace;
     if (!apiKey) {
       throw new Error("Could not resolve a valid apiKey");
     }
@@ -565,7 +742,8 @@ class XataApiClient {
       apiUrl: getHostUrl(provider, "main"),
       workspacesApiUrl: getHostUrl(provider, "workspaces"),
       fetchImpl: getFetchImplementation(options.fetch),
-      apiKey
+      apiKey,
+      trace
     });
   }
   get user() {
@@ -573,21 +751,41 @@ class XataApiClient {
       __privateGet$7(this, _namespaces).user = new UserApi(__privateGet$7(this, _extraProps));
     return __privateGet$7(this, _namespaces).user;
   }
+  get authentication() {
+    if (!__privateGet$7(this, _namespaces).authentication)
+      __privateGet$7(this, _namespaces).authentication = new AuthenticationApi(__privateGet$7(this, _extraProps));
+    return __privateGet$7(this, _namespaces).authentication;
+  }
   get workspaces() {
     if (!__privateGet$7(this, _namespaces).workspaces)
       __privateGet$7(this, _namespaces).workspaces = new WorkspaceApi(__privateGet$7(this, _extraProps));
     return __privateGet$7(this, _namespaces).workspaces;
   }
-  get databases() {
-    if (!__privateGet$7(this, _namespaces).databases)
-      __privateGet$7(this, _namespaces).databases = new DatabaseApi(__privateGet$7(this, _extraProps));
-    return __privateGet$7(this, _namespaces).databases;
+  get invites() {
+    if (!__privateGet$7(this, _namespaces).invites)
+      __privateGet$7(this, _namespaces).invites = new InvitesApi(__privateGet$7(this, _extraProps));
+    return __privateGet$7(this, _namespaces).invites;
+  }
+  get database() {
+    if (!__privateGet$7(this, _namespaces).database)
+      __privateGet$7(this, _namespaces).database = new DatabaseApi(__privateGet$7(this, _extraProps));
+    return __privateGet$7(this, _namespaces).database;
   }
   get branches() {
     if (!__privateGet$7(this, _namespaces).branches)
       __privateGet$7(this, _namespaces).branches = new BranchApi(__privateGet$7(this, _extraProps));
     return __privateGet$7(this, _namespaces).branches;
   }
+  get migrations() {
+    if (!__privateGet$7(this, _namespaces).migrations)
+      __privateGet$7(this, _namespaces).migrations = new MigrationsApi(__privateGet$7(this, _extraProps));
+    return __privateGet$7(this, _namespaces).migrations;
+  }
+  get migrationRequests() {
+    if (!__privateGet$7(this, _namespaces).migrationRequests)
+      __privateGet$7(this, _namespaces).migrationRequests = new MigrationRequestsApi(__privateGet$7(this, _extraProps));
+    return __privateGet$7(this, _namespaces).migrationRequests;
+  }
   get tables() {
     if (!__privateGet$7(this, _namespaces).tables)
       __privateGet$7(this, _namespaces).tables = new TableApi(__privateGet$7(this, _extraProps));
@@ -598,6 +796,11 @@ class XataApiClient {
       __privateGet$7(this, _namespaces).records = new RecordsApi(__privateGet$7(this, _extraProps));
     return __privateGet$7(this, _namespaces).records;
   }
+  get searchAndFilter() {
+    if (!__privateGet$7(this, _namespaces).searchAndFilter)
+      __privateGet$7(this, _namespaces).searchAndFilter = new SearchAndFilterApi(__privateGet$7(this, _extraProps));
+    return __privateGet$7(this, _namespaces).searchAndFilter;
+  }
 }
 _extraProps = new WeakMap();
 _namespaces = new WeakMap();
@@ -608,24 +811,29 @@ class UserApi {
   getUser() {
     return operationsByTag.users.getUser({ ...this.extraProps });
   }
-  updateUser(user) {
+  updateUser({ user }) {
     return operationsByTag.users.updateUser({ body: user, ...this.extraProps });
   }
   deleteUser() {
     return operationsByTag.users.deleteUser({ ...this.extraProps });
   }
+}
+class AuthenticationApi {
+  constructor(extraProps) {
+    this.extraProps = extraProps;
+  }
   getUserAPIKeys() {
-    return operationsByTag.users.getUserAPIKeys({ ...this.extraProps });
+    return operationsByTag.authentication.getUserAPIKeys({ ...this.extraProps });
   }
-  createUserAPIKey(keyName) {
-    return operationsByTag.users.createUserAPIKey({
-      pathParams: { keyName },
+  createUserAPIKey({ name }) {
+    return operationsByTag.authentication.createUserAPIKey({
+      pathParams: { keyName: name },
       ...this.extraProps
     });
   }
-  deleteUserAPIKey(keyName) {
-    return operationsByTag.users.deleteUserAPIKey({
-      pathParams: { keyName },
+  deleteUserAPIKey({ name }) {
+    return operationsByTag.authentication.deleteUserAPIKey({
+      pathParams: { keyName: name },
       ...this.extraProps
     });
   }
@@ -634,353 +842,882 @@ class WorkspaceApi {
   constructor(extraProps) {
     this.extraProps = extraProps;
   }
-  createWorkspace(workspaceMeta) {
+  getWorkspacesList() {
+    return operationsByTag.workspaces.getWorkspacesList({ ...this.extraProps });
+  }
+  createWorkspace({ data }) {
     return operationsByTag.workspaces.createWorkspace({
-      body: workspaceMeta,
+      body: data,
       ...this.extraProps
     });
   }
-  getWorkspacesList() {
-    return operationsByTag.workspaces.getWorkspacesList({ ...this.extraProps });
-  }
-  getWorkspace(workspaceId) {
+  getWorkspace({ workspace }) {
     return operationsByTag.workspaces.getWorkspace({
-      pathParams: { workspaceId },
+      pathParams: { workspaceId: workspace },
       ...this.extraProps
     });
   }
-  updateWorkspace(workspaceId, workspaceMeta) {
+  updateWorkspace({
+    workspace,
+    update
+  }) {
     return operationsByTag.workspaces.updateWorkspace({
-      pathParams: { workspaceId },
-      body: workspaceMeta,
+      pathParams: { workspaceId: workspace },
+      body: update,
       ...this.extraProps
     });
   }
-  deleteWorkspace(workspaceId) {
+  deleteWorkspace({ workspace }) {
     return operationsByTag.workspaces.deleteWorkspace({
-      pathParams: { workspaceId },
+      pathParams: { workspaceId: workspace },
       ...this.extraProps
     });
   }
-  getWorkspaceMembersList(workspaceId) {
+  getWorkspaceMembersList({ workspace }) {
     return operationsByTag.workspaces.getWorkspaceMembersList({
-      pathParams: { workspaceId },
+      pathParams: { workspaceId: workspace },
       ...this.extraProps
     });
   }
-  updateWorkspaceMemberRole(workspaceId, userId, role) {
+  updateWorkspaceMemberRole({
+    workspace,
+    user,
+    role
+  }) {
     return operationsByTag.workspaces.updateWorkspaceMemberRole({
-      pathParams: { workspaceId, userId },
+      pathParams: { workspaceId: workspace, userId: user },
       body: { role },
       ...this.extraProps
     });
   }
-  removeWorkspaceMember(workspaceId, userId) {
+  removeWorkspaceMember({
+    workspace,
+    user
+  }) {
     return operationsByTag.workspaces.removeWorkspaceMember({
-      pathParams: { workspaceId, userId },
+      pathParams: { workspaceId: workspace, userId: user },
       ...this.extraProps
     });
   }
-  inviteWorkspaceMember(workspaceId, email, role) {
-    return operationsByTag.workspaces.inviteWorkspaceMember({
-      pathParams: { workspaceId },
+}
+class InvitesApi {
+  constructor(extraProps) {
+    this.extraProps = extraProps;
+  }
+  inviteWorkspaceMember({
+    workspace,
+    email,
+    role
+  }) {
+    return operationsByTag.invites.inviteWorkspaceMember({
+      pathParams: { workspaceId: workspace },
       body: { email, role },
       ...this.extraProps
     });
   }
-  updateWorkspaceMemberInvite(workspaceId, inviteId, role) {
-    return operationsByTag.workspaces.updateWorkspaceMemberInvite({
-      pathParams: { workspaceId, inviteId },
+  updateWorkspaceMemberInvite({
+    workspace,
+    invite,
+    role
+  }) {
+    return operationsByTag.invites.updateWorkspaceMemberInvite({
+      pathParams: { workspaceId: workspace, inviteId: invite },
       body: { role },
       ...this.extraProps
     });
   }
-  cancelWorkspaceMemberInvite(workspaceId, inviteId) {
-    return operationsByTag.workspaces.cancelWorkspaceMemberInvite({
-      pathParams: { workspaceId, inviteId },
+  cancelWorkspaceMemberInvite({
+    workspace,
+    invite
+  }) {
+    return operationsByTag.invites.cancelWorkspaceMemberInvite({
+      pathParams: { workspaceId: workspace, inviteId: invite },
       ...this.extraProps
     });
   }
-  resendWorkspaceMemberInvite(workspaceId, inviteId) {
-    return operationsByTag.workspaces.resendWorkspaceMemberInvite({
-      pathParams: { workspaceId, inviteId },
+  acceptWorkspaceMemberInvite({
+    workspace,
+    key
+  }) {
+    return operationsByTag.invites.acceptWorkspaceMemberInvite({
+      pathParams: { workspaceId: workspace, inviteKey: key },
       ...this.extraProps
     });
   }
-  acceptWorkspaceMemberInvite(workspaceId, inviteKey) {
-    return operationsByTag.workspaces.acceptWorkspaceMemberInvite({
-      pathParams: { workspaceId, inviteKey },
+  resendWorkspaceMemberInvite({
+    workspace,
+    invite
+  }) {
+    return operationsByTag.invites.resendWorkspaceMemberInvite({
+      pathParams: { workspaceId: workspace, inviteId: invite },
       ...this.extraProps
     });
   }
 }
-class DatabaseApi {
+class BranchApi {
+  constructor(extraProps) {
+    this.extraProps = extraProps;
+  }
+  getBranchList({
+    workspace,
+    region,
+    database
+  }) {
+    return operationsByTag.branch.getBranchList({
+      pathParams: { workspace, region, dbName: database },
+      ...this.extraProps
+    });
+  }
+  getBranchDetails({
+    workspace,
+    region,
+    database,
+    branch
+  }) {
+    return operationsByTag.branch.getBranchDetails({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      ...this.extraProps
+    });
+  }
+  createBranch({
+    workspace,
+    region,
+    database,
+    branch,
+    from,
+    metadata
+  }) {
+    return operationsByTag.branch.createBranch({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      body: { from, metadata },
+      ...this.extraProps
+    });
+  }
+  deleteBranch({
+    workspace,
+    region,
+    database,
+    branch
+  }) {
+    return operationsByTag.branch.deleteBranch({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      ...this.extraProps
+    });
+  }
+  updateBranchMetadata({
+    workspace,
+    region,
+    database,
+    branch,
+    metadata
+  }) {
+    return operationsByTag.branch.updateBranchMetadata({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      body: metadata,
+      ...this.extraProps
+    });
+  }
+  getBranchMetadata({
+    workspace,
+    region,
+    database,
+    branch
+  }) {
+    return operationsByTag.branch.getBranchMetadata({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      ...this.extraProps
+    });
+  }
+  getBranchStats({
+    workspace,
+    region,
+    database,
+    branch
+  }) {
+    return operationsByTag.branch.getBranchStats({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      ...this.extraProps
+    });
+  }
+  getGitBranchesMapping({
+    workspace,
+    region,
+    database
+  }) {
+    return operationsByTag.branch.getGitBranchesMapping({
+      pathParams: { workspace, region, dbName: database },
+      ...this.extraProps
+    });
+  }
+  addGitBranchesEntry({
+    workspace,
+    region,
+    database,
+    gitBranch,
+    xataBranch
+  }) {
+    return operationsByTag.branch.addGitBranchesEntry({
+      pathParams: { workspace, region, dbName: database },
+      body: { gitBranch, xataBranch },
+      ...this.extraProps
+    });
+  }
+  removeGitBranchesEntry({
+    workspace,
+    region,
+    database,
+    gitBranch
+  }) {
+    return operationsByTag.branch.removeGitBranchesEntry({
+      pathParams: { workspace, region, dbName: database },
+      queryParams: { gitBranch },
+      ...this.extraProps
+    });
+  }
+  resolveBranch({
+    workspace,
+    region,
+    database,
+    gitBranch,
+    fallbackBranch
+  }) {
+    return operationsByTag.branch.resolveBranch({
+      pathParams: { workspace, region, dbName: database },
+      queryParams: { gitBranch, fallbackBranch },
+      ...this.extraProps
+    });
+  }
+}
+class TableApi {
   constructor(extraProps) {
     this.extraProps = extraProps;
   }
-  getDatabaseList(workspace) {
-    return operationsByTag.database.getDatabaseList({
-      pathParams: { workspace },
+  createTable({
+    workspace,
+    region,
+    database,
+    branch,
+    table
+  }) {
+    return operationsByTag.table.createTable({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
       ...this.extraProps
     });
   }
-  createDatabase(workspace, dbName, options = {}) {
-    return operationsByTag.database.createDatabase({
-      pathParams: { workspace, dbName },
-      body: options,
+  deleteTable({
+    workspace,
+    region,
+    database,
+    branch,
+    table
+  }) {
+    return operationsByTag.table.deleteTable({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
       ...this.extraProps
     });
   }
-  deleteDatabase(workspace, dbName) {
-    return operationsByTag.database.deleteDatabase({
-      pathParams: { workspace, dbName },
+  updateTable({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    update
+  }) {
+    return operationsByTag.table.updateTable({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
+      body: update,
+      ...this.extraProps
+    });
+  }
+  getTableSchema({
+    workspace,
+    region,
+    database,
+    branch,
+    table
+  }) {
+    return operationsByTag.table.getTableSchema({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
+      ...this.extraProps
+    });
+  }
+  setTableSchema({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    schema
+  }) {
+    return operationsByTag.table.setTableSchema({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
+      body: schema,
+      ...this.extraProps
+    });
+  }
+  getTableColumns({
+    workspace,
+    region,
+    database,
+    branch,
+    table
+  }) {
+    return operationsByTag.table.getTableColumns({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
+      ...this.extraProps
+    });
+  }
+  addTableColumn({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    column
+  }) {
+    return operationsByTag.table.addTableColumn({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
+      body: column,
+      ...this.extraProps
+    });
+  }
+  getColumn({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    column
+  }) {
+    return operationsByTag.table.getColumn({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table, columnName: column },
+      ...this.extraProps
+    });
+  }
+  updateColumn({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    column,
+    update
+  }) {
+    return operationsByTag.table.updateColumn({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table, columnName: column },
+      body: update,
+      ...this.extraProps
+    });
+  }
+  deleteColumn({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    column
+  }) {
+    return operationsByTag.table.deleteColumn({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table, columnName: column },
+      ...this.extraProps
+    });
+  }
+}
+class RecordsApi {
+  constructor(extraProps) {
+    this.extraProps = extraProps;
+  }
+  insertRecord({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    record,
+    columns
+  }) {
+    return operationsByTag.records.insertRecord({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
+      queryParams: { columns },
+      body: record,
+      ...this.extraProps
+    });
+  }
+  getRecord({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    id,
+    columns
+  }) {
+    return operationsByTag.records.getRecord({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table, recordId: id },
+      queryParams: { columns },
+      ...this.extraProps
+    });
+  }
+  insertRecordWithID({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    id,
+    record,
+    columns,
+    createOnly,
+    ifVersion
+  }) {
+    return operationsByTag.records.insertRecordWithID({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table, recordId: id },
+      queryParams: { columns, createOnly, ifVersion },
+      body: record,
+      ...this.extraProps
+    });
+  }
+  updateRecordWithID({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    id,
+    record,
+    columns,
+    ifVersion
+  }) {
+    return operationsByTag.records.updateRecordWithID({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table, recordId: id },
+      queryParams: { columns, ifVersion },
+      body: record,
+      ...this.extraProps
+    });
+  }
+  upsertRecordWithID({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    id,
+    record,
+    columns,
+    ifVersion
+  }) {
+    return operationsByTag.records.upsertRecordWithID({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table, recordId: id },
+      queryParams: { columns, ifVersion },
+      body: record,
+      ...this.extraProps
+    });
+  }
+  deleteRecord({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    id,
+    columns
+  }) {
+    return operationsByTag.records.deleteRecord({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table, recordId: id },
+      queryParams: { columns },
+      ...this.extraProps
+    });
+  }
+  bulkInsertTableRecords({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    records,
+    columns
+  }) {
+    return operationsByTag.records.bulkInsertTableRecords({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
+      queryParams: { columns },
+      body: { records },
+      ...this.extraProps
+    });
+  }
+}
+class SearchAndFilterApi {
+  constructor(extraProps) {
+    this.extraProps = extraProps;
+  }
+  queryTable({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    filter,
+    sort,
+    page,
+    columns
+  }) {
+    return operationsByTag.searchAndFilter.queryTable({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
+      body: { filter, sort, page, columns },
       ...this.extraProps
     });
   }
-  getGitBranchesMapping(workspace, dbName) {
-    return operationsByTag.database.getGitBranchesMapping({
-      pathParams: { workspace, dbName },
+  searchTable({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    query,
+    fuzziness,
+    target,
+    prefix,
+    filter,
+    highlight,
+    boosters
+  }) {
+    return operationsByTag.searchAndFilter.searchTable({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
+      body: { query, fuzziness, target, prefix, filter, highlight, boosters },
       ...this.extraProps
     });
   }
-  addGitBranchesEntry(workspace, dbName, body) {
-    return operationsByTag.database.addGitBranchesEntry({
-      pathParams: { workspace, dbName },
-      body,
+  searchBranch({
+    workspace,
+    region,
+    database,
+    branch,
+    tables,
+    query,
+    fuzziness,
+    prefix,
+    highlight
+  }) {
+    return operationsByTag.searchAndFilter.searchBranch({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      body: { tables, query, fuzziness, prefix, highlight },
       ...this.extraProps
     });
   }
-  removeGitBranchesEntry(workspace, dbName, gitBranch) {
-    return operationsByTag.database.removeGitBranchesEntry({
-      pathParams: { workspace, dbName },
-      queryParams: { gitBranch },
+  summarizeTable({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    filter,
+    columns,
+    summaries,
+    sort,
+    summariesFilter,
+    page
+  }) {
+    return operationsByTag.searchAndFilter.summarizeTable({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
+      body: { filter, columns, summaries, sort, summariesFilter, page },
       ...this.extraProps
     });
   }
-  resolveBranch(workspace, dbName, gitBranch, fallbackBranch) {
-    return operationsByTag.database.resolveBranch({
-      pathParams: { workspace, dbName },
-      queryParams: { gitBranch, fallbackBranch },
+  aggregateTable({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    filter,
+    aggs
+  }) {
+    return operationsByTag.searchAndFilter.aggregateTable({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
+      body: { filter, aggs },
       ...this.extraProps
     });
   }
 }
-class BranchApi {
+class MigrationRequestsApi {
   constructor(extraProps) {
     this.extraProps = extraProps;
   }
-  getBranchList(workspace, dbName) {
-    return operationsByTag.branch.getBranchList({
-      pathParams: { workspace, dbName },
-      ...this.extraProps
-    });
-  }
-  getBranchDetails(workspace, database, branch) {
-    return operationsByTag.branch.getBranchDetails({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      ...this.extraProps
-    });
-  }
-  createBranch(workspace, database, branch, from, options = {}) {
-    return operationsByTag.branch.createBranch({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      queryParams: isString(from) ? { from } : void 0,
-      body: options,
+  queryMigrationRequests({
+    workspace,
+    region,
+    database,
+    filter,
+    sort,
+    page,
+    columns
+  }) {
+    return operationsByTag.migrationRequests.queryMigrationRequests({
+      pathParams: { workspace, region, dbName: database },
+      body: { filter, sort, page, columns },
       ...this.extraProps
     });
   }
-  deleteBranch(workspace, database, branch) {
-    return operationsByTag.branch.deleteBranch({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
+  createMigrationRequest({
+    workspace,
+    region,
+    database,
+    migration
+  }) {
+    return operationsByTag.migrationRequests.createMigrationRequest({
+      pathParams: { workspace, region, dbName: database },
+      body: migration,
       ...this.extraProps
     });
   }
-  updateBranchMetadata(workspace, database, branch, metadata = {}) {
-    return operationsByTag.branch.updateBranchMetadata({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      body: metadata,
+  getMigrationRequest({
+    workspace,
+    region,
+    database,
+    migrationRequest
+  }) {
+    return operationsByTag.migrationRequests.getMigrationRequest({
+      pathParams: { workspace, region, dbName: database, mrNumber: migrationRequest },
       ...this.extraProps
     });
   }
-  getBranchMetadata(workspace, database, branch) {
-    return operationsByTag.branch.getBranchMetadata({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
+  updateMigrationRequest({
+    workspace,
+    region,
+    database,
+    migrationRequest,
+    update
+  }) {
+    return operationsByTag.migrationRequests.updateMigrationRequest({
+      pathParams: { workspace, region, dbName: database, mrNumber: migrationRequest },
+      body: update,
       ...this.extraProps
     });
   }
-  getBranchMigrationHistory(workspace, database, branch, options = {}) {
-    return operationsByTag.branch.getBranchMigrationHistory({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      body: options,
+  listMigrationRequestsCommits({
+    workspace,
+    region,
+    database,
+    migrationRequest,
+    page
+  }) {
+    return operationsByTag.migrationRequests.listMigrationRequestsCommits({
+      pathParams: { workspace, region, dbName: database, mrNumber: migrationRequest },
+      body: { page },
       ...this.extraProps
     });
   }
-  executeBranchMigrationPlan(workspace, database, branch, migrationPlan) {
-    return operationsByTag.branch.executeBranchMigrationPlan({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      body: migrationPlan,
+  compareMigrationRequest({
+    workspace,
+    region,
+    database,
+    migrationRequest
+  }) {
+    return operationsByTag.migrationRequests.compareMigrationRequest({
+      pathParams: { workspace, region, dbName: database, mrNumber: migrationRequest },
       ...this.extraProps
     });
   }
-  getBranchMigrationPlan(workspace, database, branch, schema) {
-    return operationsByTag.branch.getBranchMigrationPlan({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      body: schema,
+  getMigrationRequestIsMerged({
+    workspace,
+    region,
+    database,
+    migrationRequest
+  }) {
+    return operationsByTag.migrationRequests.getMigrationRequestIsMerged({
+      pathParams: { workspace, region, dbName: database, mrNumber: migrationRequest },
       ...this.extraProps
     });
   }
-  getBranchStats(workspace, database, branch) {
-    return operationsByTag.branch.getBranchStats({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
+  mergeMigrationRequest({
+    workspace,
+    region,
+    database,
+    migrationRequest
+  }) {
+    return operationsByTag.migrationRequests.mergeMigrationRequest({
+      pathParams: { workspace, region, dbName: database, mrNumber: migrationRequest },
       ...this.extraProps
     });
   }
 }
-class TableApi {
+class MigrationsApi {
   constructor(extraProps) {
     this.extraProps = extraProps;
   }
-  createTable(workspace, database, branch, tableName) {
-    return operationsByTag.table.createTable({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      ...this.extraProps
-    });
-  }
-  deleteTable(workspace, database, branch, tableName) {
-    return operationsByTag.table.deleteTable({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
+  getBranchMigrationHistory({
+    workspace,
+    region,
+    database,
+    branch,
+    limit,
+    startFrom
+  }) {
+    return operationsByTag.migrations.getBranchMigrationHistory({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      body: { limit, startFrom },
       ...this.extraProps
     });
   }
-  updateTable(workspace, database, branch, tableName, options) {
-    return operationsByTag.table.updateTable({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      body: options,
+  getBranchMigrationPlan({
+    workspace,
+    region,
+    database,
+    branch,
+    schema
+  }) {
+    return operationsByTag.migrations.getBranchMigrationPlan({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      body: schema,
       ...this.extraProps
     });
   }
-  getTableSchema(workspace, database, branch, tableName) {
-    return operationsByTag.table.getTableSchema({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
+  executeBranchMigrationPlan({
+    workspace,
+    region,
+    database,
+    branch,
+    plan
+  }) {
+    return operationsByTag.migrations.executeBranchMigrationPlan({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      body: plan,
       ...this.extraProps
     });
   }
-  setTableSchema(workspace, database, branch, tableName, options) {
-    return operationsByTag.table.setTableSchema({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      body: options,
+  getBranchSchemaHistory({
+    workspace,
+    region,
+    database,
+    branch,
+    page
+  }) {
+    return operationsByTag.migrations.getBranchSchemaHistory({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      body: { page },
       ...this.extraProps
     });
   }
-  getTableColumns(workspace, database, branch, tableName) {
-    return operationsByTag.table.getTableColumns({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
+  compareBranchWithUserSchema({
+    workspace,
+    region,
+    database,
+    branch,
+    schema
+  }) {
+    return operationsByTag.migrations.compareBranchWithUserSchema({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      body: { schema },
       ...this.extraProps
     });
   }
-  addTableColumn(workspace, database, branch, tableName, column) {
-    return operationsByTag.table.addTableColumn({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      body: column,
+  compareBranchSchemas({
+    workspace,
+    region,
+    database,
+    branch,
+    compare,
+    schema
+  }) {
+    return operationsByTag.migrations.compareBranchSchemas({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, branchName: compare },
+      body: { schema },
       ...this.extraProps
     });
   }
-  getColumn(workspace, database, branch, tableName, columnName) {
-    return operationsByTag.table.getColumn({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, columnName },
+  updateBranchSchema({
+    workspace,
+    region,
+    database,
+    branch,
+    migration
+  }) {
+    return operationsByTag.migrations.updateBranchSchema({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      body: migration,
       ...this.extraProps
     });
   }
-  deleteColumn(workspace, database, branch, tableName, columnName) {
-    return operationsByTag.table.deleteColumn({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, columnName },
+  previewBranchSchemaEdit({
+    workspace,
+    region,
+    database,
+    branch,
+    data
+  }) {
+    return operationsByTag.migrations.previewBranchSchemaEdit({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      body: data,
       ...this.extraProps
     });
   }
-  updateColumn(workspace, database, branch, tableName, columnName, options) {
-    return operationsByTag.table.updateColumn({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, columnName },
-      body: options,
+  applyBranchSchemaEdit({
+    workspace,
+    region,
+    database,
+    branch,
+    edits
+  }) {
+    return operationsByTag.migrations.applyBranchSchemaEdit({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      body: { edits },
       ...this.extraProps
     });
   }
 }
-class RecordsApi {
+class DatabaseApi {
   constructor(extraProps) {
     this.extraProps = extraProps;
   }
-  insertRecord(workspace, database, branch, tableName, record, options = {}) {
-    return operationsByTag.records.insertRecord({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      queryParams: options,
-      body: record,
-      ...this.extraProps
-    });
-  }
-  insertRecordWithID(workspace, database, branch, tableName, recordId, record, options = {}) {
-    return operationsByTag.records.insertRecordWithID({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, recordId },
-      queryParams: options,
-      body: record,
-      ...this.extraProps
-    });
-  }
-  updateRecordWithID(workspace, database, branch, tableName, recordId, record, options = {}) {
-    return operationsByTag.records.updateRecordWithID({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, recordId },
-      queryParams: options,
-      body: record,
-      ...this.extraProps
-    });
-  }
-  upsertRecordWithID(workspace, database, branch, tableName, recordId, record, options = {}) {
-    return operationsByTag.records.upsertRecordWithID({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, recordId },
-      queryParams: options,
-      body: record,
-      ...this.extraProps
-    });
-  }
-  deleteRecord(workspace, database, branch, tableName, recordId, options = {}) {
-    return operationsByTag.records.deleteRecord({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, recordId },
-      queryParams: options,
+  getDatabaseList({ workspace }) {
+    return operationsByTag.databases.getDatabaseList({
+      pathParams: { workspaceId: workspace },
       ...this.extraProps
     });
   }
-  getRecord(workspace, database, branch, tableName, recordId, options = {}) {
-    return operationsByTag.records.getRecord({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, recordId },
-      queryParams: options,
+  createDatabase({
+    workspace,
+    database,
+    data
+  }) {
+    return operationsByTag.databases.createDatabase({
+      pathParams: { workspaceId: workspace, dbName: database },
+      body: data,
       ...this.extraProps
     });
   }
-  bulkInsertTableRecords(workspace, database, branch, tableName, records, options = {}) {
-    return operationsByTag.records.bulkInsertTableRecords({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      queryParams: options,
-      body: { records },
+  deleteDatabase({
+    workspace,
+    database
+  }) {
+    return operationsByTag.databases.deleteDatabase({
+      pathParams: { workspaceId: workspace, dbName: database },
       ...this.extraProps
     });
   }
-  queryTable(workspace, database, branch, tableName, query) {
-    return operationsByTag.records.queryTable({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      body: query,
+  getDatabaseMetadata({
+    workspace,
+    database
+  }) {
+    return operationsByTag.databases.getDatabaseMetadata({
+      pathParams: { workspaceId: workspace, dbName: database },
       ...this.extraProps
     });
   }
-  searchTable(workspace, database, branch, tableName, query) {
-    return operationsByTag.records.searchTable({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      body: query,
+  updateDatabaseMetadata({
+    workspace,
+    database,
+    metadata
+  }) {
+    return operationsByTag.databases.updateDatabaseMetadata({
+      pathParams: { workspaceId: workspace, dbName: database },
+      body: metadata,
       ...this.extraProps
     });
   }
-  searchBranch(workspace, database, branch, query) {
-    return operationsByTag.records.searchBranch({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      body: query,
+  listRegions({ workspace }) {
+    return operationsByTag.databases.listRegions({
+      pathParams: { workspaceId: workspace },
       ...this.extraProps
     });
   }
@@ -996,6 +1733,20 @@ class XataApiPlugin {
 class XataPlugin {
 }
 
+function generateUUID() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function(c) {
+    const r = Math.random() * 16 | 0, v = c == "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+
+function cleanFilter(filter) {
+  if (!filter)
+    return void 0;
+  const values = Object.values(filter).filter(Boolean).filter((value) => Array.isArray(value) ? value.length > 0 : true);
+  return values.length > 0 ? filter : void 0;
+}
+
 var __accessCheck$6 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
@@ -1028,11 +1779,11 @@ class Page {
   async previousPage(size, offset) {
     return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, before: this.meta.page.cursor } });
   }
-  async firstPage(size, offset) {
-    return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, first: this.meta.page.cursor } });
+  async startPage(size, offset) {
+    return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, start: this.meta.page.cursor } });
   }
-  async lastPage(size, offset) {
-    return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, last: this.meta.page.cursor } });
+  async endPage(size, offset) {
+    return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, end: this.meta.page.cursor } });
   }
   hasNextPage() {
     return this.meta.page.more;
@@ -1044,7 +1795,7 @@ const PAGINATION_DEFAULT_SIZE = 20;
 const PAGINATION_MAX_OFFSET = 800;
 const PAGINATION_DEFAULT_OFFSET = 0;
 function isCursorPaginationOptions(options) {
-  return isDefined(options) && (isDefined(options.first) || isDefined(options.last) || isDefined(options.after) || isDefined(options.before));
+  return isDefined(options) && (isDefined(options.start) || isDefined(options.end) || isDefined(options.after) || isDefined(options.before));
 }
 const _RecordArray = class extends Array {
   constructor(...args) {
@@ -1076,12 +1827,12 @@ const _RecordArray = class extends Array {
     const newPage = await __privateGet$6(this, _page).previousPage(size, offset);
     return new _RecordArray(newPage);
   }
-  async firstPage(size, offset) {
-    const newPage = await __privateGet$6(this, _page).firstPage(size, offset);
+  async startPage(size, offset) {
+    const newPage = await __privateGet$6(this, _page).startPage(size, offset);
     return new _RecordArray(newPage);
   }
-  async lastPage(size, offset) {
-    const newPage = await __privateGet$6(this, _page).lastPage(size, offset);
+  async endPage(size, offset) {
+    const newPage = await __privateGet$6(this, _page).endPage(size, offset);
     return new _RecordArray(newPage);
   }
   hasNextPage() {
@@ -1109,9 +1860,14 @@ var __privateSet$5 = (obj, member, value, setter) => {
   setter ? setter.call(obj, value) : member.set(obj, value);
   return value;
 };
-var _table$1, _repository, _data;
+var __privateMethod$3 = (obj, member, method) => {
+  __accessCheck$5(obj, member, "access private method");
+  return method;
+};
+var _table$1, _repository, _data, _cleanFilterConstraint, cleanFilterConstraint_fn;
 const _Query = class {
   constructor(repository, table, data, rawParent) {
+    __privateAdd$5(this, _cleanFilterConstraint);
     __privateAdd$5(this, _table$1, void 0);
     __privateAdd$5(this, _repository, void 0);
     __privateAdd$5(this, _data, { filter: {} });
@@ -1130,7 +1886,7 @@ const _Query = class {
     __privateGet$5(this, _data).filter.$not = data.filter?.$not ?? parent?.filter?.$not;
     __privateGet$5(this, _data).filter.$none = data.filter?.$none ?? parent?.filter?.$none;
     __privateGet$5(this, _data).sort = data.sort ?? parent?.sort;
-    __privateGet$5(this, _data).columns = data.columns ?? parent?.columns ?? ["*"];
+    __privateGet$5(this, _data).columns = data.columns ?? parent?.columns;
     __privateGet$5(this, _data).pagination = data.pagination ?? parent?.pagination;
     __privateGet$5(this, _data).cache = data.cache ?? parent?.cache;
     this.any = this.any.bind(this);
@@ -1168,21 +1924,29 @@ const _Query = class {
   }
   filter(a, b) {
     if (arguments.length === 1) {
-      const constraints = Object.entries(a).map(([column, constraint]) => ({ [column]: constraint }));
+      const constraints = Object.entries(a ?? {}).map(([column, constraint]) => ({
+        [column]: __privateMethod$3(this, _cleanFilterConstraint, cleanFilterConstraint_fn).call(this, column, constraint)
+      }));
       const $all = compact([__privateGet$5(this, _data).filter?.$all].flat().concat(constraints));
       return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $all } }, __privateGet$5(this, _data));
     } else {
-      const $all = compact([__privateGet$5(this, _data).filter?.$all].flat().concat([{ [a]: b }]));
+      const constraints = isDefined(a) && isDefined(b) ? [{ [a]: __privateMethod$3(this, _cleanFilterConstraint, cleanFilterConstraint_fn).call(this, a, b) }] : void 0;
+      const $all = compact([__privateGet$5(this, _data).filter?.$all].flat().concat(constraints));
       return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $all } }, __privateGet$5(this, _data));
     }
   }
-  sort(column, direction) {
+  sort(column, direction = "asc") {
     const originalSort = [__privateGet$5(this, _data).sort ?? []].flat();
     const sort = [...originalSort, { column, direction }];
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { sort }, __privateGet$5(this, _data));
   }
   select(columns) {
-    return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { columns }, __privateGet$5(this, _data));
+    return new _Query(
+      __privateGet$5(this, _repository),
+      __privateGet$5(this, _table$1),
+      { columns },
+      __privateGet$5(this, _data)
+    );
   }
   getPaginated(options = {}) {
     const query = new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), options, __privateGet$5(this, _data));
@@ -1205,11 +1969,20 @@ const _Query = class {
     }
   }
   async getMany(options = {}) {
-    const page = await this.getPaginated(options);
+    const { pagination = {}, ...rest } = options;
+    const { size = PAGINATION_DEFAULT_SIZE, offset } = pagination;
+    const batchSize = size <= PAGINATION_MAX_SIZE ? size : PAGINATION_MAX_SIZE;
+    let page = await this.getPaginated({ ...rest, pagination: { size: batchSize, offset } });
+    const results = [...page.records];
+    while (page.hasNextPage() && results.length < size) {
+      page = await page.nextPage();
+      results.push(...page.records);
+    }
     if (page.hasNextPage() && options.pagination?.size === void 0) {
       console.trace("Calling getMany does not return all results. Paginate to get all results or call getAll.");
     }
-    return page.records;
+    const array = new RecordArray(page, results.slice(0, size));
+    return array;
   }
   async getAll(options = {}) {
     const { batchSize = PAGINATION_MAX_SIZE, ...rest } = options;
@@ -1223,19 +1996,35 @@ const _Query = class {
     const records = await this.getMany({ ...options, pagination: { size: 1 } });
     return records[0] ?? null;
   }
+  async getFirstOrThrow(options = {}) {
+    const records = await this.getMany({ ...options, pagination: { size: 1 } });
+    if (records[0] === void 0)
+      throw new Error("No results found.");
+    return records[0];
+  }
+  async summarize(params = {}) {
+    const { summaries, summariesFilter, ...options } = params;
+    const query = new _Query(
+      __privateGet$5(this, _repository),
+      __privateGet$5(this, _table$1),
+      options,
+      __privateGet$5(this, _data)
+    );
+    return __privateGet$5(this, _repository).summarizeTable(query, summaries, summariesFilter);
+  }
   cache(ttl) {
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { cache: ttl }, __privateGet$5(this, _data));
   }
   nextPage(size, offset) {
-    return this.firstPage(size, offset);
+    return this.startPage(size, offset);
   }
   previousPage(size, offset) {
-    return this.firstPage(size, offset);
+    return this.startPage(size, offset);
   }
-  firstPage(size, offset) {
+  startPage(size, offset) {
     return this.getPaginated({ pagination: { size, offset } });
   }
-  lastPage(size, offset) {
+  endPage(size, offset) {
     return this.getPaginated({ pagination: { size, offset, before: "end" } });
   }
   hasNextPage() {
@@ -1246,9 +2035,20 @@ let Query = _Query;
 _table$1 = new WeakMap();
 _repository = new WeakMap();
 _data = new WeakMap();
+_cleanFilterConstraint = new WeakSet();
+cleanFilterConstraint_fn = function(column, value) {
+  const columnType = __privateGet$5(this, _table$1).schema?.columns.find(({ name }) => name === column)?.type;
+  if (columnType === "multiple" && (isString(value) || isStringArray(value))) {
+    return { $includes: value };
+  }
+  if (columnType === "link" && isObject(value) && isString(value.id)) {
+    return value.id;
+  }
+  return value;
+};
 function cleanParent(data, parent) {
   if (isCursorPaginationOptions(data.pagination)) {
-    return { ...parent, sorting: void 0, filter: void 0 };
+    return { ...parent, sort: void 0, filter: void 0 };
   }
   return parent;
 }
@@ -1307,12 +2107,16 @@ var __privateMethod$2 = (obj, member, method) => {
   __accessCheck$4(obj, member, "access private method");
   return method;
 };
-var _table, _getFetchProps, _cache, _schemaTables$2, _insertRecordWithoutId, insertRecordWithoutId_fn, _insertRecordWithId, insertRecordWithId_fn, _bulkInsertTableRecords, bulkInsertTableRecords_fn, _updateRecordWithID, updateRecordWithID_fn, _upsertRecordWithID, upsertRecordWithID_fn, _deleteRecord, deleteRecord_fn, _setCacheQuery, setCacheQuery_fn, _getCacheQuery, getCacheQuery_fn, _getSchemaTables$1, getSchemaTables_fn$1;
+var _table, _getFetchProps, _db, _cache, _schemaTables$2, _trace, _insertRecordWithoutId, insertRecordWithoutId_fn, _insertRecordWithId, insertRecordWithId_fn, _bulkInsertTableRecords, bulkInsertTableRecords_fn, _updateRecordWithID, updateRecordWithID_fn, _upsertRecordWithID, upsertRecordWithID_fn, _deleteRecord, deleteRecord_fn, _setCacheQuery, setCacheQuery_fn, _getCacheQuery, getCacheQuery_fn, _getSchemaTables$1, getSchemaTables_fn$1;
 class Repository extends Query {
 }
 class RestRepository extends Query {
   constructor(options) {
-    super(null, options.table, {});
+    super(
+      null,
+      { name: options.table, schema: options.schemaTables?.find((table) => table.name === options.table) },
+      {}
+    );
     __privateAdd$4(this, _insertRecordWithoutId);
     __privateAdd$4(this, _insertRecordWithId);
     __privateAdd$4(this, _bulkInsertTableRecords);
@@ -1324,176 +2128,339 @@ class RestRepository extends Query {
     __privateAdd$4(this, _getSchemaTables$1);
     __privateAdd$4(this, _table, void 0);
     __privateAdd$4(this, _getFetchProps, void 0);
+    __privateAdd$4(this, _db, void 0);
     __privateAdd$4(this, _cache, void 0);
     __privateAdd$4(this, _schemaTables$2, void 0);
+    __privateAdd$4(this, _trace, void 0);
     __privateSet$4(this, _table, options.table);
-    __privateSet$4(this, _getFetchProps, options.pluginOptions.getFetchProps);
-    this.db = options.db;
+    __privateSet$4(this, _db, options.db);
     __privateSet$4(this, _cache, options.pluginOptions.cache);
     __privateSet$4(this, _schemaTables$2, options.schemaTables);
+    __privateSet$4(this, _getFetchProps, async () => {
+      const props = await options.pluginOptions.getFetchProps();
+      return { ...props, sessionID: generateUUID() };
+    });
+    const trace = options.pluginOptions.trace ?? defaultTrace;
+    __privateSet$4(this, _trace, async (name, fn, options2 = {}) => {
+      return trace(name, fn, {
+        ...options2,
+        [TraceAttributes.TABLE]: __privateGet$4(this, _table),
+        [TraceAttributes.KIND]: "sdk-operation",
+        [TraceAttributes.VERSION]: VERSION
+      });
+    });
   }
-  async create(a, b, c) {
-    if (Array.isArray(a)) {
-      if (a.length === 0)
-        return [];
-      const columns = isStringArray(b) ? b : void 0;
-      return __privateMethod$2(this, _bulkInsertTableRecords, bulkInsertTableRecords_fn).call(this, a, columns);
-    }
-    if (isString(a) && isObject(b)) {
-      if (a === "")
-        throw new Error("The id can't be empty");
-      const columns = isStringArray(c) ? c : void 0;
-      return __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a, b, columns);
-    }
-    if (isObject(a) && isString(a.id)) {
-      if (a.id === "")
-        throw new Error("The id can't be empty");
-      const columns = isStringArray(b) ? b : void 0;
-      return __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a.id, { ...a, id: void 0 }, columns);
-    }
-    if (isObject(a)) {
-      const columns = isStringArray(b) ? b : void 0;
-      return __privateMethod$2(this, _insertRecordWithoutId, insertRecordWithoutId_fn).call(this, a, columns);
-    }
-    throw new Error("Invalid arguments for create method");
+  async create(a, b, c, d) {
+    return __privateGet$4(this, _trace).call(this, "create", async () => {
+      const ifVersion = parseIfVersion(b, c, d);
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        const columns = isStringArray(b) ? b : void 0;
+        return __privateMethod$2(this, _bulkInsertTableRecords, bulkInsertTableRecords_fn).call(this, a, columns);
+      }
+      if (isString(a) && isObject(b)) {
+        if (a === "")
+          throw new Error("The id can't be empty");
+        const columns = isStringArray(c) ? c : void 0;
+        return __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a, b, columns, { createOnly: true, ifVersion });
+      }
+      if (isObject(a) && isString(a.id)) {
+        if (a.id === "")
+          throw new Error("The id can't be empty");
+        const columns = isStringArray(b) ? b : void 0;
+        return __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a.id, { ...a, id: void 0 }, columns, { createOnly: true, ifVersion });
+      }
+      if (isObject(a)) {
+        const columns = isStringArray(b) ? b : void 0;
+        return __privateMethod$2(this, _insertRecordWithoutId, insertRecordWithoutId_fn).call(this, a, columns);
+      }
+      throw new Error("Invalid arguments for create method");
+    });
   }
   async read(a, b) {
-    const columns = isStringArray(b) ? b : ["*"];
-    if (Array.isArray(a)) {
-      if (a.length === 0)
-        return [];
-      const ids = a.map((item) => isString(item) ? item : item.id).filter((id2) => isString(id2));
-      const finalObjects = await this.getAll({ filter: { id: { $any: ids } }, columns });
-      const dictionary = finalObjects.reduce((acc, object) => {
-        acc[object.id] = object;
-        return acc;
-      }, {});
-      return ids.map((id2) => dictionary[id2] ?? null);
-    }
-    const id = isString(a) ? a : a.id;
-    if (isString(id)) {
-      const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
-      try {
-        const response = await getRecord({
-          pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table), recordId: id },
-          queryParams: { columns },
-          ...fetchProps
-        });
-        const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
-        return initObject(this.db, schemaTables, __privateGet$4(this, _table), response);
-      } catch (e) {
-        if (isObject(e) && e.status === 404) {
-          return null;
+    return __privateGet$4(this, _trace).call(this, "read", async () => {
+      const columns = isStringArray(b) ? b : ["*"];
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        const ids = a.map((item) => extractId(item));
+        const finalObjects = await this.getAll({ filter: { id: { $any: compact(ids) } }, columns });
+        const dictionary = finalObjects.reduce((acc, object) => {
+          acc[object.id] = object;
+          return acc;
+        }, {});
+        return ids.map((id2) => dictionary[id2 ?? ""] ?? null);
+      }
+      const id = extractId(a);
+      if (id) {
+        const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
+        try {
+          const response = await getRecord({
+            pathParams: {
+              workspace: "{workspaceId}",
+              dbBranchName: "{dbBranch}",
+              region: "{region}",
+              tableName: __privateGet$4(this, _table),
+              recordId: id
+            },
+            queryParams: { columns },
+            ...fetchProps
+          });
+          const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
+          return initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), response, columns);
+        } catch (e) {
+          if (isObject(e) && e.status === 404) {
+            return null;
+          }
+          throw e;
         }
-        throw e;
       }
-    }
-    return null;
+      return null;
+    });
+  }
+  async readOrThrow(a, b) {
+    return __privateGet$4(this, _trace).call(this, "readOrThrow", async () => {
+      const result = await this.read(a, b);
+      if (Array.isArray(result)) {
+        const missingIds = compact(
+          a.filter((_item, index) => result[index] === null).map((item) => extractId(item))
+        );
+        if (missingIds.length > 0) {
+          throw new Error(`Could not find records with ids: ${missingIds.join(", ")}`);
+        }
+        return result;
+      }
+      if (result === null) {
+        const id = extractId(a) ?? "unknown";
+        throw new Error(`Record with id ${id} not found`);
+      }
+      return result;
+    });
   }
-  async update(a, b, c) {
-    if (Array.isArray(a)) {
-      if (a.length === 0)
-        return [];
-      if (a.length > 100) {
-        console.warn("Bulk update operation is not optimized in the Xata API yet, this request might be slow");
+  async update(a, b, c, d) {
+    return __privateGet$4(this, _trace).call(this, "update", async () => {
+      const ifVersion = parseIfVersion(b, c, d);
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        if (a.length > 100) {
+          console.warn("Bulk update operation is not optimized in the Xata API yet, this request might be slow");
+        }
+        const columns = isStringArray(b) ? b : ["*"];
+        return Promise.all(a.map((object) => this.update(object, columns)));
       }
-      const columns = isStringArray(b) ? b : ["*"];
-      return Promise.all(a.map((object) => this.update(object, columns)));
-    }
-    if (isString(a) && isObject(b)) {
-      const columns = isStringArray(c) ? c : void 0;
-      return __privateMethod$2(this, _updateRecordWithID, updateRecordWithID_fn).call(this, a, b, columns);
-    }
-    if (isObject(a) && isString(a.id)) {
-      const columns = isStringArray(b) ? b : void 0;
-      return __privateMethod$2(this, _updateRecordWithID, updateRecordWithID_fn).call(this, a.id, { ...a, id: void 0 }, columns);
-    }
-    throw new Error("Invalid arguments for update method");
-  }
-  async createOrUpdate(a, b, c) {
-    if (Array.isArray(a)) {
-      if (a.length === 0)
-        return [];
-      if (a.length > 100) {
-        console.warn("Bulk update operation is not optimized in the Xata API yet, this request might be slow");
+      if (isString(a) && isObject(b)) {
+        const columns = isStringArray(c) ? c : void 0;
+        return __privateMethod$2(this, _updateRecordWithID, updateRecordWithID_fn).call(this, a, b, columns, { ifVersion });
       }
-      const columns = isStringArray(b) ? b : ["*"];
-      return Promise.all(a.map((object) => this.createOrUpdate(object, columns)));
-    }
-    if (isString(a) && isObject(b)) {
-      const columns = isStringArray(c) ? c : void 0;
-      return __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a, b, columns);
-    }
-    if (isObject(a) && isString(a.id)) {
-      const columns = isStringArray(c) ? c : void 0;
-      return __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a.id, { ...a, id: void 0 }, columns);
-    }
-    throw new Error("Invalid arguments for createOrUpdate method");
-  }
-  async delete(a) {
-    if (Array.isArray(a)) {
-      if (a.length === 0)
-        return;
-      if (a.length > 100) {
-        console.warn("Bulk delete operation is not optimized in the Xata API yet, this request might be slow");
+      if (isObject(a) && isString(a.id)) {
+        const columns = isStringArray(b) ? b : void 0;
+        return __privateMethod$2(this, _updateRecordWithID, updateRecordWithID_fn).call(this, a.id, { ...a, id: void 0 }, columns, { ifVersion });
       }
-      await Promise.all(a.map((id) => this.delete(id)));
-      return;
-    }
-    if (isString(a)) {
-      await __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a);
-      return;
-    }
-    if (isObject(a) && isString(a.id)) {
-      await __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a.id);
-      return;
-    }
-    throw new Error("Invalid arguments for delete method");
+      throw new Error("Invalid arguments for update method");
+    });
+  }
+  async updateOrThrow(a, b, c, d) {
+    return __privateGet$4(this, _trace).call(this, "updateOrThrow", async () => {
+      const result = await this.update(a, b, c, d);
+      if (Array.isArray(result)) {
+        const missingIds = compact(
+          a.filter((_item, index) => result[index] === null).map((item) => extractId(item))
+        );
+        if (missingIds.length > 0) {
+          throw new Error(`Could not find records with ids: ${missingIds.join(", ")}`);
+        }
+        return result;
+      }
+      if (result === null) {
+        const id = extractId(a) ?? "unknown";
+        throw new Error(`Record with id ${id} not found`);
+      }
+      return result;
+    });
+  }
+  async createOrUpdate(a, b, c, d) {
+    return __privateGet$4(this, _trace).call(this, "createOrUpdate", async () => {
+      const ifVersion = parseIfVersion(b, c, d);
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        if (a.length > 100) {
+          console.warn("Bulk update operation is not optimized in the Xata API yet, this request might be slow");
+        }
+        const columns = isStringArray(b) ? b : ["*"];
+        return Promise.all(a.map((object) => this.createOrUpdate(object, columns)));
+      }
+      if (isString(a) && isObject(b)) {
+        const columns = isStringArray(c) ? c : void 0;
+        return __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a, b, columns, { ifVersion });
+      }
+      if (isObject(a) && isString(a.id)) {
+        const columns = isStringArray(c) ? c : void 0;
+        return __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a.id, { ...a, id: void 0 }, columns, { ifVersion });
+      }
+      throw new Error("Invalid arguments for createOrUpdate method");
+    });
+  }
+  async createOrReplace(a, b, c, d) {
+    return __privateGet$4(this, _trace).call(this, "createOrReplace", async () => {
+      const ifVersion = parseIfVersion(b, c, d);
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        const columns = isStringArray(b) ? b : ["*"];
+        return __privateMethod$2(this, _bulkInsertTableRecords, bulkInsertTableRecords_fn).call(this, a, columns);
+      }
+      if (isString(a) && isObject(b)) {
+        const columns = isStringArray(c) ? c : void 0;
+        return __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a, b, columns, { createOnly: false, ifVersion });
+      }
+      if (isObject(a) && isString(a.id)) {
+        const columns = isStringArray(c) ? c : void 0;
+        return __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a.id, { ...a, id: void 0 }, columns, { createOnly: false, ifVersion });
+      }
+      throw new Error("Invalid arguments for createOrReplace method");
+    });
+  }
+  async delete(a, b) {
+    return __privateGet$4(this, _trace).call(this, "delete", async () => {
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        if (a.length > 100) {
+          console.warn("Bulk delete operation is not optimized in the Xata API yet, this request might be slow");
+        }
+        return Promise.all(a.map((id) => this.delete(id, b)));
+      }
+      if (isString(a)) {
+        return __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a, b);
+      }
+      if (isObject(a) && isString(a.id)) {
+        return __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a.id, b);
+      }
+      throw new Error("Invalid arguments for delete method");
+    });
+  }
+  async deleteOrThrow(a, b) {
+    return __privateGet$4(this, _trace).call(this, "deleteOrThrow", async () => {
+      const result = await this.delete(a, b);
+      if (Array.isArray(result)) {
+        const missingIds = compact(
+          a.filter((_item, index) => result[index] === null).map((item) => extractId(item))
+        );
+        if (missingIds.length > 0) {
+          throw new Error(`Could not find records with ids: ${missingIds.join(", ")}`);
+        }
+        return result;
+      } else if (result === null) {
+        const id = extractId(a) ?? "unknown";
+        throw new Error(`Record with id ${id} not found`);
+      }
+      return result;
+    });
   }
   async search(query, options = {}) {
-    const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
-    const { records } = await searchTable({
-      pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table) },
-      body: {
-        query,
-        fuzziness: options.fuzziness,
-        prefix: options.prefix,
-        highlight: options.highlight,
-        filter: options.filter,
-        boosters: options.boosters
-      },
-      ...fetchProps
+    return __privateGet$4(this, _trace).call(this, "search", async () => {
+      const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
+      const { records } = await searchTable({
+        pathParams: {
+          workspace: "{workspaceId}",
+          dbBranchName: "{dbBranch}",
+          region: "{region}",
+          tableName: __privateGet$4(this, _table)
+        },
+        body: {
+          query,
+          fuzziness: options.fuzziness,
+          prefix: options.prefix,
+          highlight: options.highlight,
+          filter: options.filter,
+          boosters: options.boosters
+        },
+        ...fetchProps
+      });
+      const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
+      return records.map((item) => initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), item, ["*"]));
+    });
+  }
+  async aggregate(aggs, filter) {
+    return __privateGet$4(this, _trace).call(this, "aggregate", async () => {
+      const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
+      const result = await aggregateTable({
+        pathParams: {
+          workspace: "{workspaceId}",
+          dbBranchName: "{dbBranch}",
+          region: "{region}",
+          tableName: __privateGet$4(this, _table)
+        },
+        body: { aggs, filter },
+        ...fetchProps
+      });
+      return result;
     });
-    const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
-    return records.map((item) => initObject(this.db, schemaTables, __privateGet$4(this, _table), item));
   }
   async query(query) {
-    const cacheQuery = await __privateMethod$2(this, _getCacheQuery, getCacheQuery_fn).call(this, query);
-    if (cacheQuery)
-      return new Page(query, cacheQuery.meta, cacheQuery.records);
-    const data = query.getQueryOptions();
-    const body = {
-      filter: Object.values(data.filter ?? {}).some(Boolean) ? data.filter : void 0,
-      sort: data.sort !== void 0 ? buildSortFilter(data.sort) : void 0,
-      page: data.pagination,
-      columns: data.columns
-    };
-    const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
-    const { meta, records: objects } = await queryTable({
-      pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table) },
-      body,
-      ...fetchProps
+    return __privateGet$4(this, _trace).call(this, "query", async () => {
+      const cacheQuery = await __privateMethod$2(this, _getCacheQuery, getCacheQuery_fn).call(this, query);
+      if (cacheQuery)
+        return new Page(query, cacheQuery.meta, cacheQuery.records);
+      const data = query.getQueryOptions();
+      const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
+      const { meta, records: objects } = await queryTable({
+        pathParams: {
+          workspace: "{workspaceId}",
+          dbBranchName: "{dbBranch}",
+          region: "{region}",
+          tableName: __privateGet$4(this, _table)
+        },
+        body: {
+          filter: cleanFilter(data.filter),
+          sort: data.sort !== void 0 ? buildSortFilter(data.sort) : void 0,
+          page: data.pagination,
+          columns: data.columns ?? ["*"]
+        },
+        ...fetchProps
+      });
+      const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
+      const records = objects.map(
+        (record) => initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), record, data.columns ?? ["*"])
+      );
+      await __privateMethod$2(this, _setCacheQuery, setCacheQuery_fn).call(this, query, meta, records);
+      return new Page(query, meta, records);
+    });
+  }
+  async summarizeTable(query, summaries, summariesFilter) {
+    return __privateGet$4(this, _trace).call(this, "summarize", async () => {
+      const data = query.getQueryOptions();
+      const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
+      const result = await summarizeTable({
+        pathParams: {
+          workspace: "{workspaceId}",
+          dbBranchName: "{dbBranch}",
+          region: "{region}",
+          tableName: __privateGet$4(this, _table)
+        },
+        body: {
+          filter: cleanFilter(data.filter),
+          sort: data.sort !== void 0 ? buildSortFilter(data.sort) : void 0,
+          columns: data.columns,
+          page: data.pagination?.size !== void 0 ? { size: data.pagination?.size } : void 0,
+          summaries,
+          summariesFilter
+        },
+        ...fetchProps
+      });
+      return result;
     });
-    const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
-    const records = objects.map((record) => initObject(this.db, schemaTables, __privateGet$4(this, _table), record));
-    await __privateMethod$2(this, _setCacheQuery, setCacheQuery_fn).call(this, query, meta, records);
-    return new Page(query, meta, records);
   }
 }
 _table = new WeakMap();
 _getFetchProps = new WeakMap();
+_db = new WeakMap();
 _cache = new WeakMap();
 _schemaTables$2 = new WeakMap();
+_trace = new WeakMap();
 _insertRecordWithoutId = new WeakSet();
 insertRecordWithoutId_fn = async function(object, columns = ["*"]) {
   const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
@@ -1502,6 +2469,7 @@ insertRecordWithoutId_fn = async function(object, columns = ["*"]) {
     pathParams: {
       workspace: "{workspaceId}",
       dbBranchName: "{dbBranch}",
+      region: "{region}",
       tableName: __privateGet$4(this, _table)
     },
     queryParams: { columns },
@@ -1509,32 +2477,38 @@ insertRecordWithoutId_fn = async function(object, columns = ["*"]) {
     ...fetchProps
   });
   const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
-  return initObject(this.db, schemaTables, __privateGet$4(this, _table), response);
+  return initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), response, columns);
 };
 _insertRecordWithId = new WeakSet();
-insertRecordWithId_fn = async function(recordId, object, columns = ["*"]) {
+insertRecordWithId_fn = async function(recordId, object, columns = ["*"], { createOnly, ifVersion }) {
   const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const record = transformObjectLinks(object);
   const response = await insertRecordWithID({
     pathParams: {
       workspace: "{workspaceId}",
       dbBranchName: "{dbBranch}",
+      region: "{region}",
       tableName: __privateGet$4(this, _table),
       recordId
     },
     body: record,
-    queryParams: { createOnly: true, columns },
+    queryParams: { createOnly, columns, ifVersion },
     ...fetchProps
   });
   const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
-  return initObject(this.db, schemaTables, __privateGet$4(this, _table), response);
+  return initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), response, columns);
 };
 _bulkInsertTableRecords = new WeakSet();
 bulkInsertTableRecords_fn = async function(objects, columns = ["*"]) {
   const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const records = objects.map((object) => transformObjectLinks(object));
   const response = await bulkInsertTableRecords({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table) },
+    pathParams: {
+      workspace: "{workspaceId}",
+      dbBranchName: "{dbBranch}",
+      region: "{region}",
+      tableName: __privateGet$4(this, _table)
+    },
     queryParams: { columns },
     body: { records },
     ...fetchProps
@@ -1543,40 +2517,75 @@ bulkInsertTableRecords_fn = async function(objects, columns = ["*"]) {
     throw new Error("Request included columns but server didn't include them");
   }
   const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
-  return response.records?.map((item) => initObject(this.db, schemaTables, __privateGet$4(this, _table), item));
+  return response.records?.map((item) => initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), item, columns));
 };
 _updateRecordWithID = new WeakSet();
-updateRecordWithID_fn = async function(recordId, object, columns = ["*"]) {
+updateRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVersion }) {
   const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const record = transformObjectLinks(object);
-  const response = await updateRecordWithID({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table), recordId },
-    queryParams: { columns },
-    body: record,
-    ...fetchProps
-  });
-  const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
-  return initObject(this.db, schemaTables, __privateGet$4(this, _table), response);
+  try {
+    const response = await updateRecordWithID({
+      pathParams: {
+        workspace: "{workspaceId}",
+        dbBranchName: "{dbBranch}",
+        region: "{region}",
+        tableName: __privateGet$4(this, _table),
+        recordId
+      },
+      queryParams: { columns, ifVersion },
+      body: record,
+      ...fetchProps
+    });
+    const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
+    return initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), response, columns);
+  } catch (e) {
+    if (isObject(e) && e.status === 404) {
+      return null;
+    }
+    throw e;
+  }
 };
 _upsertRecordWithID = new WeakSet();
-upsertRecordWithID_fn = async function(recordId, object, columns = ["*"]) {
+upsertRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVersion }) {
   const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const response = await upsertRecordWithID({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table), recordId },
-    queryParams: { columns },
+    pathParams: {
+      workspace: "{workspaceId}",
+      dbBranchName: "{dbBranch}",
+      region: "{region}",
+      tableName: __privateGet$4(this, _table),
+      recordId
+    },
+    queryParams: { columns, ifVersion },
     body: object,
     ...fetchProps
   });
   const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
-  return initObject(this.db, schemaTables, __privateGet$4(this, _table), response);
+  return initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), response, columns);
 };
 _deleteRecord = new WeakSet();
-deleteRecord_fn = async function(recordId) {
+deleteRecord_fn = async function(recordId, columns = ["*"]) {
   const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
-  await deleteRecord({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table), recordId },
-    ...fetchProps
-  });
+  try {
+    const response = await deleteRecord({
+      pathParams: {
+        workspace: "{workspaceId}",
+        dbBranchName: "{dbBranch}",
+        region: "{region}",
+        tableName: __privateGet$4(this, _table),
+        recordId
+      },
+      queryParams: { columns },
+      ...fetchProps
+    });
+    const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
+    return initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), response, columns);
+  } catch (e) {
+    if (isObject(e) && e.status === 404) {
+      return null;
+    }
+    throw e;
+  }
 };
 _setCacheQuery = new WeakSet();
 setCacheQuery_fn = async function(query, meta, records) {
@@ -1600,7 +2609,7 @@ getSchemaTables_fn$1 = async function() {
     return __privateGet$4(this, _schemaTables$2);
   const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const { schema } = await getBranchDetails({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}" },
+    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", region: "{region}" },
     ...fetchProps
   });
   __privateSet$4(this, _schemaTables$2, schema.tables);
@@ -1613,7 +2622,7 @@ const transformObjectLinks = (object) => {
     return { ...acc, [key]: isIdentifiable(value) ? value.id : value };
   }, {});
 };
-const initObject = (db, schemaTables, table, object) => {
+const initObject = (db, schemaTables, table, object, selectedColumns) => {
   const result = {};
   const { xata, ...rest } = object ?? {};
   Object.assign(result, rest);
@@ -1621,6 +2630,8 @@ const initObject = (db, schemaTables, table, object) => {
   if (!columns)
     console.error(`Table ${table} not found in schema`);
   for (const column of columns ?? []) {
+    if (!isValidColumn(selectedColumns, column))
+      continue;
     const value = result[column.name];
     switch (column.type) {
       case "datetime": {
@@ -1637,17 +2648,42 @@ const initObject = (db, schemaTables, table, object) => {
         if (!linkTable) {
           console.error(`Failed to parse link for field ${column.name}`);
         } else if (isObject(value)) {
-          result[column.name] = initObject(db, schemaTables, linkTable, value);
+          const selectedLinkColumns = selectedColumns.reduce((acc, item) => {
+            if (item === column.name) {
+              return [...acc, "*"];
+            }
+            if (item.startsWith(`${column.name}.`)) {
+              const [, ...path] = item.split(".");
+              return [...acc, path.join(".")];
+            }
+            return acc;
+          }, []);
+          result[column.name] = initObject(db, schemaTables, linkTable, value, selectedLinkColumns);
+        } else {
+          result[column.name] = null;
         }
         break;
       }
+      default:
+        result[column.name] = value ?? null;
+        if (column.notNull === true && value === null) {
+          console.error(`Parse error, column ${column.name} is non nullable and value resolves null`);
+        }
+        break;
     }
   }
   result.read = function(columns2) {
     return db[table].read(result["id"], columns2);
   };
-  result.update = function(data, columns2) {
-    return db[table].update(result["id"], data, columns2);
+  result.update = function(data, b, c) {
+    const columns2 = isStringArray(b) ? b : ["*"];
+    const ifVersion = parseIfVersion(b, c);
+    return db[table].update(result["id"], data, columns2, { ifVersion });
+  };
+  result.replace = function(data, b, c) {
+    const columns2 = isStringArray(b) ? b : ["*"];
+    const ifVersion = parseIfVersion(b, c);
+    return db[table].createOrReplace(result["id"], data, columns2, { ifVersion });
   };
   result.delete = function() {
     return db[table].delete(result["id"]);
@@ -1655,7 +2691,7 @@ const initObject = (db, schemaTables, table, object) => {
   result.getMetadata = function() {
     return xata;
   };
-  for (const prop of ["read", "update", "delete", "getMetadata"]) {
+  for (const prop of ["read", "update", "replace", "delete", "getMetadata"]) {
     Object.defineProperty(result, prop, { enumerable: false });
   }
   Object.freeze(result);
@@ -1664,6 +2700,30 @@ const initObject = (db, schemaTables, table, object) => {
 function isResponseWithRecords(value) {
   return isObject(value) && Array.isArray(value.records);
 }
+function extractId(value) {
+  if (isString(value))
+    return value;
+  if (isObject(value) && isString(value.id))
+    return value.id;
+  return void 0;
+}
+function isValidColumn(columns, column) {
+  if (columns.includes("*"))
+    return true;
+  if (column.type === "link") {
+    const linkColumns = columns.filter((item) => item.startsWith(column.name));
+    return linkColumns.length > 0;
+  }
+  return columns.includes(column.name);
+}
+function parseIfVersion(...args) {
+  for (const arg of args) {
+    if (isObject(arg) && isNumber(arg.ifVersion)) {
+      return arg.ifVersion;
+    }
+  }
+  return void 0;
+}
 
 var __accessCheck$3 = (obj, member, msg) => {
   if (!member.has(obj))
@@ -1714,18 +2774,25 @@ class SimpleCache {
 }
 _map = new WeakMap();
 
-const gt = (value) => ({ $gt: value });
-const ge = (value) => ({ $ge: value });
-const gte = (value) => ({ $ge: value });
-const lt = (value) => ({ $lt: value });
-const lte = (value) => ({ $le: value });
-const le = (value) => ({ $le: value });
+const greaterThan = (value) => ({ $gt: value });
+const gt = greaterThan;
+const greaterThanEquals = (value) => ({ $ge: value });
+const greaterEquals = greaterThanEquals;
+const gte = greaterThanEquals;
+const ge = greaterThanEquals;
+const lessThan = (value) => ({ $lt: value });
+const lt = lessThan;
+const lessThanEquals = (value) => ({ $le: value });
+const lessEquals = lessThanEquals;
+const lte = lessThanEquals;
+const le = lessThanEquals;
 const exists = (column) => ({ $exists: column });
 const notExists = (column) => ({ $notExists: column });
 const startsWith = (value) => ({ $startsWith: value });
 const endsWith = (value) => ({ $endsWith: value });
 const pattern = (value) => ({ $pattern: value });
 const is = (value) => ({ $is: value });
+const equals = is;
 const isNot = (value) => ({ $isNot: value });
 const contains = (value) => ({ $contains: value });
 const includes = (value) => ({ $includes: value });
@@ -1760,16 +2827,19 @@ class SchemaPlugin extends XataPlugin {
     __privateSet$2(this, _schemaTables$1, schemaTables);
   }
   build(pluginOptions) {
-    const db = new Proxy({}, {
-      get: (_target, table) => {
-        if (!isString(table))
-          throw new Error("Invalid table name");
-        if (__privateGet$2(this, _tables)[table] === void 0) {
-          __privateGet$2(this, _tables)[table] = new RestRepository({ db, pluginOptions, table, schemaTables: __privateGet$2(this, _schemaTables$1) });
+    const db = new Proxy(
+      {},
+      {
+        get: (_target, table) => {
+          if (!isString(table))
+            throw new Error("Invalid table name");
+          if (__privateGet$2(this, _tables)[table] === void 0) {
+            __privateGet$2(this, _tables)[table] = new RestRepository({ db, pluginOptions, table, schemaTables: __privateGet$2(this, _schemaTables$1) });
+          }
+          return __privateGet$2(this, _tables)[table];
         }
-        return __privateGet$2(this, _tables)[table];
       }
-    });
+    );
     const tableNames = __privateGet$2(this, _schemaTables$1)?.map(({ name }) => name) ?? [];
     for (const table of tableNames) {
       db[table] = new RestRepository({ db, pluginOptions, table, schemaTables: __privateGet$2(this, _schemaTables$1) });
@@ -1819,7 +2889,7 @@ class SearchPlugin extends XataPlugin {
         const schemaTables = await __privateMethod$1(this, _getSchemaTables, getSchemaTables_fn).call(this, getFetchProps);
         return records.map((record) => {
           const { table = "orphan" } = record.xata;
-          return { table, record: initObject(this.db, schemaTables, table, record) };
+          return { table, record: initObject(this.db, schemaTables, table, record, ["*"]) };
         });
       },
       byTable: async (query, options = {}) => {
@@ -1828,7 +2898,7 @@ class SearchPlugin extends XataPlugin {
         return records.reduce((acc, record) => {
           const { table = "orphan" } = record.xata;
           const items = acc[table] ?? [];
-          const item = initObject(this.db, schemaTables, table, record);
+          const item = initObject(this.db, schemaTables, table, record, ["*"]);
           return { ...acc, [table]: [...items, item] };
         }, {});
       }
@@ -1841,7 +2911,7 @@ search_fn = async function(query, options, getFetchProps) {
   const fetchProps = await getFetchProps();
   const { tables, fuzziness, highlight, prefix } = options ?? {};
   const { records } = await searchBranch({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}" },
+    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", region: "{region}" },
     body: { tables, query, fuzziness, prefix, highlight },
     ...fetchProps
   });
@@ -1853,7 +2923,7 @@ getSchemaTables_fn = async function(getFetchProps) {
     return __privateGet$1(this, _schemaTables);
   const fetchProps = await getFetchProps();
   const { schema } = await getBranchDetails({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}" },
+    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", region: "{region}" },
     ...fetchProps
   });
   __privateSet$1(this, _schemaTables, schema.tables);
@@ -1883,19 +2953,27 @@ async function resolveXataBranch(gitBranch, options) {
   const databaseURL = options?.databaseURL || getDatabaseURL();
   const apiKey = options?.apiKey || getAPIKey();
   if (!databaseURL)
-    throw new Error("A databaseURL was not defined. Either set the XATA_DATABASE_URL env variable or pass the argument explicitely");
+    throw new Error(
+      "A databaseURL was not defined. Either set the XATA_DATABASE_URL env variable or pass the argument explicitely"
+    );
   if (!apiKey)
-    throw new Error("An API key was not defined. Either set the XATA_API_KEY env variable or pass the argument explicitely");
+    throw new Error(
+      "An API key was not defined. Either set the XATA_API_KEY env variable or pass the argument explicitely"
+    );
   const [protocol, , host, , dbName] = databaseURL.split("/");
-  const [workspace] = host.split(".");
+  const urlParts = parseWorkspacesUrlParts(host);
+  if (!urlParts)
+    throw new Error(`Unable to parse workspace and region: ${databaseURL}`);
+  const { workspace, region } = urlParts;
   const { fallbackBranch } = getEnvironment();
   const { branch } = await resolveBranch({
     apiKey,
     apiUrl: databaseURL,
     fetchImpl: getFetchImplementation(options?.fetchImpl),
     workspacesApiUrl: `${protocol}//${host}`,
-    pathParams: { dbName, workspace },
-    queryParams: { gitBranch, fallbackBranch }
+    pathParams: { dbName, workspace, region },
+    queryParams: { gitBranch, fallbackBranch },
+    trace: defaultTrace
   });
   return branch;
 }
@@ -1903,19 +2981,26 @@ async function getDatabaseBranch(branch, options) {
   const databaseURL = options?.databaseURL || getDatabaseURL();
   const apiKey = options?.apiKey || getAPIKey();
   if (!databaseURL)
-    throw new Error("A databaseURL was not defined. Either set the XATA_DATABASE_URL env variable or pass the argument explicitely");
+    throw new Error(
+      "A databaseURL was not defined. Either set the XATA_DATABASE_URL env variable or pass the argument explicitely"
+    );
   if (!apiKey)
-    throw new Error("An API key was not defined. Either set the XATA_API_KEY env variable or pass the argument explicitely");
+    throw new Error(
+      "An API key was not defined. Either set the XATA_API_KEY env variable or pass the argument explicitely"
+    );
   const [protocol, , host, , database] = databaseURL.split("/");
-  const [workspace] = host.split(".");
-  const dbBranchName = `${database}:${branch}`;
+  const urlParts = parseWorkspacesUrlParts(host);
+  if (!urlParts)
+    throw new Error(`Unable to parse workspace and region: ${databaseURL}`);
+  const { workspace, region } = urlParts;
   try {
     return await getBranchDetails({
       apiKey,
       apiUrl: databaseURL,
       fetchImpl: getFetchImplementation(options?.fetchImpl),
       workspacesApiUrl: `${protocol}//${host}`,
-      pathParams: { dbBranchName, workspace }
+      pathParams: { dbBranchName: `${database}:${branch}`, workspace, region },
+      trace: defaultTrace
     });
   } catch (err) {
     if (isObject(err) && err.status === 404)
@@ -1955,17 +3040,20 @@ var __privateMethod = (obj, member, method) => {
   return method;
 };
 const buildClient = (plugins) => {
-  var _branch, _parseOptions, parseOptions_fn, _getFetchProps, getFetchProps_fn, _evaluateBranch, evaluateBranch_fn, _a;
+  var _branch, _options, _parseOptions, parseOptions_fn, _getFetchProps, getFetchProps_fn, _evaluateBranch, evaluateBranch_fn, _a;
   return _a = class {
     constructor(options = {}, schemaTables) {
       __privateAdd(this, _parseOptions);
       __privateAdd(this, _getFetchProps);
       __privateAdd(this, _evaluateBranch);
       __privateAdd(this, _branch, void 0);
+      __privateAdd(this, _options, void 0);
       const safeOptions = __privateMethod(this, _parseOptions, parseOptions_fn).call(this, options);
+      __privateSet(this, _options, safeOptions);
       const pluginOptions = {
         getFetchProps: () => __privateMethod(this, _getFetchProps, getFetchProps_fn).call(this, safeOptions),
-        cache: safeOptions.cache
+        cache: safeOptions.cache,
+        trace: safeOptions.trace
       };
       const db = new SchemaPlugin(schemaTables).build(pluginOptions);
       const search = new SearchPlugin(db, schemaTables).build(pluginOptions);
@@ -1984,22 +3072,26 @@ const buildClient = (plugins) => {
         }
       }
     }
-  }, _branch = new WeakMap(), _parseOptions = new WeakSet(), parseOptions_fn = function(options) {
+    async getConfig() {
+      const databaseURL = __privateGet(this, _options).databaseURL;
+      const branch = await __privateGet(this, _options).branch();
+      return { databaseURL, branch };
+    }
+  }, _branch = new WeakMap(), _options = new WeakMap(), _parseOptions = new WeakSet(), parseOptions_fn = function(options) {
     const fetch = getFetchImplementation(options?.fetch);
     const databaseURL = options?.databaseURL || getDatabaseURL();
     const apiKey = options?.apiKey || getAPIKey();
     const cache = options?.cache ?? new SimpleCache({ defaultQueryTTL: 0 });
+    const trace = options?.trace ?? defaultTrace;
     const branch = async () => options?.branch !== void 0 ? await __privateMethod(this, _evaluateBranch, evaluateBranch_fn).call(this, options.branch) : await getCurrentBranchName({ apiKey, databaseURL, fetchImpl: options?.fetch });
-    if (!databaseURL || !apiKey) {
-      throw new Error("Options databaseURL and apiKey are required");
+    if (!apiKey) {
+      throw new Error("Option apiKey is required");
     }
-    return { fetch, databaseURL, apiKey, branch, cache };
-  }, _getFetchProps = new WeakSet(), getFetchProps_fn = async function({
-    fetch,
-    apiKey,
-    databaseURL,
-    branch
-  }) {
+    if (!databaseURL) {
+      throw new Error("Option databaseURL is required");
+    }
+    return { fetch, databaseURL, apiKey, branch, cache, trace, clientID: generateUUID() };
+  }, _getFetchProps = new WeakSet(), getFetchProps_fn = async function({ fetch, apiKey, databaseURL, branch, trace, clientID }) {
     const branchValue = await __privateMethod(this, _evaluateBranch, evaluateBranch_fn).call(this, branch);
     if (!branchValue)
       throw new Error("Unable to resolve branch value");
@@ -2009,9 +3101,11 @@ const buildClient = (plugins) => {
       apiUrl: "",
       workspacesApiUrl: (path, params) => {
         const hasBranch = params.dbBranchName ?? params.branch;
-        const newPath = path.replace(/^\/db\/[^/]+/, hasBranch ? `:${branchValue}` : "");
+        const newPath = path.replace(/^\/db\/[^/]+/, hasBranch !== void 0 ? `:${branchValue}` : "");
         return databaseURL + newPath;
-      }
+      },
+      trace,
+      clientID
     };
   }, _evaluateBranch = new WeakSet(), evaluateBranch_fn = async function(param) {
     if (__privateGet(this, _branch))
@@ -2034,6 +3128,88 @@ const buildClient = (plugins) => {
 class BaseClient extends buildClient() {
 }
 
+const META = "__";
+const VALUE = "___";
+class Serializer {
+  constructor() {
+    this.classes = {};
+  }
+  add(clazz) {
+    this.classes[clazz.name] = clazz;
+  }
+  toJSON(data) {
+    function visit(obj) {
+      if (Array.isArray(obj))
+        return obj.map(visit);
+      const type = typeof obj;
+      if (type === "undefined")
+        return { [META]: "undefined" };
+      if (type === "bigint")
+        return { [META]: "bigint", [VALUE]: obj.toString() };
+      if (obj === null || type !== "object")
+        return obj;
+      const constructor = obj.constructor;
+      const o = { [META]: constructor.name };
+      for (const [key, value] of Object.entries(obj)) {
+        o[key] = visit(value);
+      }
+      if (constructor === Date)
+        o[VALUE] = obj.toISOString();
+      if (constructor === Map)
+        o[VALUE] = Object.fromEntries(obj);
+      if (constructor === Set)
+        o[VALUE] = [...obj];
+      return o;
+    }
+    return JSON.stringify(visit(data));
+  }
+  fromJSON(json) {
+    return JSON.parse(json, (key, value) => {
+      if (value && typeof value === "object" && !Array.isArray(value)) {
+        const { [META]: clazz, [VALUE]: val, ...rest } = value;
+        const constructor = this.classes[clazz];
+        if (constructor) {
+          return Object.assign(Object.create(constructor.prototype), rest);
+        }
+        if (clazz === "Date")
+          return new Date(val);
+        if (clazz === "Set")
+          return new Set(val);
+        if (clazz === "Map")
+          return new Map(Object.entries(val));
+        if (clazz === "bigint")
+          return BigInt(val);
+        if (clazz === "undefined")
+          return void 0;
+        return rest;
+      }
+      return value;
+    });
+  }
+}
+const defaultSerializer = new Serializer();
+const serialize = (data) => {
+  return defaultSerializer.toJSON(data);
+};
+const deserialize = (json) => {
+  return defaultSerializer.fromJSON(json);
+};
+
+function buildWorkerRunner(config) {
+  return function xataWorker(name, _worker) {
+    return async (...args) => {
+      const url = process.env.NODE_ENV === "development" ? `http://localhost:64749/${name}` : `https://dispatcher.xata.workers.dev/${config.workspace}/${config.worker}/${name}`;
+      const result = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: serialize({ args })
+      });
+      const text = await result.text();
+      return deserialize(text);
+    };
+  };
+}
+
 class XataError extends Error {
   constructor(message, status) {
     super(message);
@@ -2041,5 +3217,5 @@ class XataError extends Error {
   }
 }
 
-export { BaseClient, operationsByTag as Operations, PAGINATION_DEFAULT_OFFSET, PAGINATION_DEFAULT_SIZE, PAGINATION_MAX_OFFSET, PAGINATION_MAX_SIZE, Page, Query, RecordArray, Repository, RestRepository, SchemaPlugin, SearchPlugin, SimpleCache, XataApiClient, XataApiPlugin, XataError, XataPlugin, 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, 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 };
+export { BaseClient, operationsByTag as Operations, PAGINATION_DEFAULT_OFFSET, PAGINATION_DEFAULT_SIZE, PAGINATION_MAX_OFFSET, PAGINATION_MAX_SIZE, Page, Query, RecordArray, Repository, RestRepository, SchemaPlugin, SearchPlugin, Serializer, SimpleCache, XataApiClient, XataApiPlugin, XataError, XataPlugin, acceptWorkspaceMemberInvite, addGitBranchesEntry, addTableColumn, aggregateTable, applyBranchSchemaEdit, branchTransaction, buildClient, buildWorkerRunner, bulkInsertTableRecords, cancelWorkspaceMemberInvite, compareBranchSchemas, compareBranchWithUserSchema, compareMigrationRequest, contains, createBranch, createDatabase, createMigrationRequest, createTable, createUserAPIKey, createWorkspace, dEPRECATEDcreateDatabase, dEPRECATEDdeleteDatabase, dEPRECATEDgetDatabaseList, dEPRECATEDgetDatabaseMetadata, dEPRECATEDupdateDatabaseMetadata, deleteBranch, deleteColumn, deleteDatabase, deleteRecord, deleteTable, deleteUser, deleteUserAPIKey, deleteWorkspace, deserialize, endsWith, equals, executeBranchMigrationPlan, exists, ge, getAPIKey, getBranchDetails, getBranchList, getBranchMetadata, getBranchMigrationHistory, getBranchMigrationPlan, getBranchSchemaHistory, getBranchStats, getColumn, getCurrentBranchDetails, getCurrentBranchName, getDatabaseList, getDatabaseMetadata, getDatabaseURL, getGitBranchesMapping, getHostUrl, getMigrationRequest, getMigrationRequestIsMerged, getRecord, getTableColumns, getTableSchema, getUser, getUserAPIKeys, getWorkspace, getWorkspaceMembersList, getWorkspacesList, greaterEquals, greaterThan, greaterThanEquals, gt, gte, includes, includesAll, includesAny, includesNone, insertRecord, insertRecordWithID, inviteWorkspaceMember, is, isCursorPaginationOptions, isHostProviderAlias, isHostProviderBuilder, isIdentifiable, isNot, isXataRecord, le, lessEquals, lessThan, lessThanEquals, listMigrationRequestsCommits, listRegions, lt, lte, mergeMigrationRequest, notExists, operationsByTag, parseProviderString, parseWorkspacesUrlParts, pattern, previewBranchSchemaEdit, queryMigrationRequests, queryTable, removeGitBranchesEntry, removeWorkspaceMember, resendWorkspaceMemberInvite, resolveBranch, searchBranch, searchTable, serialize, setTableSchema, startsWith, summarizeTable, updateBranchMetadata, updateBranchSchema, updateColumn, updateDatabaseMetadata, updateMigrationRequest, updateRecordWithID, updateTable, updateUser, updateWorkspace, updateWorkspaceMemberInvite, updateWorkspaceMemberRole, upsertRecordWithID };
 //# sourceMappingURL=index.mjs.map