@xata.io/client 0.0.0-alpha.vfbde008 → 0.0.0-alpha.vfc4a5e4

package/dist/index.cjs

@@ -29,8 +29,11 @@ function notEmpty(value) {
 function compact(arr) {
   return arr.filter(notEmpty);
 }
+function compactObject(obj) {
+  return Object.fromEntries(Object.entries(obj).filter(([, value]) => notEmpty(value)));
+}
 function isObject(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date);
 }
 function isDefined(value) {
   return value !== null && value !== void 0;
@@ -93,8 +96,10 @@ function getEnvironment() {
         apiKey: process.env.XATA_API_KEY ?? getGlobalApiKey(),
         databaseURL: process.env.XATA_DATABASE_URL ?? getGlobalDatabaseURL(),
         branch: process.env.XATA_BRANCH ?? getGlobalBranch(),
-        envBranch: process.env.VERCEL_GIT_COMMIT_REF ?? process.env.CF_PAGES_BRANCH ?? process.env.BRANCH,
-        fallbackBranch: process.env.XATA_FALLBACK_BRANCH ?? getGlobalFallbackBranch()
+        deployPreview: process.env.XATA_PREVIEW,
+        deployPreviewBranch: process.env.XATA_PREVIEW_BRANCH,
+        vercelGitCommitRef: process.env.VERCEL_GIT_COMMIT_REF,
+        vercelGitRepoOwner: process.env.VERCEL_GIT_REPO_OWNER
       };
     }
   } catch (err) {
@@ -105,8 +110,10 @@ function getEnvironment() {
         apiKey: Deno.env.get("XATA_API_KEY") ?? getGlobalApiKey(),
         databaseURL: Deno.env.get("XATA_DATABASE_URL") ?? getGlobalDatabaseURL(),
         branch: Deno.env.get("XATA_BRANCH") ?? getGlobalBranch(),
-        envBranch: Deno.env.get("VERCEL_GIT_COMMIT_REF") ?? Deno.env.get("CF_PAGES_BRANCH") ?? Deno.env.get("BRANCH"),
-        fallbackBranch: Deno.env.get("XATA_FALLBACK_BRANCH") ?? getGlobalFallbackBranch()
+        deployPreview: Deno.env.get("XATA_PREVIEW"),
+        deployPreviewBranch: Deno.env.get("XATA_PREVIEW_BRANCH"),
+        vercelGitCommitRef: Deno.env.get("VERCEL_GIT_COMMIT_REF"),
+        vercelGitRepoOwner: Deno.env.get("VERCEL_GIT_REPO_OWNER")
       };
     }
   } catch (err) {
@@ -115,8 +122,10 @@ function getEnvironment() {
     apiKey: getGlobalApiKey(),
     databaseURL: getGlobalDatabaseURL(),
     branch: getGlobalBranch(),
-    envBranch: void 0,
-    fallbackBranch: getGlobalFallbackBranch()
+    deployPreview: void 0,
+    deployPreviewBranch: void 0,
+    vercelGitCommitRef: void 0,
+    vercelGitRepoOwner: void 0
   };
 }
 function getEnableBrowserVariable() {
@@ -159,42 +168,59 @@ function getGlobalBranch() {
     return void 0;
   }
 }
