@xata.io/client 0.0.0-alpha.vfd071d9 → 0.0.0-alpha.vfd609764793466374d6519edeb1be8debc9a83d5

package/dist/index.mjs

@@ -1,85 +1,553 @@
+const defaultTrace = async (name, fn, _options) => {
+  return await fn({
+    name,
+    setAttributes: () => {
+      return;
+    }
+  });
+};
+const TraceAttributes = {
+  KIND: "xata.trace.kind",
+  VERSION: "xata.sdk.version",
+  TABLE: "xata.table",
+  HTTP_REQUEST_ID: "http.request_id",
+  HTTP_STATUS_CODE: "http.status_code",
+  HTTP_HOST: "http.host",
+  HTTP_SCHEME: "http.scheme",
+  HTTP_USER_AGENT: "http.user_agent",
+  HTTP_METHOD: "http.method",
+  HTTP_URL: "http.url",
+  HTTP_ROUTE: "http.route",
+  HTTP_TARGET: "http.target",
+  CLOUDFLARE_RAY_ID: "cf.ray"
+};
+
 function notEmpty(value) {
   return value !== null && value !== void 0;
 }
 function compact(arr) {
   return arr.filter(notEmpty);
 }
+function compactObject(obj) {
+  return Object.fromEntries(Object.entries(obj).filter(([, value]) => notEmpty(value)));
+}
+function isBlob(value) {
+  try {
+    return value instanceof Blob;
+  } catch (error) {
+    return false;
+  }
+}
 function isObject(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date) && !isBlob(value);
+}
+function isDefined(value) {
+  return value !== null && value !== void 0;
 }
 function isString(value) {
-  return value !== void 0 && value !== null && typeof value === "string";
+  return isDefined(value) && typeof value === "string";
+}
+function isStringArray(value) {
+  return isDefined(value) && Array.isArray(value) && value.every(isString);
+}
+function isNumber(value) {
+  return isDefined(value) && typeof value === "number";
+}
+function parseNumber(value) {
+  if (isNumber(value)) {
+    return value;
+  }
+  if (isString(value)) {
+    const parsed = Number(value);
+    if (!Number.isNaN(parsed)) {
+      return parsed;
+    }
+  }
+  return void 0;
 }
 function toBase64(value) {
   try {
     return btoa(value);
   } catch (err) {
-    return Buffer.from(value).toString("base64");
+    const buf = Buffer;
+    return buf.from(value).toString("base64");
+  }
+}
+function deepMerge(a, b) {
+  const result = { ...a };
+  for (const [key, value] of Object.entries(b)) {
+    if (isObject(value) && isObject(result[key])) {
+      result[key] = deepMerge(result[key], value);
+    } else {
+      result[key] = value;
+    }
   }
+  return result;
+}
+function chunk(array, chunkSize) {
+  const result = [];
+  for (let i = 0; i < array.length; i += chunkSize) {
+    result.push(array.slice(i, i + chunkSize));
+  }
+  return result;
+}
+async function timeout(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function timeoutWithCancel(ms) {
+  let timeoutId;
+  const promise = new Promise((resolve) => {
+    timeoutId = setTimeout(() => {
+      resolve();
+    }, ms);
+  });
+  return {
+    cancel: () => clearTimeout(timeoutId),
+    promise
+  };
+}
+function promiseMap(inputValues, mapper) {
+  const reducer = (acc$, inputValue) => acc$.then(
+    (acc) => mapper(inputValue).then((result) => {
+      acc.push(result);
+      return acc;
+    })
+  );
+  return inputValues.reduce(reducer, Promise.resolve([]));
 }
 
-function getEnvVariable(name) {
+function getEnvironment() {
   try {
-    if (isObject(process) && isString(process?.env?.[name])) {
-      return process.env[name];
+    if (isDefined(process) && isDefined(process.env)) {
+      return {
+        apiKey: process.env.XATA_API_KEY ?? getGlobalApiKey(),
+        databaseURL: process.env.XATA_DATABASE_URL ?? getGlobalDatabaseURL(),
+        branch: process.env.XATA_BRANCH ?? getGlobalBranch(),
+        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) {
   }
   try {
-    if (isObject(Deno) && isString(Deno?.env?.get(name))) {
-      return Deno.env.get(name);
+    if (isObject(Deno) && isObject(Deno.env)) {
+      return {
+        apiKey: Deno.env.get("XATA_API_KEY") ?? getGlobalApiKey(),
+        databaseURL: Deno.env.get("XATA_DATABASE_URL") ?? getGlobalDatabaseURL(),
+        branch: Deno.env.get("XATA_BRANCH") ?? getGlobalBranch(),
+        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) {
   }
+  return {
+    apiKey: getGlobalApiKey(),
+    databaseURL: getGlobalDatabaseURL(),
+    branch: getGlobalBranch(),
+    deployPreview: void 0,
+    deployPreviewBranch: void 0,
+    vercelGitCommitRef: void 0,
+    vercelGitRepoOwner: void 0
+  };
 }
-async function getGitBranch() {
+function getEnableBrowserVariable() {
   try {
-    if (typeof require === "function") {
-      const req = require;
-      return req("child_process").execSync("git branch --show-current", { encoding: "utf-8" }).trim();
+    if (isObject(process) && isObject(process.env) && process.env.XATA_ENABLE_BROWSER !== void 0) {
+      return process.env.XATA_ENABLE_BROWSER === "true";
     }
   } catch (err) {
   }
   try {
-    if (isObject(Deno)) {
-      const process2 = Deno.run({
-        cmd: ["git", "branch", "--show-current"],
-        stdout: "piped",
-        stderr: "piped"
-      });
-      return new TextDecoder().decode(await process2.output()).trim();
+    if (isObject(Deno) && isObject(Deno.env) && Deno.env.get("XATA_ENABLE_BROWSER") !== void 0) {
+      return Deno.env.get("XATA_ENABLE_BROWSER") === "true";
     }
   } catch (err) {
   }
+  try {
+    return XATA_ENABLE_BROWSER === true || XATA_ENABLE_BROWSER === "true";
+  } catch (err) {
+    return void 0;
+  }
+}
+function getGlobalApiKey() {
+  try {
+    return XATA_API_KEY;
+  } catch (err) {
+    return void 0;
+  }
+}
+function getGlobalDatabaseURL() {
+  try {
+    return XATA_DATABASE_URL;
+  } catch (err) {
+    return void 0;
+  }
+}
+function getGlobalBranch() {
+  try {
+    return XATA_BRANCH;
+  } catch (err) {
+    return void 0;
+  }
+}
+function getDatabaseURL() {
+  try {
+    const { databaseURL } = getEnvironment();
+    return databaseURL;
+  } catch (err) {
+    return void 0;
+  }
 }
-
 function getAPIKey() {
   try {
-    return getEnvVariable("XATA_API_KEY") ?? XATA_API_KEY;
+    const { apiKey } = getEnvironment();
+    return apiKey;
+  } catch (err) {
+    return void 0;
+  }
+}
+function getBranch() {
+  try {
+    const { branch } = getEnvironment();
+    return branch;
+  } catch (err) {
+    return void 0;
+  }
+}
+function buildPreviewBranchName({ org, branch }) {
+  return `preview-${org}-${branch}`;
+}
+function getPreviewBranch() {
+  try {
+    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 __accessCheck$6 = (obj, member, msg) => {
+  if (!member.has(obj))
+    throw TypeError("Cannot " + msg);
+};
+var __privateGet$5 = (obj, member, getter) => {
+  __accessCheck$6(obj, member, "read from private field");
+  return getter ? getter.call(obj) : member.get(obj);
+};
+var __privateAdd$6 = (obj, member, value) => {
+  if (member.has(obj))
+    throw TypeError("Cannot add the same private member more than once");
+  member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+};
+var __privateSet$4 = (obj, member, value, setter) => {
+  __accessCheck$6(obj, member, "write to private field");
+  setter ? setter.call(obj, value) : member.set(obj, value);
+  return value;
+};
+var __privateMethod$4 = (obj, member, method) => {
+  __accessCheck$6(obj, member, "access private method");
+  return method;
+};
+var _fetch, _queue, _concurrency, _enqueue, enqueue_fn;
+const REQUEST_TIMEOUT = 5 * 60 * 1e3;
 function getFetchImplementation(userFetch) {
   const globalFetch = typeof fetch !== "undefined" ? fetch : void 0;
-  const fetchImpl = userFetch ?? globalFetch;
+  const globalThisFetch = typeof globalThis !== "undefined" ? globalThis.fetch : void 0;
+  const fetchImpl = userFetch ?? globalFetch ?? globalThisFetch;
   if (!fetchImpl) {
-    throw new Error(`The \`fetch\` option passed to the Xata client is resolving to a falsy value and may not be correctly imported.`);
+    throw new Error(`Couldn't find a global \`fetch\`. Pass a fetch implementation explicitly.`);
   }
   return fetchImpl;
 }
+class ApiRequestPool {
+  constructor(concurrency = 10) {
+    __privateAdd$6(this, _enqueue);
+    __privateAdd$6(this, _fetch, void 0);
+    __privateAdd$6(this, _queue, void 0);
+    __privateAdd$6(this, _concurrency, void 0);
+    __privateSet$4(this, _queue, []);
+    __privateSet$4(this, _concurrency, concurrency);
+    this.running = 0;
+    this.started = 0;
+  }
+  setFetch(fetch2) {
+    __privateSet$4(this, _fetch, fetch2);
+  }
+  getFetch() {
+    if (!__privateGet$5(this, _fetch)) {
+      throw new Error("Fetch not set");
+    }
+    return __privateGet$5(this, _fetch);
+  }
+  request(url, options) {
+    const start = /* @__PURE__ */ new Date();
+    const fetchImpl = this.getFetch();
+    const runRequest = async (stalled = false) => {
+      const { promise, cancel } = timeoutWithCancel(REQUEST_TIMEOUT);
+      const response = await Promise.race([fetchImpl(url, options), promise.then(() => null)]).finally(cancel);
+      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 = (/* @__PURE__ */ new Date()).getTime() - start.getTime();
+        console.warn(`A request to Xata hit branch rate limits, was retried and stalled for ${stalledTime}ms`);
+      }
+      return response;
+    };
+    return __privateMethod$4(this, _enqueue, enqueue_fn).call(this, async () => {
+      return await runRequest();
+    });
+  }
+}
+_fetch = new WeakMap();
+_queue = new WeakMap();
+_concurrency = new WeakMap();
+_enqueue = new WeakSet();
+enqueue_fn = function(task) {
+  const promise = new Promise((resolve) => __privateGet$5(this, _queue).push(resolve)).finally(() => {
+    this.started--;
+    this.running++;
+  }).then(() => task()).finally(() => {
+    this.running--;
+    const next = __privateGet$5(this, _queue).shift();
+    if (next !== void 0) {
+      this.started++;
+      next();
+    }
+  });
+  if (this.running + this.started < __privateGet$5(this, _concurrency)) {
+    const next = __privateGet$5(this, _queue).shift();
+    if (next !== void 0) {
+      this.started++;
+      next();
+    }
+  }
+  return promise;
+};
+
+function generateUUID() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function(c) {
+    const r = Math.random() * 16 | 0, v = c == "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
 
-class FetcherError extends Error {
-  constructor(status, data) {
+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.29.1";
+
+class ErrorWithCause extends Error {
+  constructor(message, options) {
+    super(message, options);
+  }
+}
+class FetcherError extends ErrorWithCause {
+  constructor(status, data, requestId) {
     super(getMessage(data));
     this.status = status;
-    this.errors = isBulkError(data) ? data.errors : void 0;
+    this.errors = isBulkError(data) ? data.errors : [{ message: getMessage(data), status }];
+    this.requestId = requestId;
     if (data instanceof Error) {
       this.stack = data.stack;
       this.cause = data.cause;
     }
   }
+  toString() {
+    const error = super.toString();
+    return `[${this.status}] (${this.requestId ?? "Unknown"}): ${error}`;
+  }
 }
 function isBulkError(error) {
   return isObject(error) && Array.isArray(error.errors);
@@ -101,312 +569,555 @@ function getMessage(data) {
   }
 }
 
+function getHostUrl(provider, type) {
+  if (isHostProviderAlias(provider)) {
+    return providers[provider][type];
+  } else if (isHostProviderBuilder(provider)) {
+    return provider[type];
+  }
+  throw new Error("Invalid API provider");
+}
+const providers = {
+  production: {
+    main: "https://api.xata.io",
+    workspaces: "https://{workspaceId}.{region}.xata.sh"
+  },
+  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"
+  },
+  local: {
+    main: "http://localhost:6001",
+    workspaces: "http://{workspaceId}.{region}.localhost:6001"
+  }
+};
+function isHostProviderAlias(alias) {
+  return isString(alias) && Object.keys(providers).includes(alias);
+}
+function isHostProviderBuilder(builder) {
+  return isObject(builder) && isString(builder.main) && isString(builder.workspaces);
+}
+function parseProviderString(provider = "production") {
+  if (isHostProviderAlias(provider)) {
+    return provider;
+  }
+  const [main, workspaces] = provider.split(",");
+  if (!main || !workspaces)
+    return null;
+  return { main, workspaces };
+}
+function buildProviderString(provider) {
+  if (isHostProviderAlias(provider))
+    return provider;
+  return `${provider.main},${provider.workspaces}`;
+}
+function parseWorkspacesUrlParts(url) {
+  if (!isString(url))
+    return null;
+  const matches = {
+    production: url.match(/(?:https:\/\/)?([^.]+)(?:\.([^.]+))\.xata\.sh.*/),
+    staging: url.match(/(?:https:\/\/)?([^.]+)(?:\.([^.]+))\.staging-xata\.dev.*/),
+    dev: url.match(/(?:https:\/\/)?([^.]+)(?:\.([^.]+))\.dev-xata\.dev.*/),
+    local: url.match(/(?:https?:\/\/)?([^.]+)(?:\.([^.]+))\.localhost:(\d+)/)
+  };
+  const [host, match] = Object.entries(matches).find(([, match2]) => match2 !== null) ?? [];
+  if (!isHostProviderAlias(host) || !match)
+    return null;
+  return { workspace: match[1], region: match[2], host };
+}
+
+const pool = new ApiRequestPool();
 const resolveUrl = (url, queryParams = {}, pathParams = {}) => {
-  const query = new URLSearchParams(queryParams).toString();
+  const cleanQueryParams = Object.entries(queryParams).reduce((acc, [key, value]) => {
+    if (value === void 0 || value === null)
+      return acc;
+    return { ...acc, [key]: value };
+  }, {});
+  const query = new URLSearchParams(cleanQueryParams).toString();
   const queryString = query.length > 0 ? `?${query}` : "";
-  return url.replace(/\{\w*\}/g, (key) => pathParams[key.slice(1, -1)]) + queryString;
+  const cleanPathParams = Object.entries(pathParams).reduce((acc, [key, value]) => {
+    return { ...acc, [key]: encodeURIComponent(String(value ?? "")).replace("%3A", ":") };
+  }, {});
+  return url.replace(/\{\w*\}/g, (key) => cleanPathParams[key.slice(1, -1)]) + queryString;
 };
 function buildBaseUrl({
+  method,
+  endpoint,
   path,
   workspacesApiUrl,
   apiUrl,
-  pathParams
+  pathParams = {}
 }) {
-  if (!pathParams?.workspace)
-    return `${apiUrl}${path}`;
-  const url = typeof workspacesApiUrl === "string" ? `${workspacesApiUrl}${path}` : workspacesApiUrl(path, pathParams);
-  return url.replace("{workspaceId}", pathParams.workspace);
+  if (endpoint === "dataPlane") {
+    let url = isString(workspacesApiUrl) ? `${workspacesApiUrl}${path}` : workspacesApiUrl(path, pathParams);
+    if (method.toUpperCase() === "PUT" && [
+      "/db/{dbBranchName}/tables/{tableName}/data/{recordId}/column/{columnName}/file",
+      "/db/{dbBranchName}/tables/{tableName}/data/{recordId}/column/{columnName}/file/{fileId}"
+    ].includes(path)) {
+      const { host } = parseWorkspacesUrlParts(url) ?? {};
+      switch (host) {
+        case "production":
+          url = url.replace("xata.sh", "upload.xata.sh");
+          break;
+        case "staging":
+          url = url.replace("staging-xata.dev", "upload.staging-xata.dev");
+          break;
+        case "dev":
+          url = url.replace("dev-xata.dev", "upload.dev-xata.dev");
+          break;
+      }
+    }
+    const urlWithWorkspace = isString(pathParams.workspace) ? url.replace("{workspaceId}", String(pathParams.workspace)) : url;
+    return isString(pathParams.region) ? urlWithWorkspace.replace("{region}", String(pathParams.region)) : urlWithWorkspace;
+  }
+  return `${apiUrl}${path}`;
 }
 function hostHeader(url) {
   const pattern = /.*:\/\/(?<host>[^/]+).*/;
   const { groups } = pattern.exec(url) ?? {};
   return groups?.host ? { Host: groups.host } : {};
 }
+async function parseBody(body, headers) {
+  if (!isDefined(body))
+    return void 0;
+  if (isBlob(body) || typeof body.text === "function") {
+    return body;
+  }
+  const { "Content-Type": contentType } = headers ?? {};
+  if (String(contentType).toLowerCase() === "application/json" && isObject(body)) {
+    return JSON.stringify(body);
+  }
+  return body;
+}
+const defaultClientID = generateUUID();
 async function fetch$1({
   url: path,
   method,
   body,
-  headers,
+  headers: customHeaders,
   pathParams,
   queryParams,
-  fetchImpl,
+  fetch: fetch2,
   apiKey,
+  endpoint,
   apiUrl,
-  workspacesApiUrl
+  workspacesApiUrl,
+  trace,
+  signal,
+  clientID,
+  sessionID,
+  clientName,
+  xataAgentExtra,
+  fetchOptions = {},
+  rawResponse = false
 }) {
-  const baseUrl = buildBaseUrl({ path, workspacesApiUrl, pathParams, apiUrl });
+  pool.setFetch(fetch2);
+  return await trace(
+    `${method.toUpperCase()} ${path}`,
+    async ({ setAttributes }) => {
+      const baseUrl = buildBaseUrl({ method, endpoint, path, workspacesApiUrl, pathParams, apiUrl });
+      const fullUrl = resolveUrl(baseUrl, queryParams, pathParams);
+      const url = fullUrl.includes("localhost") ? fullUrl.replace(/^[^.]+\.[^.]+\./, "http://") : fullUrl;
+      setAttributes({
+        [TraceAttributes.HTTP_URL]: url,
+        [TraceAttributes.HTTP_TARGET]: resolveUrl(path, queryParams, pathParams)
+      });
+      const xataAgent = compact([
+        ["client", "TS_SDK"],
+        ["version", VERSION],
+        isDefined(clientName) ? ["service", clientName] : void 0,
+        ...Object.entries(xataAgentExtra ?? {})
+      ]).map(([key, value]) => `${key}=${value}`).join("; ");
+      const headers = compactObject({
+        "Accept-Encoding": "identity",
+        "Content-Type": "application/json",
+        "X-Xata-Client-ID": clientID ?? defaultClientID,
+        "X-Xata-Session-ID": sessionID ?? generateUUID(),
+        "X-Xata-Agent": xataAgent,
+        ...customHeaders,
+        ...hostHeader(fullUrl),
+        Authorization: `Bearer ${apiKey}`
+      });
+      const response = await pool.request(url, {
+        ...fetchOptions,
+        method: method.toUpperCase(),
+        body: await parseBody(body, headers),
+        headers,
+        signal
+      });
+      const { host, protocol } = parseUrl(response.url);
+      const requestId = response.headers?.get("x-request-id") ?? void 0;
+      setAttributes({
+        [TraceAttributes.KIND]: "http",
+        [TraceAttributes.HTTP_REQUEST_ID]: requestId,
+        [TraceAttributes.HTTP_STATUS_CODE]: response.status,
+        [TraceAttributes.HTTP_HOST]: host,
+        [TraceAttributes.HTTP_SCHEME]: protocol?.replace(":", ""),
+        [TraceAttributes.CLOUDFLARE_RAY_ID]: response.headers?.get("cf-ray") ?? void 0
+      });
+      const message = response.headers?.get("x-xata-message");
+      if (message)
+        console.warn(message);
+      if (response.status === 204) {
+        return {};
+      }
+      if (response.status === 429) {
+        throw new FetcherError(response.status, "Rate limit exceeded", requestId);
+      }
+      try {
+        const jsonResponse = rawResponse ? await response.blob() : await response.json();
+        if (response.ok) {
+          return jsonResponse;
+        }
+        throw new FetcherError(response.status, jsonResponse, requestId);
+      } catch (error) {
+        throw new FetcherError(response.status, error, requestId);
+      }
+    },
+    { [TraceAttributes.HTTP_METHOD]: method.toUpperCase(), [TraceAttributes.HTTP_ROUTE]: path }
+  );
+}
+function 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({ method, endpoint, path, workspacesApiUrl, pathParams, apiUrl });
   const fullUrl = resolveUrl(baseUrl, queryParams, pathParams);
   const url = fullUrl.includes("localhost") ? fullUrl.replace(/^[^.]+\./, "http://") : fullUrl;
-  const response = await fetchImpl(url, {
-    method: method.toUpperCase(),
-    body: body ? JSON.stringify(body) : void 0,
+  void fetchEventSource(url, {
+    method,
+    body: JSON.stringify(body),
+    fetch: fetch2,
+    signal,
     headers: {
-      "Content-Type": "application/json",
-      ...headers,
-      ...hostHeader(fullUrl),
-      Authorization: `Bearer ${apiKey}`
+      "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?.();
     }
   });
-  if (response.status === 204) {
-    return {};
-  }
+}
+function parseUrl(url) {
   try {
-    const jsonResponse = await response.json();
-    if (response.ok) {
-      return jsonResponse;
-    }
-    throw new FetcherError(response.status, jsonResponse);
+    const { host, protocol } = new URL(url);
+    return { host, protocol };
   } catch (error) {
-    throw new FetcherError(response.status, error);
+    return {};
   }
 }
 
-const getUser = (variables) => fetch$1({ url: "/user", method: "get", ...variables });
-const updateUser = (variables) => fetch$1({ url: "/user", method: "put", ...variables });
-const deleteUser = (variables) => fetch$1({ url: "/user", method: "delete", ...variables });
-const getUserAPIKeys = (variables) => fetch$1({
-  url: "/user/keys",
-  method: "get",
-  ...variables
-});
-const createUserAPIKey = (variables) => fetch$1({
-  url: "/user/keys/{keyName}",
-  method: "post",
-  ...variables
-});
-const deleteUserAPIKey = (variables) => fetch$1({
-  url: "/user/keys/{keyName}",
-  method: "delete",
-  ...variables
-});
-const createWorkspace = (variables) => fetch$1({
-  url: "/workspaces",
-  method: "post",
-  ...variables
-});
-const getWorkspacesList = (variables) => fetch$1({
-  url: "/workspaces",
+const dataPlaneFetch = async (options) => fetch$1({ ...options, endpoint: "dataPlane" });
+
+const applyMigration = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/pgroll/apply", method: "post", ...variables, signal });
+const pgRollStatus = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/pgroll/status",
   method: "get",
-  ...variables
+  ...variables,
+  signal
 });
-const getWorkspace = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}",
+const pgRollJobStatus = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/pgroll/jobs/{jobId}",
   method: "get",
-  ...variables
-});
-const updateWorkspace = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}",
-  method: "put",
-  ...variables
+  ...variables,
+  signal
 });
-const deleteWorkspace = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}",
-  method: "delete",
-  ...variables
-});
-const getWorkspaceMembersList = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}/members",
-  method: "get",
-  ...variables
-});
-const updateWorkspaceMemberRole = (variables) => fetch$1({ url: "/workspaces/{workspaceId}/members/{userId}", method: "put", ...variables });
-const removeWorkspaceMember = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}/members/{userId}",
-  method: "delete",
-  ...variables
-});
-const inviteWorkspaceMember = (variables) => fetch$1({ url: "/workspaces/{workspaceId}/invites", method: "post", ...variables });
-const cancelWorkspaceMemberInvite = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}/invites/{inviteId}",
-  method: "delete",
-  ...variables
-});
-const resendWorkspaceMemberInvite = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}/invites/{inviteId}/resend",
-  method: "post",
-  ...variables
-});
-const acceptWorkspaceMemberInvite = (variables) => fetch$1({
-  url: "/workspaces/{workspaceId}/invites/{inviteKey}/accept",
-  method: "post",
-  ...variables
-});
-const getDatabaseList = (variables) => fetch$1({
-  url: "/dbs",
-  method: "get",
-  ...variables
-});
-const getBranchList = (variables) => fetch$1({
+const pgRollMigrationHistory = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/pgroll/migrations", method: "get", ...variables, signal });
+const getBranchList = (variables, signal) => dataPlaneFetch({
   url: "/dbs/{dbName}",
   method: "get",
-  ...variables
+  ...variables,
+  signal
 });
-const createDatabase = (variables) => fetch$1({
-  url: "/dbs/{dbName}",
-  method: "put",
-  ...variables
-});
-const deleteDatabase = (variables) => fetch$1({
-  url: "/dbs/{dbName}",
-  method: "delete",
-  ...variables
-});
-const getGitBranchesMapping = (variables) => fetch$1({ url: "/dbs/{dbName}/gitBranches", method: "get", ...variables });
-const addGitBranchesEntry = (variables) => fetch$1({ url: "/dbs/{dbName}/gitBranches", method: "post", ...variables });
-const removeGitBranchesEntry = (variables) => fetch$1({ url: "/dbs/{dbName}/gitBranches", method: "delete", ...variables });
-const resolveBranch = (variables) => fetch$1({
-  url: "/dbs/{dbName}/resolveBranch",
-  method: "get",
-  ...variables
-});
-const getBranchDetails = (variables) => fetch$1({
+const getBranchDetails = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}",
   method: "get",
-  ...variables
+  ...variables,
+  signal
 });
-const createBranch = (variables) => fetch$1({
-  url: "/db/{dbBranchName}",
-  method: "put",
-  ...variables
-});
-const deleteBranch = (variables) => fetch$1({
+const createBranch = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}", method: "put", ...variables, signal });
+const deleteBranch = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}",
   method: "delete",
-  ...variables
+  ...variables,
+  signal
+});
+const getSchema = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/schema",
+  method: "get",
+  ...variables,
+  signal
+});
+const copyBranch = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/copy",
+  method: "post",
+  ...variables,
+  signal
 });
