@xata.io/client 0.0.0-alpha.vf6f217e → 0.0.0-alpha.vf70b95a

package/dist/index.cjs

@@ -93,8 +93,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 +107,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 +119,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,39 +165,48 @@ 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 { execSync } = await import(nodeModule);
-    return execSync(fullCmd, execOptions).toString().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;
   }
@@ -304,7 +319,180 @@ function generateUUID() {
   });
 }
 
-const VERSION = "0.0.0-alpha.vf6f217e";
+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.23.4";
 
 class ErrorWithCause extends Error {
   constructor(message, options) {
@@ -388,7 +576,7 @@ async function fetch$1({
   headers: customHeaders,
   pathParams,
   queryParams,
-  fetchImpl,
+  fetch: fetch2,
   apiKey,
   endpoint,
   apiUrl,
@@ -398,12 +586,13 @@ async function fetch$1({
   clientID,
   sessionID,
   clientName,
+  xataAgentExtra,
   fetchOptions = {}
 }) {
-  pool.setFetch(fetchImpl);
+  pool.setFetch(fetch2);
   return await trace(
     `${method.toUpperCase()} ${path}`,
-    async ({ name, setAttributes }) => {
+    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;
@@ -414,7 +603,8 @@ async function fetch$1({
       const xataAgent = compact([
         ["client", "TS_SDK"],
         ["version", VERSION],
-        isDefined(clientName) ? ["service", clientName] : void 0
+        isDefined(clientName) ? ["service", clientName] : void 0,
+        ...Object.entries(xataAgentExtra ?? {})
       ]).map(([key, value]) => `${key}=${value}`).join("; ");
       const headers = {
         "Accept-Encoding": "identity",
@@ -461,6 +651,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);
@@ -472,17 +715,12 @@ function parseUrl(url) {
 
 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: "get",
   ...variables,
   signal
 });
-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",
@@ -496,6 +734,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",
@@ -521,7 +765,6 @@ const resolveBranch = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName
 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({
@@ -546,6 +789,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",
@@ -588,7 +832,38 @@ const deleteColumn = (variables, signal) => dataPlaneFetch({
   ...variables,
   signal
 });
+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 getRecord = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}",
   method: "get",
@@ -618,21 +893,28 @@ 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 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: {
-    dEPRECATEDgetDatabaseList,
-    dEPRECATEDcreateDatabase,
-    dEPRECATEDdeleteDatabase,
-    dEPRECATEDgetDatabaseMetadata,
-    dEPRECATEDupdateDatabaseMetadata
-  },
   branch: {
     getBranchList,
     getBranchDetails,
     createBranch,
     deleteBranch,
+    copyBranch,
     updateBranchMetadata,
     getBranchMetadata,
     getBranchStats,
@@ -650,17 +932,8 @@ const operationsByTag$2 = {
     compareBranchSchemas,
     updateBranchSchema,
     previewBranchSchemaEdit,
-    applyBranchSchemaEdit
-  },
-  records: {
-    branchTransaction,
-    insertRecord,
-    getRecord,
-    insertRecordWithID,
-    updateRecordWithID,
-    upsertRecordWithID,
-    deleteRecord,
-    bulkInsertTableRecords
+    applyBranchSchemaEdit,
+    pushBranchMigrations
   },
   migrationRequests: {
     queryMigrationRequests,
@@ -684,7 +957,27 @@ const operationsByTag$2 = {
     updateColumn,
     deleteColumn
   },
-  searchAndFilter: { queryTable, searchBranch, searchTable, summarizeTable, aggregateTable }
+  records: {
+    branchTransaction,
+    insertRecord,
+    getRecord,
+    insertRecordWithID,
+    updateRecordWithID,
+    upsertRecordWithID,
+    deleteRecord,
+    bulkInsertTableRecords
+  },
+  files: { getFileItem, putFileItem, deleteFileItem, getFile, putFile },
+  searchAndFilter: {
+    queryTable,
+    searchBranch,
+    searchTable,
+    sqlQuery,
+    vectorSearchTable,
+    askTable,
+    summarizeTable,
+    aggregateTable
+  }
 };
 
 const controlPlaneFetch = async (options) => fetch$1({ ...options, endpoint: "controlPlane" });
@@ -783,6 +1076,10 @@ 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 });
 const listRegions = (variables, signal) => controlPlaneFetch({
   url: "/workspaces/{workspaceId}/regions",
   method: "get",
@@ -815,6 +1112,10 @@ const operationsByTag$1 = {
     deleteDatabase,
     getDatabaseMetadata,
     updateDatabaseMetadata,
+    renameDatabase,
+    getDatabaseGithubSettings,
+    updateDatabaseGithubSettings,
+    deleteDatabaseGithubSettings,
     listRegions
   }
 };
@@ -835,8 +1136,12 @@ const providers = {
     workspaces: "https://{workspaceId}.{region}.xata.sh"
   },
   staging: {
-    main: "https://staging.xatabase.co",
-    workspaces: "https://{workspaceId}.staging.{region}.xatabase.co"
+    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) {
@@ -854,12 +1159,19 @@ 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;
   const regex = /(?:https:\/\/)?([^.]+)(?:\.([^.]+))\.xata\.sh.*/;
-  const regexStaging = /(?:https:\/\/)?([^.]+)\.staging(?:\.([^.]+))\.xatabase\.co.*/;
-  const match = url.match(regex) || url.match(regexStaging);
+  const regexDev = /(?:https:\/\/)?([^.]+)(?:\.([^.]+))\.dev-xata\.dev.*/;
+  const regexStaging = /(?:https:\/\/)?([^.]+)(?:\.([^.]+))\.staging-xata\.dev.*/;
+  const regexProdTesting = /(?:https:\/\/)?([^.]+)(?:\.([^.]+))\.xata\.tech.*/;
+  const match = url.match(regex) || url.match(regexDev) || url.match(regexStaging) || url.match(regexProdTesting);
   if (!match)
     return null;
   return { workspace: match[1], region: match[2] };
@@ -898,10 +1210,11 @@ 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,
+      xataAgentExtra: options.xataAgentExtra,
       clientID
     });
   }
@@ -955,6 +1268,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));
@@ -1163,6 +1481,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,
@@ -1518,6 +1850,126 @@ 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
+      },
+      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
+    });
+  }
+}
 class SearchAndFilterApi {
   constructor(extraProps) {
     this.extraProps = extraProps;
@@ -1577,6 +2029,38 @@ 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
+    });
+  }
   summarizeTable({
     workspace,
     region,
@@ -1777,11 +2261,13 @@ class MigrationsApi {
     region,
     database,
     branch,
-    schema
+    schema,
+    schemaOperations,
+    branchOperations
   }) {
     return operationsByTag.migrations.compareBranchWithUserSchema({
       pathParams: { workspace, region, dbBranchName: `${database}:${branch}` },
-      body: { schema },
+      body: { schema, schemaOperations, branchOperations },
       ...this.extraProps
     });
   }
@@ -1791,11 +2277,12 @@ class MigrationsApi {
     database,
     branch,
     compare,
-    schema
+    sourceBranchOperations,
+    targetBranchOperations
   }) {
     return operationsByTag.migrations.compareBranchSchemas({
       pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, branchName: compare },
-      body: { schema },
+      body: { sourceBranchOperations, targetBranchOperations },
       ...this.extraProps
     });
   }
