@xata.io/client 0.0.0-alpha.vfc99020 → 0.0.0-alpha.vfc9ddd5

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) {
@@ -30,8 +31,15 @@ function compact(arr) {
 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) && !(value instanceof Date);
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date) && !isBlob(value);
 }
 function isDefined(value) {
   return value !== null && value !== void 0;
@@ -263,14 +271,13 @@ var __privateMethod$4 = (obj, member, method) => {
   return method;
 };
 var _fetch, _queue, _concurrency, _enqueue, enqueue_fn;
-const REQUEST_TIMEOUT = 3e4;
+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;
 }
@@ -312,7 +319,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;
     };
@@ -527,7 +534,7 @@ function defaultOnOpen(response) {
   }
 }
 
-const VERSION = "0.25.1";
+const VERSION = "0.26.5";
 
 var __defProp$7 = Object.defineProperty;
 var __defNormalProp$7 = (obj, key, value) => key in obj ? __defProp$7(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -613,11 +620,14 @@ function hostHeader(url) {
   const { groups } = pattern.exec(url) ?? {};
   return groups?.host ? { Host: groups.host } : {};
 }
-function parseBody(body, headers) {
+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") {
+  if (String(contentType).toLowerCase() === "application/json" && isObject(body)) {
     return JSON.stringify(body);
   }
   return body;
@@ -674,7 +684,7 @@ async function fetch$1({
       const response = await pool.request(url, {
         ...fetchOptions,
         method: method.toUpperCase(),
-        body: parseBody(body, headers),
+        body: await parseBody(body, headers),
         headers,
         signal
       });
@@ -685,7 +695,8 @@ 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)
@@ -957,12 +968,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",
@@ -979,6 +984,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,
@@ -1043,13 +1054,13 @@ const operationsByTag$2 = {
     queryTable,
     searchBranch,
     searchTable,
-    sqlQuery,
     vectorSearchTable,
     askTable,
     askTableSession,
     summarizeTable,
     aggregateTable
-  }
+  },
+  sql: { sqlQuery }
 };
 
 const controlPlaneFetch = async (options) => fetch$1({ ...options, endpoint: "controlPlane" });
@@ -1098,6 +1109,25 @@ const getUserOAuthClients = (variables, signal) => controlPlaneFetch({
   ...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",
@@ -1167,9 +1197,17 @@ const listRegions = (variables, signal) => controlPlaneFetch({
   signal
 });
 const operationsByTag$1 = {
-  authOther: { getAuthorizationCode, grantAuthorizationCode },
+  oAuth: {
+    getAuthorizationCode,
+    grantAuthorizationCode,
+    getUserOAuthClients,
+    deleteUserOAuthClient,
+    getUserOAuthAccessTokens,
+    deleteOAuthAccessToken,
+    updateOAuthAccessToken
+  },
   users: { getUser, updateUser, deleteUser },
-  authentication: { getUserAPIKeys, createUserAPIKey, deleteUserAPIKey, getUserOAuthClients },
+  authentication: { getUserAPIKeys, createUserAPIKey, deleteUserAPIKey },
   workspaces: {
     getWorkspacesList,
     createWorkspace,
@@ -2603,7 +2641,9 @@ class FilesPlugin extends XataPlugin {
       },
       upload: async (location, file) => {
         const { table, record, column, fileId = "" } = location ?? {};
+        const contentType = getContentType(file);
         return await putFileItem({
+          ...pluginOptions,
           pathParams: {
             workspace: "{workspaceId}",
             dbBranchName: "{dbBranch}",
@@ -2614,7 +2654,7 @@ class FilesPlugin extends XataPlugin {
             fileId
           },
           body: file,
-          ...pluginOptions
+          headers: { "Content-Type": contentType }
         });
       },
       delete: async (location) => {
@@ -2635,6 +2675,19 @@ class FilesPlugin extends XataPlugin {
     };
   }
 }
+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(
@@ -2651,12 +2704,17 @@ function buildTransformString(transformations) {
     })
   ).join(",");
 }
-function transformImage(url, transformations) {
+function transformImage(url, ...transformations) {
   if (!isDefined(url))
     return void 0;
-  const transformationsString = buildTransformString(transformations);
+  const newTransformations = buildTransformString(transformations);
   const { hostname, pathname, search } = new URL(url);
-  return `https://${hostname}/transform/${transformationsString}${pathname}${search}`;
+  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}`;
 }
 
 var __defProp$6 = Object.defineProperty;
@@ -2668,19 +2726,23 @@ var __publicField$6 = (obj, key, value) => {
 class XataFile {
   constructor(file) {
     /**
-     * Name of this file.
+     * Identifier of the file.
+     */
+    __publicField$6(this, "id");
+    /**
+     * Name of the file.
      */
     __publicField$6(this, "name");
     /**
-     * Media type of this file.
+     * Media type of the file.
      */
     __publicField$6(this, "mediaType");
     /**
-     * Base64 encoded content of this file.
+     * Base64 encoded content of the file.
      */
     __publicField$6(this, "base64Content");
     /**
-     * Whether to enable public url for this file.
+     * Whether to enable public url for the file.
      */
     __publicField$6(this, "enablePublicUrl");
     /**
@@ -2688,35 +2750,36 @@ class XataFile {
      */
     __publicField$6(this, "signedUrlTimeout");
     /**
-     * Size of this file.
+     * Size of the file.
      */
     __publicField$6(this, "size");
     /**
-     * Version of this file.
+     * Version of the file.
      */
     __publicField$6(this, "version");
     /**
-     * Url of this file.
+     * Url of the file.
      */
     __publicField$6(this, "url");
     /**
-     * Signed url of this file.
+     * Signed url of the file.
      */
     __publicField$6(this, "signedUrl");
     /**
-     * Attributes of this file.
+     * Attributes of the file.
      */
     __publicField$6(this, "attributes");
-    this.name = file.name;
+    this.id = file.id;
+    this.name = file.name || "";
     this.mediaType = file.mediaType || "application/octet-stream";
     this.base64Content = file.base64Content;
-    this.enablePublicUrl = file.enablePublicUrl;
-    this.signedUrlTimeout = file.signedUrlTimeout;
-    this.size = file.size;
-    this.version = file.version;
-    this.url = file.url;
+    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;
+    this.attributes = file.attributes || {};
   }
   static fromBuffer(buffer, options = {}) {
     const base64Content = buffer.toString("base64");
@@ -2768,8 +2831,12 @@ class XataFile {
     if (!this.base64Content) {
       throw new Error(`File content is not available, please select property "base64Content" when querying the file`);
     }
-    const arrayBuffer = this.toArrayBuffer();
-    return new Blob([arrayBuffer], { type: this.mediaType });
+    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);
@@ -2792,8 +2859,10 @@ class XataFile {
   }
   transform(...options) {
     return {
-      url: transformImage(this.url, options),
-      signedUrl: transformImage(this.signedUrl, options)
+      url: transformImage(this.url, ...options),
+      signedUrl: transformImage(this.signedUrl, ...options),
+      metadataUrl: transformImage(this.url, ...options, { format: "json" }),
+      metadataSignedUrl: transformImage(this.signedUrl, ...options, { format: "json" })
     };
   }
 }
@@ -2801,7 +2870,15 @@ const parseInputFileEntry = async (entry) => {
   if (!isDefined(entry))
     return null;
   const { id, name, mediaType, base64Content, enablePublicUrl, signedUrlTimeout } = await entry;
-  return compactObject({ id, name, mediaType, base64Content, enablePublicUrl, signedUrlTimeout });
+  return compactObject({
+    id,
+    // Name cannot be an empty string in our API
+    name: name ? name : void 0,
+    mediaType,
+    base64Content,
+    enablePublicUrl,
+    signedUrlTimeout
+  });
 };
 
 function cleanFilter(filter) {
@@ -2831,6 +2908,25 @@ function cleanFilter(filter) {
   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 __defProp$5 = Object.defineProperty;
 var __defNormalProp$5 = (obj, key, value) => key in obj ? __defProp$5(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField$5 = (obj, key, value) => {
@@ -3289,7 +3385,8 @@ const RecordColumnTypes = [
   "datetime",
   "vector",
   "file[]",
-  "file"
+  "file",
+  "json"
 ];
 function isIdentifiable(x) {
   return isObject(x) && isString(x?.id);
@@ -3300,6 +3397,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);
 }
@@ -3400,24 +3515,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");
@@ -3425,7 +3540,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 [];
@@ -3452,7 +3567,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;
@@ -3494,17 +3615,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) {
@@ -3544,20 +3665,20 @@ 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)) {
         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, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a, b, columns, { ifVersion });
       }
       if (isObject(a) && isString(a.id)) {
         if (a.id === "")
           throw new Error("The id can't be empty");
-        const columns = isStringArray(c) ? c : void 0;
+        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)) {
@@ -3576,20 +3697,20 @@ 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)) {
         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: false, ifVersion });
       }
       if (isObject(a) && isString(a.id)) {
         if (a.id === "")
           throw new Error("The id can't be empty");
-        const columns = isStringArray(c) ? c : void 0;
+        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)) {
@@ -3613,7 +3734,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;
@@ -3732,7 +3853,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);
@@ -4038,6 +4165,9 @@ transformObjectToApi_fn = async function(object) {
       case "file[]":
         result[key] = await promiseMap(value, (item) => parseInputFileEntry(item));
         break;
+      case "json":
+        result[key] = stringifyJson(value);
+        break;
       default:
         result[key] = value;
     }
@@ -4081,13 +4211,19 @@ 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;
         }
@@ -4099,6 +4235,9 @@ const initObject = (db, schemaTables, table, object, selectedColumns) => {
       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) {
@@ -4114,12 +4253,12 @@ const initObject = (db, schemaTables, table, object, selectedColumns) => {
     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 });
   };
@@ -4152,7 +4291,7 @@ function extractId(value) {
 function isValidColumn(columns, column) {
   if (columns.includes("*"))
     return true;
-  return columns.filter((item) => item.startsWith(column.name)).length > 0;
+  return columns.filter((item) => isString(item) && item.startsWith(column.name)).length > 0;
 }
 function parseIfVersion(...args) {
   for (const arg of args) {
@@ -4375,6 +4514,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 {
@@ -4428,6 +4639,7 @@ const buildClient = (plugins) => {
       __publicField$2(this, "db");
       __publicField$2(this, "search");
       __publicField$2(this, "transactions");
+      __publicField$2(this, "sql");
       __publicField$2(this, "files");
       const safeOptions = __privateMethod(this, _parseOptions, parseOptions_fn).call(this, options);
       __privateSet(this, _options, safeOptions);
@@ -4439,10 +4651,12 @@ 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)
@@ -4642,5 +4856,5 @@ class XataError extends Error {
   }
 }
 
-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, 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, createDatabase, createMigrationRequest, createTable, createUserAPIKey, createWorkspace, deleteBranch, deleteColumn, deleteDatabase, deleteDatabaseGithubSettings, deleteFile, deleteFileItem, deleteRecord, deleteTable, deleteUser, deleteUserAPIKey, deleteWorkspace, deserialize, endsWith, equals, executeBranchMigrationPlan, exists, fileAccess, ge, getAPIKey, getAuthorizationCode, 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, getUserOAuthClients, getWorkspace, getWorkspaceMembersList, getWorkspacesList, grantAuthorizationCode, 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, transformImage, 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, 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, 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, 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, updateColumn, updateDatabaseGithubSettings, updateDatabaseMetadata, updateMigrationRequest, updateOAuthAccessToken, updateRecordWithID, updateTable, updateUser, updateWorkspace, updateWorkspaceMemberInvite, updateWorkspaceMemberRole, upsertRecordWithID, vectorSearchTable };
 //# sourceMappingURL=index.mjs.map