@xata.io/client 0.0.0-alpha.vf286f7d → 0.0.0-alpha.vf2894b5

package/dist/index.mjs

@@ -18,7 +18,8 @@ const TraceAttributes = {
   HTTP_METHOD: "http.method",
   HTTP_URL: "http.url",
   HTTP_ROUTE: "http.route",
-  HTTP_TARGET: "http.target"
+  HTTP_TARGET: "http.target",
+  CLOUDFLARE_RAY_ID: "cf.ray"
 };
 
 function notEmpty(value) {
@@ -27,8 +28,18 @@ function notEmpty(value) {
 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;
@@ -83,6 +94,27 @@ function chunk(array, chunkSize) {
 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 getEnvironment() {
   try {
@@ -182,7 +214,7 @@ function getAPIKey() {
 function getBranch() {
   try {
     const { branch } = getEnvironment();
-    return branch ?? "main";
+    return branch;
   } catch (err) {
     return void 0;
   }
@@ -233,13 +265,13 @@ var __privateMethod$4 = (obj, member, 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(
-      `Couldn't find \`fetch\`. Install a fetch implementation such as \`node-fetch\` and pass it explicitly.`
-    );
+    throw new Error(`Couldn't find a global \`fetch\`. Pass a fetch implementation explicitly.`);
   }
   return fetchImpl;
 }
@@ -265,9 +297,13 @@ class ApiRequestPool {
   }
   request(url, options) {
     const start = /* @__PURE__ */ new Date();
-    const fetch2 = this.getFetch();
+    const fetchImpl = this.getFetch();
     const runRequest = async (stalled = false) => {
-      const response = await fetch2(url, options);
+      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);
@@ -275,7 +311,7 @@ class ApiRequestPool {
       }
       if (stalled) {
         const stalledTime = (/* @__PURE__ */ new Date()).getTime() - start.getTime();
-        console.warn(`A request to Xata hit your workspace limits, was retried and stalled for ${stalledTime}ms`);
+        console.warn(`A request to Xata hit branch rate limits, was retried and stalled for ${stalledTime}ms`);
       }
       return response;
     };
@@ -490,7 +526,7 @@ function defaultOnOpen(response) {
   }
 }
 
-const VERSION = "0.24.0";
+const VERSION = "0.26.6";
 
 class ErrorWithCause extends Error {
   constructor(message, options) {
@@ -566,6 +602,18 @@ function hostHeader(url) {
   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,
@@ -585,7 +633,8 @@ async function fetch$1({
   sessionID,
   clientName,
   xataAgentExtra,
-  fetchOptions = {}
+  fetchOptions = {},
+  rawResponse = false
 }) {
   pool.setFetch(fetch2);
   return await trace(
@@ -604,7 +653,7 @@ async function fetch$1({
         isDefined(clientName) ? ["service", clientName] : void 0,
         ...Object.entries(xataAgentExtra ?? {})
       ]).map(([key, value]) => `${key}=${value}`).join("; ");
-      const headers = {
+      const headers = compactObject({
         "Accept-Encoding": "identity",
         "Content-Type": "application/json",
         "X-Xata-Client-ID": clientID ?? defaultClientID,
@@ -613,11 +662,11 @@ async function fetch$1({
         ...customHeaders,
         ...hostHeader(fullUrl),
         Authorization: `Bearer ${apiKey}`
-      };
+      });
       const response = await pool.request(url, {
         ...fetchOptions,
         method: method.toUpperCase(),
-        body: body ? JSON.stringify(body) : void 0,
+        body: await parseBody(body, headers),
         headers,
         signal
       });
@@ -628,8 +677,12 @@ async function fetch$1({
         [TraceAttributes.HTTP_REQUEST_ID]: requestId,
         [TraceAttributes.HTTP_STATUS_CODE]: response.status,
         [TraceAttributes.HTTP_HOST]: host,
-        [TraceAttributes.HTTP_SCHEME]: protocol?.replace(":", "")
+        [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 {};
       }
@@ -637,7 +690,7 @@ async function fetch$1({
         throw new FetcherError(response.status, "Rate limit exceeded", requestId);
       }
       try {
-        const jsonResponse = await response.json();
+        const jsonResponse = rawResponse ? await response.blob() : await response.json();
         if (response.ok) {
           return jsonResponse;
         }
@@ -897,12 +950,6 @@ const searchTable = (variables, signal) => dataPlaneFetch({
   ...variables,
   signal
 });
-const sqlQuery = (variables, signal) => dataPlaneFetch({
-  url: "/db/{dbBranchName}/sql",
-  method: "post",
-  ...variables,
-  signal
-});
 const vectorSearchTable = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/vectorSearch", method: "post", ...variables, signal });
 const askTable = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/ask",
@@ -910,6 +957,7 @@ const askTable = (variables, signal) => dataPlaneFetch({
   ...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({
@@ -918,6 +966,12 @@ const fileAccess = (variables, signal) => dataPlaneFetch({
   ...variables,
   signal
 });
+const sqlQuery = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/sql",
+  method: "post",
+  ...variables,
+  signal
+});
 const operationsByTag$2 = {
   branch: {
     getBranchList,
@@ -982,16 +1036,19 @@ const operationsByTag$2 = {
     queryTable,
     searchBranch,
     searchTable,
-    sqlQuery,
     vectorSearchTable,
     askTable,
+    askTableSession,
     summarizeTable,
     aggregateTable
-  }
+  },
+  sql: { sqlQuery }
 };
 
 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",
@@ -1028,6 +1085,31 @@ const deleteUserAPIKey = (variables, signal) => controlPlaneFetch({
   ...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",
@@ -1071,6 +1153,20 @@ const updateWorkspaceMemberInvite = (variables, signal) => controlPlaneFetch({ u
 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",
@@ -1097,6 +1193,15 @@ const listRegions = (variables, signal) => controlPlaneFetch({
   signal
 });
 const operationsByTag$1 = {
+  oAuth: {
+    getAuthorizationCode,
+    grantAuthorizationCode,
+    getUserOAuthClients,
+    deleteUserOAuthClient,
+    getUserOAuthAccessTokens,
+    deleteOAuthAccessToken,
+    updateOAuthAccessToken
+  },
   users: { getUser, updateUser, deleteUser },
   authentication: { getUserAPIKeys, createUserAPIKey, deleteUserAPIKey },
   workspaces: {
@@ -1116,6 +1221,7 @@ const operationsByTag$1 = {
     acceptWorkspaceMemberInvite,
     resendWorkspaceMemberInvite
   },
+  xbcontrolOther: { listClusters, createCluster, getCluster, updateCluster },
   databases: {
     getDatabaseList,
     createDatabase,
@@ -2109,6 +2215,21 @@ class SearchAndFilterApi {
       ...this.extraProps
     });
   }
+  askTableSession({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    sessionId,
+    message
+  }) {
+    return operationsByTag.searchAndFilter.askTableSession({
+      pathParams: { workspace, region, dbBranchName: `${database}:${branch}`, tableName: table, sessionId },
+      body: { message },
+      ...this.extraProps
+    });
+  }
   summarizeTable({
     workspace,
     region,
@@ -2400,11 +2521,13 @@ class DatabaseApi {
   createDatabase({
     workspace,
     database,
-    data
+    data,
+    headers
   }) {
     return operationsByTag.databases.createDatabase({
       pathParams: { workspaceId: workspace, dbName: database },
       body: data,
+      headers,
       ...this.extraProps
     });
   }
@@ -2494,11 +2617,261 @@ class XataApiPlugin {
 class XataPlugin {
 }
 
+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) => {
+        const { table, record, column, fileId = "" } = location ?? {};
+        const contentType = getContentType(file);
+        return await putFileItem({
+          ...pluginOptions,
+          pathParams: {
+            workspace: "{workspaceId}",
+            dbBranchName: "{dbBranch}",
+            region: "{region}",
+            tableName: table ?? "",
+            recordId: record ?? "",
+            columnName: column ?? "",
+            fileId
+          },
+          body: file,
+          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 (isBlob(file)) {
+    return file.type;
+  }
+  try {
+    return file.type;
+  } catch (e) {
+  }
+  return "application/octet-stream";
+}
+
+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 || "application/octet-stream";
+    this.base64Content = file.base64Content;
+    this.enablePublicUrl = file.enablePublicUrl ?? false;
+    this.signedUrlTimeout = file.signedUrlTimeout ?? 300;
+    this.size = file.size ?? 0;
+    this.version = file.version ?? 1;
+    this.url = file.url || "";
+    this.signedUrl = file.signedUrl;
+    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");
+  }
+  static fromArrayBuffer(arrayBuffer, options = {}) {
+    const uint8Array = new Uint8Array(arrayBuffer);
+    return this.fromUint8Array(uint8Array, options);
+  }
+  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);
+  }
+  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 });
+  }
+  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;
+  }
+  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 });
+  }
+  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 });
+  }
+  static fromString(string, options = {}) {
+    const base64Content = btoa(string);
+    return new XataFile({ ...options, base64Content });
+  }
+  toString() {
+    if (!this.base64Content) {
+      throw new Error(`File content is not available, please select property "base64Content" when querying the file`);
+    }
+    return atob(this.base64Content);
+  }
+  static fromBase64(base64Content, options = {}) {
+    return new XataFile({ ...options, base64Content });
+  }
+  toBase64() {
+    if (!this.base64Content) {
+      throw new Error(`File content is not available, please select property "base64Content" when querying the file`);
+    }
+    return this.base64Content;
+  }
+  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 } = await entry;
+  return compactObject({
+    id,
+    // Name cannot be an empty string in our API
+    name: name ? name : void 0,
+    mediaType,
+    base64Content,
+    enablePublicUrl,
+    signedUrlTimeout
+  });
+};
+
 function cleanFilter(filter) {
-  if (!filter)
+  if (!isDefined(filter))
     return void 0;
-  const values = Object.values(filter).filter(Boolean).filter((value) => Array.isArray(value) ? value.length > 0 : true);
-  return values.length > 0 ? filter : void 0;
+  if (!isObject(filter))
+    return filter;
+  const values = Object.fromEntries(
+    Object.entries(filter).reduce((acc, [key, value]) => {
+      if (!isDefined(value))
+        return acc;
+      if (Array.isArray(value)) {
+        const clean = value.map((item) => cleanFilter(item)).filter((item) => isDefined(item));
+        if (clean.length === 0)
+          return acc;
+        return [...acc, [key, clean]];
+      }
+      if (isObject(value)) {
+        const clean = cleanFilter(value);
+        if (!isDefined(clean))
+          return acc;
+        return [...acc, [key, clean]];
+      }
+      return [...acc, [key, value]];
+    }, [])
+  );
+  return Object.keys(values).length > 0 ? values : void 0;
+}
+
+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) => {
@@ -2572,14 +2945,14 @@ class Page {
   }
 }
 _query = new WeakMap();
-const PAGINATION_MAX_SIZE = 200;
+const PAGINATION_MAX_SIZE = 1e3;
 const PAGINATION_DEFAULT_SIZE = 20;
-const PAGINATION_MAX_OFFSET = 800;
+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));
 }
-const _RecordArray = class extends Array {
+const _RecordArray = class _RecordArray extends Array {
   constructor(...args) {
     super(..._RecordArray.parseConstructorParams(...args));
     __privateAdd$6(this, _page, void 0);
@@ -2650,8 +3023,8 @@ const _RecordArray = class extends Array {
     return __privateGet$6(this, _page).meta.page.more;
   }
 };
-let RecordArray = _RecordArray;
 _page = new WeakMap();
+let RecordArray = _RecordArray;
 
 var __accessCheck$5 = (obj, member, msg) => {
   if (!member.has(obj))
@@ -2676,7 +3049,7 @@ var __privateMethod$3 = (obj, member, method) => {
   return method;
 };
 var _table$1, _repository, _data, _cleanFilterConstraint, cleanFilterConstraint_fn;
-const _Query = class {
+const _Query = class _Query {
   constructor(repository, table, data, rawParent) {
     __privateAdd$5(this, _cleanFilterConstraint);
     __privateAdd$5(this, _table$1, void 0);
@@ -2904,7 +3277,6 @@ const _Query = class {
     return this.meta.page.more;
   }
 };
-let Query = _Query;
 _table$1 = new WeakMap();
 _repository = new WeakMap();
 _data = new WeakMap();
@@ -2919,6 +3291,7 @@ cleanFilterConstraint_fn = function(column, value) {
   }
   return value;
 };
+let Query = _Query;
 function cleanParent(data, parent) {
   if (isCursorPaginationOptions(data.pagination)) {
     return { ...parent, sort: void 0, filter: void 0 };
@@ -2926,6 +3299,22 @@ function cleanParent(data, parent) {
   return parent;
 }
 
+const RecordColumnTypes = [
+  "bool",
+  "int",
+  "float",
+  "string",
+  "text",
+  "email",
+  "multiple",
+  "link",
+  "object",
+  "datetime",
+  "vector",
+  "file[]",
+  "file",
+  "json"
+];
 function isIdentifiable(x) {
   return isObject(x) && isString(x?.id);
 }
@@ -2935,6 +3324,24 @@ function isXataRecord(x) {
   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);
 }
@@ -2984,7 +3391,7 @@ var __privateMethod$2 = (obj, member, method) => {
   __accessCheck$4(obj, member, "access private method");
   return method;
 };
-var _table, _getFetchProps, _db, _cache, _schemaTables$2, _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, _setCacheQuery, setCacheQuery_fn, _getCacheQuery, getCacheQuery_fn, _getSchemaTables$1, getSchemaTables_fn$1;
+var _table, _getFetchProps, _db, _cache, _schemaTables$2, _trace, _insertRecordWithoutId, insertRecordWithoutId_fn, _insertRecordWithId, insertRecordWithId_fn, _insertRecords, insertRecords_fn, _updateRecordWithID, updateRecordWithID_fn, _updateRecords, updateRecords_fn, _upsertRecordWithID, upsertRecordWithID_fn, _deleteRecord, deleteRecord_fn, _deleteRecords, deleteRecords_fn, _setCacheQuery, setCacheQuery_fn, _getCacheQuery, getCacheQuery_fn, _getSchemaTables$1, getSchemaTables_fn$1, _transformObjectToApi, transformObjectToApi_fn;
 const BULK_OPERATION_MAX_SIZE = 1e3;
 class Repository extends Query {
 }
@@ -3006,6 +3413,7 @@ class RestRepository extends Query {
     __privateAdd$4(this, _setCacheQuery);
     __privateAdd$4(this, _getCacheQuery);
     __privateAdd$4(this, _getSchemaTables$1);
+    __privateAdd$4(this, _transformObjectToApi);
     __privateAdd$4(this, _table, void 0);
     __privateAdd$4(this, _getFetchProps, void 0);
     __privateAdd$4(this, _db, void 0);
@@ -3034,24 +3442,24 @@ class RestRepository extends Query {
         if (a.length === 0)
           return [];
         const ids = await __privateMethod$2(this, _insertRecords, insertRecords_fn).call(this, a, { ifVersion, createOnly: true });
-        const columns = isStringArray(b) ? b : ["*"];
+        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 = isStringArray(c) ? c : void 0;
+        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 = isStringArray(b) ? b : void 0;
+        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 = isStringArray(b) ? b : void 0;
+        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");
@@ -3059,7 +3467,7 @@ class RestRepository extends Query {
   }
   async read(a, b) {
     return __privateGet$4(this, _trace).call(this, "read", async () => {
-      const columns = isStringArray(b) ? b : ["*"];
+      const columns = isValidSelectableColumns(b) ? b : ["*"];
       if (Array.isArray(a)) {
         if (a.length === 0)
           return [];
@@ -3086,7 +3494,13 @@ class RestRepository extends Query {
             ...__privateGet$4(this, _getFetchProps).call(this)
           });
           const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
-          return initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), response, columns);
+          return initObject(
+            __privateGet$4(this, _db),
+            schemaTables,
+            __privateGet$4(this, _table),
+            response,
+            columns
+          );
         } catch (e) {
           if (isObject(e) && e.status === 404) {
             return null;
@@ -3128,17 +3542,17 @@ class RestRepository extends Query {
           ifVersion,
           upsert: false
         });
-        const columns = isStringArray(b) ? b : ["*"];
+        const columns = isValidSelectableColumns(b) ? b : ["*"];
         const result = await this.read(a, columns);
         return result;
       }
       try {
         if (isString(a) && isObject(b)) {
-          const columns = isStringArray(c) ? c : void 0;
+          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 = isStringArray(b) ? b : void 0;
+          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) {
@@ -3178,17 +3592,27 @@ class RestRepository extends Query {
           ifVersion,
           upsert: true
         });
-        const columns = isStringArray(b) ? b : ["*"];
+        const columns = isValidSelectableColumns(b) ? b : ["*"];
         const result = await this.read(a, columns);
         return result;
       }
       if (isString(a) && isObject(b)) {
-        const columns = isStringArray(c) ? c : void 0;
-        return __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a, b, columns, { ifVersion });
+        if (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)) {
-        const columns = isStringArray(c) ? c : void 0;
-        return __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a.id, { ...a, id: void 0 }, columns, { ifVersion });
+        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");
     });
@@ -3200,17 +3624,27 @@ class RestRepository extends Query {
         if (a.length === 0)
           return [];
         const ids = await __privateMethod$2(this, _insertRecords, insertRecords_fn).call(this, a, { ifVersion, createOnly: false });
-        const columns = isStringArray(b) ? b : ["*"];
+        const columns = isValidSelectableColumns(b) ? b : ["*"];
         const result = await this.read(ids, columns);
         return result;
       }
       if (isString(a) && isObject(b)) {
-        const columns = isStringArray(c) ? c : void 0;
-        return __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a, b, columns, { createOnly: false, ifVersion });
+        if (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)) {
-        const columns = isStringArray(c) ? c : void 0;
-        return __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a.id, { ...a, id: void 0 }, columns, { createOnly: false, ifVersion });
+        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");
     });
@@ -3227,7 +3661,7 @@ class RestRepository extends Query {
             return o.id;
           throw new Error("Invalid arguments for delete method");
         });
-        const columns = isStringArray(b) ? b : ["*"];
+        const columns = isValidSelectableColumns(b) ? b : ["*"];
         const result = await this.read(a, columns);
         await __privateMethod$2(this, _deleteRecords, deleteRecords_fn).call(this, ids);
         return result;
@@ -3346,7 +3780,13 @@ class RestRepository extends Query {
       });
       const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
       const records = objects.map(
-        (record) => initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), record, data.columns ?? ["*"])
+        (record) => initObject(
+          __privateGet$4(this, _db),
+          schemaTables,
+          __privateGet$4(this, _table),
+          record,
+          data.columns ?? ["*"]
+        )
       );
       await __privateMethod$2(this, _setCacheQuery, setCacheQuery_fn).call(this, query, meta, records);
       return new Page(query, meta, records);
@@ -3377,23 +3817,28 @@ class RestRepository extends Query {
     });
   }
   ask(question, options) {
+    const questionParam = options?.sessionId ? { message: question } : { question };
     const params = {
       pathParams: {
         workspace: "{workspaceId}",
         dbBranchName: "{dbBranch}",
         region: "{region}",
-        tableName: __privateGet$4(this, _table)
+        tableName: __privateGet$4(this, _table),
+        sessionId: options?.sessionId
       },
       body: {
-        question,
-        ...options
+        ...questionParam,
+        rules: options?.rules,
+        searchType: options?.searchType,
+        search: options?.searchType === "keyword" ? options?.search : void 0,
+        vectorSearch: options?.searchType === "vector" ? options?.vectorSearch : void 0
       },
       ...__privateGet$4(this, _getFetchProps).call(this)
     };
     if (options?.onMessage) {
       fetchSSERequest({
         endpoint: "dataPlane",
-        url: "/db/{dbBranchName}/tables/{tableName}/ask",
+        url: "/db/{dbBranchName}/tables/{tableName}/ask/{sessionId}",
         method: "POST",
         onMessage: (message) => {
           options.onMessage?.({ answer: message.text, records: message.records });
@@ -3401,7 +3846,7 @@ class RestRepository extends Query {
         ...params
       });
     } else {
-      return askTable(params);
+      return askTableSession(params);
     }
   }
 }
@@ -3413,7 +3858,7 @@ _schemaTables$2 = new WeakMap();
 _trace = new WeakMap();
 _insertRecordWithoutId = new WeakSet();
 insertRecordWithoutId_fn = async function(object, columns = ["*"]) {
-  const record = transformObjectLinks(object);
+  const record = await __privateMethod$2(this, _transformObjectToApi, transformObjectToApi_fn).call(this, object);
   const response = await insertRecord({
     pathParams: {
       workspace: "{workspaceId}",
@@ -3430,7 +3875,9 @@ insertRecordWithoutId_fn = async function(object, columns = ["*"]) {
 };
 _insertRecordWithId = new WeakSet();
 insertRecordWithId_fn = async function(recordId, object, columns = ["*"], { createOnly, ifVersion }) {
-  const record = transformObjectLinks(object);
+  if (!recordId)
+    return null;
+  const record = await __privateMethod$2(this, _transformObjectToApi, transformObjectToApi_fn).call(this, object);
   const response = await insertRecordWithID({
     pathParams: {
       workspace: "{workspaceId}",
@@ -3448,21 +3895,20 @@ insertRecordWithId_fn = async function(recordId, object, columns = ["*"], { crea
 };
 _insertRecords = new WeakSet();
 insertRecords_fn = async function(objects, { createOnly, ifVersion }) {
-  const chunkedOperations = chunk(
-    objects.map((object) => ({
-      insert: { table: __privateGet$4(this, _table), record: transformObjectLinks(object), createOnly, ifVersion }
-    })),
-    BULK_OPERATION_MAX_SIZE
-  );
+  const operations = await promiseMap(objects, async (object) => {
+    const record = await __privateMethod$2(this, _transformObjectToApi, transformObjectToApi_fn).call(this, object);
+    return { insert: { table: __privateGet$4(this, _table), record, createOnly, ifVersion } };
+  });
+  const chunkedOperations = chunk(operations, BULK_OPERATION_MAX_SIZE);
   const ids = [];
-  for (const operations of chunkedOperations) {
+  for (const operations2 of chunkedOperations) {
     const { results } = await branchTransaction({
       pathParams: {
         workspace: "{workspaceId}",
         dbBranchName: "{dbBranch}",
         region: "{region}"
       },
-      body: { operations },
+      body: { operations: operations2 },
       ...__privateGet$4(this, _getFetchProps).call(this)
     });
     for (const result of results) {
@@ -3477,7 +3923,9 @@ insertRecords_fn = async function(objects, { createOnly, ifVersion }) {
 };
 _updateRecordWithID = new WeakSet();
 updateRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVersion }) {
-  const { id: _id, ...record } = transformObjectLinks(object);
+  if (!recordId)
+    return null;
+  const { id: _id, ...record } = await __privateMethod$2(this, _transformObjectToApi, transformObjectToApi_fn).call(this, object);
   try {
     const response = await updateRecordWithID({
       pathParams: {
@@ -3502,21 +3950,20 @@ updateRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVe
 };
 _updateRecords = new WeakSet();
 updateRecords_fn = async function(objects, { ifVersion, upsert }) {
-  const chunkedOperations = chunk(
-    objects.map(({ id, ...object }) => ({
-      update: { table: __privateGet$4(this, _table), id, ifVersion, upsert, fields: transformObjectLinks(object) }
-    })),
-    BULK_OPERATION_MAX_SIZE
-  );
+  const operations = await promiseMap(objects, async ({ id, ...object }) => {
+    const fields = await __privateMethod$2(this, _transformObjectToApi, transformObjectToApi_fn).call(this, object);
+    return { update: { table: __privateGet$4(this, _table), id, ifVersion, upsert, fields } };
+  });
+  const chunkedOperations = chunk(operations, BULK_OPERATION_MAX_SIZE);
   const ids = [];
-  for (const operations of chunkedOperations) {
+  for (const operations2 of chunkedOperations) {
     const { results } = await branchTransaction({
       pathParams: {
         workspace: "{workspaceId}",
         dbBranchName: "{dbBranch}",
         region: "{region}"
       },
-      body: { operations },
+      body: { operations: operations2 },
       ...__privateGet$4(this, _getFetchProps).call(this)
     });
     for (const result of results) {
@@ -3531,6 +3978,8 @@ updateRecords_fn = async function(objects, { ifVersion, upsert }) {
 };
 _upsertRecordWithID = new WeakSet();
 upsertRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVersion }) {
+  if (!recordId)
+    return null;
   const response = await upsertRecordWithID({
     pathParams: {
       workspace: "{workspaceId}",
@@ -3548,6 +3997,8 @@ upsertRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVe
 };
 _deleteRecord = new WeakSet();
 deleteRecord_fn = async function(recordId, columns = ["*"]) {
+  if (!recordId)
+    return null;
   try {
     const response = await deleteRecord({
       pathParams: {
@@ -3572,7 +4023,7 @@ deleteRecord_fn = async function(recordId, columns = ["*"]) {
 _deleteRecords = new WeakSet();
 deleteRecords_fn = async function(recordIds) {
   const chunkedOperations = chunk(
-    recordIds.map((id) => ({ delete: { table: __privateGet$4(this, _table), id } })),
+    compact(recordIds).map((id) => ({ delete: { table: __privateGet$4(this, _table), id } })),
     BULK_OPERATION_MAX_SIZE
   );
   for (const operations of chunkedOperations) {
@@ -3615,12 +4066,40 @@ getSchemaTables_fn$1 = async function() {
   __privateSet$4(this, _schemaTables$2, 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$1, getSchemaTables_fn$1).call(this);
+  const schema = schemaTables.find((table) => table.name === __privateGet$4(this, _table));
+  if (!schema)
+    throw new Error(`Table ${__privateGet$4(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, schemaTables, table, object, selectedColumns) => {
   const data = {};
@@ -3652,18 +4131,33 @@ const initObject = (db, schemaTables, table, object, selectedColumns) => {
             if (item === column.name) {
               return [...acc, "*"];
             }
-            if (item.startsWith(`${column.name}.`)) {
+            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);
+          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) {
@@ -3673,18 +4167,17 @@ const initObject = (db, schemaTables, table, object, selectedColumns) => {
     }
   }
   const record = { ...data };
-  const serializable = { xata, ...transformObjectLinks(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 = isStringArray(b) ? b : ["*"];
+    const columns2 = isValidSelectableColumns(b) ? b : ["*"];
     const ifVersion = parseIfVersion(b, c);
     return db[table].update(record["id"], data2, columns2, { ifVersion });
   };
   record.replace = function(data2, b, c) {
-    const columns2 = isStringArray(b) ? b : ["*"];
+    const columns2 = isValidSelectableColumns(b) ? b : ["*"];
     const ifVersion = parseIfVersion(b, c);
     return db[table].createOrReplace(record["id"], data2, columns2, { ifVersion });
   };
@@ -3696,10 +4189,10 @@ const initObject = (db, schemaTables, table, object, selectedColumns) => {
     return record.xata;
   };
   record.toSerializable = function() {
-    return JSON.parse(JSON.stringify(serializable));
+    return JSON.parse(JSON.stringify(record));
   };
   record.toString = function() {
-    return JSON.stringify(transformObjectLinks(serializable));
+    return JSON.stringify(record);
   };
   for (const prop of ["read", "update", "replace", "delete", "getMetadata", "toSerializable", "toString"]) {
     Object.defineProperty(record, prop, { enumerable: false });
@@ -3717,11 +4210,7 @@ function extractId(value) {
 function isValidColumn(columns, column) {
   if (columns.includes("*"))
     return true;
-  if (column.type === "link") {
-    const linkColumns = columns.filter((item) => item.startsWith(column.name));
-    return linkColumns.length > 0;
-  }
-  return columns.includes(column.name);
+  return columns.filter((item) => isString(item) && item.startsWith(column.name)).length > 0;
 }
 function parseIfVersion(...args) {
   for (const arg of args) {
@@ -3936,6 +4425,78 @@ getSchemaTables_fn = async function(pluginOptions) {
   return schema.tables;
 };
 
+function escapeElement(elementRepresentation) {
+  const escaped = elementRepresentation.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+  return '"' + escaped + '"';
+}
+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 value.toString();
+  } catch (e) {
+    return value;
+  }
+}
+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 (param1, ...param2) => {
+      const { statement, params, consistency } = prepareParams(param1, param2);
+      const { records, warning } = await sqlQuery({
+        pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", region: "{region}" },
+        body: { statement, params, consistency },
+        ...pluginOptions
+      });
+      return { records, warning };
+    };
+  }
+}
+
 class TransactionPlugin extends XataPlugin {
   build(pluginOptions) {
     return {
@@ -3990,9 +4551,13 @@ const buildClient = (plugins) => {
       const db = new SchemaPlugin(schemaTables).build(pluginOptions);
       const search = new SearchPlugin(db, schemaTables).build(pluginOptions);
       const transactions = new TransactionPlugin().build(pluginOptions);
+      const sql = new SQLPlugin().build(pluginOptions);
+      const files = new FilesPlugin().build(pluginOptions);
       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 === void 0)
           continue;
@@ -4178,5 +4743,5 @@ class XataError extends Error {
   }
 }
 
-export { BaseClient, FetcherError, operationsByTag as Operations, PAGINATION_DEFAULT_OFFSET, PAGINATION_DEFAULT_SIZE, PAGINATION_MAX_OFFSET, PAGINATION_MAX_SIZE, Page, Query, RecordArray, Repository, RestRepository, SchemaPlugin, SearchPlugin, Serializer, SimpleCache, XataApiClient, XataApiPlugin, XataError, XataPlugin, acceptWorkspaceMemberInvite, addGitBranchesEntry, addTableColumn, aggregateTable, applyBranchSchemaEdit, askTable, branchTransaction, buildClient, buildPreviewBranchName, buildProviderString, buildWorkerRunner, bulkInsertTableRecords, cancelWorkspaceMemberInvite, compareBranchSchemas, compareBranchWithUserSchema, compareMigrationRequest, contains, copyBranch, createBranch, createDatabase, createMigrationRequest, createTable, createUserAPIKey, createWorkspace, deleteBranch, deleteColumn, deleteDatabase, deleteDatabaseGithubSettings, deleteFile, deleteFileItem, deleteRecord, deleteTable, deleteUser, deleteUserAPIKey, deleteWorkspace, deserialize, endsWith, equals, executeBranchMigrationPlan, exists, fileAccess, ge, getAPIKey, getBranch, getBranchDetails, getBranchList, getBranchMetadata, getBranchMigrationHistory, getBranchMigrationPlan, getBranchSchemaHistory, getBranchStats, getColumn, getDatabaseGithubSettings, getDatabaseList, getDatabaseMetadata, getDatabaseURL, getFile, getFileItem, getGitBranchesMapping, getHostUrl, getMigrationRequest, getMigrationRequestIsMerged, getPreviewBranch, getRecord, getTableColumns, getTableSchema, getUser, getUserAPIKeys, getWorkspace, getWorkspaceMembersList, getWorkspacesList, greaterEquals, greaterThan, greaterThanEquals, gt, gte, includes, includesAll, includesAny, includesNone, insertRecord, insertRecordWithID, inviteWorkspaceMember, is, isCursorPaginationOptions, isHostProviderAlias, isHostProviderBuilder, isIdentifiable, isNot, isXataRecord, le, lessEquals, lessThan, lessThanEquals, listMigrationRequestsCommits, listRegions, lt, lte, mergeMigrationRequest, notExists, operationsByTag, parseProviderString, parseWorkspacesUrlParts, pattern, previewBranchSchemaEdit, pushBranchMigrations, putFile, putFileItem, queryMigrationRequests, queryTable, removeGitBranchesEntry, removeWorkspaceMember, renameDatabase, resendWorkspaceMemberInvite, resolveBranch, searchBranch, searchTable, serialize, setTableSchema, sqlQuery, startsWith, summarizeTable, updateBranchMetadata, updateBranchSchema, updateColumn, updateDatabaseGithubSettings, updateDatabaseMetadata, updateMigrationRequest, updateRecordWithID, updateTable, updateUser, updateWorkspace, updateWorkspaceMemberInvite, updateWorkspaceMemberRole, upsertRecordWithID, vectorSearchTable };
+export { BaseClient, FetcherError, FilesPlugin, operationsByTag as Operations, PAGINATION_DEFAULT_OFFSET, PAGINATION_DEFAULT_SIZE, PAGINATION_MAX_OFFSET, PAGINATION_MAX_SIZE, Page, Query, RecordArray, RecordColumnTypes, Repository, RestRepository, SQLPlugin, SchemaPlugin, SearchPlugin, Serializer, SimpleCache, XataApiClient, XataApiPlugin, XataError, XataFile, XataPlugin, acceptWorkspaceMemberInvite, addGitBranchesEntry, addTableColumn, aggregateTable, applyBranchSchemaEdit, askTable, askTableSession, branchTransaction, buildClient, buildPreviewBranchName, buildProviderString, buildWorkerRunner, 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, 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, getTableColumns, getTableSchema, getUser, getUserAPIKeys, getUserOAuthAccessTokens, getUserOAuthClients, getWorkspace, getWorkspaceMembersList, getWorkspacesList, grantAuthorizationCode, greaterEquals, greaterThan, greaterThanEquals, gt, gte, 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, 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