-function getGlobalFallbackBranch() {
+function getDatabaseURL() {
   try {
-    return XATA_FALLBACK_BRANCH;
+    const { databaseURL } = getEnvironment();
+    return databaseURL;
   } catch (err) {
     return void 0;
   }
 }
-async function getGitBranch() {
-  const cmd = ["git", "branch", "--show-current"];
-  const fullCmd = cmd.join(" ");
-  const nodeModule = ["child", "process"].join("_");
-  const execOptions = { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] };
+function getAPIKey() {
   try {
-    if (typeof require === "function") {
-      return require(nodeModule).execSync(fullCmd, execOptions).trim();
-    }
+    const { apiKey } = getEnvironment();
+    return apiKey;
   } catch (err) {
+    return void 0;
   }
+}
+function getBranch() {
   try {
-    if (isObject(Deno)) {
-      const process2 = Deno.run({ cmd, stdout: "piped", stderr: "null" });
-      return new TextDecoder().decode(await process2.output()).trim();
-    }
+    const { branch } = getEnvironment();
+    return branch ?? "main";
   } catch (err) {
+    return void 0;
   }
 }
-
-function getAPIKey() {
+function buildPreviewBranchName({ org, branch }) {
+  return `preview-${org}-${branch}`;
+}
+function getPreviewBranch() {
   try {
-    const { apiKey } = getEnvironment();
-    return apiKey;
+    const { deployPreview, deployPreviewBranch, vercelGitCommitRef, vercelGitRepoOwner } = getEnvironment();
+    if (deployPreviewBranch)
+      return deployPreviewBranch;
+    switch (deployPreview) {
+      case "vercel": {
+        if (!vercelGitCommitRef || !vercelGitRepoOwner) {
+          console.warn("XATA_PREVIEW=vercel but VERCEL_GIT_COMMIT_REF or VERCEL_GIT_REPO_OWNER is not valid");
+          return void 0;
+        }
+        return buildPreviewBranchName({ org: vercelGitRepoOwner, branch: vercelGitCommitRef });
+      }
+    }
+    return void 0;
   } catch (err) {
     return void 0;
   }
 }
 
+var __defProp$7 = Object.defineProperty;
+var __defNormalProp$7 = (obj, key, value) => key in obj ? __defProp$7(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$7 = (obj, key, value) => {
+  __defNormalProp$7(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
 var __accessCheck$8 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
@@ -218,6 +244,7 @@ var __privateMethod$4 = (obj, member, method) => {
   return method;
 };
 var _fetch, _queue, _concurrency, _enqueue, enqueue_fn;
+const REQUEST_TIMEOUT = 3e4;
 function getFetchImplementation(userFetch) {
   const globalFetch = typeof fetch !== "undefined" ? fetch : void 0;
   const fetchImpl = userFetch ?? globalFetch;
@@ -234,6 +261,8 @@ class ApiRequestPool {
     __privateAdd$8(this, _fetch, void 0);
     __privateAdd$8(this, _queue, void 0);
     __privateAdd$8(this, _concurrency, void 0);
+    __publicField$7(this, "running");
+    __publicField$7(this, "started");
     __privateSet$8(this, _queue, []);
     __privateSet$8(this, _concurrency, concurrency);
     this.running = 0;
@@ -249,17 +278,20 @@ class ApiRequestPool {
     return __privateGet$8(this, _fetch);
   }
   request(url, options) {
-    const start = new Date();
+    const start = /* @__PURE__ */ new Date();
     const fetch2 = this.getFetch();
     const runRequest = async (stalled = false) => {
-      const response = await fetch2(url, options);
+      const response = await Promise.race([fetch2(url, options), timeout(REQUEST_TIMEOUT).then(() => null)]);
+      if (!response) {
+        throw new Error("Request timed out");
+      }
       if (response.status === 429) {
         const rateLimitReset = parseNumber(response.headers?.get("x-ratelimit-reset")) ?? 1;
         await timeout(rateLimitReset * 1e3);
         return await runRequest(true);
       }
       if (stalled) {
-        const stalledTime = new Date().getTime() - start.getTime();
+        const stalledTime = (/* @__PURE__ */ new Date()).getTime() - start.getTime();
         console.warn(`A request to Xata hit your workspace limits, was retried and stalled for ${stalledTime}ms`);
       }
       return response;
@@ -302,16 +334,199 @@ function generateUUID() {
   });
 }
 
-const VERSION = "0.22.1";
+async function getBytes(stream, onChunk) {
+  const reader = stream.getReader();
+  let result;
+  while (!(result = await reader.read()).done) {
+    onChunk(result.value);
+  }
+}
+function getLines(onLine) {
+  let buffer;
+  let position;
+  let fieldLength;
+  let discardTrailingNewline = false;
+  return function onChunk(arr) {
+    if (buffer === void 0) {
+      buffer = arr;
+      position = 0;
+      fieldLength = -1;
+    } else {
+      buffer = concat(buffer, arr);
+    }
+    const bufLength = buffer.length;
+    let lineStart = 0;
+    while (position < bufLength) {
+      if (discardTrailingNewline) {
+        if (buffer[position] === 10 /* NewLine */) {
+          lineStart = ++position;
+        }
+        discardTrailingNewline = false;
+      }
+      let lineEnd = -1;
+      for (; position < bufLength && lineEnd === -1; ++position) {
+        switch (buffer[position]) {
+          case 58 /* Colon */:
+            if (fieldLength === -1) {
+              fieldLength = position - lineStart;
+            }
+            break;
+          case 13 /* CarriageReturn */:
+            discardTrailingNewline = true;
+          case 10 /* NewLine */:
+            lineEnd = position;
+            break;
+        }
+      }
+      if (lineEnd === -1) {
+        break;
+      }
+      onLine(buffer.subarray(lineStart, lineEnd), fieldLength);
+      lineStart = position;
+      fieldLength = -1;
+    }
+    if (lineStart === bufLength) {
+      buffer = void 0;
+    } else if (lineStart !== 0) {
+      buffer = buffer.subarray(lineStart);
+      position -= lineStart;
+    }
+  };
+}
+function getMessages(onId, onRetry, onMessage) {
+  let message = newMessage();
+  const decoder = new TextDecoder();
+  return function onLine(line, fieldLength) {
+    if (line.length === 0) {
+      onMessage?.(message);
+      message = newMessage();
+    } else if (fieldLength > 0) {
+      const field = decoder.decode(line.subarray(0, fieldLength));
+      const valueOffset = fieldLength + (line[fieldLength + 1] === 32 /* Space */ ? 2 : 1);
+      const value = decoder.decode(line.subarray(valueOffset));
+      switch (field) {
+        case "data":
+          message.data = message.data ? message.data + "\n" + value : value;
+          break;
+        case "event":
+          message.event = value;
+          break;
+        case "id":
+          onId(message.id = value);
+          break;
+        case "retry":
+          const retry = parseInt(value, 10);
+          if (!isNaN(retry)) {
+            onRetry(message.retry = retry);
+          }
+          break;
+      }
+    }
+  };
+}
+function concat(a, b) {
+  const res = new Uint8Array(a.length + b.length);
+  res.set(a);
+  res.set(b, a.length);
+  return res;
+}
+function newMessage() {
+  return {
+    data: "",
+    event: "",
+    id: "",
+    retry: void 0
+  };
+}
+const EventStreamContentType = "text/event-stream";
+const LastEventId = "last-event-id";
+function fetchEventSource(input, {
+  signal: inputSignal,
+  headers: inputHeaders,
+  onopen: inputOnOpen,
+  onmessage,
+  onclose,
+  onerror,
+  fetch: inputFetch,
+  ...rest
+}) {
+  return new Promise((resolve, reject) => {
+    const headers = { ...inputHeaders };
+    if (!headers.accept) {
+      headers.accept = EventStreamContentType;
+    }
+    let curRequestController;
+    function dispose() {
+      curRequestController.abort();
+    }
+    inputSignal?.addEventListener("abort", () => {
+      dispose();
+      resolve();
+    });
+    const fetchImpl = inputFetch ?? fetch;
+    const onopen = inputOnOpen ?? defaultOnOpen;
+    async function create() {
+      curRequestController = new AbortController();
+      try {
+        const response = await fetchImpl(input, {
+          ...rest,
+          headers,
+          signal: curRequestController.signal
+        });
+        await onopen(response);
+        await getBytes(
+          response.body,
+          getLines(
+            getMessages(
+              (id) => {
+                if (id) {
+                  headers[LastEventId] = id;
+                } else {
+                  delete headers[LastEventId];
+                }
+              },
+              (_retry) => {
+              },
+              onmessage
+            )
+          )
+        );
+        onclose?.();
+        dispose();
+        resolve();
+      } catch (err) {
+      }
+    }
+    create();
+  });
+}
+function defaultOnOpen(response) {
+  const contentType = response.headers?.get("content-type");
+  if (!contentType?.startsWith(EventStreamContentType)) {
+    throw new Error(`Expected content-type to be ${EventStreamContentType}, Actual: ${contentType}`);
+  }
+}
+
+const VERSION = "0.24.3";
 
+var __defProp$6 = Object.defineProperty;
+var __defNormalProp$6 = (obj, key, value) => key in obj ? __defProp$6(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$6 = (obj, key, value) => {
+  __defNormalProp$6(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
 class ErrorWithCause extends Error {
   constructor(message, options) {
     super(message, options);
+    __publicField$6(this, "cause");
   }
 }
 class FetcherError extends ErrorWithCause {
   constructor(status, data, requestId) {
     super(getMessage(data));
+    __publicField$6(this, "status");
+    __publicField$6(this, "requestId");
+    __publicField$6(this, "errors");
     this.status = status;
     this.errors = isBulkError(data) ? data.errors : [{ message: getMessage(data), status }];
     this.requestId = requestId;
@@ -378,6 +593,15 @@ function hostHeader(url) {
   const { groups } = pattern.exec(url) ?? {};
   return groups?.host ? { Host: groups.host } : {};
 }
+function parseBody(body, headers) {
+  if (!isDefined(body))
+    return void 0;
+  const { "Content-Type": contentType } = headers ?? {};
+  if (String(contentType).toLowerCase() === "application/json") {
+    return JSON.stringify(body);
+  }
+  return body;
+}
 const defaultClientID = generateUUID();
 async function fetch$1({
   url: path,
@@ -386,7 +610,7 @@ async function fetch$1({
   headers: customHeaders,
   pathParams,
   queryParams,
-  fetchImpl,
+  fetch: fetch2,
   apiKey,
   endpoint,
   apiUrl,
@@ -397,9 +621,10 @@ async function fetch$1({
   sessionID,
   clientName,
   xataAgentExtra,
-  fetchOptions = {}
+  fetchOptions = {},
+  rawResponse = false
 }) {
-  pool.setFetch(fetchImpl);
+  pool.setFetch(fetch2);
   return await trace(
     `${method.toUpperCase()} ${path}`,
     async ({ setAttributes }) => {
@@ -416,7 +641,7 @@ async function fetch$1({
         isDefined(clientName) ? ["service", clientName] : void 0,
         ...Object.entries(xataAgentExtra ?? {})
       ]).map(([key, value]) => `${key}=${value}`).join("; ");
-      const headers = {
+      const headers = compactObject({
         "Accept-Encoding": "identity",
         "Content-Type": "application/json",
         "X-Xata-Client-ID": clientID ?? defaultClientID,
@@ -425,11 +650,11 @@ async function fetch$1({
         ...customHeaders,
         ...hostHeader(fullUrl),
         Authorization: `Bearer ${apiKey}`
-      };
+      });
       const response = await pool.request(url, {
         ...fetchOptions,
         method: method.toUpperCase(),
-        body: body ? JSON.stringify(body) : void 0,
+        body: parseBody(body, headers),
         headers,
         signal
       });
@@ -442,6 +667,9 @@ async function fetch$1({
         [TraceAttributes.HTTP_HOST]: host,
         [TraceAttributes.HTTP_SCHEME]: protocol?.replace(":", "")
       });
+      const message = response.headers?.get("x-xata-message");
+      if (message)
+        console.warn(message);
       if (response.status === 204) {
         return {};
       }
@@ -449,7 +677,7 @@ async function fetch$1({
         throw new FetcherError(response.status, "Rate limit exceeded", requestId);
       }
       try {
-        const jsonResponse = await response.json();
+        const jsonResponse = rawResponse ? await response.blob() : await response.json();
         if (response.ok) {
           return jsonResponse;
         }
@@ -461,6 +689,59 @@ async function fetch$1({
     { [TraceAttributes.HTTP_METHOD]: method.toUpperCase(), [TraceAttributes.HTTP_ROUTE]: path }
   );
 }
+function fetchSSERequest({
+  url: path,
+  method,
+  body,
+  headers: customHeaders,
+  pathParams,
+  queryParams,
+  fetch: fetch2,
+  apiKey,
+  endpoint,
+  apiUrl,
+  workspacesApiUrl,
+  onMessage,
+  onError,
+  onClose,
+  signal,
+  clientID,
+  sessionID,
+  clientName,
+  xataAgentExtra
+}) {
+  const baseUrl = buildBaseUrl({ endpoint, path, workspacesApiUrl, pathParams, apiUrl });
+  const fullUrl = resolveUrl(baseUrl, queryParams, pathParams);
+  const url = fullUrl.includes("localhost") ? fullUrl.replace(/^[^.]+\./, "http://") : fullUrl;
+  void fetchEventSource(url, {
+    method,
+    body: JSON.stringify(body),
+    fetch: fetch2,
+    signal,
+    headers: {
+      "X-Xata-Client-ID": clientID ?? defaultClientID,
+      "X-Xata-Session-ID": sessionID ?? generateUUID(),
+      "X-Xata-Agent": compact([
+        ["client", "TS_SDK"],
+        ["version", VERSION],
+        isDefined(clientName) ? ["service", clientName] : void 0,
+        ...Object.entries(xataAgentExtra ?? {})
+      ]).map(([key, value]) => `${key}=${value}`).join("; "),
+      ...customHeaders,
+      Authorization: `Bearer ${apiKey}`,
+      "Content-Type": "application/json"
+    },
+    onmessage(ev) {
+      onMessage?.(JSON.parse(ev.data));
+    },
+    onerror(ev) {
+      onError?.(JSON.parse(ev.data));
+    },
+    onclose() {
+      onClose?.();
+    }
+  });
+}
 function parseUrl(url) {
   try {
     const { host, protocol } = new URL(url);
@@ -491,6 +772,12 @@ const deleteBranch = (variables, signal) => dataPlaneFetch({
   ...variables,
   signal
 });
+const copyBranch = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/copy",
+  method: "post",
+  ...variables,
+  signal
+});
 const updateBranchMetadata = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/metadata",
   method: "put",
@@ -540,6 +827,7 @@ const compareBranchSchemas = (variables, signal) => dataPlaneFetch({ url: "/db/{
 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 pushBranchMigrations = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/schema/push", method: "post", ...variables, signal });
 const createTable = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}",
   method: "put",
@@ -584,6 +872,42 @@ const deleteColumn = (variables, signal) => dataPlaneFetch({
 });
 const branchTransaction = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/transaction", method: "post", ...variables, signal });
 const insertRecord = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/data", method: "post", ...variables, signal });
+const getFileItem = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}/column/{columnName}/file/{fileId}",
+  method: "get",
+  ...variables,
+  signal
+});
+const putFileItem = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}/column/{columnName}/file/{fileId}",
+  method: "put",
+  ...variables,
+  signal
+});
+const deleteFileItem = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}/column/{columnName}/file/{fileId}",
+  method: "delete",
+  ...variables,
+  signal
+});
+const getFile = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}/column/{columnName}/file",
+  method: "get",
+  ...variables,
+  signal
+});
+const putFile = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}/column/{columnName}/file",
+  method: "put",
+  ...variables,
+  signal
+});
+const deleteFile = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}/column/{columnName}/file",
+  method: "delete",
+  ...variables,
+  signal
+});
 const getRecord = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}",
   method: "get",
@@ -613,15 +937,35 @@ const searchTable = (variables, signal) => dataPlaneFetch({
   ...variables,
   signal
 });
+const sqlQuery = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/sql",
+  method: "post",
+  ...variables,
+  signal
+});
 const vectorSearchTable = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/vectorSearch", method: "post", ...variables, signal });
+const askTable = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/tables/{tableName}/ask",
+  method: "post",
+  ...variables,
+  signal
+});
+const chatSessionMessage = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/ask/{sessionId}", method: "post", ...variables, signal });
 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 fileAccess = (variables, signal) => dataPlaneFetch({
+  url: "/file/{fileId}",
+  method: "get",
+  ...variables,
+  signal
+});
 const operationsByTag$2 = {
   branch: {
     getBranchList,
     getBranchDetails,
     createBranch,
     deleteBranch,
+    copyBranch,
     updateBranchMetadata,
     getBranchMetadata,
     getBranchStats,
@@ -639,7 +983,8 @@ const operationsByTag$2 = {
     compareBranchSchemas,
     updateBranchSchema,
     previewBranchSchemaEdit,
-    applyBranchSchemaEdit
+    applyBranchSchemaEdit,
+    pushBranchMigrations
   },
   migrationRequests: {
     queryMigrationRequests,
@@ -673,7 +1018,18 @@ const operationsByTag$2 = {
     deleteRecord,
     bulkInsertTableRecords
   },
-  searchAndFilter: { queryTable, searchBranch, searchTable, vectorSearchTable, summarizeTable, aggregateTable }
+  files: { getFileItem, putFileItem, deleteFileItem, getFile, putFile, deleteFile, fileAccess },
+  searchAndFilter: {
+    queryTable,
+    searchBranch,
+    searchTable,
+    sqlQuery,
+    vectorSearchTable,
+    askTable,
+    chatSessionMessage,
+    summarizeTable,
+    aggregateTable
+  }
 };
 
 const controlPlaneFetch = async (options) => fetch$1({ ...options, endpoint: "controlPlane" });
@@ -772,6 +1128,7 @@ const deleteDatabase = (variables, signal) => controlPlaneFetch({
 });
 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 renameDatabase = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/dbs/{dbName}/rename", method: "post", ...variables, signal });
 const getDatabaseGithubSettings = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/dbs/{dbName}/github", method: "get", ...variables, signal });
 const updateDatabaseGithubSettings = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/dbs/{dbName}/github", method: "put", ...variables, signal });
 const deleteDatabaseGithubSettings = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/dbs/{dbName}/github", method: "delete", ...variables, signal });
@@ -807,6 +1164,7 @@ const operationsByTag$1 = {
     deleteDatabase,
     getDatabaseMetadata,
     updateDatabaseMetadata,
+    renameDatabase,
     getDatabaseGithubSettings,
     updateDatabaseGithubSettings,
     deleteDatabaseGithubSettings,
@@ -832,6 +1190,10 @@ const providers = {
   staging: {
     main: "https://api.staging-xata.dev",
     workspaces: "https://{workspaceId}.{region}.staging-xata.dev"
+  },
+  dev: {
+    main: "https://api.dev-xata.dev",
+    workspaces: "https://{workspaceId}.{region}.dev-xata.dev"
   }
 };
 function isHostProviderAlias(alias) {
@@ -849,6 +1211,11 @@ function parseProviderString(provider = "production") {
     return null;
   return { main, workspaces };
 }
+function buildProviderString(provider) {
+  if (isHostProviderAlias(provider))
+    return provider;
+  return `${provider.main},${provider.workspaces}`;
+}
 function parseWorkspacesUrlParts(url) {
   if (!isString(url))
     return null;
@@ -895,7 +1262,7 @@ class XataApiClient {
     __privateSet$7(this, _extraProps, {
       apiUrl: getHostUrl(provider, "main"),
       workspacesApiUrl: getHostUrl(provider, "workspaces"),
-      fetchImpl: getFetchImplementation(options.fetch),
+      fetch: getFetchImplementation(options.fetch),
       apiKey,
       trace,
       clientName: options.clientName,
@@ -953,6 +1320,11 @@ class XataApiClient {
       __privateGet$7(this, _namespaces).records = new RecordsApi(__privateGet$7(this, _extraProps));
     return __privateGet$7(this, _namespaces).records;
   }
+  get files() {
+    if (!__privateGet$7(this, _namespaces).files)
+      __privateGet$7(this, _namespaces).files = new FilesApi(__privateGet$7(this, _extraProps));
+    return __privateGet$7(this, _namespaces).files;
+  }
   get searchAndFilter() {
     if (!__privateGet$7(this, _namespaces).searchAndFilter)
       __privateGet$7(this, _namespaces).searchAndFilter = new SearchAndFilterApi(__privateGet$7(this, _extraProps));
@@ -1161,6 +1533,20 @@ class BranchApi {
       ...this.extraProps
     });
   }
+  copyBranch({
+    workspace,
+    region,
+    database,
+    branch,
+    destinationBranch,
+    limit
+  }) {
+    return operationsByTag.branch.copyBranch({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      body: { destinationBranch, limit },
+      ...this.extraProps
+    });
+  }
   updateBranchMetadata({
     workspace,
     region,
@@ -1516,6 +1902,164 @@ class RecordsApi {
     });
   }
 }
+class FilesApi {
+  constructor(extraProps) {
+    this.extraProps = extraProps;
+  }
+  getFileItem({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    record,
+    column,
+    fileId
+  }) {
+    return operationsByTag.files.getFileItem({
+      pathParams: {
+        workspace,
+        region,
+        dbBranchName: `${database}:${branch}`,
+        tableName: table,
+        recordId: record,
+        columnName: column,
+        fileId
+      },
+      ...this.extraProps
+    });
+  }
+  putFileItem({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    record,
+    column,
+    fileId,
+    file
+  }) {
+    return operationsByTag.files.putFileItem({
+      pathParams: {
+        workspace,
+        region,
+        dbBranchName: `${database}:${branch}`,
+        tableName: table,
+        recordId: record,
+        columnName: column,
+        fileId
+      },
+      // @ts-ignore
+      body: file,
+      ...this.extraProps
+    });
+  }
+  deleteFileItem({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    record,
+    column,
+    fileId
+  }) {
+    return operationsByTag.files.deleteFileItem({
+      pathParams: {
+        workspace,
+        region,
+        dbBranchName: `${database}:${branch}`,
+        tableName: table,
+        recordId: record,
+        columnName: column,
+        fileId
+      },
+      ...this.extraProps
+    });
+  }
+  getFile({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    record,
+    column
+  }) {
+    return operationsByTag.files.getFile({
+      pathParams: {
+        workspace,
+        region,
+        dbBranchName: `${database}:${branch}`,
+        tableName: table,
+        recordId: record,
+        columnName: column
+      },
+      ...this.extraProps
+    });
+  }
+  putFile({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    record,
+    column,
+    file
+  }) {
+    return operationsByTag.files.putFile({
+      pathParams: {
+        workspace,
+        region,
+        dbBranchName: `${database}:${branch}`,
+        tableName: table,
+        recordId: record,
+        columnName: column
+      },
+      body: file,
+      ...this.extraProps
+    });
+  }
+  deleteFile({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    record,
+    column
+  }) {
+    return operationsByTag.files.deleteFile({
+      pathParams: {
+        workspace,
+        region,
+        dbBranchName: `${database}:${branch}`,
+        tableName: table,
+        recordId: record,
+        columnName: column
+      },
+      ...this.extraProps
+    });
+  }
+  fileAccess({
+    workspace,
+    region,
+    fileId,
+    verify
+  }) {
+    return operationsByTag.files.fileAccess({
+      pathParams: {
+        workspace,
+        region,
+        fileId
+      },
+      queryParams: { verify },
+      ...this.extraProps
+    });
+  }
+}
 class SearchAndFilterApi {
   constructor(extraProps) {
     this.extraProps = extraProps;
@@ -1575,6 +2119,53 @@ class SearchAndFilterApi {
       ...this.extraProps
     });
   }
+  vectorSearchTable({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    queryVector,
+    column,
+    similarityFunction,
+    size,
+    filter
+  }) {
+    return operationsByTag.searchAndFilter.vectorSearchTable({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
+      body: { queryVector, column, similarityFunction, size, filter },
+      ...this.extraProps
+    });
+  }
+  askTable({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    options
+  }) {
+    return operationsByTag.searchAndFilter.askTable({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table },
+      body: { ...options },
+      ...this.extraProps
+    });
+  }
+  chatSessionMessage({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    sessionId,
+    message
+  }) {
+    return operationsByTag.searchAndFilter.chatSessionMessage({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table, sessionId },
+      body: { message },
+      ...this.extraProps
+    });
+  }
   summarizeTable({
     workspace,
     region,
@@ -1839,6 +2430,19 @@ class MigrationsApi {
       ...this.extraProps
     });
   }
+  pushBranchMigrations({
+    workspace,
+    region,
+    database,
+    branch,
+    migrations
+  }) {
+    return operationsByTag.migrations.pushBranchMigrations({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
+      body: { migrations },
+      ...this.extraProps
+    });
+  }
 }
 class DatabaseApi {
   constructor(extraProps) {
@@ -1890,6 +2494,17 @@ class DatabaseApi {
       ...this.extraProps
     });
   }
+  renameDatabase({
+    workspace,
+    database,
+    newName
+  }) {
+    return operationsByTag.databases.renameDatabase({
+      pathParams: { workspaceId: workspace, dbName: database },
+      body: { newName },
+      ...this.extraProps
+    });
+  }
   getDatabaseGithubSettings({
     workspace,
     database
@@ -1928,9 +2543,8 @@ class DatabaseApi {
 }
 
 class XataApiPlugin {
-  async build(options) {
-    const { fetchImpl, apiKey } = await options.getFetchProps();
-    return new XataApiClient({ fetch: fetchImpl, apiKey });
+  build(options) {
+    return new XataApiClient(options);
   }
 }
 
@@ -1938,12 +2552,38 @@ class XataPlugin {
 }
 
 function cleanFilter(filter) {
-  if (!filter)
+  if (!isDefined(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;
+  if (!isObject(filter))
+    return filter;
+  const values = Object.fromEntries(
+    Object.entries(filter).reduce((acc, [key, value]) => {
+      if (!isDefined(value))
+        return acc;
+      if (Array.isArray(value)) {
+        const clean = value.map((item) => cleanFilter(item)).filter((item) => isDefined(item));
+        if (clean.length === 0)
+          return acc;
+        return [...acc, [key, clean]];
+      }
+      if (isObject(value)) {
+        const clean = cleanFilter(value);
+        if (!isDefined(clean))
+          return acc;
+        return [...acc, [key, clean]];
+      }
+      return [...acc, [key, value]];
+    }, [])
+  );
+  return Object.keys(values).length > 0 ? values : void 0;
 }
 
+var __defProp$5 = Object.defineProperty;
+var __defNormalProp$5 = (obj, key, value) => key in obj ? __defProp$5(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$5 = (obj, key, value) => {
+  __defNormalProp$5(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
 var __accessCheck$6 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
@@ -1966,22 +2606,58 @@ var _query, _page;
 class Page {
   constructor(query, meta, records = []) {
     __privateAdd$6(this, _query, void 0);
+    /**
+     * Page metadata, required to retrieve additional records.
+     */
+    __publicField$5(this, "meta");
+    /**
+     * The set of results for this page.
+     */
+    __publicField$5(this, "records");
     __privateSet$6(this, _query, query);
     this.meta = meta;
     this.records = new RecordArray(this, records);
   }
+  /**
+   * Retrieves the next page of results.
+   * @param size Maximum number of results to be retrieved.
+   * @param offset Number of results to skip when retrieving the results.
+   * @returns The next page or results.
+   */
   async nextPage(size, offset) {
     return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, after: this.meta.page.cursor } });
   }
+  /**
+   * Retrieves the previous page of results.
+   * @param size Maximum number of results to be retrieved.
+   * @param offset Number of results to skip when retrieving the results.
+   * @returns The previous page or results.
+   */
   async previousPage(size, offset) {
     return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, before: this.meta.page.cursor } });
   }
+  /**
+   * Retrieves the start page of results.
+   * @param size Maximum number of results to be retrieved.
+   * @param offset Number of results to skip when retrieving the results.
+   * @returns The start page or results.
+   */
   async startPage(size, offset) {
     return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, start: this.meta.page.cursor } });
   }
+  /**
+   * Retrieves the end page of results.
+   * @param size Maximum number of results to be retrieved.
+   * @param offset Number of results to skip when retrieving the results.
+   * @returns The end page or results.
+   */
   async endPage(size, offset) {
     return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, end: this.meta.page.cursor } });
   }
+  /**
+   * Shortcut method to check if there will be additional results if the next page of results is retrieved.
+   * @returns Whether or not there will be additional results in the next page of results.
+   */
   hasNextPage() {
     return this.meta.page.more;
   }
@@ -1994,7 +2670,7 @@ const PAGINATION_DEFAULT_OFFSET = 0;
 function isCursorPaginationOptions(options) {
   return isDefined(options) && (isDefined(options.start) || isDefined(options.end) || isDefined(options.after) || isDefined(options.before));
 }
-const _RecordArray = class extends Array {
+const _RecordArray = class _RecordArray extends Array {
   constructor(...args) {
     super(..._RecordArray.parseConstructorParams(...args));
     __privateAdd$6(this, _page, void 0);
@@ -2022,29 +2698,58 @@ const _RecordArray = class extends Array {
   map(callbackfn, thisArg) {
     return this.toArray().map(callbackfn, thisArg);
   }
+  /**
+   * Retrieve next page of records
+   *
+   * @returns A new array of objects
+   */
   async nextPage(size, offset) {
     const newPage = await __privateGet$6(this, _page).nextPage(size, offset);
     return new _RecordArray(newPage);
   }
+  /**
+   * Retrieve previous page of records
+   *
+   * @returns A new array of objects
+   */
   async previousPage(size, offset) {
     const newPage = await __privateGet$6(this, _page).previousPage(size, offset);
     return new _RecordArray(newPage);
   }
+  /**
+   * Retrieve start page of records
+   *
+   * @returns A new array of objects
+   */
   async startPage(size, offset) {
     const newPage = await __privateGet$6(this, _page).startPage(size, offset);
     return new _RecordArray(newPage);
   }
+  /**
+   * Retrieve end page of records
+   *
+   * @returns A new array of objects
+   */
   async endPage(size, offset) {
     const newPage = await __privateGet$6(this, _page).endPage(size, offset);
     return new _RecordArray(newPage);
   }
+  /**
+   * @returns Boolean indicating if there is a next page
+   */
   hasNextPage() {
     return __privateGet$6(this, _page).meta.page.more;
   }
 };
-let RecordArray = _RecordArray;
 _page = new WeakMap();
+let RecordArray = _RecordArray;
 
+var __defProp$4 = Object.defineProperty;
+var __defNormalProp$4 = (obj, key, value) => key in obj ? __defProp$4(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$4 = (obj, key, value) => {
+  __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
 var __accessCheck$5 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
@@ -2068,14 +2773,15 @@ var __privateMethod$3 = (obj, member, method) => {
   return method;
 };
 var _table$1, _repository, _data, _cleanFilterConstraint, cleanFilterConstraint_fn;
-const _Query = class {
+const _Query = class _Query {
   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: {} });
-    this.meta = { page: { cursor: "start", more: true } };
-    this.records = new RecordArray(this, []);
+    // Implements pagination
+    __publicField$4(this, "meta", { page: { cursor: "start", more: true, size: PAGINATION_DEFAULT_SIZE } });
+    __publicField$4(this, "records", new RecordArray(this, []));
     __privateSet$5(this, _table$1, table);
     if (repository) {
       __privateSet$5(this, _repository, repository);
@@ -2111,18 +2817,38 @@ const _Query = class {
     const key = JSON.stringify({ columns, filter, sort, pagination });
     return toBase64(key);
   }
+  /**
+   * Builds a new query object representing a logical OR between the given subqueries.
+   * @param queries An array of subqueries.
+   * @returns A new Query object.
+   */
   any(...queries) {
     const $any = queries.map((query) => query.getQueryOptions().filter ?? {});
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $any } }, __privateGet$5(this, _data));
   }
+  /**
+   * Builds a new query object representing a logical AND between the given subqueries.
+   * @param queries An array of subqueries.
+   * @returns A new Query object.
+   */
   all(...queries) {
     const $all = queries.map((query) => query.getQueryOptions().filter ?? {});
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $all } }, __privateGet$5(this, _data));
   }
+  /**
+   * Builds a new query object representing a logical OR negating each subquery. In pseudo-code: !q1 OR !q2
+   * @param queries An array of subqueries.
+   * @returns A new Query object.
+   */
   not(...queries) {
     const $not = queries.map((query) => query.getQueryOptions().filter ?? {});
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $not } }, __privateGet$5(this, _data));
   }