@@ -1838,6 +2325,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) {
@@ -1889,6 +2389,46 @@ class DatabaseApi {
       ...this.extraProps
     });
   }
+  renameDatabase({
+    workspace,
+    database,
+    newName
+  }) {
+    return operationsByTag.databases.renameDatabase({
+      pathParams: { workspaceId: workspace, dbName: database },
+      body: { newName },
+      ...this.extraProps
+    });
+  }
+  getDatabaseGithubSettings({
+    workspace,
+    database
+  }) {
+    return operationsByTag.databases.getDatabaseGithubSettings({
+      pathParams: { workspaceId: workspace, dbName: database },
+      ...this.extraProps
+    });
+  }
+  updateDatabaseGithubSettings({
+    workspace,
+    database,
+    settings
+  }) {
+    return operationsByTag.databases.updateDatabaseGithubSettings({
+      pathParams: { workspaceId: workspace, dbName: database },
+      body: settings,
+      ...this.extraProps
+    });
+  }
+  deleteDatabaseGithubSettings({
+    workspace,
+    database
+  }) {
+    return operationsByTag.databases.deleteDatabaseGithubSettings({
+      pathParams: { workspaceId: workspace, dbName: database },
+      ...this.extraProps
+    });
+  }
   listRegions({ workspace }) {
     return operationsByTag.databases.listRegions({
       pathParams: { workspaceId: workspace },
@@ -1898,9 +2438,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);
   }
 }
 