-const updateBranchMetadata = (variables) => fetch$1({
+const updateBranchMetadata = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/metadata",
   method: "put",
-  ...variables
+  ...variables,
+  signal
 });
-const getBranchMetadata = (variables) => fetch$1({
+const getBranchMetadata = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/metadata",
   method: "get",
-  ...variables
+  ...variables,
+  signal
 });
-const getBranchMigrationHistory = (variables) => fetch$1({ url: "/db/{dbBranchName}/migrations", method: "get", ...variables });
-const executeBranchMigrationPlan = (variables) => fetch$1({ url: "/db/{dbBranchName}/migrations/execute", method: "post", ...variables });
-const getBranchMigrationPlan = (variables) => fetch$1({ url: "/db/{dbBranchName}/migrations/plan", method: "post", ...variables });
-const getBranchStats = (variables) => fetch$1({
+const getBranchStats = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/stats",
   method: "get",
-  ...variables
+  ...variables,
+  signal
+});
+const getGitBranchesMapping = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/gitBranches", method: "get", ...variables, signal });
+const addGitBranchesEntry = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/gitBranches", method: "post", ...variables, signal });
+const removeGitBranchesEntry = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/gitBranches", method: "delete", ...variables, signal });
+const resolveBranch = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/resolveBranch", method: "get", ...variables, signal });
+const getBranchMigrationHistory = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/migrations", method: "get", ...variables, signal });
+const getBranchMigrationPlan = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/migrations/plan", method: "post", ...variables, signal });
+const executeBranchMigrationPlan = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/migrations/execute", method: "post", ...variables, signal });
+const queryMigrationRequests = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/migrations/query", method: "post", ...variables, signal });
+const createMigrationRequest = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/migrations", method: "post", ...variables, signal });
+const getMigrationRequest = (variables, signal) => dataPlaneFetch({
+  url: "/dbs/{dbName}/migrations/{mrNumber}",
+  method: "get",
+  ...variables,
+  signal
+});
+const updateMigrationRequest = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/migrations/{mrNumber}", method: "patch", ...variables, signal });
+const listMigrationRequestsCommits = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/migrations/{mrNumber}/commits", method: "post", ...variables, signal });
+const compareMigrationRequest = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/migrations/{mrNumber}/compare", method: "post", ...variables, signal });
+const getMigrationRequestIsMerged = (variables, signal) => dataPlaneFetch({ url: "/dbs/{dbName}/migrations/{mrNumber}/merge", method: "get", ...variables, signal });
+const mergeMigrationRequest = (variables, signal) => dataPlaneFetch({
+  url: "/dbs/{dbName}/migrations/{mrNumber}/merge",
+  method: "post",
+  ...variables,
+  signal
 });
-const createTable = (variables) => fetch$1({
+const getBranchSchemaHistory = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/schema/history", method: "post", ...variables, signal });
+const compareBranchWithUserSchema = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/schema/compare", method: "post", ...variables, signal });
+const compareBranchSchemas = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/schema/compare/{branchName}", method: "post", ...variables, signal });
+const updateBranchSchema = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/schema/update", method: "post", ...variables, signal });
+const previewBranchSchemaEdit = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/schema/preview", method: "post", ...variables, signal });
+const applyBranchSchemaEdit = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/schema/apply", method: "post", ...variables, signal });
+const 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",
-  ...variables
+  ...variables,
+  signal
 });
-const deleteTable = (variables) => fetch$1({
+const deleteTable = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}",
   method: "delete",
-  ...variables
+  ...variables,
+  signal
 });
-const updateTable = (variables) => fetch$1({
-  url: "/db/{dbBranchName}/tables/{tableName}",
-  method: "patch",
-  ...variables
-});
-const getTableSchema = (variables) => fetch$1({
+const updateTable = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}", method: "patch", ...variables, signal });
+const getTableSchema = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/schema",
   method: "get",
-  ...variables
+  ...variables,
+  signal
 });
-const setTableSchema = (variables) => fetch$1({
-  url: "/db/{dbBranchName}/tables/{tableName}/schema",
-  method: "put",
-  ...variables
-});
-const getTableColumns = (variables) => fetch$1({
+const setTableSchema = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/schema", method: "put", ...variables, signal });
+const getTableColumns = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/columns",
   method: "get",
-  ...variables
-});
-const addTableColumn = (variables) => fetch$1({
-  url: "/db/{dbBranchName}/tables/{tableName}/columns",
-  method: "post",
-  ...variables
+  ...variables,
+  signal
 });
-const getColumn = (variables) => fetch$1({
+const addTableColumn = (variables, signal) => dataPlaneFetch(
+  { url: "/db/{dbBranchName}/tables/{tableName}/columns", method: "post", ...variables, signal }
+);
+const getColumn = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/columns/{columnName}",
   method: "get",
-  ...variables
+  ...variables,
+  signal
 });
-const deleteColumn = (variables) => fetch$1({
+const updateColumn = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/columns/{columnName}", method: "patch", ...variables, signal });
+const deleteColumn = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/columns/{columnName}",
   method: "delete",
-  ...variables
+  ...variables,
+  signal
 });
-const updateColumn = (variables) => fetch$1({
-  url: "/db/{dbBranchName}/tables/{tableName}/columns/{columnName}",
-  method: "patch",
-  ...variables
+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 insertRecord = (variables) => fetch$1({
-  url: "/db/{dbBranchName}/tables/{tableName}/data",
-  method: "post",
-  ...variables
+const putFileItem = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}/column/{columnName}/file/{fileId}",
+  method: "put",
+  ...variables,
+  signal
 });
-const insertRecordWithID = (variables) => fetch$1({ url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}", method: "put", ...variables });
-const updateRecordWithID = (variables) => fetch$1({ url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}", method: "patch", ...variables });
-const upsertRecordWithID = (variables) => fetch$1({ url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}", method: "post", ...variables });
-const deleteRecord = (variables) => fetch$1({
-  url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}",
+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
+  ...variables,
+  signal
 });
-const getRecord = (variables) => fetch$1({
+const getRecord = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}",
   method: "get",
-  ...variables
+  ...variables,
+  signal
 });
-const bulkInsertTableRecords = (variables) => fetch$1({ url: "/db/{dbBranchName}/tables/{tableName}/bulk", method: "post", ...variables });
-const queryTable = (variables) => fetch$1({
+const insertRecordWithID = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}", method: "put", ...variables, signal });
+const updateRecordWithID = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}", method: "patch", ...variables, signal });
+const upsertRecordWithID = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}", method: "post", ...variables, signal });
+const deleteRecord = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}", method: "delete", ...variables, signal });
+const bulkInsertTableRecords = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/bulk", method: "post", ...variables, signal });
+const queryTable = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/query",
   method: "post",
-  ...variables
+  ...variables,
+  signal
 });
-const searchBranch = (variables) => fetch$1({
+const searchBranch = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/search",
   method: "post",
-  ...variables
+  ...variables,
+  signal
 });