+  /**
+   * Builds a new query object representing a logical AND negating each subquery. In pseudo-code: !q1 AND !q2
+   * @param queries An array of subqueries.
+   * @returns A new Query object.
+   */
   none(...queries) {
     const $none = queries.map((query) => query.getQueryOptions().filter ?? {});
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $none } }, __privateGet$5(this, _data));
@@ -2145,6 +2871,11 @@ const _Query = class {
     const sort = [...originalSort, { column, direction }];
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { sort }, __privateGet$5(this, _data));
   }
+  /**
+   * Builds a new query specifying the set of columns to be returned in the query response.
+   * @param columns Array of column names to be returned by the query.
+   * @returns A new Query object.
+   */
   select(columns) {
     return new _Query(
       __privateGet$5(this, _repository),
@@ -2157,6 +2888,12 @@ const _Query = class {
     const query = new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), options, __privateGet$5(this, _data));
     return __privateGet$5(this, _repository).query(query);
   }
+  /**
+   * Get results in an iterator
+   *
+   * @async
+   * @returns Async interable of results
+   */
   async *[Symbol.asyncIterator]() {
     for await (const [record] of this.getIterator({ batchSize: 1 })) {
       yield record;
@@ -2217,26 +2954,53 @@ const _Query = class {
     );
     return __privateGet$5(this, _repository).summarizeTable(query, summaries, summariesFilter);
   }
+  /**
+   * Builds a new query object adding a cache TTL in milliseconds.
+   * @param ttl The cache TTL in milliseconds.
+   * @returns A new Query object.
+   */
   cache(ttl) {
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { cache: ttl }, __privateGet$5(this, _data));
   }