@@ -1983,6 +2522,12 @@ const _RecordArray = class extends Array {
   toArray() {
     return new Array(...this);
   }
+  toSerializable() {
+    return JSON.parse(this.toString());
+  }
+  toString() {
+    return JSON.stringify(this.toArray());
+  }
   map(callbackfn, thisArg) {
     return this.toArray().map(callbackfn, thisArg);
   }
@@ -2235,7 +2780,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;
@@ -2308,10 +2857,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, {
@@ -2368,7 +2914,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: {
@@ -2379,7 +2924,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);
@@ -2557,7 +3102,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}",
@@ -2575,7 +3119,29 @@ 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, ["*"]));
+    });
+  }
+  async vectorSearch(column, query, options) {
+    return __privateGet$4(this, _trace).call(this, "vectorSearch", async () => {
+      const { records } = await vectorSearchTable({
+        pathParams: {
+          workspace: "{workspaceId}",
+          dbBranchName: "{dbBranch}",
+          region: "{region}",
+          tableName: __privateGet$4(this, _table)
+        },
+        body: {
+          column,
+          queryVector: query,
+          similarityFunction: options?.similarityFunction,
+          size: options?.size,
+          filter: options?.filter
+        },
+        ...__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, ["*"]));
@@ -2583,7 +3149,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}",
@@ -2592,7 +3157,7 @@ class RestRepository extends Query {
           tableName: __privateGet$4(this, _table)
         },
         body: { aggs, filter },
-        ...fetchProps
+        ...__privateGet$4(this, _getFetchProps).call(this)
       });
       return result;
     });
@@ -2603,7 +3168,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}",
@@ -2619,7 +3183,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(
@@ -2632,7 +3196,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}",
@@ -2649,11 +3212,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();
@@ -2663,7 +3254,6 @@ _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 response = await insertRecord({
     pathParams: {
@@ -2674,14 +3264,13 @@ 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);
   const response = await insertRecordWithID({
     pathParams: {
@@ -2693,14 +3282,13 @@ 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 }
@@ -2716,7 +3304,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") {
@@ -2730,7 +3318,6 @@ 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);
   try {
     const response = await updateRecordWithID({
@@ -2743,7 +3330,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);
@@ -2756,7 +3343,6 @@ 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) }
@@ -2772,7 +3358,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") {
@@ -2786,7 +3372,6 @@ 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);
   const response = await upsertRecordWithID({
     pathParams: {
       workspace: "{workspaceId}",
@@ -2797,14 +3382,13 @@ 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);
   try {
     const response = await deleteRecord({
       pathParams: {
@@ -2815,7 +3399,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);
@@ -2828,7 +3412,6 @@ 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 } })),
     BULK_OPERATION_MAX_SIZE
@@ -2841,21 +3424,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: 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();
@@ -2865,10 +3449,9 @@ _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;
@@ -2881,23 +3464,23 @@ const transformObjectLinks = (object) => {
   }, {});
 };
 const initObject = (db, schemaTables, table, object, selectedColumns) => {
-  const result = {};
+  const data = {};
   const { xata, ...rest } = object ?? {};
-  Object.assign(result, rest);
+  Object.assign(data, rest);
   const { columns } = schemaTables.find(({ name }) => name === table) ?? {};
   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];
+    const value = data[column.name];
     switch (column.type) {
       case "datetime": {
         const date = value !== void 0 ? new Date(value) : null;
         if (date !== null && isNaN(date.getTime())) {
           console.error(`Failed to parse date ${value} for field ${column.name}`);
         } else {
-          result[column.name] = date;
+          data[column.name] = date;
         }
         break;
       }
@@ -2916,44 +3499,51 @@ const initObject = (db, schemaTables, table, object, selectedColumns) => {
             }
             return acc;
           }, []);