-const operationsByTag = {
-  users: { getUser, updateUser, deleteUser, getUserAPIKeys, createUserAPIKey, deleteUserAPIKey },
-  workspaces: {
-    createWorkspace,
-    getWorkspacesList,
-    getWorkspace,
-    updateWorkspace,
-    deleteWorkspace,
-    getWorkspaceMembersList,
-    updateWorkspaceMemberRole,
-    removeWorkspaceMember,
-    inviteWorkspaceMember,
-    cancelWorkspaceMemberInvite,
-    resendWorkspaceMemberInvite,
-    acceptWorkspaceMemberInvite
-  },
-  database: {
-    getDatabaseList,
-    createDatabase,
-    deleteDatabase,
-    getGitBranchesMapping,
-    addGitBranchesEntry,
-    removeGitBranchesEntry,
-    resolveBranch
-  },
+const searchTable = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/tables/{tableName}/search",
+  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 askTableSession = (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 fileUpload = (variables, signal) => dataPlaneFetch({
+  url: "/file/{fileId}",
+  method: "put",
+  ...variables,
+  signal
+});
+const sqlQuery = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/sql",
+  method: "post",
+  ...variables,
+  signal
+});
+const operationsByTag$2 = {
   branch: {
+    applyMigration,
+    pgRollStatus,
+    pgRollJobStatus,
+    pgRollMigrationHistory,
     getBranchList,
     getBranchDetails,
     createBranch,
     deleteBranch,
+    copyBranch,
     updateBranchMetadata,
     getBranchMetadata,
+    getBranchStats,
+    getGitBranchesMapping,
+    addGitBranchesEntry,
+    removeGitBranchesEntry,
+    resolveBranch
+  },
+  migrations: {
+    getSchema,
     getBranchMigrationHistory,
-    executeBranchMigrationPlan,
     getBranchMigrationPlan,
-    getBranchStats
+    executeBranchMigrationPlan,
+    getBranchSchemaHistory,
+    compareBranchWithUserSchema,
+    compareBranchSchemas,
+    updateBranchSchema,
+    previewBranchSchemaEdit,
+    applyBranchSchemaEdit,
+    pushBranchMigrations
+  },
+  migrationRequests: {
+    queryMigrationRequests,
+    createMigrationRequest,
+    getMigrationRequest,
+    updateMigrationRequest,
+    listMigrationRequestsCommits,
+    compareMigrationRequest,
+    getMigrationRequestIsMerged,
+    mergeMigrationRequest
   },
   table: {
     createTable,
@@ -417,581 +1128,694 @@ const operationsByTag = {
     getTableColumns,
     addTableColumn,
     getColumn,
-    deleteColumn,
-    updateColumn
+    updateColumn,
+    deleteColumn
   },
   records: {
+    branchTransaction,
     insertRecord,
+    getRecord,
     insertRecordWithID,
     updateRecordWithID,
     upsertRecordWithID,
     deleteRecord,
-    getRecord,
-    bulkInsertTableRecords,
+    bulkInsertTableRecords
+  },
+  files: { getFileItem, putFileItem, deleteFileItem, getFile, putFile, deleteFile, fileAccess, fileUpload },
+  searchAndFilter: {
     queryTable,
-    searchBranch
-  }
-};
-
-function getHostUrl(provider, type) {
-  if (isValidAlias(provider)) {
-    return providers[provider][type];
-  } else if (isValidBuilder(provider)) {
-    return provider[type];
-  }
-  throw new Error("Invalid API provider");
-}
-const providers = {
-  production: {
-    main: "https://api.xata.io",
-    workspaces: "https://{workspaceId}.xata.sh"
+    searchBranch,
+    searchTable,
+    vectorSearchTable,
+    askTable,
+    askTableSession,
+    summarizeTable,
+    aggregateTable
   },
-  staging: {
-    main: "https://staging.xatabase.co",
-    workspaces: "https://{workspaceId}.staging.xatabase.co"
-  }
+  sql: { sqlQuery }
 };
-function isValidAlias(alias) {
-  return isString(alias) && Object.keys(providers).includes(alias);
-}
-function isValidBuilder(builder) {
-  return isObject(builder) && isString(builder.main) && isString(builder.workspaces);
-}
 
-var __accessCheck$7 = (obj, member, msg) => {
-  if (!member.has(obj))
-    throw TypeError("Cannot " + msg);
-};
-var __privateGet$6 = (obj, member, getter) => {
-  __accessCheck$7(obj, member, "read from private field");
-  return getter ? getter.call(obj) : member.get(obj);
-};
-var __privateAdd$7 = (obj, member, value) => {
-  if (member.has(obj))
-    throw TypeError("Cannot add the same private member more than once");
-  member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
-};
-var __privateSet$5 = (obj, member, value, setter) => {
-  __accessCheck$7(obj, member, "write to private field");
-  setter ? setter.call(obj, value) : member.set(obj, value);
-  return value;
-};
-var _extraProps, _namespaces;
-class XataApiClient {
-  constructor(options = {}) {
-    __privateAdd$7(this, _extraProps, void 0);
-    __privateAdd$7(this, _namespaces, {});
-    const provider = options.host ?? "production";
-    const apiKey = options?.apiKey ?? getAPIKey();
-    if (!apiKey) {
-      throw new Error("Could not resolve a valid apiKey");
-    }
-    __privateSet$5(this, _extraProps, {
-      apiUrl: getHostUrl(provider, "main"),
-      workspacesApiUrl: getHostUrl(provider, "workspaces"),
-      fetchImpl: getFetchImplementation(options.fetch),
-      apiKey
-    });
-  }
-  get user() {
-    if (!__privateGet$6(this, _namespaces).user)
-      __privateGet$6(this, _namespaces).user = new UserApi(__privateGet$6(this, _extraProps));
-    return __privateGet$6(this, _namespaces).user;
-  }
-  get workspaces() {
-    if (!__privateGet$6(this, _namespaces).workspaces)
-      __privateGet$6(this, _namespaces).workspaces = new WorkspaceApi(__privateGet$6(this, _extraProps));
-    return __privateGet$6(this, _namespaces).workspaces;
-  }
-  get databases() {
-    if (!__privateGet$6(this, _namespaces).databases)
-      __privateGet$6(this, _namespaces).databases = new DatabaseApi(__privateGet$6(this, _extraProps));
-    return __privateGet$6(this, _namespaces).databases;
-  }
-  get branches() {
-    if (!__privateGet$6(this, _namespaces).branches)
-      __privateGet$6(this, _namespaces).branches = new BranchApi(__privateGet$6(this, _extraProps));
-    return __privateGet$6(this, _namespaces).branches;
-  }
-  get tables() {
-    if (!__privateGet$6(this, _namespaces).tables)
-      __privateGet$6(this, _namespaces).tables = new TableApi(__privateGet$6(this, _extraProps));
-    return __privateGet$6(this, _namespaces).tables;
-  }
-  get records() {
-    if (!__privateGet$6(this, _namespaces).records)
-      __privateGet$6(this, _namespaces).records = new RecordsApi(__privateGet$6(this, _extraProps));
-    return __privateGet$6(this, _namespaces).records;
-  }
-}
-_extraProps = new WeakMap();
-_namespaces = new WeakMap();
-class UserApi {
-  constructor(extraProps) {
-    this.extraProps = extraProps;
-  }
-  getUser() {
-    return operationsByTag.users.getUser({ ...this.extraProps });
-  }
-  updateUser(user) {
-    return operationsByTag.users.updateUser({ body: user, ...this.extraProps });
-  }
-  deleteUser() {
-    return operationsByTag.users.deleteUser({ ...this.extraProps });
-  }
-  getUserAPIKeys() {
-    return operationsByTag.users.getUserAPIKeys({ ...this.extraProps });
-  }
-  createUserAPIKey(keyName) {
-    return operationsByTag.users.createUserAPIKey({
-      pathParams: { keyName },
-      ...this.extraProps
-    });
-  }
-  deleteUserAPIKey(keyName) {
-    return operationsByTag.users.deleteUserAPIKey({
-      pathParams: { keyName },
-      ...this.extraProps
-    });
-  }
-}
-class WorkspaceApi {
-  constructor(extraProps) {
-    this.extraProps = extraProps;
-  }
-  createWorkspace(workspaceMeta) {
-    return operationsByTag.workspaces.createWorkspace({
-      body: workspaceMeta,
-      ...this.extraProps
-    });
-  }
-  getWorkspacesList() {
-    return operationsByTag.workspaces.getWorkspacesList({ ...this.extraProps });
-  }
-  getWorkspace(workspaceId) {
-    return operationsByTag.workspaces.getWorkspace({
-      pathParams: { workspaceId },
-      ...this.extraProps
-    });
-  }
-  updateWorkspace(workspaceId, workspaceMeta) {
-    return operationsByTag.workspaces.updateWorkspace({
-      pathParams: { workspaceId },
-      body: workspaceMeta,
-      ...this.extraProps
-    });
-  }
-  deleteWorkspace(workspaceId) {
-    return operationsByTag.workspaces.deleteWorkspace({
-      pathParams: { workspaceId },
-      ...this.extraProps
-    });
-  }
-  getWorkspaceMembersList(workspaceId) {
-    return operationsByTag.workspaces.getWorkspaceMembersList({
-      pathParams: { workspaceId },
-      ...this.extraProps
-    });
-  }
-  updateWorkspaceMemberRole(workspaceId, userId, role) {
-    return operationsByTag.workspaces.updateWorkspaceMemberRole({
-      pathParams: { workspaceId, userId },
-      body: { role },
-      ...this.extraProps
-    });
-  }
-  removeWorkspaceMember(workspaceId, userId) {
-    return operationsByTag.workspaces.removeWorkspaceMember({
-      pathParams: { workspaceId, userId },
-      ...this.extraProps
-    });
-  }
-  inviteWorkspaceMember(workspaceId, email, role) {
-    return operationsByTag.workspaces.inviteWorkspaceMember({
-      pathParams: { workspaceId },
-      body: { email, role },
-      ...this.extraProps
-    });
-  }
-  cancelWorkspaceMemberInvite(workspaceId, inviteId) {
-    return operationsByTag.workspaces.cancelWorkspaceMemberInvite({
-      pathParams: { workspaceId, inviteId },
-      ...this.extraProps
-    });
-  }
-  resendWorkspaceMemberInvite(workspaceId, inviteId) {
-    return operationsByTag.workspaces.resendWorkspaceMemberInvite({
-      pathParams: { workspaceId, inviteId },
-      ...this.extraProps
-    });
+const controlPlaneFetch = async (options) => fetch$1({ ...options, endpoint: "controlPlane" });
+
+const getAuthorizationCode = (variables, signal) => controlPlaneFetch({ url: "/oauth/authorize", method: "get", ...variables, signal });
+const grantAuthorizationCode = (variables, signal) => controlPlaneFetch({ url: "/oauth/authorize", method: "post", ...variables, signal });
+const getUser = (variables, signal) => controlPlaneFetch({
+  url: "/user",
+  method: "get",
+  ...variables,
+  signal
+});
+const updateUser = (variables, signal) => controlPlaneFetch({
+  url: "/user",
+  method: "put",
+  ...variables,
+  signal
+});
+const deleteUser = (variables, signal) => controlPlaneFetch({
+  url: "/user",
+  method: "delete",
+  ...variables,
+  signal
+});
+const getUserAPIKeys = (variables, signal) => controlPlaneFetch({
+  url: "/user/keys",
+  method: "get",
+  ...variables,
+  signal
+});
+const createUserAPIKey = (variables, signal) => controlPlaneFetch({
+  url: "/user/keys/{keyName}",
+  method: "post",
+  ...variables,
+  signal
+});
+const deleteUserAPIKey = (variables, signal) => controlPlaneFetch({
+  url: "/user/keys/{keyName}",
+  method: "delete",
+  ...variables,
+  signal
+});
+const getUserOAuthClients = (variables, signal) => controlPlaneFetch({
+  url: "/user/oauth/clients",
+  method: "get",
+  ...variables,
+  signal
+});
+const deleteUserOAuthClient = (variables, signal) => controlPlaneFetch({
+  url: "/user/oauth/clients/{clientId}",
+  method: "delete",
+  ...variables,
+  signal
+});
+const getUserOAuthAccessTokens = (variables, signal) => controlPlaneFetch({
+  url: "/user/oauth/tokens",
+  method: "get",
+  ...variables,
+  signal
+});
+const deleteOAuthAccessToken = (variables, signal) => controlPlaneFetch({
+  url: "/user/oauth/tokens/{token}",
+  method: "delete",
+  ...variables,
+  signal
+});
+const updateOAuthAccessToken = (variables, signal) => controlPlaneFetch({ url: "/user/oauth/tokens/{token}", method: "patch", ...variables, signal });
+const getWorkspacesList = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces",
+  method: "get",
+  ...variables,
+  signal
+});
+const createWorkspace = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces",
+  method: "post",
+  ...variables,
+  signal
+});
+const getWorkspace = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces/{workspaceId}",
+  method: "get",
+  ...variables,
+  signal
+});
+const updateWorkspace = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces/{workspaceId}",
+  method: "put",
+  ...variables,
+  signal
+});
+const deleteWorkspace = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces/{workspaceId}",
+  method: "delete",
+  ...variables,
+  signal
+});
+const getWorkspaceMembersList = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/members", method: "get", ...variables, signal });
+const updateWorkspaceMemberRole = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/members/{userId}", method: "put", ...variables, signal });
+const removeWorkspaceMember = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces/{workspaceId}/members/{userId}",
+  method: "delete",
+  ...variables,
+  signal
+});
+const inviteWorkspaceMember = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/invites", method: "post", ...variables, signal });
+const updateWorkspaceMemberInvite = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/invites/{inviteId}", method: "patch", ...variables, signal });
+const cancelWorkspaceMemberInvite = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/invites/{inviteId}", method: "delete", ...variables, signal });
+const acceptWorkspaceMemberInvite = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/invites/{inviteKey}/accept", method: "post", ...variables, signal });
+const resendWorkspaceMemberInvite = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/invites/{inviteId}/resend", method: "post", ...variables, signal });
+const listClusters = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/clusters", method: "get", ...variables, signal });
+const createCluster = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/clusters", method: "post", ...variables, signal });
+const getCluster = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces/{workspaceId}/clusters/{clusterId}",
+  method: "get",
+  ...variables,
+  signal
+});
+const updateCluster = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/clusters/{clusterId}", method: "patch", ...variables, signal });
+const getDatabaseList = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces/{workspaceId}/dbs",
+  method: "get",
+  ...variables,
+  signal
+});
+const createDatabase = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/dbs/{dbName}", method: "put", ...variables, signal });
+const deleteDatabase = (variables, signal) => controlPlaneFetch({
+  url: "/workspaces/{workspaceId}/dbs/{dbName}",
+  method: "delete",
+  ...variables,
+  signal
+});
+const getDatabaseMetadata = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/dbs/{dbName}", method: "get", ...variables, signal });
+const updateDatabaseMetadata = (variables, signal) => controlPlaneFetch({ url: "/workspaces/{workspaceId}/dbs/{dbName}", method: "patch", ...variables, signal });
+const 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",
+  ...variables,
+  signal
+});
+const operationsByTag$1 = {
+  oAuth: {
+    getAuthorizationCode,
+    grantAuthorizationCode,
+    getUserOAuthClients,
+    deleteUserOAuthClient,
+    getUserOAuthAccessTokens,
+    deleteOAuthAccessToken,
+    updateOAuthAccessToken
+  },
+  users: { getUser, updateUser, deleteUser },
+  authentication: { getUserAPIKeys, createUserAPIKey, deleteUserAPIKey },
+  workspaces: {
+    getWorkspacesList,
+    createWorkspace,
+    getWorkspace,
+    updateWorkspace,
+    deleteWorkspace,
+    getWorkspaceMembersList,
+    updateWorkspaceMemberRole,
+    removeWorkspaceMember
+  },
+  invites: {
+    inviteWorkspaceMember,
+    updateWorkspaceMemberInvite,
+    cancelWorkspaceMemberInvite,
+    acceptWorkspaceMemberInvite,
+    resendWorkspaceMemberInvite
+  },
+  xbcontrolOther: { listClusters, createCluster, getCluster, updateCluster },
+  databases: {
+    getDatabaseList,
+    createDatabase,
+    deleteDatabase,
+    getDatabaseMetadata,
+    updateDatabaseMetadata,
+    renameDatabase,
+    getDatabaseGithubSettings,
+    updateDatabaseGithubSettings,
+    deleteDatabaseGithubSettings,
+    listRegions
   }
-  acceptWorkspaceMemberInvite(workspaceId, inviteKey) {
-    return operationsByTag.workspaces.acceptWorkspaceMemberInvite({
-      pathParams: { workspaceId, inviteKey },
-      ...this.extraProps
+};
+
+const operationsByTag = deepMerge(operationsByTag$2, operationsByTag$1);
+
+const buildApiClient = () => class {
+  constructor(options = {}) {
+    const provider = options.host ?? "production";
+    const apiKey = options.apiKey ?? getAPIKey();
+    const trace = options.trace ?? defaultTrace;
+    const clientID = generateUUID();
+    if (!apiKey) {
+      throw new Error("Could not resolve a valid apiKey");
+    }
+    const extraProps = {
+      apiUrl: getHostUrl(provider, "main"),
+      workspacesApiUrl: getHostUrl(provider, "workspaces"),
+      fetch: getFetchImplementation(options.fetch),
+      apiKey,
+      trace,
+      clientName: options.clientName,
+      xataAgentExtra: options.xataAgentExtra,
+      clientID
+    };
+    return new Proxy(this, {
+      get: (_target, namespace) => {
+        if (operationsByTag[namespace] === void 0) {
+          return void 0;
+        }
+        return new Proxy(
+          {},
+          {
+            get: (_target2, operation) => {
+              if (operationsByTag[namespace][operation] === void 0) {
+                return void 0;
+              }
+              const method = operationsByTag[namespace][operation];
+              return async (params) => {
+                return await method({ ...params, ...extraProps });
+              };
+            }
+          }
+        );
+      }
     });
   }
+};
+class XataApiClient extends buildApiClient() {
 }
-class DatabaseApi {
-  constructor(extraProps) {
-    this.extraProps = extraProps;
-  }
-  getDatabaseList(workspace) {
-    return operationsByTag.database.getDatabaseList({
-      pathParams: { workspace },
-      ...this.extraProps
-    });
-  }
-  createDatabase(workspace, dbName, options = {}) {
-    return operationsByTag.database.createDatabase({
-      pathParams: { workspace, dbName },
-      body: options,
-      ...this.extraProps
-    });
-  }
-  deleteDatabase(workspace, dbName) {
-    return operationsByTag.database.deleteDatabase({
-      pathParams: { workspace, dbName },
-      ...this.extraProps
-    });
-  }
-  getGitBranchesMapping(workspace, dbName) {
-    return operationsByTag.database.getGitBranchesMapping({
-      pathParams: { workspace, dbName },
-      ...this.extraProps
-    });
-  }
-  addGitBranchesEntry(workspace, dbName, body) {
-    return operationsByTag.database.addGitBranchesEntry({
-      pathParams: { workspace, dbName },
-      body,
-      ...this.extraProps
-    });
-  }
-  removeGitBranchesEntry(workspace, dbName, gitBranch) {
-    return operationsByTag.database.removeGitBranchesEntry({
-      pathParams: { workspace, dbName },
-      queryParams: { gitBranch },
-      ...this.extraProps
-    });
-  }
-  resolveBranch(workspace, dbName, gitBranch) {
-    return operationsByTag.database.resolveBranch({
-      pathParams: { workspace, dbName },
-      queryParams: { gitBranch },
-      ...this.extraProps
-    });
+
+class XataApiPlugin {
+  build(options) {
+    return new XataApiClient(options);
   }
 }
-class BranchApi {
-  constructor(extraProps) {
-    this.extraProps = extraProps;
-  }
-  getBranchList(workspace, dbName) {
-    return operationsByTag.branch.getBranchList({
-      pathParams: { workspace, dbName },
-      ...this.extraProps
-    });
-  }
-  getBranchDetails(workspace, database, branch) {
-    return operationsByTag.branch.getBranchDetails({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      ...this.extraProps
-    });
-  }
-  createBranch(workspace, database, branch, from = "", options = {}) {
-    return operationsByTag.branch.createBranch({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      queryParams: { from },
-      body: options,
-      ...this.extraProps
-    });
-  }
-  deleteBranch(workspace, database, branch) {
-    return operationsByTag.branch.deleteBranch({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      ...this.extraProps
-    });
-  }
-  updateBranchMetadata(workspace, database, branch, metadata = {}) {
-    return operationsByTag.branch.updateBranchMetadata({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      body: metadata,
-      ...this.extraProps
-    });
-  }
-  getBranchMetadata(workspace, database, branch) {
-    return operationsByTag.branch.getBranchMetadata({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      ...this.extraProps
-    });
-  }
-  getBranchMigrationHistory(workspace, database, branch, options = {}) {
-    return operationsByTag.branch.getBranchMigrationHistory({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      body: options,
-      ...this.extraProps
-    });
-  }
-  executeBranchMigrationPlan(workspace, database, branch, migrationPlan) {
-    return operationsByTag.branch.executeBranchMigrationPlan({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      body: migrationPlan,
-      ...this.extraProps
-    });
-  }
-  getBranchMigrationPlan(workspace, database, branch, schema) {
-    return operationsByTag.branch.getBranchMigrationPlan({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      body: schema,
-      ...this.extraProps
-    });
-  }
-  getBranchStats(workspace, database, branch) {
-    return operationsByTag.branch.getBranchStats({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      ...this.extraProps
-    });
-  }
+
+class XataPlugin {
 }
-class TableApi {
-  constructor(extraProps) {
-    this.extraProps = extraProps;
-  }
-  createTable(workspace, database, branch, tableName) {
-    return operationsByTag.table.createTable({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      ...this.extraProps
-    });
-  }
-  deleteTable(workspace, database, branch, tableName) {
-    return operationsByTag.table.deleteTable({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      ...this.extraProps
-    });
-  }
-  updateTable(workspace, database, branch, tableName, options) {
-    return operationsByTag.table.updateTable({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      body: options,
-      ...this.extraProps
-    });
-  }
-  getTableSchema(workspace, database, branch, tableName) {
-    return operationsByTag.table.getTableSchema({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      ...this.extraProps
-    });
-  }
-  setTableSchema(workspace, database, branch, tableName, options) {
-    return operationsByTag.table.setTableSchema({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      body: options,
-      ...this.extraProps
-    });
-  }
-  getTableColumns(workspace, database, branch, tableName) {
-    return operationsByTag.table.getTableColumns({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      ...this.extraProps
-    });
-  }
-  addTableColumn(workspace, database, branch, tableName, column) {
-    return operationsByTag.table.addTableColumn({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      body: column,
-      ...this.extraProps
-    });
-  }
-  getColumn(workspace, database, branch, tableName, columnName) {
-    return operationsByTag.table.getColumn({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, columnName },
-      ...this.extraProps
-    });
-  }
-  deleteColumn(workspace, database, branch, tableName, columnName) {
-    return operationsByTag.table.deleteColumn({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, columnName },
-      ...this.extraProps
-    });
+
+function buildTransformString(transformations) {
+  return transformations.flatMap(
+    (t) => Object.entries(t).map(([key, value]) => {
+      if (key === "trim") {
+        const { left = 0, top = 0, right = 0, bottom = 0 } = value;
+        return `${key}=${[top, right, bottom, left].join(";")}`;
+      }
+      if (key === "gravity" && typeof value === "object") {
+        const { x = 0.5, y = 0.5 } = value;
+        return `${key}=${[x, y].join("x")}`;
+      }
+      return `${key}=${value}`;
+    })
+  ).join(",");
+}
+function transformImage(url, ...transformations) {
+  if (!isDefined(url))
+    return void 0;
+  const newTransformations = buildTransformString(transformations);
+  const { hostname, pathname, search } = new URL(url);
+  const pathParts = pathname.split("/");
+  const transformIndex = pathParts.findIndex((part) => part === "transform");
+  const removedItems = transformIndex >= 0 ? pathParts.splice(transformIndex, 2) : [];
+  const transform = `/transform/${[removedItems[1], newTransformations].filter(isDefined).join(",")}`;
+  const path = pathParts.join("/");
+  return `https://${hostname}${transform}${path}${search}`;
+}
+
+class XataFile {
+  constructor(file) {
+    this.id = file.id;
+    this.name = file.name;
+    this.mediaType = file.mediaType;
+    this.base64Content = file.base64Content;
+    this.enablePublicUrl = file.enablePublicUrl;
+    this.signedUrlTimeout = file.signedUrlTimeout;
+    this.uploadUrlTimeout = file.uploadUrlTimeout;
+    this.size = file.size;
+    this.version = file.version;
+    this.url = file.url;
+    this.signedUrl = file.signedUrl;
+    this.uploadUrl = file.uploadUrl;
+    this.attributes = file.attributes;
+  }
+  static fromBuffer(buffer, options = {}) {
+    const base64Content = buffer.toString("base64");
+    return new XataFile({ ...options, base64Content });
+  }
+  toBuffer() {
+    if (!this.base64Content) {
+      throw new Error(`File content is not available, please select property "base64Content" when querying the file`);
+    }
+    return Buffer.from(this.base64Content, "base64");
   }
-  updateColumn(workspace, database, branch, tableName, columnName, options) {
-    return operationsByTag.table.updateColumn({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, columnName },
-      body: options,
-      ...this.extraProps
-    });
+  static fromArrayBuffer(arrayBuffer, options = {}) {
+    const uint8Array = new Uint8Array(arrayBuffer);
+    return this.fromUint8Array(uint8Array, options);
   }
-}
-class RecordsApi {
-  constructor(extraProps) {
-    this.extraProps = extraProps;
+  toArrayBuffer() {
+    if (!this.base64Content) {
+      throw new Error(`File content is not available, please select property "base64Content" when querying the file`);
+    }
+    const binary = atob(this.base64Content);
+    return new ArrayBuffer(binary.length);
   }
-  insertRecord(workspace, database, branch, tableName, record) {
-    return operationsByTag.records.insertRecord({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      body: record,
-      ...this.extraProps
-    });
+  static fromUint8Array(uint8Array, options = {}) {
+    let binary = "";
+    for (let i = 0; i < uint8Array.byteLength; i++) {
+      binary += String.fromCharCode(uint8Array[i]);
+    }
+    const base64Content = btoa(binary);
+    return new XataFile({ ...options, base64Content });
   }
-  insertRecordWithID(workspace, database, branch, tableName, recordId, record, options = {}) {
-    return operationsByTag.records.insertRecordWithID({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, recordId },
-      queryParams: options,
-      body: record,
-      ...this.extraProps
-    });
+  toUint8Array() {
+    if (!this.base64Content) {
+      throw new Error(`File content is not available, please select property "base64Content" when querying the file`);
+    }
+    const binary = atob(this.base64Content);
+    const uint8Array = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+      uint8Array[i] = binary.charCodeAt(i);
+    }
+    return uint8Array;
   }
-  updateRecordWithID(workspace, database, branch, tableName, recordId, record, options = {}) {
-    return operationsByTag.records.updateRecordWithID({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, recordId },
-      queryParams: options,
-      body: record,
-      ...this.extraProps
-    });
+  static async fromBlob(file, options = {}) {
+    const name = options.name ?? file.name;
+    const mediaType = file.type;
+    const arrayBuffer = await file.arrayBuffer();
+    return this.fromArrayBuffer(arrayBuffer, { ...options, name, mediaType });
   }
-  upsertRecordWithID(workspace, database, branch, tableName, recordId, record, options = {}) {
-    return operationsByTag.records.upsertRecordWithID({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, recordId },
-      queryParams: options,
-      body: record,
-      ...this.extraProps
-    });
+  toBlob() {
+    if (!this.base64Content) {
+      throw new Error(`File content is not available, please select property "base64Content" when querying the file`);
+    }
+    const binary = atob(this.base64Content);
+    const uint8Array = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+      uint8Array[i] = binary.charCodeAt(i);
+    }
+    return new Blob([uint8Array], { type: this.mediaType });
   }
-  deleteRecord(workspace, database, branch, tableName, recordId) {
-    return operationsByTag.records.deleteRecord({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, recordId },
-      ...this.extraProps
-    });
+  static fromString(string, options = {}) {
+    const base64Content = btoa(string);
+    return new XataFile({ ...options, base64Content });
   }
-  getRecord(workspace, database, branch, tableName, recordId, options = {}) {
-    return operationsByTag.records.getRecord({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName, recordId },
-      ...this.extraProps
-    });
+  toString() {
+    if (!this.base64Content) {
+      throw new Error(`File content is not available, please select property "base64Content" when querying the file`);
+    }
+    return atob(this.base64Content);
   }
-  bulkInsertTableRecords(workspace, database, branch, tableName, records) {
-    return operationsByTag.records.bulkInsertTableRecords({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      body: { records },
-      ...this.extraProps
-    });
+  static fromBase64(base64Content, options = {}) {
+    return new XataFile({ ...options, base64Content });
   }
-  queryTable(workspace, database, branch, tableName, query) {
-    return operationsByTag.records.queryTable({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
-      body: query,
-      ...this.extraProps
-    });
+  toBase64() {
+    if (!this.base64Content) {
+      throw new Error(`File content is not available, please select property "base64Content" when querying the file`);
+    }
+    return this.base64Content;
   }
-  searchBranch(workspace, database, branch, query) {
-    return operationsByTag.records.searchBranch({
-      pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      body: query,
-      ...this.extraProps
-    });
+  transform(...options) {
+    return {
+      url: transformImage(this.url, ...options),
+      signedUrl: transformImage(this.signedUrl, ...options),
+      metadataUrl: transformImage(this.url, ...options, { format: "json" }),
+      metadataSignedUrl: transformImage(this.signedUrl, ...options, { format: "json" })
+    };
   }
 }
+const parseInputFileEntry = async (entry) => {
+  if (!isDefined(entry))
+    return null;
+  const { id, name, mediaType, base64Content, enablePublicUrl, signedUrlTimeout, uploadUrlTimeout } = await entry;
+  return compactObject({
+    id,
+    // Name cannot be an empty string in our API
+    name: name ? name : void 0,
+    mediaType,
+    base64Content,
+    enablePublicUrl,
+    signedUrlTimeout,
+    uploadUrlTimeout
+  });
+};
 
-class XataApiPlugin {
-  async build(options) {
-    const { fetchImpl, apiKey } = await options.getFetchProps();
-    return new XataApiClient({ fetch: fetchImpl, apiKey });
-  }
+function cleanFilter(filter) {
+  if (!isDefined(filter))
+    return 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;
 }
 
-class XataPlugin {
+function stringifyJson(value) {
+  if (!isDefined(value))
+    return value;
+  if (isString(value))
+    return value;
+  try {
+    return JSON.stringify(value);
+  } catch (e) {
+    return value;
+  }
+}
+function parseJson(value) {
+  try {
+    return JSON.parse(value);
+  } catch (e) {
+    return value;
+  }
 }
 
-var __accessCheck$6 = (obj, member, msg) => {
+var __accessCheck$5 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
 };
-var __privateGet$5 = (obj, member, getter) => {
-  __accessCheck$6(obj, member, "read from private field");
+var __privateGet$4 = (obj, member, getter) => {
+  __accessCheck$5(obj, member, "read from private field");
   return getter ? getter.call(obj) : member.get(obj);
 };
-var __privateAdd$6 = (obj, member, value) => {
+var __privateAdd$5 = (obj, member, value) => {
   if (member.has(obj))
     throw TypeError("Cannot add the same private member more than once");
   member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 };
-var __privateSet$4 = (obj, member, value, setter) => {
-  __accessCheck$6(obj, member, "write to private field");
+var __privateSet$3 = (obj, member, value, setter) => {
+  __accessCheck$5(obj, member, "write to private field");
   setter ? setter.call(obj, value) : member.set(obj, value);
   return value;
 };
-var _query;
+var _query, _page;
 class Page {
   constructor(query, meta, records = []) {
-    __privateAdd$6(this, _query, void 0);
-    __privateSet$4(this, _query, query);
+    __privateAdd$5(this, _query, void 0);
+    __privateSet$3(this, _query, query);
     this.meta = meta;
-    this.records = records;
-  }
+    this.records = new PageRecordArray(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$5(this, _query).getPaginated({ page: { size, offset, after: this.meta.page.cursor } });
-  }
+    return __privateGet$4(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$5(this, _query).getPaginated({ page: { size, offset, before: this.meta.page.cursor } });
-  }
-  async firstPage(size, offset) {
-    return __privateGet$5(this, _query).getPaginated({ page: { size, offset, first: this.meta.page.cursor } });
-  }
-  async lastPage(size, offset) {
-    return __privateGet$5(this, _query).getPaginated({ page: { size, offset, last: this.meta.page.cursor } });
-  }
+    return __privateGet$4(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$4(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$4(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;
   }
 }
 _query = new WeakMap();
-const PAGINATION_MAX_SIZE = 200;
-const PAGINATION_DEFAULT_SIZE = 200;
-const PAGINATION_MAX_OFFSET = 800;
+const PAGINATION_MAX_SIZE = 1e3;
+const PAGINATION_DEFAULT_SIZE = 20;
+const PAGINATION_MAX_OFFSET = 49e3;
 const PAGINATION_DEFAULT_OFFSET = 0;
+function isCursorPaginationOptions(options) {
+  return isDefined(options) && (isDefined(options.start) || isDefined(options.end) || isDefined(options.after) || isDefined(options.before));
+}
+class RecordArray extends Array {
+  constructor(...args) {
+    super(...RecordArray.parseConstructorParams(...args));
+  }
+  static parseConstructorParams(...args) {
+    if (args.length === 1 && typeof args[0] === "number") {
+      return new Array(args[0]);
+    }
+    if (args.length <= 1 && Array.isArray(args[0] ?? [])) {
+      const result = args[0] ?? [];
+      return new Array(...result);
+    }
+    return new Array(...args);
+  }
+  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);
+  }
+}
+const _PageRecordArray = class _PageRecordArray extends Array {
+  constructor(...args) {
+    super(..._PageRecordArray.parseConstructorParams(...args));
+    __privateAdd$5(this, _page, void 0);
+    __privateSet$3(this, _page, isObject(args[0]?.meta) ? args[0] : { meta: { page: { cursor: "", more: false } }, records: [] });
+  }
+  static parseConstructorParams(...args) {
+    if (args.length === 1 && typeof args[0] === "number") {
+      return new Array(args[0]);
+    }
+    if (args.length <= 2 && isObject(args[0]?.meta) && Array.isArray(args[1] ?? [])) {
+      const result = args[1] ?? args[0].records ?? [];
+      return new Array(...result);
+    }
+    return new Array(...args);
+  }
+  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);
+  }
+  /**
+   * Retrieve next page of records
+   *
+   * @returns A new array of objects
+   */
+  async nextPage(size, offset) {
+    const newPage = await __privateGet$4(this, _page).nextPage(size, offset);
+    return new _PageRecordArray(newPage);
+  }
+  /**
+   * Retrieve previous page of records
+   *
+   * @returns A new array of objects
+   */
+  async previousPage(size, offset) {
+    const newPage = await __privateGet$4(this, _page).previousPage(size, offset);
+    return new _PageRecordArray(newPage);
+  }
+  /**
+   * Retrieve start page of records
+   *
+   * @returns A new array of objects
+   */
+  async startPage(size, offset) {
+    const newPage = await __privateGet$4(this, _page).startPage(size, offset);
+    return new _PageRecordArray(newPage);
+  }
+  /**
+   * Retrieve end page of records
+   *
+   * @returns A new array of objects
+   */
+  async endPage(size, offset) {
+    const newPage = await __privateGet$4(this, _page).endPage(size, offset);
+    return new _PageRecordArray(newPage);
+  }
+  /**
+   * @returns Boolean indicating if there is a next page
+   */
+  hasNextPage() {
+    return __privateGet$4(this, _page).meta.page.more;
+  }
+};
+_page = new WeakMap();
+let PageRecordArray = _PageRecordArray;
 
-var __accessCheck$5 = (obj, member, msg) => {
+var __accessCheck$4 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
 };
-var __privateGet$4 = (obj, member, getter) => {
-  __accessCheck$5(obj, member, "read from private field");
+var __privateGet$3 = (obj, member, getter) => {
+  __accessCheck$4(obj, member, "read from private field");
   return getter ? getter.call(obj) : member.get(obj);
 };
-var __privateAdd$5 = (obj, member, value) => {
+var __privateAdd$4 = (obj, member, value) => {
   if (member.has(obj))
     throw TypeError("Cannot add the same private member more than once");
   member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 };
-var __privateSet$3 = (obj, member, value, setter) => {
-  __accessCheck$5(obj, member, "write to private field");
+var __privateSet$2 = (obj, member, value, setter) => {
+  __accessCheck$4(obj, member, "write to private field");
   setter ? setter.call(obj, value) : member.set(obj, value);
   return value;
 };
-var _table$1, _repository, _data;
-const _Query = class {
-  constructor(repository, table, data, parent) {
-    __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 = [];
-    __privateSet$3(this, _table$1, table);
+var __privateMethod$3 = (obj, member, method) => {
+  __accessCheck$4(obj, member, "access private method");
+  return method;
+};
+var _table$1, _repository, _data, _cleanFilterConstraint, cleanFilterConstraint_fn;
+const _Query = class _Query {
+  constructor(repository, table, data, rawParent) {
+    __privateAdd$4(this, _cleanFilterConstraint);
+    __privateAdd$4(this, _table$1, void 0);
+    __privateAdd$4(this, _repository, void 0);
+    __privateAdd$4(this, _data, { filter: {} });
+    // Implements pagination
+    this.meta = { page: { cursor: "start", more: true, size: PAGINATION_DEFAULT_SIZE } };
+    this.records = new PageRecordArray(this, []);
+    __privateSet$2(this, _table$1, table);
     if (repository) {
-      __privateSet$3(this, _repository, repository);
+      __privateSet$2(this, _repository, repository);
     } else {
-      __privateSet$3(this, _repository, this);
+      __privateSet$2(this, _repository, this);
     }
-    __privateGet$4(this, _data).filter = data.filter ?? parent?.filter ?? {};
-    __privateGet$4(this, _data).filter.$any = data.filter?.$any ?? parent?.filter?.$any;
-    __privateGet$4(this, _data).filter.$all = data.filter?.$all ?? parent?.filter?.$all;
-    __privateGet$4(this, _data).filter.$not = data.filter?.$not ?? parent?.filter?.$not;
-    __privateGet$4(this, _data).filter.$none = data.filter?.$none ?? parent?.filter?.$none;
-    __privateGet$4(this, _data).sort = data.sort ?? parent?.sort;
-    __privateGet$4(this, _data).columns = data.columns ?? parent?.columns ?? ["*"];
-    __privateGet$4(this, _data).page = data.page ?? parent?.page;
-    __privateGet$4(this, _data).cache = data.cache ?? parent?.cache;
+    const parent = cleanParent(data, rawParent);
+    __privateGet$3(this, _data).filter = data.filter ?? parent?.filter ?? {};
+    __privateGet$3(this, _data).filter.$any = data.filter?.$any ?? parent?.filter?.$any;
+    __privateGet$3(this, _data).filter.$all = data.filter?.$all ?? parent?.filter?.$all;
+    __privateGet$3(this, _data).filter.$not = data.filter?.$not ?? parent?.filter?.$not;
+    __privateGet$3(this, _data).filter.$none = data.filter?.$none ?? parent?.filter?.$none;
+    __privateGet$3(this, _data).sort = data.sort ?? parent?.sort;
+    __privateGet$3(this, _data).columns = data.columns ?? parent?.columns;
+    __privateGet$3(this, _data).consistency = data.consistency ?? parent?.consistency;
+    __privateGet$3(this, _data).pagination = data.pagination ?? parent?.pagination;
+    __privateGet$3(this, _data).fetchOptions = data.fetchOptions ?? parent?.fetchOptions;
     this.any = this.any.bind(this);
     this.all = this.all.bind(this);
     this.not = this.not.bind(this);
@@ -1002,117 +1826,262 @@ const _Query = class {
     Object.defineProperty(this, "repository", { enumerable: false });
   }
   getQueryOptions() {
-    return __privateGet$4(this, _data);
+    return __privateGet$3(this, _data);
   }
   key() {
-    const { columns = [], filter = {}, sort = [], page = {} } = __privateGet$4(this, _data);
-    const key = JSON.stringify({ columns, filter, sort, page });
+    const { columns = [], filter = {}, sort = [], pagination = {} } = __privateGet$3(this, _data);
+    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$4(this, _repository), __privateGet$4(this, _table$1), { filter: { $any } }, __privateGet$4(this, _data));
+    return new _Query(__privateGet$3(this, _repository), __privateGet$3(this, _table$1), { filter: { $any } }, __privateGet$3(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$4(this, _repository), __privateGet$4(this, _table$1), { filter: { $all } }, __privateGet$4(this, _data));
+    return new _Query(__privateGet$3(this, _repository), __privateGet$3(this, _table$1), { filter: { $all } }, __privateGet$3(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$4(this, _repository), __privateGet$4(this, _table$1), { filter: { $not } }, __privateGet$4(this, _data));
+    return new _Query(__privateGet$3(this, _repository), __privateGet$3(this, _table$1), { filter: { $not } }, __privateGet$3(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$4(this, _repository), __privateGet$4(this, _table$1), { filter: { $none } }, __privateGet$4(this, _data));
+    return new _Query(__privateGet$3(this, _repository), __privateGet$3(this, _table$1), { filter: { $none } }, __privateGet$3(this, _data));
   }
   filter(a, b) {
     if (arguments.length === 1) {
-      const constraints = Object.entries(a).map(([column, constraint]) => ({ [column]: constraint }));
-      const $all = compact([__privateGet$4(this, _data).filter?.$all].flat().concat(constraints));
-      return new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), { filter: { $all } }, __privateGet$4(this, _data));
+      const constraints = Object.entries(a ?? {}).map(([column, constraint]) => ({
+        [column]: __privateMethod$3(this, _cleanFilterConstraint, cleanFilterConstraint_fn).call(this, column, constraint)
+      }));
+      const $all = compact([__privateGet$3(this, _data).filter?.$all].flat().concat(constraints));
+      return new _Query(__privateGet$3(this, _repository), __privateGet$3(this, _table$1), { filter: { $all } }, __privateGet$3(this, _data));
     } else {
-      const $all = compact([__privateGet$4(this, _data).filter?.$all].flat().concat([{ [a]: b }]));
-      return new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), { filter: { $all } }, __privateGet$4(this, _data));
+      const constraints = isDefined(a) && isDefined(b) ? [{ [a]: __privateMethod$3(this, _cleanFilterConstraint, cleanFilterConstraint_fn).call(this, a, b) }] : void 0;
+      const $all = compact([__privateGet$3(this, _data).filter?.$all].flat().concat(constraints));
+      return new _Query(__privateGet$3(this, _repository), __privateGet$3(this, _table$1), { filter: { $all } }, __privateGet$3(this, _data));
     }
   }
-  sort(column, direction) {
-    const originalSort = [__privateGet$4(this, _data).sort ?? []].flat();
+  sort(column, direction = "asc") {
+    const originalSort = [__privateGet$3(this, _data).sort ?? []].flat();
     const sort = [...originalSort, { column, direction }];
-    return new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), { sort }, __privateGet$4(this, _data));
+    return new _Query(__privateGet$3(this, _repository), __privateGet$3(this, _table$1), { sort }, __privateGet$3(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$4(this, _repository), __privateGet$4(this, _table$1), { columns }, __privateGet$4(this, _data));
+    return new _Query(
+      __privateGet$3(this, _repository),
+      __privateGet$3(this, _table$1),
+      { columns },
+      __privateGet$3(this, _data)
+    );
   }
   getPaginated(options = {}) {
-    const query = new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), options, __privateGet$4(this, _data));
-    return __privateGet$4(this, _repository).query(query);
-  }
+    const query = new _Query(__privateGet$3(this, _repository), __privateGet$3(this, _table$1), options, __privateGet$3(this, _data));
+    return __privateGet$3(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(1)) {
+    for await (const [record] of this.getIterator({ batchSize: 1 })) {
       yield record;
     }
   }
-  async *getIterator(chunk, options = {}) {
-    let offset = 0;
-    let end = false;
-    while (!end) {
-      const { records, meta } = await this.getPaginated({ ...options, page: { size: chunk, offset } });
-      yield records;
-      offset += chunk;
-      end = !meta.page.more;
+  async *getIterator(options = {}) {
+    const { batchSize = 1 } = options;
+    let page = await this.getPaginated({ ...options, pagination: { size: batchSize, offset: 0 } });
+    let more = page.hasNextPage();
+    yield page.records;
+    while (more) {
+      page = await page.nextPage();
+      more = page.hasNextPage();
+      yield page.records;
     }
   }
   async getMany(options = {}) {
-    const { records } = await this.getPaginated(options);
-    return records;
+    const { pagination = {}, ...rest } = options;
+    const { size = PAGINATION_DEFAULT_SIZE, offset } = pagination;
+    const batchSize = size <= PAGINATION_MAX_SIZE ? size : PAGINATION_MAX_SIZE;
+    let page = await this.getPaginated({ ...rest, pagination: { size: batchSize, offset } });
+    const results = [...page.records];
+    while (page.hasNextPage() && results.length < size) {
+      page = await page.nextPage();
+      results.push(...page.records);
+    }
+    if (page.hasNextPage() && options.pagination?.size === void 0) {
+      console.trace("Calling getMany does not return all results. Paginate to get all results or call getAll.");
+    }
+    const array = new PageRecordArray(page, results.slice(0, size));
+    return array;
   }
-  async getAll(chunk = PAGINATION_MAX_SIZE, options = {}) {
+  async getAll(options = {}) {
+    const { batchSize = PAGINATION_MAX_SIZE, ...rest } = options;
     const results = [];
-    for await (const page of this.getIterator(chunk, options)) {
+    for await (const page of this.getIterator({ ...rest, batchSize })) {
       results.push(...page);
     }
-    return results;
+    return new RecordArray(results);
   }
   async getFirst(options = {}) {
-    const records = await this.getMany({ ...options, page: { size: 1 } });
-    return records[0] || null;
-  }
-  cache(ttl) {
-    return new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), { cache: ttl }, __privateGet$4(this, _data));
-  }
+    const records = await this.getMany({ ...options, pagination: { size: 1 } });
+    return records[0] ?? null;
+  }
+  async getFirstOrThrow(options = {}) {
+    const records = await this.getMany({ ...options, pagination: { size: 1 } });
+    if (records[0] === void 0)
+      throw new Error("No results found.");
+    return records[0];
+  }
+  async summarize(params = {}) {
+    const { summaries, summariesFilter, ...options } = params;
+    const query = new _Query(
+      __privateGet$3(this, _repository),
+      __privateGet$3(this, _table$1),
+      options,
+      __privateGet$3(this, _data)
+    );
+    return __privateGet$3(this, _repository).summarizeTable(query, summaries, summariesFilter);
+  }
+  /**
+   * Retrieve next page of records
+   *
+   * @returns A new page object.
+   */
   nextPage(size, offset) {
-    return this.firstPage(size, offset);
+    return this.startPage(size, offset);
   }
+  /**
+   * Retrieve previous page of records
+   *
+   * @returns A new page object
+   */
   previousPage(size, offset) {
-    return this.firstPage(size, offset);
-  }
-  firstPage(size, offset) {
-    return this.getPaginated({ page: { size, offset } });
-  }
-  lastPage(size, offset) {
-    return this.getPaginated({ page: { size, offset, before: "end" } });
-  }
+    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();
+_cleanFilterConstraint = new WeakSet();
+cleanFilterConstraint_fn = function(column, value) {
+  const columnType = __privateGet$3(this, _table$1).schema?.columns.find(({ name }) => name === column)?.type;
+  if (columnType === "multiple" && (isString(value) || isStringArray(value))) {
+    return { $includes: value };
+  }
+  if (columnType === "link" && isObject(value) && isString(value.id)) {
+    return value.id;
+  }
+  return value;
+};
+let Query = _Query;
+function cleanParent(data, parent) {
+  if (isCursorPaginationOptions(data.pagination)) {
+    return { ...parent, sort: void 0, filter: void 0 };
+  }
+  return parent;
+}
 
+const RecordColumnTypes = [
+  "bool",
+  "int",
+  "float",
+  "string",
+  "text",
+  "email",
+  "multiple",
+  "link",
+  "datetime",
+  "vector",
+  "file[]",
+  "file",
+  "json"
+];
 function isIdentifiable(x) {
   return isObject(x) && isString(x?.id);
 }
 function isXataRecord(x) {
-  return isIdentifiable(x) && typeof x?.xata === "object" && typeof x?.xata?.version === "number";
+  const record = x;
+  const metadata = record?.getMetadata();
+  return isIdentifiable(x) && isObject(metadata) && typeof metadata.version === "number";
+}
+
+function isValidExpandedColumn(column) {
+  return isObject(column) && isString(column.name);
+}
+function isValidSelectableColumns(columns) {
+  if (!Array.isArray(columns)) {
+    return false;
+  }
+  return columns.every((column) => {
+    if (typeof column === "string") {
+      return true;
+    }
+    if (typeof column === "object") {
+      return isValidExpandedColumn(column);
+    }
+    return false;
+  });
 }
 
 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;
@@ -1131,433 +2100,869 @@ function buildSortFilter(filter) {
   }
 }
 
-var __accessCheck$4 = (obj, member, msg) => {
+var __accessCheck$3 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
 };
-var __privateGet$3 = (obj, member, getter) => {
-  __accessCheck$4(obj, member, "read from private field");
+var __privateGet$2 = (obj, member, getter) => {
+  __accessCheck$3(obj, member, "read from private field");
   return getter ? getter.call(obj) : member.get(obj);
 };
-var __privateAdd$4 = (obj, member, value) => {
+var __privateAdd$3 = (obj, member, value) => {
   if (member.has(obj))
     throw TypeError("Cannot add the same private member more than once");
   member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 };
-var __privateSet$2 = (obj, member, value, setter) => {
-  __accessCheck$4(obj, member, "write to private field");
+var __privateSet$1 = (obj, member, value, setter) => {
+  __accessCheck$3(obj, member, "write to private field");
   setter ? setter.call(obj, value) : member.set(obj, value);
   return value;
 };
 var __privateMethod$2 = (obj, member, method) => {
-  __accessCheck$4(obj, member, "access private method");
+  __accessCheck$3(obj, member, "access private method");
   return method;
 };
-var _table, _links, _getFetchProps, _cache, _insertRecordWithoutId, insertRecordWithoutId_fn, _insertRecordWithId, insertRecordWithId_fn, _bulkInsertTableRecords, bulkInsertTableRecords_fn, _updateRecordWithID, updateRecordWithID_fn, _upsertRecordWithID, upsertRecordWithID_fn, _deleteRecord, deleteRecord_fn, _invalidateCache, invalidateCache_fn, _setCacheRecord, setCacheRecord_fn, _getCacheRecord, getCacheRecord_fn, _setCacheQuery, setCacheQuery_fn, _getCacheQuery, getCacheQuery_fn;
+var _table, _getFetchProps, _db, _schemaTables, _trace, _insertRecordWithoutId, insertRecordWithoutId_fn, _insertRecordWithId, insertRecordWithId_fn, _insertRecords, insertRecords_fn, _updateRecordWithID, updateRecordWithID_fn, _updateRecords, updateRecords_fn, _upsertRecordWithID, upsertRecordWithID_fn, _deleteRecord, deleteRecord_fn, _deleteRecords, deleteRecords_fn, _getSchemaTables, getSchemaTables_fn, _transformObjectToApi, transformObjectToApi_fn;
+const BULK_OPERATION_MAX_SIZE = 1e3;
 class Repository extends Query {
 }
 class RestRepository extends Query {
   constructor(options) {
-    super(null, options.table, {});
-    __privateAdd$4(this, _insertRecordWithoutId);
-    __privateAdd$4(this, _insertRecordWithId);
-    __privateAdd$4(this, _bulkInsertTableRecords);
-    __privateAdd$4(this, _updateRecordWithID);
-    __privateAdd$4(this, _upsertRecordWithID);
-    __privateAdd$4(this, _deleteRecord);
-    __privateAdd$4(this, _invalidateCache);
-    __privateAdd$4(this, _setCacheRecord);
-    __privateAdd$4(this, _getCacheRecord);
-    __privateAdd$4(this, _setCacheQuery);
-    __privateAdd$4(this, _getCacheQuery);
-    __privateAdd$4(this, _table, void 0);
-    __privateAdd$4(this, _links, void 0);
-    __privateAdd$4(this, _getFetchProps, void 0);
-    __privateAdd$4(this, _cache, void 0);
-    __privateSet$2(this, _table, options.table);
-    __privateSet$2(this, _links, options.links ?? {});
-    __privateSet$2(this, _getFetchProps, options.pluginOptions.getFetchProps);
-    this.db = options.db;
-    __privateSet$2(this, _cache, options.pluginOptions.cache);
-  }
-  async create(a, b) {
-    if (Array.isArray(a)) {
-      const records = await __privateMethod$2(this, _bulkInsertTableRecords, bulkInsertTableRecords_fn).call(this, a);
-      await Promise.all(records.map((record) => __privateMethod$2(this, _setCacheRecord, setCacheRecord_fn).call(this, record)));
-      return records;
-    }
-    if (isString(a) && isObject(b)) {
-      if (a === "")
-        throw new Error("The id can't be empty");
-      const record = await __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a, b);
-      await __privateMethod$2(this, _setCacheRecord, setCacheRecord_fn).call(this, record);
-      return record;
-    }
-    if (isObject(a) && isString(a.id)) {
-      if (a.id === "")
-        throw new Error("The id can't be empty");
-      const record = await __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a.id, { ...a, id: void 0 });
-      await __privateMethod$2(this, _setCacheRecord, setCacheRecord_fn).call(this, record);
-      return record;
-    }
-    if (isObject(a)) {
-      const record = await __privateMethod$2(this, _insertRecordWithoutId, insertRecordWithoutId_fn).call(this, a);
-      await __privateMethod$2(this, _setCacheRecord, setCacheRecord_fn).call(this, record);
-      return record;
-    }
-    throw new Error("Invalid arguments for create method");
-  }
-  async read(recordId) {
-    const cacheRecord = await __privateMethod$2(this, _getCacheRecord, getCacheRecord_fn).call(this, recordId);
-    if (cacheRecord)
-      return cacheRecord;
-    const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
-    try {
-      const response = await getRecord({
-        pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$3(this, _table), recordId },
-        ...fetchProps
+    super(
+      null,
+      { name: options.table, schema: options.schemaTables?.find((table) => table.name === options.table) },
+      {}
+    );
+    __privateAdd$3(this, _insertRecordWithoutId);
+    __privateAdd$3(this, _insertRecordWithId);
+    __privateAdd$3(this, _insertRecords);
+    __privateAdd$3(this, _updateRecordWithID);
+    __privateAdd$3(this, _updateRecords);
+    __privateAdd$3(this, _upsertRecordWithID);
+    __privateAdd$3(this, _deleteRecord);
+    __privateAdd$3(this, _deleteRecords);
+    __privateAdd$3(this, _getSchemaTables);
+    __privateAdd$3(this, _transformObjectToApi);
+    __privateAdd$3(this, _table, void 0);
+    __privateAdd$3(this, _getFetchProps, void 0);
+    __privateAdd$3(this, _db, void 0);
+    __privateAdd$3(this, _schemaTables, void 0);
+    __privateAdd$3(this, _trace, void 0);
+    __privateSet$1(this, _table, options.table);
+    __privateSet$1(this, _db, options.db);
+    __privateSet$1(this, _schemaTables, options.schemaTables);
+    __privateSet$1(this, _getFetchProps, () => ({ ...options.pluginOptions, sessionID: generateUUID() }));
+    const trace = options.pluginOptions.trace ?? defaultTrace;
+    __privateSet$1(this, _trace, async (name, fn, options2 = {}) => {
+      return trace(name, fn, {
+        ...options2,
+        [TraceAttributes.TABLE]: __privateGet$2(this, _table),
+        [TraceAttributes.KIND]: "sdk-operation",
+        [TraceAttributes.VERSION]: VERSION
       });
-      return initObject(this.db, __privateGet$3(this, _links), __privateGet$3(this, _table), response);
-    } catch (e) {
-      if (isObject(e) && e.status === 404) {
-        return null;
+    });
+  }
+  async create(a, b, c, d) {
+    return __privateGet$2(this, _trace).call(this, "create", async () => {
+      const ifVersion = parseIfVersion(b, c, d);
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        const ids = await __privateMethod$2(this, _insertRecords, insertRecords_fn).call(this, a, { ifVersion, createOnly: true });
+        const columns = isValidSelectableColumns(b) ? b : ["*"];
+        const result = await this.read(ids, columns);
+        return result;
+      }
+      if (isString(a) && isObject(b)) {
+        if (a === "")
+          throw new Error("The id can't be empty");
+        const columns = isValidSelectableColumns(c) ? c : void 0;
+        return await __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a, b, columns, { createOnly: true, ifVersion });
+      }
+      if (isObject(a) && isString(a.id)) {
+        if (a.id === "")
+          throw new Error("The id can't be empty");
+        const columns = isValidSelectableColumns(b) ? b : void 0;
+        return await __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a.id, { ...a, id: void 0 }, columns, { createOnly: true, ifVersion });
+      }
+      if (isObject(a)) {
+        const columns = isValidSelectableColumns(b) ? b : void 0;
+        return __privateMethod$2(this, _insertRecordWithoutId, insertRecordWithoutId_fn).call(this, a, columns);
+      }
+      throw new Error("Invalid arguments for create method");
+    });
+  }
+  async read(a, b) {
+    return __privateGet$2(this, _trace).call(this, "read", async () => {
+      const columns = isValidSelectableColumns(b) ? b : ["*"];
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        const ids = a.map((item) => extractId(item));
+        const finalObjects = await this.getAll({ filter: { id: { $any: compact(ids) } }, columns });
+        const dictionary = finalObjects.reduce((acc, object) => {
+          acc[object.id] = object;
+          return acc;
+        }, {});
+        return ids.map((id2) => dictionary[id2 ?? ""] ?? null);
+      }
+      const id = extractId(a);
+      if (id) {
+        try {
+          const response = await getRecord({
+            pathParams: {
+              workspace: "{workspaceId}",
+              dbBranchName: "{dbBranch}",
+              region: "{region}",
+              tableName: __privateGet$2(this, _table),
+              recordId: id
+            },
+            queryParams: { columns },
+            ...__privateGet$2(this, _getFetchProps).call(this)
+          });
+          const schemaTables = await __privateMethod$2(this, _getSchemaTables, getSchemaTables_fn).call(this);
+          return initObject(
+            __privateGet$2(this, _db),
+            schemaTables,
+            __privateGet$2(this, _table),
+            response,
+            columns
+          );
+        } catch (e) {
+          if (isObject(e) && e.status === 404) {
+            return null;
+          }
+          throw e;
+        }
+      }
+      return null;
+    });
+  }
+  async readOrThrow(a, b) {
+    return __privateGet$2(this, _trace).call(this, "readOrThrow", async () => {
+      const result = await this.read(a, b);
+      if (Array.isArray(result)) {
+        const missingIds = compact(
+          a.filter((_item, index) => result[index] === null).map((item) => extractId(item))
+        );
+        if (missingIds.length > 0) {
+          throw new Error(`Could not find records with ids: ${missingIds.join(", ")}`);
+        }
+        return result;
+      }
+      if (result === null) {
+        const id = extractId(a) ?? "unknown";
+        throw new Error(`Record with id ${id} not found`);
+      }
+      return result;
+    });
+  }
+  async update(a, b, c, d) {
+    return __privateGet$2(this, _trace).call(this, "update", async () => {
+      const ifVersion = parseIfVersion(b, c, d);
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        const existing = await this.read(a, ["id"]);
+        const updates = a.filter((_item, index) => existing[index] !== null);
+        await __privateMethod$2(this, _updateRecords, updateRecords_fn).call(this, updates, {
+          ifVersion,
+          upsert: false
+        });
+        const columns = isValidSelectableColumns(b) ? b : ["*"];
+        const result = await this.read(a, columns);
+        return result;
       }
-      throw e;
-    }
+      try {
+        if (isString(a) && isObject(b)) {
+          const columns = isValidSelectableColumns(c) ? c : void 0;
+          return await __privateMethod$2(this, _updateRecordWithID, updateRecordWithID_fn).call(this, a, b, columns, { ifVersion });
+        }
+        if (isObject(a) && isString(a.id)) {
+          const columns = isValidSelectableColumns(b) ? b : void 0;
+          return await __privateMethod$2(this, _updateRecordWithID, updateRecordWithID_fn).call(this, a.id, { ...a, id: void 0 }, columns, { ifVersion });
+        }
+      } catch (error) {
+        if (error.status === 422)
+          return null;
+        throw error;
+      }
+      throw new Error("Invalid arguments for update method");
+    });
   }
-  async update(a, b) {
-    if (Array.isArray(a)) {
-      if (a.length > 100) {
-        console.warn("Bulk update operation is not optimized in the Xata API yet, this request might be slow");
+  async updateOrThrow(a, b, c, d) {
+    return __privateGet$2(this, _trace).call(this, "updateOrThrow", async () => {
+      const result = await this.update(a, b, c, d);
+      if (Array.isArray(result)) {
+        const missingIds = compact(
+          a.filter((_item, index) => result[index] === null).map((item) => extractId(item))
+        );
+        if (missingIds.length > 0) {
+          throw new Error(`Could not find records with ids: ${missingIds.join(", ")}`);
+        }
+        return result;
       }
-      return Promise.all(a.map((object) => this.update(object)));
-    }
-    if (isString(a) && isObject(b)) {
-      await __privateMethod$2(this, _invalidateCache, invalidateCache_fn).call(this, a);
-      const record = await __privateMethod$2(this, _updateRecordWithID, updateRecordWithID_fn).call(this, a, b);
-      await __privateMethod$2(this, _setCacheRecord, setCacheRecord_fn).call(this, record);
-      return record;
-    }
-    if (isObject(a) && isString(a.id)) {
-      await __privateMethod$2(this, _invalidateCache, invalidateCache_fn).call(this, a.id);
-      const record = await __privateMethod$2(this, _updateRecordWithID, updateRecordWithID_fn).call(this, a.id, { ...a, id: void 0 });
-      await __privateMethod$2(this, _setCacheRecord, setCacheRecord_fn).call(this, record);
-      return record;
-    }
-    throw new Error("Invalid arguments for update method");
+      if (result === null) {
+        const id = extractId(a) ?? "unknown";
+        throw new Error(`Record with id ${id} not found`);
+      }
+      return result;
+    });
   }
-  async createOrUpdate(a, b) {
-    if (Array.isArray(a)) {
-      if (a.length > 100) {
-        console.warn("Bulk update operation is not optimized in the Xata API yet, this request might be slow");
+  async createOrUpdate(a, b, c, d) {
+    return __privateGet$2(this, _trace).call(this, "createOrUpdate", async () => {
+      const ifVersion = parseIfVersion(b, c, d);
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        await __privateMethod$2(this, _updateRecords, updateRecords_fn).call(this, a, {
+          ifVersion,
+          upsert: true
+        });
+        const columns = isValidSelectableColumns(b) ? b : ["*"];
+        const result = await this.read(a, columns);
+        return result;
       }
-      return Promise.all(a.map((object) => this.createOrUpdate(object)));
-    }
-    if (isString(a) && isObject(b)) {
-      await __privateMethod$2(this, _invalidateCache, invalidateCache_fn).call(this, a);
-      const record = await __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a, b);
-      await __privateMethod$2(this, _setCacheRecord, setCacheRecord_fn).call(this, record);
-      return record;
-    }
-    if (isObject(a) && isString(a.id)) {
-      await __privateMethod$2(this, _invalidateCache, invalidateCache_fn).call(this, a.id);
-      const record = await __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a.id, { ...a, id: void 0 });
-      await __privateMethod$2(this, _setCacheRecord, setCacheRecord_fn).call(this, record);
-      return record;
-    }
-    throw new Error("Invalid arguments for createOrUpdate method");
+      if (isString(a) && isObject(b)) {
+        if (a === "")
+          throw new Error("The id can't be empty");
+        const columns = isValidSelectableColumns(c) ? c : void 0;
+        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 = isValidSelectableColumns(c) ? c : void 0;
+        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");
+    });
   }
-  async delete(a) {
-    if (Array.isArray(a)) {
-      if (a.length > 100) {
-        console.warn("Bulk delete operation is not optimized in the Xata API yet, this request might be slow");
+  async createOrReplace(a, b, c, d) {
+    return __privateGet$2(this, _trace).call(this, "createOrReplace", async () => {
+      const ifVersion = parseIfVersion(b, c, d);
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        const ids = await __privateMethod$2(this, _insertRecords, insertRecords_fn).call(this, a, { ifVersion, createOnly: false });
+        const columns = isValidSelectableColumns(b) ? b : ["*"];
+        const result = await this.read(ids, columns);
+        return result;
       }
-      await Promise.all(a.map((id) => this.delete(id)));
-      return;
-    }
-    if (isString(a)) {
-      await __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a);
-      await __privateMethod$2(this, _invalidateCache, invalidateCache_fn).call(this, a);
-      return;
-    }
-    if (isObject(a) && isString(a.id)) {
-      await __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a.id);
-      await __privateMethod$2(this, _invalidateCache, invalidateCache_fn).call(this, a.id);
-      return;
-    }
-    throw new Error("Invalid arguments for delete method");
+      if (isString(a) && isObject(b)) {
+        if (a === "")
+          throw new Error("The id can't be empty");
+        const columns = isValidSelectableColumns(c) ? c : void 0;
+        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 = isValidSelectableColumns(c) ? c : void 0;
+        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");
+    });
+  }
+  async delete(a, b) {
+    return __privateGet$2(this, _trace).call(this, "delete", async () => {
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        const ids = a.map((o) => {
+          if (isString(o))
+            return o;
+          if (isString(o.id))
+            return o.id;
+          throw new Error("Invalid arguments for delete method");
+        });
+        const columns = isValidSelectableColumns(b) ? b : ["*"];
+        const result = await this.read(a, columns);
+        await __privateMethod$2(this, _deleteRecords, deleteRecords_fn).call(this, ids);
+        return result;
+      }
+      if (isString(a)) {
+        return __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a, b);
+      }
+      if (isObject(a) && isString(a.id)) {
+        return __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a.id, b);
+      }
+      throw new Error("Invalid arguments for delete method");
+    });
+  }
+  async deleteOrThrow(a, b) {
+    return __privateGet$2(this, _trace).call(this, "deleteOrThrow", async () => {
+      const result = await this.delete(a, b);
+      if (Array.isArray(result)) {
+        const missingIds = compact(
+          a.filter((_item, index) => result[index] === null).map((item) => extractId(item))
+        );
+        if (missingIds.length > 0) {
+          throw new Error(`Could not find records with ids: ${missingIds.join(", ")}`);
+        }
+        return result;
+      } else if (result === null) {
+        const id = extractId(a) ?? "unknown";
+        throw new Error(`Record with id ${id} not found`);
+      }
+      return result;
+    });
   }
   async search(query, options = {}) {
-    const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
-    const { records } = await searchBranch({
-      pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}" },
-      body: { tables: [__privateGet$3(this, _table)], query, fuzziness: options.fuzziness },
-      ...fetchProps
+    return __privateGet$2(this, _trace).call(this, "search", async () => {
+      const { records, totalCount } = await searchTable({
+        pathParams: {
+          workspace: "{workspaceId}",
+          dbBranchName: "{dbBranch}",
+          region: "{region}",
+          tableName: __privateGet$2(this, _table)
+        },
+        body: {
+          query,
+          fuzziness: options.fuzziness,
+          prefix: options.prefix,
+          highlight: options.highlight,
+          filter: options.filter,
+          boosters: options.boosters,
+          page: options.page,
+          target: options.target
+        },
+        ...__privateGet$2(this, _getFetchProps).call(this)
+      });
+      const schemaTables = await __privateMethod$2(this, _getSchemaTables, getSchemaTables_fn).call(this);
+      return {
+        records: records.map((item) => initObject(__privateGet$2(this, _db), schemaTables, __privateGet$2(this, _table), item, ["*"])),
+        totalCount
+      };
+    });
+  }
+  async vectorSearch(column, query, options) {
+    return __privateGet$2(this, _trace).call(this, "vectorSearch", async () => {
+      const { records, totalCount } = await vectorSearchTable({
+        pathParams: {
+          workspace: "{workspaceId}",
+          dbBranchName: "{dbBranch}",
+          region: "{region}",
+          tableName: __privateGet$2(this, _table)
+        },
+        body: {
+          column,
+          queryVector: query,
+          similarityFunction: options?.similarityFunction,
+          size: options?.size,
+          filter: options?.filter
+        },
+        ...__privateGet$2(this, _getFetchProps).call(this)
+      });
+      const schemaTables = await __privateMethod$2(this, _getSchemaTables, getSchemaTables_fn).call(this);
+      return {
+        records: records.map((item) => initObject(__privateGet$2(this, _db), schemaTables, __privateGet$2(this, _table), item, ["*"])),
+        totalCount
+      };
+    });
+  }
+  async aggregate(aggs, filter) {
+    return __privateGet$2(this, _trace).call(this, "aggregate", async () => {
+      const result = await aggregateTable({
+        pathParams: {
+          workspace: "{workspaceId}",
+          dbBranchName: "{dbBranch}",
+          region: "{region}",
+          tableName: __privateGet$2(this, _table)
+        },
+        body: { aggs, filter },
+        ...__privateGet$2(this, _getFetchProps).call(this)
+      });
+      return result;
     });
-    return records.map((item) => initObject(this.db, __privateGet$3(this, _links), __privateGet$3(this, _table), item));
   }
   async query(query) {
-    const cacheQuery = await __privateMethod$2(this, _getCacheQuery, getCacheQuery_fn).call(this, query);
-    if (cacheQuery)
-      return new Page(query, cacheQuery.meta, cacheQuery.records);
-    const data = query.getQueryOptions();
-    const body = {
-      filter: Object.values(data.filter ?? {}).some(Boolean) ? data.filter : void 0,
-      sort: data.sort ? buildSortFilter(data.sort) : void 0,
-      page: data.page,
-      columns: data.columns
-    };
-    const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
-    const { meta, records: objects } = await queryTable({
-      pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$3(this, _table) },
-      body,
-      ...fetchProps
+    return __privateGet$2(this, _trace).call(this, "query", async () => {
+      const data = query.getQueryOptions();
+      const { meta, records: objects } = await queryTable({
+        pathParams: {
+          workspace: "{workspaceId}",
+          dbBranchName: "{dbBranch}",
+          region: "{region}",
+          tableName: __privateGet$2(this, _table)
+        },
+        body: {
+          filter: cleanFilter(data.filter),
+          sort: data.sort !== void 0 ? buildSortFilter(data.sort) : void 0,
+          page: data.pagination,
+          columns: data.columns ?? ["*"],
+          consistency: data.consistency
+        },
+        fetchOptions: data.fetchOptions,
+        ...__privateGet$2(this, _getFetchProps).call(this)
+      });
+      const schemaTables = await __privateMethod$2(this, _getSchemaTables, getSchemaTables_fn).call(this);
+      const records = objects.map(
+        (record) => initObject(
+          __privateGet$2(this, _db),
+          schemaTables,
+          __privateGet$2(this, _table),
+          record,
+          data.columns ?? ["*"]
+        )
+      );
+      return new Page(query, meta, records);
+    });
+  }
+  async summarizeTable(query, summaries, summariesFilter) {
+    return __privateGet$2(this, _trace).call(this, "summarize", async () => {
+      const data = query.getQueryOptions();
+      const result = await summarizeTable({
+        pathParams: {
+          workspace: "{workspaceId}",
+          dbBranchName: "{dbBranch}",
+          region: "{region}",
+          tableName: __privateGet$2(this, _table)
+        },
+        body: {
+          filter: cleanFilter(data.filter),
+          sort: data.sort !== void 0 ? buildSortFilter(data.sort) : void 0,
+          columns: data.columns,
+          consistency: data.consistency,
+          page: data.pagination?.size !== void 0 ? { size: data.pagination?.size } : void 0,
+          summaries,
+          summariesFilter
+        },
+        ...__privateGet$2(this, _getFetchProps).call(this)
+      });
+      const schemaTables = await __privateMethod$2(this, _getSchemaTables, getSchemaTables_fn).call(this);
+      return {
+        ...result,
+        summaries: result.summaries.map(
+          (summary) => initObject(__privateGet$2(this, _db), schemaTables, __privateGet$2(this, _table), summary, data.columns ?? [])
+        )
+      };
     });
-    const records = objects.map((record) => initObject(this.db, __privateGet$3(this, _links), __privateGet$3(this, _table), record));
-    await __privateMethod$2(this, _setCacheQuery, setCacheQuery_fn).call(this, query, meta, records);
-    return new Page(query, meta, records);
+  }
+  ask(question, options) {
+    const questionParam = options?.sessionId ? { message: question } : { question };
+    const params = {
+      pathParams: {
+        workspace: "{workspaceId}",
+        dbBranchName: "{dbBranch}",
+        region: "{region}",
+        tableName: __privateGet$2(this, _table),
+        sessionId: options?.sessionId
+      },
+      body: {
+        ...questionParam,
+        rules: options?.rules,
+        searchType: options?.searchType,
+        search: options?.searchType === "keyword" ? options?.search : void 0,
+        vectorSearch: options?.searchType === "vector" ? options?.vectorSearch : void 0
+      },
+      ...__privateGet$2(this, _getFetchProps).call(this)
+    };
+    if (options?.onMessage) {
+      fetchSSERequest({
+        endpoint: "dataPlane",
+        url: "/db/{dbBranchName}/tables/{tableName}/ask/{sessionId}",
+        method: "POST",
+        onMessage: (message) => {
+          options.onMessage?.({ answer: message.text, records: message.records });
+        },
+        ...params
+      });
+    } else {
+      return askTableSession(params);
+    }
   }
 }
 _table = new WeakMap();
-_links = new WeakMap();
 _getFetchProps = new WeakMap();
-_cache = new WeakMap();
+_db = new WeakMap();
+_schemaTables = new WeakMap();
+_trace = new WeakMap();
 _insertRecordWithoutId = new WeakSet();
-insertRecordWithoutId_fn = async function(object) {
-  const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
-  const record = transformObjectLinks(object);
+insertRecordWithoutId_fn = async function(object, columns = ["*"]) {
+  const record = await __privateMethod$2(this, _transformObjectToApi, transformObjectToApi_fn).call(this, object);
   const response = await insertRecord({
     pathParams: {
       workspace: "{workspaceId}",
       dbBranchName: "{dbBranch}",
-      tableName: __privateGet$3(this, _table)
+      region: "{region}",
+      tableName: __privateGet$2(this, _table)
     },
+    queryParams: { columns },
     body: record,
-    ...fetchProps
+    ...__privateGet$2(this, _getFetchProps).call(this)
   });
-  const finalObject = await this.read(response.id);
-  if (!finalObject) {
-    throw new Error("The server failed to save the record");
-  }
-  return finalObject;
+  const schemaTables = await __privateMethod$2(this, _getSchemaTables, getSchemaTables_fn).call(this);
+  return initObject(__privateGet$2(this, _db), schemaTables, __privateGet$2(this, _table), response, columns);
 };
 _insertRecordWithId = new WeakSet();
-insertRecordWithId_fn = async function(recordId, object) {
-  const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
-  const record = transformObjectLinks(object);
+insertRecordWithId_fn = async function(recordId, object, columns = ["*"], { createOnly, ifVersion }) {
+  if (!recordId)
+    return null;
+  const record = await __privateMethod$2(this, _transformObjectToApi, transformObjectToApi_fn).call(this, object);
   const response = await insertRecordWithID({
     pathParams: {
       workspace: "{workspaceId}",
       dbBranchName: "{dbBranch}",
-      tableName: __privateGet$3(this, _table),
+      region: "{region}",
+      tableName: __privateGet$2(this, _table),
       recordId
     },
     body: record,
-    queryParams: { createOnly: true },
-    ...fetchProps
+    queryParams: { createOnly, columns, ifVersion },
+    ...__privateGet$2(this, _getFetchProps).call(this)
   });
-  const finalObject = await this.read(response.id);
-  if (!finalObject) {
-    throw new Error("The server failed to save the record");
-  }
-  return finalObject;
+  const schemaTables = await __privateMethod$2(this, _getSchemaTables, getSchemaTables_fn).call(this);
+  return initObject(__privateGet$2(this, _db), schemaTables, __privateGet$2(this, _table), response, columns);
 };
-_bulkInsertTableRecords = new WeakSet();
-bulkInsertTableRecords_fn = async function(objects) {
-  const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
-  const records = objects.map((object) => transformObjectLinks(object));
-  const response = await bulkInsertTableRecords({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$3(this, _table) },
-    body: { records },
-    ...fetchProps
+_insertRecords = new WeakSet();
+insertRecords_fn = async function(objects, { createOnly, ifVersion }) {
+  const operations = await promiseMap(objects, async (object) => {
+    const record = await __privateMethod$2(this, _transformObjectToApi, transformObjectToApi_fn).call(this, object);
+    return { insert: { table: __privateGet$2(this, _table), record, createOnly, ifVersion } };
   });
-  const finalObjects = await this.any(...response.recordIDs.map((id) => this.filter("id", id))).getAll();
-  if (finalObjects.length !== objects.length) {
-    throw new Error("The server failed to save some records");
+  const chunkedOperations = chunk(operations, BULK_OPERATION_MAX_SIZE);
+  const ids = [];
+  for (const operations2 of chunkedOperations) {
+    const { results } = await branchTransaction({
+      pathParams: {
+        workspace: "{workspaceId}",
+        dbBranchName: "{dbBranch}",
+        region: "{region}"
+      },
+      body: { operations: operations2 },
+      ...__privateGet$2(this, _getFetchProps).call(this)
+    });
+    for (const result of results) {
+      if (result.operation === "insert") {
+        ids.push(result.id);
+      } else {
+        ids.push(null);
+      }
+    }
   }
-  return finalObjects;
+  return ids;
 };
 _updateRecordWithID = new WeakSet();
-updateRecordWithID_fn = async function(recordId, object) {
-  const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
-  const record = transformObjectLinks(object);
-  const response = await updateRecordWithID({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$3(this, _table), recordId },
-    body: record,
-    ...fetchProps
+updateRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVersion }) {
+  if (!recordId)
+    return null;
+  const { id: _id, ...record } = await __privateMethod$2(this, _transformObjectToApi, transformObjectToApi_fn).call(this, object);
+  try {
+    const response = await updateRecordWithID({
+      pathParams: {
+        workspace: "{workspaceId}",
+        dbBranchName: "{dbBranch}",
+        region: "{region}",
+        tableName: __privateGet$2(this, _table),
+        recordId
+      },
+      queryParams: { columns, ifVersion },
+      body: record,
+      ...__privateGet$2(this, _getFetchProps).call(this)
+    });
+    const schemaTables = await __privateMethod$2(this, _getSchemaTables, getSchemaTables_fn).call(this);
+    return initObject(__privateGet$2(this, _db), schemaTables, __privateGet$2(this, _table), response, columns);
+  } catch (e) {
+    if (isObject(e) && e.status === 404) {
+      return null;
+    }
+    throw e;
+  }
+};
+_updateRecords = new WeakSet();
+updateRecords_fn = async function(objects, { ifVersion, upsert }) {
+  const operations = await promiseMap(objects, async ({ id, ...object }) => {
+    const fields = await __privateMethod$2(this, _transformObjectToApi, transformObjectToApi_fn).call(this, object);
+    return { update: { table: __privateGet$2(this, _table), id, ifVersion, upsert, fields } };
   });
-  const item = await this.read(response.id);
-  if (!item)
-    throw new Error("The server failed to save the record");
-  return item;
+  const chunkedOperations = chunk(operations, BULK_OPERATION_MAX_SIZE);
+  const ids = [];
+  for (const operations2 of chunkedOperations) {
+    const { results } = await branchTransaction({
+      pathParams: {
+        workspace: "{workspaceId}",
+        dbBranchName: "{dbBranch}",
+        region: "{region}"
+      },
+      body: { operations: operations2 },
+      ...__privateGet$2(this, _getFetchProps).call(this)
+    });
+    for (const result of results) {
+      if (result.operation === "update") {
+        ids.push(result.id);
+      } else {
+        ids.push(null);
+      }
+    }
+  }
+  return ids;
 };
 _upsertRecordWithID = new WeakSet();
-upsertRecordWithID_fn = async function(recordId, object) {
-  const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
+upsertRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVersion }) {
+  if (!recordId)
+    return null;
   const response = await upsertRecordWithID({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$3(this, _table), recordId },
+    pathParams: {
+      workspace: "{workspaceId}",
+      dbBranchName: "{dbBranch}",
+      region: "{region}",
+      tableName: __privateGet$2(this, _table),
+      recordId
+    },
+    queryParams: { columns, ifVersion },
     body: object,
-    ...fetchProps
+    ...__privateGet$2(this, _getFetchProps).call(this)
   });
-  const item = await this.read(response.id);
-  if (!item)
-    throw new Error("The server failed to save the record");
-  return item;
+  const schemaTables = await __privateMethod$2(this, _getSchemaTables, getSchemaTables_fn).call(this);
+  return initObject(__privateGet$2(this, _db), schemaTables, __privateGet$2(this, _table), response, columns);
 };
 _deleteRecord = new WeakSet();
-deleteRecord_fn = async function(recordId) {
-  const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
-  await deleteRecord({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$3(this, _table), recordId },
-    ...fetchProps
-  });
-};
-_invalidateCache = new WeakSet();
-invalidateCache_fn = async function(recordId) {
-  await __privateGet$3(this, _cache).delete(`rec_${__privateGet$3(this, _table)}:${recordId}`);
-  const cacheItems = await __privateGet$3(this, _cache).getAll();
-  const queries = Object.entries(cacheItems).filter(([key]) => key.startsWith("query_"));
-  for (const [key, value] of queries) {
-    const ids = getIds(value);
-    if (ids.includes(recordId))
-      await __privateGet$3(this, _cache).delete(key);
-  }
-};
-_setCacheRecord = new WeakSet();
-setCacheRecord_fn = async function(record) {
-  if (!__privateGet$3(this, _cache).cacheRecords)
-    return;
-  await __privateGet$3(this, _cache).set(`rec_${__privateGet$3(this, _table)}:${record.id}`, record);
-};
-_getCacheRecord = new WeakSet();
-getCacheRecord_fn = async function(recordId) {
-  if (!__privateGet$3(this, _cache).cacheRecords)
+deleteRecord_fn = async function(recordId, columns = ["*"]) {
+  if (!recordId)
     return null;
-  return __privateGet$3(this, _cache).get(`rec_${__privateGet$3(this, _table)}:${recordId}`);
+  try {
+    const response = await deleteRecord({
+      pathParams: {
+        workspace: "{workspaceId}",
+        dbBranchName: "{dbBranch}",
+        region: "{region}",
+        tableName: __privateGet$2(this, _table),
+        recordId
+      },
+      queryParams: { columns },
+      ...__privateGet$2(this, _getFetchProps).call(this)
+    });
+    const schemaTables = await __privateMethod$2(this, _getSchemaTables, getSchemaTables_fn).call(this);
+    return initObject(__privateGet$2(this, _db), schemaTables, __privateGet$2(this, _table), response, columns);
+  } catch (e) {
+    if (isObject(e) && e.status === 404) {
+      return null;
+    }
+    throw e;
+  }
 };
-_setCacheQuery = new WeakSet();
-setCacheQuery_fn = async function(query, meta, records) {
-  await __privateGet$3(this, _cache).set(`query_${__privateGet$3(this, _table)}:${query.key()}`, { date: new Date(), meta, records });
+_deleteRecords = new WeakSet();
+deleteRecords_fn = async function(recordIds) {
+  const chunkedOperations = chunk(
+    compact(recordIds).map((id) => ({ delete: { table: __privateGet$2(this, _table), id } })),
+    BULK_OPERATION_MAX_SIZE
+  );
+  for (const operations of chunkedOperations) {
+    await branchTransaction({
+      pathParams: {
+        workspace: "{workspaceId}",
+        dbBranchName: "{dbBranch}",
+        region: "{region}"
+      },
+      body: { operations },
+      ...__privateGet$2(this, _getFetchProps).call(this)
+    });
+  }
 };
-_getCacheQuery = new WeakSet();
-getCacheQuery_fn = async function(query) {
-  const key = `query_${__privateGet$3(this, _table)}:${query.key()}`;
-  const result = await __privateGet$3(this, _cache).get(key);
-  if (!result)
-    return null;
-  const { cache: ttl = __privateGet$3(this, _cache).defaultQueryTTL } = query.getQueryOptions();
-  if (!ttl || ttl < 0)
-    return result;
-  const hasExpired = result.date.getTime() + ttl < Date.now();
-  return hasExpired ? null : result;
+_getSchemaTables = new WeakSet();
+getSchemaTables_fn = async function() {
+  if (__privateGet$2(this, _schemaTables))
+    return __privateGet$2(this, _schemaTables);
+  const { schema } = await getBranchDetails({
+    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", region: "{region}" },
+    ...__privateGet$2(this, _getFetchProps).call(this)
+  });
+  __privateSet$1(this, _schemaTables, schema.tables);
+  return schema.tables;
 };
-const transformObjectLinks = (object) => {
-  return Object.entries(object).reduce((acc, [key, value]) => {
+_transformObjectToApi = new WeakSet();
+transformObjectToApi_fn = async function(object) {
+  const schemaTables = await __privateMethod$2(this, _getSchemaTables, getSchemaTables_fn).call(this);
+  const schema = schemaTables.find((table) => table.name === __privateGet$2(this, _table));
+  if (!schema)
+    throw new Error(`Table ${__privateGet$2(this, _table)} not found in schema`);
+  const result = {};
+  for (const [key, value] of Object.entries(object)) {
     if (key === "xata")
-      return acc;
-    return { ...acc, [key]: isIdentifiable(value) ? value.id : value };
-  }, {});
+      continue;
+    const type = schema.columns.find((column) => column.name === key)?.type;
+    switch (type) {
+      case "link": {
+        result[key] = isIdentifiable(value) ? value.id : value;
+        break;
+      }
+      case "datetime": {
+        result[key] = value instanceof Date ? value.toISOString() : value;
+        break;
+      }
+      case `file`:
+        result[key] = await parseInputFileEntry(value);
+        break;
+      case "file[]":
+        result[key] = await promiseMap(value, (item) => parseInputFileEntry(item));
+        break;
+      case "json":
+        result[key] = stringifyJson(value);
+        break;
+      default:
+        result[key] = value;
+    }
+  }
+  return result;
 };
-const initObject = (db, links, table, object) => {
-  const result = {};
-  Object.assign(result, object);
-  const tableLinks = links[table] || [];
-  for (const link of tableLinks) {
-    const [field, linkTable] = link;
-    const value = result[field];
-    if (value && isObject(value)) {
-      result[field] = initObject(db, links, linkTable, value);
+const initObject = (db, schemaTables, table, object, selectedColumns) => {
+  const data = {};
+  const { xata, ...rest } = object ?? {};
+  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 = 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 {
+          data[column.name] = date;
+        }
+        break;
+      }
+      case "link": {
+        const linkTable = column.link?.table;
+        if (!linkTable) {
+          console.error(`Failed to parse link for field ${column.name}`);
+        } else if (isObject(value)) {
+          const selectedLinkColumns = selectedColumns.reduce((acc, item) => {
+            if (item === column.name) {
+              return [...acc, "*"];
+            }
+            if (isString(item) && item.startsWith(`${column.name}.`)) {
+              const [, ...path] = item.split(".");
+              return [...acc, path.join(".")];
+            }
+            return acc;
+          }, []);
+          data[column.name] = initObject(
+            db,
+            schemaTables,
+            linkTable,
+            value,
+            selectedLinkColumns
+          );
+        } else {
+          data[column.name] = null;
+        }
+        break;
+      }
+      case "file":
+        data[column.name] = isDefined(value) ? new XataFile(value) : null;
+        break;
+      case "file[]":
+        data[column.name] = value?.map((item) => new XataFile(item)) ?? null;
+        break;
+      case "json":
+        data[column.name] = parseJson(value);
+        break;
+      default:
+        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() {
-    return db[table].read(result["id"]);
+  const record = { ...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);
+  };
+  record.update = function(data2, b, c) {
+    const columns2 = isValidSelectableColumns(b) ? b : ["*"];
+    const ifVersion = parseIfVersion(b, c);
+    return db[table].update(record["id"], data2, columns2, { ifVersion });
   };
-  result.update = function(data) {
-    return db[table].update(result["id"], data);
+  record.replace = function(data2, b, c) {
+    const columns2 = isValidSelectableColumns(b) ? b : ["*"];
+    const ifVersion = parseIfVersion(b, c);
+    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"]);
   };
-  for (const prop of ["read", "update", "delete"]) {
-    Object.defineProperty(result, prop, { enumerable: false });
+  if (metadata !== void 0) {
+    record.xata = Object.freeze(metadata);
   }
-  Object.freeze(result);
-  return result;
-};
-function getIds(value) {
-  if (Array.isArray(value)) {
-    return value.map((item) => getIds(item)).flat();
+  record.getMetadata = function() {
+    return record.xata;
+  };
+  record.toSerializable = function() {
+    return JSON.parse(JSON.stringify(record));
+  };
+  record.toString = function() {
+    return JSON.stringify(record);
+  };
+  for (const prop of ["read", "update", "replace", "delete", "getMetadata", "toSerializable", "toString"]) {
+    Object.defineProperty(record, prop, { enumerable: false });
   }
-  if (!isObject(value))
-    return [];
-  const nestedIds = Object.values(value).map((item) => getIds(item)).flat();
-  return isString(value.id) ? [value.id, ...nestedIds] : nestedIds;
-}
-
-var __accessCheck$3 = (obj, member, msg) => {
-  if (!member.has(obj))
-    throw TypeError("Cannot " + msg);
-};
-var __privateGet$2 = (obj, member, getter) => {
-  __accessCheck$3(obj, member, "read from private field");
-  return getter ? getter.call(obj) : member.get(obj);
-};
-var __privateAdd$3 = (obj, member, value) => {
-  if (member.has(obj))
-    throw TypeError("Cannot add the same private member more than once");
-  member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
-};
-var __privateSet$1 = (obj, member, value, setter) => {
-  __accessCheck$3(obj, member, "write to private field");
-  setter ? setter.call(obj, value) : member.set(obj, value);
-  return value;
+  Object.freeze(record);
+  return record;
 };
-var _map;
-class SimpleCache {
-  constructor(options = {}) {
-    __privateAdd$3(this, _map, void 0);
-    __privateSet$1(this, _map, /* @__PURE__ */ new Map());
-    this.capacity = options.max ?? 500;
-    this.cacheRecords = options.cacheRecords ?? true;
-    this.defaultQueryTTL = options.defaultQueryTTL ?? 60 * 1e3;
-  }
-  async getAll() {
-    return Object.fromEntries(__privateGet$2(this, _map));
-  }
-  async get(key) {
-    return __privateGet$2(this, _map).get(key) ?? null;
-  }
-  async set(key, value) {
-    await this.delete(key);
-    __privateGet$2(this, _map).set(key, value);
-    if (__privateGet$2(this, _map).size > this.capacity) {
-      const leastRecentlyUsed = __privateGet$2(this, _map).keys().next().value;
-      await this.delete(leastRecentlyUsed);
+function extractId(value) {
+  if (isString(value))
+    return value;
+  if (isObject(value) && isString(value.id))
+    return value.id;
+  return void 0;
+}
+function isValidColumn(columns, column) {
+  if (columns.includes("*"))
+    return true;
+  return columns.filter((item) => isString(item) && item.startsWith(column.name)).length > 0;
+}
+function parseIfVersion(...args) {
+  for (const arg of args) {
+    if (isObject(arg) && isNumber(arg.ifVersion)) {
+      return arg.ifVersion;
     }
   }
-  async delete(key) {
-    __privateGet$2(this, _map).delete(key);
-  }
-  async clear() {
-    return __privateGet$2(this, _map).clear();
-  }
+  return void 0;
 }
-_map = new WeakMap();
 
-const gt = (value) => ({ $gt: value });
-const ge = (value) => ({ $ge: value });
-const gte = (value) => ({ $ge: value });
-const lt = (value) => ({ $lt: value });
-const lte = (value) => ({ $le: value });
-const le = (value) => ({ $le: value });
+const greaterThan = (value) => ({ $gt: value });
+const gt = greaterThan;
+const greaterThanEquals = (value) => ({ $ge: value });
+const greaterEquals = greaterThanEquals;
+const gte = greaterThanEquals;
+const ge = greaterThanEquals;
+const lessThan = (value) => ({ $lt: value });
+const lt = lessThan;
+const lessThanEquals = (value) => ({ $le: value });
+const lessEquals = lessThanEquals;
+const lte = lessThanEquals;
+const le = lessThanEquals;
 const exists = (column) => ({ $exists: column });
 const notExists = (column) => ({ $notExists: column });
 const startsWith = (value) => ({ $startsWith: value });
 const endsWith = (value) => ({ $endsWith: value });
 const pattern = (value) => ({ $pattern: value });
+const iPattern = (value) => ({ $iPattern: value });
 const is = (value) => ({ $is: value });
+const equals = is;
 const isNot = (value) => ({ $isNot: value });
 const contains = (value) => ({ $contains: value });
+const iContains = (value) => ({ $iContains: value });
 const includes = (value) => ({ $includes: value });
 const includesAll = (value) => ({ $includesAll: value });
 const includesNone = (value) => ({ $includesNone: value });
@@ -1578,32 +2983,107 @@ var __privateAdd$2 = (obj, member, value) => {
 };
 var _tables;
 class SchemaPlugin extends XataPlugin {
-  constructor(links, tableNames) {
+  constructor() {
     super();
-    this.links = links;
-    this.tableNames = tableNames;
     __privateAdd$2(this, _tables, {});
   }
   build(pluginOptions) {
-    const links = this.links;
-    const db = new Proxy({}, {
-      get: (_target, table) => {
-        if (!isString(table))
-          throw new Error("Invalid table name");
-        if (!__privateGet$1(this, _tables)[table]) {
-          __privateGet$1(this, _tables)[table] = new RestRepository({ db, pluginOptions, table, links });
+    const db = new Proxy(
+      {},
+      {
+        get: (_target, table) => {
+          if (!isString(table))
+            throw new Error("Invalid table name");
+          if (__privateGet$1(this, _tables)[table] === void 0) {
+            __privateGet$1(this, _tables)[table] = new RestRepository({ db, pluginOptions, table, schemaTables: pluginOptions.tables });
+          }
+          return __privateGet$1(this, _tables)[table];
         }
-        return __privateGet$1(this, _tables)[table];
       }
-    });
-    for (const table of this.tableNames ?? []) {
-      db[table] = new RestRepository({ db, pluginOptions, table, links });
+    );
+    const tableNames = pluginOptions.tables?.map(({ name }) => name) ?? [];
+    for (const table of tableNames) {
+      db[table] = new RestRepository({ db, pluginOptions, table, schemaTables: pluginOptions.tables });
     }
     return db;
   }
 }
 _tables = new WeakMap();
 
+class FilesPlugin extends XataPlugin {
+  build(pluginOptions) {
+    return {
+      download: async (location) => {
+        const { table, record, column, fileId = "" } = location ?? {};
+        return await getFileItem({
+          pathParams: {
+            workspace: "{workspaceId}",
+            dbBranchName: "{dbBranch}",
+            region: "{region}",
+            tableName: table ?? "",
+            recordId: record ?? "",
+            columnName: column ?? "",
+            fileId
+          },
+          ...pluginOptions,
+          rawResponse: true
+        });
+      },
+      upload: async (location, file, options) => {
+        const { table, record, column, fileId = "" } = location ?? {};
+        const resolvedFile = await file;
+        const contentType = options?.mediaType || getContentType(resolvedFile);
+        const body = resolvedFile instanceof XataFile ? resolvedFile.toBlob() : resolvedFile;
+        return await putFileItem({
+          ...pluginOptions,
+          pathParams: {
+            workspace: "{workspaceId}",
+            dbBranchName: "{dbBranch}",
+            region: "{region}",
+            tableName: table ?? "",
+            recordId: record ?? "",
+            columnName: column ?? "",
+            fileId
+          },
+          body,
+          headers: { "Content-Type": contentType }
+        });
+      },
+      delete: async (location) => {
+        const { table, record, column, fileId = "" } = location ?? {};
+        return await deleteFileItem({
+          pathParams: {
+            workspace: "{workspaceId}",
+            dbBranchName: "{dbBranch}",
+            region: "{region}",
+            tableName: table ?? "",
+            recordId: record ?? "",
+            columnName: column ?? "",
+            fileId
+          },
+          ...pluginOptions
+        });
+      }
+    };
+  }
+}
+function getContentType(file) {
+  if (typeof file === "string") {
+    return "text/plain";
+  }
+  if ("mediaType" in file && file.mediaType !== void 0) {
+    return file.mediaType;
+  }
+  if (isBlob(file)) {
+    return file.type;
+  }
+  try {
+    return file.type;
+  } catch (e) {
+  }
+  return "application/octet-stream";
+}
+
 var __accessCheck$1 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
@@ -1619,124 +3099,141 @@ var __privateMethod$1 = (obj, member, method) => {
 };
 var _search, search_fn;
 class SearchPlugin extends XataPlugin {
-  constructor(db, links) {
+  constructor(db) {
     super();
     this.db = db;
-    this.links = links;
     __privateAdd$1(this, _search);
   }
-  build({ getFetchProps }) {
+  build(pluginOptions) {
     return {
       all: async (query, options = {}) => {
-        const records = await __privateMethod$1(this, _search, search_fn).call(this, query, options, getFetchProps);
-        return records.map((record) => {
-          const { table = "orphan" } = record.xata;
-          return { table, record: initObject(this.db, this.links, table, record) };
-        });
+        const { records, totalCount } = await __privateMethod$1(this, _search, search_fn).call(this, query, options, pluginOptions);
+        return {
+          totalCount,
+          records: records.map((record) => {
+            const { table = "orphan" } = record.xata;
+            return { table, record: initObject(this.db, pluginOptions.tables, table, record, ["*"]) };
+          })
+        };
       },
       byTable: async (query, options = {}) => {
-        const records = await __privateMethod$1(this, _search, search_fn).call(this, query, options, getFetchProps);
-        return records.reduce((acc, record) => {
+        const { records: rawRecords, totalCount } = await __privateMethod$1(this, _search, search_fn).call(this, query, options, pluginOptions);
+        const records = rawRecords.reduce((acc, record) => {
           const { table = "orphan" } = record.xata;
           const items = acc[table] ?? [];
-          const item = initObject(this.db, this.links, table, record);
+          const item = initObject(this.db, pluginOptions.tables, table, record, ["*"]);
           return { ...acc, [table]: [...items, item] };
         }, {});
+        return { totalCount, records };
       }
     };
   }
 }
 _search = new WeakSet();
-search_fn = async function(query, options, getFetchProps) {
-  const fetchProps = await getFetchProps();
-  const { tables, fuzziness } = options ?? {};
-  const { records } = await searchBranch({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}" },
-    body: { tables, query, fuzziness },
-    ...fetchProps
+search_fn = async function(query, options, pluginOptions) {
+  const { tables, fuzziness, highlight, prefix, page } = options ?? {};
+  const { records, totalCount } = await searchBranch({
+    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", region: "{region}" },
+    // @ts-expect-error Filter properties do not match inferred type
+    body: { tables, query, fuzziness, prefix, highlight, page },
+    ...pluginOptions
   });
-  return records;
-};
-
-const isBranchStrategyBuilder = (strategy) => {
-  return typeof strategy === "function";
+  return { records, totalCount };
 };
 
-const envBranchNames = [
-  "XATA_BRANCH",
-  "VERCEL_GIT_COMMIT_REF",
-  "CF_PAGES_BRANCH",
-  "BRANCH"
-];
-const defaultBranch = "main";
-async function getCurrentBranchName(options) {
-  const env = await getBranchByEnvVariable();
-  if (env)
-    return env;
-  const branch = await getGitBranch();
-  if (!branch)
-    return defaultBranch;
-  const details = await getDatabaseBranch(branch, options);
-  if (details)
-    return branch;
-  return defaultBranch;
-}
-async function getCurrentBranchDetails(options) {
-  const env = await getBranchByEnvVariable();
-  if (env)
-    return getDatabaseBranch(env, options);
-  const branch = await getGitBranch();
-  if (!branch)
-    return getDatabaseBranch(defaultBranch, options);
-  const details = await getDatabaseBranch(branch, options);
-  if (details)
-    return details;
-  return getDatabaseBranch(defaultBranch, options);
-}
-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 [workspace] = host.split(".");
-  const dbBranchName = `${database}:${branch}`;
-  try {
-    return await getBranchDetails({
-      apiKey,
-      apiUrl: databaseURL,
-      fetchImpl: getFetchImplementation(options?.fetchImpl),
-      workspacesApiUrl: `${protocol}//${host}`,
-      pathParams: {
-        dbBranchName,
-        workspace
-      }
-    });
-  } catch (err) {
-    if (isObject(err) && err.status === 404)
-      return null;
-    throw err;
-  }
+function escapeElement(elementRepresentation) {
+  const escaped = elementRepresentation.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+  return '"' + escaped + '"';
 }
-function getBranchByEnvVariable() {
-  for (const name of envBranchNames) {
-    const value = getEnvVariable(name);
-    if (value) {
-      return value;
+function arrayString(val) {
+  let result = "{";
+  for (let i = 0; i < val.length; i++) {
+    if (i > 0) {
+      result = result + ",";
+    }
+    if (val[i] === null || typeof val[i] === "undefined") {
+      result = result + "NULL";
+    } else if (Array.isArray(val[i])) {
+      result = result + arrayString(val[i]);
+    } else if (val[i] instanceof Buffer) {
+      result += "\\\\x" + val[i].toString("hex");
+    } else {
+      result += escapeElement(prepareValue(val[i]));
     }
   }
+  result = result + "}";
+  return result;
+}
+function prepareValue(value) {
+  if (!isDefined(value))
+    return null;
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  if (Array.isArray(value)) {
+    return arrayString(value);
+  }
+  if (isObject(value)) {
+    return JSON.stringify(value);
+  }
   try {
-    return XATA_BRANCH;
-  } catch (err) {
+    return value.toString();
+  } catch (e) {
+    return value;
   }
 }
-function getDatabaseURL() {
-  try {
-    return getEnvVariable("XATA_DATABASE_URL") ?? XATA_DATABASE_URL;
-  } catch (err) {
-    return void 0;
+function prepareParams(param1, param2) {
+  if (isString(param1)) {
+    return { statement: param1, params: param2?.map((value) => prepareValue(value)) };
+  }
+  if (isStringArray(param1)) {
+    const statement = param1.reduce((acc, curr, index) => {
+      return acc + curr + (index < (param2?.length ?? 0) ? "$" + (index + 1) : "");
+    }, "");
+    return { statement, params: param2?.map((value) => prepareValue(value)) };
+  }
+  if (isObject(param1)) {
+    const { statement, params, consistency } = param1;
+    return { statement, params: params?.map((value) => prepareValue(value)), consistency };
+  }
+  throw new Error("Invalid query");
+}
+
+class SQLPlugin extends XataPlugin {
+  build(pluginOptions) {
+    return async (query, ...parameters) => {
+      if (!isParamsObject(query) && (!isTemplateStringsArray(query) || !Array.isArray(parameters))) {
+        throw new Error("Invalid usage of `xata.sql`. Please use it as a tagged template or with an object.");
+      }
+      const { statement, params, consistency } = prepareParams(query, parameters);
+      const { records, warning, columns } = await sqlQuery({
+        pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", region: "{region}" },
+        body: { statement, params, consistency },
+        ...pluginOptions
+      });
+      return { records, warning, columns };
+    };
+  }
+}
+function isTemplateStringsArray(strings) {
+  return Array.isArray(strings) && "raw" in strings && Array.isArray(strings.raw);
+}
+function isParamsObject(params) {
+  return isObject(params) && "statement" in params;
+}
+
+class TransactionPlugin extends XataPlugin {
+  build(pluginOptions) {
+    return {
+      run: async (operations) => {
+        const response = await branchTransaction({
+          pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", region: "{region}" },
+          body: { operations },
+          ...pluginOptions
+        });
+        return response;
+      }
+    };
   }
 }
 
@@ -1763,85 +3260,191 @@ var __privateMethod = (obj, member, method) => {
   return method;
 };
 const buildClient = (plugins) => {
-  var _branch, _parseOptions, parseOptions_fn, _getFetchProps, getFetchProps_fn, _evaluateBranch, evaluateBranch_fn, _a;
+  var _options, _parseOptions, parseOptions_fn, _getFetchProps, getFetchProps_fn, _a;
   return _a = class {
-    constructor(options = {}, links, tables) {
+    constructor(options = {}, tables) {
       __privateAdd(this, _parseOptions);
       __privateAdd(this, _getFetchProps);
-      __privateAdd(this, _evaluateBranch);
-      __privateAdd(this, _branch, void 0);
+      __privateAdd(this, _options, void 0);
       const safeOptions = __privateMethod(this, _parseOptions, parseOptions_fn).call(this, options);
+      __privateSet(this, _options, safeOptions);
       const pluginOptions = {
-        getFetchProps: () => __privateMethod(this, _getFetchProps, getFetchProps_fn).call(this, safeOptions),
-        cache: safeOptions.cache
+        ...__privateMethod(this, _getFetchProps, getFetchProps_fn).call(this, safeOptions),
+        host: safeOptions.host,
+        tables
       };
-      const db = new SchemaPlugin(links, tables).build(pluginOptions);
-      const search = new SearchPlugin(db, links ?? {}).build(pluginOptions);
+      const db = new SchemaPlugin().build(pluginOptions);
+      const search = new SearchPlugin(db).build(pluginOptions);
+      const transactions = new TransactionPlugin().build(pluginOptions);
+      const sql = new SQLPlugin().build(pluginOptions);
+      const files = new FilesPlugin().build(pluginOptions);
+      this.schema = { tables };
       this.db = db;
       this.search = search;
+      this.transactions = transactions;
+      this.sql = sql;
+      this.files = files;
       for (const [key, namespace] of Object.entries(plugins ?? {})) {
-        if (!namespace)
+        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);
       }
     }
-  }, _branch = new WeakMap(), _parseOptions = new WeakSet(), parseOptions_fn = function(options) {
+    async getConfig() {
+      const databaseURL = __privateGet(this, _options).databaseURL;
+      const branch = __privateGet(this, _options).branch;
+      return { databaseURL, branch };
+    }
+  }, _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) {
+      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."
+      );
+    }
     const fetch = getFetchImplementation(options?.fetch);
     const databaseURL = options?.databaseURL || getDatabaseURL();
     const apiKey = options?.apiKey || getAPIKey();
-    const cache = options?.cache ?? new SimpleCache({ cacheRecords: false, defaultQueryTTL: 0 });
-    const branch = async () => options?.branch ? await __privateMethod(this, _evaluateBranch, evaluateBranch_fn).call(this, options.branch) : await getCurrentBranchName({ apiKey, databaseURL, fetchImpl: options?.fetch });
-    if (!databaseURL || !apiKey) {
-      throw new Error("Options databaseURL and apiKey are required");
+    const trace = options?.trace ?? defaultTrace;
+    const 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 };
-  }, _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,
+      trace,
+      host,
+      clientID: generateUUID(),
+      enableBrowser,
+      clientName,
+      xataAgentExtra
+    };
+  }, _getFetchProps = new WeakSet(), getFetchProps_fn = function({
     fetch,
     apiKey,
     databaseURL,
-    branch
+    branch,
+    trace,
+    clientID,
+    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 ? `:${branchValue}` : "");
+        const newPath = path.replace(/^\/db\/[^/]+/, hasBranch !== void 0 ? `:${branch}` : "");
         return databaseURL + newPath;
-      }
-    };
-  }, _evaluateBranch = new WeakSet(), evaluateBranch_fn = async function(param) {
-    if (__privateGet(this, _branch))
-      return __privateGet(this, _branch);
-    if (!param)
-      return void 0;
-    const strategies = Array.isArray(param) ? [...param] : [param];
-    const evaluateBranch = async (strategy) => {
-      return isBranchStrategyBuilder(strategy) ? await strategy() : strategy;
+      },
+      trace,
+      clientID,
+      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() {
 }
 
+const META = "__";
+const VALUE = "___";
+class Serializer {
+  constructor() {
+    this.classes = {};
+  }
+  add(clazz) {
+    this.classes[clazz.name] = clazz;
+  }
+  toJSON(data) {
+    function visit(obj) {
+      if (Array.isArray(obj))
+        return obj.map(visit);
+      const type = typeof obj;
+      if (type === "undefined")
+        return { [META]: "undefined" };
+      if (type === "bigint")
+        return { [META]: "bigint", [VALUE]: obj.toString() };
+      if (obj === null || type !== "object")
+        return obj;
+      const constructor = obj.constructor;
+      const o = { [META]: constructor.name };
+      for (const [key, value] of Object.entries(obj)) {
+        o[key] = visit(value);
+      }
+      if (constructor === Date)
+        o[VALUE] = obj.toISOString();
+      if (constructor === Map)
+        o[VALUE] = Object.fromEntries(obj);
+      if (constructor === Set)
+        o[VALUE] = [...obj];
+      return o;
+    }
+    return JSON.stringify(visit(data));
+  }
+  fromJSON(json) {
+    return JSON.parse(json, (key, value) => {
+      if (value && typeof value === "object" && !Array.isArray(value)) {
+        const { [META]: clazz, [VALUE]: val, ...rest } = value;
+        const constructor = this.classes[clazz];
+        if (constructor) {
+          return Object.assign(Object.create(constructor.prototype), rest);
+        }
+        if (clazz === "Date")
+          return new Date(val);
+        if (clazz === "Set")
+          return new Set(val);
+        if (clazz === "Map")
+          return new Map(Object.entries(val));
+        if (clazz === "bigint")
+          return BigInt(val);
+        if (clazz === "undefined")
+          return void 0;
+        return rest;
+      }
+      return value;
+    });
+  }
+}
+const defaultSerializer = new Serializer();
+const serialize = (data) => {
+  return defaultSerializer.toJSON(data);
+};
+const deserialize = (json) => {
+  return defaultSerializer.fromJSON(json);
+};
+
 class XataError extends Error {
   constructor(message, status) {
     super(message);
@@ -1849,5 +3452,5 @@ class XataError extends Error {
   }
 }
 
-export { BaseClient, operationsByTag as Operations, PAGINATION_DEFAULT_OFFSET, PAGINATION_DEFAULT_SIZE, PAGINATION_MAX_OFFSET, PAGINATION_MAX_SIZE, Page, Query, Repository, RestRepository, SchemaPlugin, SearchPlugin, SimpleCache, XataApiClient, XataApiPlugin, XataError, XataPlugin, acceptWorkspaceMemberInvite, addGitBranchesEntry, addTableColumn, buildClient, bulkInsertTableRecords, cancelWorkspaceMemberInvite, contains, createBranch, createDatabase, createTable, createUserAPIKey, createWorkspace, deleteBranch, deleteColumn, deleteDatabase, deleteRecord, deleteTable, deleteUser, deleteUserAPIKey, deleteWorkspace, endsWith, executeBranchMigrationPlan, exists, ge, getAPIKey, getBranchDetails, getBranchList, getBranchMetadata, getBranchMigrationHistory, getBranchMigrationPlan, getBranchStats, getColumn, getCurrentBranchDetails, getCurrentBranchName, getDatabaseList, getDatabaseURL, getGitBranchesMapping, getRecord, getTableColumns, getTableSchema, getUser, getUserAPIKeys, getWorkspace, getWorkspaceMembersList, getWorkspacesList, gt, gte, includes, includesAll, includesAny, includesNone, insertRecord, insertRecordWithID, inviteWorkspaceMember, is, isIdentifiable, isNot, isXataRecord, le, lt, lte, notExists, operationsByTag, pattern, queryTable, removeGitBranchesEntry, removeWorkspaceMember, resendWorkspaceMemberInvite, resolveBranch, searchBranch, setTableSchema, startsWith, updateBranchMetadata, updateColumn, updateRecordWithID, updateTable, updateUser, updateWorkspace, updateWorkspaceMemberRole, upsertRecordWithID };
+export { BaseClient, FetcherError, FilesPlugin, operationsByTag as Operations, PAGINATION_DEFAULT_OFFSET, PAGINATION_DEFAULT_SIZE, PAGINATION_MAX_OFFSET, PAGINATION_MAX_SIZE, Page, PageRecordArray, Query, RecordArray, RecordColumnTypes, Repository, RestRepository, SQLPlugin, SchemaPlugin, SearchPlugin, Serializer, TransactionPlugin, XataApiClient, XataApiPlugin, XataError, XataFile, XataPlugin, acceptWorkspaceMemberInvite, addGitBranchesEntry, addTableColumn, aggregateTable, applyBranchSchemaEdit, applyMigration, askTable, askTableSession, branchTransaction, buildClient, buildPreviewBranchName, buildProviderString, bulkInsertTableRecords, cancelWorkspaceMemberInvite, compareBranchSchemas, compareBranchWithUserSchema, compareMigrationRequest, contains, copyBranch, createBranch, createCluster, createDatabase, createMigrationRequest, createTable, createUserAPIKey, createWorkspace, deleteBranch, deleteColumn, deleteDatabase, deleteDatabaseGithubSettings, deleteFile, deleteFileItem, deleteOAuthAccessToken, deleteRecord, deleteTable, deleteUser, deleteUserAPIKey, deleteUserOAuthClient, deleteWorkspace, deserialize, endsWith, equals, executeBranchMigrationPlan, exists, fileAccess, fileUpload, ge, getAPIKey, getAuthorizationCode, getBranch, getBranchDetails, getBranchList, getBranchMetadata, getBranchMigrationHistory, getBranchMigrationPlan, getBranchSchemaHistory, getBranchStats, getCluster, getColumn, getDatabaseGithubSettings, getDatabaseList, getDatabaseMetadata, getDatabaseURL, getFile, getFileItem, getGitBranchesMapping, getHostUrl, getMigrationRequest, getMigrationRequestIsMerged, getPreviewBranch, getRecord, getSchema, getTableColumns, getTableSchema, getUser, getUserAPIKeys, getUserOAuthAccessTokens, getUserOAuthClients, getWorkspace, getWorkspaceMembersList, getWorkspacesList, grantAuthorizationCode, greaterEquals, greaterThan, greaterThanEquals, gt, gte, iContains, iPattern, includes, includesAll, includesAny, includesNone, insertRecord, insertRecordWithID, inviteWorkspaceMember, is, isCursorPaginationOptions, isHostProviderAlias, isHostProviderBuilder, isIdentifiable, isNot, isValidExpandedColumn, isValidSelectableColumns, isXataRecord, le, lessEquals, lessThan, lessThanEquals, listClusters, listMigrationRequestsCommits, listRegions, lt, lte, mergeMigrationRequest, notExists, operationsByTag, parseProviderString, parseWorkspacesUrlParts, pattern, pgRollJobStatus, pgRollMigrationHistory, pgRollStatus, previewBranchSchemaEdit, pushBranchMigrations, putFile, putFileItem, queryMigrationRequests, queryTable, removeGitBranchesEntry, removeWorkspaceMember, renameDatabase, resendWorkspaceMemberInvite, resolveBranch, searchBranch, searchTable, serialize, setTableSchema, sqlQuery, startsWith, summarizeTable, transformImage, updateBranchMetadata, updateBranchSchema, updateCluster, updateColumn, updateDatabaseGithubSettings, updateDatabaseMetadata, updateMigrationRequest, updateOAuthAccessToken, updateRecordWithID, updateTable, updateUser, updateWorkspace, updateWorkspaceMemberInvite, updateWorkspaceMemberRole, upsertRecordWithID, vectorSearchTable };
 //# sourceMappingURL=index.mjs.map