+  /**
+   * Retrieve next page of records
+   *
+   * @returns A new page object.
+   */
   nextPage(size, offset) {
     return this.startPage(size, offset);
   }
+  /**
+   * Retrieve previous page of records
+   *
+   * @returns A new page object
+   */
   previousPage(size, offset) {
     return this.startPage(size, offset);
   }
+  /**
+   * Retrieve start page of records
+   *
+   * @returns A new page object
+   */
   startPage(size, offset) {
     return this.getPaginated({ pagination: { size, offset } });
   }
+  /**
+   * Retrieve last page of records
+   *
+   * @returns A new page object
+   */
   endPage(size, offset) {
     return this.getPaginated({ pagination: { size, offset, before: "end" } });
   }
+  /**
+   * @returns Boolean indicating if there is a next page
+   */
   hasNextPage() {
     return this.meta.page.more;
   }
 };
-let Query = _Query;
 _table$1 = new WeakMap();
 _repository = new WeakMap();
 _data = new WeakMap();
@@ -2251,6 +3015,7 @@ cleanFilterConstraint_fn = function(column, value) {
   }
   return value;
 };
+let Query = _Query;
 function cleanParent(data, parent) {
   if (isCursorPaginationOptions(data.pagination)) {
     return { ...parent, sort: void 0, filter: void 0 };
@@ -2258,6 +3023,21 @@ function cleanParent(data, parent) {
   return parent;
 }
 
+const RecordColumnTypes = [
+  "bool",
+  "int",
+  "float",
+  "string",
+  "text",
+  "email",
+  "multiple",
+  "link",
+  "object",
+  "datetime",
+  "vector",
+  "file[]",
+  "file"
+];
 function isIdentifiable(x) {
   return isObject(x) && isString(x?.id);
 }
@@ -2271,7 +3051,11 @@ function isSortFilterString(value) {
   return isString(value);
 }
 function isSortFilterBase(filter) {
-  return isObject(filter) && Object.values(filter).every((value) => value === "asc" || value === "desc");
+  return isObject(filter) && Object.entries(filter).every(([key, value]) => {
+    if (key === "*")
+      return value === "random";
+    return value === "asc" || value === "desc";
+  });
 }
 function isSortFilterObject(filter) {
   return isObject(filter) && !isSortFilterBase(filter) && filter.column !== void 0;
@@ -2344,10 +3128,7 @@ class RestRepository extends Query {
     __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() };
-    });
+    __privateSet$4(this, _getFetchProps, () => ({ ...options.pluginOptions, sessionID: generateUUID() }));
     const trace = options.pluginOptions.trace ?? defaultTrace;
     __privateSet$4(this, _trace, async (name, fn, options2 = {}) => {
       return trace(name, fn, {
@@ -2404,7 +3185,6 @@ class RestRepository extends Query {
       }
       const id = extractId(a);
       if (id) {
-        const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
         try {
           const response = await getRecord({
             pathParams: {
@@ -2415,7 +3195,7 @@ class RestRepository extends Query {
               recordId: id
             },
             queryParams: { columns },
-            ...fetchProps
+            ...__privateGet$4(this, _getFetchProps).call(this)
           });
           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);
@@ -2515,12 +3295,22 @@ class RestRepository extends Query {
         return result;
       }
       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, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a, b, columns, { ifVersion });
+        return await __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a, b, columns, { ifVersion });
       }
       if (isObject(a) && isString(a.id)) {
+        if (a.id === "")
+          throw new Error("The id can't be empty");
         const columns = isStringArray(c) ? c : void 0;
-        return __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a.id, { ...a, id: void 0 }, columns, { ifVersion });
+        return await __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a.id, { ...a, id: void 0 }, columns, { ifVersion });
+      }
+      if (!isDefined(a) && isObject(b)) {
+        return await this.create(b, c);
+      }
+      if (isObject(a) && !isDefined(a.id)) {
+        return await this.create(a, b);
       }
       throw new Error("Invalid arguments for createOrUpdate method");
     });