-          result[column.name] = initObject(db, schemaTables, linkTable, value, selectedLinkColumns);
+          data[column.name] = initObject(db, schemaTables, linkTable, value, selectedLinkColumns);
         } else {
-          result[column.name] = null;
+          data[column.name] = null;
         }
         break;
       }
       default:
-        result[column.name] = value ?? null;
+        data[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);
+  const record = { ...data };
+  record.read = function(columns2) {
+    return db[table].read(record["id"], columns2);
   };
-  result.update = function(data, b, c) {
+  record.update = function(data2, b, c) {
     const columns2 = isStringArray(b) ? b : ["*"];
     const ifVersion = parseIfVersion(b, c);
-    return db[table].update(result["id"], data, columns2, { ifVersion });
+    return db[table].update(record["id"], data2, columns2, { ifVersion });
   };
-  result.replace = function(data, b, c) {
+  record.replace = function(data2, b, c) {
     const columns2 = isStringArray(b) ? b : ["*"];
     const ifVersion = parseIfVersion(b, c);
-    return db[table].createOrReplace(result["id"], data, columns2, { ifVersion });
+    return db[table].createOrReplace(record["id"], data2, columns2, { ifVersion });
   };
-  result.delete = function() {
-    return db[table].delete(result["id"]);
+  record.delete = function() {
+    return db[table].delete(record["id"]);
   };
-  result.getMetadata = function() {
+  record.getMetadata = function() {
     return xata;
   };
-  for (const prop of ["read", "update", "replace", "delete", "getMetadata"]) {
-    Object.defineProperty(result, prop, { enumerable: false });
+  record.toSerializable = function() {
+    return JSON.parse(JSON.stringify(transformObjectLinks(data)));
+  };
+  record.toString = function() {
+    return JSON.stringify(transformObjectLinks(data));
+  };
+  for (const prop of ["read", "update", "replace", "delete", "getMetadata", "toSerializable", "toString"]) {
+    Object.defineProperty(record, prop, { enumerable: false });
   }
-  Object.freeze(result);
-  return result;
+  Object.freeze(record);
+  return record;
 };
 function extractId(value) {
   if (isString(value))
@@ -3137,19 +3727,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] ?? [];
@@ -3162,38 +3752,35 @@ 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}" },
     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;
       }
@@ -3201,90 +3788,6 @@ class TransactionPlugin extends XataPlugin {
   }
 }
 
-const isBranchStrategyBuilder = (strategy) => {
-  return typeof strategy === "function";
-};
-
-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
-  });
-  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);
@@ -3308,20 +3811,18 @@ 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);
       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);
@@ -3332,24 +3833,17 @@ 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";
+    const isBrowser = typeof window !== "undefined" && typeof Deno === "undefined";
     if (isBrowser && !enableBrowser) {
       throw new Error(
         "You are trying to use Xata from the browser, which is potentially a non-secure environment. If you understand the security concerns, such as leaking your credentials, pass `enableBrowser: true` to the client options to remove this error."
@@ -3361,60 +3855,71 @@ const buildClient = (plugins) => {
     const cache = options?.cache ?? new SimpleCache({ defaultQueryTTL: 0 });
     const trace = options?.trace ?? defaultTrace;
     const clientName = options?.clientName;
-    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: options?.clientName
-    });
+    const host = options?.host ?? "production";
+    const xataAgentExtra = options?.xataAgentExtra;
     if (!apiKey) {
       throw new Error("Option apiKey is required");
     }
     if (!databaseURL) {
       throw new Error("Option databaseURL is required");
     }
-    return { fetch, databaseURL, apiKey, branch, cache, trace, clientID: generateUUID(), enableBrowser, clientName };
-  }, _getFetchProps = new WeakSet(), getFetchProps_fn = async function({
+    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,
+      apiKey,
+      branch,
+      cache,
+      trace,
+      host,
+      clientID: generateUUID(),
+      enableBrowser,
+      clientName,
+      xataAgentExtra
+    };
+  }, _getFetchProps = new WeakSet(), getFetchProps_fn = function({
     fetch,
     apiKey,
     databaseURL,
     branch,
     trace,
     clientID,
-    clientName
+    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: "",
       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,
       clientID,
-      clientName
-    };
-  }, _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;
+      clientName,
+      xataAgentExtra
     };
-    for await (const strategy of strategies) {
-      const branch = await evaluateBranch(strategy);
-      if (branch) {
-        __privateSet(this, _branch, branch);
-        return branch;
-      }
-    }
   }, _a;
 };
 class BaseClient extends buildClient() {
@@ -3510,6 +4015,7 @@ class XataError extends Error {
 }
 
 exports.BaseClient = BaseClient;
+exports.FetcherError = FetcherError;
 exports.Operations = operationsByTag;
 exports.PAGINATION_DEFAULT_OFFSET = PAGINATION_DEFAULT_OFFSET;
 exports.PAGINATION_DEFAULT_SIZE = PAGINATION_DEFAULT_SIZE;
@@ -3533,8 +4039,11 @@ 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;
@@ -3542,20 +4051,18 @@ exports.compareBranchSchemas = compareBranchSchemas;
 exports.compareBranchWithUserSchema = compareBranchWithUserSchema;
 exports.compareMigrationRequest = compareMigrationRequest;
 exports.contains = contains;
+exports.copyBranch = copyBranch;
 exports.createBranch = createBranch;
 exports.createDatabase = createDatabase;
 exports.createMigrationRequest = createMigrationRequest;
 exports.createTable = createTable;
 exports.createUserAPIKey = createUserAPIKey;
 exports.createWorkspace = createWorkspace;
-exports.dEPRECATEDcreateDatabase = dEPRECATEDcreateDatabase;
-exports.dEPRECATEDdeleteDatabase = dEPRECATEDdeleteDatabase;
-exports.dEPRECATEDgetDatabaseList = dEPRECATEDgetDatabaseList;
-exports.dEPRECATEDgetDatabaseMetadata = dEPRECATEDgetDatabaseMetadata;
-exports.dEPRECATEDupdateDatabaseMetadata = dEPRECATEDupdateDatabaseMetadata;
 exports.deleteBranch = deleteBranch;
 exports.deleteColumn = deleteColumn;
 exports.deleteDatabase = deleteDatabase;
+exports.deleteDatabaseGithubSettings = deleteDatabaseGithubSettings;
+exports.deleteFileItem = deleteFileItem;
 exports.deleteRecord = deleteRecord;
 exports.deleteTable = deleteTable;
 exports.deleteUser = deleteUser;
@@ -3568,6 +4075,7 @@ exports.executeBranchMigrationPlan = executeBranchMigrationPlan;
 exports.exists = exists;
 exports.ge = ge;
 exports.getAPIKey = getAPIKey;
+exports.getBranch = getBranch;
 exports.getBranchDetails = getBranchDetails;
 exports.getBranchList = getBranchList;
 exports.getBranchMetadata = getBranchMetadata;
@@ -3576,15 +4084,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;
@@ -3627,21 +4137,27 @@ 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;
 exports.updateBranchSchema = updateBranchSchema;
 exports.updateColumn = updateColumn;
+exports.updateDatabaseGithubSettings = updateDatabaseGithubSettings;
 exports.updateDatabaseMetadata = updateDatabaseMetadata;
 exports.updateMigrationRequest = updateMigrationRequest;
 exports.updateRecordWithID = updateRecordWithID;
@@ -3651,4 +4167,5 @@ exports.updateWorkspace = updateWorkspace;
 exports.updateWorkspaceMemberInvite = updateWorkspaceMemberInvite;
 exports.updateWorkspaceMemberRole = updateWorkspaceMemberRole;
 exports.upsertRecordWithID = upsertRecordWithID;
+exports.vectorSearchTable = vectorSearchTable;
 //# sourceMappingURL=index.cjs.map