@@ -2537,12 +3327,22 @@ class RestRepository extends Query {
         return result;
       }
       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: false, ifVersion });
+        return await __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a, b, columns, { createOnly: false, ifVersion });
       }
       if (isObject(a) && isString(a.id)) {
+        if (a.id === "")
+          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.id, { ...a, id: void 0 }, columns, { createOnly: false, ifVersion });
+        return await __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a.id, { ...a, id: void 0 }, columns, { createOnly: false, ifVersion });
+      }
+      if (!isDefined(a) && isObject(b)) {
+        return await this.create(b, c);
+      }
+      if (isObject(a) && !isDefined(a.id)) {
+        return await this.create(a, b);
       }
       throw new Error("Invalid arguments for createOrReplace method");
     });
@@ -2593,7 +3393,6 @@ class RestRepository extends Query {
   }
   async search(query, options = {}) {
     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}",
@@ -2611,7 +3410,7 @@ class RestRepository extends Query {
           page: options.page,
           target: options.target
         },
-        ...fetchProps
+        ...__privateGet$4(this, _getFetchProps).call(this)
       });
       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, ["*"]));
@@ -2619,7 +3418,6 @@ class RestRepository extends Query {
   }
   async vectorSearch(column, query, options) {
     return __privateGet$4(this, _trace).call(this, "vectorSearch", async () => {
-      const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
       const { records } = await vectorSearchTable({
         pathParams: {
           workspace: "{workspaceId}",
@@ -2634,7 +3432,7 @@ class RestRepository extends Query {
           size: options?.size,
           filter: options?.filter
         },
-        ...fetchProps
+        ...__privateGet$4(this, _getFetchProps).call(this)
       });
       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, ["*"]));
@@ -2642,7 +3440,6 @@ class RestRepository extends Query {
   }
   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}",
@@ -2651,7 +3448,7 @@ class RestRepository extends Query {
           tableName: __privateGet$4(this, _table)
         },
         body: { aggs, filter },
-        ...fetchProps
+        ...__privateGet$4(this, _getFetchProps).call(this)
       });
       return result;
     });
@@ -2662,7 +3459,6 @@ class RestRepository extends 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}",
@@ -2678,7 +3474,7 @@ class RestRepository extends Query {
           consistency: data.consistency
         },
         fetchOptions: data.fetchOptions,
-        ...fetchProps
+        ...__privateGet$4(this, _getFetchProps).call(this)
       });
       const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
       const records = objects.map(
@@ -2691,7 +3487,6 @@ class RestRepository extends Query {
   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}",
@@ -2708,11 +3503,39 @@ class RestRepository extends Query {
           summaries,
           summariesFilter
         },
-        ...fetchProps
+        ...__privateGet$4(this, _getFetchProps).call(this)
       });
       return result;
     });
   }
+  ask(question, options) {
+    const params = {
+      pathParams: {
+        workspace: "{workspaceId}",
+        dbBranchName: "{dbBranch}",
+        region: "{region}",
+        tableName: __privateGet$4(this, _table)
+      },
+      body: {
+        question,
+        ...options
+      },
+      ...__privateGet$4(this, _getFetchProps).call(this)
+    };
+    if (options?.onMessage) {
+      fetchSSERequest({
+        endpoint: "dataPlane",
+        url: "/db/{dbBranchName}/tables/{tableName}/ask",
+        method: "POST",
+        onMessage: (message) => {
+          options.onMessage?.({ answer: message.text, records: message.records });
+        },
+        ...params
+      });
+    } else {
+      return askTable(params);
+    }
+  }
 }
 _table = new WeakMap();
 _getFetchProps = new WeakMap();
@@ -2722,8 +3545,7 @@ _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);
-  const record = transformObjectLinks(object);
+  const record = removeLinksFromObject(object);
   const response = await insertRecord({
     pathParams: {
       workspace: "{workspaceId}",
@@ -2733,15 +3555,16 @@ insertRecordWithoutId_fn = async function(object, columns = ["*"]) {
     },
     queryParams: { columns },
     body: record,
-    ...fetchProps
+    ...__privateGet$4(this, _getFetchProps).call(this)
   });
   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);
 };
 _insertRecordWithId = new WeakSet();
 insertRecordWithId_fn = async function(recordId, object, columns = ["*"], { createOnly, ifVersion }) {
-  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
-  const record = transformObjectLinks(object);
+  if (!recordId)
+    return null;
+  const record = removeLinksFromObject(object);
   const response = await insertRecordWithID({
     pathParams: {
       workspace: "{workspaceId}",
@@ -2752,17 +3575,16 @@ insertRecordWithId_fn = async function(recordId, object, columns = ["*"], { crea
     },
     body: record,
     queryParams: { createOnly, columns, ifVersion },
-    ...fetchProps
+    ...__privateGet$4(this, _getFetchProps).call(this)
   });
   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);
 };
 _insertRecords = new WeakSet();
 insertRecords_fn = async function(objects, { createOnly, ifVersion }) {
-  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const chunkedOperations = chunk(
     objects.map((object) => ({
-      insert: { table: __privateGet$4(this, _table), record: transformObjectLinks(object), createOnly, ifVersion }
+      insert: { table: __privateGet$4(this, _table), record: removeLinksFromObject(object), createOnly, ifVersion }
     })),
     BULK_OPERATION_MAX_SIZE
   );
@@ -2775,7 +3597,7 @@ insertRecords_fn = async function(objects, { createOnly, ifVersion }) {
         region: "{region}"
       },
       body: { operations },
-      ...fetchProps
+      ...__privateGet$4(this, _getFetchProps).call(this)
     });
     for (const result of results) {
       if (result.operation === "insert") {
@@ -2789,8 +3611,9 @@ insertRecords_fn = async function(objects, { createOnly, ifVersion }) {
 };
 _updateRecordWithID = new WeakSet();
 updateRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVersion }) {
-  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
-  const { id: _id, ...record } = transformObjectLinks(object);
+  if (!recordId)
+    return null;
+  const { id: _id, ...record } = removeLinksFromObject(object);
   try {
     const response = await updateRecordWithID({
       pathParams: {
@@ -2802,7 +3625,7 @@ updateRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVe
       },
       queryParams: { columns, ifVersion },
       body: record,
-      ...fetchProps
+      ...__privateGet$4(this, _getFetchProps).call(this)
     });
     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);
@@ -2815,10 +3638,9 @@ updateRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVe
 };
 _updateRecords = new WeakSet();
 updateRecords_fn = async function(objects, { ifVersion, upsert }) {
-  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const chunkedOperations = chunk(
     objects.map(({ id, ...object }) => ({
-      update: { table: __privateGet$4(this, _table), id, ifVersion, upsert, fields: transformObjectLinks(object) }
+      update: { table: __privateGet$4(this, _table), id, ifVersion, upsert, fields: removeLinksFromObject(object) }
     })),
     BULK_OPERATION_MAX_SIZE
   );
@@ -2831,7 +3653,7 @@ updateRecords_fn = async function(objects, { ifVersion, upsert }) {
         region: "{region}"
       },
       body: { operations },
-      ...fetchProps
+      ...__privateGet$4(this, _getFetchProps).call(this)
     });
     for (const result of results) {
       if (result.operation === "update") {
@@ -2845,7 +3667,8 @@ updateRecords_fn = async function(objects, { ifVersion, upsert }) {
 };
 _upsertRecordWithID = new WeakSet();
 upsertRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVersion }) {
-  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
+  if (!recordId)
+    return null;
   const response = await upsertRecordWithID({
     pathParams: {
       workspace: "{workspaceId}",
@@ -2856,14 +3679,15 @@ upsertRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVe
     },
     queryParams: { columns, ifVersion },
     body: object,
-    ...fetchProps
+    ...__privateGet$4(this, _getFetchProps).call(this)
   });
   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);
 };
 _deleteRecord = new WeakSet();
 deleteRecord_fn = async function(recordId, columns = ["*"]) {
-  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
+  if (!recordId)
+    return null;
   try {
     const response = await deleteRecord({
       pathParams: {
@@ -2874,7 +3698,7 @@ deleteRecord_fn = async function(recordId, columns = ["*"]) {
         recordId
       },
       queryParams: { columns },
-      ...fetchProps
+      ...__privateGet$4(this, _getFetchProps).call(this)
     });
     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);
@@ -2887,9 +3711,8 @@ deleteRecord_fn = async function(recordId, columns = ["*"]) {
 };
 _deleteRecords = new WeakSet();
 deleteRecords_fn = async function(recordIds) {
-  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const chunkedOperations = chunk(
-    recordIds.map((id) => ({ delete: { table: __privateGet$4(this, _table), id } })),
+    compact(recordIds).map((id) => ({ delete: { table: __privateGet$4(this, _table), id } })),
     BULK_OPERATION_MAX_SIZE
   );
   for (const operations of chunkedOperations) {
@@ -2900,21 +3723,22 @@ deleteRecords_fn = async function(recordIds) {
         region: "{region}"
       },
       body: { operations },
-      ...fetchProps
+      ...__privateGet$4(this, _getFetchProps).call(this)
     });
   }
 };
 _setCacheQuery = new WeakSet();
 setCacheQuery_fn = async function(query, meta, records) {
-  await __privateGet$4(this, _cache).set(`query_${__privateGet$4(this, _table)}:${query.key()}`, { date: new Date(), meta, records });
+  await __privateGet$4(this, _cache)?.set(`query_${__privateGet$4(this, _table)}:${query.key()}`, { date: /* @__PURE__ */ new Date(), meta, records });
 };
 _getCacheQuery = new WeakSet();
 getCacheQuery_fn = async function(query) {
   const key = `query_${__privateGet$4(this, _table)}:${query.key()}`;
-  const result = await __privateGet$4(this, _cache).get(key);
+  const result = await __privateGet$4(this, _cache)?.get(key);
   if (!result)
     return null;
-  const { cache: ttl = __privateGet$4(this, _cache).defaultQueryTTL } = query.getQueryOptions();
+  const defaultTTL = __privateGet$4(this, _cache)?.defaultQueryTTL ?? -1;
+  const { cache: ttl = defaultTTL } = query.getQueryOptions();
   if (ttl < 0)
     return null;
   const hasExpired = result.date.getTime() + ttl < Date.now();
@@ -2924,15 +3748,14 @@ _getSchemaTables$1 = new WeakSet();
 getSchemaTables_fn$1 = async function() {
   if (__privateGet$4(this, _schemaTables$2))
     return __privateGet$4(this, _schemaTables$2);
-  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const { schema } = await getBranchDetails({
     pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", region: "{region}" },
-    ...fetchProps
+    ...__privateGet$4(this, _getFetchProps).call(this)
   });
   __privateSet$4(this, _schemaTables$2, schema.tables);
   return schema.tables;
 };
-const transformObjectLinks = (object) => {
+const removeLinksFromObject = (object) => {
   return Object.entries(object).reduce((acc, [key, value]) => {
     if (key === "xata")
       return acc;
@@ -2990,6 +3813,8 @@ const initObject = (db, schemaTables, table, object, selectedColumns) => {
     }
   }
   const record = { ...data };
+  const serializable = { xata, ...removeLinksFromObject(data) };
+  const metadata = xata !== void 0 ? { ...xata, createdAt: new Date(xata.createdAt), updatedAt: new Date(xata.updatedAt) } : void 0;
   record.read = function(columns2) {
     return db[table].read(record["id"], columns2);
   };
@@ -3006,14 +3831,15 @@ const initObject = (db, schemaTables, table, object, selectedColumns) => {
   record.delete = function() {
     return db[table].delete(record["id"]);
   };
+  record.xata = Object.freeze(metadata);
   record.getMetadata = function() {
-    return xata;
+    return record.xata;
   };
   record.toSerializable = function() {
-    return JSON.parse(JSON.stringify(transformObjectLinks(data)));
+    return JSON.parse(JSON.stringify(serializable));
   };
   record.toString = function() {
-    return JSON.stringify(transformObjectLinks(data));
+    return JSON.stringify(serializable);
   };
   for (const prop of ["read", "update", "replace", "delete", "getMetadata", "toSerializable", "toString"]) {
     Object.defineProperty(record, prop, { enumerable: false });
@@ -3031,11 +3857,7 @@ function extractId(value) {
 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);
+  return columns.filter((item) => item.startsWith(column.name)).length > 0;
 }
 function parseIfVersion(...args) {
   for (const arg of args) {
@@ -3046,6 +3868,12 @@ function parseIfVersion(...args) {
   return void 0;
 }
 
+var __defProp$3 = Object.defineProperty;
+var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$3 = (obj, key, value) => {
+  __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
 var __accessCheck$3 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
@@ -3068,6 +3896,8 @@ var _map;
 class SimpleCache {
   constructor(options = {}) {
     __privateAdd$3(this, _map, void 0);
+    __publicField$3(this, "capacity");
+    __publicField$3(this, "defaultQueryTTL");
     __privateSet$3(this, _map, /* @__PURE__ */ new Map());
     this.capacity = options.max ?? 500;
     this.defaultQueryTTL = options.defaultQueryTTL ?? 60 * 1e3;
@@ -3203,19 +4033,19 @@ class SearchPlugin extends XataPlugin {
     __privateAdd$1(this, _schemaTables, void 0);
     __privateSet$1(this, _schemaTables, schemaTables);
   }
-  build({ getFetchProps }) {
+  build(pluginOptions) {
     return {
       all: async (query, options = {}) => {
-        const records = await __privateMethod$1(this, _search, search_fn).call(this, query, options, getFetchProps);
-        const schemaTables = await __privateMethod$1(this, _getSchemaTables, getSchemaTables_fn).call(this, getFetchProps);
+        const records = await __privateMethod$1(this, _search, search_fn).call(this, query, options, pluginOptions);
+        const schemaTables = await __privateMethod$1(this, _getSchemaTables, getSchemaTables_fn).call(this, pluginOptions);
         return records.map((record) => {
           const { table = "orphan" } = record.xata;
           return { table, record: initObject(this.db, schemaTables, table, record, ["*"]) };
         });
       },
       byTable: async (query, options = {}) => {
-        const records = await __privateMethod$1(this, _search, search_fn).call(this, query, options, getFetchProps);
-        const schemaTables = await __privateMethod$1(this, _getSchemaTables, getSchemaTables_fn).call(this, getFetchProps);
+        const records = await __privateMethod$1(this, _search, search_fn).call(this, query, options, pluginOptions);
+        const schemaTables = await __privateMethod$1(this, _getSchemaTables, getSchemaTables_fn).call(this, pluginOptions);
         return records.reduce((acc, record) => {
           const { table = "orphan" } = record.xata;
           const items = acc[table] ?? [];
@@ -3228,38 +4058,36 @@ class SearchPlugin extends XataPlugin {
 }
 _schemaTables = new WeakMap();
 _search = new WeakSet();
-search_fn = async function(query, options, getFetchProps) {
-  const fetchProps = await getFetchProps();
+search_fn = async function(query, options, pluginOptions) {
   const { tables, fuzziness, highlight, prefix, page } = options ?? {};
   const { records } = await searchBranch({
     pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", region: "{region}" },
+    // @ts-ignore https://github.com/xataio/client-ts/issues/313
     body: { tables, query, fuzziness, prefix, highlight, page },
-    ...fetchProps
+    ...pluginOptions
   });
   return records;
 };
 _getSchemaTables = new WeakSet();
-getSchemaTables_fn = async function(getFetchProps) {
+getSchemaTables_fn = async function(pluginOptions) {
   if (__privateGet$1(this, _schemaTables))
     return __privateGet$1(this, _schemaTables);
-  const fetchProps = await getFetchProps();
   const { schema } = await getBranchDetails({
     pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", region: "{region}" },
-    ...fetchProps
+    ...pluginOptions
   });
   __privateSet$1(this, _schemaTables, schema.tables);
   return schema.tables;
 };
 
 class TransactionPlugin extends XataPlugin {
-  build({ getFetchProps }) {
+  build(pluginOptions) {
     return {
       run: async (operations) => {
-        const fetchProps = await getFetchProps();
         const response = await branchTransaction({
           pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", region: "{region}" },
           body: { operations },
-          ...fetchProps
+          ...pluginOptions
         });
         return response;
       }
@@ -3267,91 +4095,12 @@ class TransactionPlugin extends XataPlugin {
   }
 }
 
-const isBranchStrategyBuilder = (strategy) => {
-  return typeof strategy === "function";
+var __defProp$2 = Object.defineProperty;
+var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$2 = (obj, key, value) => {
+  __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
 };
-
-async function getCurrentBranchName(options) {
-  const { branch, envBranch } = getEnvironment();
-  if (branch)
-    return branch;
-  const gitBranch = envBranch || await getGitBranch();
-  return resolveXataBranch(gitBranch, options);
-}
-async function getCurrentBranchDetails(options) {
-  const branch = await getCurrentBranchName(options);
-  return getDatabaseBranch(branch, options);
-}
-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"
-    );
-  if (!apiKey)
-    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 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, region },
-    queryParams: { gitBranch, fallbackBranch },
-    trace: defaultTrace,
-    clientName: options?.clientName,
-    xataAgentExtra: options?.xataAgentExtra
-  });
-  return branch;
-}
-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"
-    );
-  if (!apiKey)
-    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 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: `${database}:${branch}`, workspace, region },
-      trace: defaultTrace
-    });
-  } catch (err) {
-    if (isObject(err) && err.status === 404)
-      return null;
-    throw err;
-  }
-}
-function getDatabaseURL() {
-  try {
-    const { databaseURL } = getEnvironment();
-    return databaseURL;
-  } catch (err) {
-    return void 0;
-  }
-}
-
 var __accessCheck = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
@@ -3375,20 +4124,21 @@ var __privateMethod = (obj, member, method) => {
   return method;
 };
 const buildClient = (plugins) => {
-  var _branch, _options, _parseOptions, parseOptions_fn, _getFetchProps, getFetchProps_fn, _evaluateBranch, evaluateBranch_fn, _a;
+  var _options, _parseOptions, parseOptions_fn, _getFetchProps, getFetchProps_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);
+      __publicField$2(this, "db");
+      __publicField$2(this, "search");
+      __publicField$2(this, "transactions");
       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),
+        ...__privateMethod(this, _getFetchProps, getFetchProps_fn).call(this, safeOptions),
         cache: safeOptions.cache,
-        trace: safeOptions.trace
+        host: safeOptions.host
       };
       const db = new SchemaPlugin(schemaTables).build(pluginOptions);
       const search = new SearchPlugin(db, schemaTables).build(pluginOptions);
@@ -3399,22 +4149,15 @@ const buildClient = (plugins) => {
       for (const [key, namespace] of Object.entries(plugins ?? {})) {
         if (namespace === void 0)
           continue;
-        const result = namespace.build(pluginOptions);
-        if (result instanceof Promise) {
-          void result.then((namespace2) => {
-            this[key] = namespace2;
-          });
-        } else {
-          this[key] = result;
-        }
+        this[key] = namespace.build(pluginOptions);
       }
     }
     async getConfig() {
       const databaseURL = __privateGet(this, _options).databaseURL;
-      const branch = await __privateGet(this, _options).branch();
+      const branch = __privateGet(this, _options).branch;
       return { databaseURL, branch };
     }
-  }, _branch = new WeakMap(), _options = new WeakMap(), _parseOptions = new WeakSet(), parseOptions_fn = function(options) {
+  }, _options = new WeakMap(), _parseOptions = new WeakSet(), parseOptions_fn = function(options) {
     const enableBrowser = options?.enableBrowser ?? getEnableBrowserVariable() ?? false;
     const isBrowser = typeof window !== "undefined" && typeof Deno === "undefined";
     if (isBrowser && !enableBrowser) {
@@ -3428,20 +4171,34 @@ const buildClient = (plugins) => {
     const cache = options?.cache ?? new SimpleCache({ defaultQueryTTL: 0 });
     const trace = options?.trace ?? defaultTrace;
     const clientName = options?.clientName;
+    const host = options?.host ?? "production";
     const xataAgentExtra = options?.xataAgentExtra;
-    const branch = async () => options?.branch !== void 0 ? await __privateMethod(this, _evaluateBranch, evaluateBranch_fn).call(this, options.branch) : await getCurrentBranchName({
-      apiKey,
-      databaseURL,
-      fetchImpl: options?.fetch,
-      clientName,
-      xataAgentExtra
-    });
     if (!apiKey) {
       throw new Error("Option apiKey is required");
     }
     if (!databaseURL) {
       throw new Error("Option databaseURL is required");
     }
+    const envBranch = getBranch();
+    const previewBranch = getPreviewBranch();
+    const branch = options?.branch || previewBranch || envBranch || "main";
+    if (!!previewBranch && branch !== previewBranch) {
+      console.warn(
+        `Ignoring preview branch ${previewBranch} because branch option was passed to the client constructor with value ${branch}`
+      );
+    } else if (!!envBranch && branch !== envBranch) {
+      console.warn(
+        `Ignoring branch ${envBranch} because branch option was passed to the client constructor with value ${branch}`
+      );
+    } else if (!!previewBranch && !!envBranch && previewBranch !== envBranch) {
+      console.warn(
+        `Ignoring preview branch ${previewBranch} and branch ${envBranch} because branch option was passed to the client constructor with value ${branch}`
+      );
+    } else if (!previewBranch && !envBranch && options?.branch === void 0) {
+      console.warn(
+        `No branch was passed to the client constructor. Using default branch ${branch}. You can set the branch with the environment variable XATA_BRANCH or by passing the branch option to the client constructor.`
+      );
+    }
     return {
       fetch,
       databaseURL,
@@ -3449,12 +4206,13 @@ const buildClient = (plugins) => {
       branch,
       cache,
       trace,
+      host,
       clientID: generateUUID(),
       enableBrowser,
       clientName,
       xataAgentExtra
     };
-  }, _getFetchProps = new WeakSet(), getFetchProps_fn = async function({
+  }, _getFetchProps = new WeakSet(), getFetchProps_fn = function({
     fetch,
     apiKey,
     databaseURL,
@@ -3464,16 +4222,14 @@ const buildClient = (plugins) => {
     clientName,
     xataAgentExtra
   }) {
-    const branchValue = await __privateMethod(this, _evaluateBranch, evaluateBranch_fn).call(this, branch);
-    if (!branchValue)
-      throw new Error("Unable to resolve branch value");
     return {
-      fetchImpl: fetch,
+      fetch,
       apiKey,
       apiUrl: "",
+      // Instead of using workspace and dbBranch, we inject a probably CNAME'd URL
       workspacesApiUrl: (path, params) => {
         const hasBranch = params.dbBranchName ?? params.branch;
-        const newPath = path.replace(/^\/db\/[^/]+/, hasBranch !== void 0 ? `:${branchValue}` : "");
+        const newPath = path.replace(/^\/db\/[^/]+/, hasBranch !== void 0 ? `:${branch}` : "");
         return databaseURL + newPath;
       },
       trace,
@@ -3481,32 +4237,22 @@ const buildClient = (plugins) => {
       clientName,
       xataAgentExtra
     };
-  }, _evaluateBranch = new WeakSet(), evaluateBranch_fn = async function(param) {
-    if (__privateGet(this, _branch))
-      return __privateGet(this, _branch);
-    if (param === void 0)
-      return void 0;
-    const strategies = Array.isArray(param) ? [...param] : [param];
-    const evaluateBranch = async (strategy) => {
-      return isBranchStrategyBuilder(strategy) ? await strategy() : strategy;
-    };
-    for await (const strategy of strategies) {
-      const branch = await evaluateBranch(strategy);
-      if (branch) {
-        __privateSet(this, _branch, branch);
-        return branch;
-      }
-    }
   }, _a;
 };
 class BaseClient extends buildClient() {
 }
 
+var __defProp$1 = Object.defineProperty;
+var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$1 = (obj, key, value) => {
+  __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
 const META = "__";
 const VALUE = "___";
 class Serializer {
   constructor() {
-    this.classes = {};
+    __publicField$1(this, "classes", {});
   }
   add(clazz) {
     this.classes[clazz.name] = clazz;
@@ -3584,9 +4330,16 @@ function buildWorkerRunner(config) {
   };
 }
 
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
 class XataError extends Error {
   constructor(message, status) {
     super(message);
+    __publicField(this, "status");
     this.status = status;
   }
 }
@@ -3601,6 +4354,7 @@ exports.PAGINATION_MAX_SIZE = PAGINATION_MAX_SIZE;
 exports.Page = Page;
 exports.Query = Query;
 exports.RecordArray = RecordArray;
+exports.RecordColumnTypes = RecordColumnTypes;
 exports.Repository = Repository;
 exports.RestRepository = RestRepository;
 exports.SchemaPlugin = SchemaPlugin;
@@ -3616,15 +4370,20 @@ exports.addGitBranchesEntry = addGitBranchesEntry;
 exports.addTableColumn = addTableColumn;
 exports.aggregateTable = aggregateTable;
 exports.applyBranchSchemaEdit = applyBranchSchemaEdit;
+exports.askTable = askTable;
 exports.branchTransaction = branchTransaction;
 exports.buildClient = buildClient;
+exports.buildPreviewBranchName = buildPreviewBranchName;
+exports.buildProviderString = buildProviderString;
 exports.buildWorkerRunner = buildWorkerRunner;
 exports.bulkInsertTableRecords = bulkInsertTableRecords;
 exports.cancelWorkspaceMemberInvite = cancelWorkspaceMemberInvite;
+exports.chatSessionMessage = chatSessionMessage;
 exports.compareBranchSchemas = compareBranchSchemas;
 exports.compareBranchWithUserSchema = compareBranchWithUserSchema;
 exports.compareMigrationRequest = compareMigrationRequest;
 exports.contains = contains;
+exports.copyBranch = copyBranch;
 exports.createBranch = createBranch;
 exports.createDatabase = createDatabase;
 exports.createMigrationRequest = createMigrationRequest;
@@ -3635,6 +4394,8 @@ exports.deleteBranch = deleteBranch;
 exports.deleteColumn = deleteColumn;
 exports.deleteDatabase = deleteDatabase;
 exports.deleteDatabaseGithubSettings = deleteDatabaseGithubSettings;
+exports.deleteFile = deleteFile;
+exports.deleteFileItem = deleteFileItem;
 exports.deleteRecord = deleteRecord;
 exports.deleteTable = deleteTable;
 exports.deleteUser = deleteUser;
@@ -3645,8 +4406,10 @@ exports.endsWith = endsWith;
 exports.equals = equals;
 exports.executeBranchMigrationPlan = executeBranchMigrationPlan;
 exports.exists = exists;
+exports.fileAccess = fileAccess;
 exports.ge = ge;
 exports.getAPIKey = getAPIKey;
+exports.getBranch = getBranch;
 exports.getBranchDetails = getBranchDetails;
 exports.getBranchList = getBranchList;
 exports.getBranchMetadata = getBranchMetadata;
@@ -3655,16 +4418,17 @@ exports.getBranchMigrationPlan = getBranchMigrationPlan;
 exports.getBranchSchemaHistory = getBranchSchemaHistory;
 exports.getBranchStats = getBranchStats;
 exports.getColumn = getColumn;
-exports.getCurrentBranchDetails = getCurrentBranchDetails;
-exports.getCurrentBranchName = getCurrentBranchName;
 exports.getDatabaseGithubSettings = getDatabaseGithubSettings;
 exports.getDatabaseList = getDatabaseList;
 exports.getDatabaseMetadata = getDatabaseMetadata;
 exports.getDatabaseURL = getDatabaseURL;
+exports.getFile = getFile;
+exports.getFileItem = getFileItem;
 exports.getGitBranchesMapping = getGitBranchesMapping;
 exports.getHostUrl = getHostUrl;
 exports.getMigrationRequest = getMigrationRequest;
 exports.getMigrationRequestIsMerged = getMigrationRequestIsMerged;
+exports.getPreviewBranch = getPreviewBranch;
 exports.getRecord = getRecord;
 exports.getTableColumns = getTableColumns;
 exports.getTableSchema = getTableSchema;
@@ -3707,16 +4471,21 @@ exports.parseProviderString = parseProviderString;
 exports.parseWorkspacesUrlParts = parseWorkspacesUrlParts;
 exports.pattern = pattern;
 exports.previewBranchSchemaEdit = previewBranchSchemaEdit;
+exports.pushBranchMigrations = pushBranchMigrations;
+exports.putFile = putFile;
+exports.putFileItem = putFileItem;
 exports.queryMigrationRequests = queryMigrationRequests;
 exports.queryTable = queryTable;
 exports.removeGitBranchesEntry = removeGitBranchesEntry;
 exports.removeWorkspaceMember = removeWorkspaceMember;
+exports.renameDatabase = renameDatabase;
 exports.resendWorkspaceMemberInvite = resendWorkspaceMemberInvite;
 exports.resolveBranch = resolveBranch;
 exports.searchBranch = searchBranch;
 exports.searchTable = searchTable;
 exports.serialize = serialize;
 exports.setTableSchema = setTableSchema;
+exports.sqlQuery = sqlQuery;
 exports.startsWith = startsWith;
 exports.summarizeTable = summarizeTable;
 exports.updateBranchMetadata = updateBranchMetadata;